Obrazovka#

Zavedení#

Metody Screen řídí, jak EXP Brain zobrazuje text, čísla a grafiku na obrazovce.

Ve výchozím nastavení je pro tisk do Brainu použito písmo monospaced small, které má 7 řádků a 20 sloupců.

Pro kreslení je rozlišení Brainu 159 x 107 pixelů.

Popsaný mřížkový diagram obrazovky VEX Brain zobrazující řádky, sloupce, rozměry v pixelech a souřadnice s červenými čarami ohraničujícími mřížku.

Níže je uveden seznam dostupných metod:

Tisk kurzoru – Zobrazení textu a správa kurzoru tisku.

  • print – Vypíše text, čísla nebo hodnoty proměnných na aktuální pozici kurzoru.

  • print_at – Vypíše text, čísla nebo hodnoty proměnných na zadaných souřadnicích x a y.

  • set_cursor – Přesune kurzor na konkrétní řádek a sloupec.

  • set_origin – Nastaví počátek použitý pro tisk a kreslení na základě souřadnic.

  • next_row – Přesune kurzor na další řádek.

  • clear_row – Vymaže řádek textu.

  • row – Vrátí řádek, kam bude vytištěn text.

  • column – Vrátí sloupec, do kterého bude vytištěn text.

  • get_string_width – Vrátí šířku řetězce v pixelech s použitím aktuálního písma.

  • get_string_height – Vrátí výšku řetězce v pixelech s použitím aktuálního písma.

Mutátory – Změňte nastavení obrazovky, barvy a chování při kreslení.

  • clear_screen – Vymaže všechny kresby a text z obrazovky Brain.

  • set_font – Nastaví typ písma použitého pro tisk textu na obrazovce Brainu.

  • set_pen_width – Nastavuje tloušťku nakreslených čar a obrysů tvarů.

  • set_pen_color – Nastaví barvu textu, pixelů, čar a obrysů tvarů.

  • set_fill_color – Nastaví barvu výplně pro nakreslené tvary a tištěné textové pozadí.

Kreslení – Vytvářejte tvary, čáry a grafiku na obrazovce Brain.

  • draw_pixel – Nakreslí jeden pixel na zadané souřadnici.

  • draw_line – Nakreslí čáru mezi dvěma body.

  • draw_rectangle – Nakreslí obdélník s použitím aktuálních barev pera a výplně.

  • draw_circle – Nakreslí kruh s použitím aktuálních barev pera a výplně.

  • draw_image_from_file – Nakreslí obrázek z SD karty.

  • render – Přepne kreslení na dvojité ukládání do vyrovnávací paměti a vykreslí obrazovku Brainu.

  • set_clip_region – Nastaví oblast ořezu pro vykreslení zadaného obdélníku.

Tisk kurzoru#

print#

print vytiskne text, čísla nebo hodnoty proměnných na obrazovku Brain na aktuální pozici kurzoru a s aktuálním písmem.

Používání:

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

Parametry

Popis

text

Text, číslo nebo hodnota proměnné, která se má vytisknout.

sep

Volitelné. Řetězec, který se má vložit mezi hodnoty. Musí být zapsán jako klíčový argument (sep=). Výchozí hodnota je “”.

precision

Volitelné. Počet desetinných míst, které se mají zobrazit při tisku jednoduchých čísel. Musí být zapsán jako klíčový argument (precision=). Výchozí hodnota je 2.

 
brain.screen.print("Hello, Robot!")

Snímek obrazovky EXP Brainu zobrazující na obrazovce text „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='-')

set_cursor#

set_cursor přesune kurzor na konkrétní řádek a sloupec na obrazovce Brain. Další volání print začne tisknout na tomto místě. Rozteč řádků a sloupců bude zohledňovat vybrané písmo. Výchozí pozice kurzoru je Řádek 1, Sloupec 1.

Používání:

brain.screen.set_cursor(row, column)

Parametry

Popis

row

Řádek, na který se má kurzor přesunout.

column

Sloupec, do kterého se má kurzor přesunout.

 
# Display text starting at Row 3 Column 10.
brain.screen.set_cursor(3, 10)
brain.screen.print("R3, C10")

Snímek obrazovky EXP Brainu zobrazující na obrazovce nápis „R3, C10“.

set_origin#

set_origin nastavuje počátek používaný pro kreslení a tisk na základě souřadnic na obrazovce Brain. Ve výchozím nastavení je počátkem levý horní roh obrazovky.

Používání:

brain.screen.set_origin(x, y)

Parametry

Popis

x

Pozice počátku souřadnic na ose x vzhledem k levému hornímu rohu, od 0 do 159.

y

Pozice počátku souřadné souřadnice na ose y vzhledem k levému hornímu rohu, od 0 do 107.

next_row#

next_row přesune kurzor do sloupce 1 na dalším řádku na obrazovce Brain.

Používání:

brain.screen.next_row()

Parametry

Popis

Tato metoda nemá žádné parametry.

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

Snímek obrazovky EXP Brainu zobrazující text „3“ na 3. řádku.

clear_row#

clear_row vymaže jeden řádek textu na obrazovce Brain.

Používání:

brain.screen.clear_row(row)

Parametry

Popis

row

Volitelné. Řádek, který se má vymazat. Výchozí hodnota je aktuální řádek kurzoru.

color

Volitelné. Platný ColorType, hexadecimální hodnota nebo webový řetězec.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Můžete také zadat vlastní barvu.

 
# 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 vrací řádek, kde bude text vytištěn jako celé číslo.

Používání:

brain.screen.row()

Parametry

Popis

Tato metoda nemá žádné parametry.

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

Snímek obrazovky EXP Brainu zobrazující text „3“ na 3. řádku.

column#

column vrací sloupec, kam bude text vytištěn jako celé číslo.

Používání:

brain.screen.column()

Parametry

Popis

Tato metoda nemá žádné parametry.

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

Snímek obrazovky EXP Brainu zobrazující text „10“ ve sloupci 10.

get_string_width#

get_string_width vrací šířku řetězce v pixelech jako celé číslo s použitím aktuálního fontu.

Používání:

brain.screen.get_string_width(string)

Parametry

Popis

string

Řetězec k měření.

get_string_height#

get_string_height vrací výšku řetězce v pixelech jako celé číslo s použitím aktuálního fontu.

Používání:

brain.screen.get_string_height(string)

Parametry

Popis

string

Řetězec k měření.

Mutátory#

clear_screen#

clear_screen vymaže všechny kresby a text z obrazovky mozku.

Používání:

brain.screen.clear_screen(color)

Parametry

Popis

color

Volitelné. Platný ColorType, hexadecimální hodnota nebo webový řetězec.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Můžete také zadat vlastní barvu.

 
# 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 nastavuje písmo použité pro zobrazení textu na obrazovce Brain. Toto písmo se použije na veškerý text vytištěný po spuštění této metody.

Používání:

brain.screen.set_font(fontname)

Parametry

Popis

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.

Mozek vytiskl čísla a písmena na sítotisk s velikostí písma MONO 12. Zobrazuje písmena od A do Z a všechna čísla. Ve spodní části obrazovky je uvedeno 9 řádků, 26 sloupců.
MONO12

Mozek vytiskl na obrazovce čísla a písmena s velikostí písma MONO 15. Zobrazuje písmena od A do T a všechna čísla. Ve spodní části obrazovky je uvedeno 7 řádků, 22 sloupců.
MONO15

Mozek vytiskl na obrazovce čísla a písmena s velikostí písma MONO 20. Zobrazuje písmena od A do P a všechna čísla. Ve spodní části obrazovky je uvedeno 5 řádků, 16 sloupců.
MONO20

Mozek vytiskl na obrazovce čísla a písmena o velikosti písma MONO 30. Zobrazuje písmena od A do J. Ve spodní části obrazovky je uvedeno R:3 C:10.
MONO30

Mozek vytiskl na obrazovce čísla a písmena o velikosti písma MONO 40. Ve spodní části obrazovky je uvedeno R:2 C:8.
MONO40

Čísla a písmena vytištěná na sítotisku Brain s velikostí písma MONO 60. Zobrazuje se pouze MON60.
MONO60

Mozek vytiskl na obrazovce čísla a písmena s velikostí písma PROP 20. Zobrazuje písmena od A do W a všechna čísla. Ve spodní části obrazovky je uvedeno 5 řádků, 16 sloupců.
PROP20

Mozek vytiskl na obrazovce čísla a písmena s velikostí písma PROP 30. Zobrazuje písmena od A do P. Ve spodní části obrazovky je uvedeno R:3 C:10.
PROP30

Mozek vytiskl na obrazovce čísla a písmena s velikostí písma PROP 40. Ve spodní části obrazovky je uvedeno R:2 C:8.
PROP40

Čísla a písmena vytištěná na sítotisku Brain s velikostí písma PROP 60. Zobrazuje se pouze PROP60.
PROP60

 

# Set the font type to MONO40.
brain.screen.set_font(FontType.MONO40)
brain.screen.print("VEX")

Snímek obrazovky EXP Brainu zobrazující text „VEX“ větším písmem než ve výchozím nastavení.

set_pen_width#

set_pen_width nastavuje tloušťku kreslených čar a obrysů tvarů.

Používání:

brain.screen.set_pen_width(width)

Parametry

Popis

width

Šířka pera v pixelech od 0 do 32.

 
# Draw a rectangle with a pen width of 10.
brain.screen.set_pen_width(10)
brain.screen.draw_rectangle(20, 20, 75, 50)

Snímek obrazovky EXP Brainu zobrazující obdélník s tlustými okraji.

set_pen_color#

set_pen_color nastavuje barvu textu, pixelů, čar a obrysů tvarů.

Používání:

brain.screen.set_pen_color(color)

Parametry

Popis

color

Barva pera a písma, která se má použít. Může se jednat o platný ColorType, hexadecimální hodnotu nebo webový řetězec.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Můžete také zadat vlastní barvu.

 
# Draw a rectangle with orange borders.
brain.screen.set_pen_color(Color.ORANGE)
brain.screen.draw_rectangle(20, 20, 75, 50)

Snímek obrazovky EXP Brainu zobrazující obdélník s oranžovými okraji.

# 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 nastavuje barvu výplně použitou pro kreslení obdélníků a kruhů.

Používání:

brain.screen.set_fill_color(color)

Parametry

Popis

color

Barva výplně, která se má použít. Může se jednat o platný ColorType, hexadecimální hodnotu nebo webový řetězec.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Můžete také zadat vlastní barvu.

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

Snímek obrazovky EXP Brainu zobrazující obdélník vyplněný fialovou barvou.

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

Remíza#

draw_pixel#

draw_pixel nakreslí jeden pixel na vybrané souřadnici x a y s použitím aktuální barvy pera.

Používání:

brain.screen.draw_pixel(x, y)

Parametry

Popis

x

Souřadnice x pro vykreslení pixelu, od 0 do 159, vztažená k počátku obrazovky.

y

Souřadnice y pro vykreslení pixelu, od 0 do 107, vztažená k počátku obrazovky.

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

Snímek obrazovky EXP Brainu zobrazující směs pixelů znázorňujících rohy čtverce.

draw_line#

draw_line nakreslí čáru z první souřadnice obrazovky (x1, y1) do druhé souřadnice obrazovky (x2, y2) s použitím aktuální šířky pera a barvy pera.

Používání:

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

Parametry

Popis

x1

Souřadnice x začátku řádku v pixelech, od 0 do 159, vztažená k počátku obrazovky.

y1

Souřadnice y začátku řádku v pixelech, od 0 do 107, vztažená k počátku obrazovky.

x2

Souřadnice x konce řádku v pixelech, od 0 do 159, vztažená k počátku obrazovky.

y2

Souřadnice y konce řádku v pixelech, od 0 do 107, vztažená k počátku obrazovky.

 
# Draw a line from the top left to bottom right of the screen.
brain.screen.draw_line(0, 0, 159, 107)

Obrazovka Brainu ukazuje tenkou diagonální čáru přes střed, od levého horního rohu k pravému dolnímu rohu.

draw_rectangle#

draw_rectangle nakreslí obdélník s použitím aktuálních hodnot per width, per colour a fill color, pokud není použit volitelný parametr color.

Používání:

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

Parametry

Popis

x

Souřadnice x levého horního rohu obdélníku v pixelech, od 0 do 159, vztažená k počátku obrazovky.

y

Souřadnice y levého horního rohu obdélníku v pixelech, od 0 do 107, vztažená k počátku obrazovky.

width

Šířka obdélníku.

height

Výška obdélníku.

color

Volitelné. Platný ColorType, hexadecimální hodnota nebo webový řetězec.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Můžete také zadat vlastní barvu.

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

Na obrazovce Brainu se zobrazí obdélník s tenkým bílým okrajem.

# 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 nakreslí kruh s použitím aktuálních parametrů pen width, pen color a fill color, pokud není použit volitelný parametr color.

Používání:

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

Parametry

Popis

x

Souřadnice x středu kruhu v pixelech, od 0 do 159, vztažená k počátku obrazovky.

y

Souřadnice y středu kruhu v pixelech, od 0 do 107, vztažená k počátku obrazovky.

radius

Poloměr kružnice.

color

Volitelné. Platný ColorType, hexadecimální hodnota nebo webový řetězec.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Můžete také zadat vlastní barvu.

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

Obrazovka Mozku ukazuje kruh s tenkým bílým okrajem uprostřed.

# 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 nakreslí obrázek z SD karty. Název souboru, který zadáte při volání metody, musí být umístěn na SD kartě.

Používání:

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

Parametry

Popis

filename

Název souboru s obrázkem.

x

Souřadnice x pro levý horní roh obrázku na obrazovce.

y

Souřadnice y pro levý horní roh obrázku na obrazovce.

 
# 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 přepne kreslení na dvojité ukládání do vyrovnávací paměti a vykreslí obrazovku Brainu. Po zavolání se další kreslení na obrazovce Brainu neobjeví, dokud nebude znovu zavolán render.

  • True , pokud byl buffer úspěšně vykreslen na obrazovku.

  • False , pokud se vyrovnávací paměť nepodařilo úspěšně vykreslit na obrazovku.

Používání:

brain.screen.render()

Parametry

Popis

Tato metoda nemá žádné parametry.

set_clip_region#

set_clip_region definuje obdélníkovou oblast na obrazovce, kde budou umístěny všechny kresby a text. Veškerý obsah mimo tuto oblast se nezobrazí.

Používání:

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

Parametry

Popis

x

Pozice x levého horního rohu obdélníku vztažená k počátku obrazovky.

y

Pozice y levého horního rohu obdélníku vztažená k počátku obrazovky.

width

Šířka obdélníku.

height

Výška obdélníku.
On this page