pxt-calliope/docs/reference/game/clear.md
Juri Wolf 77ed2ccfb1
V4 updates (#210)
* update pxt.json files

* Fix button event enums

fixes https://github.com/microsoft/pxt-calliope/issues/206

* Fix Safari CSS Rule for iOS app

fixes https://github.com/microsoft/pxt-calliope/issues/205

* aprove preffered repos

should fix https://github.com/microsoft/pxt-calliope/issues/167
2023-01-11 09:51:27 -08:00

40 lines
775 B
Markdown

# Clear
The clear function for images.
Turn off all the pixels in an [Image](/reference/images/image).
## JavaScript
```sig
export function clear(img: micro_bit.Image)
```
## Parameters
* none
## Example
The following example turns off the pixels of `img` when the A input button is pressed:
```blocks
let img = images.createImage(`
. . . . .
. # # # .
. # # # .
. # # # .
. . . . .
`)
img.showImage(0)
input.onButtonEvent(Button.A, input.buttonEventValue(ButtonEvent.Down), () => {
img.clear()
img.showImage(0)
})
```
## See also
[Image](/reference/images/image), [show animation](/reference/basic/show-animation), [show image](/reference/images/show-image), [scroll image](/reference/images/scroll-image), [create image](/reference/images/create-image)