Sensor de luz

Introdução

A classe light é utilizada com o Sensor de Luz, que mede o brilho da luz refletida ou que incide sobre um objeto. Emite um valor analógico que representa a quantidade de luz detectada.

Construtor de Classes

light(
  triport::port &port );

Destrutor de classes

Destroys the light object and releases associated resources.

virtual ~light();

Parâmetros

Parâmetro	Tipo	Descrição
port	triport::port &	A porta de 3 fios à qual o sensor de luz está ligado, escrita como Brain.ThreeWirePort.X ou ExpanderName.X, em que X é a letra da porta (por exemplo, Brain.ThreeWirePort.A ou Expander1.A).

Exemplos

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

Funções de membro

A classe light inclui as seguintes funções membro:

• brightness — Devolve a quantidade de luz detectada pelo sensor de luz.

Antes de chamar qualquer função membro light , deve ser criada uma instância light , como se mostra abaixo:

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

Retorna a quantidade de luz detetada pelo sensor de luz. Isto pode ser utilizado para verificar se um objeto é suficientemente brilhante para que outros dados visuais sejam reportados com precisão.

Available Functions

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

Parameters

Parâmetro	Tipo	Descrição
units	percentUnits	A unidade que representa o brilho: percent pct (padrão) — por cento

Return Values

Retorna um valor int32_t que representa o brilho medido pelo sensor de luz como uma percentagem no intervalo de 0 a 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);