pxt-calliope/docs/reference/js/image.md
2016-04-13 08:27:45 -07:00

2.4 KiB

Image

An image for the micro:bit screen.

@parent js/language

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

Touch Develop editor: plot an image

To display an image using the Touch Develop editor:

  • click image , plot image, and then edit
  • click the rectangles to create an image
  • when you're done, click ok to return to your code

You should see code similar to this:

basic.plotImage(`
. . . . .
. # . # .
. . # . .
. # . # .
. . . . .
`)

Creating an image

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

Block editor: create and show images

To create images using the Block editor:

  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.

Global image variables

Images that you create in the Touch Develop editor are local variables. To promote a local image variable to a global variable, select the local image variable and click promote to data. The var keyword changes to the data symbol data->.

Image functions

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

Lessons

See also

plot image, create image, show image, LED screen