タッチLED

導入

VEX IQ Touch LEDは、ライトとボタンの両方の機能を備えています。ロボットの準備完了を知らせたり、選択されているモードを表示したり、他のセンサーで検出された色と一致させたりするなど、さまざまな色で点灯してフィードバックを提供できます。また、タッチされたことを検知し、タップするだけでロボットの動作を開始したり変更したりできます。

このページでは、タッチLED名として touchled_1 という例を使用しています。必要に応じて、ご自身で設定した名前に置き換えてください。

以下にすべてのメソッドの一覧を示します。

操作 — タッチLEDを操作する。

• pressed — タッチLEDが押されたときに呼び出される関数を登録します。

• released — タッチLEDが離されたときに呼び出される関数を登録します。

• on — タッチLEDをオンにします。

• off — タッチLEDをオフにします。

• toggle — タッチ LED をオンまたはオフにします。

ミューテーター — タッチLEDの色、明るさ、設定を変更します。

• set_color — タッチLEDの色を設定します。

• set_fade — 色が互いにフェードインする速度を設定します。

• set_brightness — タッチLEDの明るさを設定します。

• set_blink — タッチLEDを無期限に交互に点灯・消灯します。

ゲッター — タッチLEDからデータを返します。

• pressing — タッチ LED が押されているかどうかを返します。

• installed — タッチLEDがブレインに接続されているかどうかを返します。

コンストラクター向け — タッチLEDを手動で初期化および構成します。

• Touchled — タッチLEDを作成します。

行動

pressed

pressed 押され、タッチ LED が押されたときに呼び出される関数が登録されます。

Usage:
touchled_1.pressed(callback, arg)

パラメータ	説明
callback	タッチLEDが押されたときに実行されるように事前に定義された関数。
arg	Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

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

touchled_1.pressed(light_blue)

released

released タッチ LED が解放されたときに呼び出される関数を登録します。

Usage:
touchled_1.released(callback, arg)

パラメータ	説明
callback	タッチLEDが離されたときに実行されるように事前に定義された関数。
arg	Optional. A tuple containing arguments to pass to the callback function. See Functions with Parameters for more information.

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

touchled_1.released(light_red)

on

on に設定すると、タッチLEDの明るさが100%に設定され、LEDが点灯します。

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 、タッチLEDの明るさを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 はタッチ LED のオン/オフを切り替えます。LED がオンの場合、 toggle で明るさを 0% に設定してオフにします。LED がオフの場合、 toggle 明るさを 100% に設定してオンにします。

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 は、タッチLEDの色を設定します。このメソッドを使用する際にタッチLEDが点灯していない場合は、明るさを100%に設定してタッチLEDを点灯させます。

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 は、タッチLEDが新しい色に変化する方法を変更します。

Usage:
touchled_1.set_fade(type)

パラメータ	説明
type	色が次の色にフェードする速さ： FadeType.FAST — 色が素早く変化します。 FadeType.OFF — 色が瞬時に変化します。 FadeType.SLOW — 色がゆっくりと変化します。

# 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 タッチ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)

set_blink

set_blink タッチLEDをオン/オフパターンで繰り返し点滅させます。

注: off を呼び出しても点滅動作は停止しません。点滅動作を停止するには、set_brightness を使用して LED の明るさを 0 に設定します。

Usage:
set_blink(color, ontime, offtime)

パラメータ	説明
color	Sets the Touch LED’s color to: Color.RED Color.GREEN Color.BLUE Color.WHITE 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.
ontime	LEDが点滅する時間（秒単位）。デフォルト値は0.25秒です。
offtime	LEDが点滅する間、消灯している時間（秒単位）。デフォルト値は0.25秒です。

# Blink green for 2 seconds then stop
touchled_1.set_blink(Color.GREEN, 0.5, 0.5)
wait(2, SECONDS)
touchled_1.set_brightness(0)

ゲッター

pressing

pressing 返され、タッチLEDが現在押されているかどうかを示す整数が返されます。

• 1 — TouchLEDが押されています。

• 0 — TouchLEDが押されていません。

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 タッチ LED が Brain に接続されているかどうかを示すブール値を返します。

• True — タッチLEDはブレインに接続されています。

• False — タッチLEDがブレインに接続されていません。

Usage:
touchled_1.installed()

パラメータ	説明
	このメソッドにはパラメータがありません。

建設業者

コンストラクタは、VEXcode の外部で Touch LED を構成するために必要な、 Touchled を手動で作成するために使用されます。

Touchled

Touchled タッチ LED を作成します。

Usage:
touchled_1 = Touchled(smartport)

パラメータ	説明
smartport	タッチLEDが接続されているスマートポートは、PORTxと表記され、xはポート番号です。

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