Valoanturi

Johdanto

Luokkaa light käytetään valoanturin kanssa, joka mittaa kohteesta heijastuvan tai siihen paistavan valon kirkkautta. Se tuottaa analogisen arvon, joka edustaa havaittua valoa.

Luokan rakentaja

light(
  triport::port &port );

Luokan tuhoaja

Tuhoaa light -objektin ja vapauttaa siihen liittyvät resurssit.

virtual ~light();

Parametrit

Parametri	Tyyppi	Kuvaus
port	triport::port &	3-johtiminen portti, johon valoanturi on kytketty, kirjoitetaan muodossa Brain.ThreeWirePort.X tai ExpanderName.X, jossa X on portin kirjain (esimerkiksi Brain.ThreeWirePort.A tai Expander1.A).

Esimerkkejä

// Create a light instance in Port A
light LightA = light(Brain.ThreeWirePort.A);

Jäsenten toiminnot

light -luokka sisältää seuraavat jäsenfunktiot:

• brightness — Palauttaa valoanturin havaitseman valon määrän.

Ennen minkään light -jäsenfunktion kutsumista on luotava light -instanssi alla olevan mukaisesti:

/* This constructor is required when using VS Code.
Light Sensor configuration is generated automatically
in VEXcode using the Device Menu. Replace the values
as needed. */

// Create a light instance in Port A
light LightA = light(Brain.ThreeWirePort.A);

brightness

Palauttaa valoanturin havaitseman valon määrän. Tätä voidaan käyttää tarkistamaan, onko kohde riittävän kirkas raportoidakseen muita visuaalisia tietoja tarkasti.

Available Functions

int32_t brightness(
  percentUnits units = percentUnits::pct );

Parameters

Parametri	Tyyppi	Kuvaus
units	percentUnits	Kirkkautta edustava yksikkö: percent pct (oletus) — prosenttia

Return Values

Palauttaa arvon int32_t joka edustaa valoanturin mittaamaa kirkkautta prosentteina väliltä 0–100 %.

Examples

// Get Light Sensor brightness in range of 0% - 100%.
int32_t value = LightA.brightness();

// Print the brightness of the Light Sensor to the
// Brain's screen.
Brain.Screen.print(value);