Näyttö

Johdanto

Screen-metodit ohjaavat sitä, miten VEX AIM -koodausrobotti näyttää tekstiä, numeroita ja grafiikkaa näytöllään ja miten se reagoi näytön painalluksiin.

Alla on luettelo kaikista menetelmistä:

Kosketus – Tunnistaa näytön painallukset ja reagoi niihin.

• pressing – Palauttaa, painetaanko näyttöä parhaillaan.

• x_position – Palauttaa viimeisimmän näytön painalluksen x-koordinaatin.

• y_position – Palauttaa viimeisimmän näytön painalluksen y-koordinaatin.

Kohdistimen tulostus – Näytä teksti rivi-sarake-järjestelmässä.

• print – Tulostaa tekstiä, numeroita tai muuttujan arvoja kohdistimen nykyisestä sijainnista.

• set_cursor – Siirtää kohdistimen tiettyyn riviin ja sarakkeeseen.

• next_row – Siirtää kohdistimen seuraavan rivin sarakkeeseen 1.

• clear_row – Tyhjentää tekstirivin.

• get_row – Palauttaa kohdistimen nykyisen rivin.

• get_column – Palauttaa kohdistimen nykyisen sarakkeen.

XY-tulostus – Näytä teksti tietyssä näytön koordinaatissa.

• print_at – Tulostaa tekstiä, numeroita tai muuttujan arvoja tietyssä x- ja y-koordinaatissa.

• set_origin – Asettaa koordinaatistopohjaisessa tulostuksessa ja piirtämisessä käytettävän lähtöpisteen.

Mutaattorit – Tyhjennä näyttö tai päivitä visuaaliset asetukset.

• clear_screen – Tyhjentää näytön kaikista piirroksista ja tekstistä.

• set_font – Asettaa tulostettavan tekstin fontin.

• set_pen_width – Asettaa piirrettyjen viivojen ja ääriviivojen paksuuden.

• set_pen_color – Asettaa tekstin, pikseleiden, viivojen ja ääriviivojen värin.

• set_fill_color – Asettaa piirrettyjen muotojen ja tulostettujen tekstitaustojen täyttövärin.

Piirrä – Lisää grafiikkaa ja kuvia näytölle.

• draw_pixel – Piirtää pikselin tiettyyn x- ja y-sijaintiin.

• draw_line – Piirtää viivan kahden pisteen välille.

• draw_rectangle – Piirtää suorakulmion.

• draw_circle – Piirtää ympyrän.

• show_file – Näyttää ladatun kuvan.

• set_clip_region – Rajoittaa piirrosten ja tekstin näkymistä.

Takaisinkutsutoiminnot – Suorittavat funktioita, kun näyttöä painetaan tai vapautetaan.

• pressed – Rekisteröi funktion, jota kutsutaan näyttöä painettaessa.

• released – Rekisteröi funktion, jota kutsutaan, kun näyttö vapautetaan.

Kosketa

pressing

pressing palauttaa totuusarvon, joka ilmaisee, painetaanko robotin näyttöä parhaillaan.

• True – Näyttöä painetaan.

• False – Näyttöä ei paineta.

Usage:
robot.screen.pressing()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

# 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 palauttaa viimeisimmän näytön painalluksen x-koordinaatin kokonaislukuna väliltä 0 (vasen) - 240 (oikea).

Usage:
robot.screen.x_position()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

# 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 palauttaa viimeisimmän näytön painalluksen y-koordinaatin kokonaislukuna väliltä 0 (ylhäällä) - 240 (alhaalla).

Usage:
robot.screen.y_position()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

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

Kohdistimen tulostus

print

print tulostaa tekstiä, numeroita tai muuttujien arvoja robotin näytölle nykyiseen kursorin sijaintiin ja fontti.

Usage:
robot.screen.print(text)

Parametrit	Kuvaus
text	Näytöllä näytettävä teksti, numero tai muuttujan arvo.

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

set_cursor

set_cursor siirtää tekstikohdistimen robotin näytöllä tiettyyn riviin ja sarakkeeseen. Seuraava print -kutsu aloittaa tulostuksen tästä kohdasta. Sopivien rivien ja sarakkeiden määrä riippuu valitusta fontista. Oletusarvoisella kiinteävälisellä keskikokoisella fontilla näyttö voi näyttää selkeästi jopa 8 riviä ja 13 saraketta. Tämän alueen ulkopuolelle sijoitettu teksti saattaa katketa ​​tai olla vaikeampi lukea.

Kiinteävälisissä fonteissa kaikki merkit ovat saman levyisiä, mikä tekee tekstin sijoittelusta yhdenmukaista. Sitä vastoin suhteutettujen fonttien merkkien leveys vaihtelee, joten jotkut kirjaimet vievät enemmän tilaa kuin toiset. Käytetystä tyypistä riippumatta set_cursor sijoittaa kohdistimen rivi- ja sarakekoon, ei fonttityylin, perusteella. Fonttikokoa voidaan säätää käyttämällä set_font.

Usage:
robot.screen.set_cursor(row, column)

Parametrit	Kuvaus
row	Rivi, johon kohdistin siirretään.
column	Sarake, johon kohdistin siirretään.

# 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 siirtää kohdistimen robotin näytön seuraavan rivin sarakkeeseen 1.

Usage:
robot.screen.next_row()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

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

clear_row

clear_row tyhjentää yhden tekstirivin robotin näytöltä.

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

Parametri	Kuvaus
row	Valinnainen. Tyhjennettävä rivi kokonaislukuna. Oletusarvo on nykyinen kohdistinrivi.
color	Optional. The color to apply to the cleared row. Options include: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW You can also specify a custom color.

# 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 palauttaa nykyisen rivin, jolle teksti tulostetaan kokonaislukuna.

Usage:
robot.screen.get_row()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

# 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 palauttaa nykyisen sarakkeen, johon teksti tulostetaan kokonaislukuna.

Usage:
robot.screen.get_column()

Parametrit	Kuvaus
	Tällä menetelmällä ei ole parametreja.

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

XY-tulostus

print_at

print_at tulostaa tekstiä, numeroita tai muuttujan arvoja robotin näytölle tietyssä x- ja y-koordinaatissa pikseleinä käyttäen nykyisiä font ja origin -arvoja. x määrittää, kuinka kaukana vasemmasta reunasta teksti alkaa, ja y määrittää, missä kirjainten alaosa sijaitsee. Tämä metodi jättää huomiotta kohdistimen nykyisen sijainnin.

Huomautus: Punainen ympyrä näyttää, mitkä koordinaatit näkyvät AIM-robotin pyöreällä näytöllä. Punaisen ympyrän ulkopuolelle jäävät koordinaatit ovat välillä 0–240, mutta ne eivät näy näytöllä.

Usage:
robot.screen.print_at(text, x, y)

Parametri	Kuvaus
text	Näytölle tulostettava teksti, numero tai muuttujan arvo.
x	Tekstin vaakasuora sijainti kokonaislukuna väliltä 0–240 pikseliä. 0 on vasen ja 240 oikea.
y	Tekstin pystysuuntainen sijainti kokonaislukuna väliltä 0–240 pikseliä. 0 on yläreuna ja 240 alareuna.

# Display a message in the middle of the screen
robot.screen.print_at("Hello, Robot!", x=40, y=120)

set_origin

set_origin asettaa robotin näytölle piirtämisessä ja koordinaattipohjaisessa tulostuksessa käytettävän lähtöpisteen. Oletusarvoisesti lähtöpiste on näytön vasen yläkulma.

Usage:
robot.screen.set_origin(x, y)

Parametri	Kuvaus
x	Uusi x-koordinaatti, joka asetetaan lähtöpisteeksi, kokonaislukuna väliltä 0–240.
y	Uusi y-koordinaatti, joka asetetaan origoksi, kokonaislukuna väliltä 0–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)

Mutaattorit

clear_screen

clear_screen tyhjentää kaikki piirrokset ja tekstin robotin näytöltä. Oletusarvoisesti se myös palauttaa kohdistimen sijainnin riville 1, sarakkeeseen 1.

Usage:
robot.screen.clear_screen(color)

Parametri	Kuvaus
color	Valinnainen. Määrittää näytön värin. Vaihtoehtoja ovat: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Voit myös määrittää mukautetun värin.

# 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 asettaa robotin näytöllä näkyvän tekstin fontin. Tätä fonttia käytetään kaikkeen tekstiin, joka tulostetaan joko print tai print_at -funktiolla. Projektin alussa oletusfontti on MONO24.

Usage:
robot.screen.set_font(fontname)

Parametri	Kuvaus
fontname	Sets the font to one of the following: MONO12 MONO15 MONO20 MONO24 MONO30 MONO40 MONO60 PROP20 PROP30 PROP40 PROP60 These options are shown below.

MONO12	MONO15	MONO20
MONO24	MONO30	MONO40
MONO60	PROP20	PROP30
PROP40	PROP60

# Display text using a larger font
robot.screen.set_font(MONO40)
robot.screen.print("VEX")

set_pen_width

set_pen_width asettaa piirrettyjen viivojen ja ääriviivojen paksuuden.

Usage:
robot.screen.set_pen_width(width)

Parametri	Kuvaus
width	Kynän leveys pikseleinä väliltä 0–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 asettaa tekstin, pikseleiden, viivojen ja ääriviivojen värin.

Usage:
robot.screen.set_pen_color(color)

Parametri	Kuvaus
color	Optional. The pen and font color to use. Options include: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW You can also specify a custom color.

# 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 asettaa täyttövärin, jota käytetään muotojen piirtämisessä ja tulostetun tekstin taustan käytössä.

Usage:
robot.screen.set_fill_color(color)

Parametri	Kuvaus
color	Valinnainen. Käytettävä täyttöväri. Vaihtoehtoja ovat: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Voit myös määrittää mukautetun värin.

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

Piirrä

draw_pixel

draw_pixel piirtää yhden pikselin valittuun x- ja y-koordinaattiin käyttäen nykyistä kynän väriä.

Usage:
robot.screen.draw_pixel(x, y)

Parametri	Kuvaus
x	Pikselin piirrettävä x-koordinaatti kokonaislukuna 0–240.
y	Y-koordinaatti, johon pikseli piirretään, kokonaislukuna 0–240.

# Draw a pixel at the center of the screen
robot.screen.draw_pixel(120, 120)

draw_line

draw_line piirtää viivan ensimmäisestä näyttökoordinaatista (x1, y1) toiseen näyttökoordinaattiin (x2, y2) käyttäen nykyisiä kynän leveys ja kynän väri -arvoja.

X- ja y-koordinaatit käyttävät oletusarvoista origoa (0, 0), ellei eri origoa ole asetettu käyttämällä funktiota set_origin.

Usage:
robot.screen.draw_line(x1, y1, x2, y2)

Parametri	Kuvaus
x1	Suoran aloitus-x-koordinaatti kokonaislukuna väliltä 0–240.
y1	Suoran aloitus-y-koordinaatti kokonaislukuna väliltä 0–240.
x2	Suoran päättymispisteen x-koordinaatti kokonaislukuna väliltä 0–240.
y2	Suoran päätepisteen y-koordinaatti kokonaislukuna väliltä 0–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 piirtää suorakulmion, jonka vasen yläkulma on valitussa (x, y) koordinaatissa ja jonka koko määräytyy annetun leveyden ja korkeuden mukaan, kaikki mitattuna pikseleinä. Suorakulmion ääriviivat piirretään käyttämällä nykyisiä pen width ja pen color -parametreja. Sisäosa täytetään nykyisellä täyttövärillä, ellei valinnaista color -parametria käytetä.

X- ja y-koordinaatit käyttävät oletusarvoista origoa (0, 0), ellei eri origoa ole asetettu käyttämällä funktiota set_origin.

Usage:
robot.screen.draw_rectangle(x, y, width, height, color)

Parametri	Kuvaus
x	Suorakulmion vasemman yläkulman x-koordinaatti kokonaislukuna väliltä 0–240.
y	Suorakulmion vasemman yläkulman y-koordinaatti kokonaislukuna väliltä 0–240.
width	Suorakulmion leveys kokonaislukuna väliltä 0–240.
height	Suorakulmion korkeus kokonaislukuna väliltä 0–240.
color	Valinnainen. Suorakulmion täyttöväri. Vaihtoehtoja ovat: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Voit myös määrittää mukautetun värin.

# Draw a red rectangle on the screen
robot.screen.draw_rectangle(50, 50, 130, 60, RED)

draw_circle

draw_circle piirtää ympyrän, jonka keskipiste on valitussa (x, y) koordinaatissa ja jonka koko määräytyy annetun säteen mukaan, kaikki mitattuna pikseleinä. Ympyrän ääriviivat piirretään käyttämällä nykyisiä kynän leveys ja kynän väri -parametreja. Sisäosa täytetään nykyisellä täyttövärillä, ellei valinnaista color -parametria käytetä.

X- ja y-koordinaatit käyttävät oletusarvoista origoa (0, 0), ellei eri origoa ole asetettu käyttämällä funktiota set_origin.

Usage:
robot.screen.draw_circle(x, y, radius, color)

Parametri	Kuvaus
x	Ympyrän keskipisteen x-koordinaatti kokonaislukuna väliltä 0–240.
y	Ympyrän keskipisteen y-koordinaatti kokonaislukuna väliltä 0–240.
radius	Ympyrän säde, joka annetaan kokonaislukuna väliltä 0 - 240 pikseliä.
color	Valinnainen. Ympyrän täyttöväri. Vaihtoehtoja ovat: BLACK BLUE CYAN GREEN ORANGE PURPLE RED TRANSPARENT WHITE YELLOW Voit myös määrittää mukautetun värin.

# Draw a green circle on the screen
robot.screen.draw_circle(120, 120, 40, GREEN)

show_file

show_file näyttää robotin näytöllä mukautetun ladatun kuvan, jonka sijainti on asetettu kuvan referenssipisteeseen perustuvien x, y- ja center -parametrien avulla.

Usage:
robot.screen.show_file(file, x, y, center)

Parametri	Kuvaus
file	Käytettävä mukautettu kuva väliltä IMAGE1 – IMAGE10Kuvan numero vastaa AIM-ohjauspaneelissa näkyvää numeroa.
x	Kuvan vaakasuuntainen siirtymä, joka annetaan kokonaislukuna pikseleissä. Positiiviset arvot siirtävät kuvaa oikealle ja negatiiviset arvot vasemmalle.
y	Kuvan pystysuora siirtymä pikseleissä kokonaislukuna. Positiiviset arvot siirtävät kuvaa alaspäin ja negatiiviset arvot ylöspäin.
center	Valinnainen. Jos center=True, kuva sijoitetaan käyttämällä sen keskipistettä koordinaateissa (120, 120). Oletusarvoisesti (center=False) käytetään kuvan vasenta yläkulmaa ja se sijoitetaan suhteessa nykyiseen origin-pisteeseen.

# 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 määrittää näytölle suorakaiteen muotoisen alueen, johon kaikki piirrokset ja teksti rajataan. Tämän alueen ulkopuolella olevaa sisältöä ei näytetä.

Usage:
robot.screen.set_clip_region(x, y, width, height)

Parametri	Kuvaus
x	Leikkausalueen vasemman yläkulman x-koordinaatti desimaalilukuna (float) välillä 0–240.
y	Leikkausalueen vasemman yläkulman y-koordinaatti desimaalilukuna (float) välillä 0–240.
width	Leikkausalueen leveys pikseleinä desimaalilukuna (float) välillä 0–240.
height	Leikkausalueen korkeus pikseleinä desimaalilukuna (float) välillä 0–240.

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

Takaisinkutsut

pressed

pressed rekisteröi metodin, jota kutsutaan, kun robotin näyttöä painetaan.

Usage:
robot.screen.pressed(callback, arg)

Parametrit	Kuvaus
callback	Function, joka on aiemmin määritelty suoritettavaksi, kun ohjaimen näyttöä painetaan.
arg	Valinnainen. tuple, joka sisältää argumentteja, jotka välitetään takaisinkutsufunktiolle. Lisätietoja on kohdassa Funktioiden käyttö parametrien kanssa.

# 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 rekisteröi metodin, jota kutsutaan, kun robotin näyttö vapautetaan.

Usage:
robot.screen.released(callback, arg)

Parametrit	Kuvaus
callback	Function, joka on aiemmin määritelty suoritettavaksi, kun ohjaimen näyttöä painetaan.
arg	Valinnainen. tuple, joka sisältää argumentteja, jotka välitetään takaisinkutsufunktiolle. Lisätietoja on kohdassa Funktioiden käyttö parametrien kanssa.

# Set the LEDs to blue when the screen is released.
def screen_released():
    robot.led.on(ALL_LEDS, BLUE)

robot.screen.released(screen_released)