Barva

Zavedení

Barevný senzor je optický senzor, který umožňuje robotovi detekovat přítomnost objektu, rozpoznávat specifické barvy a vracet vizuální data, jako je jas a odstín.

Můžete také nakonfigurovat jas vnitřního osvětlení senzoru. Tyto nástroje jsou ideální pro programy, které potřebují reagovat na barevné objekty, světelné podmínky nebo zpětnou vazbu senzorů v reálném čase.

Tato stránka používá jako příklad názvu senzoru barev hodnotu color_1 V případě potřeby jej nahraďte vlastním nakonfigurovaným názvem.

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

Akce – Detekce objektů pomocí barevného senzoru.

• object_detected — Registruje funkci, která má být volána při detekci objektu.

Mutátory – Upravují světla na barevném senzoru.

• set_light — Nastaví LED diodu barevného senzoru na zapnuto, vypnuto nebo na nastavenou úroveň jasu.

• set_light_power — Nastaví jas LED diody barevného senzoru.

Gettery – Vracejí data objektu pomocí senzoru barev.

• is_near_object — Vrátí, zda se objekt nachází v dosahu senzoru.

• color — Vrátí hexadecimální kód detekované barvy.

• brightness — Vrátí detekovaný jas.

• hue — Vrátí detekovanou hodnotu odstínu.

• installed — Vrátí, zda je senzor barev připojen k mozku.

Konstruktory – Ruční inicializace a konfigurace barevného senzoru.

• ColorSensor — Vytvoří barevný senzor.

Akce

object_detected

object_detected registruje funkci, která má být volána, když barevný senzor detekuje objekt.

Usage:
color_1.object_detected(callback, args)

Parametry	Popis
callback	Funkce funkce, která je předem definována k provedení, když senzor barev detekuje objekt.
args	Volitelné. N-tice obsahující argumenty, které se mají předat zpětné funkci. Další informace naleznete v části Funkce s parametry.

Mutátory

set_light

set_light zapne, vypne nebo nastaví jas LED diody barevného senzoru.

Usage:
color_1.set_light(value, units)

Parametry	Popis
value	Určuje, zda se má LED dioda zapnout nebo vypnout, pomocí jedné z následujících možností: LedStateType.ON — Nastaví jas LED diody na 100 %. LedStateType.OFF — Nastaví jas LED diody na 0 %. Alternativně lze k nastavení jasu LED diody použít procenta od 0 do 100. Hodnota 0 LED diodu vypne; jakákoli hodnota nad 0 ji s daným jasem rozsvítí.
units	Volitelné. Jednotka, která představuje hodnotu jasu: 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 nastavuje jas LED diody barevného senzoru. Pokud LED dioda ještě nesvítí, tato metoda ji také zapne.

Usage:
color_1.set_light_power(value)

Parametry	Popis
value	Jas LED diody v procentech od 0 do 100. Hodnota 0 LED diodu vypne.

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

Gettery

is_near_object

is_near_object vrací booleovskou hodnotu, která indikuje, zda se barevný senzor nachází přibližně do 57 milimetrů (2,25 palce) od objektu. Detekce závisí na odraženém světle, takže tmavé nebo nereflexní povrchy nemusí být spolehlivě detekovány.

• True — Detekovaný objekt se nachází do vzdálenosti přibližně 57 milimetrů.

• False — Detekovaný objekt se nenachází ve vzdálenosti přibližně 57 milimetrů.

Usage:
color_1.is_near_object()

Parametry	Popis
	Tato metoda nemá žádné parametry.

color

color vrací hexadecimální kód detekované barvy jako řetězec ve formátu „Barva“, následovaný dvěma nulami a hexadecimální hodnotou barvy.

Například detekce červené (#FF0000) by vrátila „Color 00FF0000“.

Usage:
color_1.color()

Parametry	Popis
	Tato metoda nemá žádné parametry.

# 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 vrací jas detekované barvy jako celé číslo od 0 % do 100 %.

Vyšší procento znamená, že barevný senzor detekuje více světla. Nižší procento znamená, že barevný senzor detekuje méně světla.

Usage:
color_1.brightness()

Parametry	Popis
	Tato metoda nemá žádné parametry.

# 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 vrací detekovanou hodnotu odstínu jako číslo s desetinnou čárkou v rozsahu od 0 do 359,99 stupňů.

Odstín je způsob, jak popsat barvu pomocí čísel v barevném kruhu, jak je znázorněno níže.

Usage:
color_1.hue()

Parametry	Popis
	Tato metoda nemá žádné parametry.

# 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 vrací booleovskou hodnotu označující, zda je barevný senzor připojen k mozku.

• True — Senzor barev je propojen s mozkem.

• False — Senzor barev není připojen k mozku.

Usage:
color_1.installed()

Parametry	Popis
	Tato metoda nemá žádné parametry.

Konstruktéři

Konstruktory se používají k ručnímu vytvoření objektů ColorSensor , které jsou nezbytné pro konfiguraci Color Sensoru mimo VEXcode.

ColorSensor

ColorSensor vytvoří barevný senzor.

Usage:
color_1 = ColorSensor(smartport)

Parametr	Popis
smartport	Inteligentní port, ke kterému je připojen barevný senzor, zapsaný jako PORTx, kde x je číslo portu.

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