Ekrāns#
Ievads#
Ekrāna metodes kontrolē, kā VEX AIM kodēšanas robots ekrānā rāda tekstu, skaitļus un grafiku un kā tas reaģē uz ekrāna nospiešanu.
Zemāk ir visu metožu saraksts:
Pieskāriens — ekrāna pieskārienu noteikšana un reaģēšana uz tiem.
pressing– Atgriež, vai ekrāns pašlaik tiek nospiests.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.
Kursora drukāšana — teksta attēlošana, izmantojot rindu/kolonnu sistēmu.
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.get_row– Atgriež pašreizējo kursora rindu.get_column– Atgriež pašreizējo kursora kolonnu.
XY drukāšana — attēlo tekstu noteiktā ekrāna koordinātā.
print_at– Izdrukā tekstu, skaitļus vai mainīgo vērtības noteiktā x un y koordinātā.set_origin– Iestata sākumpunktu, kas tiek izmantots uz koordinātām balstītai drukāšanai un zīmēšanai.
Mutatori — notīriet ekrānu vai atjauniniet vizuālos iestatījumus.
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.
Zīmēt — pievienojiet ekrānam grafiku un attēlus.
draw_pixel– Uzzīmē pikseli noteiktā x un y pozīcijā.draw_line– Novelk līniju starp diviem punktiem.draw_rectangle– Uzzīmē taisnstūri.draw_circle– Uzzīmē apli.show_file– Parāda augšupielādētu attēlu.set_clip_region– Ierobežo zīmējumu un teksta rādīšanas vietu.
Atzvanīšanas funkcijas — funkciju palaišana, nospiežot vai atlaižot ekrānu.
Pieskāriens#
pressing#
Nospiežot pressing , tiek atgriezta Būla vērtība, kas norāda, vai pašlaik tiek nospiests robota ekrāns.
True– Ekrāns tiek nospiests.False– Ekrāns netiek nospiests.
Usage:
robot.screen.pressing()
Parametri |
Apraksts |
|---|---|
Šai metodei nav parametru. |
# Turn LEDs white only while the screen is pressed.
while True:
if robot.screen.pressing():
robot.led.on(ALL_LEDS, WHITE)
else:
robot.led.off(ALL_LEDS)
wait(50, MSEC)
# Display different messages after the screen is pressed
while not robot.screen.pressing():
wait(5, MSEC)
robot.screen.print("First message!")
robot.screen.next_row()
# Lift finger to press the screen again
while robot.screen.pressing():
wait(5, MSEC)
while not robot.screen.pressing():
wait(5, MSEC)
robot.screen.print("Second message!")
robot.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 240 (pa labi).
Usage:robot.screen.x_position()
Parametri |
Apraksts |
|---|---|
Šai metodei nav parametru. |
# Display the x-coordinate of where
# the screen is pressed
while True:
if robot.screen.pressing():
robot.screen.clear_screen()
robot.screen.print(robot.screen.x_position())
wait (50, MSEC)
y_position#
y_position atgriež pēdējā ekrāna nospiešanas y koordinātu kā veselu skaitli no 0 (augšā) līdz 240 (apakšā).
Usage:robot.screen.y_position()
Parametri |
Apraksts |
|---|---|
Šai metodei nav parametru. |
# Display the y-coordinate of where
# the screen is pressed
while True:
if robot.screen.pressing():
robot.screen.clear_screen()
robot.screen.print(robot.screen.y_position())
wait (50, MSEC)
Kursora drukāšana#
print#
print izdrukā tekstu, skaitļus vai mainīgās vērtības robota ekrānā pašreizējā kursora pozīcijā un fontā.
Usage:robot.screen.print(text)
Parametri |
Apraksts |
|---|---|
|
Teksts, skaitlis vai mainīgā vērtība, kas jāparāda ekrānā. |
# Display a message at the starting cursor position
robot.screen.print("Hello, Robot!")

set_cursor#
set_cursor pārvieto teksta kursoru uz noteiktu rindu un kolonnu robota ekrānā. Nākamais print izsaukums sāks drukāšanu šajā vietā. Derīgo rindu un kolonnu skaits ir atkarīgs no izvēlētā fonta. Ar noklusējuma vidēja lieluma vienrindu fontu ekrānā var skaidri parādīt līdz 8 rindām un 13 kolonnām. Teksts, kas novietots ārpus šī diapazona, var tikt nogriezts vai grūtāk lasāms.
Vienrindas fontiem ir vienāda platuma rakstzīmes, padarot teksta izvietojumu vienmērīgu. Turpretī proporcionāliem 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.
Usage:robot.screen.set_cursor(row, column)
Parametri |
Apraksts |
|---|---|
|
Rinda, uz kuru jāpārvieto kursors. |
|
Kolonna, uz kuru jāpārvieto kursors. |
# Display text starting at Row 3 Column 2
robot.screen.set_cursor(3, 2)
robot.screen.print("Row 3, Column 2")

next_row#
next_row pārvieto kursoru uz 1. kolonnu nākamajā rindā robota ekrānā.
Usage:robot.screen.next_row()
Parametri |
Apraksts |
|---|---|
Šai metodei nav parametru. |
# Display two lines of text
robot.screen.print("Line 1")
robot.screen.next_row()
robot.screen.print("Line 2")

clear_row#
clear_row notīra vienu teksta rindu robota ekrānā.
Usage:robot.screen.clear_row(row, color)
Parametrs |
Apraksts |
|---|---|
|
Neobligāti. Rinda, kas jātīra kā vesels skaitlis. Noklusējuma vērtība ir pašreizējā kursora rinda. |
|
Optional. The color to apply to the cleared row. Options include:
|
# Display text on two rows
robot.screen.print("This text stays")
robot.screen.next_row()
robot.screen.print("This text disappears")
# Wait 3 seconds before clearing only the second row
wait(3, SECONDS)
robot.screen.clear_row()
# Turn the 5th row green
robot.screen.clear_row(5, GREEN)

get_row#
get_row atgriež pašreizējo rindu, kurā teksts tiks drukāts kā vesels skaitlis.
Usage:robot.screen.get_row()
Parametri |
Apraksts |
|---|---|
Šai metodei nav parametru. |
# Set cursor to (3,2) and print row number
robot.screen.set_cursor(3, 2)
robot.screen.print(robot.screen.get_row())

get_column#
get_column atgriež pašreizējo kolonnu, kurā teksts tiks drukāts kā vesels skaitlis.
Usage:robot.screen.get_column()
Parametri |
Apraksts |
|---|---|
Šai metodei nav parametru. |
# Set cursor to (3,2) and print column number
robot.screen.set_cursor(3, 2)
robot.screen.print(robot.screen.get_column())

XY druka#
print_at#
print_at izdrukā tekstu, skaitļus vai mainīgo vērtības robota ekrānā noteiktā x un y koordinātā pikseļos, izmantojot pašlaik iestatītos font un origin. x nosaka, cik tālu no kreisās puses sākas teksts, un y nosaka, kur atrodas burtu apakšdaļa. Šī metode ignorē pašreizējo kursora pozīciju.

Piezīme: Sarkanais aplis norāda, kuras koordinātas būs redzamas AIM robota apaļajā ekrānā. Koordinātas, kas atrodas ārpus sarkanā apļa, atrodas diapazonā no 0 līdz 240, bet ekrānā neparādīsies.
Usage:
robot.screen.print_at(text, x, y)
Parametrs |
Apraksts |
|---|---|
|
Teksts, skaitlis vai mainīgā vērtība, kas jāizdrukā ekrānā. |
|
Teksta horizontālā pozīcija kā vesels skaitlis no 0 līdz 240 pikseļiem. 0 ir pa kreisi; 240 ir pa labi. |
|
Teksta vertikālā pozīcija kā vesels skaitlis no 0 līdz 240 pikseļiem. 0 ir augšdaļa; 240 ir apakšdaļa. |
# Display a message in the middle of the screen
robot.screen.print_at("Hello, Robot!", x=40, y=120)

set_origin#
set_origin iestata sākumpunktu, kas tiek izmantots zīmēšanai un uz koordinātām balstītai drukāšanai robota ekrānā. Pēc noklusējuma sākumpunkts ir ekrāna augšējais kreisais stūris.
Usage:
robot.screen.set_origin(x, y)
Parametrs |
Apraksts |
|---|---|
|
Jaunā x koordināta, kas jāiestata kā sākumpunkts, norādīta kā vesels skaitlis no 0 līdz 240. |
|
Jaunā y koordināta, kas jāiestata kā sākumpunkts, norādīta kā vesels skaitlis no 0 līdz 240. |
# Set the origin to the center of the screen
robot.screen.set_origin(120, 120)
# Draw a rectangle at the new origin
robot.screen.draw_rectangle(0, 0, 80, 40)

Mutatori#
clear_screen#
clear_screen notīra visus zīmējumus un tekstu no robota ekrāna. Pēc noklusējuma tā arī atiestata kursora pozīciju uz 1. rindas 1. kolonnu.
Usage:
robot.screen.clear_screen(color)
Parametrs |
Apraksts |
|---|---|
|
Neobligāti. Iestata ekrāna krāsu. Opcijas ietver:
|
# Draw a circle, and clear it after 2 seconds
robot.screen.draw_circle(120, 120, 60)
wait(2, SECONDS)
robot.screen.clear_screen()
# Set the background color of the screen to red
robot.screen.clear_screen(RED)

set_font#
set_font iestata fontu, kas tiek izmantots teksta attēlošanai robota ekrānā. Šis fonts tiks lietots visam tekstam, kas tiek drukāts ar print vai print_at. Noklusējuma fonts projekta sākumā ir MONO24.
Usage:
robot.screen.set_font(fontname)
Parametrs |
Apraksts |
|---|---|
|
Iestata fontu uz vienu no šiem:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
# Display text using a larger font
robot.screen.set_font(MONO40)
robot.screen.print("VEX")

set_pen_width#
set_pen_width nosaka zīmēto līniju un formu kontūru biezumu.
Usage:
robot.screen.set_pen_width(width)
Parametrs |
Apraksts |
|---|---|
|
Pildspalvas platums pikseļos no 0 līdz 32. |
# Draw a rectangle with a pen width of 10
robot.screen.set_pen_width(10)
robot.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.
Usage:
robot.screen.set_pen_color(color)
Parametrs |
Apraksts |
|---|---|
|
Neobligāti. Pildspalvas un fonta krāsa, ko izmantot. Iespējas ietver:
|
# Draw a rectangle with a red pen
robot.screen.set_pen_color(RED)
robot.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 un drukājot tekstu ar fonu.
Usage:robot.screen.set_fill_color(color)
Parametrs |
Apraksts |
|---|---|
|
Neobligāti. Izmantojamā aizpildījuma krāsa. Iespējas ietver:
|
# Draw two orange rectangles
robot.screen.set_fill_color(ORANGE)
robot.screen.draw_rectangle(50, 50, 100, 60)
robot.screen.draw_rectangle(50, 130, 100, 60)

# Display text with a purple background
robot.screen.set_fill_color(PURPLE)
robot.screen.print("Highlight")

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.
Usage:
robot.screen.draw_pixel(x, y)
Parametrs |
Apraksts |
|---|---|
|
X koordināta, kur tiks zīmēts pikselis, norādīta kā vesels skaitlis no 0 līdz 240. |
|
Y koordināta, kur tiks zīmēts pikselis, norādīta kā vesels skaitlis no 0 līdz 240. |
# Draw a pixel at the center of the screen
robot.screen.draw_pixel(120, 120)
![]()
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.
X un y koordinātām tiek izmantota noklusējuma sākumpunkts (0, 0), ja vien, izmantojot set_origin, nav iestatīts cits sākumpunkts.
Usage:
robot.screen.draw_line(x1, y1, x2, y2)
Parametrs |
Apraksts |
|---|---|
|
Līnijas sākuma x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 240. |
|
Līnijas sākuma y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 240. |
|
Līnijas beigu x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 240. |
|
Līnijas beigu y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 240. |
# Draw a line from the top left to bottom right of the screen
robot.screen.draw_line(0, 0, 240, 240)

draw_rectangle#
draw_rectangle uzzīmē taisnstūri ar tā augšējo kreiso stūri atlasītajā (x, y) koordinātā un izmēru, ko nosaka dotais platums un augstums, visi mērīti pikseļos. Taisnstūra kontūra tiek zīmēta, izmantojot pašreizējos pen width un pen color. Iekšpuse tiek aizpildīta ar pašreizējo fill color, ja vien netiek izmantots papildu color parametrs.
X un y koordinātām tiek izmantota noklusējuma sākumpunkts (0, 0), ja vien, izmantojot set_origin, nav iestatīts cits sākumpunkts.
Usage:robot.screen.draw_rectangle(x, y, width, height, color)
Parametrs |
Apraksts |
|---|---|
|
Taisnstūra augšējā kreisā stūra x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 240. |
|
Taisnstūra augšējā kreisā stūra y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 240. |
|
Taisnstūra platums, kas norādīts kā vesels skaitlis no 0 līdz 240. |
|
Taisnstūra augstums, kas norādīts kā vesels skaitlis no 0 līdz 240. |
|
Optional. The fill color of the rectangle. Options include:
|
# Draw a red rectangle on the screen
robot.screen.draw_rectangle(50, 50, 130, 60, RED)

draw_circle#
draw_circle uzzīmē apli ar centru atlasītajā (x, y) koordinātā un izmēru, ko nosaka dotais rādiuss, visi mērījumi pikseļos. Apļa kontūra tiek zīmēta, izmantojot pašreizējos pen width un pen color. Iekšpuse tiek aizpildīta ar pašreizējo fill color, ja vien netiek izmantots papildu color parametrs.
X un y koordinātām tiek izmantota noklusējuma sākumpunkts (0, 0), ja vien, izmantojot set_origin, nav iestatīts cits sākumpunkts.
Usage:robot.screen.draw_circle(x, y, radius, color)
Parametrs |
Apraksts |
|---|---|
|
Apļa centra x koordināta, kas norādīta kā vesels skaitlis no 0 līdz 240. |
|
Apļa centra y koordināta, kas norādīta kā vesels skaitlis no 0 līdz 240. |
|
Apļa rādiuss, kas norādīts kā vesels skaitlis no 0 līdz 240 pikseļiem. |
|
Optional. The fill color of the circle. Options include:
|
# Draw a green circle on the screen
robot.screen.draw_circle(120, 120, 40, GREEN)

show_file#
show_file robota ekrānā parāda pielāgotu augšupielādētu attēlu, kura pozīcija ir iestatīta, izmantojot x, yun center parametrus, pamatojoties uz attēla atskaites punktu.
Usage:
robot.screen.show_file(file, x, y, center)
Parametrs |
Apraksts |
|---|---|
|
Izmantojamais pielāgotais attēls no |
|
Attēla horizontālā nobīde, kas norādīta kā vesels skaitlis pikseļos. Pozitīvas vērtības pārvieto attēlu pa labi; negatīvas vērtības pārvieto to pa kreisi. |
|
Attēla vertikālā nobīde, kas norādīta kā vesels skaitlis pikseļos. Pozitīvas vērtības to pārvieto uz leju; negatīvas vērtības to pārvieto uz augšu. |
|
Neobligāti. Ja |
# Display uploaded Image 1 in the top left corner
robot.screen.show_file(IMAGE1, 0, 0)
# Show the same image on both sides of the screen
# Image size is 120 x 120
robot.screen.show_file(IMAGE1, 65, 0, center=True)
robot.screen.show_file(IMAGE1, -65, 0, center=True)
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.
Usage:
robot.screen.set_clip_region(x, y, width, height)
Parametrs |
Apraksts |
|---|---|
|
Klipa apgabala augšējā kreisā stūra x koordināta, kas norādīta kā decimālskaitlis ( |
|
Saspraudes apgabala augšējā kreisā stūra y koordināta, kas norādīta kā decimālskaitlis ( |
|
Klipa apgabala platums pikseļos, norādīts kā decimāls ( |
|
Klipa apgabala augstums pikseļos, norādīts kā decimāls ( |
# Restrict text and drawings to a specific region
robot.screen.set_clip_region(0, 0, 120, 120)
robot.screen.draw_rectangle(60, 60, 100, 100, RED)
robot.screen.print_at("Cut off!", x=60, y=60)

Atzvani#
pressed#
pressed reģistrē metodi, kas tiks izsaukta, nospiežot robota ekrānu.
Usage:robot.screen.pressed(callback, arg)
Parametri |
Apraksts |
|---|---|
|
Funkcija, kas iepriekš definēta izpildei, nospiežot kontrollera ekrānu. |
|
Neobligāti. Tuple, kas satur argumentus, kas jānodod atzvanīšanas funkcijai. Plašāku informāciju skatiet sadaļā Funkciju izmantošana ar parametriem. |
# Set the LEDs to green when the screen is pressed.
def screen_touched():
robot.led.on(ALL_LEDS, GREEN)
robot.screen.pressed(screen_touched)
released#
released reģistrē metodi, kas tiks izsaukta, kad robota ekrāns tiks atbrīvots.
Usage:robot.screen.released(callback, arg)
Parametri |
Apraksts |
|---|---|
|
Funkcija, kas iepriekš definēta izpildei, nospiežot kontrollera ekrānu. |
|
Neobligāti. Tuple, kas satur argumentus, kas jānodod atzvanīšanas funkcijai. Plašāku informāciju skatiet sadaļā Funkciju izmantošana ar parametriem. |
# Set the LEDs to blue when the screen is released.
def screen_released():
robot.led.on(ALL_LEDS, BLUE)
robot.screen.released(screen_released)










