pxt-common-packages 10.1.2 → 10.1.5

package/libs/game/docs/reference/effects/clear-particles.md

@@ -65,6 +65,43 @@ logs = sprites.create(img`
 logs.startEffect(effects.fire)
 ```
 
+### Immediately clear all particles
+
+The clear particles block gets rid of the sources, but if you want to immediately get rid of all particles on the screen you need to also call `particles.clearAll()`, which is currently only available in text coding.
+
+```typescript
+let logs: Sprite = null
+controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
+    effects.clearParticles(logs)
+    logs.startEffect(effects.blizzard, 750)
+    logs.startEffect(effects.bubbles, 2000)
+})
+
+controller.B.onEvent(ControllerButtonEvent.Pressed, function () {
+    effects.clearParticles(logs)
+    particles.clearAll()
+})
+logs = sprites.create(img`
+    . . . . . . . . . . . . . . . .
+    . . . . . . . . . . . . . . . .
+    . . . . . . . . . . . . . . . .
+    . . . . . . . . . . . . . . . .
+    . . . . . . . . . . . . . . . .
+    . . . . . . . . . . . . e . . .
+    . . e e . . . . . . . e e . . .
+    . . . e e e . . . e e d e . . .
+    . . . e d e e e . e d e e . . .
+    . . . e e d d e e d d e . . . .
+    . . . . . e e d d e e . . . . .
+    . . . e e d e e d d e . . . . .
+    . . e e d d e e e d d e e . . .
+    . . e d d e e . e e e d e e . .
+    . . e e e . . . . . e e e . . .
+    . . . . . . . . . . . . . . . .
+`, 0)
+logs.startEffect(effects.fire)
+```
+
 ## See also #seealso
 
 [start effect](/reference/sprites/sprite/start-effect)

package/libs/game/hitbox.ts

@@ -1,6 +1,6 @@
 namespace game {
     export class Hitbox {
-        hash: Fx8;
+        hash: number;
         parent: Sprite;
         ox: Fx8;
         oy: Fx8;
@@ -46,7 +46,48 @@ namespace game {
             return (x >= this.left) && (x <= this.right) && (y >= this.top) && (y <= this.bottom);
         }
 
+        updateIfInvalid() {
+            if (this.isValid())
+                return;
+
+            const newHitBox = game.calculateHitBox(this.parent);
+
+            const oMinX = this.ox;
+            const oMinY = this.oy;
+            const oMaxX = Fx.add(oMinX, this.width);
+            const oMaxY = Fx.add(oMinY, this.height);
+
+            const nMinX = newHitBox.ox;
+            const nMinY = newHitBox.oy;
+            const nMaxX = Fx.add(nMinX, newHitBox.width);
+            const nMaxY = Fx.add(nMinY, newHitBox.height);
+
+            // total diff in x / y corners between the two hitboxes
+            const xDiff = Fx.add(
+                Fx.abs(Fx.sub(oMinX, nMinX)),
+                Fx.abs(Fx.sub(oMaxX, nMaxX))
+            );
+            const yDiff = Fx.add(
+                Fx.abs(Fx.sub(oMinY, nMinY)),
+                Fx.abs(Fx.sub(oMaxY, nMaxY))
+            );
+
+            // If it's just a small change to the hitbox on one axis,
+            // don't change the dimensions to avoid random clipping
+            if (xDiff > Fx.twoFx8) {
+                this.ox = nMinX;
+                this.width = newHitBox.width;
+            }
+            if (yDiff > Fx.twoFx8) {
+                this.oy = nMinY;
+                this.height = newHitBox.height;
+            }
+            this.hash = newHitBox.hash;
+        }
+
         overlapsWith(other: Hitbox): boolean {
+            this.updateIfInvalid();
+            other.updateIfInvalid();
             if (this.contains(other.left, other.top)) return true;
             if (this.contains(other.left, other.bottom)) return true;
             if (this.contains(other.right, other.top)) return true;

package/libs/game/sim/keymap.ts

@@ -90,7 +90,7 @@ namespace pxsim {
                 80, // P - Screenshot
                 82, // R - Gif
                 192, // Menu - '`' (backtick) button
-                50 // Reset - Backspace button
+                8 // Reset - Backspace button
             );
 
             // Player 1 alternate mapping. This is cleared when the game sets any player keys explicitly

package/libs/game/sprite.ts

@@ -337,7 +337,7 @@ class Sprite extends sprites.BaseSprite {
     }
 
     calcDimensionalHash() {
-        return Fx.mul(Fx.mul(this._width, this._height), Fx8(this._image.revision()));
+        return this._image.revision() + Fx.toIntShifted(this._width, 8) + Fx.toIntShifted(this._height, 16);
     }
 
     resetHitbox() {
@@ -346,43 +346,10 @@ class Sprite extends sprites.BaseSprite {
     }
 
     setHitbox() {
-        const newHitBox = game.calculateHitBox(this);
-
-        if (!this._hitbox || this._hitbox.isValid()) {
-            this._hitbox = newHitBox;
-            return;
-        }
-
-        const oMinX = this._hitbox.ox;
-        const oMinY = this._hitbox.oy;
-        const oMaxX = Fx.add(oMinX, this._hitbox.width);
-        const oMaxY = Fx.add(oMinY, this._hitbox.height);
-
-        const nMinX = newHitBox.ox;
-        const nMinY = newHitBox.oy;
-        const nMaxX = Fx.add(nMinX, newHitBox.width);
-        const nMaxY = Fx.add(nMinY, newHitBox.height);
-
-        // total diff in x / y corners between the two hitboxes
-        const xDiff = Fx.add(
-            Fx.abs(Fx.sub(oMinX, nMinX)),
-            Fx.abs(Fx.sub(oMaxX, nMaxX))
-        );
-        const yDiff = Fx.add(
-            Fx.abs(Fx.sub(oMinY, nMinY)),
-            Fx.abs(Fx.sub(oMaxY, nMaxY))
-        );
-
-        // If it's just a small change to the hitbox on one axis,
-        // don't change the dimensions to avoid random clipping
-        this._hitbox = newHitBox;
-        if (xDiff <= Fx.twoFx8) {
-            this._hitbox.ox = oMinX;
-            this._hitbox.width = Fx.sub(oMaxX, oMinX);
-        }
-        if (yDiff <= Fx.twoFx8) {
-            this._hitbox.oy = oMinY;
-            this._hitbox.height = Fx.sub(oMaxY, oMinY);
+        if (this._hitbox) {
+            this._hitbox.updateIfInvalid();
+        } else {
+            this._hitbox = game.calculateHitBox(this);
         }
     }
 

package/libs/game/temp.d.ts

@@ -36,4 +36,10 @@ declare namespace Math {
     function sign(x: number): number;
 }
 
+declare interface Image {
+    revision(): number;
+    isStatic(): boolean;
+    equals(img: Image): boolean;
+}
+
 declare const img: any;

package/libs/game/tsconfig.json

@@ -0,0 +1,21 @@
+{
+    "compilerOptions": {
+        "target": "es5",
+        "noImplicitAny": true,
+        "noImplicitReturns": true,
+        "outDir": "../built",
+        "newLine": "LF",
+        "sourceMap": false,
+        "types": []
+    },
+    "include": [
+        "*.ts",
+        "../settings/*.ts",
+        "../screen/*.ts",
+        "../mixer/*.ts",
+        "../power/*.ts",
+        "../core/*.ts",
+        "../base/*.ts",
+        "../../../pxt/libs/pxt-common/*.ts"
+    ]
+}

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

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

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___P96998(s) {
+function _main___P96995(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___97241 = (undefined);
-    globals._pollEventQueue___97254 = (undefined);
+    globals._intervals___97238 = (undefined);
+    globals._pollEventQueue___97251 = (undefined);
     r0 = undefined;
     return leave(s, r0)
   default: oops()
 } } }
-_main___P96998.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tsl2591.ts","functionName":"<main>","argumentNames":[]}
-_main___P96998.continuations = [  ]
+_main___P96995.info = {"start":0,"length":0,"line":0,"column":0,"endLine":0,"endColumn":0,"fileName":"tsl2591.ts","functionName":"<main>","argumentNames":[]}
+_main___P96995.continuations = [  ]
 
-function _main___P96998_mk(s) {
+function _main___P96995_mk(s) {
     checkStack(s.depth);
     return {
-        parent: s, fn: _main___P96998, depth: s.depth + 1,
+        parent: s, fn: _main___P96995, depth: s.depth + 1,
         pc: 0, retval: undefined, r0: undefined, overwrittenPC: false, lambdaArgs: null,
 } }
 
@@ -88,5 +88,5 @@ function _main___P96998_mk(s) {
 
 const breakpoints = setupDebugger(1, [])
 
-return _main___P96998
+return _main___P96995
 })

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

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

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

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