หน้าจอ#

การแนะนำ#

เมธอด Screen จะควบคุมวิธีการแสดงข้อความ ตัวเลข และกราฟิกบนหน้าจอของหุ่นยนต์เขียนโค้ด VEX AIM รวมถึงวิธีการตอบสนองต่อการกดบนหน้าจอ

ด้านล่างนี้คือรายการวิธีการทั้งหมด:

ระบบสัมผัส – ตรวจจับและตอบสนองต่อการกดบนหน้าจอ

  • pressing – ส่งคืนว่าหน้าจอกำลังถูกกดอยู่หรือไม่

  • x_position – ส่งคืนพิกัด x ของการกดหน้าจอครั้งสุดท้าย

  • y_position – ส่งคืนพิกัด y ของการกดหน้าจอครั้งสุดท้าย

การพิมพ์ด้วยเคอร์เซอร์ – แสดงข้อความโดยใช้ระบบแถว/คอลัมน์

  • print – พิมพ์ข้อความ ตัวเลข หรือค่าตัวแปร ณ ตำแหน่งเคอร์เซอร์ปัจจุบัน

  • set_cursor – ย้ายเคอร์เซอร์ไปยังแถวและคอลัมน์ที่ระบุ

  • next_row – ย้ายเคอร์เซอร์ไปที่คอลัมน์ที่ 1 ของแถวถัดไป

  • clear_row – ล้างข้อความหนึ่งแถว

  • get_row – ส่งคืนแถวเคอร์เซอร์ปัจจุบัน

  • get_column – ส่งคืนคอลัมน์เคอร์เซอร์ปัจจุบัน

การพิมพ์แบบ XY – แสดงข้อความที่พิกัดหน้าจอที่กำหนด

  • print_at – พิมพ์ข้อความ ตัวเลข หรือค่าตัวแปรที่พิกัด x และ y ที่ระบุ

  • set_origin – กำหนดจุดกำเนิดที่ใช้สำหรับการพิมพ์และการวาดตามพิกัด

ตัวปรับแต่ง – ล้างหน้าจอหรืออัปเดตการตั้งค่าภาพ

  • clear_screen – ล้างภาพวาดและข้อความทั้งหมดบนหน้าจอ

  • set_font – ตั้งค่าแบบอักษรสำหรับข้อความที่พิมพ์

  • set_pen_width – กำหนดความหนาของเส้นที่วาดและเส้นขอบของรูปร่าง

  • set_pen_color – ตั้งค่าสีของข้อความ พิกเซล เส้น และเส้นขอบของรูปร่าง

  • set_fill_color – กำหนดสีเติมสำหรับรูปทรงที่วาดและพื้นหลังข้อความที่พิมพ์

วาด – เพิ่มกราฟิกและรูปภาพลงบนหน้าจอ

  • draw_pixel – วาดพิกเซลที่ตำแหน่ง x และ y ที่ระบุ

  • draw_line – วาดเส้นระหว่างสองจุด

  • draw_rectangle – วาดสี่เหลี่ยมผืนผ้า

  • draw_circle – วาดวงกลม

  • show_file – แสดงภาพที่อัปโหลด

  • set_clip_region – จำกัดตำแหน่งที่ภาพวาดและข้อความสามารถปรากฏได้

ฟังก์ชันเรียกกลับ – เรียกใช้ฟังก์ชันเมื่อกดหรือปล่อยหน้าจอ

  • pressed – ลงทะเบียนฟังก์ชันที่จะเรียกเมื่อกดหน้าจอ

  • released – ลงทะเบียนฟังก์ชันที่จะเรียกเมื่อหน้าจอถูกปล่อย

สัมผัส#

pressing#

การกดปุ่ม pressing จะส่งค่าบูลีนกลับมาเพื่อระบุว่าหน้าจอของหุ่นยนต์กำลังถูกกดอยู่หรือไม่

  • True – หน้าจอกำลังถูกกด

  • False – ไม่ได้กดหน้าจอ

Usage:
robot.screen.pressing()

พารามิเตอร์

คำอธิบาย

เมธอดนี้ไม่มีพารามิเตอร์

# Turn LEDs white only while the screen is pressed.
while True:
    if robot.screen.pressing():
        robot.led.on(ALL_LEDS, WHITE)
    else:
        robot.led.off(ALL_LEDS)

    wait(50, MSEC)

# Display different messages after the screen is pressed
while not robot.screen.pressing():
    wait(5, MSEC)
robot.screen.print("First message!")
robot.screen.next_row()
# Lift finger to press the screen again
while robot.screen.pressing():
    wait(5, MSEC)
while not robot.screen.pressing():
    wait(5, MSEC)
robot.screen.print("Second message!")
robot.screen.next_row()

x_position#

x_position จะส่งคืนค่าพิกัด x ของการกดหน้าจอครั้งล่าสุดเป็นจำนวนเต็มตั้งแต่ 0 (ซ้าย) ถึง 240 (ขวา)

Usage:
robot.screen.x_position()

พารามิเตอร์

คำอธิบาย

เมธอดนี้ไม่มีพารามิเตอร์

# Display the x-coordinate of where
# the screen is pressed
while True:
    if robot.screen.pressing():
        robot.screen.clear_screen()
        robot.screen.print(robot.screen.x_position())
    wait (50, MSEC)

y_position#

y_position จะส่งคืนค่าพิกัด y ของการกดหน้าจอครั้งล่าสุดเป็นจำนวนเต็มตั้งแต่ 0 (บนสุด) ถึง 240 (ล่างสุด)

Usage:
robot.screen.y_position()

พารามิเตอร์

คำอธิบาย

เมธอดนี้ไม่มีพารามิเตอร์

# Display the y-coordinate of where
# the screen is pressed
while True:
    if robot.screen.pressing():
        robot.screen.clear_screen()
        robot.screen.print(robot.screen.y_position())
    wait (50, MSEC)

พิมพ์เคอร์เซอร์#

print#

print prints text, numbers, or variable values on the robot’s screen at the current cursor position and font.

Usage:
robot.screen.print(text)

พารามิเตอร์

คำอธิบาย

text

ข้อความ ตัวเลข หรือค่าตัวแปรที่จะแสดงบนหน้าจอ

# Display a message at the starting cursor position
robot.screen.print("Hello, Robot!")

ภาพหน้าจอของหุ่นยนต์ โดยมีข้อความ "สวัสดี หุ่นยนต์!" พิมพ์ด้วยสีขาวอยู่ด้านบน

set_cursor#

set_cursor ย้ายเคอร์เซอร์ข้อความไปยังแถวและคอลัมน์ที่ระบุบนหน้าจอของหุ่นยนต์ การเรียก print ครั้งถัดไปจะเริ่มพิมพ์ที่ตำแหน่งนั้น จำนวนแถวและคอลัมน์ที่พอดีขึ้นอยู่กับแบบอักษรที่เลือก ด้วยแบบอักษร monospaced medium เริ่มต้น หน้าจอสามารถแสดงได้สูงสุด 8 แถวและ 13 คอลัมน์อย่างชัดเจน ข้อความที่วางเกินช่วงนี้อาจถูกตัดออกหรืออ่านยากขึ้น

ฟอนต์แบบ Monospaced มีตัวอักษรที่มีความกว้างเท่ากันทั้งหมด ทำให้การจัดวางข้อความสม่ำเสมอ ในทางตรงกันข้าม ฟอนต์แบบ Proportional มีความกว้างของตัวอักษรแตกต่างกัน ดังนั้นตัวอักษรบางตัวจึงใช้พื้นที่มากกว่าตัวอื่น อย่างไรก็ตาม ไม่ว่าจะใช้ฟอนต์แบบใดก็ตาม คำสั่ง set_cursor จะกำหนดตำแหน่งเคอร์เซอร์ตามขนาดของแถวและคอลัมน์ ไม่ใช่รูปแบบฟอนต์ ขนาดฟอนต์สามารถปรับได้โดยใช้ set_font

Usage:
robot.screen.set_cursor(row, column)

พารามิเตอร์

คำอธิบาย

row

แถวที่จะย้ายเคอร์เซอร์ไป

column

คอลัมน์ที่จะย้ายเคอร์เซอร์ไป

# Display text starting at Row 3 Column 2
robot.screen.set_cursor(3, 2)
robot.screen.print("Row 3, Column 2")

ภาพหน้าจอของหุ่นยนต์ โดยมีข้อความ "แถวที่ 3 คอลัมน์ที่ 2" พิมพ์เป็นสีขาวอยู่เหนือกึ่งกลางหน้าจอ เริ่มต้นที่แถวที่ 3 คอลัมน์ที่ 2

next_row#

คำสั่ง next_row จะย้ายเคอร์เซอร์ไปยังคอลัมน์ที่ 1 ในแถวถัดไปบนหน้าจอของหุ่นยนต์

Usage:
robot.screen.next_row()

พารามิเตอร์

คำอธิบาย

เมธอดนี้ไม่มีพารามิเตอร์

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

ภาพหน้าจอของหุ่นยนต์ที่มีข้อความสีขาว บรรทัดบนสุดแสดงบรรทัดที่ 1 จัดชิดซ้าย และบรรทัดที่ 2 อยู่ด้านล่าง

clear_row#

clear_row ล้างข้อความหนึ่งแถวบนหน้าจอของหุ่นยนต์

Usage:
robot.screen.clear_row(row, color)

พารามิเตอร์

คำอธิบาย

row

ตัวเลือกเสริม ระบุแถวที่จะล้างเป็นจำนวนเต็ม ค่าเริ่มต้นคือแถวปัจจุบันที่เคอร์เซอร์ชี้อยู่

color

ตัวเลือกเสริม สีที่จะใช้กับแถวที่ล้างแล้ว ตัวเลือกได้แก่:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
คุณยังสามารถระบุ สีที่กำหนดเอง ได้อีกด้วย

# Display text on two rows
robot.screen.print("This text stays")
robot.screen.next_row()
robot.screen.print("This text disappears")

# Wait 3 seconds before clearing only the second row
wait(3, SECONDS)
robot.screen.clear_row()

# Turn the 5th row green
robot.screen.clear_row(5, GREEN)

ภาพหน้าจอของหุ่นยนต์ที่มีแถบสีเขียวพาดผ่านกลางหน้าจอจากซ้ายไปขวา

get_row#

get_row ส่งคืนแถวปัจจุบันที่จะพิมพ์ข้อความเป็นจำนวนเต็ม

Usage:
robot.screen.get_row()

พารามิเตอร์

คำอธิบาย

เมธอดนี้ไม่มีพารามิเตอร์

# Set cursor to (3,2) and print row number
robot.screen.set_cursor(3, 2)
robot.screen.print(robot.screen.get_row())

ภาพหน้าจอ SA ของหุ่นยนต์ โดยมีเลข 3 สีขาวพิมพ์อยู่ใกล้กึ่งกลางของช่องบนซ้าย ที่แถว 3 คอลัมน์ 2

get_column#

get_column ส่งคืนคอลัมน์ปัจจุบันที่จะพิมพ์ข้อความเป็นจำนวนเต็ม

Usage:
robot.screen.get_column()

พารามิเตอร์

คำอธิบาย

เมธอดนี้ไม่มีพารามิเตอร์

# Set cursor to (3,2) and print column number
robot.screen.set_cursor(3, 2)
robot.screen.print(robot.screen.get_column())

ภาพหน้าจอของหุ่นยนต์ โดยมีเลข 2 สีขาวพิมพ์อยู่ใกล้กึ่งกลางของช่องบนซ้าย ที่แถวที่ 3 คอลัมน์ที่ 2

XY Print#

set_origin#

set_origin กำหนดจุดกำเนิดที่ใช้สำหรับการวาดและการพิมพ์แบบอิงพิกัดบนหน้าจอของหุ่นยนต์ โดยค่าเริ่มต้น จุดกำเนิดคือมุมบนซ้ายของหน้าจอ

Usage:
robot.screen.set_origin(x, y)

พารามิเตอร์

คำอธิบาย

x

พิกัด x ใหม่ที่จะกำหนดให้เป็นจุดกำเนิด จะต้องเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

y

พิกัด y ใหม่ที่จะกำหนดให้เป็นจุดกำเนิด จะต้องเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

# Set the origin to the center of the screen
robot.screen.set_origin(120, 120)

# Draw a rectangle at the new origin
robot.screen.draw_rectangle(0, 0, 80, 40)

ภาพหน้าจอของหุ่นยนต์ที่มีสี่เหลี่ยมสีขาววาดอยู่ในมุมล่างซ้าย มุมบนซ้ายของสี่เหลี่ยมคือจุดกึ่งกลางของหน้าจอ

ตัวกลายพันธุ์#

clear_screen#

คำสั่ง clear_screen จะล้างภาพวาดและข้อความทั้งหมดออกจากหน้าจอของหุ่นยนต์ โดยค่าเริ่มต้น จะรีเซ็ตตำแหน่งเคอร์เซอร์ไปที่แถวที่ 1 คอลัมน์ที่ 1 ด้วย

Usage:
robot.screen.clear_screen(color)

พารามิเตอร์

คำอธิบาย

color

ตัวเลือกเสริม ตั้งค่าสีหน้าจอ ตัวเลือกได้แก่:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
คุณยังสามารถระบุ สีที่กำหนดเอง ได้อีกด้วย

# Draw a circle, and clear it after 2 seconds
robot.screen.draw_circle(120, 120, 60)
wait(2, SECONDS)
robot.screen.clear_screen()

# Set the background color of the screen to red
robot.screen.clear_screen(RED)

ภาพหน้าจอของหุ่นยนต์ แสดงทั้งหน้าจอเป็นสีแดงสด

set_font#

set_font กำหนดแบบอักษรที่ใช้สำหรับแสดงข้อความบนหน้าจอของหุ่นยนต์ แบบอักษรนี้จะใช้กับข้อความทั้งหมดที่พิมพ์ด้วย print หรือ print_at แบบอักษรเริ่มต้นเมื่อเริ่มโครงการคือ MONO24

Usage:
robot.screen.set_font(fontname)

พารามิเตอร์

คำอธิบาย

fontname

Sets the font to one of the following:

  • MONO12
  • MONO15
  • MONO20
  • MONO24
  • MONO30
  • MONO40
  • MONO60
  • PROP20
  • PROP30
  • PROP40
  • PROP60
These options are shown below.

ภาพหน้าจอของหุ่นยนต์แสดงตัวอย่างตัวเลขและตัวอักษรที่พิมพ์ด้วยฟอนต์ Mono 12 ตัวอักษรครอบคลุม 1 แถว ด้านล่างมี 26 ตัวอักษรในแนวนอนและ 15 แถว
MONO12

ภาพเดียวกันกับภาพก่อนหน้า แต่ใช้ฟอนต์ Mono 15 ตัวอักษร AT ครอบคลุม 1 แถวข้อความ ด้านล่างมี 20 ตัวอักษรแนวนอนและ 12 แถว
MONO15

ภาพเดียวกันกับภาพก่อนหน้า แต่ใช้ฟอนต์ Mono 20 ตัวอักษร AP ครอบคลุม 1 แถวข้อความ ด้านล่างมี 16 ตัวอักษรแนวนอนและ 9 แถว
MONO20

ภาพเดียวกันกับภาพก่อนหน้า แต่ใช้ฟอนต์ Mono 24 ตัวอักษร AM ครอบคลุม 1 แถวข้อความ ด้านล่างมี 13 ตัวอักษรแนวนอนและ 8 แถว
MONO24

ภาพเดียวกับภาพก่อนหน้า แต่ใช้ฟอนต์ Mono 30 ตัวอักษร AK ครอบคลุม 1 แถวข้อความ ด้านล่างมี 11 ตัวอักษรแนวนอนและ 6 แถว
MONO30

ภาพเดียวกับภาพก่อนหน้า แต่ใช้ฟอนต์ Mono 40 ตัวอักษร AH ครอบคลุม 1 แถวข้อความ ด้านล่างมี 8 ตัวอักษรแนวนอนและ 5 แถว
MONO40

ภาพเดียวกับภาพก่อนหน้า แต่พิมพ์ตัวเลขด้วยฟอนต์ Mono 60 ตัวเลข 1-6 อยู่ในบรรทัดเดียว ส่วนด้านล่างมี 3 แถว
MONO60

ภาพเดียวกับภาพก่อนหน้า แต่ใช้ฟอนต์ Prop 20 ตัวอักษร As ครอบคลุม 1 แถวข้อความ ด้านล่างมี 20 ตัวอักษรแนวนอนและ 9 แถว
PROP20

ภาพเดียวกันกับภาพก่อนหน้า แต่ใช้ฟอนต์ Prop 30 ตัวอักษร AM ครอบคลุม 1 แถวข้อความ ด้านล่างมี 15 ตัวอักษรแนวนอนและ 6 แถว
PROP30

ภาพเดียวกันกับภาพก่อนหน้า แต่ใช้ฟอนต์ Prop 40 ตัวอักษร AJ ครอบคลุม 1 แถวข้อความ ด้านล่างมี 11 ตัวอักษรและ 5 แถว
PROP40

ภาพเดียวกับภาพก่อนหน้า แต่พิมพ์ตัวเลขด้วยแบบอักษร Prop 60 ตัวเลข 1-7 อยู่ในแถวเดียว ด้านล่างอ่านว่า 7 x 3
PROP60

# Display text using a larger font
robot.screen.set_font(MONO40)
robot.screen.print("VEX")

ภาพหน้าจอของหุ่นยนต์แสดงคำว่า VEX ด้วยฟอนต์ Mono 40 ที่มุมบนซ้าย

set_pen_width#

set_pen_width กำหนดความหนาของเส้นที่วาดและเส้นขอบของรูปทรง

Usage:
robot.screen.set_pen_width(width)

พารามิเตอร์

คำอธิบาย

width

ความกว้างของปากกา (หน่วยเป็นพิกเซล) มีค่าตั้งแต่ 0 ถึง 32

# Draw a rectangle with a pen width of 10
robot.screen.set_pen_width(10)
robot.screen.draw_rectangle(50, 50, 130, 60)

ภาพหน้าจอของหุ่นยนต์ที่มีสี่เหลี่ยมสีขาวหนาขีดทับครึ่งบน

set_pen_color#

set_pen_color กำหนดสีของข้อความ พิกเซล เส้น และเส้นขอบของรูปทรง

Usage:
robot.screen.set_pen_color(color)

พารามิเตอร์

คำอธิบาย

color

Optional. The pen and font color to use. Options include:

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

# Draw a rectangle with a red pen
robot.screen.set_pen_color(RED)
robot.screen.draw_rectangle(50, 50, 130, 60)

ภาพหน้าจอของหุ่นยนต์ที่มีสี่เหลี่ยมสีแดงที่มีเส้นขอบบางๆ ลากผ่านครึ่งบน

set_fill_color#

set_fill_color กำหนดสีเติมที่ใช้เมื่อวาดรูปทรงและเมื่อข้อความที่พิมพ์ใช้พื้นหลัง

Usage:
robot.screen.set_fill_color(color)

พารามิเตอร์

คำอธิบาย

color

ตัวเลือกเสริม สีเติมที่จะใช้ ตัวเลือกได้แก่:

  • BLACK
  • BLUE
  • CYAN
  • GREEN
  • ORANGE
  • PURPLE
  • RED
  • TRANSPARENT
  • WHITE
  • YELLOW
คุณยังสามารถระบุ สีที่กำหนดเอง ได้อีกด้วย

# Draw two orange rectangles
robot.screen.set_fill_color(ORANGE)
robot.screen.draw_rectangle(50, 50, 100, 60)
robot.screen.draw_rectangle(50, 130, 100, 60)

ภาพหน้าจอของหุ่นยนต์ที่มีสี่เหลี่ยมผืนผ้าสีส้มสองอันขนานกัน มีเส้นขอบสีขาวบางๆ วางอยู่ทางด้านซ้ายตรงกลางของหน้าจอ

# Display text with a purple background
robot.screen.set_fill_color(PURPLE)
robot.screen.print("Highlight")

ภาพหน้าจอของหุ่นยนต์แสดงข้อความ Highlight เป็นสีขาว มีไฮไลต์สีม่วงล้อมรอบ เริ่มจากมุมบนซ้าย

วาด#

draw_pixel#

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

Usage:
robot.screen.draw_pixel(x, y)

พารามิเตอร์

คำอธิบาย

x

พิกัด x ที่จะใช้ในการวาดพิกเซล โดยระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

y

พิกัด y ที่จะใช้ในการวาดพิกเซล โดยระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

# Draw a pixel at the center of the screen
robot.screen.draw_pixel(120, 120)

ภาพหน้าจอของหุ่นยนต์ที่มีพิกเซลสีขาวหนึ่งจุดตรงกลาง

draw_line#

draw_line วาดเส้นจากพิกัดหน้าจอแรก (x1, y1) ไปยังพิกัดหน้าจอที่สอง (x2, y2) โดยใช้ ความกว้างของปากกา และ สีของปากกา ปัจจุบัน

พิกัด x และ y ใช้จุดกำเนิดเริ่มต้นที่ (0, 0) เว้นแต่จะมีการตั้งค่าจุดกำเนิดอื่นโดยใช้ set_origin

Usage:
robot.screen.draw_line(x1, y1, x2, y2)

พารามิเตอร์

คำอธิบาย

x1

พิกัด x เริ่มต้นของเส้นตรง ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

y1

พิกัด y เริ่มต้นของเส้นตรง ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

x2

พิกัด x สุดท้ายของเส้นตรง ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

y2

พิกัด y สุดท้ายของเส้นตรง ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

# Draw a line from the top left to bottom right of the screen
robot.screen.draw_line(0, 0, 240, 240)

ภาพหน้าจอของหุ่นยนต์ที่มีเส้นทแยงมุมสีขาวบางๆ ลากจากมุมบนซ้ายไปยังมุมล่างขวา

draw_rectangle#

draw_rectangle วาดสี่เหลี่ยมผืนผ้าโดยให้มุมบนซ้ายอยู่ที่พิกัด (x, y) ที่เลือกไว้ และมีขนาดที่กำหนดโดยความกว้างและความสูงที่กำหนด โดยวัดเป็นพิกเซลทั้งหมด เส้นขอบของสี่เหลี่ยมผืนผ้าจะถูกวาดโดยใช้ ความกว้างของปากกา และ สีของปากกา ปัจจุบัน ส่วนภายในจะถูกเติมด้วย สีเติม ปัจจุบัน เว้นแต่จะใช้พารามิเตอร์ color ที่เป็นตัวเลือก

พิกัด x และ y ใช้จุดกำเนิดเริ่มต้นที่ (0, 0) เว้นแต่จะมีการตั้งค่าจุดกำเนิดอื่นโดยใช้ set_origin

Usage:
robot.screen.draw_rectangle(x, y, width, height, color)

พารามิเตอร์

คำอธิบาย

x

พิกัด x ของมุมบนซ้ายของสี่เหลี่ยมผืนผ้า ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

y

พิกัด y ของมุมบนซ้ายของสี่เหลี่ยมผืนผ้า ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

width

ความกว้างของสี่เหลี่ยมผืนผ้า ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

height

ความสูงของสี่เหลี่ยมผืนผ้า ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

color

Optional. The fill color of the rectangle. Options include:

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

# Draw a red rectangle on the screen
robot.screen.draw_rectangle(50, 50, 130, 60, RED)

ภาพหน้าจอของหุ่นยนต์ที่มีสี่เหลี่ยมสีแดงสดพร้อมขอบสีขาวบาง ๆ อยู่ตรงกลางครึ่งบนของหน้าจอ

draw_circle#

draw_circle วาดวงกลมที่มีจุดศูนย์กลางอยู่ที่พิกัด (x, y) ที่เลือก และขนาดที่กำหนดโดยรัศมีที่กำหนด โดยวัดเป็นพิกเซลทั้งหมด เส้นขอบของวงกลมจะถูกวาดโดยใช้ ความกว้างของปากกา และ สีของปากกา ปัจจุบัน ส่วนภายในจะถูกเติมด้วย สีเติม ปัจจุบัน เว้นแต่จะใช้พารามิเตอร์ color ที่เป็นตัวเลือก

พิกัด x และ y ใช้จุดกำเนิดเริ่มต้นที่ (0, 0) เว้นแต่จะมีการตั้งค่าจุดกำเนิดอื่นโดยใช้ set_origin

Usage:
robot.screen.draw_circle(x, y, radius, color)

พารามิเตอร์

คำอธิบาย

x

พิกัด x ของจุดศูนย์กลางของวงกลม ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

y

พิกัด y ของจุดศูนย์กลางของวงกลม ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240

radius

รัศมีของวงกลม ระบุเป็นจำนวนเต็มตั้งแต่ 0 ถึง 240 พิกเซล

color

Optional. The fill color of the circle. Options include:

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

# Draw a green circle on the screen
robot.screen.draw_circle(120, 120, 40, GREEN)

ภาพหน้าจอของหุ่นยนต์ที่มีวงกลมสีเขียวสดใสและมีขอบสีขาวบางๆ อยู่ตรงกลาง

show_file#

show_file แสดงภาพที่อัปโหลดเองบนหน้าจอของหุ่นยนต์ โดยกำหนดตำแหน่งโดยใช้พารามิเตอร์ x, yและ center โดยอิงตามจุดอ้างอิงของภาพ

Usage:
robot.screen.show_file(file, x, y, center)

พารามิเตอร์

คำอธิบาย

file

รูปภาพที่กำหนดเองที่จะใช้ ตั้งแต่ IMAGE1 ถึง IMAGE10หมายเลขรูปภาพต้องตรงกับหมายเลขที่แสดงในแผงควบคุม AIM

x

ค่าชดเชยแนวนอนของภาพ ระบุเป็นจำนวนเต็มในหน่วยพิกเซล ค่าบวกจะเลื่อนไปทางขวา ค่าลบจะเลื่อนไปทางซ้าย

y

ค่าชดเชยแนวตั้งของภาพ ระบุเป็นจำนวนเต็มในหน่วยพิกเซล ค่าบวกจะเลื่อนลง ค่าลบจะเลื่อนขึ้น

center

Optional. If center=True, the image is placed using its center at coordinate (120, 120). By default (center=False), the top-left corner of the image is used and positioned relative to the current origin.

# Display uploaded Image 1 in the top left corner
robot.screen.show_file(IMAGE1, 0, 0)

# Show the same image on both sides of the screen
# Image size is 120 x 120
robot.screen.show_file(IMAGE1, 65, 0, center=True)
robot.screen.show_file(IMAGE1, -65, 0, center=True)

set_clip_region#

set_clip_region กำหนดพื้นที่สี่เหลี่ยมบนหน้าจอซึ่งจะจำกัดภาพวาดและข้อความทั้งหมดไว้ภายในพื้นที่นี้ เนื้อหาใดๆ ที่อยู่นอกพื้นที่นี้จะไม่แสดงผล

Usage:
robot.screen.set_clip_region(x, y, width, height)

พารามิเตอร์

คำอธิบาย

x

พิกัด x ของมุมบนซ้ายของบริเวณคลิป ระบุเป็นเลขฐานสิบ (float) ตั้งแต่ 0 ถึง 240

y

พิกัด y ของมุมบนซ้ายของบริเวณคลิป ระบุเป็นเลขฐานสิบ (float) ตั้งแต่ 0 ถึง 240

width

ความกว้างของบริเวณคลิปในหน่วยพิกเซล ระบุเป็นเลขฐานสิบ (float) ตั้งแต่ 0 ถึง 240

height

ความสูงของบริเวณคลิปในหน่วยพิกเซล ระบุเป็นค่าทศนิยม (float) ตั้งแต่ 0 ถึง 240

# Restrict text and drawings to a specific region
robot.screen.set_clip_region(0, 0, 120, 120)
robot.screen.draw_rectangle(60, 60, 100, 100, RED)
robot.screen.print_at("Cut off!", x=60, y=60)

ภาพหน้าจอของหุ่นยนต์แสดงข้อความและรูปภาพที่พอดีกับพื้นที่ตัด ในส่วนบนซ้าย ข้อความสีขาวเขียนว่า Cut o โดยมีสี่เหลี่ยมสีแดงอยู่ด้านล่าง

การเรียกกลับ#

pressed#

กด pressed ทะเบียนเมธอดที่จะถูกเรียกเมื่อกดหน้าจอของหุ่นยนต์

Usage:
robot.screen.pressed(callback, arg)

พารามิเตอร์

คำอธิบาย

callback

A function that is previously defined to execute when the controller screen is pressed.

arg

ตัวเลือกเสริม ทูเปิล ที่มีอาร์กิวเมนต์ที่จะส่งไปยังฟังก์ชันเรียกกลับ ดู การใช้ฟังก์ชันที่มีพารามิเตอร์ สำหรับข้อมูลเพิ่มเติม

# Set the LEDs to green when the screen is pressed.
def screen_touched():
    robot.led.on(ALL_LEDS, GREEN)

robot.screen.pressed(screen_touched)

released#

released ลงทะเบียนเมธอดที่จะถูกเรียกเมื่อหน้าจอของหุ่นยนต์ถูกปล่อย

Usage:
robot.screen.released(callback, arg)

พารามิเตอร์

คำอธิบาย

callback

A function that is previously defined to execute when the controller screen is pressed.

arg

ตัวเลือกเสริม ทูเปิล ที่มีอาร์กิวเมนต์ที่จะส่งไปยังฟังก์ชันเรียกกลับ ดู การใช้ฟังก์ชันที่มีพารามิเตอร์ สำหรับข้อมูลเพิ่มเติม

# Set the LEDs to blue when the screen is released.
def screen_released():
    robot.led.on(ALL_LEDS, BLUE)

robot.screen.released(screen_released)