화면#
소개#
화면 관련 메서드는 V5 브레인이 터치스크린에 텍스트, 숫자 및 그래픽을 표시하는 방식과 터치 입력에 반응하는 방식을 제어합니다.
기본적으로 Brain에 인쇄할 때 사용하는 글꼴은 고폭 고정폭 글꼴이며, 12행 48열로 구성됩니다.
그림을 그릴 때 브레인의 해상도는 480 x 240 픽셀입니다.
다음은 모든 방법 목록입니다.
커서 인쇄 - 텍스트를 놓고 인쇄합니다.
print— 현재 커서 위치에 텍스트, 숫자 또는 변수 값을 출력합니다.set_cursor— 커서를 특정 행과 열로 이동합니다.next_row— 커서를 다음 행의 1열로 이동합니다.clear_row— 텍스트 행을 지웁니다.row— 텍스트가 출력될 행을 반환합니다.column— 텍스트가 출력될 열을 반환합니다.print_at— 특정 x 및 y 좌표에 텍스트, 숫자 또는 변수 값을 출력합니다.get_string_width— 현재 글꼴을 사용하여 문자열의 너비를 픽셀 단위로 반환합니다.get_string_height— 현재 글꼴을 사용하여 문자열의 높이를 픽셀 단위로 반환합니다.clear_line— 텍스트의 한 줄을 지웁니다.new_line— 커서를 새 줄로 이동합니다.
뮤테이터 — 화면 설정, 색상 및 그리기 동작을 변경합니다.
clear_screen— 화면의 모든 그림과 텍스트를 지웁니다.set_font— 인쇄된 텍스트의 글꼴을 설정합니다.set_pen_width— 그려진 선과 도형 윤곽선의 두께를 설정합니다.set_pen_color— 텍스트, 픽셀, 선 및 도형 윤곽선의 색상을 설정합니다.set_fill_color— 그려진 도형과 인쇄된 텍스트 배경의 채우기 색상을 설정합니다.set_origin— 좌표 기반 인쇄 및 그리기에 사용되는 원점을 설정합니다.
그리기 — 화면에 그래픽을 추가합니다.
draw_pixel— 좌표에 픽셀 하나를 그립니다.draw_line— 두 점 사이에 선을 그립니다.draw_rectangle— 사각형을 그립니다.draw_circle— 원을 그립니다.render— 호출될 때만 텍스트와 그림으로 브레인의 화면을 업데이트합니다.set_clip_region— 그림과 텍스트가 나타날 수 있는 위치를 제한합니다.
게터 — 터치 상태 및 터치 위치를 확인합니다.
pressing누르기 — 화면이 눌러지고 있는지 여부를 반환합니다.x_position— 마지막 화면 누름의 x좌표를 반환합니다.y_position— 마지막 화면 누름의 y좌표를 반환합니다.
콜백 함수 — 화면 터치 이벤트에 응답합니다.
screen 메서드에 접근하기 위한 Brain 구성에 대한 정보는 Brain을 참조하세요.
커서 인쇄#
print#
print 은 현재 커서 위치와 글꼴로 Brain 화면에 텍스트, 숫자 또는 변수 값을 출력합니다.
용법:
brain.screen.print(text, sep, precision)
매개변수 |
설명 |
|---|---|
|
출력할 텍스트, 숫자 또는 변수 값입니다. |
|
선택 사항입니다. 값 사이에 삽입할 문자열입니다. 이는 키워드 인수(sep=)로 작성해야 합니다. 기본값은 |
|
선택 사항입니다. 간단한 숫자를 출력할 때 표시할 소수점 자릿수입니다. 이 값은 키워드 인수로 작성해야 합니다( |
# Print on the Brain's screen
brain.screen.print("Hello, Robot!")
set_cursor#
set_cursor Brain 화면의 특정 행과 열로 커서를 이동합니다. 다음 print 호출은 해당 위치에서 출력을 시작합니다. 편안하게 표시할 수 있는 행과 열의 수는 선택한 글꼴에 따라 다릅니다. 기본 고정폭 중간 글꼴을 사용하는 경우 최대 8행 13열까지 명확하게 표시할 수 있습니다. 이 범위를 벗어난 텍스트는 잘리거나 읽기 어려워질 수 있습니다.
고정폭 글꼴은 문자의 너비가 모두 같으므로 텍스트 배치가 일관적입니다. 이와 대조적으로 비례 글꼴은 문자 너비가 다양하므로 일부 문자는 다른 문자보다 더 많은 공간을 차지합니다. 그러나 어떤 유형을 사용하든 set_cursor 글꼴 스타일이 아닌 행과 열 크기를 기준으로 커서를 배치합니다. 글꼴 크기는 set_font를 사용하여 조정할 수 있습니다.
용법:
brain.screen.set_cursor(row, column)
매개변수 |
설명 |
|---|---|
|
커서를 이동할 행입니다. |
|
커서를 이동할 열입니다. |
# 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 커서를 다음 행으로 이동합니다.
용법:
brain.screen.next_row()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
# 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 Brain 화면에서 한 줄의 텍스트를 지웁니다.
용법:
brain.screen.clear_row(row, color)
매개변수 |
설명 |
|---|---|
|
선택 사항입니다. 지울 행을 지정합니다. 기본값은 현재 커서가 있는 행입니다. |
|
선택 사항입니다. 유효한 color, 16진수 값 또는 웹 문자열입니다. |
# 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 텍스트가 정수로 출력될 행을 반환합니다.
용법:
brain.screen.row()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
# Display the cursor's current row
brain.screen.set_cursor(3, 2)
brain.screen.print(brain.screen.row())
column#
column 은 텍스트가 정수로 출력될 열을 반환합니다.
용법:
brain.screen.column()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
# Display the cursor's current column
brain.screen.set_cursor(3, 15)
brain.screen.print(brain.screen.column())
print_at#
print_at 은 현재 font 및 origin을 사용하여 특정 x 및 y 좌표의 Brain 화면에 텍스트, 숫자 또는 변수 값을 출력합니다.
용법:
brain.screen.print_at(text, x, y, sep, precision, opaque)
매개변수 |
설명 |
|---|---|
|
출력할 텍스트, 숫자 또는 변수 값입니다. |
|
화면 원점을 기준으로 출력할 x 좌표를 키워드 인수로 지정합니다( |
|
화면 원점을 기준으로 출력할 y 좌표를 키워드 인수로 지정합니다( |
|
선택 사항입니다. 값 사이에 삽입할 문자열입니다. 이는 키워드 인수(sep=)로 작성해야 합니다. 기본값은 |
|
선택 사항입니다. 간단한 숫자를 출력할 때 표시할 소수점 자릿수입니다. 이 값은 키워드 인수로 작성해야 합니다( |
|
선택 사항입니다. 텍스트가 배경 픽셀을 지워야 하는지 여부를 나타내는 부울 값입니다. 기본값은 |
# Display text at the center of the screen
brain.screen.print_at("Center", x=220, y=120)
get_string_width#
get_string_width 현재 font를 사용하여 문자열의 너비를 픽셀 단위로 정수로 반환합니다.
Usage:
brain.screen.get_string_width(string)
매개변수 |
설명 |
|---|---|
|
측정할 줄. |
get_string_height#
get_string_height 현재 font를 사용하여 문자열의 높이를 픽셀 단위로 정수로 반환합니다.
Usage:
brain.screen.get_string_height(string)
매개변수 |
설명 |
|---|---|
|
측정할 줄. |
clear_line#
clear_line 은 현재 행의 텍스트를 지웁니다.
Usage:
brain.screen.clear_line()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
new_line#
new_line 브레인 화면의 다음 행의 1열로 커서를 이동합니다.
용법:
brain.screen.new_line()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
돌연변이체#
clear_screen#
clear_screen Brain 화면에서 모든 그림과 텍스트를 지웁니다.
용법:
brain.screen.clear_screen(color)
매개변수 |
설명 |
|---|---|
|
선택 사항입니다. 유효한 색상 옵션:
|
# 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 브레인 화면에 텍스트를 표시하는 데 사용되는 글꼴을 설정합니다. 이 글꼴은 이 메서드가 실행된 후 출력되는 모든 텍스트에 적용됩니다.
용법:
brain.screen.set_font(font)
매개변수 |
설명 |
|---|---|
|
아래에 유효한 글꼴 옵션이 있습니다. |
|
|
|
|---|---|---|
|
|
|
|
|
|
|
# Set the font type to MONO40
brain.screen.set_font(FontType.MONO40)
brain.screen.print("VEX")
set_pen_width#
set_pen_width 그려진 선과 도형 윤곽선의 두께를 설정합니다.
용법:
brain.screen.set_pen_width(value)
매개변수 |
설명 |
|---|---|
|
펜 너비는 픽셀 단위로 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 텍스트, 픽셀, 선 및 도형 윤곽선의 색상을 설정합니다.
용법:
brain.screen.set_pen_color(color)
매개변수 |
설명 |
|---|---|
|
사용할 펜과 글꼴 색상입니다. 옵션은 다음과 같습니다.
|
# 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 도형을 그릴 때 사용되는 채우기 색상을 설정합니다.
용법:
brain.screen.set_fill_color(color)
매개변수 |
설명 |
|---|---|
|
사용할 채우기 색상입니다. 옵션은 다음과 같습니다.
|
# Draw a purple rectangle
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(50, 130, 100, 60)
set_origin#
set_origin 은 Brain 화면에서 그리기 및 좌표 기반 인쇄에 사용되는 원점을 설정합니다. 기본적으로 원점은 화면의 왼쪽 상단 모서리입니다.
용법:
brain.screen.set_origin(x, y)
매개변수 |
설명 |
|---|---|
|
원점으로 설정할 x 좌표는 0부터 479까지입니다. |
|
원점으로 설정할 y 좌표는 0부터 239까지입니다. |
그리다#
draw_pixel#
draw_pixel 현재 펜 색상을 사용하여 선택한 x, y 좌표에 픽셀 하나를 그립니다.
용법:
brain.screen.draw_pixel(x, y)
매개변수 |
설명 |
|---|---|
|
화면 원점을 기준으로 픽셀을 그릴 x 좌표는 0에서 479 사이의 값입니다. |
|
화면 원점을 기준으로 픽셀을 그릴 y 좌표(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 은 현재 펜 굵기와 펜 색상을 사용하여 화면의 첫 번째 좌표에서 화면의 두 번째 좌표까지 선을 그립니다.
용법:
brain.screen.draw_line(start_x, start_y, end_x, end_y)
매개변수 |
설명 |
|---|---|
|
화면 원점을 기준으로 한 선의 시작점의 픽셀 단위 x 좌표(0~479). |
|
화면 원점을 기준으로 한 선의 시작점의 픽셀 단위 y 좌표(0~239). |
|
화면 원점을 기준으로 한 줄 끝의 픽셀 단위 x 좌표(0~479). |
|
화면 원점을 기준으로 한 선 끝의 y 좌표(픽셀 단위, 0~239)입니다. |
# 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 은 선택적 color 매개변수가 사용되지 않는 한 현재 펜 두께, 펜 색상 및 채우기 색상을 사용하여 사각형을 그립니다.
용법:
brain.screen.draw_rectangle(x, y, width, height, color)
매개변수 |
설명 |
|---|---|
|
사각형의 왼쪽 상단 모서리의 x 좌표는 0에서 479까지의 픽셀 값입니다. |
|
사각형의 왼쪽 상단 모서리의 y 좌표는 0부터 239까지의 픽셀 값입니다. |
|
직사각형의 너비. |
|
직사각형의 높이. |
|
선택 사항입니다. 유효한 색상 옵션:
|
# Draw a rectangle on the screen
brain.screen.draw_rectangle(50, 50, 130, 60)
draw_circle#
draw_circle 은 선택적 color 매개변수가 사용되지 않는 한 현재 펜 두께, 펜 색상 및 채우기 색상을 사용하여 원을 그립니다.
용법:
brain.screen.draw_circle(x, y, radius, color)
매개변수 |
설명 |
|---|---|
|
화면 원점을 기준으로 한 원 중심의 픽셀 단위 x 좌표(0~479). |
|
화면 원점을 기준으로 한 원 중심의 y 좌표(픽셀 단위, 0~239)입니다. |
|
원의 반지름(픽셀 단위). |
|
선택 사항입니다. 사용할 채우기 색상입니다. 옵션은 다음과 같습니다.
|
# Draw a circle on the screen
brain.screen.draw_circle(120, 120, 40)
render#
render Brain 화면에 더블 버퍼링을 활성화합니다. 이 함수가 호출되면 텍스트, 도형 또는 이미지와 같은 모든 그리기 명령은 프로젝트의 나머지 기간 동안 즉시 표시되지 않습니다. 대신, render 다시 사용될 때만 업데이트된 내용이 표시됩니다. 이를 통해 더욱 부드럽고 제어된 화면 업데이트가 가능하지만, render 사용될 때까지는 아무것도 보이지 않게 됩니다.
용법:
brain.screen.render()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
# 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 은 화면에서 모든 그림과 텍스트가 표시될 직사각형 영역을 정의합니다. 이 영역 밖의 콘텐츠는 표시되지 않습니다.
용법:
brain.screen.set_clip_region(x, y, width, height)
매개변수 |
설명 |
|---|---|
|
화면 원점을 기준으로 한 직사각형 왼쪽 상단 모서리의 x 좌표입니다. |
|
화면 원점을 기준으로 한 직사각형 좌측 상단 모서리의 y 좌표입니다. |
|
직사각형의 너비. |
|
직사각형의 높이. |
# 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)
만지다#
pressing#
pressing 반환되며, 현재 브레인 화면이 눌러져 있는지 여부를 나타내는 부울 값이 반환됩니다.
True- 화면이 눌리고 있습니다.False- 화면이 눌리지 않았습니다.
용법:
brain.screen.pressing()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
# 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 은 마지막으로 화면을 누른 위치의 x 좌표를 0(왼쪽)부터 479(오른쪽)까지의 정수로 반환합니다.
용법:
brain.screen.x_position()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
# 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 은 마지막으로 화면을 누른 위치의 y 좌표를 0(상단)부터 239(하단)까지의 정수로 반환합니다.
용법:
brain.screen.y_position()
매개변수 |
설명 |
|---|---|
이 메서드에는 매개변수가 없습니다. |
# 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)
콜백#
pressed#
pressed 표시되고, 브레인의 화면이 눌렸을 때 호출될 함수가 등록됩니다.
용법:
brain.screen.pressed(callback, arg)
매개변수 |
설명 |
|---|---|
|
Brain 화면이 눌렸을 때 실행되는 이전에 정의된 함수. |
|
선택 사항입니다. 콜백 함수에 전달할 인수를 포함하는 튜플입니다. 자세한 내용은 매개변수가 있는 함수 사용을 참조하세요. |
def my_function():
brain.screen.print("Screen pressed")
# Call my_function whenever the Brain screen is pressed
brain.screen.pressed(my_function)
released#
released 화면에서 손을 떼면(터치가 제거되면) 호출될 함수를 등록합니다.
용법:
brain.screen.released(callback, arg)
매개변수 |
설명 |
|---|---|
|
Brain 화면이 해제될 때 실행되는 이전에 정의된 함수. |
|
선택 사항입니다. 콜백 함수에 전달할 인수를 포함하는 튜플입니다. 자세한 내용은 매개변수가 있는 함수 사용을 참조하세요. |
def my_function():
brain.screen.print("Screen released")
# Call my_function whenever the Brain screen is released
brain.screen.released(my_function)