pxt-calliope/docs/reference/game/set.md
Juri Wolf 5f7a8e5301
Updates for V4 (#197)
* update yotta defaults for 16kb devices

* refactor deprecated blocks

* updates for button events

* update button events

* update refference

* update docs

* update docs

* update button event blocks

* update docs

* update block id
2022-08-10 09:36:19 -07:00

1.8 KiB

set (Sprite Property)

Set a value for a sprite property.

game.createSprite(0,0).set(LedSpriteProperty.X, 0);

Parameters

  • property: the property of the Sprite you want to store a value for, like:
  • x - the horizontal location to set the sprite at on the LED screen (0-4)
  • y - the vertical location to set the sprite at on the LED screen (0-4)
  • direction - the direction in degrees for the sprite to go when the next move happens. The degree range is from -180 to 180.
  • brightness - how bright the LED sprite is. Completely dark is 0 and very bright is 255.
  • blink - how fast the sprite is will blink on and off. The blink rate is in milliseconds.
  • value: the a number value to set for the property.

Example

Make an LED sprite move to random locations on the screen. Use button A to freeze and unfreeze the sprite while it's moving. When the sprite is frozen, it will blink and dim to half brightness.

input.onButtonEvent(Button.A, input.buttonEventClick(), function () {
    if (freeze) {
        sprite.set(LedSpriteProperty.Brightness, 255)
        sprite.set(LedSpriteProperty.Blink, 0)
    } else {
        sprite.set(LedSpriteProperty.Brightness, 128)
        sprite.set(LedSpriteProperty.Blink, 200)
    }
    freeze = !(freeze)
})
let freeze = false
let sprite: game.LedSprite = null
sprite = game.createSprite(0, 0)
basic.forever(function () {
    if (!(freeze)) {
        sprite.set(LedSpriteProperty.X, randint(0, 4))
        sprite.set(LedSpriteProperty.Y, randint(0, 4))
    }
    basic.pause(500)
})

See also

turn, brightness, change sprite property, get sprite property