Dotyková LED#

Zavedení#

Dotyková LED dioda VEX IQ Touch je zároveň kontrolka i tlačítko. Může svítit různými barvami a poskytovat tak zpětnou vazbu, například signalizovat, že je robot připraven, ukazovat, který režim je vybrán, nebo shodovat se s barvou detekovanou jiným senzorem. Dokáže také detekovat dotyk, což vám umožní spustit nebo změnit chování robota klepnutím.

Tato stránka používá jako příklad názvu dotykové LED diody touchled_1 V případě potřeby jej nahraďte vlastním nakonfigurovaným názvem.

Níže je uveden seznam všech metod:

Akce – Interakce s dotykovou LED kontrolkou.

  • pressed — Registruje funkci, která se má volat při stisknutí dotykové LED diody.

  • released — Registruje funkci, která se má volat při uvolnění dotykové LED diody.

  • on – Zapne dotykovou LED.

  • off — Vypne dotykovou LED.

  • toggle — Zapíná nebo vypíná dotykovou LED.

Mutátory – Mění barvy, jas a nastavení dotykové LED diody.

  • set_color — Nastaví barvu dotykové LED diody.

  • set_fade — Nastavuje, jak rychle budou barvy přecházet jedna do druhé.

  • set_brightness — Nastaví jas dotykové LED diody.

  • set_blink — Střídavě zapíná a vypíná dotykovou LED diodu na dobu neurčitou.

Gettery – Vracejí data z dotykové LED diody.

  • pressing — Vrátí, zda je stisknuta dotyková LED.

  • installed — Vrátí, zda je dotyková LED dioda připojena k Brainu.

Konstruktory – Ruční inicializace a konfigurace dotykové LED.

Akce#

pressed#

pressed registruje funkci, která se má volat při stisknutí dotykové LED diody.

Usage:
touchled_1.pressed(callback, arg)

Parametry

Popis

callback

Funkce funkce, která je předem definována k provedení při stisknutí dotykové LED diody.

arg

Volitelné. N-tice tuple obsahující argumenty, které se mají předat zpětné funkci. Další informace naleznete v části Funkce s parametry.

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

touchled_1.pressed(light_blue)

released#

released registruje funkci, která má být volána po uvolnění dotykové LED diody.

Usage:
touchled_1.released(callback, arg)

Parametry

Popis

callback

Funkce funkce, která je předem definována k provedení po uvolnění dotykové LED diody.

arg

Volitelné. N-tice tuple obsahující argumenty, které se mají předat zpětné funkci. Další informace naleznete v části Funkce s parametry.

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

touchled_1.released(light_red)

on#

on zapne dotykovou LED diodu nastavením jejího jasu na 100 %.

Usage:
touchled_1.on(value)

Parametry

Popis

value

Volitelné. Nastaví barvu LED diody na:

  • Color.RED
  • Color.GREEN
  • Color.BLUE
  • Color.WHITE (výchozí)
  • 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
Můžete také zadat vlastní barvu.

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

off#

off vypne dotykovou LED diodu nastavením jejího jasu na 0 %.

Usage:
touchled_1.off()

Parametry

Popis

Tato metoda nemá žádné parametry.

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

toggle#

toggle zapíná nebo vypíná dotykovou LED. Pokud LED dioda aktuálně svítí, toggle nastaví její jas na 0 % a vypne ji. Pokud LED dioda nesvítí, toggle nastaví její jas na 100 % a zapne ji.

Usage:
touchled_1.toggle()

Parametry

Popis

Tato metoda nemá žádné parametry.

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

Mutátory#

set_color#

set_color nastavuje barvu dotykové LED diody. Pokud dotyková LED dioda při použití této metody ještě nesvítí, nastaví se jas na 100 %, aby se dotyková LED dioda rozsvítila.

Usage:
touchled_1.set_color(color)

Parametry

Popis

color

Volitelné. Nastaví barvu LED diody na:

  • Color.RED
  • Color.GREEN
  • Color.BLUE
  • Color.WHITE (výchozí)
  • 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
Pokud není zadána, set_color rozsvítí dotykovou LED diodu dříve nastavenou barvou.
Můžete také zadat vlastní barvu.

# 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 mění způsob, jakým dotyková LED dioda přechází do nových barev.

Usage:
touchled_1.set_fade(type)

Parametry

Popis

type

Jak rychle bude barva blednout z jedné barvy do druhé:

  • FadeType.FAST — Barvy budou přecházet rychle.
  • FadeType.OFF — Barvy budou přecházet okamžitě.
  • FadeType.SLOW — Barvy budou přecházet pomalu.

# 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 nastavuje jas dotykové LED.

Usage:
touchled_1.set_brightness(brightness)

Parametry

Popis

brightness

Jas dotykové LED diody se nastavuje jako celé číslo od 0 % do 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)

Gettery#

pressing#

pressing vrací celé číslo označující, zda je dotyková LED dioda aktuálně stisknuta.

  • 1 — Dotyková LED dioda je stisknuta.

  • 0 — Dotyková LED dioda není stisknuta.

Usage:
touchled_1.pressing()

Parametry

Popis

Tato metoda nemá žádné parametry.

# 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 vrací booleovskou hodnotu označující, zda je dotyková LED dioda připojena k Brainu.

  • True — Dotyková LED dioda je připojena k mozku.

  • False — Dotyková LED dioda není připojena k mozku.

Usage:
touchled_1.installed()

Parametry

Popis

Tato metoda nemá žádné parametry.

Konstruktéři#

Constructors are used to manually create Touchled objects, which are necessary for configuring a Touch LED outside of VEXcode.

Touchled#

Touchled vytvoří dotykovou LED.

Usage:
touchled_1 = Touchled(smartport)

Parametr

Popis

smartport

Inteligentní port, ke kterému je připojena dotyková LED dioda, zapsaný jako PORTx, kde x je číslo portu.

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