pxt-common-packages 9.4.2 → 9.4.3

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

@@ -28568,7 +28568,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-tiles_getTileImage__P65708.info = {"start":19985,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
+tiles_getTileImage__P65708.info = {"start":19984,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
 
 function tiles_getTileImage__P65708_mk(s) {
     checkStack(s.depth);

package/libs/controller---none/built/debug/binary.js

@@ -28459,7 +28459,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-tiles_getTileImage__P80726.info = {"start":19985,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
+tiles_getTileImage__P80726.info = {"start":19984,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
 
 function tiles_getTileImage__P80726_mk(s) {
     checkStack(s.depth);

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

@@ -27954,7 +27954,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-tiles_getTileImage__P137301.info = {"start":19985,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
+tiles_getTileImage__P137301.info = {"start":19984,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
 
 function tiles_getTileImage__P137301_mk(s) {
     checkStack(s.depth);

package/libs/game/docs/reference/scene/set-tilemap.md

@@ -0,0 +1,89 @@
+# set Tilemap
+
+Set a tilemap as the current tilemap for the game scene.
+
+```sig
+tiles.setTilemap(null)
+```
+
+A tilemap is complex data object that contains the dimensions, layers, and tile list for a tile mapping to set as the scene for a game. A game program can have more than one tilemap defined and the game's scene or _level_ can change by setting a different tilemap at certain times during a game.
+
+Tilemaps aren't coded by the user but are created using a tilemap editor. Each tilemap in a game project is a named resource and is contained within the project's **assets** collection. A particular tilemap is specified with it's resource name like this:
+
+```typescript
+tiles.setTilemap(tilemap`level1`)
+```
+
+## Parameters
+
+* **tilemap**: the tilemap data containing the tilemap layout and tiles to set for the game scene. The tilemap can be specified by it's resource name, such as: `` tilemap`level1` ``.
+
+## Example #example
+
+Create a maze tilemap for a sprite to travel through. Set the tilemap as the scene for the game. Create a sprite and start it travelling in the maze.
+
+```blocks
+tiles.setTilemap(tilemap`level1`)
+let mySprite = 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)
+mySprite.setPosition(0, 104)
+mySprite.vx = 16
+```
+
+## See also #seealso
+
+[set tile at](/reference/scene/set-tile-at)
+
+```jres
+{
+    "transparency16": {
+        "data": "hwQQABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true
+    },
+    "tile1": {
+        "data": "hwQQABAAAADu7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7g==",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "myTile0"
+    },
+    "tile2": {
+        "data": "hwQQABAAAABERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERERA==",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "myTile1"
+    },
+    "level1": {
+        "id": "level1",
+        "mimeType": "application/mkcd-tilemap",
+        "data": "MTAwYTAwMDgwMDAxMDEwMTAxMDEwMTAxMDEwMTAxMDEwMDAwMDAwMDAwMDAwMDAwMDEwMTAwMDIwMjAyMDAwMjAyMDAwMTAxMDAwMjAwMDIwMDAyMDIwMDAwMDEwMDAyMDAwMjAwMDIwMDAwMDEwMTAwMDIwMDAyMDIwMjAwMDIwMTAwMDAwMDAwMDAwMDAyMDAwMDAxMDEwMTAxMDEwMTAxMDEwMTAxMDEyMjIyMjIyMjIyMDIwMDAwMDAyMDAyMjIwMjIyMjAwMjAyMDIyMjAwMDIwMjAyMDIyMDAyMDIyMjAyMjIwMDAwMDAwMjIwMjIyMjIyMjIyMg==",
+        "tileset": [
+            "myTiles.transparency16",
+            "myTiles.tile1",
+            "myTiles.tile2"
+        ],
+        "displayName": "maze"
+    },
+    "*": {
+        "mimeType": "image/x-mkcd-f4",
+        "dataEncoding": "base64",
+        "namespace": "myTiles"
+    }
+}
+```

package/libs/game/docs/reference/scene.md

@@ -16,7 +16,8 @@ scene.backgroundImage()
 ## Tiles and Tilemaps
 
 ```cards
-tiles.setTileAt(null, tiles.getTileLocation(0, 0))
+tiles.setTilemap(null)
+tiles.setTileAt(tiles.getTileLocation(0, 0), null)
 tiles.setWallAt(tiles.getTileLocation(0, 0), false)
 tiles.getTileLocation(0, 0)
 tiles.getTilesByType(null)
@@ -24,7 +25,7 @@ tiles.placeOnTile(null, tiles.getTileLocation(0, 0))
 tiles.placeOnRandomTile(null, null)
 scene.onOverlapTile(SpriteKind.Player, null, function (sprite, location) {})
 scene.onHitWall(SpriteKind.Player, function (sprite, location) { })
-tiles.tileAtLocationEquals(location, null)
+tiles.tileAtLocationEquals(tiles.getTileLocation(0, 0), null)
 sprites.create(null).isHittingTile(CollisionDirection.Right)
 sprites.create(null).tileKindAt(TileDirection.Right, null)
 ```
@@ -52,6 +53,7 @@ scene.cameraShake(4,500)
 [set background image](/reference/scene/set-background-image),
 [background color](/reference/scene/background-color),
 [background image](/reference/scene/background-image),
+[set tilemap](/reference/scene/set-tilemap),
 [set tile at](/reference/scene/set-tile-at),
 [set wall at](/reference/scene/set-wall-at),
 [get tile location](/reference/scene/get-tile-location),

package/libs/game/tilemap.ts

@@ -545,7 +545,7 @@ namespace tiles {
     //% tilemap.fieldOptions.filter="tile"
     //% tilemap.fieldOptions.taggedTemplate="tilemap"
     //% blockNamespace="scene" duplicateShadowOnDrag
-    //% help=tiles/set-tile-map
+    //% help=scene/set-tilemap
     //% deprecated=1
     export function setTilemap(tilemap: TileMapData) {
         setCurrentTilemap(tilemap);

package/libs/net-game/built/debug/binary.js

@@ -36777,7 +36777,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-tiles_getTileImage__P111153.info = {"start":19985,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
+tiles_getTileImage__P111153.info = {"start":19984,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
 
 function tiles_getTileImage__P111153_mk(s) {
     checkStack(s.depth);

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

@@ -27954,7 +27954,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-tiles_getTileImage__P168540.info = {"start":19985,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
+tiles_getTileImage__P168540.info = {"start":19984,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
 
 function tiles_getTileImage__P168540_mk(s) {
     checkStack(s.depth);

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

@@ -27954,7 +27954,7 @@ switch (step) {
     return leave(s, r0)
   default: oops()
 } } }
-tiles_getTileImage__P152413.info = {"start":19985,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
+tiles_getTileImage__P152413.info = {"start":19984,"length":207,"line":622,"column":4,"endLine":626,"endColumn":5,"fileName":"pxt_modules/game/tilemap.ts","functionName":"getTileImage","argumentNames":["loc"]}
 
 function tiles_getTileImage__P152413_mk(s) {
     checkStack(s.depth);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pxt-common-packages",
-  "version": "9.4.2",
+  "version": "9.4.3",
   "description": "Microsoft MakeCode (PXT) common packages",
   "keywords": [
     "MakeCode",