Krāsa

Ievads

Krāsu sensors ir optiskais sensors, kas ļauj robotam noteikt objekta klātbūtni, atpazīt noteiktas krāsas un atgriezt vizuālus datus, piemēram, spilgtumu un nokrāsu.

Varat arī konfigurēt sensora iekšējā apgaismojuma spilgtumu. Šie rīki ir ideāli piemēroti programmām, kurām reāllaikā jāreaģē uz krāsainiem objektiem, apgaismojuma apstākļiem vai sensora atsauksmēm.

Šajā lapā kā krāsu sensora nosaukuma piemērs tiek izmantots color_1 Ja nepieciešams, nomainiet to ar savu konfigurēto nosaukumu.

Zemāk ir visu metožu saraksts:

Darbības — Noteikt objektus ar krāsu sensoru.

• object_detected — Reģistrē funkciju, kas jāizsauc, kad tiek atklāts objekts.

Mutatori — modificējiet krāsu sensora gaismas.

• set_light — Iestata krāsu sensora gaismas diodi uz ieslēgtu, izslēgtu vai iestatītu spilgtuma līmeni.

• set_light_power — Iestata krāsu sensora gaismas diodes spilgtumu.

Ieguvēji — Atgriež objekta datus, izmantojot krāsu sensoru.

• is_near_object — Atgriež, vai objekts atrodas sensora darbības rādiusā.

• color — Atgriež noteiktās krāsas heksadecimālo kodu.

• brightness — Atgriež noteikto spilgtumu.

• hue — Atgriež noteikto nokrāsas vērtību.

• installed — Atgriež, vai krāsu sensors ir pievienots smadzenēm.

Konstruktori — manuāla krāsu sensora inicializācija un konfigurēšana.

• ColorSensor — Izveido krāsu sensoru.

Darbības

object_detected

object_detected reģistrē funkciju, kas tiks izsaukta, kad krāsu sensors nosaka objektu.

Usage:
color_1.object_detected(callback, args)

Parametri	Apraksts
callback	Funkcija, kas iepriekš definēta izpildei, kad krāsu sensors nosaka objektu.
args	Neobligāti. Kortežs, kas satur argumentus, kas jānodod atzvanīšanas funkcijai. Plašāku informāciju skatiet sadaļā Funkcijas ar parametriem.

Mutatori

set_light

set_light ieslēdz, izslēdz krāsu sensora LED vai iestata spilgtuma līmeni.

Usage:
color_1.set_light(value, units)

Parametri	Apraksts
value	Norāda, vai LED ieslēgt vai izslēgt, izmantojot vienu no šīm iespējām: LedStateType.ON — Iestata LED spilgtumu uz 100%. LedStateType.OFF — Iestata LED spilgtumu uz 0%. LED spilgtuma iestatīšanai var izmantot arī procentus no 0 līdz 100. Vērtība 0 izslēdz LED; jebkura vērtība, kas pārsniedz 0, to ieslēdz ar šo spilgtumu.
units	Neobligāti. Mērvienība, kas attēlo spilgtuma vērtību: 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 iestata krāsu sensora gaismas diodes spilgtumu. Ja gaismas diode vēl nav ieslēgta, šī metode to arī ieslēgs.

Usage:
color_1.set_light_power(value)

Parametri	Apraksts
value	Gaismas diodes spilgtums procentos no 0 līdz 100. Vērtība 0 izslēdz gaismas diodi.

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

Getteri

is_near_object

is_near_object atgriež Būla vērtību, kas norāda, vai krāsu sensors atrodas aptuveni 57 milimetru (2,25 collu) attālumā no objekta. Noteikšana ir atkarīga no atstarotās gaismas, tāpēc tumšas vai neatstarojošas virsmas var netikt droši noteiktas.

• True — Noteiktais objekts atrodas aptuveni 57 milimetru attālumā.

• False — Noteiktais objekts neatrodas aptuveni 57 milimetru attālumā.

Usage:
color_1.is_near_object()

Parametri	Apraksts
	Šai metodei nav parametru.

color

color atgriež noteiktās krāsas heksadecimālo kodu kā virkni formātā “Color”, kam seko divas nulles un krāsas heksadecimālā vērtība.

Piemēram, nosakot sarkano krāsu (#FF0000), tiktu atgriezta vērtība “Krāsa 00FF0000”.

Usage:
color_1.color()

Parametri	Apraksts
	Šai metodei nav parametru.

# 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 atgriež noteiktās krāsas spilgtumu kā veselu skaitli no 0% līdz 100%.

Augstāks procentuālais daudzums nozīmē, ka krāsu sensors uztver vairāk gaismas. Zemāks procentuālais daudzums nozīmē, ka krāsu sensors uztver mazāk gaismas.

Usage:
color_1.brightness()

Parametri	Apraksts
	Šai metodei nav parametru.

# 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 atgriež noteikto nokrāsas vērtību kā peldošo skaitli diapazonā no 0 līdz 359,99 grādiem.

Nokrāsa ir veids, kā aprakstīt krāsu, izmantojot skaitļus ap krāsu apli, kā parādīts zemāk.

Usage:
color_1.hue()

Parametri	Apraksts
	Šai metodei nav parametru.

# 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 atgriež Būla vērtību, kas norāda, vai krāsu sensors ir savienots ar smadzenēm.

• True — Krāsu sensors ir savienots ar smadzenēm.

• False — Krāsu sensors nav savienots ar smadzenēm.

Usage:
color_1.installed()

Parametri	Apraksts
	Šai metodei nav parametru.

Konstruktori

Konstruktori tiek izmantoti, lai manuāli izveidotu ColorSensor objektus, kas ir nepieciešami krāsu sensora konfigurēšanai ārpus VEXkoda.

ColorSensor

ColorSensor izveido krāsu sensoru.

Usage:
color_1 = ColorSensor(smartport)

Parametrs	Apraksts
smartport	Viedā pieslēgvieta, kurai ir pievienots krāsu sensors, tiek pierakstīta kā PORTx, kur x ir pieslēgvietas numurs.

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