화면#

소개#

Screen 메서드는 EXP Brain이 화면에 텍스트, 숫자 및 그래픽을 표시하는 방식을 제어합니다.

기본적으로 Brain에 인쇄할 때 사용하는 글꼴은 7행 20열의 고정폭 소형 글꼴입니다.

그림을 그릴 때 브레인의 해상도는 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 – Brain의 화면에 텍스트를 인쇄하는 데 사용되는 글꼴 유형을 설정합니다.

  • set_pen_width – 그려진 선과 도형 윤곽선의 두께를 설정합니다.

  • set_pen_color – 텍스트, 픽셀, 선 및 도형 윤곽선의 색상을 설정합니다.

  • set_fill_color – 그려진 도형과 인쇄된 텍스트 배경의 채우기 색상을 설정합니다.

그리기 – 브레인 화면에 도형, 선, 그래픽을 그려보세요.

  • 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.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, 16진수 값 또는 웹 문자열입니다.

  • 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 브레인의 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, 16진수 값 또는 웹 문자열입니다.

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

브레인의 화면에는 MONO 30 크기의 글꼴로 숫자와 문자가 인쇄되어 있습니다. A부터 J까지 표시되어 있으며, 화면 하단에는 R:3 C:10이라고 적혀 있습니다.
MONO30

브레인의 화면에는 MONO 40 크기의 글꼴로 숫자와 문자가 인쇄되어 있습니다. 화면 하단에는 R:2 C:8이라고 적혀 있습니다.
MONO40

브레인의 화면에 MONO 60 크기의 글꼴로 숫자와 문자가 인쇄되어 있습니다. MON60만 표시됩니다.
MONO60

브레인의 화면에는 PROP 20 크기의 글꼴로 숫자와 문자가 인쇄되어 있습니다. A부터 W까지 모든 숫자가 표시됩니다. 화면 하단에는 5행 16열이라고 적혀 있습니다.
PROP20

브레인의 화면에는 PROP 30 크기의 글꼴로 숫자와 문자가 인쇄되어 있습니다. A부터 P까지 표시되어 있으며, 화면 하단에는 R:3 C:10이라고 적혀 있습니다.
PROP30

브레인의 화면에 PROP 40 크기의 글꼴로 숫자와 문자가 인쇄되어 있습니다. 화면 하단에는 R:2 C:8이라고 적혀 있습니다.
PROP40

T브레인의 화면에 PROP 60 크기의 글꼴로 숫자와 문자가 인쇄되어 있습니다. PROP60만 표시됩니다.
PROP60

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

EXP 브레인의 스크린샷으로 "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 브레인의 스크린샷입니다.

set_pen_color#

set_pen_color 텍스트, 픽셀, 선 및 도형 윤곽선의 색상을 설정합니다.

용법:

brain.screen.set_pen_color(color)

매개변수

설명

color

사용할 펜과 글꼴 색상입니다. 유효한 ColorType, 16진수 값 또는 웹 문자열일 수 있습니다.

  • 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 브레인의 스크린샷입니다.

# 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, 16진수 값 또는 웹 문자열일 수 있습니다.

  • 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 브레인의 스크린샷으로 정사각형 모서리를 나타내는 다양한 픽셀이 표시됩니다.

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, 16진수 값 또는 웹 문자열입니다.

  • 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, 16진수 값 또는 웹 문자열입니다.

  • 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 드로잉 모드를 더블 버퍼링으로 전환하고 브레인의 화면을 렌더링합니다. 이 함수가 호출된 후에 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

직사각형의 높이.