光学传感器#
介绍#
optical 类用于访问来自 V5 光学传感器 的数据。它利用反射光来检测物体、识别颜色以及测量亮度和色调。
类构造函数#
optical Optical = optical(index);
类析构函数#
销毁 optical 对象并释放相关资源。
virtual ~optical();
参数#
范围 |
类型 |
描述 |
|---|---|---|
|
|
光传感器连接的智能端口,记为 |
示例#
// Create an optical instance in Port 1
optical Optical1 = optical(PORT1);
成员功能#
optical 类包含以下成员函数:
setLight— 打开或关闭光学传感器的 LED。setLightPower— 设置光学传感器的光功率级别。isNearObject— 返回光学传感器是否检测到范围内的物体。color— 返回光学传感器检测到的颜色。brightness— 返回物体反射的光量。hue— 返回光学传感器检测到的色调。objectDetected— 注册一个当光学传感器检测到物体时要调用的函数。objectLost— 注册一个当光学传感器丢失物体时要调用的函数。
在调用任何 optical 成员函数之前,必须创建一个 optical 实例,如下所示:
// Create an optical object in Port 1
optical Optical1 = optical(PORT1);
setLight#
设置光学传感器的 LED 指示灯亮起或熄灭。指示灯可以帮助光学传感器更清晰地检测物体和颜色。
Available Functionsvoid setLight(ledState state);
范围 |
类型 |
描述 |
|---|---|---|
|
|
Sets the LED on or off. |
此函数不返回值。
Examples// Turn on LED with previous intensity.
Optical.setLight(ledState::on);
setLightPower#
设置光学传感器的LED亮度。灯光可以帮助光学传感器更清晰地检测物体和颜色。
如果光传感器的灯熄灭,将灯光功率设置为 0% 以上即可打开灯。
如果光传感器的指示灯亮着,将光功率设置为 0% 将关闭指示灯。
百分比越高,灯光越亮;百分比越低,灯光越暗。
Available Functionsvoid setLightPower(
int32_t intensity,
percentUnits units = percent );
范围 |
类型 |
描述 |
|---|---|---|
|
|
灯光亮度级别,可从 0 到 100 设置。 |
|
|
表示光照强度的单位: |
此函数不返回值。
Examples// Set the light power to 50 percent.
Optical.setLightPower(50, percent);
isNearObject#
返回光学传感器检测到附近物体时的值。
Available Functionsbool isNearObject();
此函数不接受任何参数。
Return Values此函数返回一个布尔值,指示是否检测到附近物体:
true– 光学传感器检测到物体。false– 光学传感器未检测到物体。
// If an object is detected by the Optical Sensor, print
// "near object".
if (Optical.isNearObject()){
Brain.Screen.print("near object");
}
color#
返回光学传感器检测到的颜色。
Available Functionsvex::color color();
此函数不接受任何参数。
Return Values光学传感器检测到的颜色是颜色类的一个实例。
可选颜色有:
blackwhitered- 色调值介于 340° 至 20° 之间green- 色调值介于 80° 至 140° 之间blue- 色调值介于 200° 至 240° 之间yellow- 色调值介于 40° 至 60° 之间orange- 色调值介于 20° 至 40° 之间purple- 色调值介于 240° 至 280° 之间cyan- 色调值介于 140° 至 200° 之间
// Set a variable, detectColor, to the color detected by the
// Optical Sensor
color detectColor = Optical.color();
// Print the color detected by the Optical Sensor
// to the Brain's screen
Brain.Screen.print(detectColor);
brightness#
返回物体反射的光量。
百分比越高,意味着反射回光学传感器的光线越多;百分比越低,意味着反射回的光线越少。
Available Functionsdouble brightness(bool bRaw = false);
范围 |
类型 |
描述 |
|---|---|---|
|
|
一个布尔值,用于读取原始亮度数据而不是百分比。默认值为 |
表示光学传感器检测到的亮度的双精度浮点数,范围为 0 - 100%,或者表示传感器检测到的原始数据的双精度浮点数。
Examples// Set a variable, brightness, to the value of the brightness
// detected by the Optical Sensor
double brightness = Optical.brightness();
// Print the brightness detected by the Optical Sensor to the
// Brain's screen
Brain.Screen.print(brightness);
hue#
返回检测到的颜色的色调值。
色相是用色轮上的数字来描述颜色的一种方法。

double hue();
此函数不接受任何参数。
Return Values表示光学传感器检测到的色调值的双精度浮点数,范围为 0 — 359.99。
Examples// Set a variable, hue, to the value of the hue detected
// by the Optical Sensor.
double hue = Optical.hue();
objectDetected#
注册一个回调函数,用于在检测到对象时执行该回调函数。
Available Functionsvoid objectDetected(void (* callback)(void));
范围 |
类型 |
描述 |
|---|---|---|
|
|
先前定义的 函数,当光学传感器检测到新物体时执行。 |
此函数不返回值。
Examples定义回调函数(在
int main()之外)// Display a message when the Optical Sensor detects an object. void detected() { Brain.Screen.print("object detected"); }在
int main()中注册回调函数int main() { // Run detected when the Optical Sensor detects an object. Optical.objectDetected(detected); }
objectLost#
注册一个对象丢失时的回调函数。
Available Functionsvoid objectLost(void (* callback)(void));
范围 |
类型 |
描述 |
|---|---|---|
|
|
先前定义的 函数,当光学传感器丢失检测到的对象时执行。 |
此函数不返回值。
Examples定义回调函数(在
int main()之外)// Display a message when the Optical Sensor loses an object. void lost() { Brain.Screen.print("object lost"); }在
int main()中注册回调函数int main() { // Run lost when the Optical Sensor loses an object. Optical.objectLost(lost); }