Kolor

Wstęp

Czujnik koloru to czujnik optyczny, który umożliwia robotowi wykrywanie obecności obiektu, rozpoznawanie określonych kolorów i przekazywanie danych wizualnych, takich jak jasność i odcień.

Można również skonfigurować jasność wewnętrznego oświetlenia czujnika. Te narzędzia są idealne dla programów, które muszą reagować na kolorowe obiekty, warunki oświetleniowe lub sygnały z czujnika w czasie rzeczywistym.

Ta strona używa color_1 jako przykładowej nazwy czujnika koloru. W razie potrzeby zastąp ją własną, skonfigurowaną nazwą.

Poniżej znajduje się lista wszystkich metod:

Akcje — Wykrywanie obiektów za pomocą czujnika koloru.

• object_detected — Rejestruje funkcję, która ma zostać wywołana po wykryciu obiektu.

Mutatory — modyfikują światła na czujniku koloru.

• set_light — Ustawia diodę LED czujnika koloru na włączoną, wyłączoną lub na ustawiony poziom jasności.

• set_light_power — Ustawia jasność diody LED czujnika koloru.

Gettery — zwracają dane obiektu za pomocą czujnika koloru.

• is_near_object — Zwraca informację, czy obiekt znajduje się w zasięgu czujnika.

• color — Zwraca kod szesnastkowy wykrytego koloru.

• brightness — Zwraca wykrytą jasność.

• hue — Zwraca wykrytą wartość odcienia.

• zainstalowanoinstalled — Zwraca informację, czy czujnik koloru jest podłączony do mózgu.

Konstruktory — ręczna inicjalizacja i konfiguracja czujnika koloru.

• ColorSensor — Tworzy czujnik koloru.

Akcje

object_detected

object_detected rejestruje funkcję, która ma zostać wywołana, gdy czujnik koloru wykryje obiekt.

Usage:
color_1.object_detected(callback, args)

Parametry	Opis
callback	Funkcja, która została wcześniej zdefiniowana do wykonania, gdy czujnik koloru wykryje obiekt.
args	Opcjonalnie. Krotka zawierająca argumenty do przekazania do funkcji wywołania zwrotnego. Więcej informacji można znaleźć w Funkcjach z parametrami.

Mutatory

set_light

set_light włącza, wyłącza lub ustawia poziom jasności diody LED czujnika koloru.

Usage:
color_1.set_light(value, units)

Parametry	Opis
value	Określa, czy dioda LED ma być włączona, czy wyłączona, używając jednej z następujących opcji: LedStateType.ON — ustawia jasność diody LED na 100%. LedStateType.OFF — ustawia jasność diody LED na 0%. Alternatywnie, jasność diody LED można ustawić w procentach od 0 do 100. Wartość 0 wyłącza diodę LED; wartość powyżej 0 włącza ją z tą jasnością.
units	Opcjonalnie. Jednostka reprezentująca wartość jasności: 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 ustawia jasność diody LED czujnika koloru. Jeśli dioda LED nie jest jeszcze włączona, ta metoda również ją włączy.

Usage:
color_1.set_light_power(value)

Parametry	Opis
value	Jasność diody LED wyrażona w procentach od 0 do 100. Wartość 0 powoduje wyłączenie diody LED.

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

Getters

is_near_object

is_near_object zwraca wartość logiczną wskazującą, czy czujnik koloru znajduje się w odległości około 57 milimetrów (2,25 cala) od obiektu. Wykrywanie zależy od światła odbitego, więc ciemne lub nieodblaskowe powierzchnie mogą nie zostać wykryte wiarygodnie.

• True — Wykryty obiekt znajduje się w odległości około 57 milimetrów.

• False — Wykryty obiekt nie znajduje się w odległości około 57 milimetrów.

Usage:
color_1.is_near_object()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

color

color zwraca kod szesnastkowy wykrytego koloru jako ciąg w formacie „Color”, po którym następują dwa zera i wartość szesnastkowa koloru.

Na przykład wykrycie koloru czerwonego (#FF0000) zwróci „Kolor 00FF0000”.

Usage:
color_1.color()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

# 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 zwraca jasność wykrytego koloru jako liczbę całkowitą od 0% do 100%.

Wyższy procent oznacza, że ​​czujnik koloru wykrywa więcej światła. Niższy procent oznacza, że ​​czujnik koloru wykrywa mniej światła.

Usage:
color_1.brightness()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

# 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 zwraca wykrytą wartość odcienia jako liczbę zmiennoprzecinkową w zakresie od 0 do 359,99 stopni.

Odcień to sposób opisywania koloru za pomocą liczb znajdujących się na kole barw, jak pokazano poniżej.

Usage:
color_1.hue()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

# 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 zwraca wartość logiczną wskazującą, czy czujnik koloru jest podłączony do mózgu.

• True — Czujnik koloru jest połączony z mózgiem.

• False — Czujnik koloru nie jest połączony z mózgiem.

Usage:
color_1.installed()

Parametry	Opis
	Ta metoda nie ma żadnych parametrów.

Konstruktorzy

Konstruktory służą do ręcznego tworzenia obiektów ColorSensor ColorSensor , które są niezbędne do konfiguracji czujnika kolorów poza VEXcode.

ColorSensor

ColorSensor tworzy czujnik koloru.

Usage:
color_1 = ColorSensor(smartport)

Parametr	Opis
smartport	Inteligentny port, do którego podłączony jest czujnik koloru, zapisany jako PORTx, gdzie x jest numerem portu.

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