pxt-calliope/docs/reference/input/light-level.md
Peli de Halleux 7da483f258 fixing links
2016-04-18 09:47:34 -07:00

31 lines
778 B
Markdown

# Light Level
Gets the light level from ``0`` (dark) to ``255`` (bright). The light is measured by using various LEDs from the screen.
This function will return ``0`` on the first call to this method, a light reading will be available after the display has activated the light sensor for the first time.
```sig
input.lightLevel();
```
### Returns
* [Number](/reference/types/number) - light level from ``0`` (dark) to ``255`` (bright).
### Example: chart light level
Use `plot bar chart` to visual the influence of various light source on the light level.
```blocks
basic.forever(() => {
led.plotBarGraph(input.lightLevel(), 255)
})
```
### Lessons
### See also
[acceleration](/reference/input/acceleration), [compass-heading](/reference/input/compass-heading)