Màn hình#

Giới thiệu#

Các phương thức Màn hình điều khiển cách EXP Brain hiển thị văn bản, số và đồ họa trên màn hình của nó.

Mặc định, phông chữ dùng để in lên Brain là phông chữ đơn cách nhỏ với 7 hàng và 20 cột.

Đối với việc vẽ, độ phân giải của Brain là 159 x 107 pixel.

Sơ đồ lưới có chú thích của màn hình VEX Brain hiển thị các hàng, cột, kích thước pixel và tọa độ, với các đường màu đỏ phác thảo lưới.

Dưới đây là danh sách các phương pháp có sẵn:

In bằng con trỏ – Hiển thị văn bản và quản lý con trỏ in.

  • print – In văn bản, số hoặc giá trị biến tại vị trí con trỏ hiện tại.

  • print_at – In văn bản, số hoặc giá trị biến tại tọa độ x và y cụ thể.

  • set_cursor – Di chuyển con trỏ đến một hàng và cột cụ thể.

  • set_origin – Đặt gốc tọa độ được sử dụng để in và vẽ dựa trên tọa độ.

  • next_row – Di chuyển con trỏ đến hàng tiếp theo.

  • clear_row – Xóa một hàng văn bản.

  • row – Trả về hàng mà văn bản sẽ được in.

  • column – Trả về cột mà văn bản sẽ được in.

  • get_string_width – Trả về chiều rộng của một chuỗi tính bằng pixel sử dụng phông chữ hiện tại.

  • get_string_height – Trả về chiều cao của một chuỗi tính bằng pixel sử dụng phông chữ hiện tại.

Bộ điều chỉnh – Thay đổi cài đặt màn hình, màu sắc và hành vi vẽ.

  • clear_screen – Xóa tất cả hình vẽ và văn bản khỏi màn hình Brain.

  • set_font – Đặt kiểu phông chữ được sử dụng để in văn bản trên màn hình của Brain.

  • set_pen_width – Đặt độ dày của các đường vẽ và đường viền hình dạng.

  • set_pen_color – Đặt màu cho văn bản, pixel, đường kẻ và đường viền hình dạng.

  • set_fill_color – Đặt màu tô cho các hình vẽ và nền văn bản in.

Vẽ – Tạo hình dạng, đường thẳng và đồ họa trên màn hình Brain.

  • draw_pixel – Vẽ một pixel tại tọa độ.

  • draw_line – Vẽ một đường thẳng giữa hai điểm.

  • draw_rectangle – Vẽ một hình chữ nhật bằng bút hiện tại và màu tô.

  • draw_circle – Vẽ một hình tròn bằng bút hiện tại và màu tô.

  • draw_image_from_file – Vẽ một hình ảnh từ thẻ SD.

  • render – Chuyển chế độ vẽ sang đệm kép và hiển thị màn hình của Brain.

  • set_clip_region – Đặt vùng cắt để vẽ hình chữ nhật được cung cấp.

In bằng con trỏ#

print#

print in văn bản, số hoặc giá trị biến lên màn hình Brain tại vị trí con trỏ hiện tại và phông chữ hiện tại.

Cách sử dụng:

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

Thông số

Sự miêu tả

text

Văn bản, số hoặc giá trị biến cần in.

sep

Tùy chọn. Một chuỗi để chèn giữa các giá trị. Chuỗi này phải được viết dưới dạng đối số từ khóa (sep=). Giá trị mặc định là “”.

precision

Tùy chọn. Số lượng chữ số thập phân hiển thị khi in các số đơn giản. Tham số này phải được viết dưới dạng đối số từ khóa (precision=). Giá trị mặc định là 2.

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

Ảnh chụp màn hình EXP Brain hiển thị dòng chữ "Hello Robot" trên màn hình.

# 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 di chuyển con trỏ đến một hàng và cột cụ thể trên màn hình Brain. Lệnh print tiếp theo sẽ bắt đầu in tại vị trí đó. Khoảng cách hàng và cột sẽ tính đến phông chữ đã chọn. Vị trí con trỏ mặc định là Hàng 1, Cột 1.

Cách sử dụng:

brain.screen.set_cursor(row, column)

Thông số

Sự miêu tả

row

Hàng cần di chuyển con trỏ đến.

column

Cột cần di chuyển con trỏ đến.

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

Ảnh chụp màn hình EXP Brain hiển thị "R3, C10" được in trên màn hình.

set_origin#

set_origin thiết lập gốc tọa độ được sử dụng để vẽ và in dựa trên tọa độ trên màn hình Brain. Theo mặc định, gốc tọa độ là góc trên bên trái của màn hình.

Cách sử dụng:

brain.screen.set_origin(x, y)

Thông số

Sự miêu tả

x

Vị trí x của gốc tọa độ so với góc trên bên trái, từ 0 đến 159.

y

Vị trí trục y của điểm gốc so với góc trên bên trái, từ 0 đến 107.

next_row#

Lệnh next_row di chuyển con trỏ đến cột 1 trên hàng tiếp theo trên màn hình Brain.

Cách sử dụng:

brain.screen.next_row()

Thông số

Sự miêu tả

Phương pháp này không có tham số.

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

Ảnh chụp màn hình EXP Brain hiển thị văn bản "3" ở hàng 3.

clear_row#

clear_row xóa một hàng văn bản trên màn hình Brain.

Cách sử dụng:

brain.screen.clear_row(row)

Thông số

Sự miêu tả

row

Tùy chọn. Hàng cần xóa. Mặc định là hàng hiện tại của con trỏ.

color

Optional. A valid ColorType, a hex value, or a web string.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
You can also specify a custom color.

 
# 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 trả về số hàng mà văn bản sẽ được in dưới dạng số nguyên.

Cách sử dụng:

brain.screen.row()

Thông số

Sự miêu tả

Phương pháp này không có tham số.

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

Ảnh chụp màn hình EXP Brain hiển thị văn bản "3" ở hàng 3.

column#

column trả về số nguyên chỉ định cột sẽ in văn bản.

Cách sử dụng:

brain.screen.column()

Thông số

Sự miêu tả

Phương pháp này không có tham số.

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

Ảnh chụp màn hình EXP Brain hiển thị văn bản "10" ở cột 10.

get_string_width#

get_string_width trả về chiều rộng của một chuỗi tính bằng pixel dưới dạng số nguyên, sử dụng font.

Cách sử dụng:

brain.screen.get_string_width(string)

Thông số

Sự miêu tả

string

Sợi dây dùng để đo.

get_string_height#

get_string_height trả về chiều cao của một chuỗi tính bằng pixel dưới dạng số nguyên, sử dụng font.

Cách sử dụng:

brain.screen.get_string_height(string)

Thông số

Sự miêu tả

string

Sợi dây dùng để đo.

Biến đổi#

clear_screen#

clear_screen xóa tất cả hình vẽ và văn bản khỏi màn hình của Brain.

Cách sử dụng:

brain.screen.clear_screen(color)

Thông số

Sự miêu tả

color

Optional. A valid ColorType, a hex value, or a web string.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
You can also specify a custom color.

 
# 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 thiết lập phông chữ được sử dụng để hiển thị văn bản trên màn hình Brain. Phông chữ này sẽ được áp dụng cho tất cả văn bản được in sau khi phương thức này chạy.

Cách sử dụng:

brain.screen.set_font(fontname)

Thông số

Sự miêu tả

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.

Màn hình của Brain in các số và chữ cái với cỡ chữ MONO 12. Nó hiển thị các chữ cái từ A đến Z và tất cả các số. Ở cuối màn hình, nó ghi 9 hàng, 26 cột.
MONO12

Màn hình của Brain in các số và chữ cái với cỡ chữ MONO 15. Nó hiển thị các chữ cái từ A đến T và tất cả các số. Ở cuối màn hình, nó ghi 7 hàng, 22 cột.
MONO15

Màn hình của Brain in các số và chữ cái với cỡ chữ MONO 20. Nó hiển thị các chữ cái từ A đến P và tất cả các số. Ở cuối màn hình, nó ghi 5 hàng, 16 cột.
MONO20

Màn hình của Brain in các số và chữ cái với cỡ chữ MONO 30. Nó hiển thị các chữ cái từ A đến J. Ở dưới cùng của màn hình, nó ghi R:3 C:10.
MONO30

Màn hình của Brain in các số và chữ cái với cỡ chữ MONO 40. Ở cuối màn hình, nó ghi R:2 C:8.
MONO40

Màn hình của Brain in các số và chữ cái với cỡ chữ MONO 60. Chỉ hiển thị MON60.
MONO60

Màn hình của Brain in các số và chữ cái với cỡ chữ PROP 20. Nó hiển thị các chữ cái từ A đến W và tất cả các số. Ở cuối màn hình, nó ghi 5 hàng, 16 cột.
PROP20

Màn hình của Brain in các số và chữ cái với cỡ chữ PROP 30. Nó hiển thị các chữ cái từ A đến P. Ở dưới cùng của màn hình, nó ghi R:3 C:10.
PROP30

Màn hình của Brain in các số và chữ cái với cỡ chữ PROP 40. Ở cuối màn hình, nó ghi R:2 C:8.
PROP40

Màn hình của Brain in các số và chữ cái với cỡ chữ PROP 60. Chỉ PROP60 được hiển thị.
PROP60

 

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

Ảnh chụp màn hình EXP Brain hiển thị văn bản "VEX" với phông chữ lớn hơn so với mặc định.

set_pen_width#

set_pen_width thiết lập độ dày của các đường vẽ và đường viền hình dạng.

Cách sử dụng:

brain.screen.set_pen_width(width)

Thông số

Sự miêu tả

width

Độ rộng của bút, tính bằng pixel, từ 0 đến 32.

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

Ảnh chụp màn hình EXP Brain hiển thị một hình chữ nhật có viền dày.

set_pen_color#

set_pen_color thiết lập màu sắc cho văn bản, pixel, đường kẻ và đường viền hình dạng.

Cách sử dụng:

brain.screen.set_pen_color(color)

Thông số

Sự miêu tả

color

Màu bút và màu phông chữ cần sử dụng. Đây có thể là một ColorType hợp lệ, một giá trị thập lục phân hoặc một chuỗi web.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Bạn cũng có thể chỉ định một màu tùy chỉnh.

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

Ảnh chụp màn hình EXP Brain hiển thị một hình chữ nhật có viền màu cam.

# 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 thiết lập màu tô được sử dụng để vẽ hình chữ nhật và hình tròn.

Cách sử dụng:

brain.screen.set_fill_color(color)

Thông số

Sự miêu tả

color

Màu tô cần sử dụng. Đây có thể là một ColorType hợp lệ, một giá trị thập lục phân hoặc một chuỗi web.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
Bạn cũng có thể chỉ định một màu tùy chỉnh.

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

Ảnh chụp màn hình EXP Brain hiển thị một hình chữ nhật được tô màu tím.

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

Vẽ tranh#

draw_pixel#

draw_pixel draws one pixel at the selected x and y coordinate using the current pen color.

Cách sử dụng:

brain.screen.draw_pixel(x, y)

Thông số

Sự miêu tả

x

Tọa độ x để vẽ điểm ảnh, từ 0 đến 159, được tham chiếu đến gốc tọa độ của màn hình.

y

Tọa độ y để vẽ điểm ảnh, từ 0 đến 107, được tham chiếu đến gốc tọa độ của màn hình.

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

Ảnh chụp màn hình EXP Brain hiển thị một loạt các pixel thể hiện các góc của một hình vuông.

draw_line#

draw_line vẽ một đường thẳng từ tọa độ màn hình đầu tiên (x1, y1) đến tọa độ màn hình thứ hai (x2, y2) bằng cách sử dụng độ rộng bút và màu bút hiện tại.

Cách sử dụng:

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

Thông số

Sự miêu tả

x1

Tọa độ x (tính bằng pixel) của điểm bắt đầu đường thẳng, từ 0 đến 159, được tham chiếu đến gốc tọa độ màn hình.

y1

Tọa độ y (tính bằng pixel) của điểm bắt đầu đường thẳng, từ 0 đến 107, được tham chiếu đến gốc tọa độ màn hình.

x2

Tọa độ x (tính bằng pixel) của điểm cuối đường thẳng, từ 0 đến 159, được tham chiếu đến gốc tọa độ màn hình.

y2

Tọa độ y tính bằng pixel của điểm cuối đường thẳng, từ 0 đến 107, được tham chiếu đến gốc tọa độ màn hình.

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

Màn hình của Brain hiển thị một đường chéo mỏng ở giữa, từ góc trên bên trái đến góc dưới bên phải.

draw_rectangle#

draw_rectangle vẽ một hình chữ nhật bằng cách sử dụng chiều rộng bút, màu bút và màu tô hiện tại, trừ khi tham số color tùy chọn được sử dụng.

Cách sử dụng:

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

Thông số

Sự miêu tả

x

Tọa độ x (tính bằng pixel) của góc trên bên trái của hình chữ nhật, từ 0 đến 159, được tham chiếu đến gốc tọa độ màn hình.

y

Tọa độ y (tính bằng pixel) của góc trên bên trái của hình chữ nhật, từ 0 đến 107, được tham chiếu đến gốc tọa độ màn hình.

width

Chiều rộng của hình chữ nhật.

height

Chiều cao của hình chữ nhật.

color

Optional. A valid ColorType, a hex value, or a web string.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
You can also specify a custom color.

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

Màn hình của Brain hiển thị một hình chữ nhật có viền trắng mỏng trên màn hình.

# 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 vẽ một hình tròn bằng cách sử dụng độ rộng bút, màu bút và màu tô hiện tại, trừ khi tham số color tùy chọn được sử dụng.

Cách sử dụng:

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

Thông số

Sự miêu tả

x

Tọa độ x (tính bằng pixel) của tâm hình tròn, từ 0 đến 159, được tham chiếu đến gốc tọa độ màn hình.

y

Tọa độ y tính bằng pixel của tâm hình tròn, từ 0 đến 107, được tham chiếu đến gốc tọa độ màn hình.

radius

Bán kính của đường tròn.

color

Optional. A valid ColorType, a hex value, or a web string.

  • Color.BLACK
  • Color.BLUE
  • Color.GREEN
  • Color.ORANGE
  • Color.PURPLE
  • Color.RED
  • Color.VIOLET
  • Color.WHITE
  • Color.YELLOW
You can also specify a custom color.

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

Màn hình của Brain hiển thị một vòng tròn có viền trắng mỏng ở giữa.

# 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 vẽ một hình ảnh từ thẻ SD. Tên tệp bạn nhập khi gọi phương thức phải nằm trên thẻ SD.

Cách sử dụng:

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

Thông số

Sự miêu tả

filename

Tên tệp tin của hình ảnh.

x

Tọa độ x của góc trên bên trái hình ảnh trên màn hình.

y

Tọa độ y của góc trên bên trái hình ảnh trên màn hình.

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

Lệnh render chuyển chế độ vẽ sang chế độ đệm kép và hiển thị màn hình của Brain. Sau khi được gọi, hình ảnh sẽ không xuất hiện trên màn hình của Brain cho đến lần gọi tiếp theo của lệnh render.

  • True nếu dữ liệu đệm được hiển thị thành công lên màn hình.

  • False nếu bộ đệm không được hiển thị thành công lên màn hình.

Cách sử dụng:

brain.screen.render()

Thông số

Sự miêu tả

Phương pháp này không có tham số.

set_clip_region#

set_clip_region xác định một vùng hình chữ nhật trên màn hình, nơi tất cả các hình vẽ và văn bản sẽ được giới hạn. Bất kỳ nội dung nào nằm ngoài vùng này sẽ không được hiển thị.

Cách sử dụng:

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

Thông số

Sự miêu tả

x

Vị trí x của góc trên bên trái của hình chữ nhật, được tham chiếu đến gốc tọa độ màn hình.

y

Vị trí y của góc trên bên trái của hình chữ nhật, được tham chiếu đến gốc tọa độ màn hình.

width

Chiều rộng của hình chữ nhật.

height

Chiều cao của hình chữ nhật.
On this page