Màn hình#
Giới thiệu#
Các phương thức điều khiển màn hình kiểm soát cách bộ xử lý V5 hiển thị văn bản, số và đồ họa trên màn hình cảm ứng, cũng như cách nó phản hồi các thao tác chạm.
Mặc định, phông chữ dùng để in lên Brain là phông chữ đơn cách nhỏ với 12 hàng và 48 cột.
Đối với việc vẽ, độ phân giải của Brain là 480 x 240 pixel.

Dưới đây là danh sách tất cả các phương pháp:
In bằng con trỏ — Đặt và in văn bản.
print— In văn bản, số hoặc giá trị biến tại vị trí con trỏ hiện tại.set_cursor— Di chuyển con trỏ đến một hàng và cột cụ thể.next_row— Di chuyển con trỏ đến cột 1 của 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.print_at— In văn bản, số hoặc giá trị biến tại tọa độ x và y cụ thể.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.clear_line— Xóa một dòng văn bản.new_line— Di chuyển con trỏ đến một dòng mớ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 trên màn hình.set_font— Đặt phông chữ cho văn bản in.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.set_origin— Đặt gốc tọa độ được sử dụng để in và vẽ dựa trên tọa độ.
Vẽ — Thêm hình ảnh vào màn hình.
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.draw_circle— Vẽ một hình tròn.render— Cập nhật màn hình của Brain với văn bản và hình vẽ chỉ khi được gọi.set_clip_region— Hạn chế vị trí hiển thị của hình vẽ và văn bản.
Getters — Kiểm tra trạng thái và vị trí chạm.
pressing— Trả về trạng thái màn hình có đang được nhấn hay không.x_position— Trả về tọa độ x của lần nhấn màn hình cuối cùng.y_position— Trả về tọa độ y của lần nhấn màn hình cuối cùng.
Hàm gọi lại — Phản hồi các sự kiện chạm trên màn hình.
pressed— Đăng ký một hàm sẽ được gọi khi màn hình được nhấn.released— Đăng ký một hàm sẽ được gọi khi màn hình được thả ra.
Để biết thông tin về cách xây dựng một bộ não để truy cập vào các phương pháp màn hình screen , hãy xem Bộ não.
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ữ.
Cách sử dụng:
brain.screen.print(text, sep, precision)
Thông số |
Sự miêu tả |
|---|---|
|
Văn bản, số hoặc giá trị biến cần in. |
|
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à |
|
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 ( |
# Print on the Brain's screen
brain.screen.print("Hello, Robot!")

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í đó. Số hàng và cột có thể hiển thị thoải mái tùy thuộc vào phông chữ được chọn. Với phông chữ đơn cách mặc định cỡ trung bình, có thể hiển thị rõ ràng tối đa 8 hàng và 13 cột. Văn bản đặt ngoài phạm vi này có thể bị cắt hoặc khó đọc.
Phông chữ đơn cách có các ký tự đều có cùng chiều rộng, giúp việc đặt văn bản nhất quán. Ngược lại, phông chữ tỷ lệ có chiều rộng ký tự khác nhau, do đó một số chữ cái chiếm nhiều không gian hơn những chữ cái khác. Tuy nhiên, bất kể loại nào được sử dụng, set_cursor định vị con trỏ dựa trên kích thước hàng và cột, chứ không phải kiểu phông chữ. Kích thước phông chữ có thể được điều chỉnh bằng cách sử dụng set_font.
Cách sử dụng:
brain.screen.set_cursor(row, column)
Thông số |
Sự miêu tả |
|---|---|
|
Hàng cần di chuyển con trỏ đến. |
|
Cột cần di chuyển con trỏ đến. |
# 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 di chuyển con trỏ đến hàng tiếp theo.
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ố. |
# 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 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, color)
Thông số |
Sự miêu tả |
|---|---|
|
Tùy chọn. Hàng cần xóa. Mặc định là hàng hiện tại của con trỏ. |
|
Optional. A valid color, a hex value, or a web string. |
# 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 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, 2)
brain.screen.print(brain.screen.row())

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, 15)
brain.screen.print(brain.screen.column())

print_at#
print_at in văn bản, số hoặc giá trị biến trên màn hình Brain tại tọa độ x và y cụ thể với font và origin hiện tại.
Cách sử dụng:
brain.screen.print_at(text, x, y, sep, precision, opaque)
Thông số |
Sự miêu tả |
|---|---|
|
Văn bản, số hoặc giá trị biến cần in. |
|
Tọa độ x cần in dưới dạng đối số từ khóa ( |
|
Tọa độ y cần in dưới dạng đối số từ khóa ( |
|
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à |
|
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 ( |
|
Tùy chọn. Một giá trị Boolean cho biết liệu văn bản có nên xóa các pixel nền hay không. Giá trị mặc định là |
# Display text at the center of the screen
brain.screen.print_at("Center", x=220, y=120)

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.
Usage:
brain.screen.get_string_width(string)
Thông số |
Sự miêu tả |
|---|---|
|
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.
Usage:
brain.screen.get_string_height(string)
Thông số |
Sự miêu tả |
|---|---|
|
Sợi dây dùng để đo. |
clear_line#
clear_line xóa dòng văn bản hiện tại.
Usage:
brain.screen.clear_line()
Thông số |
Sự miêu tả |
|---|---|
Phương pháp này không có tham số. |
new_line#
new_line 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.new_line()
Thông số |
Sự miêu tả |
|---|---|
Phương pháp này không có tham số. |
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 Brain.
Cách sử dụng:
brain.screen.clear_screen(color)
Thông số |
Sự miêu tả |
|---|---|
|
Tùy chọn. Một tùy chọn màu hợp lệ:
|
# 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 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(font)
Thông số |
Sự miêu tả |
|---|---|
|
Dưới đây là một tùy chọn phông chữ hợp lệ. |
|
|
|
|---|---|---|
|
|
|
|
|
|
|
# Set the font type to MONO40
brain.screen.set_font(FontType.MONO40)
brain.screen.print("VEX")

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(value)
Thông số |
Sự miêu tả |
|---|---|
|
Độ 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(50, 50, 130, 60)

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ả |
|---|---|
|
Màu bút và màu chữ cần sử dụng. Các tùy chọn bao gồm:
|
# 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 thiết lập màu tô được sử dụng khi vẽ các hình dạng.
Cách sử dụng:
brain.screen.set_fill_color(color)
Thông số |
Sự miêu tả |
|---|---|
|
Màu tô cần sử dụng. Các tùy chọn bao gồm:
|
# Draw a purple rectangle
brain.screen.set_fill_color(Color.PURPLE)
brain.screen.draw_rectangle(50, 130, 100, 60)

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ả |
|---|---|
|
Tọa độ x cần đặt làm gốc tọa độ, từ 0 đến 479. |
|
Tọa độ y cần đặt làm gốc tọa độ, từ 0 đến 239. |
Vẽ tranh#
draw_pixel#
draw_pixel vẽ một pixel tại tọa độ x và y đã chọn bằng màu bút hiện tại.
Cách sử dụng:
brain.screen.draw_pixel(x, y)
Thông số |
Sự miêu tả |
|---|---|
|
Tọa độ x để vẽ điểm ảnh, từ 0 đến 479, được tham chiếu đến gốc tọa độ của màn hình. |
|
Tọa độ y để vẽ điểm ảnh, từ 0 đến 239, đượ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(250, 100)
brain.screen.draw_pixel(275, 100)
brain.screen.draw_pixel(250, 125)
brain.screen.draw_pixel(275, 125)
![]()
draw_line#
draw_line vẽ một đường thẳng từ tọa độ màn hình thứ nhất đến tọa độ màn hình thứ hai bằng cách sử dụng độ rộng và màu bút hiện tại.
Cách sử dụng:
brain.screen.draw_line(start_x, start_y, end_x, end_y)
Thông số |
Sự miêu tả |
|---|---|
|
Tọa độ x (tính bằng pixel) của điểm bắt đầu đường thẳng, từ 0 đến 479, được tham chiếu đến gốc tọa độ màn hình. |
|
Tọa độ y (tính bằng pixel) của điểm bắt đầu đường thẳng, từ 0 đến 239, được tham chiếu đến gốc tọa độ màn hình. |
|
Tọa độ x (tính bằng pixel) của điểm cuối đường thẳng, từ 0 đến 479, được tham chiếu đến gốc tọa độ màn hình. |
|
Tọa độ y (tính bằng pixel) của điểm cuối đường thẳng, từ 0 đến 239, đượ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, 479, 239)

draw_rectangle#
draw_rectangle vẽ một hình chữ nhật 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ố tùy chọn color đượ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ả |
|---|---|
|
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 479. |
|
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 239. |
|
Chiều rộng của hình chữ nhật. |
|
Chiều cao của hình chữ nhật. |
|
Tùy chọn. Một tùy chọn màu hợp lệ:
|
# Draw a rectangle on the screen
brain.screen.draw_rectangle(50, 50, 130, 60)

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ố tùy chọn color được sử dụng.
Cách sử dụng:
brain.screen.draw_circle(x, y, radius, color)
Thông số |
Sự miêu tả |
|---|---|
|
Tọa độ x (tính bằng pixel) của tâm hình tròn, từ 0 đến 479, được tham chiếu đến gốc tọa độ màn hình. |
|
Tọa độ y tính bằng pixel của tâm hình tròn, từ 0 đến 239, được tham chiếu đến gốc tọa độ màn hình. |
|
Bán kính của hình tròn, tính bằng pixel. |
|
Tùy chọn. Màu tô cần sử dụng. Các tùy chọn bao gồm:
|
# Draw a circle on the screen
brain.screen.draw_circle(120, 120, 40)

render#
Lệnh render cho phép bộ đệm kép cho màn hình của Brain. Sau khi được gọi, bất kỳ lệnh vẽ nào (như văn bản, hình dạng hoặc hình ảnh) sẽ không còn hiển thị ngay lập tức trong suốt phần còn lại của dự án. Thay vào đó, các cập nhật sẽ chỉ được hiển thị khi lệnh render được sử dụng lại. Điều này cho phép cập nhật màn hình mượt mà và được kiểm soát tốt hơn, nhưng có nghĩa là sẽ không có gì hiển thị cho đến khi lệnh render được sử dụng.
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ố. |
# 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 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ả |
|---|---|
|
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. |
|
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. |
|
Chiều rộng của hình chữ nhật. |
|
Chiều cao của hình chữ nhật. |
# 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)

Chạm#
pressing#
Việc nhấn pressing sẽ trả về giá trị Boolean cho biết màn hình Brain hiện có đang được nhấn hay không.
True- Màn hình đang được nhấn.False- Màn hình không được nhấn.
Cách sử dụng:
brain.screen.pressing()
Thông số |
Sự miêu tả |
|---|---|
Phương pháp này không có tham số. |
# 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 trả về tọa độ x của lần nhấn màn hình cuối cùng dưới dạng số nguyên từ 0 (trái) đến 479 (phải).
Cách sử dụng:
brain.screen.x_position()
Thông số |
Sự miêu tả |
|---|---|
Phương pháp này không có tham số. |
# 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 trả về tọa độ y của lần nhấn màn hình cuối cùng dưới dạng số nguyên từ 0 (trên cùng) đến 239 (dưới cùng).
Cách sử dụng:
brain.screen.y_position()
Thông số |
Sự miêu tả |
|---|---|
Phương pháp này không có tham số. |
# 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)
Cuộc gọi lại#
pressed#
pressed đăng ký một hàm sẽ được gọi khi Màn hình của Não được nhấn.
Cách sử dụng:
brain.screen.pressed(callback, arg)
Thông số |
Sự miêu tả |
|---|---|
|
Một hàm được định nghĩa trước đó sẽ thực thi khi màn hình Brain được nhấn. |
|
Tùy chọn. Một tuple chứa các đối số để truyền cho hàm gọi lại. Xem Sử dụng hàm có tham số để biết thêm thông tin. |
def my_function():
brain.screen.print("Screen pressed")
# Call my_function whenever the Brain screen is pressed
brain.screen.pressed(my_function)
released#
released đăng ký một hàm sẽ được gọi khi màn hình được nhả ra (cảm ứng bị xóa).
Cách sử dụng:
brain.screen.released(callback, arg)
Thông số |
Sự miêu tả |
|---|---|
|
Một hàm được định nghĩa trước đó sẽ được thực thi khi màn hình Brain được thả ra. |
|
Tùy chọn. Một tuple chứa các đối số để truyền cho hàm gọi lại. Xem Sử dụng hàm có tham số để biết thêm thông tin. |
def my_function():
brain.screen.print("Screen released")
# Call my_function whenever the Brain screen is released
brain.screen.released(my_function)









