pxt-common-packages 9.5.10 → 10.0.1

package/libs/game/docs/reference/tiles/tile-image-at-location.md

@@ -0,0 +1,65 @@
+# tile Image At Location
+
+Get the image of the tile at a location in the tilemap.
+
+```sig
+tiles.tileImageAtLocation(tiles.getTileAtLocation(0, 0))
+```
+
+## Parameters
+
+* **location**: the [location](/reference/tiles/location) object for the tile to return it's image.
+
+## Returns
+
+* the [image](/types/image) of the tile at the **location** in the tilemap.
+
+## Example #example
+
+Make a tilemap with some smiley face tiles. Create a new sprite using the image from one of the smiley face tiles. Have the new sprite move across the screen and back.
+
+```blocks
+scene.onHitWall(SpriteKind.Player, function (sprite, location) {
+    sprite.startEffect(effects.bubbles, 500)
+})
+tiles.setCurrentTilemap(tilemap`level1`)
+let tileImage = tiles.tileImageAtLocation(tiles.getTileLocation(0, 0))
+let mySprite = sprites.create(tileImage, SpriteKind.Player)
+mySprite.setBounceOnWall(true)
+mySprite.vx = 50
+```
+
+## See also #seealso
+
+[location](/reference/tiles/location)
+
+```jres
+{
+    "transparency16": {
+        "data": "hwQQABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true
+    },
+    "tile1": {
+        "data": "hwQQABAAAABERERERERERERERERERERERPT/RET/RERE9PRERERPRET0/0RERPRERERERERE9ERERERERET0RERERPRPRPRERERE9E9E9ERERERERET0RERERERERPRERPT/RERE9ERE9PRERERPRET0/0RE/0RERERERERERERERERERERERA==",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "myTile"
+    },
+    "level1": {
+        "id": "level1",
+        "mimeType": "application/mkcd-tilemap",
+        "data": "MTAwYTAwMDgwMDAxMDAwMTAwMDEwMDAxMDAwMTAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAxMDAwMTAwMDEwMDAxMDAwMTAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMA==",
+        "tileset": [
+            "myTiles.transparency16",
+            "myTiles.tile1"
+        ],
+        "displayName": "level1"
+    },
+    "*": {
+        "mimeType": "image/x-mkcd-f4",
+        "dataEncoding": "base64",
+        "namespace": "myTiles"
+    }
+}
+```

package/libs/game/game.ts

@@ -191,6 +191,9 @@ namespace game {
                 effect = win ? winEffect : loseEffect;
             }
 
+            // Save all scores as relevant to the game.
+            info.saveAllScores();
+
             // collect the scores before poping the scenes
             const scoreInfo = info.player1.getState();
             const highScore = info.highScore();

package/libs/game/info.ts

@@ -204,6 +204,19 @@ namespace info {
                 `;
     }
 
+    export function saveAllScores() {
+        const allScoresKey = "all-scores";
+        let allScores: number[];
+        if (players) {
+            allScores = players.filter(item => item.hasScore()).map(item => item.score());
+        }
+        else {
+            allScores = [];
+        }
+
+        settings.writeJSON(allScoresKey, allScores);
+    }
+
     export function saveHighScore() {
         if (players) {
             let hs = 0;

package/libs/game/sim/keymap.ts

@@ -67,9 +67,9 @@ namespace pxsim {
             this.setPlayerKeys(
                 1, // Player 1
                 87, // W - Up
-                83, // D - Down
+                83, // S - Down
                 65, // A - Left
-                83, // S - Right
+                68, // D - Right
                 32, // Space - A
                 13 // Enter - B
             );
@@ -79,7 +79,7 @@ namespace pxsim {
                 73, // I - Up
                 75, // K - Down
                 74, // J - Left
-                75, // K - Right
+                76, // L - Right
                 85, // U - A
                 79 // O - B
             );

package/libs/game/sprite.ts

@@ -857,6 +857,7 @@ class Sprite extends sprites.BaseSprite {
     //% this.shadow=variables_get
     //% this.defl=mySprite
     //% blockNamespace="scene" group="Locations" weight=90
+    //% help=scene/tilemap-location
     tilemapLocation(): tiles.Location {
         const scene = game.currentScene();
         if (!scene.tileMap) return undefined;

package/libs/game/tilemap.ts

@@ -110,7 +110,7 @@ namespace tiles {
         //% this.defl=location
         //% this.shadow=variables_get
         //% group="Locations" blockGap=8
-        //% weight=10
+        //% weight=10 help=tiles/get-neighboring-location
         public getNeighboringLocation(direction: CollisionDirection): Location {
             switch (direction) {
                 case CollisionDirection.Top:

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

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

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___P96980(s) {
+function _main___P96983(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___97223 = (undefined);
-    globals._pollEventQueue___97236 = (undefined);
+    globals._intervals___97226 = (undefined);
+    globals._pollEventQueue___97239 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P96980.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tsl2591.ts","functionName":"<main>","argumentNames":[]}
-_main___P96980.continuations = [  ]
+_main___P96983.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tsl2591.ts","functionName":"<main>","argumentNames":[]}
+_main___P96983.continuations = [  ]
 
-function _main___P96980_mk(s) {
+function _main___P96983_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P96980, depth: s.depth + 1,
+        parent: s, fn: _main___P96983, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -88,5 +88,5 @@ function _main___P96980_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P96980
+return _main___P96983
 })

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

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

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

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