pxt-common-packages 10.4.4 → 10.4.5

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

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P138247(s) {
+function _main___P138383(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___138490 = (undefined);
-    globals._pollEventQueue___138503 = (undefined);
+    globals._intervals___138626 = (undefined);
+    globals._pollEventQueue___138639 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P138247.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"colorbuffer.ts","functionName":"<main>","argumentNames":[]}
-_main___P138247.continuations = [  ]
+_main___P138383.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"colorbuffer.ts","functionName":"<main>","argumentNames":[]}
+_main___P138383.continuations = [  ]
 
-function _main___P138247_mk(s) {
+function _main___P138383_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P138247, depth: s.depth + 1,
+        parent: s, fn: _main___P138383, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -88,5 +88,5 @@ function _main___P138247_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P138247
+return _main___P138383
 })

package/libs/{game/docs/reference/scene → color-coded-tilemap/docs/reference/color-coded-tilemap}/get-tile.md

@@ -13,7 +13,7 @@ scene.getTile(0, 0)
 
 ## Returns
 
-* a [tile](/types/tile) from a location in the tilemap.
+* a [tile](/reference/color-coded-tilemap/tile) from a location in the tilemap.
 
 ## Example #example
 
@@ -56,8 +56,8 @@ scene.setTileAt(scene.getTile(5, 3), 2)
 
 ## See also #seealso
 
-[set tile](/reference/scene/set-tile),
-[set tile at](/reference/scene/set-tile-at)
+[set tile](/reference/color-coded-tilemap/set-tile),
+[set tile at](/reference/color-coded-tilemap/set-tile-at)
 
 ```package
 color-coded-tilemap

package/libs/color-coded-tilemap/docs/reference/color-coded-tilemap/get-tiles-by-type.md

@@ -0,0 +1,65 @@
+# get Tiles By Type
+
+Get a list of tiles in the tilemap that have the same color index.
+
+```sig
+scene.getTilesByType(0)
+```
+
+All the tiles in the tilemap with the chosen **index** are returned in an array of [tiles](/reference/color-coded-tilemap/tile). You can use this array to change or replace the tiles as one group.
+
+## Parameters
+
+* **index**: the color index to the tiles to make a list for.
+
+## Returns
+
+* an [array](/types/array) of [tiles](/reference/color-coded-tilemap/tile) from the tilemap that have the same color **index**.
+
+## Example #example
+
+Get a list of all the tiles in the center of the tilemap. Replace all of them with the tile type used for the border.
+
+```blocks
+scene.setTile(2, img`
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+`)
+scene.setTileMap(img`
+2 2 2 2 2 2 2 2 2 2 
+2 8 . . . 8 . . . 2 
+2 . 8 . 8 . 8 . 8 2 
+2 . . 8 . . . 8 . 2 
+2 . 8 . 8 . 8 . 8 2 
+2 8 . . . 8 . . . 2 
+2 2 2 2 2 2 2 2 2 2 
+. . . . . . . . . . 
+`)
+for (let tile of scene.getTilesByType(8)) {
+    scene.setTileAt(tile, 2)
+    pause(500)
+}
+```
+
+## See also #seealso
+
+[get tile](/reference/color-coded-tilemap/get-tile),
+[set tile at](/reference/color-coded-tilemap/set-tile-at)
+
+```package
+color-coded-tilemap
+```

package/libs/{game/docs/reference/scene → color-coded-tilemap/docs/reference/color-coded-tilemap}/on-hit-tile.md

@@ -26,9 +26,9 @@ A a sprite hitting a wall is dectected when the outside edges of their images ma
 Build a brick wall of tiles in the scene. Use the **A** to send a ``Ghost`` sprite toward the wall and watch it stop.  When button **B** is pressed, switch the value of the ``ghost`` flag and see if the ghost sprite hits the wall or goes through.
 
 ```blocks
-enum SpriteKind {
-    Ghost,
-    Ball
+namespace SpriteKind {
+    export const Ghost = SpriteKind.create()
+    export const Ball = SpriteKind.create()
 }
 let ghost: Sprite = null
 scene.setTile(2, img`
@@ -102,4 +102,4 @@ controller.B.onEvent(ControllerButtonEvent.Pressed, function () {
 
 ```package
 color-coded-tilemap
-```
+```

package/libs/color-coded-tilemap/docs/reference/color-coded-tilemap/place-on-random-tile.md

@@ -0,0 +1,61 @@
+# place On Random Tile
+
+Move a sprite's position to the center of a random tile in the scene.
+
+```sig
+scene.placeOnRandomTile(null, 0)
+```
+
+You can make a sprite locate itself right on top of a random tile in the tile map. Use the color number of type tile to select for the sprite to locate on one of them.
+
+
+## Parameters
+
+* **sprite**: the sprite to move onto the tile.
+* **color**: the color [number](/types/number) of a tile to randomly select.
+
+## Example #example
+
+Make a tilemap with several different tiles. Create a round shaped sprite. Ramdomly place the sprite on a tile with color number `8`.
+
+```blocks
+let mySprite: Sprite = null
+scene.setTileMap(img`
+. . . . . . . . 3 . 
+. 2 . . . . . . . . 
+. . . . . 8 . . . . 
+. . . . . . . b . . 
+. . 8 . 6 . . . . . 
+. . . . . . 4 . . . 
+. a . . . . . . . . 
+. . . . . . . . e . 
+`)
+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)
+pause(1000)
+scene.placeOnRandomTile(mySprite, 8)
+```
+
+## See also #seealso
+
+[get tile](/reference/color-coded-tilemap/get-tile)
+
+```package
+color-coded-tilemap
+```

package/libs/{game/docs/reference/scene → color-coded-tilemap/docs/reference/color-coded-tilemap}/place.md

@@ -6,7 +6,7 @@ Move a sprite's position to the center of a tile in the scene.
 scene.getTile(0, 0).place(null)
 ```
 
-You a can make a sprite to locate itself right on top of a tile. If you have a [tile](/types/tile) object from the tilemap, just use **place** to put a sprite on top of it.
+You can make a sprite locate itself right on top of a tile. If you have a [tile](/reference/color-coded-tilemap/tile) object from the tilemap, just use **place** to put a sprite on top of it.
 
 ## Parameters
 
@@ -17,10 +17,6 @@ You a can make a sprite to locate itself right on top of a tile. If you have a [
 Make a tilemap with several different tiles. Create a round shaped sprite. Choose the tile at position (1, 1) in the tilemap and place the sprite over it.
 
 ```blocks
-enum SpriteKind {
-    Player,
-    Enemy
-}
 let mySprite: Sprite = null
 scene.setTileMap(img`
 . . . . . . . . 3 . 
@@ -57,7 +53,7 @@ tileDock.place(mySprite)
 
 ## See also #seealso
 
-[get tile](/reference/scene/get-tile)
+[get tile](/reference/color-coded-tilemap/get-tile)
 
 ```package
 color-coded-tilemap

package/libs/color-coded-tilemap/docs/reference/color-coded-tilemap/set-tile-at.md

@@ -0,0 +1,61 @@
+# set Tile At
+
+Change a tile in the tilemap to another tile.
+
+```sig
+scene.setTileAt(null, 0)
+```
+
+A tile from the tile map has the [tile](/reference/color-coded-tilemap/tile) type. You can change that tile by using its object type, [tile](/reference/color-coded-tilemap/tile), and the index of a different tile. The tile map is changed to have the new tile take the position in the tilemap where this one was.
+
+## Parameters
+
+* **tile**: the [tile](/reference/color-coded-tilemap/tile) object to be replaced.
+* **index**: the color index of the tile to replace the previous one.
+
+## Example #example
+
+Make a scene using a tilemap with border tiles and two tiles in the center. Replace the tiles in the center with the ones used for the border.
+
+```blocks
+scene.setTile(2, img`
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+a a a a a a a a a a a a a a a a 
+`)
+scene.setTileMap(img`
+2 2 2 2 2 2 2 2 2 2 
+2 . . . . . . . . 2 
+2 . . . . . . . . 2 
+2 . . . 1 1 . . . 2 
+2 . . . . . . . . 2 
+2 . . . . . . . . 2 
+2 2 2 2 2 2 2 2 2 2 
+. . . . . . . . . . 
+`)
+pause(1000)
+scene.setTileAt(scene.getTile(4, 3), 2)
+pause(1000)
+scene.setTileAt(scene.getTile(5, 3), 2)
+```
+
+## See also #seealso
+
+[set tile](/reference/color-coded-tilemap/set-tile), [get tile](/reference/color-coded-tilemap/get-tile)
+
+```package
+color-coded-tilemap
+```

package/libs/{game/docs/reference/scene → color-coded-tilemap/docs/reference/color-coded-tilemap}/set-tile-map.md

@@ -6,7 +6,7 @@ Arrange image tiles as a pattern in the scene.
 scene.setTileMap(null)
 ```
 
-Your game scene contains a [tile map](/reference/scene/tile-map). A tile map is an arrangement (a pattern) of image tiles that fill up some of the scene. At first, the scene has an empty tile map and no tile pattern is displayed. To build up your scene, you need to make some tiles, add them to the scene, and then tell the scene where to place the tiles.
+Your game scene contains a [tile map](/reference/color-coded-tilemap/tile-map). A tile map is an arrangement (a pattern) of image tiles that fill up some of the scene. At first, the scene has an empty tile map and no tile pattern is displayed. To build up your scene, you need to make some tiles, add them to the scene, and then tell the scene where to place the tiles.
 
 The tile map uses an image layout to map the tiles for the scene. The color numbers in the image are identifiers (an index) for image tiles that were added to the scene. Tile indexes are placed at various locations in the map to create what's displayed in the scene. If there's no tile set with an index to match a color number in the map, the actual color for that number is filled into the scene at that tile location instead.
 
@@ -77,8 +77,8 @@ scene.setTileMap(img`
 
 ## See also #seealso
 
-[tile map](/reference/scene/tile-map),
-[set tile](/reference/scene/set-tile)
+[tile map](/reference/color-coded-tilemap/tile-map),
+[set tile](/reference/color-coded-tilemap/set-tile)
 
 ```package
 color-coded-tilemap

package/libs/{game/docs/reference/scene → color-coded-tilemap/docs/reference/color-coded-tilemap}/set-tile.md

@@ -60,7 +60,7 @@ scene.setTileMap(img`
 
 ## See also #seealso
 
-[tile map](/reference/scene/tile-map), [set tile map](/reference/scene/set-tile-map)
+[tile map](/reference/color-coded-tilemap/tile-map), [set tile map](/reference/color-coded-tilemap/set-tile-map)
 
 ```package
 color-coded-tilemap

package/libs/{game/docs/reference/scene → color-coded-tilemap/docs/reference/color-coded-tilemap}/tile-map.md

@@ -167,8 +167,8 @@ scene.setTileMap(img`
 
 ## See also #seealso
 
-[set tile](/reference/scene/set-tile),
-[set tile map](/reference/scene/set-tile-map)
+[set tile](/reference/color-coded-tilemap/set-tile),
+[set tile map](/reference/color-coded-tilemap/set-tile-map)
 
 ```package
 color-coded-tilemap

package/libs/{game/docs/types → color-coded-tilemap/docs/reference/color-coded-tilemap}/tile.md

@@ -4,7 +4,7 @@ A tile is an image that is displayed as a rectangular portion of the game scene.
 
 ## The tile type
 
-A **tile** is a complex type that contains an [image](/types/image) and a position in a tilemap. The game scene has a collection of tiles and they are added to the scene using the [setTile](/reference/scene/set-tile) function. Tiles can also be set as a wall to keep sprites from passing through them.
+A **tile** is a complex type that contains an [image](/types/image) and a position in a tilemap. The game scene has a collection of tiles and they are added to the scene using the [setTile](/reference/color-coded-tilemap/set-tile) function. Tiles can also be set as a wall to keep sprites from passing through them.
 
 ## Setting tiles
 
@@ -68,7 +68,11 @@ tileList = scene.getTilesByType(4)
 
 ## See also
 
-[set tile](/reference/scene/set-tile),
-[set tilemap](/reference/scene/set-tilemap),
-[get tile](/reference/scene/get-tile),
-[get tiles by type](/reference/scene/get-tiles-by-type)
+[set tile](/reference/color-coded-tilemap/set-tile),
+[set tile map](/reference/color-coded-tilemap/set-tile-map),
+[get tile](/reference/color-coded-tilemap/get-tile),
+[get tiles by type](/reference/color-coded-tilemap/get-tiles-by-type)
+
+```package
+color-coded-tilemap
+```

package/libs/color-coded-tilemap/docs/reference/color-coded-tilemap.md

@@ -0,0 +1,32 @@
+# Color Coded Tilemap
+
+Map scene background tiles using color code placement.
+
+## Tiles and Tilemaps
+
+```cards
+scene.setTileMap(null)
+scene.getTile(0, 0)
+scene.getTilesByType(0)
+scene.getTile(0, 0).place(null)
+scene.setTile(0, null)
+scene.setTileAt(null, 0)
+scene.onHitTile(0, 0, function (sprite) {
+scene.placeOnRandomTile(null, 0)
+```
+
+## See also
+
+[set tile](/reference/color-coded-tilemap/set-tile),
+[set tile map](/reference/color-coded-tilemap/set-tile-map),
+[set tile at](/reference/color-coded-tilemap/set-tile-at),
+[get tile](/reference/color-coded-tilemap/get-tile),
+[get tiles by type](/reference/color-coded-tilemap/get-tiles-by-type),
+[place](/reference/scene/place),
+[place on random tile](/reference/color-coded-tilemap/place-on-random-tile),
+[on hit tile](/reference/color-coded-tilemap/on-hit-tile),
+[tile hit from](/reference/sprites/sprite/tile-hit-from)
+
+```package
+color-coded-tilemap
+```

package/libs/color-coded-tilemap/tilemap.ts

@@ -12,7 +12,7 @@ namespace scene {
     //% blockId=gamesettilemap block="set tile map to %map=tilemap_image_picker || with %scale pixel tiles"
     //% scale.defl=TileScale.Sixteen
     //% group="Color-coded Tilemap"
-    //% help=scene/set-tile-map
+    //% help=color-coded-tilemap/set-tile-map
     export function setTileMap(map: Image, scale = TileScale.Sixteen) {
         const scene = game.currentScene();
         if (!scene.tileMap || !(scene.tileMap as tiles.legacy.LegacyTilemap).isLegacy) {
@@ -29,7 +29,7 @@ namespace scene {
      */
     //% blockId=gamesettile block="set tile %index=colorindexpicker to %img=tile_image_picker with wall %wall=toggleOnOff"
     //% group="Color-coded Tilemap"
-    //% help=scene/set-tile
+    //% help=color-coded-tilemap/set-tile
     export function setTile(index: number, img: Image, wall?: boolean) {
         const scene = game.currentScene();
         if (!scene.tileMap || !(scene.tileMap as tiles.legacy.LegacyTilemap).isLegacy) {
@@ -45,7 +45,7 @@ namespace scene {
      */
     //% blockId=gamegettile block="tile col %col row %row"
     //% group="Color-coded Tilemap" blockSetVariable="myTile"
-    //% help=scene/get-tile
+    //% help=color-coded-tilemap/get-tile
     export function getTile(col: number, row: number): tiles.Tile {
         const scene = game.currentScene();
         if (!scene.tileMap || !(scene.tileMap as tiles.legacy.LegacyTilemap).isLegacy) {
@@ -60,7 +60,7 @@ namespace scene {
      */
     //% blockId=gamegettilestype block="array of all %index=colorindexpicker tiles"
     //% group="Color-coded Tilemap" blockSetVariable="tile list"
-    //% help=scene/get-tiles-by-type
+    //% help=color-coded-tilemap/get-tiles-by-type
     export function getTilesByType(index: number): tiles.Tile[] {
         const scene = game.currentScene();
         if (!scene.tileMap || !(scene.tileMap as tiles.legacy.LegacyTilemap).isLegacy) {
@@ -77,7 +77,7 @@ namespace scene {
     //% blockId=gameplaceonrandomtile block="place %sprite=variables_get(mySprite) on top of random $color tile"
     //% group="Color-coded Tilemap"
     //% color.shadow="colorindexpicker"
-    //% help=scene/place-on-random-tile
+    //% help=color-coded-tilemap/place-on-random-tile
     export function placeOnRandomTile(sprite: Sprite, color: number): void {
         if (!sprite || !game.currentScene().tileMap) return;
         const tiles = getTilesByType(color);
@@ -92,7 +92,7 @@ namespace scene {
      */
     //% blockId=gamesettileat block="set %tile=gamegettile to %index=colorindexpicker"
     //% group="Color-coded Tilemap"
-    //% help=scene/set-tile-at
+    //% help=color-coded-tilemap/set-tile-at
     export function setTileAt(tile: tiles.Tile, index: number) {
         const scene = game.currentScene();
         if (!scene.tileMap || !(scene.tileMap as tiles.legacy.LegacyTilemap).isLegacy) {
@@ -125,7 +125,7 @@ namespace scene {
     //% group="Color-coded Tilemap"
     //% draggableParameters="reporter"
     //% blockId=spritesollisions block="on $sprite of kind $kind=spritekind hits wall $tile=colorindexpicker"
-    //% help=scene/on-hit-tile
+    //% help=color-coded-tilemap/on-hit-tile
     export function onHitTile(kind: number, tile: number, handler: (sprite: Sprite) => void) {
         if (kind == undefined || tile < 0 || tile > 0xF || !handler) return;
 

package/libs/color-sensor/built/debug/binary.js

@@ -56,7 +56,7 @@ const pxsim_pxtrt = pxsim.pxtrt;
 const pxsim_numops = pxsim.numops;
 
 
-function _main___P96771(s) {
+function _main___P96873(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___97014 = (undefined);
-    globals._pollEventQueue___97027 = (undefined);
+    globals._intervals___97116 = (undefined);
+    globals._pollEventQueue___97129 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P96771.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tcs34725.ts","functionName":"<main>","argumentNames":[]}
-_main___P96771.continuations = [  ]
+_main___P96873.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tcs34725.ts","functionName":"<main>","argumentNames":[]}
+_main___P96873.continuations = [  ]
 
-function _main___P96771_mk(s) {
+function _main___P96873_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P96771, depth: s.depth + 1,
+        parent: s, fn: _main___P96873, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -88,5 +88,5 @@ function _main___P96771_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P96771
+return _main___P96873
 })