光传感器

介绍

The light class is used to measure the brightness detected by the Light Sensor.

类构造函数

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 brightness 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);