pxt-calliope/docs/reference/images/image.md

57 lines
1.7 KiB
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Image
2016-04-02 01:22:47 +02:00
An image for the micro:bit screen.
2016-03-26 00:47:20 +01:00
### @parent blocks/language
2016-04-13 17:27:45 +02:00
An *Image* is a matrix of pixels to show on the [LED screen](/device/screen)
2016-03-26 00:47:20 +01:00
### Block Editor: Show LEDs
2016-04-13 17:27:45 +02:00
To display an image using the [Block Editor](/blocks/editor):
2016-03-26 00:47:20 +01:00
* click `Basic` , `Show LEDs`, and tap on the LEDs`
* when you're done, return to your code
![](/static/mb/show-leds-1.png)
You should see code similar to this:
### Creating an image
2016-04-13 17:27:45 +02:00
To create an image that you can later modify, see the [create image](/reference/images/create-image) function.
2016-03-26 00:47:20 +01:00
### Block editor: create and show images
2016-04-13 17:27:45 +02:00
To create images using the [Block editor](/blocks/editor):
2016-03-26 00:47:20 +01:00
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:
![](/static/mb/blocks/image-0.png)
### Image functions
2016-04-13 17:27:45 +02:00
* [create image](/reference/images/create-image): create an image from a series of on/off LED states
* [clear](/reference/basic/clear-screen): turn off all the pixels in an image
* [pixel](/reference/images/pixel): get the state of a pixel in an image
* [show-leds](/reference/basic/show-leds): show a single-frame image on the LED screen
* [show image](/reference/images/show-image): show an image on the screen
* [scroll image](/reference/images/scroll-image): scroll an image on the screen
2016-03-26 00:47:20 +01:00
### Lessons
2016-04-13 17:27:45 +02:00
* [smiley](/lessons/smiley)
2016-03-26 00:47:20 +01:00
### See also
2016-04-13 17:27:45 +02:00
[Show LEDs](/reference/basic/show-leds), [create image](/reference/images/create-image), [show image](/reference/images/show-image), [LED screen](/device/screen)
2016-03-26 00:47:20 +01:00