pxt-common-packages 9.3.11 → 9.4.2

package/libs/game/spriteevents.ts

@@ -46,7 +46,7 @@ namespace sprites {
     //% group="Overlaps"
     //% weight=100 draggableParameters="reporter"
     //% blockId=spritesoverlap block="on $sprite of kind $kind=spritekind overlaps $otherSprite of kind $otherKind=spritekind"
-    //% help=sprites/on-overlap
+    //% help=scene/on-overlap
     //% blockGap=8
     export function onOverlap(kind: number, otherKind: number, handler: (sprite: Sprite, otherSprite: Sprite) => void) {
         if (kind == undefined || otherKind == undefined || !handler) return;
@@ -82,11 +82,11 @@ namespace scene {
      * @param tile
      * @param handler
      */
-    //% group="Tiles"
-    //% weight=100 draggableParameters="reporter" blockGap=8
+    //% group="Tilemaps"
+    //% weight=120 draggableParameters="reporter" blockGap=8
     //% blockId=spriteshittile block="on $sprite of kind $kind=spritekind overlaps $tile at $location"
     //% tile.shadow=tileset_tile_picker
-    //% help=tiles/on-overlap-tile
+    //% help=scene/on-overlap-tile
     export function onOverlapTile(kind: number, tile: Image, handler: (sprite: Sprite, location: tiles.Location) => void) {
         if (kind == undefined || !tile || !handler) return;
 
@@ -105,10 +105,10 @@ namespace scene {
      * @param kind
      * @param handler
      */
-    //% group="Tiles"
-    //% weight=120 draggableParameters="reporter" blockGap=8
+    //% group="Tilemaps"
+    //% weight=100 draggableParameters="reporter" blockGap=8
     //% blockId=spriteshitwall block="on $sprite of kind $kind=spritekind hits wall at $location"
-    //% help=tiles/on-hit-wall
+    //% help=scene/on-hit-wall
     export function onHitWall(kind: number, handler: (sprite: Sprite, location: tiles.Location) => void) {
         if (kind == undefined || !handler) return;
 

package/libs/game/sprites.ts

@@ -72,6 +72,22 @@ namespace sprites {
         else return spritesByKind[kind].sprites();
     }
 
+    /**
+     * Destroys all sprites of the given kind.
+     */
+    //% group="Effects"
+    //% weight=79
+    //% blockId=sprites_destroy_all_sprites_of_kind
+    //% block="destroy all sprites of kind $kind || with $effect effect for $duration ms"
+    //% kind.shadow=spritekind
+    //% duration.shadow=timePicker
+    //% expandableArgumentMode="toggle"
+    export function destroyAllSpritesOfKind(kind: number, effect?: effects.ParticleEffect, duration?: number) {
+        for (const sprite of allOfKind(kind)) {
+            sprite.destroy(effect, duration);
+        }
+    }
+
     /**
      * Create a new sprite with a given speed, and place it at the edge of the screen so it moves towards the middle.
      * The sprite auto-destroys when it leaves the screen. You can modify position after it's created.

package/libs/game/tilemap.ts

@@ -6,45 +6,124 @@ enum TileScale {
     //% block="32x32"
     ThirtyTwo = 5
 }
+
 namespace tiles {
 
     /**
      * A (col, row) location in the tilemap
      **/
-    //% blockNamespace=scene color="#401255" blockGap=8
+    //% blockNamespace=scene color="#401255"
     export class Location {
         protected _row: number;
         protected _col: number;
-        protected tileMap: TileMap;
 
-        get col() {
+        constructor(col: number, row: number, map: TileMap) {
+            this._col = col;
+            this._row = row;
+        }
+
+        get tileMap() {
+            return game.currentScene().tileMap;
+        }
+
+        //% group="Locations" blockSetVariable="location"
+        //% blockCombine block="column"
+        //% weight=100
+        get column() {
             return this._col;
         }
 
+        //% group="Locations" blockSetVariable="location"
+        //% blockCombine block="row"
+        //% weight=100
         get row() {
             return this._row;
         }
 
-        constructor(col: number, row: number, map: TileMap) {
-            this._col = col;
-            this._row = row;
-            this.tileMap = map;
-        }
-
+        //% group="Locations" blockSetVariable="location"
+        //% blockCombine block="x"
+        //% weight=100
         get x(): number {
             const scale = this.tileMap.scale;
             return (this._col << scale) + (1 << (scale - 1));
         }
 
+        //% group="Locations" blockSetVariable="location"
+        //% blockCombine block="y"
+        //% weight=100
         get y(): number {
             const scale = this.tileMap.scale;
             return (this._row << scale) + (1 << (scale - 1));
         }
 
+        //% group="Locations" blockSetVariable="location"
+        //% blockCombine block="left"
+        //% weight=100
+        get left(): number {
+            return (this._col << this.tileMap.scale);
+        }
+
+        //% group="Locations" blockSetVariable="location"
+        //% blockCombine block="top"
+        //% weight=100
+        get top(): number {
+            return (this._row << this.tileMap.scale);
+        }
+
+        //% group="Locations" blockSetVariable="location"
+        //% blockCombine block="right"
+        //% weight=100
+        get right(): number {
+            return this.left + (1 << this.tileMap.scale);
+        }
+
+        //% group="Locations" blockSetVariable="location"
+        //% blockCombine block="bottom"
+        //% weight=100
+        get bottom(): number {
+            return this.top + (1 << this.tileMap.scale);
+        }
+
         get tileSet(): number {
             return this.tileMap.getTileIndex(this._col, this._row);
         }
 
+        // deprecated
+        get col() {
+            return this.column;
+        }
+
+        public isWall(): boolean {
+            return this.tileMap.isObstacle(this._col, this._row);
+        }
+
+        public getImage(): Image {
+            return this.tileMap.getTileImage(this.tileSet);
+        }
+
+        /**
+         * Returns the neighboring location in a specifc direction from a location in a tilemap
+         * @param direction The direction to fetch the location in
+         */
+        //% blockId=tiles_location_get_neighboring_location
+        //% block="tilemap location $direction of $this"
+        //% this.defl=location
+        //% this.shadow=variables_get
+        //% group="Locations" blockGap=8
+        //% weight=10
+        public getNeighboringLocation(direction: CollisionDirection): Location {
+            switch (direction) {
+                case CollisionDirection.Top:
+                    return this.tileMap.getTile(this._col, this._row - 1);
+                case CollisionDirection.Right:
+                    return this.tileMap.getTile(this._col + 1, this._row);
+                case CollisionDirection.Bottom:
+                    return this.tileMap.getTile(this._col, this._row + 1);
+                case CollisionDirection.Left:
+                    return this.tileMap.getTile(this._col - 1, this._row);
+            }
+        }
+
         /**
          * Center the given sprite on this tile
          * @param sprite
@@ -94,7 +173,7 @@ namespace tiles {
          * @param sprite
          */
         //% blockId=gameplaceontile block="on top of %tile(myTile) place %sprite=variables_get(mySprite)"
-        //% blockNamespace="scene" group="Tiles"
+        //% blockNamespace="scene" group="Tilemap Operations"
         //% weight=25
         //% help=tiles/place
         //% deprecated=1
@@ -465,9 +544,24 @@ namespace tiles {
     //% tilemap.fieldOptions.decompileArgumentAsString="true"
     //% tilemap.fieldOptions.filter="tile"
     //% tilemap.fieldOptions.taggedTemplate="tilemap"
-    //% blockNamespace="scene" group="Tiles" duplicateShadowOnDrag
+    //% blockNamespace="scene" duplicateShadowOnDrag
     //% help=tiles/set-tile-map
+    //% deprecated=1
     export function setTilemap(tilemap: TileMapData) {
+        setCurrentTilemap(tilemap);
+    }
+
+    /**
+     * Sets the given tilemap to be the current active tilemap in the game
+     *
+     * @param tilemap The tilemap to set as the current tilemap
+     */
+    //% blockId=set_current_tilemap block="set tilemap to $tilemap"
+    //% weight=201 blockGap=8
+    //% tilemap.shadow=tiles_tilemap_editor
+    //% blockNamespace="scene" group="Tilemaps" duplicateShadowOnDrag
+    //% help=tiles/set-tile-map
+    export function setCurrentTilemap(tilemap: TileMapData) {
         scene.setTileMapLevel(tilemap);
     }
 
@@ -479,8 +573,9 @@ namespace tiles {
     //% blockId=mapsettileat block="set $tile at $loc=mapgettile"
     //% tile.shadow=tileset_tile_picker
     //% tile.decompileIndirectFixedInstances=true
-    //% blockNamespace="scene" group="Tiles" blockGap=8
-    //% help=tiles/set-tile-at
+    //% blockNamespace="scene" group="Tilemap Operations" blockGap=8
+    //% help=scene/set-tile-at
+    //% weight=70
     export function setTileAt(loc: Location, tile: Image): void {
         const scene = game.currentScene();
         if (!loc || !tile || !scene.tileMap) return null;
@@ -496,8 +591,9 @@ namespace tiles {
      */
     //% blockId=mapsetwallat block="set wall $on at $loc"
     //% on.shadow=toggleOnOff loc.shadow=mapgettile
-    //% blockNamespace="scene" group="Tiles" blockGap=8
-    //% help=tiles/set-wall-at
+    //% blockNamespace="scene" group="Tilemap Operations"
+    //% help=scene/set-wall-at
+    //% weight=60
     export function setWallAt(loc: Location, on: boolean): void {
         const scene = game.currentScene();
         if (!loc || !scene.tileMap) return null;
@@ -511,9 +607,9 @@ namespace tiles {
      * @param row
      */
     //% blockId=mapgettile block="tilemap col $col row $row"
-    //% blockNamespace="scene" group="Tiles"
-    //% weight=25 blockGap=8
-    //% help=tiles/get-tile-location
+    //% blockNamespace="scene" group="Locations"
+    //% weight=100 blockGap=8
+    //% help=scene/get-tile-location
     export function getTileLocation(col: number, row: number): Location {
         const scene = game.currentScene();
         if (col == undefined || row == undefined || !scene.tileMap) return null;
@@ -549,13 +645,45 @@ namespace tiles {
     //% blockId=maplocationistile block="tile at $location is $tile"
     //% location.shadow=mapgettile
     //% tile.shadow=tileset_tile_picker tile.decompileIndirectFixedInstances=true
-    //% blockNamespace="scene" group="Collisions" blockGap=8
+    //% blockNamespace="scene" group="Locations" blockGap=8
+    //% weight=40 help=scene/tile-at-location-equals
     export function tileAtLocationEquals(location: Location, tile: Image): boolean {
         const scene = game.currentScene();
         if (!location || !tile || !scene.tileMap) return false;
         return location.tileSet === scene.tileMap.getImageType(tile);
     }
 
+    /**
+     * Returns true if the tile at the given location is a wall in the current tilemap;
+     * otherwise returns false
+     * @param location The location to check for a wall
+     */
+    //% blockId=tiles_tile_at_location_is_wall
+    //% block="tile at $location is wall"
+    //% location.shadow=mapgettile
+    //% blockNamespace="scene" group="Locations" blockGap=8
+    //% weight=30
+    export function tileAtLocationIsWall(location: Location): boolean {
+        if (!location || !location.tileMap) return false;
+        return location.isWall();
+    }
+
+    /**
+     * Returns the image of the tile at the given location in the current tilemap
+     *
+     * @param location The location of the image to fetch
+     */
+    //% blockId=tiles_image_at_location
+    //% block="tile image at $location"
+    //% location.shadow=mapgettile
+    //% weight=0
+    //% blockNamespace="scene" group="Locations"
+    export function tileImageAtLocation(location: Location): Image {
+        const scene = game.currentScene();
+        if (!location || !scene.tileMap) return img``;
+        return location.getImage();
+    }
+
     /**
      * Center the given sprite on a given location
      * @param sprite
@@ -563,10 +691,11 @@ namespace tiles {
      */
     //% blockId=mapplaceontile block="place $sprite=variables_get(mySprite) on top of $loc"
     //% loc.shadow=mapgettile
-    //% blockNamespace="scene" group="Tiles" blockGap=8
-    //% help=tiles/place
+    //% blockNamespace="scene" group="Tilemap Operations" blockGap=8
+    //% help=scene/place
+    //% weight=100
     export function placeOnTile(sprite: Sprite, loc: Location): void {
-        if (!sprite || !loc || !game.currentScene().tileMap) return;
+        if (!sprite || !loc || !loc.tileMap) return;
         loc.place(sprite);
     }
 
@@ -578,8 +707,9 @@ namespace tiles {
     //% blockId=mapplaceonrandomtile block="place $sprite=variables_get(mySprite) on top of random $tile"
     //% tile.shadow=tileset_tile_picker
     //% tile.decompileIndirectFixedInstances=true
-    //% blockNamespace="scene" group="Tiles" blockGap=8
-    //% help=tiles/place-on-random-tile
+    //% blockNamespace="scene" group="Tilemap Operations"
+    //% help=scene/place-on-random-tile
+    //% weight=90
     export function placeOnRandomTile(sprite: Sprite, tile: Image): void {
         if (!sprite || !game.currentScene().tileMap) return;
         const loc = getRandomTileByType(tile);
@@ -594,8 +724,9 @@ namespace tiles {
     //% blockId=mapgettilestype block="array of all $tile locations"
     //% tile.shadow=tileset_tile_picker
     //% tile.decompileIndirectFixedInstances=true
-    //% blockNamespace="scene" group="Tiles" blockGap=8
-    //% help=tiles/get-tiles-by-type
+    //% blockNamespace="scene" group="Locations" blockGap=8
+    //% help=scene/get-tiles-by-type
+    //% weight=10
     export function getTilesByType(tile: Image): Location[] {
         const scene = game.currentScene();
         if (!tile || !scene.tileMap) return [];
@@ -615,4 +746,19 @@ namespace tiles {
         const sample = scene.tileMap.sampleTilesByType(index, 1);
         return sample[0];
     }
+
+    /**
+     * A tilemap
+     */
+    //% blockId=tiles_tilemap_editor shim=TD_ID
+    //% weight=200 blockGap=8
+    //% block="tilemap $tilemap"
+    //% tilemap.fieldEditor="tilemap"
+    //% tilemap.fieldOptions.decompileArgumentAsString="true"
+    //% tilemap.fieldOptions.filter="tile"
+    //% tilemap.fieldOptions.taggedTemplate="tilemap"
+    //% blockNamespace="scene" group="Tilemaps" duplicateShadowOnDrag
+    export function _tilemapEditor(tilemap: TileMapData): TileMapData {
+        return tilemap;
+    }
 }

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

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P48390(s) {
+function _main___P48418(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___48631 = (undefined);
-    globals._pollEventQueue___48644 = (undefined);
+    globals._intervals___48659 = (undefined);
+    globals._pollEventQueue___48672 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P48390.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"characterlcd.ts","functionName":"<main>","argumentNames":[]}
-_main___P48390.continuations = [  ]
+_main___P48418.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"characterlcd.ts","functionName":"<main>","argumentNames":[]}
+_main___P48418.continuations = [  ]
 
-function _main___P48390_mk(s) {
+function _main___P48418_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P48390, depth: s.depth + 1,
+        parent: s, fn: _main___P48418, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -88,5 +88,5 @@ function _main___P48390_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P48390
+return _main___P48418
 })

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___P95840(s) {
+function _main___P95928(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___96081 = (undefined);
-    globals._pollEventQueue___96094 = (undefined);
+    globals._intervals___96169 = (undefined);
+    globals._pollEventQueue___96182 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P95840.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tsl2591.ts","functionName":"<main>","argumentNames":[]}
-_main___P95840.continuations = [  ]
+_main___P95928.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tsl2591.ts","functionName":"<main>","argumentNames":[]}
+_main___P95928.continuations = [  ]
 
-function _main___P95840_mk(s) {
+function _main___P95928_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P95840, depth: s.depth + 1,
+        parent: s, fn: _main___P95928, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -88,5 +88,5 @@ function _main___P95840_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P95840
+return _main___P95928
 })

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

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P59676(s) {
+function _main___P59708(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___59917 = (undefined);
-    globals._pollEventQueue___59930 = (undefined);
+    globals._intervals___59949 = (undefined);
+    globals._pollEventQueue___59962 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P59676.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"lora.ts","functionName":"<main>","argumentNames":[]}
-_main___P59676.continuations = [  ]
+_main___P59708.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"lora.ts","functionName":"<main>","argumentNames":[]}
+_main___P59708.continuations = [  ]
 
-function _main___P59676_mk(s) {
+function _main___P59708_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P59676, depth: s.depth + 1,
+        parent: s, fn: _main___P59708, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -88,5 +88,5 @@ function _main___P59676_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P59676
+return _main___P59708
 })

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

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P185082(s) {
+function _main___P185323(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___185323 = (undefined);
-    globals._pollEventQueue___185336 = (undefined);
+    globals._intervals___185564 = (undefined);
+    globals._pollEventQueue___185577 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P185082.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"keypad.ts","functionName":"<main>","argumentNames":[]}
-_main___P185082.continuations = [  ]
+_main___P185323.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"keypad.ts","functionName":"<main>","argumentNames":[]}
+_main___P185323.continuations = [  ]
 
-function _main___P185082_mk(s) {
+function _main___P185323_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P185082, depth: s.depth + 1,
+        parent: s, fn: _main___P185323, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -88,5 +88,5 @@ function _main___P185082_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P185082
+return _main___P185323
 })