Ekrāns

Ievads

Ekrāna metodes kontrolē, kā V5 Brain skārienekrānā rāda tekstu, skaitļus un grafiku un kā tas reaģē uz skārienvadi.

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

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

Zemāk ir visu metožu saraksts:

Kursora drukāšana — ievietojiet un izdrukājiet tekstu.

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

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

• next_row — Pārvieto kursoru uz nākamās rindas 1. kolonnu.

• clear_row — Notīra teksta rindu.

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

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

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

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

• clear_line — Notīra teksta rindiņu.

• new_line — Pārvieto kursoru uz jaunu rindu.

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

• clear_screen — Notīra ekrānu no visiem zīmējumiem un teksta.

• set_font — Iestata drukātā teksta fontu.

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

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

Zīmēt — pievienot ekrānam grafiku.

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

• draw_line — Novelk līniju starp diviem punktiem.

• draw_rectangle — Uzzīmē taisnstūri.

• draw_circle — Uzzīmē apli.

• render — Atjaunina smadzeņu ekrānu ar tekstu un zīmējumiem tikai tad, kad tas tiek izsaukts.

• set_clip_region — Ierobežo, kur var parādīties zīmējumi un teksts.

Getteri — pārbaudiet skāriena stāvokli un pozīciju.

• pressing — Atgriež, vai tiek nospiests ekrāns.

• x_position — Atgriež pēdējās ekrāna nospiešanas x koordinātu.

• y_position — Atgriež pēdējās ekrāna nospiešanas y koordinātu.

Atzvanīšanas funkcijas — reaģēt uz skāriena notikumiem ekrānā.

• pressed — Reģistrē funkciju, kas tiks izsaukta, nospiežot ekrānu.

• released — Reģistrē funkciju, kas tiks izsaukta, atlaižot ekrānu.

Informāciju par Brain konstruēšanu, lai piekļūtu screen metodēm, skatiet Brain.

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.

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

set_cursor

set_cursor pārvieto kursoru uz konkrētu rindu un kolonnu Brain ekrānā. Nākamais print izsaukums sāks drukāt šajā vietā. Cik rindu un kolonnu var ērti ievietot, ir atkarīgs no izvēlētā fonta. Ar noklusējuma vienrindu vidējo fontu var skaidri parādīt līdz 8 rindām un 13 kolonnām. Teksts, kas novietots ārpus šī diapazona, var tikt nogriezts vai kļūt grūti lasāms.

Vienrindas fontiem ir vienāda platuma rakstzīmes, padarot teksta izvietojumu vienmērīgu. Turpretī proporcionālajiem fontiem ir atšķirīgs rakstzīmju platums, tāpēc daži burti aizņem vairāk vietas nekā citi. Tomēr neatkarīgi no izmantotā tipa, set_cursor pozicionē kursoru, pamatojoties uz rindas un kolonnas lielumu, nevis fonta stilu. Fonta lielumu var pielāgot, izmantojot set_font.

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

next_row

next_row pārvieto kursoru uz nākamo rindu.

Lietojums:

brain.screen.next_row()

Parametri	Apraksts
	Šai metodei nav parametru.

# 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 notīra vienu teksta rindu Brain ekrānā.

Lietojums:

brain.screen.clear_row(row, color)

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īga color, heksadecimāla vērtība vai tīmekļa virkne.

# 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  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, 2)
brain.screen.print(brain.screen.row())

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, 15)
brain.screen.print(brain.screen.column())

print_at

print_at izdrukā tekstu, skaitļus vai mainīgo vērtības Brain ekrānā noteiktās x un y koordinātēs ar pašreizējo font un origin.

Lietojums:

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

Parametri	Apraksts
text	Izdrukājamais teksts, skaitlis vai mainīgā vērtība.
x	X koordināta, kas jāizdrukā kā atslēgvārda arguments (x=), atsaucoties uz ekrāna sākumpunktu.
y	Y koordināta, kas jāizdrukā kā atslēgvārda arguments (y=), atsaucoties uz ekrāna sākumpunktu.
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.
opaque	Neobligāti. Būla vērtība, kas norāda, vai tekstam ir jānotīra fona pikseļi. Noklusējuma vērtība ir True.

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

get_string_width

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

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

Usage:
brain.screen.get_string_height(string)

Parametri	Apraksts
string	Mērāmā aukla.

clear_line

clear_line notīra pašreizējo teksta rindu.

Usage: brain.screen.clear_line()

Parametri	Apraksts
	Šai metodei nav parametru.

new_line

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

Lietojums:

brain.screen.new_line()

Parametri	Apraksts
	Šai metodei nav parametru.

Mutatori

clear_screen

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

Lietojums:

brain.screen.clear_screen(color)

Parametri	Apraksts
color	Neobligāti. Derīga krāsas opcija: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.BLACK (Noklusējums) 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

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

Parametri	Apraksts
font	Derīga fonta opcija zemāk.

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

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

Lietojums:

brain.screen.set_pen_width(value)

Parametri	Apraksts
value	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(50, 50, 130, 60)

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	Izmantojamā pildspalvas un fonta krāsa. Opcijas ietver: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Varat arī norādīt pielāgotu krāsu.

# 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 iestata aizpildījuma krāsu, kas tiek izmantota, zīmējot formas.

Lietojums:

brain.screen.set_fill_color(color)

Parametri	Apraksts
color	The fill color to use. Options include: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE You can also specify a custom color.

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

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	X koordināta, kas jāiestata kā sākumpunkts, no 0 līdz 479.
y	Y koordināta, kas jāiestata kā sākumpunkts, no 0 līdz 239.

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 479, atsaucoties uz ekrāna sākumpunktu.
y	Y koordināta pikseļa zīmēšanai no 0 līdz 239, atsaucoties uz ekrāna sākumpunktu.

# 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 zīmē līniju no pirmās ekrāna koordinātas līdz otrajai ekrāna koordinātai, izmantojot pašreizējo pildspalvas platumu un pildspalvas krāsu.

Lietojums:

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

Parametri	Apraksts
start_x	Līnijas sākuma x koordināta pikseļos no 0 līdz 479, atsaucoties uz ekrāna sākumpunktu.
start_y	Līnijas sākuma y koordināta pikseļos no 0 līdz 239, atsaucoties uz ekrāna sākumpunktu.
end_x	Līnijas beigu x koordināta pikseļos no 0 līdz 479, atsaucoties uz ekrāna sākumpunktu.
end_y	Līnijas beigu y koordināta pikseļos no 0 līdz 239, 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, 479, 239)

draw_rectangle

draw_rectangle zīmē taisnstūri, izmantojot pašreizējo pildspalvas platumu, pildspalvas krāsu un aizpildījuma krāsu, ja vien netiek izmantots papildu parametrs color.

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 479.
y	Taisnstūra augšējā kreisā stūra y koordināta pikseļos no 0 līdz 239.
width	Taisnstūra platums.
height	Taisnstūra augstums.
color	Neobligāti. Derīga krāsas opcija: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Varat arī norādīt pielāgotu krāsu.

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

draw_circle

draw_circle zīmē apli, izmantojot pašreizējo pildspalvas platumu, pildspalvas krāsu un aizpildījuma krāsu, ja vien netiek izmantots papildu parametrs color.

Lietojums:

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

Parametri	Apraksts
x	Apļa centra x koordināta pikseļos no 0 līdz 479, atsaucoties uz ekrāna sākumpunktu.
y	Apļa centra y koordināta pikseļos no 0 līdz 239, atsaucoties uz ekrāna sākumpunktu.
radius	Apļa rādiuss pikseļos.
color	Neobligāti. Izmantojamā aizpildījuma krāsa. Opcijas ietver: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Varat arī norādīt pielāgotu krāsu.

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

render

render iespējo dubultu buferizāciju Brain ekrānam. Pēc izsaukšanas visas zīmēšanas komandas (piemēram, teksts, formas vai attēli) vairs neparādīsies nekavējoties pārējā projektā. Tā vietā atjauninājumi tiks parādīti tikai tad, kad atkal tiks izmantota render Tas nodrošina vienmērīgākus un kontrolētākus ekrāna atjauninājumus, bet nozīmē, ka nekas nebūs redzams, kamēr netiks izmantota render.

Lietojums:

brain.screen.render()

Parametri	Apraksts
	Šai metodei nav parametru.

# 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

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.

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

Pieskāriens

pressing

Nospiežot pressing , tiek atgriezta Būla vērtība, kas norāda, vai pašlaik tiek nospiests Brain ekrāns.

• True  — tiek nospiests ekrāns.

• False  — ekrāns netiek nospiests.

Lietojums:

brain.screen.pressing()

Parametri	Apraksts
	Šai metodei nav parametru.

# 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

x_position atgriež pēdējā ekrāna nospiešanas x koordinātu kā veselu skaitli no 0 (pa kreisi) līdz 479 (pa labi).

Lietojums:

brain.screen.x_position()

Parametri	Apraksts
	Šai metodei nav parametru.

# 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

y_position atgriež pēdējā ekrāna nospiešanas y koordinātu kā veselu skaitli no 0 (augšā) līdz 239 (apakšā).

Lietojums:

brain.screen.y_position()

Parametri	Apraksts
	Šai metodei nav parametru.

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

Atzvanīšanas

pressed

Nospiests pressed reģistrē funkciju, kas tiks izsaukta, nospiežot Smadzeņu ekrānu.

Lietojums:

brain.screen.pressed(callback, arg)

Parametri	Apraksts
callback	Iepriekš definēta funkcija, kas tiek izpildīta, nospiežot pogu Brain ekrāns.
arg	Neobligāti. Tuple, kas satur argumentus, kas jānodod atzvanīšanas funkcijai. Plašāku informāciju skatiet sadaļā Funkciju izmantošana ar parametriem.

def my_function():
  brain.screen.print("Screen pressed")

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

released

released reģistrē funkciju, kas tiks izsaukta, kad ekrāns tiek atlaists (noņemts pieskāriens).

Lietojums:

brain.screen.released(callback, arg)

Parametri	Apraksts
callback	Iepriekš definēta funkcija, kas tiek izpildīta, kad tiek atbrīvots Brain ekrāns.
arg	Neobligāti. Tuple, kas satur argumentus, kas jānodod atzvanīšanas funkcijai. Plašāku informāciju skatiet sadaļā Funkciju izmantošana ar parametriem.

def my_function():
  brain.screen.print("Screen released")

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