pxt-common-packages 13.1.7 → 13.1.8

package/libs/game/docs/reference/sprites/sprite/follow.md

@@ -63,4 +63,5 @@ game.onUpdateInterval(1000, function () {
 
 ## See also
 
+[unfollow](/reference/sprites/sprite/unfollow),
 [overlaps with](/reference/sprites/sprite/overlaps-with)

package/libs/game/docs/reference/sprites/sprite/set-kind.md

@@ -55,7 +55,7 @@ namespace SpriteKind {
 }
 ```
 
-During the game, if you need a sprite to change to a different kind, say a ``Planet`` becomes an ``Asteriod``, you just set the new kind with **setKind**.
+During the game, if you need a sprite to change to a different kind, say a ``Planet`` becomes an ``Asteroid``, you just set the new kind with **setKind**.
 
 ## Example #example
 

package/libs/game/docs/reference/sprites/sprite/unfollow.md

@@ -0,0 +1,62 @@
+# unfollow
+
+Stop a sprite from following any target sprite.
+
+```sig
+sprites.create(null).unfollow()
+```
+
+When you set a sprite to unfollow, it will stop moving toward any previously set target sprite. The sprite's velocity will be set to zero, and it will remain at its current position until you move it again using other methods.
+
+## Example
+
+Create 2 sprites. Set the second sprite to follow the first one. After 3 seconds, make the second sprite stop following.
+
+```blocks
+let mySprite = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 7 7 7 7 7 7 . . . . . 
+    . . . 7 7 7 7 7 7 7 7 7 7 . . . 
+    . . . 7 7 7 7 7 7 7 7 7 7 . . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . 7 7 7 7 7 7 7 7 7 7 7 7 . . 
+    . . . 7 7 7 7 7 7 7 7 7 7 . . . 
+    . . . 7 7 7 7 7 7 7 7 7 7 . . . 
+    . . . . . 7 7 7 7 7 7 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+let mySprite2 = sprites.create(img`
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . 5 5 5 5 5 5 5 5 5 5 5 5 . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . 5 5 5 5 5 5 5 5 5 5 . . . 
+    . . . . . 5 5 5 5 5 5 . . . . . 
+    . . . . . . . . . . . . . . . . 
+    . . . . . . . . . . . . . . . . 
+    `, SpriteKind.Player)
+mySprite2.follow(mySprite, 50)
+game.onUpdateInterval(1000, function () {
+    mySprite.setPosition(randint(0, scene.screenWidth()), randint(0, scene.screenHeight()))
+})
+pause(3000)
+mySprite2.unfollow()
+```
+
+## See also
+
+[follow](/reference/sprites/sprite/follow)

package/libs/game/sprite.ts

@@ -1103,6 +1103,19 @@ class Sprite extends sprites.BaseSprite {
         }
     }
 
+    /**
+     * Stop this sprite from following any target sprite.
+     */
+    //% group="Physics" weight=9
+    //% blockId=spriteUnfollow
+    //% block="set $sprite(myEnemy) unfollow"
+    //% sprite.shadow=variables_get
+    //% sprite.defl=myEnemy
+    //% help=sprites/sprite/unfollow
+    unfollow() {
+        this.follow(null, 0);
+    }
+
     setScaleCore(sx?: number, sy?: number, anchor?: ScaleAnchor, proportional?: boolean): void {
         anchor = anchor || ScaleAnchor.Middle;
 

package/libs/lcd/built/debug/binary.js

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P49368(s) {
+function _main___P49369(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,19 +66,19 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___49612 = (undefined);
-    globals._pollEventQueue___49625 = (undefined);
+    globals._intervals___49613 = (undefined);
+    globals._pollEventQueue___49626 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P49368.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"characterlcd.ts","functionName":"<main>","argumentNames":[]}
-_main___P49368.continuations = [  ]
+_main___P49369.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"characterlcd.ts","functionName":"<main>","argumentNames":[]}
+_main___P49369.continuations = [  ]
 
-function _main___P49368_mk(s) {
+function _main___P49369_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P49368, depth: s.depth + 1,
+        parent: s, fn: _main___P49369, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -87,5 +87,5 @@ function _main___P49368_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P49368
+return _main___P49369
 })

package/libs/light-spectrum-sensor/built/debug/binary.js

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P100627(s) {
+function _main___P100630(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,19 +66,19 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___100871 = (undefined);
-    globals._pollEventQueue___100884 = (undefined);
+    globals._intervals___100874 = (undefined);
+    globals._pollEventQueue___100887 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P100627.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tsl2591.ts","functionName":"<main>","argumentNames":[]}
-_main___P100627.continuations = [  ]
+_main___P100630.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tsl2591.ts","functionName":"<main>","argumentNames":[]}
+_main___P100630.continuations = [  ]
 
-function _main___P100627_mk(s) {
+function _main___P100630_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P100627, depth: s.depth + 1,
+        parent: s, fn: _main___P100630, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -87,5 +87,5 @@ function _main___P100627_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P100627
+return _main___P100630
 })

package/libs/lora/built/debug/binary.js

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P60651(s) {
+function _main___P60652(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,19 +66,19 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___60895 = (undefined);
-    globals._pollEventQueue___60908 = (undefined);
+    globals._intervals___60896 = (undefined);
+    globals._pollEventQueue___60909 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P60651.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"lora.ts","functionName":"<main>","argumentNames":[]}
-_main___P60651.continuations = [  ]
+_main___P60652.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"lora.ts","functionName":"<main>","argumentNames":[]}
+_main___P60652.continuations = [  ]
 
-function _main___P60651_mk(s) {
+function _main___P60652_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P60651, depth: s.depth + 1,
+        parent: s, fn: _main___P60652, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -87,5 +87,5 @@ function _main___P60651_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P60651
+return _main___P60652
 })

package/libs/matrix-keypad/built/debug/binary.js

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P196981(s) {
+function _main___P196988(s) {
 let r0 = s.r0, step = s.pc;
 s.pc = -1;
 
@@ -66,19 +66,19 @@ if (yieldSteps-- < 0 && maybeYield(s, step, r0) || runtime !== pxsim.runtime) re
 switch (step) {
   case 0:
 
-    globals._intervals___197225 = (undefined);
-    globals._pollEventQueue___197238 = (undefined);
+    globals._intervals___197232 = (undefined);
+    globals._pollEventQueue___197245 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P196981.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"keypad.ts","functionName":"<main>","argumentNames":[]}
-_main___P196981.continuations = [  ]
+_main___P196988.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"keypad.ts","functionName":"<main>","argumentNames":[]}
+_main___P196988.continuations = [  ]
 
-function _main___P196981_mk(s) {
+function _main___P196988_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P196981, depth: s.depth + 1,
+        parent: s, fn: _main___P196988, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -87,5 +87,5 @@ function _main___P196981_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P196981
+return _main___P196988
 })