颜色

介绍

颜色传感器提供了从不同对象返回数据的方法。这使得大脑能够检测颜色及其色调和亮度。

For the examples below, the configured Color Sensor will be named Color1 and will be used in all subsequent examples throughout this API documentation when referring to colorsensor class methods.

以下是所有可用方法的列表：

动作——使用颜色传感器检测物体。

• objectDetected – Calls a function when an object is detected.

变异器——修改颜色传感器上的灯光。

• setLight – Turns the Color Sensor’s LED on, off, or to a set brightness level.

Getters – 使用颜色传感器返回对象数据。

• isNearObject – Returns whether or not an object is close to the Color Sensor.

• detects – Returns whether or not a specified color is detected by the Color Sensor.

• colorname – Returns the name of the color detected by the Color Sensor.

• brightness – Returns the detected brightness of an object.

• hue – Returns the detected hue value as a float from 0 to 359.99 degrees.

• colorname3 – Returns the closest of red, blue or green to the detected color.

• color – Return the detected color as a predefined color object.

• installed – Returns whether the Color Sensor is connected to the Brain.

构造函数——手动初始化颜色传感器。

• colorsensor – Create a Color Sensor.

行动

objectDetected

objectDetected registers a function to be called when the Color Sensor detects an object.

Usage:
Color1.objectDetected(callback);

参数	描述
callback	当颜色传感器检测到物体时执行的先前定义的函数。

// Example coming soon

修改器

setLight

setLight sets the state of the Color Sensor LED.

Default Usage:
Color1.setLight(value, units);

Overload Usages:
Color1.setLight(state);

参数	描述
value	将光的强度设置为 0 - 100 之间的百分比值。
units	The unit that represents the intensity: percent
state	A valid LED state: ledState::off ledState::on

// Example coming soon

吸气剂

isNearObject

isNearObject returns a Boolean indicating whether or not the Color Sensor is close to an object.

• 1 – The Color Sensor detects a close object.

• 0 – The Color Sensor does not detect a close object.

Usage:
Color1.isNearObject()

参数	描述
	该方法没有参数。

// Example coming soon

detects

detects returns if the Color Sensor is detecting a specified color.

• 1 – The Color Sensor detects the color.

• 0 – The Color Sensor does not detect the color.

Usage:
Color1.detects(color)

参数	描述
color	A valid color: blue blue_green blue_violet green orange purple red red_orange red_violet violet white yellow yellow_green yellow_orange

// Example coming soon

colorname

colorname returns the closest matching color from a preset list shown below.

直接打印时，它会显示与该颜色相关的数值：

颜色	数值
none	0
red	1
green	2
blue	3
white	4
yellow	5
orange	6
purple	7
cyan	8
red_violet	9
violet	10
blue_violet	11
blue_green	12
yellow_green	十三
yellow_orange	14
red_orange	15
black	16
transparent	17

Usage:
Color1.colorname()

参数	描述
	该方法没有参数。

// Example coming soon

brightness

brightness returns the brightness value from the Color Sensor.

Usage:
Color1.brightness(bRaw)

参数	描述
bRaw	Optional. A Boolean indicating whether to return the raw value detected by the Color Sensor: true – Return the raw value. false (default) – Do not return the raw value.

// Example coming soon

hue

hue returns the hue value detected by the Color Sensor as an integer.

Usage:
Color1.hue()

参数	描述
	该方法没有参数。

// Example coming soon

colorname3

colorname3 returns the closest color detected to red, green, or blue as an enumerated value (enum).

颜色	数值
red	1
green	2
blue	3

Usage:
Color1.colorname3()

参数	描述
	该方法没有参数。

// Example coming soon

color

color returns the closest predefined color object detected by the Color Sensor:

• red

• green

• blue

• white

• yellow

• orange

• purple

• cyan

• red_violet

• violet

• blue_violet

• blue_green

• yellow_green

• yellow_orange

• red_orange

• black

• transparent

Usage:
Color1.color()

参数	描述
	该方法没有参数。

// Example coming soon

installed

installed returns a Boolean indicating whether the Color Sensor is currently connected to the Brain.

• 1 – The Color Sensor is connected to the Brain.

• 0 – The Color Sensor is not connected to the Brain.

Usage:
Color1.installed()

参数	描述
	该方法没有参数。

// Example coming soon

构造函数

colorsensor

colorsensor creates an object of the colorsensor Class in the specified port.

Usage:
colorsensor Color1 = colorsensor(port);

范围	描述
port	Which Smart Port that the Color Sensor is connected to as PORT followed by the port number, ranging from 1 to 12.

// Example coming soon