Scáileán

Réamhrá

Rialaíonn na modhanna Scáileáin an chaoi a léiríonn an V5 Brain téacs, uimhreacha agus grafaicí ar a scáileán tadhaill, agus an chaoi a bhfreagraíonn sé d’ionchur tadhaill.

De réir réamhshocraithe, is é beag aonspáis an cló le haghaidh priontála chuig an Brain, ina bhfuil 12 shraith agus 48 colún.

Chun líníocht a dhéanamh, is é 480 x 240 picteilín taifeach na hinchinne.

Seo thíos liosta de na modhanna uile:

Priontáil Cúrsóra — Cuir téacs isteach agus priontáil é.

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

• row — Tugann sé seo an tsraith ar ais ina gclófar an téacs.

• column — Tugann sé seo an colún ar ais ina gclófar an téacs.

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

• get_string_width — Tugann sé leithead teaghráin ar ais i bpicteilíní ag baint úsáide as an gcló reatha.

• get_string_height — Tugann sé airde teaghráin ar ais i bpicteilíní ag baint úsáide as an gcló reatha.

• clear_line — Glanann sé líne téacs.

• new_line — Bogann sé an cúrsóir go líne nua.

Múiteoirí — Athraigh socruithe scáileáin, dathanna agus iompar líníochta.

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

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

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

Tarraing — Cuir grafaicí leis an scáileán.

• draw_pixel — Tarraingíonn sé picteilín amháin ag comhordanáid.

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

• draw_rectangle — Tarraingíonn sé dronuilleog.

• draw_circle — Tarraingíonn sé ciorcal.

• render — Nuashonraíonn sé scáileán na hinchinne le téacs agus líníochtaí amháin nuair a ghlaotar air.

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

Faighteoirí — Seiceáil staid agus suíomh tadhaill.

• pressing — Tugann sé seo le fios an bhfuil an scáileán á bhrú.

• 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 — Freagair d’imeachtaí tadhaill ar an scáileán.

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

• released — Cláraíonn sé feidhm le glaoch uirthi nuair a scaoiltear an scáileán.

Le haghaidh eolais ar Inchinn a thógáil chun rochtain a fháil ar na modhanna screen , féach Inchinn.

Priontáil Cúrsóra

print

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

Úsáid:

brain.screen.print(text, sep, precision)

Paraiméadair	Cur síos
text	An téacs, an uimhir, nó an luach athrógach le priontáil.
sep	Roghnach. Teaghrán le cur isteach idir luachanna. Ní mór é seo a scríobh mar argóint eochairfhocail (sep=). Is é “” an réamhshocrú.
precision	Roghnach. Líon na n-áiteanna deachúlacha le taispeáint agus uimhreacha simplí á bpriontáil. Ní mór é seo a scríobh mar argóint eochairfhocail (precision=). Is é 2 an réamhshocrú.

# Print on the Brain's screen
brain.screen.print("Hello, Robot!")

set_cursor

Bogann set_cursor an cúrsóir go sraith agus colún ar leith ar scáileán na Brain. Tosóidh an chéad ghlao eile print ag priontáil ag an suíomh sin. Braitheann líon na sraitheanna agus na gcolún a n-oirfidh go compordach ar an gcló roghnaithe. Leis an gcló meánach réamhshocraithe aonspásáilte, is féidir 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ó deacair 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ú téacs comhsheasmhach. I gcodarsnacht leis sin, bíonn leithead carachtar é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 colún, ní ar stíl an chló. Is féidir méid an chló a choigeartú ag baint úsáide as set_font.

Úsáid:

brain.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 12
brain.screen.set_cursor(3, 12)
brain.screen.print("Row 3, Column 12")

next_row

next_row bogann an cúrsóir go dtí an chéad ró eile.

Úsáid:

brain.screen.next_row()

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

# Print two lines of text on the Brain's screen
brain.screen.print("Line 1")
brain.screen.next_row()
brain.screen.print("Line 2")

clear_row

clear_row glanann sé sraith amháin téacs ar scáileán na hInchinne.

Úsáid:

brain.screen.clear_row(row, color)

Paraiméadair	Cur síos
row	Roghnach. An tsraith le glanadh. Is é an tsraith cúrsóra reatha an réamhshocrú.
color	Roghnach. Luach bailí color, luach heicsidheachúlach, nó teaghrán gréasáin.

# Only keep the text on row 1
brain.screen.print("This text stays")
brain.screen.next_row
brain.screen.print("This text disappears")
wait(3, SECONDS)

brain.screen.clear_row()

row

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

Úsáid:

brain.screen.row()

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

# Display the cursor's current row
brain.screen.set_cursor(3, 2)
brain.screen.print(brain.screen.row())

column

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

Úsáid:

brain.screen.column()

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

# Display the cursor's current column
brain.screen.set_cursor(3, 15)
brain.screen.print(brain.screen.column())

print_at

Priontálann print_at téacs, uimhreacha, nó luachanna athrógacha ar scáileán na hInchinne ag comhordanáidí x agus y sonracha leis an font agus an origin reatha.

Úsáid:

brain.screen.print_at(text, x, y, sep, precision, opaque)

Paraiméadair	Cur síos
text	An téacs, an uimhir, nó an luach athrógach le priontáil.
x	An comhordanáid-x le priontáil mar argóint eochairfhocail (x=), agus tagairt á déanamh do bhunús an scáileáin.
y	An comhordanáid-y le priontáil mar argóint eochairfhocail (y=), agus tagairt á déanamh do bhunús an scáileáin.
sep	Roghnach. Teaghrán le cur isteach idir luachanna. Ní mór é seo a scríobh mar argóint eochairfhocail (sep=). Is é ” “ an réamhshocrú.
precision	Roghnach. Líon na n-áiteanna deachúlacha le taispeáint agus uimhreacha simplí á bpriontáil. Ní mór é seo a scríobh mar argóint eochairfhocail (precision=). Is é 2 an réamhshocrú.
opaque	Roghnach. Luach Booleanach a léiríonn an bhfuil nó nach bhfuil an téacs le feiceáil ó na picteilíní cúlra. Is é True an luach réamhshocraithe.

# Display text at the center of the screen
brain.screen.print_at("Center", x=220, y=120)

get_string_width

get_string_width leithead teaghráin i bpicteilíní ar ais mar shlánuimhir, ag baint úsáide as an font reatha.

Usage:
brain.screen.get_string_width(string)

Paraiméadair	Cur síos
string	An sreang le tomhas.

get_string_height

get_string_height airde teaghráin i bpicteilíní ar ais mar shlánuimhir, ag baint úsáide as an font reatha.

Usage:
brain.screen.get_string_height(string)

Paraiméadair	Cur síos
string	An sreang le tomhas.

clear_line

clear_line glanann an tsraith téacs reatha.

Usage: brain.screen.clear_line()

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

new_line

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

Úsáid:

brain.screen.new_line()

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

Sóiteoirí

clear_screen

clear_screen glanann sé na líníochtaí agus an téacs go léir ón scáileán Brain.

Úsáid:

brain.screen.clear_screen(color)

Paraiméadair	Cur síos
color	Roghnach. Rogha datha bailí: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.BLACK (Réamhshocrú) Color.WHITE

# Print VEXcode on the screen
brain.screen.print("VEXcode")
wait(2, SECONDS)
# Clear screen to black
brain.screen.clear_screen()

# Print VEXcode on the screen
brain.screen.print("VEXcode")

# Clear screen to blue using predefined color
brain.screen.clear_screen(Color.BLUE)

set_font

Socraíonn set_font an cló a úsáidtear chun téacs a thaispeáint ar scáileán na hinchinne. Cuirfear an cló seo i bhfeidhm ar gach téacs a phriontáiltear tar éis don mhodh seo a rith.

Úsáid:

brain.screen.set_font(font)

Paraiméadair	Cur síos
font	Rogha cló bailí thíos.

Scáileán den scáileán V5 Brain le huimhreacha agus litreacha priontáilte i mbán sa chúinne uachtarach ar chlé i gcló MONO 12. Taispeánann sé AZ ar líne amháin, trasna thart ar cheathrú de leithead an scáileáin. Sa chúinne íochtarach ar chlé léann sé 80 colún agus 20 sraith. FontType.MONO12	FontType.MONO15	FontType.MONO20
FontType.MONO30	FontType.MONO40	FontType.MONO60
FontType.PROP20	FontType.PROP30	FontType.PROP40
FontType.PROP60

# Set the font type to MONO40
brain.screen.set_font(FontType.MONO40)
brain.screen.print("VEX")

set_pen_width

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

Úsáid:

brain.screen.set_pen_width(value)

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

# Draw a rectangle with a pen width of 10
brain.screen.set_pen_width(10)
brain.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.

Úsáid:

brain.screen.set_pen_color(color)

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

# Draw a rectangle with orange borders
brain.screen.set_pen_color(Color.ORANGE)
brain.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.

Úsáid:

brain.screen.set_fill_color(color)

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

# Draw a purple rectangle
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(50, 130, 100, 60)

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 Brain. De réir réamhshocraithe, is é an bunús cúinne uachtarach na láimhe clé den scáileán.

Úsáid:

brain.screen.set_origin(x, y)

Paraiméadair	Cur síos
x	An comhordanáid x le socrú mar an mbunphointe, ó 0 go 479.
y	An comhordanáid y le socrú mar an mbunphointe, ó 0 go 239.

Tarraing

draw_pixel

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

Úsáid:

brain.screen.draw_pixel(x, y)

Paraiméadair	Cur síos
x	An comhordanáid-x chun an picteilín a tharraingt, ó 0 go 479, agus tagairt á déanamh do bhunús an scáileáin.
y	An comhordanáid-y chun an picteilín a tharraingt, ó 0 go 239, agus tagairt á déanamh do bhunús an scáileáin.

# Draw the pixels marking the corners of a square
brain.screen.draw_pixel(250, 100)
brain.screen.draw_pixel(275, 100)
brain.screen.draw_pixel(250, 125)
brain.screen.draw_pixel(275, 125)

draw_line

draw_line Tarraingíonn líne ón gcéad chomhordanáid scáileáin go dtí an dara comhordanáid scáileáin ag baint úsáide as leithead agus dath an phinn reatha.

Úsáid:

brain.screen.draw_line(start_x, start_y, end_x, end_y)

Paraiméadair	Cur síos
start_x	An comhordanáid-x i bpicteilíní de thús na líne, ó 0 go 479, i dtagairt do bhunús an scáileáin.
start_y	An comhordanáid y i bpicteilíní de thús na líne, ó 0 go 239, i dtagairt do bhunús an scáileáin.
end_x	An comhordanáid-x i bpicteilíní ag deireadh na líne, ó 0 go 479, i dtagairt do bhunús an scáileáin.
end_y	An comhordanáid y i bpicteilíní ag deireadh na líne, ó 0 go 239, i dtagairt do bhunús an scáileáin.

# Draw a line from the top left to bottom right of the screen
brain.screen.draw_line(0, 0, 479, 239)

draw_rectangle

draw_rectangle Tarraingíonn sé dronuilleog ag baint úsáide as leithead an phinn, dath an phinn, agus dath an líonta reatha, mura n-úsáidtear an paraiméadar roghnach color.

Úsáid:

brain.screen.draw_rectangle(x, y, width, height, color)

Paraiméadair	Cur síos
x	An comhordanáid x i bpicteilíní den chúinne uachtarach ar chlé den dronuilleog ó 0 go 479.
y	An comhordanáid y i bpicteilíní den chúinne uachtarach ar chlé den dronuilleog ó 0 go 239.
width	Leithead an dronuilleoige.
height	Airde an dronuilleoige.
color	Roghnach. Rogha datha bailí: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a rectangle on the screen
brain.screen.draw_rectangle(50, 50, 130, 60)

draw_circle

draw_circle tarraingíonn ciorcal ag baint úsáide as leithead an phinn, dath an phinn, agus dath an líonta reatha, mura n-úsáidtear an paraiméadar roghnach color.

Úsáid:

brain.screen.draw_circle(x, y, radius, color)

Paraiméadair	Cur síos
x	An comhordanáid-x i bpicteilí lár an chiorcail, ó 0 go 479, i dtagairt do bhunús an scáileáin.
y	An comhordanáid y i bpicteilí lár an chiorcail, ó 0 go 239, i dtagairt do bhunús an scáileáin.
radius	Ga an chiorcail, i bpicteilíní.
color	Roghnach. An dath líonta le húsáid. Áirítear leis na roghanna: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a circle on the screen
brain.screen.draw_circle(120, 120, 40)

render

Cumasaíonn render maolánú dúbailte do scáileán an Inchinn. Nuair a ghlaoitear orthu, ní bheidh aon orduithe líníochta (cosúil le téacs, cruthanna, nó íomhánna) le feiceáil láithreach don chuid eile den tionscadal. Ina áit sin, ní thaispeánfar nuashonruithe ach amháin nuair a úsáidtear render arís. Ligeann sé seo do nuashonruithe scáileáin a bheith níos réidhe agus níos rialaithe, ach ciallaíonn sé nach mbeidh aon rud le feiceáil go dtí go n-úsáidtear render.

Úsáid:

brain.screen.render()

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

# Render text after moving
brain.screen.render()
brain.screen.print("Render later...")
drivetrain.drive_for(FORWARD, 100, MM)
drivetrain.turn_for(RIGHT, 90, DEGREES)
brain.screen.render()

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.

Úsáid:

brain.screen.set_clip_region(x, y, width, height)

Paraiméadair	Cur síos
x	Suíomh x chúinne uachtarach na láimhe clé den dronuilleog, i dtagairt do bhunús an scáileáin.
y	Suíomh y chúinne uachtarach ar chlé an dronuilleog, i dtagairt do bhunús an scáileáin.
width	Leithead an dronuilleoige.
height	Airde an dronuilleoige.

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

Teagmháil

pressing

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

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

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

Úsáid:

brain.screen.pressing()

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

# Change the screen's color after it's pressed
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.set_fill_color(Color.GREEN)
brain.screen.draw_rectangle(0, 0, 479, 239)

# Display different messages after the screen is pressed
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.print("First message!")
brain.screen.next_row()
# Lift finger to press the screen again
while brain.screen.pressing():
    wait(5, MSEC)
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.print("Second message!")
brain.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 479 (ar dheis).

Úsáid:

brain.screen.x_position()

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

# Display a circle where the screen is pressed
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.set_fill_color(Color.WHITE)
brain.screen.draw_circle(brain.screen.x_position(), brain.screen.y_position(), 20)

y_position

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

Úsáid:

brain.screen.y_position()

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

# Display a circle where the screen is pressed
while not brain.screen.pressing():
    wait(5, MSEC)
brain.screen.set_fill_color(Color.WHITE)
brain.screen.draw_circle(brain.screen.x_position(), brain.screen.y_position(), 20)

Glaonna ar ais

pressed

pressed cláraíonn feidhm le glaoch nuair a bhrúitear Scáileán na hInchinne.

Úsáid:

brain.screen.pressed(callback, arg)

Paraiméadair	Cur síos
callback	Feidhm shainithe a fhorghníomhaítear nuair a bhrúitear an scáileán Brain.
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("Screen pressed")

# Call my_function whenever the Brain screen is pressed
brain.screen.pressed(my_function)

released

released Cláraíonn feidhm le glaoch uirthi nuair a scaoiltear an scáileán (teagmháil bainte).

Úsáid:

brain.screen.released(callback, arg)

Paraiméadair	Cur síos
callback	Feidhm shainithe a fhorghníomhaítear nuair a scaoiltear an scáileán Inchinne.
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("Screen released")

# Call my_function whenever the Brain screen is released
brain.screen.released(my_function)