Ekrāns#

Ievads#

Screen metodes kontrolē, kā EXP Brain ekrānā rāda tekstu, skaitļus un grafiku.

Pēc noklusējuma fonts drukāšanai uz Brain ir vienas atstarpes mazs, kam ir 7 rindas un 20 kolonnas.

Zīmēšanai smadzeņu izšķirtspēja ir 159 x 107 pikseļi.

VEX Brain ekrāna marķēta režģa diagramma, kurā redzamas rindas, kolonnas, pikseļu izmēri un koordinātas, un sarkanās līnijas iezīmē režģi.

Zemāk ir pieejamo metožu saraksts:

Kursora drukāšana — attēlot tekstu un pārvaldīt drukāšanas kursoru.

  • print – Izdrukā tekstu, skaitļus vai mainīgo vērtības pašreizējā kursora pozīcijā.

  • print_at – Izdrukā tekstu, skaitļus vai mainīgo vērtības noteiktās x un y koordinātēs.

  • set_cursor – Pārvieto kursoru uz noteiktu rindu un kolonnu.

  • set_origin – Iestata sākumpunktu, kas tiek izmantots uz koordinātām balstītai drukāšanai un zīmēšanai.

  • next_row – Pārvieto kursoru uz nākamo rindu.

  • clear_row – Notīra teksta rindu.

  • row rinda — atgriež rindu, kurā tiks drukāts teksts.

  • column – Atgriež kolonnu, kurā tiks drukāts teksts.

  • get_string_width – Atgriež virknes platumu pikseļos, izmantojot pašreizējo fontu.

  • get_string_height – Atgriež virknes augstumu pikseļos, izmantojot pašreizējo fontu.

Mutatori — maina ekrāna iestatījumus, krāsas un zīmēšanas uzvedību.

  • clear_screen – Notīra visus zīmējumus un tekstu no smadzeņu ekrāna.

  • set_font – Iestata fonta veidu, kas tiek izmantots teksta drukāšanai Brain ekrānā.

  • set_pen_width – Iestata zīmēto līniju un formu kontūru biezumu.

  • set_pen_color – Iestata teksta, pikseļu, līniju un formu kontūru krāsu.

  • set_fill_color – Iestata aizpildījuma krāsu zīmētām formām un drukāta teksta foniem.

Zīmēt — veidojiet formas, līnijas un grafiku Brain ekrānā.

  • draw_pixel – Uzzīmē vienu pikseli koordinātā.

  • draw_line – Novelk līniju starp diviem punktiem.

  • draw_rectangle – Zīmē taisnstūri, izmantojot pašreizējās pildspalvas un aizpildījuma krāsas.

  • draw_circle – Zīmē apli, izmantojot pašreizējo pildspalvas un aizpildījuma krāsas.

  • draw_image_from_file – Izvelk attēlu no SD kartes.

  • render – Pārslēdz zīmēšanu uz dubulto buferizāciju un renderē Brain ekrānu.

  • set_clip_region – Iestata klipa reģionu norādītā taisnstūra zīmēšanai.

Kursora drukāšana#

print#

print izdrukā tekstu, skaitļus vai mainīgo vērtības Brain ekrānā pašreizējā kursora pozīcijā un ar izvēlēto fontu.

Lietojums:

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

Parametri

Apraksts

text

Izdrukājamais teksts, skaitlis vai mainīgā vērtība.

sep

Neobligāti. Virkne, kas jāievieto starp vērtībām. Tā jāraksta kā atslēgvārda arguments (sep=). Noklusējuma vērtība ir “”.

precision

Neobligāti. Decimālzīmju skaits, kas jāparāda, drukājot vienkāršus skaitļus. Tas jāraksta kā atslēgvārda arguments (precision=). Noklusējuma vērtība ir 2.

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

Ekrānuzņēmums ar EXP Brain, kurā redzams uzraksts "Hello Robot".

# 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 pārvieto kursoru uz noteiktu rindu un kolonnu Brain ekrānā. Nākamais print izsaukums sāks drukāšanu šajā vietā. Rindu un kolonnu atstarpe ņems vērā izvēlēto fontu. Noklusējuma kursora pozīcija ir 1. rinda, 1. kolonna.

Lietojums:

brain.screen.set_cursor(row, column)

Parametri

Apraksts

row

Rinda, uz kuru jāpārvieto kursors.

column

Kolonna, uz kuru jāpārvieto kursors.

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

EXP smadzeņu ekrānuzņēmums, kurā redzams uz ekrāna uzraksts "R3, C10".

set_origin#

set_origin iestata sākumpunktu, kas tiek izmantots zīmēšanai un uz koordinātām balstītai drukāšanai Brain ekrānā. Pēc noklusējuma sākumpunkts ir ekrāna augšējais kreisais stūris.

Lietojums:

brain.screen.set_origin(x, y)

Parametri

Apraksts

x

Sākotnes x pozīcija attiecībā pret augšējo kreiso stūri no 0 līdz 159.

y

Sākotnes y pozīcija attiecībā pret augšējo kreiso stūri no 0 līdz 107.

next_row#

next_row pārvieto kursoru uz 1. kolonnu nākamajā rindā Brain ekrānā.

Lietojums:

brain.screen.next_row()

Parametri

Apraksts

Šai metodei nav parametru.

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

EXP Brain ekrānuzņēmums, kurā 3. rindā redzams teksts "3".

clear_row#

clear_row notīra vienu teksta rindu Brain ekrānā.

Lietojums:

brain.screen.clear_row(row)

Parametri

Apraksts

row

Neobligāti. Rinda, kas jātīra. Noklusējuma vērtība ir pašreizējā kursora rinda.

color

Neobligāti. Derīgs ColorType (krāsas tips), heksadecimālvērtība vai tīmekļa virkne.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Varat arī norādīt pielāgotu krāsu.

# 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  rinda atgriež rindu, kurā teksts tiks drukāts kā vesels skaitlis.

Lietojums:

brain.screen.row()

Parametri

Apraksts

Šai metodei nav parametru.

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

EXP Brain ekrānuzņēmums, kurā 3. rindā redzams teksts "3".

column#

column atgriež kolonnu, kurā teksts tiks drukāts kā vesels skaitlis.

Lietojums:

brain.screen.column()

Parametri

Apraksts

Šai metodei nav parametru.

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

EXP Brain ekrānuzņēmums, kurā 10. kolonnā redzams teksts "10".

get_string_width#

get_string_width atgriež virknes platumu pikseļos kā veselu skaitli, izmantojot pašreizējo font.

Lietojums:

brain.screen.get_string_width(string)

Parametri

Apraksts

string

Mērāmā aukla.

get_string_height#

get_string_height atgriež virknes augstumu pikseļos kā veselu skaitli, izmantojot pašreizējo font.

Lietojums:

brain.screen.get_string_height(string)

Parametri

Apraksts

string

Mērāmā aukla.

Mutatori#

clear_screen#

clear_screen notīra visus zīmējumus un tekstu no smadzeņu ekrāna.

Lietojums:

brain.screen.clear_screen(color)

Parametri

Apraksts

color

Neobligāti. Derīgs ColorType (krāsas tips), heksadecimālvērtība vai tīmekļa virkne.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Varat arī norādīt pielāgotu krāsu.

# 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 iestata fontu, kas tiek izmantots teksta attēlošanai Brain ekrānā. Šis fonts tiks lietots visam tekstam, kas tiks izdrukāts pēc šīs metodes izpildes.

Lietojums:

brain.screen.set_font(fontname)

Parametri

Apraksts

fontname

The font size (examples below):

  • MONO12
  • MONO15
  • MONO20
  • MONO30
  • MONO40
  • MONO60
  • PROP20
  • PROP30
  • PROP40
  • PROP60
Note: Extra small and small sizes are not available for proportional fonts.

Smadzeņu ekrāns izdrukāja ciparus un burtus ar MONO 12 fonta izmēru. Tas rāda no A līdz Z un visus ciparus. Ekrāna apakšdaļā ir rakstīts 9 rindas, 26 kolonnas.
MONO12

Smadzenes ekrānā drukāja ciparus un burtus ar MONO 15 fonta izmēru. Tas rāda no A līdz T un visus ciparus. Ekrāna apakšdaļā ir rakstīts 7 rindas, 22 kolonnas.
MONO15

Smadzenes ekrānā drukāja ciparus un burtus ar MONO 20 fonta izmēru. Tas rāda no A līdz P un visus ciparus. Ekrāna apakšdaļā ir rakstīts 5 rindas, 16 kolonnas.
MONO20

Smadzenes ekrānā drukāja ciparus un burtus ar MONO 30 fonta izmēru. Tas rāda no A līdz J. Ekrāna apakšdaļā ir rakstīts R:3 C:10.
MONO30

Smadzenes ekrānā drukāja ciparus un burtus ar MONO 40 fonta izmēru. Ekrāna apakšdaļā ir rakstīts R:2 C:8.
MONO40

Smadzenes sietspiedē attēloja ciparus un burtus ar fonta izmēru MONO 60. Tiek parādīts tikai MON60.
MONO60

Smadzenes ekrānā izdrukāja ciparus un burtus ar PROP 20 fonta izmēru. Tas rāda no A līdz W un visus ciparus. Ekrāna apakšdaļā ir rakstīts 5 rindas, 16 kolonnas.
PROP20

Smadzenes ekrānā drukāja ciparus un burtus ar PROP 30 fonta izmēru. Tas rāda no A līdz P. Ekrāna apakšdaļā ir rakstīts R:3 C:10.
PROP30

Smadzenes ekrānā izdrukāja ciparus un burtus ar PROP 40 fonta izmēru. Ekrāna apakšdaļā ir rakstīts R:2 C:8.
PROP40

Smadzeņu sietspiedes cipari un burti ar fonta izmēru PROP 60. Tiek parādīts tikai PROP60.
PROP60

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

EXP smadzeņu ekrānuzņēmums, kurā teksts "VEX" ir lielākā fontā nekā noklusējuma fonts.

set_pen_width#

set_pen_width nosaka zīmēto līniju un formu kontūru biezumu.

Lietojums:

brain.screen.set_pen_width(width)

Parametri

Apraksts

width

Pildspalvas platums pikseļos no 0 līdz 32.

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

EXP Brain ekrānuzņēmums, kurā redzams taisnstūris ar biezām apmalēm.

set_pen_color#

set_pen_color iestata teksta, pikseļu, līniju un formu kontūru krāsu.

Lietojums:

brain.screen.set_pen_color(color)

Parametri

Apraksts

color

The pen and font color to use. This can be a valid ColorType, a hex value, or a web string.

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

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

EXP Brain ekrānuzņēmums, kurā redzams taisnstūris ar oranžām apmalēm.

# 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 iestata aizpildījuma krāsu, ko izmanto taisnstūru un apļu zīmēšanai.

Lietojums:

brain.screen.set_fill_color(color)

Parametri

Apraksts

color

Izmantojamā aizpildījuma krāsa. Tā var būt derīga ColorType vērtība, heksadecimālvērtība vai tīmekļa virkne.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Varat arī norādīt pielāgotu krāsu.

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

EXP smadzeņu ekrānuzņēmums, kurā redzams taisnstūris, kas aizpildīts ar violetu krāsu.

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

Zīmēt#

draw_pixel#

draw_pixel uzzīmē vienu pikseli atlasītajā x un y koordinātā, izmantojot pašreizējo pildspalvas krāsu.

Lietojums:

brain.screen.draw_pixel(x, y)

Parametri

Apraksts

x

X koordināta pikseļa zīmēšanai no 0 līdz 159, atsaucoties uz ekrāna sākumpunktu.

y

Y koordināta pikseļa zīmēšanai no 0 līdz 107, atsaucoties uz ekrāna sākumpunktu.

# 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 smadzeņu ekrānuzņēmums, kurā redzams pikseļu klāsts, kas attēlo kvadrāta stūrus.

draw_line#

draw_line zīmē līniju no pirmās ekrāna koordinātas (x1, y1) līdz otrajai ekrāna koordinātai (x2, y2) , izmantojot pašreizējos pildspalvas platumu un pildspalvas krāsu.

Lietojums:

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

Parametri

Apraksts

x1

Līnijas sākuma x koordināta pikseļos no 0 līdz 159, atsaucoties uz ekrāna sākumpunktu.

y1

Līnijas sākuma y koordināta pikseļos no 0 līdz 107, atsaucoties uz ekrāna sākumpunktu.

x2

Līnijas beigu x koordināta pikseļos no 0 līdz 159, atsaucoties uz ekrāna sākumpunktu.

y2

Līnijas beigu y koordināta pikseļos no 0 līdz 107, atsaucoties uz ekrāna sākumpunktu.

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

Smadzeņu ekrānā redzama plāna diagonāla līnija pāri centram no augšējā kreisā stūra līdz apakšējam labajam stūrim.

draw_rectangle#

draw_rectangle zīmē taisnstūri, izmantojot pašreizējos pen width, pen color un fill color, ja vien netiek izmantots papildu color parametrs.

Lietojums:

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

Parametri

Apraksts

x

Taisnstūra augšējā kreisā stūra x koordināta pikseļos no 0 līdz 159, atsaucoties uz ekrāna sākumpunktu.

y

Taisnstūra augšējā kreisā stūra y koordināta pikseļos no 0 līdz 107, atsaucoties uz ekrāna sākumpunktu.

width

Taisnstūra platums.

height

Taisnstūra augstums.

color

Neobligāti. Derīgs ColorType (krāsas tips), heksadecimālvērtība vai tīmekļa virkne.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Varat arī norādīt pielāgotu krāsu.

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

Smadzeņu ekrānā ir redzams taisnstūris ar plānu baltu apmali.

# 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 zīmē apli, izmantojot pašreizējos pen width, pen color un fill color, ja vien netiek izmantots papildu color parametrs.

Lietojums:

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

Parametri

Apraksts

x

Apļa centra x koordināta pikseļos no 0 līdz 159, atsaucoties uz ekrāna sākumpunktu.

y

Apļa centra y koordināta pikseļos no 0 līdz 107, atsaucoties uz ekrāna sākumpunktu.

radius

Apļa rādiuss.

color

Neobligāti. Derīgs ColorType (krāsas tips), heksadecimālvērtība vai tīmekļa virkne.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Varat arī norādīt pielāgotu krāsu.

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

Smadzeņu ekrānā redzams aplis ar plānu baltu apmali centrā.

# 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 izvelk attēlu no SD kartes. Faila nosaukumam, ko norādāt, izsaucot metodi, ir jāatrodas SD kartē.

Lietojums:

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

Parametri

Apraksts

filename

Attēla faila nosaukums.

x

Attēla augšējā kreisā stūra x koordināta ekrānā.

y

Attēla augšējā kreisā stūra y koordināta ekrānā.

# 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 pārslēdz zīmēšanu uz dubulto buferizāciju un renderē Brain ekrānu. Pēc izsaukšanas turpmāka zīmēšana Brain ekrānā neparādīsies līdz nākamajai reizei, kad tiks izsaukta render.

  • True , ja buferis tika veiksmīgi atveidots ekrānā.

  • False , ja buferis netika veiksmīgi atveidots ekrānā.

Lietojums:

brain.screen.render()

Parametri

Apraksts

Šai metodei nav parametru.

set_clip_region#

set_clip_region definē taisnstūrveida apgabalu ekrānā, kurā tiks ierobežoti visi zīmējumi un teksts. Jebkāds saturs ārpus šī apgabala netiks parādīts.

Lietojums:

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

Parametri

Apraksts

x

Taisnstūra augšējā kreisā stūra x pozīcija, atsaucoties uz ekrāna sākumpunktu.

y

Taisnstūra augšējā kreisā stūra y pozīcija, atsaucoties uz ekrāna sākumpunktu.

width

Taisnstūra platums.

height

Taisnstūra augstums.