Aanraak-LED#

Invoering #

De VEX IQ Touch LED is zowel een lampje als een knop. Hij kan in verschillende kleuren oplichten om feedback te geven, bijvoorbeeld om aan te geven dat de robot klaar is, welke modus is geselecteerd of om een kleur te tonen die door een andere sensor is gedetecteerd. Hij kan ook detecteren wanneer hij wordt aangeraakt, waardoor je het gedrag van een robot met een tik kunt starten of wijzigen.

Op deze pagina wordt touchled_1 als voorbeeldnaam voor de touch-led gebruikt. Vervang dit door uw eigen geconfigureerde naam.

Hieronder vindt u een lijst met alle methoden:

Acties — Interactie met de aanraak-LED.

pressed — Registreert een functie die moet worden aangeroepen wanneer de Touch LED wordt ingedrukt.
released — Registreert een functie die moet worden aangeroepen wanneer de Touch LED wordt losgelaten.
on — Schakelt de aanraak-LED in.
off — Schakelt de aanraak-LED uit.
toggle — Schakelt de aanraak-LED in of uit.

Mutators — Wijzig de kleuren, helderheid en instellingen van de Touch LED.

set_color — Stelt de kleur van de Touch LED in.
set_fade — Hiermee wordt ingesteld hoe snel kleuren in elkaar overvloeien.
set_brightness — Stelt de helderheid van de Touch LED in.
set_blink — Schakel de aanraak-LED oneindig aan en uit.

Getters — Gegevens ophalen van de Touch LED.

pressingindrukt — Geeft aan of de aanraak-LED wordt ingedrukt.
installed — Geeft aan of de Touch LED is verbonden met de Brain.

Constructors — Initialiseer en configureer de Touch LED handmatig.

Touchled — Maak een aanraakbare LED.

Acties #

pressed #

pressed registreert een functie die moet worden aangeroepen wanneer de aanraak-LED wordt ingedrukt.

Usage:
touchled_1.pressed(callback, arg)

Parameters	Beschrijving
`callback`	Een functie die eerder is gedefinieerd om te worden uitgevoerd wanneer de Touch LED wordt ingedrukt.
`arg`	Optioneel. Een tuple met argumenten die aan de callbackfunctie moeten worden doorgegeven. Zie Functies met parameters voor meer informatie.

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

touchled_1.pressed(light_blue)

released #

released registreert een functie die moet worden aangeroepen wanneer de Touch LED wordt losgelaten.

Usage:
touchled_1.released(callback, arg)

Parameters	Beschrijving
`callback`	Een functie die eerder is gedefinieerd om te worden uitgevoerd wanneer de Touch LED wordt losgelaten.
`arg`	Optioneel. Een tuple met argumenten die aan de callbackfunctie moeten worden doorgegeven. Zie Functies met parameters voor meer informatie.

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

touchled_1.released(light_red)

on #

Met on wordt de Touch LED ingeschakeld door de helderheid op 100% te zetten.

Usage:
touchled_1.on(value)

Parameters	Beschrijving
`value`	Optioneel. Stelt de kleur van de LED in op: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (standaard) `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` U kunt ook een aangepaste kleur opgeven.

Parameters

Beschrijving

value

Optioneel. Stelt de kleur van de LED in op:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (standaard)
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

U kunt ook een aangepaste kleur opgeven.

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

off #

Met off wordt de Touch LED uitgeschakeld door de helderheid op 0% te zetten.

Usage:
touchled_1.off()

Parameters	Beschrijving
	Deze methode heeft geen parameters.

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

Parameters	Beschrijving
	Deze methode heeft geen parameters.

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

Mutators #

set_color #

set_color stelt de kleur van de Touch LED in. Als de Touch LED nog niet aan staat wanneer deze methode wordt gebruikt, wordt de helderheid op 100% gezet om de Touch LED in te schakelen.

Usage:
touchled_1.set_color(color)

Parameters	Beschrijving
`color`	Optioneel. Stelt de kleur van de LED in op: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (standaard) `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` Indien niet gespecificeerd, `set_color` zal de Touch LED inschakelen met de eerder ingestelde kleur. U kunt ook een aangepaste kleur specificeren.

Parameters

Beschrijving

color

Optioneel. Stelt de kleur van de LED in op:

Color.RED
Color.GREEN
Color.BLUE
Color.WHITE (standaard)
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

Indien niet gespecificeerd, set_color zal de Touch LED inschakelen met de eerder ingestelde kleur.
U kunt ook een aangepaste kleur specificeren.

# 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 wijzigt hoe de Touch LED overgaat naar nieuwe kleuren.

Usage:
touchled_1.set_fade(type)

Parameters	Beschrijving
`type`	Hoe snel een kleur van de ene naar de andere overgaat: `FadeType.FAST` — Kleuren gaan snel in elkaar over. `FadeType.OFF` — Kleuren gaan direct in elkaar over. `FadeType.SLOW` — Kleuren gaan langzaam in elkaar over.

Parameters

Beschrijving

type

Hoe snel een kleur van de ene naar de andere overgaat:

FadeType.FAST — Kleuren gaan snel in elkaar over.
FadeType.OFF — Kleuren gaan direct in elkaar over.
FadeType.SLOW — Kleuren gaan langzaam in elkaar over.

# 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 stelt de helderheid van de Touch LED in.

Usage:
touchled_1.set_brightness(brightness)

Parameters	Beschrijving
`brightness`	De helderheid van de Touch LED kan worden ingesteld als een geheel getal van 0% tot 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 laat de Touch LED herhaaldelijk knipperen in een aan- en uitpatroon.

Opmerking: Het aanroepen van off zal het knipperen niet stoppen. Om het knipperen te stoppen, stelt u de helderheid van de LED in op 0 met set_brightness.

Usage:
set_blink(color, ontime, offtime)

Parameters	Beschrijving
`color`	Hiermee wordt de kleur van de aanraak-LED ingesteld op: `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` U kunt ook een aangepaste kleur opgeven.
`ontime`	Hoe lang de LED brandt tijdens elke knipperbeweging, in seconden. Standaard is dit 0,25 seconden.
`offtime`	Hoe lang de LED uit blijft tijdens elke knipperbeweging, in seconden. Standaardwaarde: 0,25 seconden.

Parameters

Beschrijving

color

Hiermee wordt de kleur van de aanraak-LED ingesteld op:

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

U kunt ook een aangepaste kleur opgeven.

ontime

Hoe lang de LED brandt tijdens elke knipperbeweging, in seconden. Standaard is dit 0,25 seconden.

offtime

Hoe lang de LED uit blijft tijdens elke knipperbeweging, in seconden. Standaardwaarde: 0,25 seconden.

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

Getters #

pressing #

Als je pressing krijg je een geheel getal terug dat aangeeft of de aanraak-LED momenteel wordt ingedrukt.

1 — De TouchLED wordt ingedrukt.
0 — De TouchLED wordt niet ingedrukt.

Usage:
touchled_1.pressing()

Parameters	Beschrijving
	Deze methode heeft geen parameters.

# 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 retourneert een Booleaanse waarde die aangeeft of de Touch LED is verbonden met de Brain.

True — De aanraak-LED is verbonden met de hersenen.
False — De aanraak-LED is niet verbonden met de hersenen.

Usage:
touchled_1.installed()

Parameters	Beschrijving
	Deze methode heeft geen parameters.

Constructeurs #

Constructors worden gebruikt om handmatig Touchled objecten te creëren, die nodig zijn voor het configureren van een Touch LED buiten VEXcode.

Touchled #

Touchled creëert een Touch LED.

Usage:
touchled_1 = Touchled(smartport)

Parameter	Beschrijving
`smartport`	De Smart Port waarop de Touch LED is aangesloten, wordt weergegeven als PORTx, waarbij x het poortnummer is.

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