Szín

Bevezetés

A színérzékelő egy optikai érzékelő, amely lehetővé teszi a robot számára, hogy érzékelje egy tárgy jelenlétét, felismerje a meghatározott színeket, és vizuális adatokat, például fényerőt és színárnyalatot adjon vissza.

A szenzor belső fényének fényerejét is beállíthatod. Ezek az eszközök ideálisak olyan programokhoz, amelyeknek valós időben kell reagálniuk színes tárgyakra, fényviszonyokra vagy szenzor-visszajelzésekre.

Ez az oldal color_1 értéket használja példaként a színérzékelő nevére. Szükség szerint cserélje ki a saját konfigurált névre.

Az alábbiakban felsoroljuk az összes módszert:

Műveletek — Tárgyak érzékelése a színérzékelővel.

• object_detected — Regisztrál egy függvényt, amely meghívódik, amikor egy objektumot észlel.

Mutátorok – Módosíthatod a színérzékelő fényeit.

• set_light — Be-, kikapcsolja a színérzékelő LED-jét, vagy beállítja a fényerőt.

• set_light_power — Beállítja a színérzékelő LED-jének fényerejét.

Getterek – Objektumadatokat adnak vissza a színérzékelővel.

• is_near_object — Visszaadja, hogy egy objektum a szenzor hatótávolságán belül van-e.

• color — Visszaadja a detektált szín hexadecimális kódját.

• brightness — Visszaadja az érzékelt fényerőt.

• hue — Visszaadja az érzékelt színárnyalat értékét.

• installed — Visszaadja, hogy a színérzékelő csatlakozik-e az agyhoz.

Konstruktorok – Színérzékelő manuális inicializálása és konfigurálása.

• ColorSensor — Színérzékelőt hoz létre.

Műveletek

object_detected

object_detected regisztrál egy függvényt, amely akkor hívódik meg, amikor a színérzékelő egy objektumot érzékel.

Usage:
color_1.object_detected(callback, args)

Paraméterek	Leírás
callback	Egy korábban definiált függvény, amely akkor hajtódik végre, amikor a színérzékelő egy objektumot érzékel.
args	Opcionális. Egy tuple, amely argumentumokat tartalmaz a visszahívó függvénynek átadandó. További információkért lásd a Functions with Parameters részt.

Mutátorok

set_light

set_light A színérzékelő LED-jét be-, kikapcsolt állapotba, vagy egy beállított fényerőszintre állítja.

Usage:
color_1.set_light(value, units)

Paraméterek	Leírás
value	A LED be- vagy kikapcsolását az alábbiak egyikével határozza meg: LedStateType.ON — A LED fényerejét 100%-ra állítja. LedStateType.OFF — A LED fényerejét 0%-ra állítja. Alternatív megoldásként 0 és 100 közötti százalékos értékkel is beállítható a LED fényereje. A 0 érték kikapcsolja a LED-et; a 0 feletti érték pedig ezen a fényerőn bekapcsolja.
units	Opcionális. A fényerő értékét jelző mértékegység: PERCENT.

# Turn the LED on and off forever
while True:
    color_1.set_light(LedStateType.ON)
    wait(0.5, SECONDS)
    color_1.set_light(LedStateType.OFF)
    wait(0.5, SECONDS)

# Turn the LED on and off forever
while True:
    color_1.set_light(LedStateType.ON, 75)
    wait(0.5, SECONDS)
    color_1.set_light(0)
    wait(0.5, SECONDS)

set_light_power

set_light_power beállítja a színérzékelő LED-jének fényerejét. Ha a LED még nem világít, ez a metódus bekapcsolja azt is.

Usage:
color_1.set_light_power(value)

Paraméterek	Leírás
value	A LED fényereje százalékban, 0 és 100 között. A 0 érték kikapcsolja a LED-et.

# Turn the LED light on at different intensities
color_1.set_light_power(10)
wait(2, SECONDS)
color_1.set_light_power(100)

Getterek

is_near_object

is_near_object Egy logikai értéket ad vissza, amely azt jelzi, hogy a színérzékelő körülbelül 57 milliméteren (2,25 hüvelyken) belül van-e a tárgytól. Az érzékelés a visszavert fénytől függ, így a sötét vagy nem fényvisszaverő felületek érzékelése nem biztos, hogy megbízható.

• True — Az érzékelt tárgy körülbelül 57 milliméteren belül van.

• False — Az érzékelt tárgy nincs körülbelül 57 milliméteren belül.

Usage:
color_1.is_near_object()

Paraméterek	Leírás
	Ennek a metódusnak nincsenek paraméterei.

color

color Az 1-es paraméter a detektált szín hexadecimális kódját adja vissza karakterláncként a következő formátumban: “Color”, majd két nulla, végül a szín hexadecimális értéke.

Például a piros (#FF0000) észlelése a „Color 00FF0000” értéket adja vissza.

Usage:
color_1.color()

Paraméterek	Leírás
	Ennek a metódusnak nincsenek paraméterei.

# Display the currently detected hex value
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print(color_1.color())
    wait(0.5,SECONDS)

brightness

brightness visszaadja a detektált szín fényességét 0%-tól 100%-ig terjedő egész számként.

A magasabb százalékos érték azt jelenti, hogy a színérzékelő több fényt érzékel. Az alacsonyabb százalékos érték azt jelenti, hogy a színérzékelő kevesebb fényt érzékel.

Usage:
color_1.brightness()

Paraméterek	Leírás
	Ennek a metódusnak nincsenek paraméterei.

# Display the currently detected brightness
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Brightness:")
    brain.screen.next_row()
    brain.screen.print(color_1.brightness())
    wait(0.5,SECONDS)

hue

hue érték a detektált színárnyalat értékét adja vissza lebegőpontos számként 0 és 359,99 fok között.

A színárnyalat a színek leírásának egy módja, számok segítségével, egy színkör körül, az alábbiak szerint.

Usage:
color_1.hue()

Paraméterek	Leírás
	Ennek a metódusnak nincsenek paraméterei.

# Display the currently detected hue 
while True:
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)
    brain.screen.print("Hue: ")
    brain.screen.print(color_1.hue())
    wait(0.5,SECONDS)

installed

installed egy logikai értéket ad vissza, amely azt jelzi, hogy a színérzékelő csatlakoztatva van-e az agyhoz.

• True — A színérzékelő az agyhoz van csatlakoztatva.

• False — A színérzékelő nincs csatlakoztatva az agyhoz.

Usage:
color_1.installed()

Paraméterek	Leírás
	Ennek a metódusnak nincsenek paraméterei.

Konstruktorok

A konstruktorokat ColorSensor objektumok manuális létrehozására használjuk, amelyek szükségesek egy színérzékelő VEXcode-on kívüli konfigurálásához.

ColorSensor

ColorSensor létrehoz egy színérzékelőt.

Usage:
color_1 = ColorSensor(smartport)

Paraméter	Leírás
smartport	Az az intelligens port, amelyhez a színérzékelő csatlakozik, PORTx-ként írva, ahol x a port száma.

# Create a Color Sensor object in Port 3
color_1 = ColorSensor(Ports.PORT3)