Scáileán

Réamhrá

Rialaíonn na modhanna Scáileáin an chaoi a léiríonn an IQ (2ú glúin) Inchinn téacs, uimhreacha agus grafaicí ar a scáileán ionsuite.

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

Úsáideann an leathanach seo brain mar shampla ainm Inchinn. Cuir d’ainm cumraithe féin ina áit de réir mar is gá.

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.

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

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

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

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

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

Priontáil Cúrsóra

print

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

Usage:
brain.screen.print(text, precision, opaque)

Paraiméadair	Cur síos
text	An téacs, an uimhir, nó an luach athrógach le priontáil ar an scáileán.
precision	Roghnach. Líon na n-áiteanna deachúlacha le taispeáint agus uimhreacha á dtaispeáint. Ní mór é seo a scríobh mar argóint eochairfhocail, i.e.:precision=3Is é 2 an réamhshocrú.
opaque	Roghnach. opaque=True — Líontar cúlra an téacs leis an dath líonta reatha nó dubh de réir réamhshocraithe. opaque=False (réamhshocraithe) — Beidh cúlra an téacs ag teacht le dath cúlra an scáileáin.

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

# Display a percentage with 4 decimal
# places and a blue background
brain.screen.set_fill_color(Color.BLUE)
brain.screen.print((42/100), precision = 4, opaque = True)

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 print eile 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.

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

# Repeatedly print the Brain's timer at
# the top left of the screen
while True:
    brain.screen.print(brain.timer.time(SECONDS))
    brain.screen.next_row()
    wait(1, SECONDS)
    brain.screen.clear_screen()
    brain.screen.set_cursor(1, 1)

next_row

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

Usage:
brain.screen.next_row()

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

# Display two lines of text
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.

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

Paraiméadair	Cur síos
ró	Roghnach. An tsraith le glanadh. Is é an tsraith cúrsóra reatha an réamhshocrú.
dath	Roghnach. An dath le cur i bhfeidhm ar an ró glanta. Áirítear na roghanna seo a leanas: Color.BLACK Color.BLUE Color.BLUE_GREEN Color.BLUE_VIOLET Color.GREEN Color.ORANGE Color.PURPLE Color.RED COLOR.RED_ORANGE Color.RED_VIOLET Color.VIOLET Color.WHITE Color.YELLOW Color.YELLOW_GREEN Color.YELLOW_ORANGE Is féidir leat dath saincheaptha a shonrú freisin.

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

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

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

row

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

Usage:
brain.screen.row()

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

# Set cursor to (3,2) and print 
# row number
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.

Usage:
brain.screen.column()

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

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

print_at

Priontálann print_at téacs, uimhreacha, nó luachanna athrógacha ar scáileán na Brain ag comhordanáidí x agus y sonraithe i bpicteilíní leis an font agus an origin atá socraithe faoi láthair. Ní thugann an modh seo aird ar shuíomh reatha an chúrsóra.

Usage:
brain.screen.print_at(text, x, y, 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, i.e.: x=, agus tagairt á déanamh do bhunús an scáileáin.
y	An comhordanáid-y le priontáil ag mar argóint eochairfhocail, i.e.: y=, agus tagairt á déanamh do bhunús an scáileáin.
precision	Roghnach. Líon na n-áiteanna deachúlacha le taispeáint agus uimhreacha á dtaispeáint. Ní mór é seo a scríobh mar argóint eochairfhocail, i.e.:precision=3Is é 2 an réamhshocrú.
opaque	Roghnach. opaque=True — Líontar cúlra an téacs leis an dath líonta reatha nó dubh de réir réamhshocraithe. opaque=False (réamhshocraithe) — Beidh cúlra an téacs ag teacht le dath cúlra an scáileáin.

# Print the number 1 on the Brain's screen at position (100, 40)
brain.screen.print_at(1, x=100, y=40)

# Display 1/3 with 3 decimal places and a blue background
brain.screen.set_fill_color(Color.BLUE)
brain.screen.print_at((1/3), x=100, y=40, precision=3, opaque=True)

get_string_width

get_string_width leithead sreinge i bpicteilíní ar ais mar shlánuimhir, mar a bheadh ​​sé le feiceáil ar scáileán an Brain. Athraíonn an leithead ag brath ar fhad an tsreinge agus an cló 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, mar a thaispeánfadh sé ar scáileán Brain. Athraíonn an airde ag brath ar fhad an teaghráin agus ar an cló reatha.

Usage:
brain.screen.get_string_height(string)

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

Sóiteoirí

clear_screen

clear_screen glanann sé gach líníocht agus téacs ó scáileán na hinchinne.

Usage:
brain.screen.clear_screen(color)

Paraiméadair	Cur síos
color	Roghnach. Socraíonn sé dath an scáileáin. Áirítear na roghanna seo a leanas: Color.BLACK Color.BLUE Color.BLUE_GREEN Color.BLUE_VIOLET Color.GREEN Color.ORANGE Color.PURPLE Color.RED COLOR.RED_ORANGE Color.RED_VIOLET Color.VIOLET Color.WHITE Color.YELLOW Color.YELLOW_GREEN Color.YELLOW_ORANGE Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a circle and clear it after 
# 2 seconds
brain.screen.draw_circle(80, 50, 20)
wait(2, SECONDS)
brain.screen.clear_screen()

# Turn the screen red
brain.screen.clear_screen(Color.RED)

set_font

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

Usage:
brain.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 MONO30 MONO40 MONO60 PROP20 PROP30 PROP40 PROP60 Taispeántar na roghanna seo thíos.

Scáileán den scáileán VEX IQ Brain le sraith uimhreacha agus litreacha i gcló Mono 12. Tá na litreacha AZ ar líne amháin, ag síneadh leithead an scáileáin. Léiríonn an chúinne íochtarach ar chlé 26 carachtar trasna agus 9 sraitheanna. MONO12	MONO15	MONO20
MONO30	MONO40	MONO60
PROP20	PROP30	PROP40
PROP60

# Display two different fonts on 
# two separate lines
brain.screen.set_font(FontType.MONO20)
brain.screen.print("Mono Medium")
brain.screen.next_row()
brain.screen.set_font(FontType.PROP20)
brain.screen.print("Prop Medium")

set_pen_width

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

Usage:
brain.screen.set_pen_width(width)

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

# Draw two circles with
# different pen widths
brain.screen.draw_circle(40, 70, 20)
brain.screen.set_pen_width(5)
brain.screen.draw_circle(100, 70, 20)

set_pen_color

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

Usage:
brain.screen.set_pen_color(color)

Paraiméadar	Cur síos
color	Optional. The pen and font color to use. Options include: Color.BLACK Color.BLUE Color.BLUE_GREEN Color.BLUE_VIOLET Color.GREEN Color.ORANGE Color.PURPLE Color.RED COLOR.RED_ORANGE Color.RED_VIOLET Color.VIOLET Color.WHITE Color.YELLOW Color.YELLOW_GREEN Color.YELLOW_ORANGE You can also specify a custom color.

# Draw two rectangles with
# different colors
brain.screen.draw_rectangle(100, 50, 10, 20)
brain.screen.set_pen_color(Color.BLUE)
brain.screen.draw_rectangle(50, 50, 10, 20)

set_fill_color

set_fill_color socraíonn an dath líonta a úsáidtear nuair a tharraingítear cruthanna.

Usage:
brain.screen.set_fill_color(color)

Paraiméadar	Cur síos
color	Roghnach. An dath líonta le húsáid. Áirítear na roghanna seo a leanas: Color.BLACK Color.BLUE Color.BLUE_GREEN Color.BLUE_VIOLET Color.GREEN Color.ORANGE Color.PURPLE Color.RED COLOR.RED_ORANGE Color.RED_VIOLET Color.VIOLET Color.WHITE Color.YELLOW Color.YELLOW_GREEN Color.YELLOW_ORANGE Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a yellow circle
brain.screen.set_fill_color(Color.YELLOW)
brain.screen.draw_circle(50, 50, 20)

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.

Usage:
brain.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 159.
y	An comhordanáid y nua le socrú mar an mbunphointe, tugtha mar shlánuimhir ó 0 go 107.

# Draw a line with the origin set to (50, 50)
brain.screen.set_origin(50, 50)
brain.screen.draw_line(1, 1, 159, 107)

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:
brain.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 159.
y	An comhordanáid y ina dtarraingeofar an picteilín, tugtha mar shlánuimhir ó 0 go 107.

# Draw one pixel at the center
# of the screen
brain.screen.draw_pixel(80, 50)

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:
brain.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 159.
y1	Comhordanáid y tosaigh na líne, tugtha mar shlánuimhir ó 0 go 107.
x2	Comhordanáid x deiridh na líne, tugtha mar shlánuimhir ó 0 go 159.
y2	Comhordanáid y deiridh na líne, tugtha mar shlánuimhir ó 0 go 107.

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

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:
brain.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 159.
y	Comhordanáid y chúinne uachtarach na láimhe clé den dronuilleog, tugtha mar shlánuimhir ó 0 go 107.
width	Leithead an dronuilleoige, i bpicteilíní.
height	Airde an dronuilleoige, i bpicteilíní.
color	Roghnach. Dath líonta an dronuilleoige. Áirítear na roghanna seo a leanas: Color.BLACK Color.BLUE Color.BLUE_GREEN Color.BLUE_VIOLET Color.GREEN Color.ORANGE Color.PURPLE Color.RED COLOR.RED_ORANGE Color.RED_VIOLET Color.VIOLET Color.WHITE Color.YELLOW Color.YELLOW_GREEN Color.YELLOW_ORANGE Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a red rectangle on the screen
brain.screen.draw_rectangle(25, 25, 100, 50, Color.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:
brain.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 159.
y	Comhordanáid y lár an chiorcail, tugtha mar shlánuimhir ó 0 go 107.
radius	Ga an chiorcail, i bpicteilíní.
color	Roghnach. Dath líonta an chiorcail. Áirítear na roghanna seo a leanas: Color.BLACK Color.BLUE Color.BLUE_GREEN Color.BLUE_VIOLET Color.GREEN Color.ORANGE Color.PURPLE Color.RED COLOR.RED_ORANGE Color.RED_VIOLET Color.VIOLET Color.WHITE Color.YELLOW Color.YELLOW_GREEN Color.YELLOW_ORANGE Is féidir leat dath saincheaptha a shonrú freisin.

# Draw a green circle on the screen
brain.screen.draw_circle(80, 50, 20, Color.GREEN)

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:
brain.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 shlánuimhir nó snámhphointe ó 0 go 159.
y	Comhordanáid y chúinne uachtarach na láimhe clé den réigiún gearrthóige, tugtha mar shlánuimhir nó snámhuimhir ó 0 go 107.
width	Leithead réigiún an ghearrthóige i bpicteilíní.
height	Airde réigiún an ghearrthóige i bpicteilíní.

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

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.

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