Näyttö

Johdanto

Näyttö-metodit ohjaavat sitä, miten V5 Brain näyttää tekstiä, numeroita ja grafiikkaa kosketusnäytöllään ja miten se reagoi kosketussyötteeseen.

Oletusarvoisesti Brainiin tulostettava fontti on monospaced small, jossa on 12 riviä ja 48 saraketta.

Piirtämistä varten aivojen resoluutio on 480 x 240 pikseliä.

Alla on luettelo kaikista menetelmistä:

Kohdistimen tulostus — Sijoita ja tulosta tekstiä.

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

• row — Palauttaa rivin, jolle teksti tulostetaan.

• column — Palauttaa sarakkeen, johon teksti tulostetaan.

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

• get_string_width — Palauttaa merkkijonon leveyden pikseleinä käyttäen nykyistä fonttia.

• get_string_height — Palauttaa merkkijonon korkeuden pikseleinä käyttäen nykyistä fonttia.

• clear_line — Tyhjentää tekstirivin.

• new_line — Siirtää kohdistimen uudelle riville.

Mutaattorit — Muuta näytön asetuksia, värejä ja piirtokäyttäytymistä.

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

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

Piirrä — Lisää grafiikkaa näytölle.

• draw_pixel — Piirtää yhden pikselin koordinaatin kohdalle.

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

• draw_rectangle — Piirtää suorakulmion.

• draw_circle — Piirtää ympyrän.

• render — Päivittää Brainin näytön tekstillä ja piirroksilla vain kutsuttaessa.

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

Getterit — Tarkista kosketuksen tila ja sijainti.

• pressing — Palauttaa, painetaanko näyttöä.

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

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

Takaisinkutsutoiminnot — Reagoi näytön kosketustapahtumiin.

• pressed — Rekisteröi funktion, joka kutsutaan näyttöä painettaessa.

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

Tietoja Brainin rakentamisesta screen -metodien käyttämiseksi on artikkelissa Brain.

Kohdistimen tulostus

print

print tulostaa tekstiä, numeroita tai muuttujan arvoja Brain-näytölle kohdistimen nykyiseen sijaintiin ja fontilla.

Käyttö:

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

Parametrit	Kuvaus
text	Tulostettava teksti, numero tai muuttujan arvo.
sep	Valinnainen. Merkkijono, joka lisätään arvojen väliin. Tämä on kirjoitettava avainsana-argumenttina (sep=). Oletusarvo on “”.
precision	Valinnainen. Näytettävien desimaalien määrä tulostettaessa yksinkertaisia ​​lukuja. Tämä on kirjoitettava avainsana-argumenttina (precision=). Oletusarvo on 2.

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

set_cursor

set_cursor siirtää kohdistimen tiettyyn riviin ja sarakkeeseen Brain-näytöllä. Seuraava print -kutsu aloittaa tulostuksen tästä kohdasta. Se, kuinka monta riviä ja saraketta mahtuu mukavasti, riippuu valitusta fontista. Oletusarvoisella kiinteävälisellä keskikokoisella fontilla voidaan näyttää jopa 8 riviä ja 13 saraketta selkeästi. Tämän alueen ulkopuolelle sijoitettu teksti saattaa katketa ​​tai siitä voi tulla vaikealukuista.

Kiinteävälisissä fonteissa merkit ovat kaikki 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.

Käyttö:

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

next_row

next_row siirtää kohdistimen seuraavalle riville.

Käyttö:

brain.screen.next_row()

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

# 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 tyhjentää yhden tekstirivin Brain-näytöltä.

Käyttö:

brain.screen.clear_row(row, color)

Parametrit	Kuvaus
row	Valinnainen. Tyhjennettävä rivi. Oletusarvo on nykyinen kohdistinrivi.
color	Valinnainen. Kelvollinen color, heksadesimaaliarvo tai verkkomerkkijono.

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

Käyttö:

brain.screen.row()

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

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

column

column palauttaa sarakkeen, johon teksti tulostetaan kokonaislukuna.

Käyttö:

brain.screen.column()

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

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

print_at

print_at tulostaa tekstiä, numeroita tai muuttujan arvoja Brain-näytölle tietyissä x- ja y-koordinaateissa nykyisten font ja origin -arvojen avulla.

Käyttö:

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

Parametrit	Kuvaus
text	Tulostettava teksti, numero tai muuttujan arvo.
x	Tulostettava x-koordinaatti avainsana-argumenttina (x=), viitaten näytön lähtöpisteeseen.
y	Tulostettava y-koordinaatti avainsana-argumenttina (y=), viitaten näytön nolliin.
sep	Valinnainen. Merkkijono, joka lisätään arvojen väliin. Tämä on kirjoitettava avainsana-argumenttina (sep=). Oletusarvo on ” “.
precision	Valinnainen. Näytettävien desimaalien määrä tulostettaessa yksinkertaisia ​​lukuja. Tämä on kirjoitettava avainsana-argumenttina (precision=). Oletusarvo on 2.
opaque	Valinnainen. Totuusarvo, joka ilmaisee, tyhjennetäänkö tekstin taustapikselit. Oletusarvo on True.

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

get_string_width

get_string_width palauttaa merkkijonon leveyden pikseleinä kokonaislukuna käyttäen nykyistä font-muuttujaa.

Usage:
brain.screen.get_string_width(string)

Parametrit	Kuvaus
string	Mitattava merkkijono.

get_string_height

get_string_height palauttaa merkkijonon korkeuden pikseleinä kokonaislukuna käyttäen nykyistä font-merkkijonoa.

Usage:
brain.screen.get_string_height(string)

Parametrit	Kuvaus
string	Mitattava merkkijono.

clear_line

clear_line tyhjentää nykyisen tekstirivin.

Usage: brain.screen.clear_line()

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

new_line

new_line siirtää kohdistimen Brain-näytön seuraavan rivin sarakkeeseen 1.

Käyttö:

brain.screen.new_line()

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

Mutaattorit

clear_screen

clear_screen tyhjentää kaikki piirrokset ja tekstin Brain-näytöltä.

Käyttö:

brain.screen.clear_screen(color)

Parametrit	Kuvaus
color	Valinnainen. Kelvollinen värivaihtoehto: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.BLACK (Oletus) 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 asettaa Brain-näytöllä näytettävän tekstin fontin. Tätä fonttia käytetään kaikkeen tekstiin, joka tulostetaan tämän metodin suorittamisen jälkeen.

Käyttö:

brain.screen.set_font(font)

Parametrit	Kuvaus
font	Kelvollinen fonttivaihtoehto alla.

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 asettaa piirrettyjen viivojen ja ääriviivojen paksuuden.

Käyttö:

brain.screen.set_pen_width(value)

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

Käyttö:

brain.screen.set_pen_color(color)

Parametrit	Kuvaus
color	Käytettävä kynän ja fontin väri. Vaihtoehtoja ovat: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Voit myös määrittää mukautetun värin.

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

Käyttö:

brain.screen.set_fill_color(color)

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

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

set_origin

set_origin asettaa piirtämisessä ja koordinaatistoon perustuvassa tulostuksessa käytettävän origon Brain-näytöllä. Oletusarvoisesti origo on näytön vasen yläkulma.

Käyttö:

brain.screen.set_origin(x, y)

Parametrit	Kuvaus
x	Origopisteeksi asetettava x-koordinaatti väliltä 0–479.
y	Origopisteeksi asetettava y-koordinaatti väliltä 0–239.

Piirrä

draw_pixel

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

Käyttö:

brain.screen.draw_pixel(x, y)

Parametrit	Kuvaus
x	Pikselin piirtämiseen käytettävä x-koordinaatti väliltä 0–479 näytön lähtöpisteeseen nähden.
y	Y-koordinaatti, jolla pikseli piirretään näytön lähtöpisteeseen nähden, väliltä 0–239.

# 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 piirtää viivan ensimmäisestä näytön koordinaatista toiseen näytön koordinaattiin käyttäen nykyistä kynän leveyttä ja väriä.

Käyttö:

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

Parametrit	Kuvaus
start_x	Viivan alun x-koordinaatti pikseleinä, 0 - 479, viitaten näytön lähtöpisteeseen.
start_y	Viivan alun y-koordinaatti pikseleinä, 0 - 239, viitaten näytön lähtöpisteeseen.
end_x	Viivan lopun x-koordinaatti pikseleinä, 0 - 479, viitaten näytön lähtöpisteeseen.
end_y	Viivan lopun y-koordinaatti pikseleinä, 0 - 239, viitaten näytön lähtöpisteeseen.

# 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 piirtää suorakulmion käyttäen nykyistä kynän leveyttä, kynän väriä ja täyttöväriä, ellei valinnaista color -parametria käytetä.

Käyttö:

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

Parametrit	Kuvaus
x	Suorakulmion vasemman yläkulman x-koordinaatti pikseleinä väliltä 0–479.
y	Suorakulmion vasemman yläkulman y-koordinaatti pikseleinä välillä 0–239.
width	Suorakulmion leveys.
height	Suorakulmion korkeus.
color	Valinnainen. Kelvollinen värivaihtoehto: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Voit myös määrittää mukautetun värin.

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

draw_circle

draw_circle piirtää ympyrän käyttämällä nykyistä kynän leveyttä, kynän väriä ja täyttöväriä, ellei valinnaista color -parametria käytetä.

Käyttö:

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

Parametrit	Kuvaus
x	Ympyrän keskipisteen x-koordinaatti pikseleinä, 0–479, viitaten näytön lähtöpisteeseen.
y	Ympyrän keskipisteen y-koordinaatti pikseleinä, 0–239, suhteessa näytön lähtöpisteeseen.
radius	Ympyrän säde pikseleinä.
color	Valinnainen. Käytettävä täyttöväri. Vaihtoehtoja ovat: Color.RED Color.GREEN Color.BLUE Color.YELLOW Color.ORANGE Color.PURPLE Color.CYAN Color.TRANSPARENT Color.WHITE Voit myös määrittää mukautetun värin.

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

render

render ottaa käyttöön kaksinkertaisen puskuroinnin Brainin näytöllä. Kun komentoa kutsutaan, mitkään piirustuskomennot (kuten teksti, muodot tai kuvat) eivät enää näy välittömästi projektin loppuosassa. Sen sijaan päivitykset näkyvät vasta, kun render -komentoa käytetään uudelleen. Tämä mahdollistaa sujuvammat ja hallitummat näytön päivitykset, mutta tarkoittaa, että mikään ei ole näkyvissä ennen kuin render käytetään.

Käyttö:

brain.screen.render()

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

# 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 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ä.

Käyttö:

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

Parametrit	Kuvaus
x	Suorakulmion vasemman yläkulman x-sijainti suhteessa näytön lähtöpisteeseen.
y	Suorakulmion vasemman yläkulman y-sijainti suhteessa näytön lähtöpisteeseen.
width	Suorakulmion leveys.
height	Suorakulmion korkeus.

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

Kosketa

pressing

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

• True - Näyttöä painetaan.

• False - Näyttöä ei paineta.

Käyttö:

brain.screen.pressing()

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

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

Käyttö:

brain.screen.x_position()

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

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

Käyttö:

brain.screen.y_position()

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

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

Takaisinkutsut

pressed

pressed rekisteröi funktion, jota kutsutaan, kun Brain’s Screen -painiketta painetaan.

Käyttö:

brain.screen.pressed(callback, arg)

Parametrit	Kuvaus
callback	Aiemmin määritelty function, joka suoritetaan, kun Brain-näyttöä painetaan.
arg	Valinnainen. tuple, joka sisältää argumentteja, jotka välitetään takaisinkutsufunktiolle. Lisätietoja on kohdassa Funktioiden käyttö parametrien kanssa.

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

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

released

released rekisteröi funktion kutsuttavaksi, kun näyttö vapautetaan (kosketus poistetaan).

Käyttö:

brain.screen.released(callback, arg)

Parametrit	Kuvaus
callback	Aiemmin määritelty function, joka suoritetaan, kun Brain-näyttö vapautetaan.
arg	Valinnainen. tuple, joka sisältää argumentteja, jotka välitetään takaisinkutsufunktiolle. Lisätietoja on kohdassa Funktioiden käyttö parametrien kanssa.

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

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