Spalva

Įvadas

Spalvų jutiklis yra optinis jutiklis, leidžiantis jūsų robotui aptikti objektą, atpažinti konkrečias spalvas ir pateikti vaizdinius duomenis, tokius kaip ryškumas ir atspalvis.

Taip pat galite konfigūruoti jutiklio vidinės šviesos ryškumą. Šie įrankiai idealiai tinka programoms, kurios turi reaguoti į spalvotus objektus, apšvietimo sąlygas ar jutiklio grįžtamąjį ryšį realiuoju laiku.

Šiame puslapyje spalvų jutiklio pavadinimo pavyzdys yra color_1 Prireikus pakeiskite jį savo sukonfigūruotu pavadinimu.

Žemiau pateikiamas visų metodų sąrašas:

Veiksmai — Aptikti objektus spalvų jutikliu.

• object_detected — Registruoja funkciją, kuri bus iškviesta aptikus objektą.

Mutatoriai – Modifikuokite spalvų jutiklio šviesas.

• set_light – Įjungia, išjungia spalvų jutiklio šviesos diodą arba nustato nustatytą ryškumo lygį.

• set_light_power — Nustato spalvų jutiklio šviesos diodo ryškumą.

Geteris – grąžina objekto duomenis su spalvų jutikliu.

• is_near_object — Grąžina, ar objektas yra jutiklio diapazone.

• color — Grąžina aptiktos spalvos šešioliktainį kodą.

• brightness — Grąžina aptiktą ryškumą.

• hue – Grąžina aptiktą atspalvio reikšmę.

• installed — Grąžina, ar spalvų jutiklis prijungtas prie smegenų.

Konstruktoriai – rankiniu būdu inicijuokite ir konfigūruokite spalvų jutiklį.

• ColorSensor – Sukuria spalvų jutiklį.

Veiksmai

object_detected

object_detected užregistruoja funkciją, kuri bus iškviesta, kai spalvų jutiklis aptiks objektą.

Usage:
color_1.object_detected(callback, args)

Parametrai	Aprašymas
callback	Anksčiau apibrėžta funkcija, kuri turi būti vykdoma, kai spalvų jutiklis aptinka objektą.
args	Pasirinktinai. Rinkinys su argumentais, kurie turi būti perduoti atgalinio iškvietimo funkcijai. Daugiau informacijos žr. Funkcijos su parametrais.

Mutatoriai

set_light

set_light nustato spalvų jutiklio šviesos diodo ryškumą: įjungtą, išjungtą arba nustatytą ryškumo lygį.

Usage:
color_1.set_light(value, units)

Parametrai	Aprašymas
value	Nurodo, ar įjungti, ar išjungti šviesos diodą, naudojant vieną iš šių parinkčių: LedStateType.ON — Nustato šviesos diodo ryškumą į 100 %. LedStateType.OFF — Nustato šviesos diodo ryškumą į 0 %. Arba šviesos diodo ryškumui nustatyti galima naudoti procentinę reikšmę nuo 0 iki 100. 0 reikšmė išjungia šviesos diodą; bet kokia reikšmė, didesnė nei 0, jį įjungia tokiu ryškumu.
units	Pasirinktinai. Ryškumo reikšmę žymintis vienetas: 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 nustato spalvų jutiklio šviesos diodo ryškumą. Jei šviesos diodas dar neįjungtas, šis metodas jį taip pat įjungs.

Usage:
color_1.set_light_power(value)

Parametrai	Aprašymas
value	Šviesos diodo ryškumas procentais nuo 0 iki 100. 0 reikšmė išjungia šviesos diodą.

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

Getteriai

is_near_object

is_near_object grąžina loginę reikšmę, rodančią, ar spalvų jutiklis yra maždaug 57 milimetrų (2,25 colio) atstumu nuo objekto. Aptikimas priklauso nuo atspindėtos šviesos, todėl tamsūs arba neatspindintys paviršiai gali būti nepatikimai aptikti.

• True – Aptiktas objektas yra maždaug 57 milimetrų atstumu.

• False — Aptiktas objektas yra ne toliau kaip maždaug 57 milimetrų atstumu.

Usage:
color_1.is_near_object()

Parametrai	Aprašymas
	Šis metodas neturi parametrų.

color

color grąžina aptiktos spalvos šešioliktainį kodą kaip eilutę formatu „Spalva“, po kurios seka du nuliai ir spalvos šešioliktainė reikšmė.

Pavyzdžiui, aptikus raudoną spalvą (#FF0000), būtų grąžinta „Spalva 00FF0000“.

Usage:
color_1.color()

Parametrai	Aprašymas
	Šis metodas neturi parametrų.

# 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 grąžina aptiktos spalvos ryškumą sveikuoju skaičiumi nuo 0 % iki 100 %.

Didesnis procentas reiškia, kad spalvų jutiklis aptinka daugiau šviesos. Mažesnis procentas reiškia, kad spalvų jutiklis aptinka mažiau šviesos.

Usage:
color_1.brightness()

Parametrai	Aprašymas
	Šis metodas neturi parametrų.

# 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 grąžina aptiktą atspalvio reikšmę kaip slankiojo skaičiaus reikšmę diapazone nuo 0 iki 359,99 laipsnių.

Atspalvis yra būdas apibūdinti spalvą skaičiais aplink spalvų ratą, kaip parodyta žemiau.

Usage:
color_1.hue()

Parametrai	Aprašymas
	Šis metodas neturi parametrų.

# 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 grąžina loginę reikšmę, nurodančią, ar spalvų jutiklis yra prijungtas prie smegenų.

• True — Spalvų jutiklis prijungtas prie smegenų.

• False — Spalvų jutiklis neprijungtas prie smegenų.

Usage:
color_1.installed()

Parametrai	Aprašymas
	Šis metodas neturi parametrų.

Konstruktoriai

Konstruktoriai naudojami rankiniu būdu sukurti ColorSensor objektus, kurie yra būtini spalvų jutiklio konfigūravimui už VEX kodo ribų.

ColorSensor

ColorSensor sukuria spalvų jutiklį.

Usage:
color_1 = ColorSensor(smartport)

Parametras	Aprašymas
smartport	Išmanusis prievadas, prie kurio prijungtas spalvų jutiklis, rašomas kaip PORTx, kur x yra prievado numeris.

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