Екран#

Вступ#

Методи Screen контролюють, як EXP Brain відображає текст, числа та графіку на екрані.

За замовчуванням шрифт для друку в Brain — моноширинний малий, який має 7 рядків і 20 стовпців.

Для малювання роздільна здатність Brain становить 159 x 107 пікселів.

Схема з позначками на екрані VEX Brain, що показує рядки, стовпці, розміри пікселів та координати, з червоними лініями, що окреслюють сітку.

Нижче наведено список доступних методів:

Друк курсора – відображення тексту та керування курсором друку.

  • print – Друкує текст, числа або значення змінних у поточній позиції курсора.

  • print_at – Друкує текст, числа або значення змінних у певних координатах x та y.

  • set_cursor – Переміщує курсор до певного рядка та стовпця.

  • set_origin – Встановлює початок координат, що використовується для друку та малювання на основі координат.

  • next_row – Переміщує курсор до наступного рядка.

  • clear_row – Очищає рядок тексту.

  • row – Повертає рядок, у який буде надруковано текст.

  • column – Повертає стовпець, у якому буде надруковано текст.

  • get_string_width – Повертає ширину рядка в пікселях, використовуючи поточний шрифт.

  • get_string_height – Повертає висоту рядка в пікселях, використовуючи поточний шрифт.

Мутатори – Змінюйте налаштування екрана, кольори та поведінку малювання.

  • clear_screen – Очищає всі малюнки та текст з екрана Brain.

  • set_font – Встановлює тип шрифту, який використовується для друку тексту на екрані Мозку.

  • set_pen_width – Встановлює товщину намальованих ліній та контурів фігур.

  • set_pen_color – Встановлює колір тексту, пікселів, ліній та контурів фігур.

  • set_fill_color – Встановлює колір заливки для намальованих фігур та фону друкованого тексту.

Малювання – створюйте фігури, лінії та графіку на екрані Brain.

  • draw_pixel – Малює один піксель за заданою координатою.

  • draw_line – Малює лінію між двома точками.

  • draw_rectangle – Малює прямокутник, використовуючи поточні кольори пера та заливки.

  • draw_circle – Малює коло, використовуючи поточні кольори пера та заливки.

  • draw_image_from_file – Знімає зображення з SD-карти.

  • render – Перемикає малювання на подвійну буферизацію та рендерить екран Brain.

  • set_clip_region – Встановлює область відсікання для малювання наданого прямокутника.

Курсор друку#

print#

print друкує текст, числа або значення змінних на екрані Brain у поточній позиції курсора та з поточним шрифтом.

Використання:

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

Параметри

Опис

text

Текст, число або значення змінної, яке потрібно вивести.

sep

Необов’язково. Рядок для вставки між значеннями. Його потрібно записати як ключовий аргумент (sep=). Значення за замовчуванням — “”.

precision

Необов’язково. Кількість знаків після коми, які відображатимуться під час друку простих чисел. Це має бути записано як ключовий аргумент (precision=). Значення за замовчуванням — 2.

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

Знімок екрана мозку EXP, на якому написано "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 переміщує курсор до певного рядка та стовпця на екрані Brain. Наступний виклик print почне друк у цьому місці. Інтервал між рядками та стовпцями враховуватиме вибраний шрифт. Позиція курсора за замовчуванням – Рядок 1, Стовпець 1.

Використання:

brain.screen.set_cursor(row, column)

Параметри

Опис

row

Рядок, до якого потрібно перемістити курсор.

column

Стовпець, до якого потрібно перемістити курсор.

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

Знімок екрана мозку EXP, на якому написано "R3, C10".

set_origin#

set_origin встановлює початок координат, який використовується для малювання та друку на основі координат на екрані Brain. За замовчуванням початком координат є верхній лівий кут екрана.

Використання:

brain.screen.set_origin(x, y)

Параметри

Опис

x

Положення початку координат за осю x відносно верхнього лівого кута, від 0 до 159.

y

Положення початку координат за y відносно верхнього лівого кута, від 0 до 107.

next_row#

next_row переміщує курсор до стовпця 1 наступного рядка на екрані Brain.

Використання:

brain.screen.next_row()

Параметри

Опис

Цей метод не має параметрів.

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

Знімок екрана мозку EXP, на якому показано текст "3" у рядку 3.

clear_row#

clear_row очищає один рядок тексту на екрані Brain.

Використання:

brain.screen.clear_row(row)

Параметри

Опис

row

Необов’язково. Рядок, який потрібно очистити. За замовчуванням використовується поточний рядок курсора.

color

Необов’язково. Дійсний ColorType, шістнадцяткове значення або веб-рядок.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Ви також можете вказати власний колір.

 
# 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 повертає рядок, у якому текст буде надруковано як ціле число.

Використання:

brain.screen.row()

Параметри

Опис

Цей метод не має параметрів.

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

Знімок екрана мозку EXP, на якому показано текст "3" у рядку 3.

column#

column повертає стовпець, у якому текст буде надруковано як ціле число.

Використання:

brain.screen.column()

Параметри

Опис

Цей метод не має параметрів.

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

Знімок екрана EXP Brain, на якому показано текст "10" у стовпці 10.

get_string_width#

get_string_width повертає ширину рядка в пікселях як ціле число, використовуючи поточний font.

Використання:

brain.screen.get_string_width(string)

Параметри

Опис

string

Нитка для вимірювання.

get_string_height#

get_string_height повертає висоту рядка в пікселях як ціле число, використовуючи поточний font.

Використання:

brain.screen.get_string_height(string)

Параметри

Опис

string

Нитка для вимірювання.

Мутатори#

clear_screen#

clear_screen очищає всі малюнки та текст з екрана Мозку.

Використання:

brain.screen.clear_screen(color)

Параметри

Опис

color

Необов’язково. Дійсний ColorType, шістнадцяткове значення або веб-рядок.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Ви також можете вказати власний колір.

 
# 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 встановлює шрифт, який використовується для відображення тексту на екрані Brain. Цей шрифт застосовуватиметься до всього тексту, що друкується після виконання цього методу.

Використання:

brain.screen.set_font(fontname)

Параметри

Опис

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.

Мозок надрукував на екрані цифри та літери шрифтом MONO 12 розміром. На екрані показано літери від A до Z та всі цифри. Внизу екрана написано 9 рядків, 26 стовпців.
MONO12

Мозок надрукував цифри та літери на екрані шрифтом MONO 15 розміром. На ньому показано літери від A до T та всі цифри. Внизу екрана написано 7 рядків, 22 стовпці.
MONO15

Мозок надрукував на екрані цифри та літери розміром шрифту MONO 20. На ньому показано цифри від A до P. Внизу екрана написано 5 рядків, 16 стовпців.
MONO20

Цифри та літери на екрані Brain надруковані шрифтом MONO 30 розміром. Показано літери від A до J. Внизу екрана написано R:3 C:10.
MONO30

Мозок надрукував цифри та літери шрифтом розміром MONO 40. Внизу екрана написано R:2 C:8.
MONO40

Цифри та літери, надруковані на екрані Brain, розміром шрифту MONO 60. Відображається лише MON60.
MONO60

На екрані Brain надруковано цифри та літери розміром шрифту PROP 20. Показано літери від A до W та всі цифри. Внизу екрана написано 5 рядків, 16 стовпців.
PROP20

Цифри та літери на екрані мозку були надруковані шрифтом PROP 30 розміром. Показано літери від A до P. Внизу екрана написано R:3 C:10.
PROP30

Мозок надрукував цифри та літери шрифтом PROP 40 розміром. Внизу екрана написано R:2 C:8.
PROP40

Цифри та літери, надруковані на екрані TThe Brain розміром шрифту PROP 60. Відображається лише PROP60.
PROP60

 

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

Знімок екрана EXP Brain, на якому текст "VEX" зображено більшим шрифтом, ніж за замовчуванням.

set_pen_width#

set_pen_width встановлює товщину намальованих ліній та контурів фігур.

Використання:

brain.screen.set_pen_width(width)

Параметри

Опис

width

Ширина пера, у пікселях, від 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)

Знімок екрана EXP Brain, що показує прямокутник із товстими рамками.

set_pen_color#

set_pen_color встановлює колір тексту, пікселів, ліній та контурів фігур.

Використання:

brain.screen.set_pen_color(color)

Параметри

Опис

color

Колір пера та шрифту, який слід використовувати. Це може бути дійсний ColorType, шістнадцяткове значення або веб-рядок.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Виможете вказати власний колір.

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

Знімок екрана EXP Brain, що показує прямокутник з помаранчевими рамками.

# 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 встановлює колір заливки, який використовується для малювання прямокутників та кіл.

Використання:

brain.screen.set_fill_color(color)

Параметри

Опис

color

Колір заливки, який слід використовувати. Це може бути дійсний ColorType, шістнадцяткове значення або веб-рядок.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Ви також можете вказати власний колір.

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

Знімок екрана мозку EXP, на якому показано прямокутник, заповнений фіолетовим кольором.

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

Нічия#

draw_pixel#

draw_pixel малює один піксель у вибраних координатах x та y, використовуючи поточний колір пера.

Використання:

brain.screen.draw_pixel(x, y)

Параметри

Опис

x

Координата x для малювання пікселя, від 0 до 159, відносно початку координат екрана.

y

Координата Y для малювання пікселя, від 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)

Знімок екрана EXP Brain, що показує набір пікселів, що показують кути квадрата.

draw_line#

draw_line малює лінію від першої екранної координати (x1, y1) до другої екранної координати (x2, y2) використовуючи поточні значення ширина пера та колір пера.

Використання:

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

Параметри

Опис

x1

Координата x початку лінії в пікселях, від 0 до 159, відносно початку координат на екрані.

y1

Y-координата в пікселях початку лінії, від 0 до 107, відносно початку координат на екрані.

x2

Координата x кінця рядка в пікселях, від 0 до 159, відносно початку координат на екрані.

y2

Y-координата кінця рядка в пікселях, від 0 до 107, відносно початку координат на екрані.

 
# 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 малює прямокутник, використовуючи поточні значення ширина пера, колір пера та колір заливки, якщо не використовується необов’язковий параметр color.

Використання:

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

Параметри

Опис

x

Координата x верхнього лівого кута прямокутника в пікселях, від 0 до 159, відносно початку координат на екрані.

y

Y-координата в пікселях верхнього лівого кута прямокутника, від 0 до 107, відносно початку координат на екрані.

width

Ширина прямокутника.

height

Висота прямокутника.

color

Необов’язково. Дійсний ColorType, шістнадцяткове значення або веб-рядок.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Ви також можете вказати власний колір.

 
# 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 малює коло, використовуючи поточні значення ширина пера, колір пера та колір заливки, якщо не використовується необов’язковий параметр color.

Використання:

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

Параметри

Опис

x

Координата x центру кола в пікселях, від 0 до 159, відносно початку координат на екрані.

y

Y-координата в пікселях центру кола, від 0 до 107, відносно початку координат на екрані.

radius

Радіус кола.

color

Необов’язково. Дійсний ColorType, шістнадцяткове значення або веб-рядок.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Ви також можете вказати власний колір.

 
# 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 малює зображення з SD-карти. Ім’я файлу, яке ви вказуєте під час виклику методу, має бути розташоване на SD-карті.

Використання:

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

Параметри

Опис

filename

Ім’я файлу зображення.

x

Координата x для верхнього лівого кута зображення на екрані.

y

Координата Y для верхнього лівого кута зображення на екрані.

 
# 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 перемикає малювання в режим подвійної буферизації та рендерить екран Brain. Після виклику подальше малювання не з’являтиметься на екрані Brain до наступного виклику render.

  • True , якщо буфер успішно відобразився на екрані.

  • False , якщо буфер не було успішно відображено на екрані.

Використання:

brain.screen.render()

Параметри

Опис

Цей метод не має параметрів.

set_clip_region#

set_clip_region визначає прямокутну область на екрані, де будуть обмежені всі малюнки та текст. Будь-який контент за межами цієї області не відображатиметься.

Використання:

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

Параметри

Опис

x

Позиція верхнього лівого кута прямокутника за осю x відносно початку координат на екрані.

y

Позиція верхнього лівого кута прямокутника по осі Y відносно початку координат на екрані.

width

Ширина прямокутника.

height

Висота прямокутника.
On this page