Näyttö

Johdanto

Screen-metodit ohjaavat sitä, miten EXP Brain näyttää tekstiä, numeroita ja grafiikkaa näytöllään.

Oletusarvoisesti Brainiin tulostettava fontti on monospaced small, jossa on 7 riviä ja 20 saraketta.

Piirtämistä varten aivojen resoluutio on 159 x 107 pikseliä.

Alla on luettelo käytettävissä olevista menetelmistä:

Kohdistimen tulostus – Näytä tekstiä ja hallitse tulostuskohdistinta.

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

• print_at – Tulostaa tekstiä, numeroita tai muuttujien arvoja tietyissä x- ja y-koordinaateissa.

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

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

• next_row – Siirtää kohdistimen seuraavalle riville.

• clear_row – Tyhjentää tekstirivin.

• row – Palauttaa rivin, jolle teksti tulostetaan.

• column – Palauttaa sarakkeen, johon teksti tulostetaan.

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

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

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

• clear_screen – Tyhjentää kaikki piirrokset ja tekstin Brain-näytöltä.

• set_font – Asettaa Brainin näytöllä tulostettavan tekstin fonttityypin.

• 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ä – Luo muotoja, viivoja ja grafiikkaa Brain-näytöllä.

• draw_pixel – Piirtää yhden pikselin koordinaatin kohdalle.

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

• draw_rectangle – Piirtää suorakulmion käyttämällä nykyisiä kynän ja täyttövärejä.

• draw_circle – Piirtää ympyrän käyttämällä nykyistä kynää ja täyttövärejä.

• draw_image_from_file – Noutaa kuvan SD-kortilta.

• render – Vaihtaa piirron kaksoispuskuroituun ja renderöi Brainin näytön.

• set_clip_region – Asettaa leikealueen annetun suorakulmion piirtämistä varten.

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.

brain.screen.print("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='-')

print_at

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

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. opaque=True — Tekstin tausta täytetään oletusarvoisesti nykyisellä täyttövärillä tai mustalla. opaque=False (oletus) — Tekstin tausta vastaa näytön taustaväriä.

# Print the number 1 on the Brain's screen at position (100, 40).
brain.screen.print_at(1, x=100, y=40)

set_cursor

set_cursor siirtää kohdistimen tiettyyn riviin ja sarakkeeseen Brain-näytöllä. Seuraava print -kutsu aloittaa tulostamisen tästä kohdasta. Rivi- ja sarakevälistys ottaa huomioon valitun fontin. Kohdistimen oletussijainti on rivi 1, sarake 1.

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 10.
brain.screen.set_cursor(3, 10)
brain.screen.print("R3, C10")

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	Lähtöpisteen x-sijainti suhteessa vasempaan yläkulmaan, 0–159.
y	Origon y-sijainti suhteessa vasempaan yläkulmaan, 0:sta 107:ään.

next_row

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

Käyttö:

brain.screen.next_row()

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

# Display two lines of text.
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)

Parametrit	Kuvaus
row	Valinnainen. Tyhjennettävä rivi. Oletusarvo on nykyinen kohdistinrivi.
color	Valinnainen. Kelvollinen ColorType, heksadesimaaliarvo tai verkkomerkkijono. Color.BLACK Color.BLUE Color.GREEN Color.ORANGE Color.PURPLE Color.RED Color.VIOLET Color.WHITE Color.YELLOW määrittää mukautetun värin.

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

get_string_width

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

Käyttö:

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

Käyttö:

brain.screen.get_string_height(string)

Parametrit	Kuvaus
string	Mitattava merkkijono.

Mutaattorit

clear_screen

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

Käyttö:

brain.screen.clear_screen(color)

Parametrit	Kuvaus
color	Valinnainen. Kelvollinen ColorType, heksadesimaaliarvo tai verkkomerkkijono. Color.BLACK Color.BLUE Color.GREEN Color.ORANGE Color.PURPLE Color.RED Color.VIOLET Color.WHITE Color.YELLOW määrittää mukautetun värin.

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

Parametrit	Kuvaus
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.

MONO12	MONO15	MONO20
MONO30	MONO40	MONO60
PROP20	PROP30	PROP40
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(width)

Parametrit	Kuvaus
width	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(20, 20, 75, 50)

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. Tämä voi olla kelvollinen ColorType, heksadesimaaliarvo tai verkkomerkkijono. Color.BLACK Color.BLUE Color.GREEN Color.ORANGE Color.PURPLE Color.RED Color.VIOLET Color.WHITE Color.YELLOW 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(20, 20, 75, 50)

# 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 asettaa suorakulmioiden ja ympyröiden piirtämiseen käytetyn täyttövärin.

Käyttö:

brain.screen.set_fill_color(color)

Parametrit	Kuvaus
color	Käytettävä täyttöväri. Tämä voi olla kelvollinen ColorType, heksadesimaaliarvo tai verkkomerkkijono. Color.BLACK Color.BLUE Color.GREEN Color.ORANGE Color.PURPLE Color.RED Color.VIOLET Color.WHITE Color.YELLOW Voit myös määrittää mukautetun värin.

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

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

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–159 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–107.

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

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.

Käyttö:

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

Parametrit	Kuvaus
x1	Viivan alun x-koordinaatti pikseleinä, 0 - 159, viitaten näytön lähtöpisteeseen.
y1	Viivan alun y-koordinaatti pikseleinä, 0 - 107, viitaten näytön lähtöpisteeseen.
x2	Viivan lopun x-koordinaatti pikseleinä, 0 - 159, viitaten näytön lähtöpisteeseen.
y2	Viivan lopun y-koordinaatti pikseleinä, 0 - 107, 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, 159, 107)

draw_rectangle

draw_rectangle piirtää suorakulmion käyttämällä nykyisiä kynän leveys, kynän väri ja täyttöväri -parametreja, 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ä, 0–159, viitaten näytön lähtöpisteeseen.
y	Suorakulmion vasemman yläkulman y-koordinaatti pikseleinä, 0–107, suhteessa näytön lähtöpisteeseen.
width	Suorakulmion leveys.
height	Suorakulmion korkeus.
color	Valinnainen. Kelvollinen ColorType, heksadesimaaliarvo tai verkkomerkkijono. Color.BLACK Color.BLUE Color.GREEN Color.ORANGE Color.PURPLE Color.RED Color.VIOLET Color.WHITE Color.YELLOW määrittää mukautetun värin.

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

# 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 piirtää ympyrän käyttämällä nykyisiä kynän leveys, kynän väri ja täyttöväri -parametreja, 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–159, suhteessa näytön lähtöpisteeseen.
y	Ympyrän keskipisteen y-koordinaatti pikseleinä, 0–107, suhteessa näytön lähtöpisteeseen.
radius	Ympyrän säde.
color	Valinnainen. Kelvollinen ColorType, heksadesimaaliarvo tai verkkomerkkijono. Color.BLACK Color.BLUE Color.GREEN Color.ORANGE Color.PURPLE Color.RED Color.VIOLET Color.WHITE Color.YELLOW määrittää mukautetun värin.

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

# 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 piirtää kuvan SD-kortilta. Metodia kutsuttaessa annetun tiedostonimen on sijaittava SD-kortilla.

Käyttö:

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

Parametrit	Kuvaus
filename	Kuvan tiedostonimi.
x	Näytöllä näkyvän kuvan vasemman yläkulman x-koordinaatti.
y	Näytöllä näkyvän kuvan vasemman yläkulman y-koordinaatti.

# 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 vaihtaa piirtämisen kaksoispuskuroituun ja renderöi Brainin näytön. Kun komento render kutsutaan, piirtämistä ei näy Brainin näytöllä.

• True , jos puskurin renderöinti näytölle onnistui.

• False , jos puskuria ei renderöity näytölle onnistuneesti.

Käyttö:

brain.screen.render()

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

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.