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

Clear

The clear function for images. #clear #docs

Turn off all the pixels in an Image.

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, () => {
    img.clear()
    img.showImage(0)
})

See also

Image, show animation, show image, scroll image, create image