pxt-ev3/docs/reference/brick/set-status-light.md
Peli de Halleux e94ac6f6f1
renaming brick.setLight to brick.setStatusLight (#307)
* renaming brick.setLight to brick.setStatusLight

* updated docs
2018-02-06 22:18:39 -08:00

38 lines
936 B
Markdown

# set Light
Set the light on the brick to a solid or flashing color.
```sig
brick.setStatusLight(StatusLight.Red);
```
## Parameters
* **pattern**: the color or color pattern for the brick light to show. The brick light can have these color patterns:
>* `off`: brick light is off
>* `green`: solid green
>* `red`: solid red
>* `orange`: solid orange
>* `green flash`: flashing green
>* `red flash`: flashing red
>* `orange flash`: flashing orange
>* `green pulse`: pulsing green
>* `red pulse`: pulsing red
>* `orange pulse`: pulsing orange
## Example
Repeatedly show a different color pattern for the brick light.
```blocks
loops.forever(function () {
brick.setStatusLight(StatusLight.Orange)
loops.pause(1000)
brick.setStatusLight(StatusLight.GreenFlash)
loops.pause(2000)
brick.setStatusLight(StatusLight.RedPulse)
loops.pause(2000)
brick.setStatusLight(StatusLight.Off)
loops.pause(500)
})
```