Scáileán

Réamhrá

Rialaíonn na modhanna Scáileáin an chaoi a léiríonn an Róbó Códaithe VEX AIM téacs, uimhreacha agus grafaicí ar a scáileán, agus an chaoi a bhfreagraíonn sé do bhrúnna scáileáin.

Seo thíos liosta de na modhanna uile:

Tadhall – Braith brúnna scáileáin agus freagair dóibh.

• pressing – Tugann sé seo le fios an bhfuil an scáileán á bhrú faoi láthair.

• x_position – Tugann sé seo comhordanáid-x an bhrú scáileáin dheireanaigh ar ais.

• y_position – Tugann sé seo comhordanáid y an bhrú scáileáin dheireanaigh ar ais.

Priontáil Cúrsóra – Taispeáin téacs ag baint úsáide as córas sraitheanna/colún.

• print – Priontálann sé téacs, uimhreacha, nó luachanna athróg ag suíomh reatha an chúrsóra.

• set_cursor – Bogann sé an cúrsóir go dtí sraith agus colún ar leith.

• next_row – Bogann sé an cúrsóir go colún 1 den chéad ró eile.

• clear_row – Glanann sé sraith téacs.

• get_row – Tugann sé seo an ró cúrsóra reatha ar ais.

• get_column – Tugann sé seo an colún cúrsóra reatha ar ais.

Priontáil XY – Taispeáin téacs ag comhordanáid scáileáin shonrach.

• print_at – Priontálann sé téacs, uimhreacha, nó luachanna athróg ag comhordanáid x agus y shonrach.

• set_origin – Socraíonn sé an bunús a úsáidtear le haghaidh priontála agus líníochta bunaithe ar chomhordanáidí.

Múiteoirí – Glan an scáileán nó nuashonraigh socruithe amhairc.

• clear_screen – Glanann sé seo an scáileán de na líníochtaí agus an téacs go léir.

• set_font – Socraíonn sé seo an cló don téacs clóite.

• set_pen_width – Socraíonn sé tiús na línte tarraingthe agus imlínte na gcruthanna.

• set_pen_color – Socraíonn sé dath an téacs, na bpicteilíní, na línte, agus imlínte an chrutha.

• set_fill_color – Socraíonn sé seo an dath líonta do chruthanna tarraingthe agus do chúlraí téacs clóite.

Tarraing – Cuir grafaicí agus íomhánna leis an scáileán.

• draw_pixel – Tarraingíonn sé picteilín ag suíomh x agus y ar leith.

• draw_line – Tarraingíonn líne idir dhá phointe.

• draw_rectangle – Tarraingíonn sé dronuilleog.

• draw_circle – Tarraingíonn sé ciorcal.

• show_file – Taispeánann sé íomhá uaslódáilte.

• set_clip_region – Cuireann sé srian ar an áit ar féidir líníochtaí agus téacs a bheith le feiceáil.

Glaonna Ar Ais – Feidhmeanna a rith nuair a bhrúitear nó a scaoiltear an scáileán.

• pressed – Cláraíonn sé feidhm le glaoch nuair a bhrúitear an scáileán.

• released – Cláraíonn feidhm le glaoch nuair a scaoiltear an scáileán.

Teagmháil

pressing

Má bhrúnn tú pressing , tugann tú luach Booleach ar ais a léiríonn an bhfuil scáileán an róbait á bhrú faoi láthair.

• True – Tá an scáileán á bhrú.

• False – Níl an scáileán á bhrú.

Usage:
robot.screen.pressing()

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

# Turn LEDs white only while the screen is pressed.
while True:
    if robot.screen.pressing():
        robot.led.on(ALL_LEDS, WHITE)
    else:
        robot.led.off(ALL_LEDS)

    wait(50, MSEC)

# Display different messages after the screen is pressed
while not robot.screen.pressing():
    wait(5, MSEC)
robot.screen.print("First message!")
robot.screen.next_row()
# Lift finger to press the screen again
while robot.screen.pressing():
    wait(5, MSEC)
while not robot.screen.pressing():
    wait(5, MSEC)
robot.screen.print("Second message!")
robot.screen.next_row()

x_position

Tugann x_position comhordanáid-x an bhrú scáileáin dheireanaigh ar ais mar shlánuimhir ó 0 (ar chlé) go 240 (ar dheis).

Usage:
robot.screen.x_position()

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

# Display the x-coordinate of where
# the screen is pressed
while True:
    if robot.screen.pressing():
        robot.screen.clear_screen()
        robot.screen.print(robot.screen.x_position())
    wait (50, MSEC)

y_position

Tugann y_position comhordanáid-y na brúigh scáileáin dheireanaí ar ais mar shlánuimhir ó 0 (barr) go 240 (bun).

Usage:
robot.screen.y_position()

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

# Display the y-coordinate of where
# the screen is pressed
while True:
    if robot.screen.pressing():
        robot.screen.clear_screen()
        robot.screen.print(robot.screen.y_position())
    wait (50, MSEC)

Priontáil Cúrsóra

print

print priontáileann téacs, uimhreacha, nó luachanna athrógacha ar scáileán an róbait ag an suíomh cúrsóra agus an cló reatha.

Usage:
robot.screen.print(text)

Paraiméadair	Cur síos
text	An téacs, an uimhir, nó an luach athrógach le taispeáint ar an scáileán.

# Display a message at the starting cursor position
robot.screen.print("Hello, Robot!")

set_cursor

Bogann set_cursor an cúrsóir téacs go sraith agus colún ar leith ar scáileán an róbait. Tosóidh an chéad ghlao print eile ag priontáil ag an suíomh sin. Braitheann líon na sraitheanna agus na gcolún a oireann ar an gcló roghnaithe. Leis an gcló meánach aonspásáilte réamhshocraithe, is féidir leis an scáileán suas le 8 sraith agus 13 cholún a thaispeáint go soiléir. D’fhéadfadh téacs a chuirtear lasmuigh den raon seo a bheith gearrtha amach nó níos deacra a léamh.

Bíonn carachtair i gclónna aonspáisithe atá ar an leithead céanna, rud a fhágann go mbíonn socrú an téacs comhsheasmhach. I gcodarsnacht leis sin, bíonn leithead na gcarachtar éagsúil i gclónna comhréireacha, mar sin tógann roinnt litreacha níos mó spáis ná a chéile. Mar sin féin, is cuma cén cineál a úsáidtear, socraíonn set_cursor an cúrsóir bunaithe ar mhéid na sraithe agus na gcolún, ní ar stíl an chló. Is féidir méid an chló a choigeartú ag baint úsáide as set_font.

Usage:
robot.screen.set_cursor(row, column)

Paraiméadair	Cur síos
row	An tsraith le bogadh an cúrsóir chuici.
column	An colún le bogadh an cúrsóir chuige.

# Display text starting at Row 3 Column 2
robot.screen.set_cursor(3, 2)
robot.screen.print("Row 3, Column 2")

next_row

next_row bogann an cúrsóir go colún 1 ar an gcéad ró eile ar scáileán an róbait.

Usage:
robot.screen.next_row()

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

# Display two lines of text
robot.screen.print("Line 1")
robot.screen.next_row()
robot.screen.print("Line 2")

clear_row

clear_row glanann sé sraith amháin téacs ar scáileán an róbait.

Usage:
robot.screen.clear_row(row, color)

Paraiméadar	Cur síos
row	Roghnach. An tsraith le glanadh mar shlánuimhir. Is é an tsraith cúrsóra reatha an réamhshocrú.
color	Roghnach. An dath le cur i bhfeidhm ar an ró glanta. Áirítear leis na roghanna: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Is féidir leat dath saincheaptha a shonrú freisin.

# Display text on two rows
robot.screen.print("This text stays")
robot.screen.next_row()
robot.screen.print("This text disappears")

# Wait 3 seconds before clearing only the second row
wait(3, SECONDS)
robot.screen.clear_row()

# Turn the 5th row green
robot.screen.clear_row(5, GREEN)

get_row

get_row an tsraith reatha ar ais ina gclófar téacs mar shlánuimhir.

Usage:
robot.screen.get_row()

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

# Set cursor to (3,2) and print row number
robot.screen.set_cursor(3, 2)
robot.screen.print(robot.screen.get_row())

get_column

get_column an colún reatha ar ais ina gclófar téacs mar shlánuimhir.

Usage:
robot.screen.get_column()

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

# Set cursor to (3,2) and print column number
robot.screen.set_cursor(3, 2)
robot.screen.print(robot.screen.get_column())

Priontáil XY

print_at

Priontálann print_at téacs, uimhreacha, nó luachanna athraitheacha ar scáileán an róbait ag comhordanáid x agus y shonrach i bpicteilíní, ag baint úsáide as an font agus an origin atá socraithe faoi láthair. Socraíonn x cé chomh fada ón taobh clé a thosaíonn an téacs, agus socraíonn y cá bhfuil bun na litreacha suite. Ní thugann an modh seo aird ar shuíomh reatha an chúrsóra.

Nóta: Taispeánann an ciorcal dearg cé na comhordanáidí a bheidh le feiceáil ar scáileán ciorclach róbat AIM. Bíonn comhordanáidí lasmuigh den chiorcal dearg laistigh den raon 0–240 ach ní bheidh siad le feiceáil ar an scáileán.

Usage:
robot.screen.print_at(text, x, y)

Paraiméadar	Cur síos
text	An téacs, an uimhir, nó an luach athrógach le priontáil ar an scáileán.
x	Suíomh cothrománach an téacs, mar shlánuimhir ó 0 go 240 picteilín. Is é 0 an chlé; is é 240 an deas.
y	Suíomh ingearach an téacs, mar shlánuimhir ó 0 go 240 picteilín. Is é 0 an barr; is é 240 an bun.

# Display a message in the middle of the screen
robot.screen.print_at("Hello, Robot!", x=40, y=120)

set_origin

Socraíonn set_origin an bunús a úsáidtear le haghaidh líníochta agus priontáil bunaithe ar chomhordanáidí ar scáileán an róbait. De réir réamhshocraithe, is é an bunús cúinne uachtarach na láimhe clé den scáileán.

Usage:
robot.screen.set_origin(x, y)

Paraiméadar	Cur síos
x	An comhordanáid x nua le socrú mar an mbunphointe, tugtha mar shlánuimhir ó 0 go 240.
y	An comhordanáid y nua le socrú mar an mbunphointe, tugtha mar shlánuimhir ó 0 go 240.

# Set the origin to the center of the screen
robot.screen.set_origin(120, 120)

# Draw a rectangle at the new origin
robot.screen.draw_rectangle(0, 0, 80, 40)

Sóiteoirí

clear_screen

Glanann clear_screen na líníochtaí agus an téacs go léir ó scáileán an róbait. De réir réamhshocraithe, athshocraíonn sé suíomh an chúrsóra go dtí ró 1, colún 1 freisin.

Usage:
robot.screen.clear_screen(color)

Paraiméadar	Cur síos
color	Roghnach. Socraíonn sé dath an scáileáin. Áirítear leis na roghanna: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a circle, and clear it after 2 seconds
robot.screen.draw_circle(120, 120, 60)
wait(2, SECONDS)
robot.screen.clear_screen()

# Set the background color of the screen to red
robot.screen.clear_screen(RED)

set_font

Socraíonn set_font an cló a úsáidtear chun téacs a thaispeáint ar scáileán an róbait. Bainfidh an cló seo le gach téacs a phriontáiltear le print nó print_at. Is é MONO24 an cló réamhshocraithe ag tús tionscadail.

Usage:
robot.screen.set_font(fontname)

Paraiméadar	Cur síos
fontname	Socraíonn sé seo an cló go ceann amháin díobh seo a leanas: MONO12 MONO15 MONO20 MONO24 MONO30 MONO40 MONO60 PROP20 PROP30 PROP40 PROP60 Taispeántar na roghanna seo thíos.

MONO12	MONO15	MONO20
MONO24	MONO30	MONO40
MONO60	PROP20	PROP30
PROP40	PROP60

# Display text using a larger font
robot.screen.set_font(MONO40)
robot.screen.print("VEX")

set_pen_width

Socraíonn set_pen_width tiús na línte tarraingthe agus imlínte na gcruthanna.

Usage:
robot.screen.set_pen_width(width)

Paraiméadar	Cur síos
width	Leithead an pheann, i bpicteilíní, ó 0 go 32.

# Draw a rectangle with a pen width of 10
robot.screen.set_pen_width(10)
robot.screen.draw_rectangle(50, 50, 130, 60)

set_pen_color

set_pen_color socraíonn dath an téacs, na bpicteilíní, na línte, agus imlínte na gcruthanna.

Usage:
robot.screen.set_pen_color(color)

Paraiméadar	Cur síos
color	Roghnach. An dath peann agus cló le húsáid. Áirítear leis na roghanna: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a rectangle with a red pen
robot.screen.set_pen_color(RED)
robot.screen.draw_rectangle(50, 50, 130, 60)

set_fill_color

set_fill_color socraíonn an dath líonta a úsáidtear nuair a tharraingítear cruthanna agus nuair a úsáideann téacs clóite cúlra.

Usage:
robot.screen.set_fill_color(color)

Paraiméadar	Cur síos
color	Roghnach. An dath líonta le húsáid. Áirítear leis na roghanna: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Is féidir leat dath saincheaptha a shonrú freisin.

# Draw two orange rectangles
robot.screen.set_fill_color(ORANGE)
robot.screen.draw_rectangle(50, 50, 100, 60)
robot.screen.draw_rectangle(50, 130, 100, 60)

# Display text with a purple background
robot.screen.set_fill_color(PURPLE)
robot.screen.print("Highlight")

Tarraing

draw_pixel

Tarraingíonn draw_pixel picteilín amháin ag an gcomhordanáid x agus y roghnaithe ag baint úsáide as an dath peann reatha.

Usage:
robot.screen.draw_pixel(x, y)

Paraiméadar	Cur síos
x	An comhordanáid-x ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 240.
y	An comhordanáid y ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 240.

# Draw a pixel at the center of the screen
robot.screen.draw_pixel(120, 120)

draw_line

draw_line tarraingíonn líne ón gcéad chomhordanáid scáileáin (x1, y1) go dtí an dara comhordanáid scáileáin (x2, y2) ag baint úsáide as an leithead peann agus an dath peann reatha.

Úsáideann na comhordanáidí x agus y an bunús réamhshocraithe (0, 0) mura bhfuil bunús difriúil socraithe ag baint úsáide as set_origin.

Usage:
robot.screen.draw_line(x1, y1, x2, y2)

Paraiméadar	Cur síos
x1	Comhordanáid x tosaigh na líne, tugtha mar shlánuimhir ó 0 go 240.
y1	Comhordanáid y tosaigh na líne, tugtha mar shlánuimhir ó 0 go 240.
x2	Comhordanáid x deiridh na líne, tugtha mar shlánuimhir ó 0 go 240.
y2	Comhordanáid y deiridh na líne, tugtha mar shlánuimhir ó 0 go 240.

# Draw a line from the top left to bottom right of the screen
robot.screen.draw_line(0, 0, 240, 240)

draw_rectangle

Tarraingíonn draw_rectangle dronuilleog agus a chúinne uachtarach ar chlé ag an gcomhordanáid (x, y) roghnaithe agus méid a chinntear ag an leithead agus an airde tugtha, agus iad uile tomhaiste i bpicteilíní. Tarraingítear imlíne na dronuilleoige ag baint úsáide as an leithead peann agus an dath peann reatha. Líontar an taobh istigh leis an dath líonta reatha, mura n-úsáidtear an paraiméadar roghnach color.

Úsáideann na comhordanáidí x agus y an bunús réamhshocraithe (0, 0) mura bhfuil bunús difriúil socraithe ag baint úsáide as set_origin.

Usage:
robot.screen.draw_rectangle(x, y, width, height, color)

Paraiméadar	Cur síos
x	Comhordanáid-x chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 240.
y	Comhordanáid y chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 240.
width	Leithead na dronuilleoige, tugtha mar shlánuimhir ó 0 go 240.
height	Airde na dronuilleoige, tugtha mar shlánuimhir ó 0 go 240.
color	Roghnach. Dath líonta an dronuilleoige. Áirítear leis na roghanna: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a red rectangle on the screen
robot.screen.draw_rectangle(50, 50, 130, 60, RED)

draw_circle

Tarraingíonn draw_circle ciorcal agus a lár ag an gcomhordanáid (x, y) roghnaithe agus méid a chinntear ag an nga tugtha, agus tomhaistear iad go léir i bpicteilíní. Tarraingítear imlíne an chiorcail ag baint úsáide as an leithead peann agus an dath peann reatha. Líontar an taobh istigh leis an dath líonta reatha, mura n-úsáidtear an paraiméadar roghnach color.

Úsáideann na comhordanáidí x agus y an bunús réamhshocraithe (0, 0) mura bhfuil bunús difriúil socraithe ag baint úsáide as set_origin.

Usage:
robot.screen.draw_circle(x, y, radius, color)

Paraiméadar	Cur síos
x	Comhordanáid-x lár an chiorcail, tugtha mar shlánuimhir ó 0 go 240.
y	Comhordanáid y lár an chiorcail, tugtha mar shlánuimhir ó 0 go 240.
radius	Ga an chiorcail, tugtha mar shlánuimhir ó 0 go 240 picteilín.
color	Roghnach. Dath líonta an chiorcail. Áirítear leis na roghanna: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a green circle on the screen
robot.screen.draw_circle(120, 120, 40, GREEN)

show_file

Taispeánann show_file íomhá saincheaptha uaslódáilte ar scáileán an róbait, agus a suíomh socraithe ag baint úsáide as na paraiméadair x, y, agus center bunaithe ar phointe tagartha na híomhá.

Usage:
robot.screen.show_file(file, x, y, center)

Paraiméadar	Cur síos
file	An íomhá saincheaptha le húsáid, ó IMAGE1 go IMAGE10Tá uimhir na híomhá mar an gcéanna leis an uimhir a thaispeántar i bpainéal rialaithe AIM.
x	An fritháireamh cothrománach don íomhá, tugtha mar shlánuimhir i bpicteilíní. Bogann luachanna dearfacha ar dheis í; bogann luachanna diúltacha ar chlé í.
y	An t-aschur ingearach don íomhá, tugtha mar shlánuimhir i bpicteilíní. Bogann luachanna dearfacha síos é; bogann luachanna diúltacha suas é.
center	Optional. If center=True, the image is placed using its center at coordinate (120, 120). By default (center=False), the top-left corner of the image is used and positioned relative to the current origin.

# Display uploaded Image 1 in the top left corner
robot.screen.show_file(IMAGE1, 0, 0)

# Show the same image on both sides of the screen
# Image size is 120 x 120
robot.screen.show_file(IMAGE1, 65, 0, center=True)
robot.screen.show_file(IMAGE1, -65, 0, center=True)

set_clip_region

Sainmhíníonn set_clip_region limistéar dronuilleogach ar an scáileán ina mbeidh gach líníocht agus téacs teoranta. Ní thaispeánfar aon ábhar lasmuigh den réigiún seo.

Usage:
robot.screen.set_clip_region(x, y, width, height)

Paraiméadar	Cur síos
x	Comhordanáid x chúinne uachtarach na láimhe clé den réigiún gearrthóige, tugtha mar dheachúil (float) ó 0 go 240.
y	Comhordanáid y chúinne uachtarach na láimhe clé den réigiún gearrthóige, tugtha mar dheachúil (float) ó 0 go 240.
width	Leithead réigiún an ghearrthóige i bpicteilíní, tugtha mar dheachúil (float) ó 0 go 240.
height	Airde réigiún an ghearrthóige i bpicteilíní, tugtha mar dheachúil (float) ó 0 go 240.

# Restrict text and drawings to a specific region
robot.screen.set_clip_region(0, 0, 120, 120)
robot.screen.draw_rectangle(60, 60, 100, 100, RED)
robot.screen.print_at("Cut off!", x=60, y=60)

Glaonna ar ais

pressed

pressed modh le glaoch nuair a bhrúitear scáileán an róbait.

Usage:
robot.screen.pressed(callback, arg)

Paraiméadair	Cur síos
callback	Feidhm [Feidhm] atá sainmhínithe roimhe seo le forghníomhú nuair a bhrúitear scáileán an rialtóra.
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.

# Set the LEDs to green when the screen is pressed.
def screen_touched():
    robot.led.on(ALL_LEDS, GREEN)

robot.screen.pressed(screen_touched)

released

released cláraíonn modh le glaoch nuair a scaoiltear scáileán an róbait.

Usage:
robot.screen.released(callback, arg)

Paraiméadair	Cur síos
callback	Feidhm [Feidhm] atá sainmhínithe roimhe seo le forghníomhú nuair a bhrúitear scáileán an rialtóra.
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.

# Set the LEDs to blue when the screen is released.
def screen_released():
    robot.led.on(ALL_LEDS, BLUE)

robot.screen.released(screen_released)