Braiteoir Optúil#

Réamhrá #

Braitheann an Braiteoir Optúil EXP dath, gile agus láithreacht rudaí in aice láimhe trí úsáid a bhaint as meascán de braiteoir datha RGB agus braiteoir gaireachta. Is féidir leis a soilse LED ionsuite a úsáid freisin chun rudaí a shoilsiú le haghaidh braite níos cruinne.

An Braiteoir Optúil VEX EXP.

Úsáideann an leathanach seo optical_sensor mar ainm samplach don Braiteoir Optúil. Cuir d’ainm cumraithe féin ina áit de réir mar is gá.

Seo thíos liosta de na modhanna atá ar fáil:

set_light – Casann sé LED an Braiteora Optúil air nó as.
set_light_power – Socraíonn sé leibhéal cumhachta solais an Braiteora Optúil.
is_near_object – Tugann sé seo ar ais an mbraitheann an Braiteoir Optúil réad laistigh den raon.
color – Tugann sé seo an dath a bhraith an Braiteoir Optúil ar ais.
brightness – Tugann sé seo ar ais an méid solais a léirítear ón réad.
hue – Tugann sé seo an dath a bhraith an Braiteoir Optúil ar ais.
object_detected – Cláraíonn sé feidhm le glaoch uirthi nuair a bhraitheann an Braiteoir Optúil réad.
object_lost – Cláraíonn sé feidhm le glaoch uirthi nuair a chailleann an Braiteoir Optúil réad.

Tógálaí – Braiteoir Optúil a thosú de láimh.

Optical – Cruthaíonn sé Braiteoir Optúil.

socraigh_solas #

set_light Casann LED an Braiteora Optúil air nó as. Is féidir leis seo cabhrú le cruinneas an braiteora a mhéadú agus dathanna á mbrath.

Usage:
optical_sensor.set_light(state)

Paraiméadair	Cur síos
stát	Socraíonn sé an LED air nó as. `LEDStateType.ON` Casann sé an solas air ag 100% gile. `LEDStateType.OFF` Casann sé as é.

# Turn on the sensor's LED
optical_sensor.set_light(LEDStateType.ON)

socraigh_cumhacht_sholais #

Socraíonn set_light_power gile LED an Braiteora Optúil. Is féidir leis an solas cabhrú leis an Braiteoir Optúil rudaí agus dathanna a bhrath níos soiléire.

Mura bhfuil solas an Braiteora Optúil múchta, lasfar an solas má shocraítear cumhacht an tsolais os cionn 0%.

Má tá solas an Braiteora Optúil lasta, múchfar an solas má shocraítear cumhacht an tsolais ag 0%.

Déanann céatadán níos airde an solas níos gile. Déanann céatadán níos ísle an solas níos laige.

Usage:
optical_sensor.set_light_power(percent, units)

Paraiméadair	Cur síos
céatadán	An gile le socrú an LED mar uimhir iomlán.
aonaid	Roghnach. An t-aonad chun an gile a léiriú: `PERCENT`

# Turn on the sensor's light at half brightness
optical_sensor.set_light_power(50, PERCENT)

is_gar_don_réad #

is_near_object tugann sé luach Booleach ar ais a léiríonn an bhfuil nó nach bhfuil an Braiteoir Optúil ag brath réad laistigh den raon.

True – Braitheann an Braiteoir Optúil réad.
False – Ní bhraitheann an Braiteoir Optúil réad.

Usage:
optical_sensor.is_near_object()

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

# Drive forward until an object is found
drivetrain.drive(FORWARD)
while not optical_sensor.is_near_object():
  pass
drivetrain.stop()

dath #

Tugann color sampla de Color rang ar ais, bunaithe ar an luach datha a braitheadh. Is féidir iad seo a chur i gcomparáid le réada Color réamhshainithe chun ráitis choinníollacha a chruthú.

Is iad na dathanna féideartha ná:

Color.BLACK
Color.WHITE
Color.RED - Luach datha idir 340° - 20°
Color.GREEN - Luach datha idir 80° - 140°
Color.BLUE - Luach datha idir 200° - 240°
Color.YELLOW - Luach datha idir 40° - 60°
Color.ORANGE - Luach datha idir 20° - 40°
Color.PURPLE - Luach datha idir 240° - 280°
Color.CYAN - Luach datha idir 140° - 200°

Nóta: Tá an Braiteoir Optúil ag lorg raonta datha a mheaitseálann an dath sonraithe. Chun raonta datha sonracha a bhrath, féach hue.

Usage:
optical_sensor.color()

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

# Drive forward until red is found
drivetrain.drive(FORWARD)
while not optical_sensor.color() == Color.RED:
  pass
drivetrain.stop()

gile #

Tugann brightness an méid solais a léirítear ón réad ar ais mar dheachúil (float) a léiríonn céatadán.

Ciallaíonn céatadán níos airde go léirítear níos mó solais ar ais chuig an Braiteoir Optúil. Ciallaíonn céatadán níos ísle go léirítear níos lú solais ar ais.

Usage:
optical_sensor.brightness()

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

dath #

Tugann hue luach hue an datha braite ar ais mar dheachúil (float) ó 0 go 359.

Is bealach é lí chun dath a chur síos trí uimhreacha a úsáid timpeall ar roth datha.

An Roth Dathanna VEX a thaispeánann céimeanna na ndathanna timpeall ciorcail, le dearg ag 0 céim agus ag aistriú tríd an tuar ceatha de réir mar a mhéadaíonn an luach.

Usage: optical_sensor.hue()

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

# Look for the color pink using hue
while True:
  brain.screen.clear_screen()
  brain.screen.set_cursor(1, 1)

  if 300 < optical_sensor.hue() < 359:
    brain.screen.print("This is pink!")
  else:
    brain.screen.print("No pink detected!")

réad_braite #

object_detected feidhm le glaoch uirthi aon uair a bhraitheann an Braiteoir Optúil réad nua.

Usage:
optical_sensor.object_detected(callback, arg)

Paraiméadair	Cur síos
`callback`	Feidhm shainithe a fhorghníomhaítear nuair a bhraitheann an Braiteoir Optúil réad nua.
`arg`	Roghnach. Tuple ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Úsáid Feidhmeanna le Paraiméadair le haghaidh tuilleadh eolais.

def my_function():
  brain.screen.print("Optical Sensor detected an object")

# Call my_function whenever optical_sensor detects an object
optical_sensor.object_detected(my_function)

réad_caillte #

object_lost feidhm le glaoch uirthi aon uair a chailleann an Braiteoir Optúil réad braite.

Usage:
optical_sensor.object_lost(callback, arg)

Paraiméadair	Cur síos
`callback`	Feidhm shainithe a fhorghníomhaítear nuair a chailleann an Braiteoir Optúil réad braite.
`arg`	Roghnach. Tuple ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Úsáid Feidhmeanna le Paraiméadair le haghaidh tuilleadh eolais.

def my_function():
  brain.screen.print("Optical Sensor lost an object")

# Call my_function whenever optical_sensor loses an object
optical_sensor.object_lost(my_function)

Tógálaí #

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

Optical #

Cruthaíonn Optical Braiteoir Optúil.

Usage:
Optical(smartport)

Paraiméadar	Cur síos
`smartport`	An Port Cliste a bhfuil an Braiteoir Optúil ceangailte leis, scríofa mar `Ports.PORTx` áit a seasann x do uimhir an phoirt.

# Create an Optical Sensor in Port 10
optical_sensor = Optical(Ports.PORT10)