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.

  • 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.

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

text

An téacs, an uimhir, nó an luach athrógach le priontáil ar an scáileán.

sep

Roghnach. An deighilteoir idir téacs clóite. De réir réamhshocraithe, sep = ’ ‘

end

Roghnach. An teaghrán a chuirtear i ndiaidh an téacs priontáilte dheireanaigh. De réir réamhshocraithe, end = ‘\n’

precision

Roghnach. Líon na ndeachúlacha a phriontálfaidh snámhphointe mar shlánuimhir. De réir réamhshocraithe, precision = 5

# Display a message at the starting cursor position.
controller.screen.print("Time to fly!")

Scáileán den scáileán Rialaitheoir Dróin VEX AIR, le téacs bán sa chúinne uachtarach ar chlé a léann Am eitilte!

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

An scáileán céanna leis an gceann roimhe seo, leis an téacs ag léamh 3.14 sa chúinne uachtarach ar chlé.

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

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 7 Column 25.
controller.screen.set_cursor(row=7, col=25)
controller.screen.print("Row 7, Column 25")

Scáileán den scáileán Rialaitheoir Dróin VEX AIR, le téacs bán in aice leis an lár a léann Ró 7, Colún 25 sa suíomh scáileáin sin.

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")

Scáileán den scáileán Rialaitheoir Dróin VEX AIR, le téacs bán sa chúinne uachtarach ar chlé a léann Líne 1 ar an líne uachtarach, agus Líne 2 díreach faoi.

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

row

Roghnach. An tsraith le glanadh. Is é an tsraith cúrsóra reatha an réamhshocrú.

color

Roghnach. An dath le cur i bhfeidhm ar an ró glanta. Mura sonraítear dath, úsáidtear set_fill_color. Áirítear leis na roghanna:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
Is féidir leat dath saincheaptha a shonrú freisin.

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

Scáileán den scáileán Rialaitheoir Dróin VEX AIR, le téacs bán in aice leis an lár a léann 7, ag suíomh ró 7, colún 25.

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())

Scáileán den scáileán Rialaitheoir Dróin VEX AIR, le téacs bán in aice leis an lár a léann 25, ag suíomh ró 7, colún 25.

Priontáil XY#

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

x

An comhordanáid x nua le socrú mar an mbunphointe, tugtha mar shlánuimhir ó 0 go 640.

y

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)

Scáileán den scáileán Rialaitheoir Dróin VEX AIR, le dronuilleog bán tarraingthe ionas go bhfuil an chúinne uachtarach ar chlé i lár an scáileáin.

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

row

Roghnach. An tsraith ar a mbogfar an cúrsóir tar éis an scáileán a ghlanadh. Is é 1 an réamhshocrú.

col

Roghnach. An colún le bogadh an cúrsóir chuige tar éis an scáileán a ghlanadh. Is é 1 an réamhshocrú.

color

Optional. Sets the screen color. If row and col are included, use color as the third argument. Options include:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
You can also specify a custom color.

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

Scáileán den scáileán Rialaitheoir Dróin VEX AIR, le téacs bán a léann Screen rendered! sa chúinne uachtarach ar chlé, agus ciorcal bán tarraingthe i lár an scáileáin.

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

fontname

Sets the font to one of the following:

  • MONO12
  • MONO15
  • MONO20
  • MONO24
  • MONO30
  • MONO36
  • MONO40
  • MONO60
  • PROP20
  • PROP24
  • PROP30
  • PROP36
  • PROP40
  • PROP60

Scáileán den scáileán Rialaitheoir Dróin VEX AIR le meascán litreacha agus uimhreacha priontáilte i mbán sa chúinne uachtarach ar chlé i gcló Mono 12. Tá na litreacha AZ ar líne amháin, agus tógann siad thart ar aon trian de leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 91 carachtar trasna agus 30 sraith.
MONO12

An íomhá chéanna leis an gceann roimhe seo, anois le cló Mono 15. Tá na litreacha AZ ar líne amháin, agus tógann siad beagnach leath leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 71 carachtar trasna agus 23 sraitheanna.
MONO15

An íomhá chéanna leis an gceann roimhe seo, anois le cló Mono 20. Tá na litreacha AZ ar líne amháin, agus tógann siad leath leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 53 carachtar trasna agus 18 sraitheanna.
MONO20

An íomhá chéanna leis an gceann roimhe seo, anois le cló Mono 24. Tá na litreacha AZ ar líne amháin, agus tógann siad beagán os cionn leath leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 45 carachtar trasna agus 15 sraitheanna.
MONO24

An íomhá chéanna leis an gceann roimhe seo, anois le cló Mono 30. Tá na litreacha AZ ar líne amháin, agus tógann siad thart ar thrí cheathrú de leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 35 carachtar trasna agus 12 shraith.
MONO30

An íomhá chéanna leis an gceann roimhe seo, anois le cló Mono 36. Tá na litreacha AZ ar líne amháin, ag síneadh beagnach leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 29 carachtar trasna agus 10 sraitheanna.
MONO36

An íomhá chéanna leis an gceann roimhe seo, anois le cló Mono 40. Tá na litreacha AZ ar líne amháin, ag síneadh leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 26 carachtar trasna agus 9 sraitheanna.
MONO40

An íomhá chéanna leis an gceann roimhe seo, anois le cló Mono 60. Tá na litreacha AQ ar líne amháin, ag síneadh leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 17 carachtar trasna agus 6 shraith.
MONO60

An íomhá chéanna leis an gceann roimhe seo, anois le cló Prop 20. Tá na litreacha AZ ar líne amháin, agus tógann siad beagán os cionn leath leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 49 carachtar trasna agus 18 sraitheanna.
PROP20

An íomhá chéanna leis an gceann roimhe seo, anois le cló Prop 24. Tá na litreacha AZ ar líne amháin, agus tógann siad thart ar dhá thrian de leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 42 carachtar trasna agus 15 sraitheanna.
PROP24

An íomhá chéanna leis an gceann roimhe seo, anois le cló Prop 30. Tá na litreacha AZ ar líne amháin, agus tógann siad trí cheathrú de leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 33 carachtar trasna agus 12 shraith.
PROP30

An íomhá chéanna leis an gceann roimhe seo, anois le cló Prop 36. Tá na litreacha AZ ar líne amháin, ag síneadh beagnach leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 27 carachtar trasna agus 10 sraitheanna.
PROP36

An íomhá chéanna leis an gceann roimhe seo, anois le cló Prop 40. Tá na litreacha AY ar líne amháin, ag síneadh leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 24 carachtar trasna agus 9 sraitheanna.
PROP40

An íomhá chéanna leis an gceann roimhe seo, anois le cló Prop 60. Tá na litreacha AQ ar líne amháin, ag síneadh leithead an scáileáin. Sa chúinne íochtarach ar chlé, léann sé 17 carachtar trasna agus 6 shraith.
PROP60

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

An íomhá chéanna leis na cinn roimhe seo, anois leis an bhfocal VEX clóite i gcló Mono 40 sa chúinne uachtarach ar chlé.

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

width

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)

Scáileán de scáileán Rialaitheoir Dróin VEX AIR le dronuilleog bán le himill thiubh priontáilte sa lár.

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

color

Roghnach. Socraíonn sé dath an pheann agus an chló. Á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 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)

Scáileán de scáileán Rialaitheoir Dróin VEX AIR le dronuilleog tanaí oráiste agus na focail VEXcode AIR priontáilte i mbán sa lár.

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

color

Optional. Sets the text fill color. Options include:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
You can also specify a custom color.

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

Scáileán de scáileán Rialaitheoir Dróin VEX AIR le dhá líne téacs priontáilte sa chúinne uachtarach ar chlé. Léitear Dearg i dtéacs bán le haicinn dhearg ar an gcéad cheann, léitear Gorm i dtéacs bán le haicinn ghorm ar an dara ceann, díreach faoi bhun.

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

color

Roghnach. Socraíonn sé an dath líonta. Á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 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)

Scáileán de scáileán Rialaitheoir Dróin VEX AIR le dronuilleog oráiste soladach le himill tanaí bán agus téacs bán ina léann VEXcode AIR priontáilte sa lár.

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

x

An comhordanáid-x ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 640.

y

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)

Scáileán de scáileán Rialaitheoir Dróin VEX AIR le 5 picteilín scaipthe go cothrom priontáilte i líne trasnánach trasna lár an scáileáin.

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

x1

Comhordanáid x tosaigh na líne, tugtha mar shlánuimhir ó 0 go 640.

y1

Comhordanáid y tosaigh na líne, tugtha mar shlánuimhir ó 0 go 480.

x2

Comhordanáid x deiridh na líne, tugtha mar shlánuimhir ó 0 go 640.

y2

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)

Scáileán de scáileán Rialaitheoir Dróin VEX AIR le líne bán tarraingthe ón gcúinne uachtarach ar chlé go dtí an chúinne íochtarach ar dheis, agus líne gorm-uaine tarraingthe ón gcúinne íochtarach ar chlé go dtí an chúinne uachtarach ar dheis, ag trasnú sa lár.

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

x

Comhordanáid-x chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 640.

y

Comhordanáid y chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 480.

width

Leithead na dronuilleoige, tugtha mar shlánuimhir ó 0 go 640.

height

Airde na dronuilleoige, tugtha mar shlánuimhir ó 0 go 480.

color

Roghnach. Socraíonn sé 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 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)

Scáileán de scáileán Rialaitheoir Dróin VEX AIR le dronuilleog ghlas soladach le himill tanaí bán priontáilte sa lár, agus dronuilleog tanaí bán priontáilte timpeall imill sheachtracha an scáileáin.

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

x

Comhordanáid-x lár an chiorcail, tugtha mar shlánuimhir ó 0 go 640.

y

Comhordanáid y lár an chiorcail, tugtha mar shlánuimhir ó 0 go 480.

radius

Ga an chiorcail, tugtha mar shlánuimhir ó 0 go 480 picteilín.

color

Roghnach. Socraíonn sé 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 one green circle on the screen.
controller.screen.set_fill_color(GREEN)
controller.screen.draw_circle(x=320, y=240, radius=200, color=GREEN)

Scáileán de scáileán Rialaitheoir Dróin VEX AIR le ciorcal mór glas soladach le himill tanaí bán tarraingthe i lár an scáileáin.

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

file

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.

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 é.

scale_width

Roghnach. Leithead na híomhá atá á scálú chuige, tugtha mar shlánuimhir i bpicteilíní.

scale_height

Roghnach. Airde na híomhá atá á scálaiú chuici, tugtha mar shlánuimhir i bpicteilíní.

rotation

Roghnach. Líon na gcéimeanna chun an íomhá a rothlú, tugtha mar shlánuimhir ó 0 go 359.

use_alpha

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: True nó False.

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

Rialaitheoir Dróin VEX AIR agus toisí an scáileáin lipéadaithe agus imlínithe i mbosca dearg. Tosaíonn na comhordanáidí le (0,0) sa chúinne uachtarach ar chlé, agus leanann siad deiseal le (0, 640), (480, 640), agus (480,0) go dtí an chúinne íochtarach ar chlé. Tá comhordanáidí lár an scáileáin lipéadaithe (240, 320).

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).

Rialaitheoir Dróin VEX AIR agus toisí an scáileáin lipéadaithe agus imlínithe i mbosca dearg. Tosaíonn na comhordanáidí le (0,0) sa chúinne uachtarach ar chlé, agus leanann siad deiseal le (0, 640), (480, 640), agus (480,0) go dtí an chúinne íochtarach ar chlé. Tá comhordanáidí lár an scáileáin lipéadaithe (240, 320).

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

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.

# 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

callback

Feidhm [Feidhmeanna] atá sainmhínithe roimhe seo le forghníomhú nuair a scaoiltear scáileán an rialaitheora.

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.

# Play a sound when the screen is pressed.
def play_sound():
    controller.sound.play_note("C5", 500)

controller.screen.released(play_sound)