触摸LED#

介绍#

VEX IQ 触摸 LED 既是指示灯又是按钮。它可以发出不同颜色的光来提供反馈，例如指示机器人已准备就绪、显示所选模式或匹配其他传感器检测到的颜色，它还可以检测到触摸，让您只需轻触一下即可启动或更改机器人的行为。

This page uses touchled_1 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 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 into one another.

  • set_brightness — Sets the brightness of the Touch LED.

  • set_blink — Alternate the Touch LED on and off indefinitely.

获取器 — 返回触摸 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

可选。包含要传递给回调函数的参数的元组。有关更多信息，请参阅带参数的函数。

 
# Turn blue while the Touch LED is pressed
def light_blue():
    touchled_1.set_color(Color.BLUE)

touchled_1.pressed(light_blue)

released#

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

Usage:
touchled_1.released(callback, arg)

参数

描述

callback

一个预先定义好的函数，当触摸 LED 被释放时执行。

arg

可选。包含要传递给回调函数的参数的元组。有关更多信息，请参阅带参数的函数。

 
# Turn red when the Touch LED is released
def light_red():
    touchled_1.set_color(Color.RED)

touchled_1.released(light_red)

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.

 
# Turn green when the robot is moving
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

off#

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

Usage:
touchled_1.off()

参数

描述

该方法没有参数。

 
# Turn off Touch LED when movement is over
touchled_1.on(Color.GREEN)
drivetrain.drive_for(FORWARD, 5)
touchled_1.off()

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()

参数

描述

该方法没有参数。

 
# Turn the Touch LED off and on
touchled_1.set_color(Color.RED)
while True:
    touchled_1.toggle()
    wait(0.5,SECONDS)

修改器#

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.

 
# Change colors between blue and green
while True:
    touchled_1.set_color(Color.BLUE)
    wait(0.5, SECONDS)
    touchled_1.set_color(Color.GREEN)
    wait(0.5, SECONDS)

set_fade#

set_fade changes how the Touch LED transitions to new colors.

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.

 
# No fade to red, then slow fade to purple
touchled_1.set_fade(FadeType.OFF)
touchled_1.set_color(Color.RED)
wait(2, SECONDS)
touchled_1.set_fade(FadeType.SLOW)
touchled_1.set_color(Color.PURPLE)

set_brightness#

set_brightness sets the brightness of the Touch LED.

Usage:
touchled_1.set_brightness(brightness)

参数

描述

brightness

触摸 LED 的亮度可以设置为 0% 到 100% 之间的整数。

 
# Show green at different brightness levels
touchled_1.set_color(Color.GREEN)
wait(1, SECONDS)
touchled_1.set_brightness(10)
wait(1, SECONDS)
touchled_1.set_brightness(100)

吸气剂#

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()

参数

描述

该方法没有参数。

 
# Turn TouchLED green when touched
while True:
    if touchled_1.pressing():
        touchled_1.set_color(Color.GREEN)
    else:
        touchled_1.set_color(Color.RED)
    wait(50, MSEC)

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()

参数

描述

该方法没有参数。

构造函数#

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(smartport)

范围

描述

smartport

触摸 LED 连接的智能端口，记为 PORTx，其中 x 是端口号。

 
# Create a Touchled in Port 1
touchled_1 = Touchled(Ports.PORT1)
On this page