光传感器

介绍

The light class is used with the Light Sensor, which measures the brightness of light reflected from or shining on an object. It outputs an analog value that represents how much light is detected.

类构造函数

light(
  triport::port &port );

类析构函数

Destroys the light object and releases associated resources.

virtual ~light();

参数

范围	类型	描述
port	triport::port &	The 3-Wire Port that the Light Sensor is connected to, written as Brain.ThreeWirePort.X or ExpanderName.X, where X is the port letter (for example, Brain.ThreeWirePort.A or Expander1.A).

示例

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

成员功能

The light class includes the following member functions:

• brightness — Returns the amount of light detected by the Light Sensor.

Before calling any light member functions, a light instance must be created, as shown below:

/* 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	The unit that represents the brightness: percent / pct (default) — percent

Return Values

Returns an int32_t representing the brightness measured by the Light Sensor as a percent in the range 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);