Súil#

Réamhrá #

Is féidir leis an Braiteoir Súile VEX GO rudaí agus dathanna a bhrath. Is féidir leis tuairisciú freisin ar an méid solais a fhrithchaitheann ar ais chuig an braiteoir agus luach dath an datha a braitheadh.

Tá solas ag an Braiteoir Súile is féidir a chasadh air nó as chun cabhrú leis rudaí agus dathanna a fheiceáil níos soiléire. Is féidir leis an Braiteoir Súile raon NEAR nó FAR a úsáid freisin chun rudaí ag achair éagsúla a bhrath.

Is féidir an Braiteoir Súile a chur i suíomhanna difriúla ag brath ar an tógáil. Mar shampla, tá an Braiteoir Súile os comhair an tógáil Code Base 2.0 - Eye Forward. Tá an Braiteoir Súile os comhair anuas i gcás an tógáil Code Base 2.0 - Eye Down, Code Base 2.0 ‑ Eye + Electromagnet, agus Super Code Base 2.0.

Sna samplaí thíos, tugtar eyear an Braiteoir Súile cumraithe. Úsáidtear an t-ainm seo sna samplaí chun modhanna ranga Eye a ghlaoch.

Tá go leor bealaí ann chun an Braiteoir Súile a chódú. Seo thíos liosta de na modhanna Súile go léir:

Múiteoirí — Coigeartaigh socruithe Braiteora Súile.

set_light — Casann sé solas an Braiteora Súile air nó as.
set_range — Socraíonn sé cé chomh fada is féidir leis an Braiteoir Súile réad a bhrath.
set_light_power — Socraíonn sé leibhéal cumhachta solais an Braiteora Súile.

Faighteoirí — Tabhair ar ais an rud a bhraitheann an Braiteoir Súile.

get_color — Tugann sé seo an dath a bhraith an Braiteoir Súile ar ais.
get_hue — Tugann sé seo an dath a bhraith an Braiteoir Súile ar ais.
get_brightness — Tugann sé seo an gile a bhraith an Braiteoir Súile ar ais.
is_object_detected — Tugann sé seo ar ais an mbraitheann an Braiteoir Súile réad laistigh den raon.
is_color_detected — Tugann sé seo ar ais an mbraitheann an Braiteoir Súile dath ar leith.

Sóiteoirí #

set_light #

set_light Casann solas an Braiteora Súile air nó as.

Usage:
eye.set_light(state)

Paraiméadair	Cur síos
`state`	Staid sholas an Braiteora Súile: `ON` nó `OFF`.

# Build Used: Super Code Base 2.0
def main():
    # Turn the light on and off
    while True:
        eye.set_light(ON)
        wait(2, SECONDS)
        eye.set_light(OFF)
        wait(2, SECONDS)

# Start threads — Do not delete
start_thread(main)

set_range #

set_range socraíonn sé cé chomh fada is féidir le réad a bheith ón Braiteoir Súile sula bhféadfar é a bhrath.

Tosaíonn gach tionscadal leis an Braiteoir Súile socraithe go raon FAR de réir réamhshocraithe.

Usage:
eye.set_range(distance)

Paraiméadair	Cur síos
`distance`	Raon braite réad an Braiteora Súile. `NEAR` a bhraitheann réada suas le 18 milliméadar ar shiúl, agus `FAR` a bhraitheann réada suas le 40 milliméadar ar shiúl.

# Build Used: Code Base 2.0 - Eye Forward
def main():
    # Drive to an object with different ranges
    eye.set_range(FAR)
    drivetrain.drive(FORWARD)
    wait(0.2, SECONDS)
    while not eye.is_object_detected():
        wait(0.2, SECONDS)
    drivetrain.drive_for(REVERSE, 100, MM)
    # Closer detection range
    eye.set_range(NEAR)
    drivetrain.drive(FORWARD)
    wait(0.2, SECONDS)
    while not eye.is_object_detected():
        wait(0.2, SECONDS)
    drivetrain.stop()


# Start threads — Do not delete
start_thread(main)

set_light_power #

set_light_power cé chomh geal is atá solas an Braiteora Súile. Is féidir leis an solas cabhrú leis an Braiteoir Súile rudaí agus dathanna a bhrath níos soiléire.

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.

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

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

Usage:
eye.set_light_power(value)

Paraiméadair	Cur síos
`value`	An gile ar cheart solas an Braiteora Súile a shocrú di, ó 0% go 100%. Úsáid uimhreacha slána.

# Build Used: Super Code Base 2.0
def main():
    # Turn on the light at different brightnesses
    eye.set_light_power(25)
    wait(2, SECONDS)
    eye.set_light_power(50)
    wait(2, SECONDS)
    eye.set_light_power(100)

# Start threads — Do not delete
start_thread(main)

Faighteoirí #

get_color #

get_color tugann sé an dath a bhraith an Braiteoir Súile ar ais.

Is féidir leis an modh seo a thabhairt ar ais:

RED — Luach datha idir 340° - 20°
GREEN — Luach datha idir 75° - 154°
BLUE — Luach datha idir 160° - 254°
NONE — Ní bhraitear aon cheann de na dathanna atá ar fáil.

Usage:
eye.get_color()

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

# Build Used: Super Code Base 2.0
def main():
    # Stop when red is detected
    drivetrain.drive(FORWARD)
    while True:
        if eye.get_color() == RED:
            break
        wait(0.2, SECONDS)
    drivetrain.stop()

# Start threads — Do not delete
start_thread(main)

get_hue #

get_hue tugann sé an dath a bhraith an Braiteoir Súile ar ais mar uimhir iomlán ó 0 go 359.00 céim.

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

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:
eye.get_hue()

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

# Build Used: Code Base 2.0 - Eye Forward
def main():
    # Display the hue of a pink GO piece
    while True:
        console.clear()
        if 10 < eye.get_hue() < 40:
            console.print("Pink!")
            wait(0.1,SECONDS)
        else:
            console.print("Not pink.")
            wait(0.1,SECONDS)

# Start threads — Do not delete
start_thread(main)

get_brightness #

Tugann get_brightness ar ais cé chomh geal is atá an solas braite, mar uimhir iomlán ó 0% go 100%.

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

Usage:
eye.get_brightness()

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

# Build Used: Super Code Base 2.0
def main():
    # Monitor the brightness until red is detected
    monitor_sensor("eye.get_brightness")
    drivetrain.drive(FORWARD)
    while not eye.get_color() == RED:
        wait(0.2, SECONDS)
    drivetrain.stop()

# Start threads — Do not delete
start_thread(main)

is_object_detected #

is_object_detected tugann sé Boolean ar ais a thuairiscíonn an bhfuil nó nach bhfuil an Braiteoir Súile ag brath réad laistigh den raon.

True — Braitheann an Braiteoir Súile réad.
False — Ní bhraitheann an Braiteoir Súile réad.

Is féidir an raon braite a athrú ag baint úsáide as set_range.

Usage:
eye.is_object_detected()

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

# Build Used: Code Base 2.0 - Eye Forward
def main():
    # Drive forward until an object is detected
    drivetrain.drive(FORWARD)
    wait(0.2, SECONDS)
    while not eye.is_object_detected():
        wait(0.5, SECONDS)
    drivetrain.stop()

# Start threads — Do not delete
start_thread(main)

is_color_detected #

is_color_detected Boolean ar ais a thuairiscíonn an mbraitheann an Braiteoir Súile dath sonraithe, bunaithe ar an luach datha a braitheadh.

True — Braitheann an Braiteoir Súile an dath roghnaithe.
False — Ní bhraitheann an Braiteoir Súile an dath roghnaithe.

Oibríonn an Braiteoir Súile is fearr nuair a bhíonn an réad gar go leor le braiteadh agus nuair a bhíonn an soilsiú soiléir.

Usage:
eye.is_color_detected(color)

Paraiméadair	Cur síos
`color`	An dath atá le seiceáil ag an Braiteoir Súile: `BLUE` – Luach datha idir 160° agus 254°. `GREEN` – Luach datha idir 75° agus 154°. `NONE` `RED` – Luach datha idir 340° agus 20°.

Paraiméadair

Cur síos

color

An dath atá le seiceáil ag an Braiteoir Súile:

BLUE – Luach datha idir 160° agus 254°.
GREEN – Luach datha idir 75° agus 154°.
NONE
RED – Luach datha idir 340° agus 20°.

# Build Used: Super Code Base 2.0
def main():
    # Drive forward until a green object is detected
    drivetrain.drive(FORWARD)
    wait(0.2, SECONDS)
    while not eye.is_color_detected(GREEN):
        wait(0.5, SECONDS)
    drivetrain.stop()

# Start threads — Do not delete
start_thread(main)