Capteur de lumière

Introduction

La classe light est utilisée avec le capteur de lumière, qui mesure la luminosité de la lumière réfléchie par un objet ou l’atteignant. Elle fournit une valeur analogique représentant la quantité de lumière détectée.

Constructeur de classe

light(
  triport::port &port );

Destructeur de classe

Détruit l’objet light et libère les ressources associées.

virtual ~light();

Paramètres

Paramètre	Taper	Description
port	triport::port &	Le port à 3 fils auquel le capteur de lumière est connecté, écrit comme Brain.ThreeWirePort.X ou ExpanderName.X, où X est la lettre du port (par exemple, Brain.ThreeWirePort.A ou Expander1.A).

Exemples

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

Fonctions des membres

La classe light comprend les fonctions membres suivantes :

• brightness — Renvoie la quantité de lumière détectée par le capteur de lumière.

Avant d’appeler les fonctions membres de light , une instance light doit être créée, comme indiqué ci-dessous :

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

Renvoie la quantité de lumière détectée par le capteur de luminosité. Cette valeur permet de vérifier si un objet est suffisamment lumineux pour que d’autres données visuelles puissent être transmises avec précision.

Available Functions

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

Parameters

Paramètre	Taper	Description
units	percentUnits	Unité de luminosité : percent pct (par défaut) — pourcentage

Return Values

Renvoie un int32_t int32_t représentant la luminosité mesurée par le capteur de lumière en pourcentage dans la plage 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);