触摸LED

介绍

VEX IQ（第二代）触摸 LED 类别提供了与触摸 LED 交互的方法。

This page uses TouchLED1 as the example Touch LED name. Replace it with your own configured name as needed.

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

操作——与触摸 LED 交互。

• pressed – Registers a function to be called when the Touch LED is pressed.

• released – Registers a function to be called when the Bumper Switch is released.

• on – Turns the Touch LED on.

• off – Turns the Touch LED off.

改变器——改变触摸 LED 的颜色、亮度和设置。

• setColor – Sets the color of the Touch LED.

• setFade – Sets how fast colors will fade to one another.

• setBrightness – Sets the brightness of the Touch LED.

• setBlink – Alternate the Touch LED on and off indefinitely.

Getters – 从触摸 LED 返回数据。

• pressing – Returns whether the Touch LED is being pressed.

• installed – Returns whether the Touch LED is connected to the Brain.

构造函数 – 手动初始化触摸 LED。

• touchled – Create a Touch LED.

行动

pressed

pressed registers a function to be called when the Touch LED is pressed.

Usage:
TouchLED1.pressed(callback);

参数	描述
callback	先前定义的 函数 在按下触摸 LED 时执行。

// Turn the LED red
void onTouchPressed() {
  TouchLED1.setColor(red);
}

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Call onTouchPressed when the Touch LED is pressed
  TouchLED1.pressed(onTouchPressed);
}

released

released registers a function to be called when the Touch LED is released.

Usage:
TouchLED1.released(callback);

参数	描述
callback	先前定义的在释放触摸 LED 时执行的功能。

// Turn the LED off
void onTouchReleased() {
  TouchLED1.off();
}

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  TouchLED1.setColor(blue);
  // Call onTouchReleased when the Touch LED is released
  TouchLED1.released(onTouchReleased);
}

on

on method turns the LED of the TouchLED Sensor on using predefined colors and a set brightness.

Default Usage:
TouchLED1.on(color, brightness);

Overload Usages:
TouchLED1.on(hue, brightness);
TouchLED1.on(r, g, b, brightness);

参数	描述
color	A valid color: blue blue_green blue_violet green orange purple red red_orange red_violet violet white yellow yellow_green yellow_orange colorType::none black transparent
brightness	可选。LED 亮度的百分比，默认为 100。
hue	LED 的色调。这也可以用十六进制代码值 (0x000000) 表示。
r	表示 LED 红色值的整数。
g	表示 LED 绿色值的整数。
b	表示 LED 蓝色值的整数。

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Turn LED on using a predefined color with 100 brightness
  TouchLED1.on(green, 100);
  wait(1, seconds);

  // Turn LED on using hexcode (FF2A00, 75 brightness)
  TouchLED1.on(0xFF2A00, 75);
  wait(1, seconds);

  // Turn LED on using RGB values (0, 30, 255, 50 brightness)
  TouchLED1.on(0, 30, 255, 50);
}

off

off turns the Touch LED off.

Usage:
TouchLED1.off();

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

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Turn LED on, wait, then turn off
  TouchLED1.setColor(yellow);
  wait(2, seconds);
  TouchLED1.off();
}

修改器

setColor

setColor turns the LED of the Touch LED Sensor on to a specific color.

Usage:
TouchLED1.setColor(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 colorType::none black transparent

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Alternate between colors
  while (true) {
    TouchLED1.setColor(blue_violet);
    wait(0.5, seconds);
    TouchLED1.setColor(blue_green);
    wait(0.5, seconds);
  }
}

setFade

setFade changes the fade setting of the Touch LED Sensor. The Touch LED Sensor will change to new colors using the fade type.

Usage:
TouchLED1.setFade(speed);

参数	描述
speed	The speed the fade will be set to: fast off — no fade slow

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Set the fade speed to slow
  TouchLED1.setFade(slow);
}

setBrightness

setBrightness sets the brightness of the Touch LED.

Usage:
TouchLED1.setBrightness(value);

参数	描述
value	触摸 LED 的亮度设置为百分比。

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Show different brightness levels
  TouchLED1.setColor(green);
  wait(1, seconds);

  TouchLED1.setBrightness(25);
  wait(1, seconds);

  TouchLED1.setBrightness(100);
}

setBlink

setBlink repeatedly blinks the TouchLED in an on and off pattern.

Note: Calling off will not stop the blinking behavior. To stop the blinking behavior, set the LED brightness to 0 with setBrightness.

Default Usage:
TouchLED1.setBlink(color, ontime, offtime);

Overload Usages:
TouchLED1.setBlink(hue, ontime, offtime);

参数	描述
color	A valid color: blue blue_green blue_violet green orange purple red red_orange red_violet violet white yellow yellow_green yellow_orange colorType::none black transparent
ontime	可选。LED 闪烁的持续时间（以秒为单位），默认为 0.25 秒。
offtime	可选。LED 闪烁熄灭的时长（以秒为单位），默认为 0.25 秒。
hue	LED 的色调。也可以用十六进制代码值表示。

吸气剂

pressing

pressing returns a Boolean indicating whether the Touch LED Sensor is currently being pressed.

• 1 – The Touch LED is currently bring pressed.

• 0 – The Touch LED is not currently being pressed.

Usage:
TouchLED1.pressing()

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

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Only turn green when the Touch LED is being pressed
  while (true) {
    if (TouchLED1.pressing()) {
      TouchLED1.setColor(green);

    } else {
      TouchLED1.off();
    }
  }
}

installed

installed returns a Boolean indicating whether the Touch LED is currently connected to the Brain.

• 1 – The TouchLED is connected to the Brain.

• 0 – The TouchLED is not connected to the Brain.

Usage:
TouchLED1.installed()

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

构造函数

touchled

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

Usage:
touchled TouchLED1 = touchled(smartport);

范围	描述
smartport	The Smart Port that the Touch LED is connected to, written as PORTx where x is the number of the port.

int main() {
  // Initializing Robot Configuration. DO NOT REMOVE!
  vexcodeInit();

  // Create a Touch LED in Port 1
  touchled myTouchLED = touchled(PORT1);
}