Touch-LED#

Einführung #

Die VEX IQ Touch LED ist sowohl eine Leuchte als auch ein Knopf. Sie kann in verschiedenen Farben leuchten, um Feedback zu geben, z. B. um anzuzeigen, dass der Roboter bereit ist, den ausgewählten Modus anzuzeigen oder eine von einem anderen Sensor erfasste Farbe widerzuspiegeln. Außerdem erkennt sie Berührungen, sodass Sie das Verhalten des Roboters durch Antippen starten oder ändern können.

Diese Seite verwendet touchled_1 als Beispielnamen für die Touch-LED. Ersetzen Sie diesen bei Bedarf durch Ihren eigenen Namen.

Nachfolgend finden Sie eine Liste aller Methoden:

Aktionen – Interaktion mit der Touch-LED.

pressed — Registriert eine Funktion, die aufgerufen werden soll, wenn die Touch-LED gedrückt wird.
released — Registriert eine Funktion, die aufgerufen werden soll, wenn die Touch-LED losgelassen wird.
on — Schaltet die Touch-LED ein.
off — Schaltet die Touch-LED aus.
toggle — Schaltet die Touch-LED ein oder aus.

Mutatoren – Ändern Sie Farben, Helligkeit und Einstellungen der Touch-LED.

set_color — Legt die Farbe der Touch-LED fest.
set_fade — Legt fest, wie schnell die Farben ineinander überblenden.
set_brightness — Legt die Helligkeit der Touch-LED fest.
set_blink — Die Touch-LED wird abwechselnd ein- und ausgeschaltet.

Getter – Geben Daten vom Touch-LED zurück.

pressing — Gibt zurück, ob die Touch-LED gedrückt wird.
installed — Gibt zurück, ob die Touch-LED mit dem Brain verbunden ist.

Konstruktoren – Manuelle Initialisierung und Konfiguration der Touch-LED.

Touchled — Erstellen einer Touch-LED.

Aktionen #

pressed #

pressed registriert eine Funktion, die beim Drücken der Touch-LED aufgerufen werden soll.

Usage:
touchled_1.pressed(callback, arg)

Parameter	Beschreibung
`callback`	Eine Funktion, die zuvor definiert wurde und ausgeführt werden soll, wenn die Touch-LED gedrückt wird.
`arg`	Optional. Ein Tupel, das Argumente enthält, die an die Callback-Funktion übergeben werden sollen. Weitere Informationen finden Sie unter Funktionen mit Parametern.

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

touchled_1.pressed(light_blue)

released #

released registriert eine Funktion, die aufgerufen werden soll, wenn die Touch-LED losgelassen wird.

Usage:
touchled_1.released(callback, arg)

Parameter	Beschreibung
`callback`	Eine Funktion, die zuvor definiert wurde und ausgeführt werden soll, wenn die Touch-LED losgelassen wird.
`arg`	Optional. Ein Tupel, das Argumente enthält, die an die Callback-Funktion übergeben werden sollen. Weitere Informationen finden Sie unter Funktionen mit Parametern.

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

touchled_1.released(light_red)

on #

Mit on wird die Touch-LED eingeschaltet, indem ihre Helligkeit auf 100 % eingestellt wird.

Usage:
touchled_1.on(value)

Parameter	Beschreibung
`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.

Parameter

Beschreibung

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 schaltet die Touch-LED aus, indem ihre Helligkeit auf 0 % eingestellt wird.

Usage:
touchled_1.off()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

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

toggle #

Mit den Schaltern toggle kann die Touch-LED ein- oder ausgeschaltet werden. Ist die LED eingeschaltet, wird ihre Helligkeit durch die Schalter toggle auf 0 % reduziert und somit ausgeschaltet. Ist die LED ausgeschaltet, wird ihre Helligkeit durch die Schalter toggle auf 100 % erhöht und somit eingeschaltet.

Usage:
touchled_1.toggle()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

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

Mutatoren #

set_color #

Mit dem Befehl set_color wird die Farbe der Touch-LED festgelegt. Falls die Touch-LED bei Verwendung dieser Methode noch nicht eingeschaltet ist, wird die Helligkeit auf 100 % gesetzt, um sie zu aktivieren.

Usage:
touchled_1.set_color(color)

Parameter	Beschreibung
`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.

Parameter

Beschreibung

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 ändert, wie die Touch-LED zu neuen Farben übergeht.

Usage:
touchled_1.set_fade(type)

Parameter	Beschreibung
`type`	Wie schnell ein Farbübergang erfolgt: `FadeType.FAST` – Schnelle Farbübergänge. `FadeType.OFF` – Sofortige Farbübergänge. `FadeType.SLOW` – Langsame Farbübergänge.

Parameter

Beschreibung

type

Wie schnell ein Farbübergang erfolgt:

FadeType.FAST – Schnelle Farbübergänge.
FadeType.OFF – Sofortige Farbübergänge.
FadeType.SLOW – Langsame Farbübergänge.

# 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 stellt die Helligkeit der Touch-LED ein.

Usage:
touchled_1.set_brightness(brightness)

Parameter	Beschreibung
`brightness`	Die Helligkeit der Touch-LED kann als ganze Zahl von 0 % bis 100 % eingestellt werden.

# 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 lässt die Touch-LED wiederholt in einem Ein- und Aus-Muster blinken.

Hinweis: Der Aufruf von off beendet das Blinken nicht. Um das Blinken zu beenden, setzen Sie die LED-Helligkeit mit set_brightness auf 0.

Usage:
set_blink(color, ontime, offtime)

Parameter	Beschreibung
`color`	Stellt die Farbe der Touch-LED ein auf: `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` Sie können auch eine benutzerdefinierte Farbe angeben.
`ontime`	Die Dauer, in der die LED während jedes Blinkens leuchtet, in Sekunden. Standardwert: 0,25 Sekunden.
`offtime`	Wie lange die LED während jedes Blinkens ausgeschaltet bleibt (in Sekunden). Standardwert: 0,25 Sekunden.

Parameter

Beschreibung

color

Stellt die Farbe der Touch-LED ein auf:

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

Sie können auch eine benutzerdefinierte Farbe angeben.

ontime

Die Dauer, in der die LED während jedes Blinkens leuchtet, in Sekunden. Standardwert: 0,25 Sekunden.

offtime

Wie lange die LED während jedes Blinkens ausgeschaltet bleibt (in Sekunden). Standardwert: 0,25 Sekunden.

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

Getter #

pressing #

pressing wird eine ganze Zahl zurückgegeben, die angibt, ob die Touch-LED gerade gedrückt wird.

1 — Der TouchLED-Button wird gedrückt.
0 — Der TouchLED-Button wird nicht gedrückt.

Usage:
touchled_1.pressing()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

# 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 gibt einen booleschen Wert zurück, der angibt, ob die Touch-LED mit dem Brain verbunden ist.

True — Die Touch-LED ist mit dem Gehirn verbunden.
False — Die Touch-LED ist nicht mit dem Gehirn verbunden.

Usage:
touchled_1.installed()

Parameter	Beschreibung
	Diese Methode hat keine Parameter.

Konstruktoren #

Konstruktoren werden verwendet, um manuell Touchled Objekte zu erstellen, die für die Konfiguration einer Touch LED außerhalb von VEXcode erforderlich sind.

Touchled #

Touchled erzeugt eine Touch-LED.

Usage:
touchled_1 = Touchled(smartport)

Parameter	Beschreibung
`smartport`	Der Smart Port, an den die Touch-LED angeschlossen ist, wird als PORTx bezeichnet, wobei x die Nummer des Ports ist.

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