Kosketus-LED#

Johdanto #

VEX IQ Touch -LED on sekä valo että painike. Se voi hehkua eri väreillä antaakseen palautetta, esimerkiksi robotin valmiuden osoittamiseksi, valitun tilan näyttämiseksi tai toisen anturin havaitseman värin mukaiseksi. Se voi myös havaita kosketuksen, jolloin voit käynnistää robotin toiminnan tai muuttaa sitä napauttamalla.

Tällä sivulla käytetään esimerkkinä kosketus-LEDin nimeä touchled_1 Korvaa se tarvittaessa omalla määrittämälläsi nimellä.

Alla on luettelo kaikista menetelmistä:

Toiminnot — Käytä kosketus-LEDiä.

pressed — Rekisteröi funktion, joka kutsutaan, kun kosketus-LEDiä painetaan.
released — Rekisteröi funktion, joka kutsutaan, kun kosketus-LED vapautetaan.
on:llä — Sytyttää kosketus-LED-valon.
off — Sammuttaa kosketus-LEDin.
toggle — Kytkee kosketus-LEDin päälle tai pois päältä.

Mutaattorit — Muuta kosketus-LEDin värejä, kirkkautta ja asetuksia.

set_color — Asettaa kosketus-LEDin värin.
set_fade — Määrittää, kuinka nopeasti värit häipyvät toisiinsa.
set_brightness — Asettaa kosketus-LEDin kirkkautta.
set_blink — Kytkee kosketus-LEDin päälle ja pois päältä vuorotellen loputtomiin.

Getterit — Palauttavat dataa kosketus-LEDistä.

pressing — Palauttaa tiedon siitä, painetaanko kosketus-LEDiä.
installed — Palauttaa, onko kosketus-LED kytketty aivoihin.

Konstruktorit — Kosketus-LEDin manuaalinen alustaminen ja konfigurointi.

Touchled — Luo kosketus-LED.

Toiminnot #

pressed #

pressed rekisteröi funktion, joka kutsutaan, kun kosketus-LEDiä painetaan.

Usage:
touchled_1.pressed(callback, arg)

Parametrit	Kuvaus
`callback`	Funktio, joka on aiemmin määritelty suoritettavaksi, kun kosketus-LEDiä painetaan.
`arg`	Valinnainen. tuple, joka sisältää argumentteja, jotka välitetään takaisinkutsufunktiolle. Katso lisätietoja kohdasta Functions with Parameters.

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

touchled_1.pressed(light_blue)

released #

released rekisteröi funktion, jota kutsutaan, kun kosketus-LED vapautetaan.

Usage:
touchled_1.released(callback, arg)

Parametrit	Kuvaus
`callback`	Funktio, joka on aiemmin määritelty suoritettavaksi, kun kosketus-LED vapautetaan.
`arg`	Valinnainen. tuple, joka sisältää argumentteja, jotka välitetään takaisinkutsufunktiolle. Katso lisätietoja kohdasta Functions with Parameters.

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

touchled_1.released(light_red)

on #

on sytyttää kosketus-LEDin asettamalla sen kirkkauden 100 %:iin.

Usage:
touchled_1.on(value)

Parametrit	Kuvaus
`value`	Valinnainen. Asettaa LEDin väriksi: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (oletus) `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` Voit myös määrittää mukautetun värin.

Parametrit

Kuvaus

value

Valinnainen. Asettaa LEDin väriksi:

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

Voit myös määrittää mukautetun värin.

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

off #

off sammuttaa kosketus-LEDin asettamalla sen kirkkauteen 0 %.

Usage:
touchled_1.off()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

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

toggle #

toggle kytkee kosketus-LEDin päälle tai pois päältä. Jos LED palaa parhaillaan, toggle asettaa sen kirkkauteen 0 %:iin, jolloin se sammuu. Jos LED ei pala, toggle asettaa sen kirkkauteen 100 %:iin, jolloin se kytkeytyy päälle.

Usage:
touchled_1.toggle()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

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

Mutaattorit #

set_color #

set_color asettaa kosketus-LEDin värin. Jos kosketus-LED ei ole jo päällä, kun tätä menetelmää käytetään, se asettaa kirkkaudekseksi 100 %:n, jotta kosketus-LED syttyy.

Usage:
touchled_1.set_color(color)

Parametrit	Kuvaus
`color`	Valinnainen. Asettaa LEDin väriksi: `Color.RED` `Color.GREEN` `Color.BLUE` `Color.WHITE` (oletus) `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` Jos sitä ei ole määritetty, `set_color` sytyttää kosketus-LEDin aiemmin asetetulla värillä. Voit myös määrittää mukautetun värin.

Parametrit

Kuvaus

color

Valinnainen. Asettaa LEDin väriksi:

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

Jos sitä ei ole määritetty, set_color sytyttää kosketus-LEDin aiemmin asetetulla värillä.
Voit myös määrittää mukautetun värin.

# 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 muuttaa tapaa, jolla kosketus-LED siirtyy uusiin väreihin.

Usage:
touchled_1.set_fade(type)

Parametrit	Kuvaus
`type`	Kuinka nopeasti väri haalistuu väristä toiseen: `FadeType.FAST` — Värit vaihtuvat nopeasti. `FadeType.OFF` — Värit vaihtuvat välittömästi. `FadeType.SLOW` — Värit vaihtuvat hitaasti.

Parametrit

Kuvaus

type

Kuinka nopeasti väri haalistuu väristä toiseen:

FadeType.FAST — Värit vaihtuvat nopeasti.
FadeType.OFF — Värit vaihtuvat välittömästi.
FadeType.SLOW — Värit vaihtuvat hitaasti.

# 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 asettaa kosketusnäytön LED-valon kirkkautta.

Usage:
touchled_1.set_brightness(brightness)

Parametrit	Kuvaus
`brightness`	Kosketus-LEDin kirkkaus asetetaan kokonaislukuna väliltä 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 vilkuttaa kosketus-LEDiä toistuvasti päälle ja pois päältä -kuviossa.

Huomautus: Funktion off kutsuminen ei pysäytä vilkkumista. Vilkkumisen pysäyttämiseksi aseta LED-valon kirkkaus arvoon 0 funktiolla set_brightness.

Usage:
set_blink(color, ontime, offtime)

Parametrit	Kuvaus
`color`	Asettaa kosketus-LEDin väriksi: `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` Voit myös määrittää mukautetun värin.
`ontime`	Kuinka kauan LED-valo palaa sekunteina kunkin välähdyksen aikana. Oletusarvo on 0,25 sekuntia.
`offtime`	Kuinka kauan LED pysyy sammuneena jokaisen välähdyksen aikana, sekunteina. Oletusarvo on 0,25 sekuntia.

Parametrit

Kuvaus

color

Asettaa kosketus-LEDin väriksi:

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

Voit myös määrittää mukautetun värin.

ontime

Kuinka kauan LED-valo palaa sekunteina kunkin välähdyksen aikana. Oletusarvo on 0,25 sekuntia.

offtime

Kuinka kauan LED pysyy sammuneena jokaisen välähdyksen aikana, sekunteina. Oletusarvo on 0,25 sekuntia.

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

Getterit #

pressing #

pressing palauttaa kokonaisluvun, joka ilmaisee, painetaanko kosketus-LEDiä parhaillaan.

1 — Kosketus-LED-painiketta painetaan.
0 — Touch-LED-valoa ei paineta.

Usage:
touchled_1.pressing()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

# 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 palauttaa totuusarvon, joka ilmaisee, onko kosketus-LED kytketty aivoihin.

True — Kosketus-LED on kytketty aivoihin.
False — Kosketus-LED ei ole kytketty aivoihin.

Usage:
touchled_1.installed()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

Rakentajat #

Konstruktoreita käytetään Touchled -objektien manuaaliseen luomiseen, jotka ovat välttämättömiä Touch LEDin konfiguroimiseksi VEXcoden ulkopuolella.

Touchled #

Touchled luo Touch-LEDin.

Usage:
touchled_1 = Touchled(smartport)

Parametri	Kuvaus
`smartport`	Kosketus-LEDin kytkentään tarkoitettu älyportti, joka merkitään muodossa PORTx, jossa x on portin numero.

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