触摸LED#

介绍#

触摸 LED 是一种电容式触摸按钮，可以以不同的亮度级别和转换速度显示颜色，并可以检测何时按下。

For the examples below, the configured Touch LED will be named touchled_1 and will be used in all subsequent examples throughout this API documentation when referring to Touchled class methods.

以下是所有方法的列表：

操作——与触摸 LED 交互。

  • pressed – Calls a function when the Touch LED is pressed.

  • released – Calls a function when the Touch LED is released.

  • on – Turns the Touch LED on.

  • off – Turns the Touch LED off.

  • toggle – Turns the Touch LED on or off.

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

  • set_color – Sets the color of the Touch LED.

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

  • set_brightness – Sets the brightness of the Touch LED.

  • vset_blink – 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。

行动#

pressed#

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

Usage:
touchled_1.pressed(callback, arg)

参数

描述

callback

先前定义的当触摸 LED 被按下时执行的功能。

arg

可选。包含要传递给回调函数的参数的元组。更多信息，请参阅带参数的函数](…/Logic/Functions.md#functions-with-parameters)。

 
# Example coming soon

released#

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

Usage:
touchled_1.released(callback, arg)

参数

描述

callback

先前定义的在触摸 LED 释放时执行的功能。

arg

可选。包含要传递给回调函数的参数的元组。更多信息，请参阅带参数的函数](…/Logic/Functions.md#functions-with-parameters)。

 
# Example coming soon

on#

on turns the Touch LED on by setting its brightness to 100%.

Usage:
touchled_1.on(value)

参数

描述

value

Optional. Sets the LED’s color to:

  • Color.RED
  • Color.GREEN
  • Color.BLUE
  • Color.WHITE (default)
  • Color.YELLOW
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED_VIOLET
  • Color.VIOLET
  • Color.BLUE_VIOLET
  • Color.BLUE_GREEN
  • Color.YELLOW_GREEN
  • Color.YELLOW_ORANGE
  • Color.RED_ORANGE
You can also specify a custom color.

 
# Example coming soon

off#

off turns the Touch LED off by setting its brightness to 0%.

Usage:
touchled_1.off()

参数

描述

该方法没有参数。

 
# Example coming soon

toggle#

toggle turns the Touch LED on or off. If the LED is currently on, toggle sets its brightness to 0%, turning it off. If the LED is off, toggle sets its brightness to 100%, turning it on.

Usage:
touchled_1.toggle()

参数

描述

该方法没有参数。

 
# Example coming soon

修改器#

set_color#

set_color sets the color of the Touch LED. If the Touch LED is not already on when this method is used, it will set the brightness to 100% to turn the Touch LED on.

Usage:
touchled_1.set_color(color)

参数

描述

color

Optional. Sets the LED’s color to:

  • Color.RED
  • Color.GREEN
  • Color.BLUE
  • Color.WHITE (default)
  • Color.YELLOW
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED_VIOLET
  • Color.VIOLET
  • Color.BLUE_VIOLET
  • Color.BLUE_GREEN
  • Color.YELLOW_GREEN
  • Color.YELLOW_ORANGE
  • Color.RED_ORANGE
If unspecified, set_color will turn the Touch LED on with the previously set color.
You can also specify a custom color.

 
# Example coming soon

set_fade#

set_fade changes the color fade setting for the Touch LED.

Usage:
touchled_1.set_fade(type)

参数

描述

type

How fast a color will fade from one to the next:

  • FadeType.FAST – Colors will transition quickly.
  • FadeType.OFF – Colors will instantly transition.
  • FadeType.SLOW – Colors will transition slowly.

 
# Example coming soon

set_brightness#

set_brightness sets the brightness of the Touch LED.

Usage:
touchled_1.set_brightness(brightness)

参数

描述

brightness

触摸 LED 的亮度设置为百分比。

 
# Example coming soon

吸气剂#

pressing#

.pressing returns an integer indicating whether the Touch LED is currently being pressed.

  • 1 - The TouchLED is being pressed.

  • 0 - The TouchLED is not being pressed.

Usage:
touchled_1.pressing()

参数

描述

该方法没有参数。

 
# Example coming soon

installed#

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

  • True - The Touch LED is connected to the Brain.

  • False - The Touch LED is not connected to the Brain.

Usage:
touchled_1.installed()

参数

描述

该方法没有参数。

 
# Example coming soon

构造函数#

Constructors are used to manually create TouchLED objects, which are necessary for configuring a Touch LED outside of VEXcode.

TouchLED#

TouchLED creates a Touch LED.

Usage:
touchled_1 = TouchLED(port)

范围

描述

port

Which Smart Port that the Touch LED is connected to as Ports.PORT followed by the port number, ranging from 1 to 12.

 
# Example coming soon
On this page