pxt-common-packages 13.1.6 → 13.1.8

package/libs/game/controller.ts

@@ -183,6 +183,7 @@ namespace controller {
         //% blockId="ctrlgame_control_sprite" block="%controller move $sprite=variables_get(mySprite) with buttons||vx $vx vy $vy"
         //% weight=100
         //% expandableArgumentMode="toggle"
+        //% sprite.defl=mySprite
         //% vx.defl=100 vy.defl=100
         //% help=controller/move-sprite
         //% group="Multiplayer"
@@ -433,6 +434,7 @@ namespace controller {
     //% blockId="game_control_sprite" block="move $sprite=variables_get(mySprite) with buttons||vx $vx vy $vy"
     //% weight=100
     //% expandableArgumentMode="toggle"
+    //% sprite.defl=mySprite
     //% vx.defl=100 vy.defl=100
     //% help=controller/move-sprite
     //% group="Single Player"

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/particleeffects.ts

@@ -134,6 +134,7 @@ namespace effects {
      */
     //% blockId=particlesclearparticles block="clear effects on %anchor=variables_get(mySprite)"
     //% blockNamespace=sprites
+    //% anchor.defl=mySprite
     //% group="Effects" weight=89
     //% help=effects/clear-particles
     export function clearParticles(anchor: Sprite | particles.ParticleAnchor) {

package/libs/game/scenes.ts

@@ -139,6 +139,7 @@ namespace scene {
      */
     //% blockId=camerafollow block="camera follow sprite %sprite=variables_get(mySprite)"
     //% group="Camera"
+    //% sprite.defl=mySprite
     //% help=scene/camera-follow-sprite
     //% weight=100
     export function cameraFollowSprite(sprite: Sprite) {

package/libs/game/sprite.ts

@@ -767,6 +767,7 @@ class Sprite extends sprites.BaseSprite {
      */
     //% group="Overlaps"
     //% blockId=spriteoverlapswith block="%sprite(mySprite) overlaps with %other=variables_get(otherSprite)"
+    //% other.defl=otherSprite
     //% help=sprites/sprite/overlaps-with
     //% weight=90
     overlapsWith(other: Sprite): boolean {
@@ -1015,6 +1016,7 @@ class Sprite extends sprites.BaseSprite {
     //% group="Physics" weight=10
     //% blockId=spriteFollowOtherSprite
     //% block="set %sprite(myEnemy) follow %target=variables_get(mySprite) || with speed %speed"
+    //% target.defl=mySprite
     //% help=sprites/sprite/follow
     follow(target: Sprite, speed = 100, turnRate = 400) {
         if (target === this) return;
@@ -1101,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/game/sprites.ts

@@ -125,6 +125,7 @@ namespace sprites {
     //% blockId=spritescreateprojectilefromsprite block="projectile %img=screen_image_picker from %sprite=variables_get(mySprite) with vx %vx vy %vy"
     //% vx.shadow=spriteSpeedPicker
     //% vy.shadow=spriteSpeedPicker
+    //% sprite.defl=mySprite
     //% weight=99 help=sprites/create-projectile-from-sprite
     //% blockSetVariable=projectile
     //% inlineInputMode=inline

package/libs/game/tilemap.ts

@@ -744,6 +744,7 @@ namespace tiles {
      * @param loc
      */
     //% blockId=mapplaceontile block="place $sprite=variables_get(mySprite) on top of $loc"
+    //% sprite.defl=mySprite
     //% loc.shadow=mapgettile
     //% blockNamespace="scene" group="Tilemap Operations" blockGap=8
     //% help=tiles/place-on-tile
@@ -759,6 +760,7 @@ namespace tiles {
      * @param tile
      */
     //% blockId=mapplaceonrandomtile block="place $sprite=variables_get(mySprite) on top of random $tile"
+    //% sprite.defl=mySprite
     //% tile.shadow=tileset_tile_picker
     //% tile.decompileIndirectFixedInstances=true
     //% blockNamespace="scene" group="Tilemap Operations"

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
 })