Ljussensor

Introduktion

Klassen light används med ljussensorn, som mäter ljusstyrkan hos ljus som reflekteras från eller lyser på ett objekt. Den matar ut ett analogt värde som representerar hur mycket ljus som detekteras.

Klasskonstruktor

light(
  triport::port &port );

Klassförstörare

Förstör light objektet och frigör tillhörande resurser.

virtual ~light();

Parametrar

Parameter	Typ	Beskrivning
port	triport::port &	Den 3-trådsport som ljussensorn är ansluten till, skriven som Brain.ThreeWirePort.X eller ExpanderName.X, där X är portbokstaven (till exempel Brain.ThreeWirePort.A eller Expander1.A).

Exempel

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

Medlemsfunktioner

Klassen light innehåller följande medlemsfunktioner:

• brightness — Returnerar mängden ljus som detekterats av ljussensorn.

Innan några light medlemsfunktioner anropas måste en light instans skapas, som visas nedan:

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

Returnerar mängden ljus som detekterats av ljussensorn. Detta kan användas för att kontrollera om ett objekt är tillräckligt ljust för att korrekt rapportera annan visuell data.

Available Functions

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

Parameters

Parameter	Typ	Beskrivning
units	percentUnits	Enheten som representerar ljusstyrkan: percent / pct (standard) — procent

Return Values

Returnerar int32_t som representerar ljusstyrkan mätt av ljussensorn som en procentandel i intervallet 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);