Väri

Johdanto

Värianturi on optinen anturi, jonka avulla robottisi voi havaita kohteen läsnäolon, tunnistaa tiettyjä värejä ja palauttaa visuaalisia tietoja, kuten kirkkautta ja sävyä.

Voit myös määrittää anturin sisäisen valon kirkkautta. Nämä työkalut sopivat ihanteellisesti ohjelmiin, joiden on reagoitava värillisiin esineisiin, valaistusolosuhteisiin tai anturin palautteeseen reaaliajassa.

Tällä sivulla käytetään esimerkkinä värianturin nimeä color_1 Korvaa se tarvittaessa omalla määritetyllä nimelläsi.

Alla on luettelo kaikista menetelmistä:

Toiminnot — Tunnista esineitä värianturilla.

• object_detected — Rekisteröi funktion kutsuttavaksi, kun objekti havaitaan.

Mutaattorit — Muokkaa värisensorin valoja.

• set_light — Asettaa värianturin LED-valon päälle, pois päältä tai asettaa kirkkaustason.

• set_light_power — Asettaa värianturin LED-valon kirkkautta.

Getterit — Palauttavat objektidataa värianturilla.

• is_near_object — Palauttaa, onko kohde anturin kantaman sisällä.

• color — Palauttaa havaitun värin heksakoodin.

• brightness — Palauttaa havaitun kirkkauden.

• hue — Palauttaa havaitun sävyn arvon.

• installed — Palauttaa, onko värianturi kytketty aivoihin.

Konstruktorit — Värianturin manuaalinen alustaminen ja konfigurointi.

• ColorSensor — Luo värianturin.

Toiminnot

object_detected

object_detected rekisteröi funktion kutsuttavaksi, kun värianturi havaitsee objektin.

Usage:
color_1.object_detected(callback, args)

Parametrit	Kuvaus
callback	Funktio, joka on aiemmin määritelty suoritettavaksi, kun värianturi havaitsee kohteen.
args	Valinnainen. Tuple, joka sisältää argumentteja, jotka välitetään takaisinkutsufunktiolle. Lisätietoja on kohdassa Funktiot parametreilla.

Mutaattorit

set_light

set_light asettaa värianturin LEDin päälle, pois päältä tai asetetulle kirkkaustasolle.

Usage:
color_1.set_light(value, units)

Parametrit	Kuvaus
value	Määrittää, kytketäänkö LED päälle vai pois päältä, käyttämällä jotakin seuraavista: LedStateType.ON — Asettaa LEDin kirkkaudeksi 100 %. LedStateType.OFF — Asettaa LEDin kirkkaudeksi 0 %. Vaihtoehtoisesti LEDin kirkkautta voidaan asettaa prosenttiluvulla 0–100. Arvo 0 sammuttaa LEDin; mikä tahansa arvo yli 0:n kytkee sen päälle kyseisellä kirkkaudella.
units	Valinnainen. Kirkkausarvoa edustava yksikkö: 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 asettaa värianturin LEDin kirkkautta. Jos LED ei ole jo päällä, tämä menetelmä sytyttää myös LEDin.

Usage:
color_1.set_light_power(value)

Parametrit	Kuvaus
value	LEDin kirkkaus prosentteina välillä 0 - 100. Arvo 0 sammuttaa LEDin.

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

Getterit

is_near_object

is_near_object palauttaa totuusarvon, joka ilmaisee, onko värianturi noin 57 millimetrin (2,25 tuuman) etäisyydellä kohteesta. Havaitseminen riippuu heijastuneesta valosta, joten tummia tai heijastamattomia pintoja ei välttämättä havaita luotettavasti.

• True — Havaittu kohde on noin 57 millimetrin etäisyydellä.

• False — Havaittu kohde ei ole noin 57 millimetrin etäisyydellä.

Usage:
color_1.is_near_object()

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

color

color palauttaa havaitun värin heksakoodin merkkijonona muodossa “Color”, jota seuraa kaksi nollaa ja värin heksadesimaaliarvo.

Esimerkiksi punaisen (#FF0000) havaitseminen palauttaisi arvon “Väri 00FF0000”.

Usage:
color_1.color()

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

# 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 palauttaa havaitun värin kirkkauden kokonaislukuna väliltä 0–100 %.

Korkeampi prosenttiosuus tarkoittaa, että värianturi havaitsee enemmän valoa. Matalampi prosenttiosuus tarkoittaa, että värianturi havaitsee vähemmän valoa.

Usage:
color_1.brightness()

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

# 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 palauttaa havaitun sävyn arvon liukulukuna välillä 0–359,99 astetta.

Sävy on tapa kuvata väriä käyttämällä numeroita väriympyrän ympärillä, kuten alla on esitetty.

Usage:
color_1.hue()

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

# 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 palauttaa totuusarvon, joka ilmaisee, onko värianturi kytketty aivoihin.

• True — Värianturi on kytketty aivoihin.

• False — Värianturi ei ole yhteydessä aivoihin.

Usage:
color_1.installed()

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

Rakentajat

Konstruktoreita käytetään ColorSensor -objektien luomiseen manuaalisesti, jotka ovat välttämättömiä värianturin konfiguroimiseksi VEXcoden ulkopuolella.

ColorSensor

ColorSensor luo värianturin.

Usage:
color_1 = ColorSensor(smartport)

Parametri	Kuvaus
smartport	Värianturin kytkennän sisältävä älyportti, joka kirjoitetaan muodossa PORTx, jossa x on portin numero.

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