pxt-calliope/docs/reference/led/unplot.md

54 lines
1.3 KiB
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Unplot
2016-04-13 17:27:45 +02:00
Turn off a LED light on the [LED screen](/device/screen). Specify which LED using x, y coordinates. Use [plot](/reference/led/plot) to turn a LED on.
2016-03-26 00:47:20 +01:00
```sig
led.unplot(0,0)
```
### Parameters
2016-04-13 17:27:45 +02:00
* x - [Number](/reference/types/number); the *x coordinate* or horizontal position (0, 1, 2, 3, 4)
* y - [Number](/reference/types/number); the *y coordinate* or vertical position (0, 1, 2, 3, 4)
2016-03-26 00:47:20 +01:00
2016-04-13 17:27:45 +02:00
If a parameter is [out of bounds](/reference/out-of-bounds) (a value other than 0-4), this function will do nothing.
2016-03-26 00:47:20 +01:00
### x, y coordinates?
2016-04-13 17:27:45 +02:00
The LED screen is made up of 25 LEDs arranged in a 5x5 grid. To figure out the ``x``, ``y`` coordinates, see [LED screen](/device/screen).
2016-03-26 00:47:20 +01:00
This code turns off centre LED:
```blocks
led.unplot(2, 2)
```
### Get the LED on/off state
2016-04-13 17:27:45 +02:00
Use the [point](/reference/led/point) function to find out if a LED is on or off.
2016-03-26 00:47:20 +01:00
### Example: toggle off
This code creates and shows an image on the micro:bit screen, and then clears the centre LED using `unplot`:
```blocks
basic.showLeds(`
. . # . .
. . # . .
# # # # #
. . # . .
. . # . .
`)
basic.pause(500)
led.unplot(2, 2)
```
### Lessons
2016-04-13 17:27:45 +02:00
[strobe light](/lessons/strobe-light)
2016-03-26 00:47:20 +01:00
### See also
2016-04-13 17:27:45 +02:00
[plot](/reference/led/plot), [point](/reference/led/point), [LED screen](/device/screen), [create image](/reference/images/create-image)
2016-03-26 00:47:20 +01:00