Scáileán#
Réamhrá#
Rialaíonn na modhanna Scáileáin an chaoi a léiríonn Rialaitheoir Dróin VEX AIR téacs, uimhreacha, grafaicí agus íomhánna 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 atá ar fáil:
Priontáil Cúrsóra – Taispeáin téacs agus bainistigh an cúrsóir priontála.
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– Seolann sé an tsraith ar ais ina gclófar an téacs.get_column– Tugann sé seo an colún ar ais ina gclófar an téacs.
Priontáil XY – Priontáil téacs ag comhordanáidí bunaithe ar phicteilíní.
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í – Athraigh socruithe scáileáin, dathanna agus iompar líníochta.
clear_screen– Glanann sé seo na líníochtaí, an téacs agus na híomhánna go léir ó scáileán an rialaitheora.wait_for_render– Athraíonn sé líníocht scáileáin go hiompar rindreála níos déanaí.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_text_fill_color– Socraíonn sé an dath líonta taobh thiar den téacs clóite.set_fill_color– Socraíonn sé seo an dath líonta do chruthanna tarraingthe.
Tarraing – Cuir grafaicí agus íomhánna leis an scáileán.
draw_pixel– Tarraingíonn sé picteilín amháin ag suíomh x agus y ar leith.draw_line– Tarraingíonn líne idir dhá phointe.draw_rectangle– Tarraingíonn sé dronuilleog ag baint úsáide as na dathanna peann agus líonta reatha.draw_circle– Tarraingíonn sé ciorcal ag baint úsáide as an bpeann reatha agus na dathanna líonta.show_file– Tarraingíonn sé íomhá uaslódáilte.
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.
Glaonna Ar Ais – Feidhmeanna a rith nuair a bhrúitear nó a scaoiltear an scáileán.
Priontáil Cúrsóra#
print#
print priontáileann téacs, uimhreacha, nó luachanna athrógacha ar scáileán an rialaitheora ag an suíomh cúrsóra agus an cló reatha.
Usage:
controller.screen.print(text)
Paraiméadair |
Cur síos |
|---|---|
|
An téacs, an uimhir, nó an luach athrógach le priontáil ar an scáileán. |
|
Roghnach. An deighilteoir idir téacs clóite. De réir réamhshocraithe, |
|
Roghnach. An teaghrán a chuirtear i ndiaidh an téacs priontáilte dheireanaigh. De réir réamhshocraithe, |
|
Roghnach. Líon na ndeachúlacha a phriontálfaidh snámhphointe mar shlánuimhir. De réir réamhshocraithe, |
# Display a message at the starting cursor position.
controller.screen.print("Time to fly!")

# Display the first 2 decimals of pi
controller.screen.print(3.1415, precision = 2)

set_cursor#
Bogann set_cursor an cúrsóir go sraith agus colún ar leith ar scáileán an rialaitheora. Tosóidh an chéad ghlao eile print ag priontáil ag an suíomh sin. Cuirfidh spásáil na sraitheanna agus na gcolún an cló roghnaithe san áireamh. Leis an gcló meánach aonspásáilte réamhshocraithe, is féidir leis an scáileán suas le 18 sraith agus 53 colú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.
Usage:
controller.screen.set_cursor(row, col)
Paraiméadair |
Cur síos |
|---|---|
|
An tsraith le bogadh an cúrsóir chuici. |
|
An colún le bogadh an cúrsóir chuige. |
# Display text starting at Row 7 Column 25.
controller.screen.set_cursor(row=7, col=25)
controller.screen.print("Row 7, Column 25")

next_row#
next_row bogann an cúrsóir go colún 1 ar an gcéad ró eile ar scáileán an rialaitheora.
Usage:
controller.screen.next_row()
Paraiméadair |
Cur síos |
|---|---|
Níl aon pharaiméadair ag an modh seo. |
# Display two lines of text.
controller.screen.print("Line 1")
controller.screen.next_row()
controller.screen.print("Line 2")

clear_row#
clear_row Glanann sé sraith téacs ar scáileán an rialtóra.
Usage:
controller.screen.clear_row(row, color)
Paraiméadar |
Cur síos |
|---|---|
|
Roghnach. An tsraith le glanadh. Is é an tsraith cúrsóra reatha an réamhshocrú. |
|
Roghnach. An dath le cur i bhfeidhm ar an ró glanta. Mura sonraítear dath, úsáidtear
|
# Clear only the second row of text
controller.screen.print("This text stays")
controller.screen.next_row()
controller.screen.print("This text disappears")
wait(3, SECONDS)
controller.screen.clear_row(2)
# Turn the 5th row green.
controller.screen.clear_row(5, GREEN)
get_row#
get_row an tsraith reatha ina gclófar téacs ar ais, mar shlánuimhir.
Usage:
controller.screen.get_row()
Paraiméadair |
Cur síos |
|---|---|
Níl aon pharaiméadair ag an modh seo. |
# Display the cursor's current row.
controller.screen.set_cursor(row=7, col=25)
controller.screen.print(controller.screen.get_row())

get_column#
get_column an colún reatha ina gclófar téacs ar ais, mar shlánuimhir.
Usage:
controller.screen.get_column()
Paraiméadair |
Cur síos |
|---|---|
Níl aon pharaiméadair ag an modh seo. |
# Display the cursor's current column.
controller.screen.set_cursor(row=7, col=25)
controller.screen.print(controller.screen.get_column())

Priontáil XY#
print_at#
Priontálann print_at téacs, uimhreacha, nó luachanna athraitheacha ar scáileán an rialaitheora ag suíomh sonrach (x, y) i bpicteilíní, ag baint úsáide as an font agus an origin reatha. 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.
Usage:
controller.screen.print_at(text, x, y)
Paraiméadar |
Cur síos |
|---|---|
|
An téacs, an uimhir, nó an luach athrógach le priontáil ar an scáileán. |
|
Suíomh cothrománach an téacs, mar shlánuimhir ó 0 go 640 picteilín. 0 ar chlé; 640 ar dheis. |
|
Suíomh ingearach an téacs, mar shlánuimhir ó 0 go 480 picteilín. Is é 0 an barr; is é 480 an bun. |
# Display a message in the middle of the screen.
controller.screen.print_at("Hello, drone!", x=320, y=240)

set_origin#
Socraíonn set_origin an bunús (0, 0) a úsáidtear le haghaidh líníochta agus priontáil bunaithe ar chomhordanáidí ar scáileán an rialaitheora. De réir réamhshocraithe, is é an bunús an chúinne uachtarach ar chlé den scáileán. Is féidir leis an modh seo an bunús a athshocrú go suíomh comhordanáidí scáileáin malartach (x, y).
Usage:
controller.screen.set_origin(x, y)
Paraiméadar |
Cur síos |
|---|---|
|
An comhordanáid x nua le socrú mar an mbunphointe, tugtha mar shlánuimhir ó 0 go 640. |
|
An comhordanáid y nua le socrú mar an mbunphointe, tugtha mar shlánuimhir ó 0 go 480. |
# Set the origin to the center of the screen.
controller.screen.set_origin(x=320, y=240)
# Draw a rectangle at the new origin.
controller.screen.draw_rectangle(x=0, y=0, width=80, height=40)

Sóiteoirí#
clear_screen#
clear_screen glanann sé gach líníocht, téacs agus íomhá ó scáileán an rialaitheora.
Usage:
controller.screen.clear_screen(row, col, color)
Paraiméadar |
Cur síos |
|---|---|
|
Roghnach. An tsraith ar a mbogfar an cúrsóir tar éis an scáileán a ghlanadh. Is é 1 an réamhshocrú. |
|
Roghnach. An colún le bogadh an cúrsóir chuige tar éis an scáileán a ghlanadh. Is é 1 an réamhshocrú. |
|
Optional. Sets the screen color. If
|
# Draw a circle, and clear it after 2 seconds.
controller.screen.draw_circle(x=320, y=240, radius=80)
wait(2, SECONDS)
controller.screen.clear_screen()
# Print two messages in the same spot
controller.screen.print("Hello!")
wait(3,SECONDS)
controller.screen.clear_screen(row=1, col=1)
controller.screen.print("Goodbye!")
# Set the background color of the screen to red.
controller.screen.clear_screen(color=RED)
wait_for_render#
wait_for_render líníocht scáileáin go hiompar rindreála níos déanaí. Nuair a ritheann an modh seo, ní bheidh na horduithe scáileáin seo a leanas le feiceáil ar scáileán an rialtóra go dtí go ritheann an chéad wait_for_render eile.
Nóta: Bain úsáid as seo sula dtarraingíonn tú grúpa téacs, cruthanna nó íomhánna, ansin bain úsáid as arís chun an nuashonrú iomlán a rindreáil ag an am céanna.
Usage:
controller.screen.wait_for_render()
Paraiméadar |
Cur síos |
|---|---|
Níl aon pharaiméadair ag an modh seo. |
# Display text and images when button 7 is pressed.
controller.screen.wait_for_render()
controller.screen.print("Screen rendered!")
controller.screen.draw_circle(x=320, y=240, radius=80)
while not controller.button7.pressing():
wait(5, MSEC)
controller.screen.wait_for_render()

set_font#
Socraíonn set_font an cló a úsáidtear chun téacs a thaispeáint ar scáileán an rialaitheora. Cuirfear an cló seo i bhfeidhm ar an téacs go léir a phriontálfar tar éis an modh seo a rith. Is é MONO20 an cló réamhshocraithe ag tús tionscadail.
Usage:
controller.screen.set_font(fontname)
Paraiméadar |
Cur síos |
|---|---|
|
Sets the font to one of the following:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
# Display text using a larger font.
controller.screen.set_font(MONO40)
controller.screen.print("VEX")

set_pen_width#
Socraíonn set_pen_width tiús na línte tarraingthe agus imlínte na gcruthanna.
Usage:
controller.screen.set_pen_width(width)
Paraiméadar |
Cur síos |
|---|---|
|
Leithead an pheann, tugtha mar shlánuimhir i bpicteilíní. |
# Draw a rectangle with a pen width of 10.
controller.screen.set_pen_width(10)
controller.screen.draw_rectangle(x=200, y=200, width=200, height=80)

set_pen_color#
set_pen_color socraíonn dath an téacs, na bpicteilíní, na línte, agus imlínte na gcruthanna.
Usage:
controller.screen.set_pen_color(color)
Paraiméadar |
Cur síos |
|---|---|
|
Roghnach. Socraíonn sé dath an pheann agus an chló. Áirítear leis na roghanna:
|
# Draw a rectangle with an orange outline.
controller.screen.set_pen_color(ORANGE)
controller.screen.draw_rectangle(x=200, y=150, width=240, height=150)
controller.screen.set_pen_color(WHITE)
controller.screen.print_at("VEXcode AIR", x=250, y=220)

set_text_fill_color#
set_text_fill_color Socraíonn sé an dath líonta taobh thiar de théacs clóite. Is trédhearcach an dath líonta téacs réamhshocraithe.
Usage:
controller.screen.set_text_fill_color(color)
Paraiméadar |
Cur síos |
|---|---|
|
Optional. Sets the text fill color. Options include:
|
# Display two colors behind text
controller.screen.set_text_fill_color(RED)
controller.screen.print("Red")
controller.screen.next_row()
controller.screen.set_text_fill_color(BLUE)
controller.screen.print("Blue")

set_fill_color#
set_fill_color Socraíonn an dath líonta a úsáidtear nuair a tharraingítear cruthanna. Is dubh an dath líonta réamhshocraithe.
Usage:
controller.screen.set_fill_color(color)
Paraiméadar |
Cur síos |
|---|---|
|
Roghnach. Socraíonn sé an dath líonta. Áirítear leis na roghanna:
TRANSPARENT |
# Draw an orange-filled rectangle with text on top
controller.screen.set_fill_color(ORANGE)
controller.screen.draw_rectangle(x=200, y=150, width=250, height=150)
controller.screen.print_at("VEXcode AIR", x=250, y=220)

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:
controller.screen.draw_pixel(x, y)
Paraiméadar |
Cur síos |
|---|---|
|
An comhordanáid-x ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 640. |
|
An comhordanáid y ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 480. |
# Draw five pixels in a diagonal.
controller.screen.draw_pixel(x=360, y=200)
controller.screen.draw_pixel(x=340, y=220)
controller.screen.draw_pixel(x=320, y=240)
controller.screen.draw_pixel(x=300, y=260)
controller.screen.draw_pixel(x=280, y=280)
![]()
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:
controller.screen.draw_line(x1, y1, x2, y2)
Paraiméadar |
Cur síos |
|---|---|
|
Comhordanáid x tosaigh na líne, tugtha mar shlánuimhir ó 0 go 640. |
|
Comhordanáid y tosaigh na líne, tugtha mar shlánuimhir ó 0 go 480. |
|
Comhordanáid x deiridh na líne, tugtha mar shlánuimhir ó 0 go 640. |
|
Comhordanáid y deiridh na líne, tugtha mar shlánuimhir ó 0 go 480. |
# Make an X across the screen.
controller.screen.draw_line(x1=0, y1=0, x2=640, y2=480)
controller.screen.set_pen_color(CYAN)
controller.screen.draw_line(x1=0, y1=480, x2=640, y2=0)

draw_rectangle#
draw_rectangle tarraingíonn dronuilleog ag baint úsáide as an leithead peann, dath peann, agus 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:
controller.screen.draw_rectangle(x, y, width, height, color)
Paraiméadar |
Cur síos |
|---|---|
|
Comhordanáid-x chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 640. |
|
Comhordanáid y chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 480. |
|
Leithead na dronuilleoige, tugtha mar shlánuimhir ó 0 go 640. |
|
Airde na dronuilleoige, tugtha mar shlánuimhir ó 0 go 480. |
|
Roghnach. Socraíonn sé dath líonta an dronuilleoige. Áirítear leis na roghanna:
|
# Draw two rectangles on the screen.
controller.screen.draw_rectangle(x=0, y=0, width=620, height=460)
controller.screen.draw_rectangle(x=200, y=180, width=200, height=100, color=GREEN)

draw_circle#
draw_circle tarraingíonn ciorcal ag baint úsáide as an leithead peann, dath peann, agus 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:
controller.screen.draw_circle(x, y, radius, color)
Paraiméadar |
Cur síos |
|---|---|
|
Comhordanáid-x lár an chiorcail, tugtha mar shlánuimhir ó 0 go 640. |
|
Comhordanáid y lár an chiorcail, tugtha mar shlánuimhir ó 0 go 480. |
|
Ga an chiorcail, tugtha mar shlánuimhir ó 0 go 480 picteilín. |
|
Roghnach. Socraíonn sé dath líonta an chiorcail. Áirítear leis na roghanna:
|
# Draw one green circle on the screen.
controller.screen.set_fill_color(GREEN)
controller.screen.draw_circle(x=320, y=240, radius=200, color=GREEN)

show_file#
Tarraingíonn show_file íomhá saincheaptha uaslódáilte ar scáileán an rialaitheora ag suíomh x agus y, le scálú, rothlú agus trédhearcacht alfa roghnach.
Usage:
controller.screen.show_file(file, x, y, scale_width, scale_height, rotation, use_alpha)
Paraiméadar |
Cur síos |
|---|---|
|
An íomhá uaslódáilte ag an úsáideoir le húsáid. Athróidh na roghanna má chuirtear ainmneacha na n-íomhánna in eagar sa Phainéal Rialaithe. |
|
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é í. |
|
An t-aschur ingearach don íomhá, tugtha mar shlánuimhir i bpicteilíní. Bogann luachanna dearfacha síos é; bogann luachanna diúltacha suas é. |
|
Roghnach. Leithead na híomhá atá á scálú chuige, tugtha mar shlánuimhir i bpicteilíní. |
|
Roghnach. Airde na híomhá atá á scálaiú chuici, tugtha mar shlánuimhir i bpicteilíní. |
|
Roghnach. Líon na gcéimeanna chun an íomhá a rothlú, tugtha mar shlánuimhir ó 0 go 359. |
|
Roghnach. Cibé acu ar cheart cainéal alfa na híomhá a úsáid le haghaidh trédhearcachta. Áirítear na roghanna seo a leanas: |
# Display uploaded Image 1 in the top left corner.
controller.screen.show_file(IMAGE1, x=0, y=0)
# Display uploaded Image 1 scaled to the full screen.
controller.screen.show_file(IMAGE1, x=65, y=0, scale_width=640, scale_height=480)
# Display uploaded Image 1 with rotation of 180 degrees.
controller.screen.show_file(IMAGE1, x=-65, y=0, rotation=180)
# Upload an image with a transparent background.
# Display uploaded Image 1 with alpha channel enabled.
controller.screen.show_file(IMAGE1, x=0, y=0, use_alpha=True)
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:
controller.screen.pressing()
Paraiméadair |
Cur síos |
|---|---|
Níl aon pharaiméadair ag an modh seo. |
# Play a sound when the screen is pressed.
while True:
if controller.screen.pressing():
controller.sound.play_note("C5", 500)
wait(5, MSEC)
# Display different messages after the screen is pressed
while not controller.screen.pressing():
wait(5, MSEC)
controller.screen.print("First message!")
controller.screen.next_row()
# Lift finger to press the screen again
while controller.screen.pressing():
wait(5, MSEC)
while not controller.screen.pressing():
wait(5, MSEC)
controller.screen.print("Second message!")
controller.screen.next_row()
x_position#
Tugann x_position an comhordanáid-x i bpicteilíní ar ais san áit dheireanach ar brúdh an scáileán, mar shlánuimhir ó 0 (ar chlé) go 640 (ar dheis).

Usage:
controller.screen.x_position()
Paraiméadair |
Cur síos |
|---|---|
Níl aon pharaiméadair ag an modh seo. |
# Play a high or low note based on where screen is pressed.
while True:
if controller.screen.pressing():
if controller.screen.x_position() > 320:
controller.sound.play_note("C6", 500)
else:
controller.sound.play_note("C4", 500)
wait(5, MSEC)
y_position#
Tugann y_position an comhordanáid-y ar ais i bpicteilíní san áit ar brúdh an scáileán go deireanach, mar shlánuimhir ó 0 (barr) go 480 (bun).

Usage:
controller.screen.y_position()
# Play a high or low note based on where screen is pressed.
while True:
if controller.screen.pressing():
if controller.screen.y_position() > 240:
controller.sound.play_note("C6", 500)
else:
controller.sound.play_note("C4", 500)
wait(5, MSEC)
Glaonna ar ais#
pressed#
pressed cláraíonn feidhm le glaoch uirthi nuair a bhrúitear scáileán an rialtóra.
Usage:
controller.screen.pressed(callback, arg)
Paraiméadair |
Cur síos |
|---|---|
|
Feidhm [Feidhm] atá sainmhínithe roimhe seo le forghníomhú nuair a bhrúitear scáileán an rialtóra. |
|
Roghnach. Tuple ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Úsáid Feidhmeanna le Paraiméadair le haghaidh tuilleadh eolais. |
# Play a sound when the screen is pressed.
def play_sound():
controller.sound.play_note("C5", 500)
controller.screen.pressed(play_sound)
released#
released cláraíonn feidhm le glaoch uirthi nuair a scaoiltear scáileán an rialtóra.
Usage:
controller.screen.released(callback, arg)
Paraiméadair |
Cur síos |
|---|---|
|
Feidhm [Feidhmeanna] atá sainmhínithe roimhe seo le forghníomhú nuair a scaoiltear scáileán an rialaitheora. |
|
Roghnach. Tuple ina bhfuil argóintí le cur chuig an bhfeidhm athghlaoite. Féach Úsáid Feidhmeanna le Paraiméadair le haghaidh tuilleadh eolais. |
# Play a sound when the screen is pressed.
def play_sound():
controller.sound.play_note("C5", 500)
controller.screen.released(play_sound)












