lejos.robotics
Interface LightDetector

All Known Subinterfaces:
LampLightDetector
All Known Implementing Classes:
ColorSensor, LightSensor, RCXLightSensor

public interface LightDetector

A platform independent implementation for sensors that can detect white light levels.

Author:
BB

Method Summary
 int getHigh()
          The highest raw light value this sensor can return from intense bright light.
 int getLightValue()
          Returns the calibrated and normalized brightness of the white light detected.
 int getLow()
          The lowest raw light value this sensor can return in pitch black darkness.
 int getNormalizedLightValue()
          Returns the normalized value of the brightness of the white light detected, such that the lowest value is darkness and the highest value is intense bright light.
 

Method Detail

getLightValue

int getLightValue()
Returns the calibrated and normalized brightness of the white light detected.

Returns:
A brightness value between 0 and 100%, with 0 = darkness and 100 = intense sunlight

getNormalizedLightValue

int getNormalizedLightValue()
Returns the normalized value of the brightness of the white light detected, such that the lowest value is darkness and the highest value is intense bright light.

Returns:
A raw value, between getLow() and getHigh(). Usually between 0 and 1023 but can be anything depending on hardware. low values = dark, high values = bright

getHigh

int getHigh()
The highest raw light value this sensor can return from intense bright light.

Returns:
the high value

getLow

int getLow()
The lowest raw light value this sensor can return in pitch black darkness.

Returns:
the low value