Lichtsensor

Einführung

Die Klasse light wird mit dem Lichtsensor verwendet, der die Helligkeit von Licht misst, das von einem Objekt reflektiert wird oder auf ein Objekt fällt. Er gibt einen Analogwert aus, der die detektierte Lichtmenge angibt.

Klassenkonstruktor

light(
  triport::port &port );

Klassendestruktor

Zerstört das Objekt light und gibt zugehörige Ressourcen frei.

virtual ~light();

Parameter

Parameter	Typ	Beschreibung
port	triport::port &	Der 3-Draht-Anschluss, an den der Lichtsensor angeschlossen ist, wird als Brain.ThreeWirePort.X oder ExpanderName.Xgeschrieben, wobei X der Anschlussbuchstabe ist (zum Beispiel Brain.ThreeWirePort.A oder Expander1.A).

Beispiele

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

Mitgliedsfunktionen

Die Klasse light umfasst die folgenden Memberfunktionen:

• brightness — Gibt die vom Lichtsensor erfasste Lichtmenge zurück.

Bevor light Memberfunktionen aufgerufen werden können, muss eine light Instanz erstellt werden, wie unten gezeigt:

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

Gibt die vom Lichtsensor erfasste Lichtmenge zurück. Dies kann verwendet werden, um zu überprüfen, ob ein Objekt hell genug ist, um andere visuelle Daten präzise zu erfassen.

Available Functions

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

Parameters

Parameter	Typ	Beschreibung
units	percentUnits	Die Einheit, die die Helligkeit darstellt: percent pct (Standard) — Prozent

Return Values

Gibt einen int32_t zurück, der die vom Lichtsensor gemessene Helligkeit als Prozentwert im Bereich von 0 - 100% darstellt.

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);