Dath#

Réamhrá #

Is braiteoir optúil é an Braiteoir Dathanna a ligeann do do róbat a bhrath nuair a bhíonn réad i láthair, dathanna sonracha a aithint, agus sonraí amhairc amhail gile agus dath a thabhairt ar ais.

Is féidir leat gile sholas inmheánach an braiteora a chumrú freisin. Tá na huirlisí seo oiriúnach do chláir a gcaithfidh freagairt do rudaí daite, dálaí soilsithe, nó aiseolas braiteora i bhfíor-am.

Úsáideann an leathanach seo color_1 mar shampla d’ainm Braiteora Datha. Cuir d’ainm cumraithe féin ina áit de réir mar is gá.

Seo thíos liosta de na modhanna uile:

Gníomhartha — Braith rudaí leis an Braiteoir Datha.

object_detected — Cláraíonn sé feidhm le glaoch uirthi nuair a bhraitear réad.

Mútaitheoirí — Athraigh na soilse ar an Braiteoir Datha.

set_light — Socraíonn sé seo soilse LED an Braiteora Datha go lasadh, múchadh, nó leibhéal gile socraithe.
set_light_power — Socraíonn sé gile LED an Braiteora Datha.

Faighteoirí — Tabhair sonraí réada ar ais leis an Braiteoir Dathanna.

is_near_object — Tugann sé seo le fios an bhfuil réad laistigh de raon an braiteora.
color — Tugann sé seo an cód heicsidheachúlach den dath a braitheadh ar ais.
brightness — Tugann sé seo an gile braite ar ais.
hue — Tugann sé seo luach an datha a braitheadh ar ais.
installed — Tugann sé seo ar ais an bhfuil an Braiteoir Datha ceangailte leis an Inchinn.

Tógálaithe — Braiteoir Datha a thosú agus a chumrú de láimh.

ColorSensor — Cruthaíonn sé Braiteoir Datha.

Gníomhartha #

object_detected #

object_detected feidhm le glaoch uirthi nuair a bhraitheann an Braiteoir Datha réad.

Usage:
color_1.object_detected(callback, args)

Paraiméadair	Cur síos
`callback`	Feidhm [Feidhmeanna] atá sainmhínithe roimhe seo le forghníomhú nuair a bhraitheann an Braiteoir Datha réad.
`args`	Roghnach. Tupla ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Feidhmeanna le Paraiméadair le haghaidh tuilleadh eolais.

Sóiteoirí #

set_light #

set_light socraíonn LED an Braiteora Datha go air, as, nó leibhéal gile socraithe.

Usage:
color_1.set_light(value, units)

Paraiméadair	Cur síos
`value`	Sonraíonn sé seo an ndéanfar an LED a chasadh air nó as trí cheann amháin díobh seo a leanas a úsáid: `LedStateType.ON` — Socraíonn sé gile an LED go 100%. `LedStateType.OFF` — Socraíonn sé gile an LED go 0%. Nó is féidir céatadán ó 0 go 100 a úsáid chun gile an LED a shocrú. Múchann luach 0 an LED; casann aon luach os cionn 0 air é ag an gile sin.
`units`	Roghnach. An t-aonad a léiríonn luach an ghile: `PERCENT`.

Paraiméadair

Cur síos

value

Sonraíonn sé seo an ndéanfar an LED a chasadh air nó as trí cheann amháin díobh seo a leanas a úsáid:

LedStateType.ON — Socraíonn sé gile an LED go 100%.
LedStateType.OFF — Socraíonn sé gile an LED go 0%.

Nó is féidir céatadán ó 0 go 100 a úsáid chun gile an LED a shocrú. Múchann luach 0 an LED; casann aon luach os cionn 0 air é ag an gile sin.

units

Roghnach. An t-aonad a léiríonn luach an ghile: 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 #

Socraíonn set_light_power gile LED an Braiteora Datha. Mura bhfuil an LED lasta cheana féin, cuirfidh an modh seo an LED air freisin.

Usage:
color_1.set_light_power(value)

Paraiméadair	Cur síos
`value`	Gile an LED mar chéatadán ó 0 go 100. Múchann luach 0 an LED.

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

Tugann is_near_object luach Boolean ar ais a léiríonn an bhfuil an Braiteoir Datha laistigh de thart ar 57 milliméadar (2.25 orlach) ó réad. Braitheann an bhrath ar sholas frithchaite, mar sin ní féidir dromchlaí dorcha nó neamh-fhrithchaiteacha a bhrath go hiontaofa.

True — Tá an réad braite laistigh de thart ar 57 milliméadar.
False — Níl an réad braite laistigh de thart ar 57 milliméadar.

Usage:
color_1.is_near_object()

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

color #

color seolann an cód heicsidheachúlach den dath a braitheadh ar ais mar shreang san fhormáid “Dath” agus dhá nialas agus luach heicsidheachúlach an datha ina dhiaidh.

Mar shampla, dá mbraithfí dearg (#FF0000) chuirfí “Dath 00FF0000” ar ais.

Usage:
color_1.color()

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

# 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 #

Tugann gile brightness ar ais cé chomh geal is atá an dath braite, mar shlánuimhir ó 0% go 100%.

Ciallaíonn céatadán níos airde go mbraitheann an Braiteoir Dathanna níos mó solais. Ciallaíonn céatadán níos ísle go mbraitheann an Braiteoir Dathanna níos lú solais.

Usage:
color_1.brightness()

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

# 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 #

Tugann hue an luach datha braite ar ais mar shnámhphointe sa raon ó 0 go 359.99 céim.

Is bealach é lí chun dath a chur síos trí uimhreacha a úsáid timpeall roth datha, mar a thaispeántar thíos.

Roth dathanna ciorclach a thaispeánann speictream iomlán dathanna atá lipéadaithe le luachanna céime timpeall an imlíne, ag méadú i méaduithe 30 céim ó 0° ag an mbarr go 360°.

Usage:
color_1.hue()

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

# 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 seolann sé luach Booleánach ar ais a léiríonn an bhfuil an Braiteoir Dathanna ceangailte leis an Inchinn.

True — Tá an Braiteoir Datha ceangailte leis an Inchinn.
False — Níl an Braiteoir Datha ceangailte leis an Inchinn.

Usage:
color_1.installed()

Paraiméadair	Cur síos
	Níl aon pharaiméadair ag an modh seo.

Tógálaithe #

Úsáidtear tógálaithe chun ColorSensor a chruthú de láimh, atá riachtanach chun Braiteoir Dathanna a chumrú lasmuigh de VEXcode.

ColorSensor #

Cruthaíonn ColorSensor Braiteoir Dathanna.

Usage:
color_1 = ColorSensor(smartport)

Paraiméadar	Cur síos
`smartport`	An Port Cliste a bhfuil an Braiteoir Dathanna ceangailte leis, scríofa mar PORTx áit a seasann x d’uimhir an phoirt.

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