Pek-LED#

Introduktion #

VEX IQ Touch LED är både en lampa och en knapp. Den kan lysa i olika färger för att ge feedback, till exempel signalera att roboten är redo, visa vilket läge som är valt eller matcha en färg som detekteras av en annan sensor, och den kan känna av när den berörs, vilket låter dig starta eller ändra en robots beteende med ett tryck.

Den här sidan använder touchled_1 som exempelnamn för pekskärms-LED. Ersätt det med ditt eget konfigurerade namn efter behov.

Nedan följer en lista över alla metoder:

Åtgärder — Interagera med pekskärmens LED.

pressed — Registrerar en funktion som ska anropas när pekskärms-LED:n trycks ned.
released — Registrerar en funktion som ska anropas när pekskärmslampan släpps.
on — Slår på pekskärmens lysdiod.
off — Stänger av pekskärmens LED-lampa.
toggle — Slår på eller av pekskärmens LED-lampa.

Mutatorer — Ändra färger, ljusstyrka och inställningar för Touch-LED:n.

set_color — Ställer in färgen på pekskärmens LED-lampa.
set_fade — Anger hur snabbt färger ska tona in i varandra.
set_brightness — Ställer in ljusstyrkan för pekskärmens LED.
set_blink — Växla mellan pekskärms-LED:n och tändningen i oändlighet.

Getters — Returnera data från Touch-LED:n.

pressing — Returnerar om pekskärms-LED:n trycks ned.
installed — Returnerar om Touch-LED:n är ansluten till hjärnan.

Konstruktörer — Initiera och konfigurera pekskärms-LED:n manuellt.

Touchled — Skapa en touch-LED.

Åtgärder #

pressed #

pressed registrerar en funktion som ska anropas när pek-LED:n trycks ned.

Usage:
touchled_1.pressed(callback, arg)

Parametrar	Beskrivning
`callback`	En funktion som tidigare är definierad att köras när pekskärms-LED:n trycks ned.
`arg`	Valfritt. En tupel som innehåller argument som ska skickas till callback-funktionen. Se Funktioner med parametrar för mer 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 registrerar en funktion som ska anropas när pek-LED:n släpps.

Usage:
touchled_1.released(callback, arg)

Parametrar	Beskrivning
`callback`	En funktion som tidigare är definierad att köras när pekskärms-LED:n släpps.
`arg`	Valfritt. En tupel som innehåller argument som ska skickas till callback-funktionen. Se Funktioner med parametrar för mer 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 tänder Touch-LED:n genom att ställa in dess ljusstyrka på 100 %.

Usage:
touchled_1.on(value)

Parametrar	Beskrivning
`value`	Valfritt. Ställer in lysdiodens färg till: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (standard) `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` Du kan också ange en anpassad färg.

Parametrar

Beskrivning

value

Valfritt. Ställer in lysdiodens färg till:

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

Du kan också ange en anpassad färg.

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

off #

off släcker Touch-LED-lampan genom att ställa in dess ljusstyrka på 0 %.

Usage:
touchled_1.off()

Parametrar	Beskrivning
	Den här metoden har inga parametrar.

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

toggle #

toggle slår på eller av pekskärms-LED:n. Om LED-lampan är tänd, toggle ställer in ljusstyrkan på 0 % och stänger av den. Om LED-lampan är släckt, toggle ställer in ljusstyrkan på 100 % och slår på den.

Usage:
touchled_1.toggle()

Parametrar	Beskrivning
	Den här metoden har inga parametrar.

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

Mutatorer #

set_color #

set_color ställer in färgen på Touch-LED:n. Om Touch-LED:n inte redan är tänd när den här metoden används, ställs ljusstyrkan in på 100 % för att slå på Touch-LED:n.

Usage:
touchled_1.set_color(color)

Parametrar	Beskrivning
`color`	Valfritt. Ställer in lysdiodens färg till: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (standard) `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` Om inget alternativ anges, `set_color` tänds Touch-LED:n med den tidigare inställda färgen. Du kan också ange en anpassad färg.

Parametrar

Beskrivning

color

Valfritt. Ställer in lysdiodens färg till:

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

Om inget alternativ anges, set_color tänds Touch-LED:n med den tidigare inställda färgen.
Du kan också ange en anpassad färg.

# 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 ändrar hur Touch-LED-lampan övergår till nya färger.

Usage:
touchled_1.set_fade(type)

Parametrar	Beskrivning
`type`	Hur snabbt en färg bleknar från en till nästa: `FadeType.FAST` — Färgerna övergår snabbt. `FadeType.OFF` — Färgerna övergår direkt. `FadeType.SLOW` — Färgerna övergår långsamt.

Parametrar

Beskrivning

type

Hur snabbt en färg bleknar från en till nästa:

FadeType.FAST — Färgerna övergår snabbt.
FadeType.OFF — Färgerna övergår direkt.
FadeType.SLOW — Färgerna övergår långsamt.

# 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 ställer in ljusstyrkan för pekskärmens LED.

Usage:
touchled_1.set_brightness(brightness)

Parametrar	Beskrivning
`brightness`	Ljusstyrkan för touch-LED:n kan ställas in som ett heltal från 0 % till 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 blinkar upprepade gånger på- och av-lampan.

Obs: Att anropa off stoppar inte blinkningen. För att stoppa blinkningen, ställ in LED-ljusstyrkan till 0 med set_brightness.

Usage:
set_blink(color, ontime, offtime)

Parametrar	Beskrivning
`color`	Ställer in pekskärmens LED-färg till: `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` Du kan också ange en anpassad färg.
`ontime`	Hur länge lysdioden lyser under varje blinkning, i sekunder. Standardinställningen är 0,25 sekunder.
`offtime`	Hur länge lysdioden är släckt under varje blinkning, i sekunder. Standardinställningen är 0,25 sekunder.

Parametrar

Beskrivning

color

Ställer in pekskärmens LED-färg till:

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

Du kan också ange en anpassad färg.

ontime

Hur länge lysdioden lyser under varje blinkning, i sekunder. Standardinställningen är 0,25 sekunder.

offtime

Hur länge lysdioden är släckt under varje blinkning, i sekunder. Standardinställningen är 0,25 sekunder.

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

pressing returnerar ett heltal som anger om pek-LED:n trycks ned för närvarande.

1 — TouchLED-lampan trycks ned.
0 — TouchLED-lampan trycks inte in.

Usage:
touchled_1.pressing()

Parametrar	Beskrivning
	Den här metoden har inga parametrar.

# 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 returnerar ett booleskt värde som anger om Touch-LED:n är ansluten till hjärnan.

True — Touch-LED:n är ansluten till hjärnan.
False — Touch-LED:n är inte ansluten till hjärnan.

Usage:
touchled_1.installed()

Parametrar	Beskrivning
	Den här metoden har inga parametrar.

Konstruktörer #

Konstruktorer används för att manuellt skapa Touchled objekt, vilka är nödvändiga för att konfigurera en Touch-LED utanför VEXcode.

Touchled #

Touchled skapar en touch-LED.

Usage:
touchled_1 = Touchled(smartport)

Parameter	Beskrivning
`smartport`	Den smarta porten som touch-LED:n är ansluten till, skriven som PORTx där x är portens nummer.

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