Czujnik światła

Wstęp

Klasa światła light jest używana z czujnikiem światła, który mierzy jasność światła odbitego od obiektu lub padającego na niego. Generuje on wartość analogową reprezentującą ilość wykrytego światła.

Konstruktor klasy

light(
  triport::port &port );

Destruktor klasy

Niszczy obiekt światła light i uwalnia powiązane zasoby.

virtual ~light();

Parametry

Parametr	Typ	Opis
port	triport::port &	Port 3-żyłowy, do którego podłączony jest czujnik światła, zapisany jako Brain.ThreeWirePort.X lub ExpanderName.X, gdzie X to litera portu (na przykład Brain.ThreeWirePort.A lub Expander1.A).

Przykłady

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

Funkcje członkowskie

Klasa light zawiera następujące funkcje członkowskie:

• brightness — Zwraca ilość światła wykrytą przez czujnik światła.

Przed wywołaniem jakiejkolwiek funkcji członkowskiej light należy utworzyć instancję light , jak pokazano poniżej:

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

Zwraca ilość światła wykrytego przez czujnik światła. Można tego użyć do sprawdzenia, czy obiekt jest wystarczająco jasny, aby precyzyjnie raportować inne dane wizualne.

Available Functions

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

Parameters

Parametr	Typ	Opis
units	percentUnits	Jednostka reprezentująca jasność: percent / pct (domyślnie) — procent

Return Values

Zwraca int32_t odpowiadającą jasności zmierzonej przez czujnik światła jako wartość procentową w zakresie 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);