pxt-common-packages 9.5.1 → 9.5.2

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

@@ -0,0 +1,83 @@
+# tilemap Location
+
+Get the location of a sprite on the tilemap.
+
+```sig
+sprites.create(null).tilemapLocation()
+```
+
+A tile location object represents a column and a row position in the tilemap. Location objects are used to get and set tiles or tile information for specific places in the tilemap.
+
+The tile that is under the center of the sprite is considered as the sprite's tilemap **location**. A sprite may overlap multiple tiles but the tile under the sprite's `x` and `y` coordinate properties is its tilemap location.
+
+## Returns
+
+* a tile [location](/reference/scene/location) object for the location of the sprite on the tilemap.
+
+## Example #example
+
+Make a grid tilemap with two tile colors. Create a sprite to appear on the tilemap. Display the column and row postion of the sprite on the tilemap.
+
+```blocks
+tiles.setCurrentTilemap(tilemap`level1`)
+let mySprite = sprites.create(img`
+    . . 4 4 4 . . . . 4 4 4 . . . . 
+    . 4 5 5 5 e . . e 5 5 5 4 . . . 
+    4 5 5 5 5 5 e e 5 5 5 5 5 4 . . 
+    4 5 5 4 4 5 5 5 5 4 4 5 5 4 . . 
+    e 5 4 4 5 5 5 5 5 5 4 4 5 e . . 
+    . e e 5 5 5 5 5 5 5 5 e e . . . 
+    . . e 5 f 5 5 5 5 f 5 e . . . . 
+    . . f 5 5 5 4 4 5 5 5 f . . f f 
+    . . f 4 5 5 f f 5 5 6 f . f 5 f 
+    . . . f 6 6 6 6 6 6 4 4 f 5 5 f 
+    . . . f 4 5 5 5 5 5 5 4 4 5 f . 
+    . . . f 5 5 5 5 5 4 5 5 f f . . 
+    . . . f 5 f f f 5 f f 5 f . . . 
+    . . . f f . . f f . . f f . . . 
+    `, SpriteKind.Player)
+let tmLocation = mySprite.tilemapLocation()
+mySprite.sayText("col: " + tmLocation.column + " row: " + tmLocation.row)
+```
+
+## See also #seealso
+
+[get tile location](/reference/scene/get-tile-location)
+
+```jres
+{
+    "transparency16": {
+        "data": "hwQQABAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA==",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true
+    },
+    "tile1": {
+        "data": "hwQQABAAAADu7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7u7g==",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "myTile"
+    },
+    "tile2": {
+        "data": "hwQQABAAAACZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmQ==",
+        "mimeType": "image/x-mkcd-f4",
+        "tilemapTile": true,
+        "displayName": "myTile0"
+    },
+    "level1": {
+        "id": "level1",
+        "mimeType": "application/mkcd-tilemap",
+        "data": "MTAwYTAwMDgwMDAyMDEwMjAxMDIwMTAyMDEwMjAxMDEwMjAxMDIwMTAyMDEwMjAxMDIwMjAxMDIwMTAyMDEwMjAxMDIwMTAxMDIwMTAyMDEwMjAxMDIwMTAyMDIwMTAyMDEwMjAxMDIwMTAyMDEwMTAyMDEwMjAxMDIwMTAyMDEwMjAyMDEwMjAxMDIwMTAyMDEwMjAxMDEwMjAxMDIwMTAyMDEwMjAxMDIwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMA==",
+        "tileset": [
+            "myTiles.transparency16",
+            "myTiles.tile1",
+            "myTiles.tile2"
+        ],
+        "displayName": "level1"
+    },
+    "*": {
+        "mimeType": "image/x-mkcd-f4",
+        "dataEncoding": "base64",
+        "namespace": "myTiles"
+    }
+}
+```

package/libs/game/docs/reference/sprites/destroy-all-sprites-of-kind.md

@@ -0,0 +1,74 @@
+# destroy All Sprites Of Kind
+
+Destroy all the sprites of a certain kind.
+
+```sig
+sprites.destroyAllSpritesOfKind(SpriteKind.Enemy)
+```
+
+You can destroy all of the current sprites of a particular kind. For example, you could explode all of the `Enemy` sprites in your game by destroying them with a disintegrating particle effect.
+
+## Parameters
+
+* **kind**: the kind of the sprites you want to destroy, such as `Player` or `Enemy`.
+* **effect**: a particle effect to show when a sprite is destroyed.
+* **duration**: the time in milliseconds that the **effect** will show.
+
+## Example #example
+
+Make a game where your player must avoid contact with `Blob` sprites to stay alive. Send the blobs at random speeds from the right side of the screen. Give your player a superpower to zap all of the current blobs with one press of button `A`.
+
+```blocks
+namespace SpriteKind {
+    export const Blob = SpriteKind.create()
+}
+controller.A.onEvent(ControllerButtonEvent.Pressed, function () {
+    sprites.destroyAllSpritesOfKind(SpriteKind.Blob, effects.disintegrate, 100)
+})
+sprites.onOverlap(SpriteKind.Player, SpriteKind.Blob, function (sprite, otherSprite) {
+    info.changeLifeBy(-1)
+})
+let blob: Sprite = null
+info.setLife(3)
+let mySprite = sprites.create(img`
+    . . . . . f f f f . . . . . 
+    . . . f f 5 5 5 5 f f . . . 
+    . . f 5 5 5 5 5 5 5 5 f . . 
+    . f 5 5 5 5 5 5 5 5 5 5 f . 
+    . f 5 5 5 d b b d 5 5 5 f . 
+    f 5 5 5 b 4 4 4 4 b 5 5 5 f 
+    f 5 5 c c 4 4 4 4 c c 5 5 f 
+    f b b f b f 4 4 f b f b b f 
+    f b b 4 1 f d d f 1 4 b b f 
+    . f b f d d d d d d f b f . 
+    . f e f e 4 4 4 4 e f e f . 
+    . e 4 f 6 9 9 9 9 6 f 4 e . 
+    . 4 d c 9 9 9 9 9 9 c d 4 . 
+    . 4 f b 3 b 3 b 3 b b f 4 . 
+    . . f f 3 b 3 b 3 3 f f . . 
+    . . . . f f b b f f . . . . 
+    `, SpriteKind.Player)
+controller.moveSprite(mySprite)
+mySprite.left = 10
+game.onUpdateInterval(500, function () {
+    blob = sprites.create(img`
+        . 2 2 2 . 2 2 . 
+        2 2 5 2 2 2 2 2 
+        2 f 2 2 5 2 2 . 
+        2 2 2 2 2 2 2 2 
+        2 2 2 2 2 2 2 2 
+        2 2 f 2 f 2 2 2 
+        . 2 2 2 2 2 2 . 
+        . 2 . 2 2 5 2 . 
+        `, SpriteKind.Blob)
+    blob.setFlag(SpriteFlag.AutoDestroy, true)
+    blob.setPosition(scene.screenWidth(), randint(0, scene.screenHeight()))
+    blob.vx = randint(-10, -50)
+})
+```
+
+## See also #seealso
+
+[start effect](/reference/sprites/sprite/start-effect),
+[destroy](/reference/sprites/sprite/destroy),
+[on destroyed](/reference/sprites/on-destroyed),

package/libs/game/docs/reference/sprites/sprite/change-scale.md

@@ -0,0 +1,65 @@
+# change Scale
+
+Change the scale factor for a sprite by an increment or decrement.
+
+```sig
+sprites.create(null).changeScale(1, ScaleAnchor.Middle)
+```
+
+You can increase or decrease a sprite's size from it's current size by a certain amount. If a sprite's scale is `2` and you change it by `1`, then the sprite is now `3` times larger than it's original size. The sprite's size will shrink if you give a negative value. If you use `-2` for the change **value**, the sprite's new size will be half of what is was before.
+
+The **anchor** determines which direction the sprite will expand or shrink. If you increase the scale from the `middle`, the sprite will grow equally from it's center. If you choose to scale from the `bottom left`, the sprite will grow toward the top right of the screen.
+
+## Parameters
+
+* **value**: a [number](/types/number) to change the sprite's scale by.
+* **anchor**: an anchor point to scale the sprite from:
+>* `middle`
+>* `top`
+>* `left`
+>* `right`
+>* `bottom`
+>* `top left`
+>* `top right`
+>* `bottom right`
+>* `bottom left`
+
+## Examples #example
+
+### Rescale sprite
+
+Create a sprite with a square image. In a game update event, make the sprite grow and shrink continuously.
+
+```blocks
+let scaleFactor = 0
+let mySprite = sprites.create(img`
+    2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 
+    2 5 5 5 7 7 7 7 7 7 7 7 5 5 5 2 
+    2 5 5 7 7 7 7 7 7 7 7 7 7 5 5 2 
+    2 5 7 7 7 7 7 7 7 7 7 7 7 7 5 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 8 8 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 8 8 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 5 7 7 7 7 7 7 7 7 7 7 7 7 5 2 
+    2 5 5 7 7 7 7 7 7 7 7 7 7 5 5 2 
+    2 5 5 5 7 7 7 7 7 7 7 7 5 5 5 2 
+    2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 
+    `, SpriteKind.Player)
+game.onUpdateInterval(500, function () {
+    if (mySprite.scale == 1) {
+        scaleFactor = 1
+    } else if (mySprite.scale == 7) {
+        scaleFactor = -1
+    }
+    mySprite.changeScale(scaleFactor, ScaleAnchor.Middle)
+})
+```
+
+## See also #seealso
+
+[set scale](/reference/sprites/sprite/set-scale)

package/libs/game/docs/reference/sprites/sprite/fx.md

@@ -1,52 +1,52 @@
-# fy (property)
+# fx (property)
 
-Get or set the friction opposing a sprite's motion in the vertical direction.
+Get or set the friction opposing a sprite's motion in the horizontal direction.
 
 ## Get
 
-Get the vertical friction on the sprite.
+Get the horizontal friction on the sprite.
 
 ```block
 let mySprite: Sprite = null
 
-let horzAccel = mySprite.fy
+let horzAccel = mySprite.fx
 ```
 
 ```typescript-ignorelet
-horzAccel = mySprite.fy
+horzAccel = mySprite.fx
 ```
 
 ### Returns
 
-* a [number](/types/number) that is the current vertical friction of the sprite.
+* a [number](/types/number) that is the current horizontal friction of the sprite.
 
 ## Set
 
-Set the vertical friction for the sprite.
+Set the horizontal friction for the sprite.
 
 ```block
 let mySprite: Sprite = null
 
-mySprite.fy = 0
+mySprite.fx = 0
 ```
 
 ```typescript-ignore
-mySprite.fy = 0
+mySprite.fx = 0
 ```
 
 ### Parameter
 
-* **value**: the new vertical friction opposing the sprite's motion in pixels per second, per second.
+* **value**: the new horizontal friction opposing the sprite's motion in pixels per second, per second.
 
-## Sprite vertical friction
+## Sprite horizontal friction
 
-Friction is an opposing force against the motion of a sprite. If a sprite has a vertical velocity (`vy`), it's friction will slow the sprite down until it's vertical velocity becomes `0`. This is similar to setting an opposite vertical acceleration but the opposite acceleration goes away once the sprite stops.
+Friction is an opposing force against the motion of a sprite. If a sprite has a horizontal velocity (`vx`), it's friction will slow the sprite down until it's horizontal velocity becomes `0`. This is similar to setting an opposite horizontal acceleration but the opposite acceleration goes away once the sprite stops.
 
 ## Examples #example
 
 ### Measure stopping time #ex1
 
-Move the sprite from top to bottom across the screen. Use the correct amount of friction (`fy`) to make the sprite stop at `3` seconds.
+Move the sprite from left to right across the screen. Use the correct amount of friction (`fx`) to make the sprite stop at `3` seconds.
 
 ```blocks
 let stopTime = 0
@@ -70,13 +70,13 @@ let mySprite = sprites.create(img`
     . . . . . . . . . . . . . . . . 
     `, SpriteKind.Player)
 mySprite.setStayInScreen(true)
-mySprite.top = 0
-mySprite.fy = 20
-mySprite.vy = 60
+mySprite.left = 0
+mySprite.fx = 30
+mySprite.vx = 90
 game.onUpdateInterval(100, function () {
     if (counting) {
         stopTime += 0.1
-        if (mySprite.vy == 0) {
+        if (mySprite.vx == 0) {
             counting = false
             mySprite.sayText("" + stopTime + "sec", 5000, false)
         }
@@ -84,9 +84,9 @@ game.onUpdateInterval(100, function () {
 })
 ```
 
-### Skipppng sprite #ex2
+### Skipping sprite #ex2
 
-Make a sprite move from the top to the bottom. Make it skip to the right once every second.
+Make a sprite move from the left to the right. Make it skip to the right once every second.
 
 ```blocks
 let mySprite = sprites.create(img`
@@ -108,16 +108,16 @@ let mySprite = sprites.create(img`
     . . . . . . . . . . . . . . . . 
     `, SpriteKind.Player)
 mySprite.setStayInScreen(true)
-mySprite.top = 0
-mySprite.fy = 60
-mySprite.vy = 60
+mySprite.left = 0
+mySprite.fx = 80
+mySprite.vx = 80
 for (let index = 0; index < 3; index++) {
-    mySprite.vy = 60
+    mySprite.vx = 80
     pause(1000)
 }
 ```
 
 ## See also #seealso
 
-[fx](/reference/sprites/sprite/fx),
-[ay](/reference/sprites/sprite/ay)
+[fy](/reference/sprites/sprite/fy),
+[ax](/reference/sprites/sprite/ax)

package/libs/game/docs/reference/sprites/sprite/fy.md

@@ -1,52 +1,52 @@
 # fy (property)
 
-Get or set the friction opposing a sprite's motion in the horizontal direction.
+Get or set the friction opposing a sprite's motion in the vertical direction.
 
 ## Get
 
-Get the horizontal friction on the sprite.
+Get the vertical friction on the sprite.
 
 ```block
 let mySprite: Sprite = null
 
-let horzAccel = mySprite.fx
+let horzAccel = mySprite.fy
 ```
 
 ```typescript-ignorelet
-horzAccel = mySprite.fx
+horzAccel = mySprite.fy
 ```
 
 ### Returns
 
-* a [number](/types/number) that is the current horizontal friction of the sprite.
+* a [number](/types/number) that is the current vertical friction of the sprite.
 
 ## Set
 
-Set the horizontal friction for the sprite.
+Set the vertical friction for the sprite.
 
 ```block
 let mySprite: Sprite = null
 
-mySprite.fx = 0
+mySprite.fy = 0
 ```
 
 ```typescript-ignore
-mySprite.fx = 0
+mySprite.fy = 0
 ```
 
 ### Parameter
 
-* **value**: the new horizontal friction opposing the sprite's motion in pixels per second, per second.
+* **value**: the new vertical friction opposing the sprite's motion in pixels per second, per second.
 
-## Sprite horizontal friction
+## Sprite vertical friction
 
-Friction is an opposing force against the motion of a sprite. If a sprite has a horizontal velocity (`vx`), it's friction will slow the sprite down until it's horizontal velocity becomes `0`. This is similar to setting an opposite horizontal acceleration but the opposite acceleration goes away once the sprite stops.
+Friction is an opposing force against the motion of a sprite. If a sprite has a vertical velocity (`vy`), it's friction will slow the sprite down until it's vertical velocity becomes `0`. This is similar to setting an opposite vertical acceleration but the opposite acceleration goes away once the sprite stops.
 
 ## Examples #example
 
 ### Measure stopping time #ex1
 
-Move the sprite from left to right across the screen. Use the correct amount of friction (`fx`) to make the sprite stop at `3` seconds.
+Move the sprite from top to bottom across the screen. Use the correct amount of friction (`fy`) to make the sprite stop at `3` seconds.
 
 ```blocks
 let stopTime = 0
@@ -70,13 +70,13 @@ let mySprite = sprites.create(img`
     . . . . . . . . . . . . . . . . 
     `, SpriteKind.Player)
 mySprite.setStayInScreen(true)
-mySprite.left = 0
-mySprite.fx = 30
-mySprite.vx = 90
+mySprite.top = 0
+mySprite.fy = 20
+mySprite.vy = 60
 game.onUpdateInterval(100, function () {
     if (counting) {
         stopTime += 0.1
-        if (mySprite.vx == 0) {
+        if (mySprite.vy == 0) {
             counting = false
             mySprite.sayText("" + stopTime + "sec", 5000, false)
         }
@@ -84,9 +84,9 @@ game.onUpdateInterval(100, function () {
 })
 ```
 
-### Skipppng sprite #ex2
+### Skipping sprite #ex2
 
-Make a sprite move from the left to the right. Make it skip to the right once every second.
+Make a sprite move from the top to the bottom. Make it skip to the right once every second.
 
 ```blocks
 let mySprite = sprites.create(img`
@@ -108,16 +108,16 @@ let mySprite = sprites.create(img`
     . . . . . . . . . . . . . . . . 
     `, SpriteKind.Player)
 mySprite.setStayInScreen(true)
-mySprite.left = 0
-mySprite.fx = 80
-mySprite.vx = 80
+mySprite.top = 0
+mySprite.fy = 60
+mySprite.vy = 60
 for (let index = 0; index < 3; index++) {
-    mySprite.vx = 80
+    mySprite.vy = 60
     pause(1000)
 }
 ```
 
 ## See also #seealso
 
-[fy](/reference/sprites/sprite/fy),
-[ax](/reference/sprites/sprite/ax)
+[fx](/reference/sprites/sprite/fx),
+[ay](/reference/sprites/sprite/ay)

package/libs/game/docs/reference/sprites/sprite/scale.md

@@ -0,0 +1,80 @@
+# scale (property)
+
+Get or set the scaling factor for the width and height of a sprite.
+
+## Get
+
+Get the scale for the sprite.
+
+```block
+let mySprite: Sprite = null
+
+let xScale = mySprite.scale
+```
+
+```typescript-ignorelet
+xScale = mySprite.scale
+```
+
+### Returns
+
+* a [number](/types/number) that is the current scale for the sprite.
+
+## Set
+
+Set the scale for the sprite.
+
+```block
+let mySprite: Sprite = null
+
+mySprite.scale = 2
+```
+
+```typescript-ignore
+mySprite.scale = 2
+```
+
+### Parameter
+
+* **value**: the new scale factor for the size of the sprite.
+
+## Examples #example
+
+### Stretch and shrink size #ex1
+
+Scale a sprite's size by `1` more every second. Expand while it's small and contract when it's large.
+
+```blocks
+let expand = 0
+let mySprite = sprites.create(img`
+    2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 
+    `, SpriteKind.Player)
+game.onUpdateInterval(1000, function () {
+    if (mySprite.scale == 1) {
+        expand = 1
+    } else if (mySprite.scale == 6) {
+        expand = -1
+    }
+    mySprite.scale += expand
+})
+```
+
+## See also #seealso
+
+[sx](/reference/sprites/sprite/sx),
+[sy](/reference/sprites/sprite/sy)

package/libs/game/docs/reference/sprites/sprite/set-scale.md

@@ -0,0 +1,79 @@
+# set Scale
+
+Set the scale factor for a sprite based on an anchor point.
+
+```sig
+sprites.create(null).setScale(1, ScaleAnchor.Middle)
+```
+
+You can increase or decrease a sprite from it's current size to a new size by setting a scale value. If a sprite's scale is set to `2`, then the sprite's new size is two times larger than it's original size. The sprite's size will shrink if you give a negative value. If you use `-3` for the scale value, the sprite's new size will three times smaller than it's original size.
+
+The **anchor** determines which direction the sprite will expand or shrink. If you increase the scale from the `middle`, the sprite will grow equally from it's center. If you choose to scale from the `bottom left`, the sprite will grow toward the top right of the screen.
+
+## Parameters
+
+* **value**: a [number](/types/number) that is the scale factor for the sprite.
+* **anchor**: an anchor point to scale the sprite from:
+>* `middle`
+>* `top`
+>* `left`
+>* `right`
+>* `bottom`
+>* `top left`
+>* `top right`
+>* `bottom right`
+>* `bottom left`
+
+## Examples #example
+
+### Scale in 4 directions
+
+Create a sprite with a square image. Make the sprite grow and shrink by `3` in each of the 4 corner directions.
+
+```blocks
+let scaleZone = 0
+let mySprite = sprites.create(img`
+    2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 
+    2 5 5 5 7 7 7 7 7 7 7 7 5 5 5 2 
+    2 5 5 7 7 7 7 7 7 7 7 7 7 5 5 2 
+    2 5 7 7 7 7 7 7 7 7 7 7 7 7 5 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 8 8 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 8 8 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 7 7 7 7 7 7 7 7 7 7 7 7 7 7 2 
+    2 5 7 7 7 7 7 7 7 7 7 7 7 7 5 2 
+    2 5 5 7 7 7 7 7 7 7 7 7 7 5 5 2 
+    2 5 5 5 7 7 7 7 7 7 7 7 5 5 5 2 
+    2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2 
+    `, SpriteKind.Player)
+game.onUpdateInterval(500, function () {
+    if (scaleZone == 0) {
+        mySprite.setScale(3, ScaleAnchor.TopLeft)
+    } else if (scaleZone == 1) {
+        mySprite.setScale(1, ScaleAnchor.TopLeft)
+    } else if (scaleZone == 2) {
+        mySprite.setScale(3, ScaleAnchor.TopRight)
+    } else if (scaleZone == 3) {
+        mySprite.setScale(1, ScaleAnchor.TopRight)
+    } else if (scaleZone == 4) {
+        mySprite.setScale(3, ScaleAnchor.BottomRight)
+    } else if (scaleZone == 5) {
+        mySprite.setScale(1, ScaleAnchor.BottomRight)
+    } else if (scaleZone == 6) {
+        mySprite.setScale(3, ScaleAnchor.BottomLeft)
+    } else if (scaleZone == 7) {
+        mySprite.setScale(1, ScaleAnchor.BottomLeft)
+    } else {
+        scaleZone = -1
+    }
+    scaleZone += 1
+})
+```
+
+## See also #seealso
+
+[change scale](/reference/sprites/sprite/change-scale)