Ekranas#

Įvadas#

„Screen“ metodai kontroliuoja, kaip EXP Brain ekrane rodo tekstą, skaičius ir grafiką.

Pagal numatytuosius nustatymus, „Brain“ spausdinimui naudojamas šriftas yra mažas vieno tarpo, turintis 7 eilutes ir 20 stulpelių.

Piešimui smegenų skiriamoji geba yra 159 x 107 pikselių.

Pažymėta „VEX Brain“ ekrano tinklelio diagrama, kurioje rodomos eilutės, stulpeliai, pikselių matmenys ir koordinatės, o raudonos linijos apibrėžia tinklelį.

Žemiau pateikiamas galimų metodų sąrašas:

Žymeklio spausdinimas – rodyti tekstą ir valdyti spausdinimo žymeklį.

  • print – Spausdina tekstą, skaičius arba kintamųjų reikšmes dabartinėje žymeklio padėtyje.

  • print_at – Spausdina tekstą, skaičius arba kintamųjų reikšmes konkrečiose x ir y koordinatėse.

  • set_cursor – Perkelia žymeklį į konkrečią eilutę ir stulpelį.

  • set_origin – Nustato koordinatėmis pagrįsto spausdinimo ir piešimo pradžios tašką.

  • next_row – Perkelia žymeklį į kitą eilutę.

  • clear_row – Išvalo teksto eilutę.

  • row – Grąžina eilutę, kurioje bus spausdinamas tekstas.

  • column – Grąžina stulpelį, kuriame bus spausdinamas tekstas.

  • get_string_width – Grąžina eilutės plotį pikseliais, naudojant dabartinį šriftą.

  • get_string_height – Grąžina eilutės aukštį pikseliais, naudojant dabartinį šriftą.

Mutatoriai – keičia ekrano nustatymus, spalvas ir piešimo elgseną.

  • clear_screen – Išvalo visus piešinius ir tekstą iš smegenų ekrano.

  • set_font – Nustato šrifto tipą, naudojamą tekstui spausdinti smegenų ekrane.

  • set_pen_width – Nustato nubrėžtų linijų ir formos kontūrų storį.

  • set_pen_color – Nustato teksto, pikselių, linijų ir figūrų kontūrų spalvą.

  • set_fill_color – Nustato nupieštų formų ir spausdinto teksto fonų užpildymo spalvą.

Pieškite – kurkite formas, linijas ir grafiką „Brain“ ekrane.

  • draw_pixel – Nubraižo vieną pikselį koordinatėje.

  • draw_line – Nubrėžia liniją tarp dviejų taškų.

  • draw_rectangle – Nubrėžia stačiakampį naudodamas dabartines rašiklio ir užpildymo spalvas.

  • draw_circle – Nubrėžia apskritimą naudodamas dabartinį rašiklį ir užpildymo spalvas.

  • draw_image_from_file – Nukopijuoja vaizdą iš SD kortelės.

  • render – Perjungia piešimą į dvigubą buferį ir atvaizduoja smegenų ekraną.

  • set_clip_region – Nustato iškirpimo sritį, skirtą pateiktam stačiakampiui piešti.

Žymeklio spausdinimas#

print#

print spausdina tekstą, skaičius arba kintamųjų reikšmes „Brain“ ekrane dabartinėje žymeklio padėtyje ir tuo pačiu šriftu.

Naudojimas:

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

Parametrai

Aprašymas

text

Tekstas, skaičius arba kintamoji reikšmė, kurią reikia spausdinti.

sep

Pasirinktinai. Eilutė, įterpiama tarp reikšmių. Ji turi būti parašyta kaip raktinio žodžio argumentas (sep=). Numatytoji reikšmė yra “”.

precision

Pasirinktinai. Dešimtainių vietų skaičius, rodomas spausdinant paprastus skaičius. Tai turi būti parašyta kaip raktinio žodžio argumentas (precision=). Numatytoji reikšmė yra 2.

 
brain.screen.print("Hello, Robot!")

EKRANO kopija, kurioje matyti EXP smegenų modulis ir užrašas „Labas, robotas“.

# Print the number 1 on the Brain's screen at current
# cursor position.
brain.screen.print(1)

# Print the numbers 1, 2, 3 and 4 on the Brain's screen at
# current cursor position separated by a '-'.
brain.screen.print(1, 2, 3, 4, sep='-')

set_cursor#

set_cursor perkelia žymeklį į konkrečią eilutę ir stulpelį „Brain“ ekrane. Kitas print iškvietimas pradės spausdinti toje vietoje. Eilučių ir stulpelių tarpai bus nustatomi atsižvelgiant į pasirinktą šriftą. Numatytoji žymeklio padėtis yra 1 eilutė, 1 stulpelis.

Naudojimas:

brain.screen.set_cursor(row, column)

Parametrai

Aprašymas

row

Eilutė, į kurią reikia perkelti žymeklį.

column

Stulpelis, į kurį reikia perkelti žymeklį.

 
# Display text starting at Row 3 Column 10.
brain.screen.set_cursor(3, 10)
brain.screen.print("R3, C10")

! EKRANO kopija, kurioje matyti EXP smegenų sritis, kurioje ekrane atspausdinta „R3, C10“.

set_origin#

set_origin nustato pradžios tašką, naudojamą piešimui ir spausdinimui pagal koordinates „Brain“ ekrane. Pagal numatytuosius nustatymus pradžios taškas yra viršutinis kairysis ekrano kampas.

Naudojimas:

brain.screen.set_origin(x, y)

Parametrai

Aprašymas

x

Pradinės taško x padėtis viršutinio kairiojo kampo atžvilgiu nuo 0 iki 159.

y

Pradinės taško y padėtis viršutinio kairiojo kampo atžvilgiu nuo 0 iki 107.

next_row#

next_row perkelia žymeklį į 1 stulpelį kitoje eilutėje smegenų ekrane.

Naudojimas:

brain.screen.next_row()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

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

! „EXP Brain“ ekrano kopija, kurioje 3 eilutėje rodomas tekstas „3“.

clear_row#

clear_row išvalo vieną teksto eilutę „Brain“ ekrane.

Naudojimas:

brain.screen.clear_row(row)

Parametrai

Aprašymas

row

Pasirinktinai. Eilutė, kurią reikia išvalyti. Numatytoji reikšmė yra dabartinė žymeklio eilutė.

color

Pasirinktinai. Galiojantis „ColorType“ (spalvos tipas), šešioliktainė reikšmė arba žiniatinklio eilutė.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Taip pat galite nurodyti pasirinktinę spalvą.

 
# Clear Brain's screen to black.
brain.screen.clear_row()

# Clear Brain's screen to blue using predefined color.
brain.screen.clear_row(2, Color.BLUE)

row#

row grąžina eilutę, kurioje tekstas bus spausdinamas kaip sveikasis skaičius.

Naudojimas:

brain.screen.row()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

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

! „EXP Brain“ ekrano kopija, kurioje 3 eilutėje rodomas tekstas „3“.

column#

column grąžina stulpelį, kuriame tekstas bus spausdinamas kaip sveikasis skaičius.

Naudojimas:

brain.screen.column()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

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

! „EXP Brain“ ekrano kopija, kurioje 10 stulpelyje rodomas tekstas „10“.

get_string_width#

get_string_width grąžina eilutės plotį pikseliais kaip sveikąjį skaičių, naudojant dabartinį font.

Naudojimas:

brain.screen.get_string_width(string)

Parametrai

Aprašymas

string

Matuojama eilutė.

get_string_height#

get_string_height grąžina eilutės aukštį pikseliais kaip sveikąjį skaičių, naudojant dabartinį font.

Naudojimas:

brain.screen.get_string_height(string)

Parametrai

Aprašymas

string

Matuojama eilutė.

Mutatoriai#

clear_screen#

clear_screen išvalo visus piešinius ir tekstą iš smegenų ekrano.

Naudojimas:

brain.screen.clear_screen(color)

Parametrai

Aprašymas

color

Pasirinktinai. Galiojantis „ColorType“ (spalvos tipas), šešioliktainė reikšmė arba žiniatinklio eilutė.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Taip pat galite nurodyti pasirinktinę spalvą.

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

# Clear screen to black.
brain.screen.clear_screen()

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

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

set_font#

set_font nustato šriftą, naudojamą tekstui rodyti „Brain“ ekrane. Šis šriftas bus taikomas visam tekstui, atspausdintam paleidus šį metodą.

Naudojimas:

brain.screen.set_font(fontname)

Parametrai

Aprašymas

fontname

Šrifto dydis (pavyzdžiai pateikti žemiau):

  • MONO12
  • MONO15
  • MONO20
  • MONO30
  • MONO40
  • MONO60
  • PROP20
  • PROP30
  • PROP40
  • PROP60
Pastaba: Proporcingiems šriftams negalimi labai maži ir labai maži dydžiai.

Smegenų ekrane atspausdinti skaičiai ir raidės MONO 12 dydžio šriftu. Rodomi skaičiai nuo A iki Z ir visi skaičiai. Ekrano apačioje parašyta 9 eilutės, 26 stulpeliai.
MONO12

Smegenų ekrane atspausdinti skaičiai ir raidės MONO 15 dydžio šriftu. Rodomi skaičiai nuo A iki T. Ekrano apačioje parašyta 7 eilutės, 22 stulpeliai.
MONO15

Smegenų ekrane atspausdinti skaičiai ir raidės MONO 20 dydžio šriftu. Rodomi raidės nuo A iki P ir visi skaičiai. Ekrano apačioje parašyta 5 eilutės, 16 stulpelių.
MONO20

Smegenų ekrane atspausdinti skaičiai ir raidės MONO 30 dydžio šriftu. Rodomos raidės nuo A iki J. Ekrano apačioje parašyta R:3 C:10.
MONO30

Smegenų ekrane atspausdino skaičius ir raides MONO 40 dydžio šriftu. Ekrano apačioje parašyta R:2 C:8.
MONO40

Smegenys ekrane atspausdino skaičius ir raides MONO 60 dydžio šriftu. Rodomas tik MON60.
MONO60

Smegenys ekrane atspausdino skaičius ir raides PROP 20 dydžio šriftu. Rodomi raidės nuo A iki W ir visi skaičiai. Ekrano apačioje parašyta 5 eilutės, 16 stulpelių.
PROP20

Smegenų ekrane atspausdinti skaičiai ir raidės PROP 30 dydžio šriftu. Rodomos raidės nuo A iki P. Ekrano apačioje parašyta R:3 C:10.
PROP30

Smegenų ekrane atspausdinti skaičiai ir raidės PROP 40 dydžio šriftu. Ekrano apačioje parašyta R:2 C:8.
PROP40

Smegenų ekrane atspausdinti skaičiai ir raidės PROP 60 dydžio šriftu. Rodomas tik PROP60.
PROP60

 

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

! „EXP Brain“ ekrano kopija, kurioje tekstas „VEX“ rodomas didesniu šriftu nei numatytasis.

set_pen_width#

set_pen_width nustato nubrėžtų linijų ir formos kontūrų storį.

Naudojimas:

brain.screen.set_pen_width(width)

Parametrai

Aprašymas

width

Rašiklio plotis pikseliais nuo 0 iki 32.

 
# Draw a rectangle with a pen width of 10.
brain.screen.set_pen_width(10)
brain.screen.draw_rectangle(20, 20, 75, 50)

Ekrano kopija, kurioje matyti stačiakampis su storais kraštais, EXP Brain.

set_pen_color#

set_pen_color nustato teksto, pikselių, linijų ir figūrų kontūrų spalvą.

Naudojimas:

brain.screen.set_pen_color(color)

Parametrai

Aprašymas

color

Naudojama rašiklio ir šrifto spalva. Tai gali būti galiojantis „ColorType“ (spalvos tipas), šešioliktainė reikšmė arba žiniatinklio eilutė.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Taip pat galite nurodyti pasirinktinę spalvą.

 
# Draw a rectangle with orange borders.
brain.screen.set_pen_color(Color.ORANGE)
brain.screen.draw_rectangle(20, 20, 75, 50)

Ekrano kopija, kurioje matyti stačiakampis su oranžiniais rėmeliais, EXP Brain.

# Set pen color red using a hex value.
brain.screen.set_pen_color(0xFF0000)

# Set pen color blue using predefined color.
brain.screen.set_pen_color(Color.BLUE)

# Set pen color green using web string.
brain.screen.set_pen_color("#00FF00")

set_fill_color#

set_fill_color nustato užpildymo spalvą, naudojamą stačiakampiams ir apskritimams piešti.

Naudojimas:

brain.screen.set_fill_color(color)

Parametrai

Aprašymas

color

Naudojama užpildymo spalva. Tai gali būti galiojantis „ColorType“ (spalvos tipas), šešioliktainė reikšmė arba žiniatinklio eilutė.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Taip pat galite nurodyti pasirinktinę spalvą.

 
# Draw a purple rectangle.
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(20, 20, 75, 50)

EXP smegenų ekrano kopija, kurioje matyti violetine spalva užpildytas stačiakampis.

# Set fill color red using a hex value.
brain.screen.set_fill_color(0xFF0000)

# Set fill color blue using predefined color.
brain.screen.set_fill_color(Color.BLUE)

# Set fill color green using web string.
brain.screen.set_fill_color("#00FF00")

Piešti#

draw_pixel#

draw_pixel nupiešia vieną pikselį pasirinktose x ir y koordinatėse, naudodamas dabartinę rašiklio spalvą.

Naudojimas:

brain.screen.draw_pixel(x, y)

Parametrai

Aprašymas

x

Pikselio piešimo x koordinatė nuo 0 iki 159, atsižvelgiant į ekrano pradžios tašką.

y

Y koordinatė pikseliui nuo 0 iki 107 nubrėžti, atsižvelgiant į ekrano pradžios tašką.

 
# Draw the pixels marking the corners of a square.
brain.screen.draw_pixel(50, 50)
brain.screen.draw_pixel(50, 75)
brain.screen.draw_pixel(75, 50)
brain.screen.draw_pixel(75, 75)

EXP smegenų ekrano kopija, kurioje matyti kvadrato kampus vaizduojančių pikselių rinkinys.

draw_line#

draw_line nubrėžia liniją nuo pirmosios ekrano koordinatės (x1, y1) iki antrosios ekrano koordinatės (x2, y2) naudodama dabartinius pen width ir pen color parametrus.

Naudojimas:

brain.screen.draw_line(x1, y1, x2, y2)

Parametrai

Aprašymas

x1

Linijos pradžios x koordinatė pikseliais nuo 0 iki 159, atsižvelgiant į ekrano pradžią.

y1

Linijos pradžios y koordinatė pikseliais nuo 0 iki 107, atsižvelgiant į ekrano pradžią.

x2

Linijos pabaigos x koordinatė pikseliais nuo 0 iki 159, atsižvelgiant į ekrano pradžią.

y2

Linijos pabaigos y koordinatė pikseliais nuo 0 iki 107, atsižvelgiant į ekrano pradžią.

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

Smegenų ekrane rodoma plona įstriža linija per centrą, nuo viršutinio kairiojo kampo iki apatinio dešiniojo kampo.

draw_rectangle#

draw_rectangle nubrėžia stačiakampį naudodamas dabartines pen width, pen color ir fill color reikšmes, nebent naudojamas pasirenkamas color parametras.

Naudojimas:

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

Parametrai

Aprašymas

x

Stačiakampio viršutinio kairiojo kampo x koordinatė pikseliais nuo 0 iki 159, atsižvelgiant į ekrano pradžios tašką.

y

Stačiakampio viršutinio kairiojo kampo y koordinatė pikseliais nuo 0 iki 107, atsižvelgiant į ekrano pradžios tašką.

width

Stačiakampio plotis.

height

Stačiakampio aukštis.

color

Pasirinktinai. Galiojantis „ColorType“ (spalvos tipas), šešioliktainė reikšmė arba žiniatinklio eilutė.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Taip pat galite nurodyti pasirinktinę spalvą.

 
# Draw a rectangle on the screen.
brain.screen.draw_rectangle(20, 20, 80, 30)

Smegenų ekrane rodomas stačiakampis su plonu baltu apvadu.

# Draw a green rectangle on the screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_rectangle(10, 10, 20, 20)

# Draw a green rectangle on the screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_rectangle(50, 50, 20, 20, Color.RED)

draw_circle#

draw_circle nubrėžia apskritimą naudodamas dabartines pen width, pen color ir fill color reikšmes, nebent naudojamas pasirenkamas color parametras.

Naudojimas:

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

Parametrai

Aprašymas

x

Apskritimo centro x koordinatė pikseliais nuo 0 iki 159, atsižvelgiant į ekrano pradžios tašką.

y

Apskritimo centro y koordinatė pikseliais nuo 0 iki 107, atsižvelgiant į ekrano pradžios tašką.

radius

Apskritimo spindulys.

color

Pasirinktinai. Galiojantis „ColorType“ (spalvos tipas), šešioliktainė reikšmė arba žiniatinklio eilutė.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Taip pat galite nurodyti pasirinktinę spalvą.

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

Smegenų ekrane rodomas apskritimas su plonu baltu apvadu centre.

# Draw a green circle on the Brain's screen that is filled using blue.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.set_fill_color(Color.BLUE)
brain.screen.draw_circle(50, 50, 10)

# Draw a green circle on the Brain's screen that is filled using red.
brain.screen.set_pen_color(Color.GREEN)
brain.screen.draw_circle(100, 50, 10, Color.RED)

draw_image_from_file#

draw_image_from_file iš SD kortelės ištraukia vaizdą. Failo pavadinimas, kurį nurodote iškviečiant metodą, turi būti SD kortelėje.

Naudojimas:

brain.screen.draw_image_from_file(filename, x, y)

Parametrai

Aprašymas

filename

Vaizdo failo pavadinimas.

x

Viršutinio kairiojo vaizdo kampo ekrane x koordinatė.

y

Viršutinio kairiojo vaizdo kampo ekrane y koordinatė.

 
# Draw the vex.bmp image on the Brain's screen at coordinate 0, 0.
brain.screen.draw_image_from_file('vex.bmp', 0, 0)

render#

render perjungia piešimą į dvigubą buferį ir atvaizduoja smegenų ekraną. Iškvietus, tolesnis piešimas smegenų ekrane nebus rodomas tol, kol nebus iškviestas render.

  • True , jei buferis buvo sėkmingai perteiktas ekrane.

  • False , jei buferis nebuvo sėkmingai atvaizduotas ekrane.

Naudojimas:

brain.screen.render()

Parametrai

Aprašymas

Šis metodas neturi parametrų.

set_clip_region#

set_clip_region apibrėžia stačiakampę ekrano sritį, kurioje bus visi piešiniai ir tekstas. Turinys už šios srities ribų nebus rodomas.

Naudojimas:

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

Parametrai

Aprašymas

x

Stačiakampio viršutinio kairiojo kampo x padėtis, atsižvelgiant į ekrano pradžios tašką.

y

Stačiakampio viršutinio kairiojo kampo y padėtis, atsižvelgiant į ekrano pradžios tašką.

width

Stačiakampio plotis.

height

Stačiakampio aukštis.
On this page