pxt-calliope/docs/reference/game/clear.md

40 lines
728 B
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Clear
2016-04-02 01:22:47 +02:00
The clear function for images.
2016-03-26 00:47:20 +01:00
2016-04-13 17:27:45 +02:00
Turn off all the pixels in an [Image](/reference/image/image).
2016-03-26 00:47:20 +01:00
### KindScript
```
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:
```
let img = images.createImage(`
. . . . .
. # # # .
. # # # .
. # # # .
. . . . .
`)
img.showImage(0)
input.onButtonPressed(Button.A, () => {
2016-03-26 00:47:20 +01:00
img.clear()
img.showImage(0)
})
```
### See also
2016-04-13 17:27:45 +02:00
[Image](/reference/image/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)
2016-03-26 00:47:20 +01:00