pxt-calliope/docs/reference/images/image.md
Sam El-Husseini e3975e65e5 pxt-microbit Accessibility PR ()
* Accessibility changes
2017-09-07 13:42:08 -07:00

1.5 KiB

Image

An image for the @boardname@ screen.

@parent blocks/language

An Image is a matrix of pixels to show on the LED screen

Block Editor: Show LEDs

To display an image:

  • click Basic , Show LEDs, and tap on the LEDs`
basic.showLeds(`
    . . . . .
    . # . # .
    . . . . .
    # . . . #
    . # # # .
    `)

Creating an image

To create an image that you can later modify, see the create image function.

  1. Click the Images category on the left.

  2. Drag and drop the show image block into your code.

  3. Drag and drop the create image or create big image block onto the show image block so that they connect.

  4. Make an image on the create image block by clicking on the squares.

You should see code similar to this:

Image functions

  • create image: create an image from a series of on/off LED states
  • clear: turn off all the pixels in an image
  • pixel: get the state of a pixel in an image
  • show-leds: show a single-frame image on the LED screen
  • show image: show an image on the screen
  • scroll image: scroll an image on the screen

See also

Show LEDs, create image, show image, LED screen