Světelný senzor

Zavedení

Třída light se používá se světelným senzorem, který měří jas světla odraženého od objektu nebo dopadajícího na něj. Výstupem je analogová hodnota, která představuje množství detekovaného světla.

Konstruktor třídy

light(
  triport::port &port );

Destruktor tříd

Zničí objekt light a uvolní související zdroje.

virtual ~light();

Parametry

Parametr	Typ	Popis
port	triport::port &	3vodičový port, ke kterému je připojen světelný senzor, zapsaný jako Brain.ThreeWirePort.X nebo ExpanderName.X, kde X je písmeno portu (například Brain.ThreeWirePort.A nebo Expander1.A).

Příklady

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

Členské funkce

Třída light obsahuje následující členské funkce:

• brightness — Vrátí množství světla detekovaného světelným senzorem.

Před voláním jakékoli členské funkce light je nutné vytvořit instanci light , jak je znázorněno níže:

/* 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

Vrátí množství světla detekovaného světelným senzorem. To lze použít k ověření, zda je objekt dostatečně jasný pro přesné zobrazení dalších vizuálních dat.

Available Functions

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

Parameters

Parametr	Typ	Popis
units	percentUnits	Jednotka, která představuje jas: percent / pct (výchozí) — procenta

Return Values

Vrací hodnotu int32_t která představuje jas měřený světelným senzorem v procentech v rozsahu 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);