Датчик світла

Вступ

Клас light використовується з датчиком світла, який вимірює яскравість світла, відбитого від об’єкта або падаючий на нього. Він виводить аналогове значення, яке відображає кількість виявленого світла.

Конструктор класів

light(
  triport::port &port );

Деструктор класів

Знищує об’єкт light та звільняє пов’язані з ним ресурси.

virtual ~light();

Параметри

Параметр	Тип	Опис
port	triport::port &	3-провідний порт, до якого підключено датчик світла, записується як Brain.ThreeWirePort.X або ExpanderName.X, де X – літера порту (наприклад, Brain.ThreeWirePort.A або Expander1.A).

Приклади

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

Функції-члени

Клас light містить такі функції-члени:

• brightness — Повертає кількість світла, виявленого датчиком освітленості.

Перед викликом будь-яких функцій-членів light необхідно створити екземпляр light , як показано нижче:

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

Повертає кількість світла, виявленого датчиком освітленості. Це можна використовувати для перевірки, чи об’єкт достатньо яскравий для точного відображення інших візуальних даних.

Available Functions

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

Parameters

Параметр	Тип	Опис
units	percentUnits	Одиниця вимірювання яскравості: percent / pct (за замовчуванням) — відсоток

Return Values

Повертає значення int32_t , яке представляє яскравість, виміряну датчиком освітленості, у відсотках у діапазоні від 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);