外观#

笔 #

pen.move()#

The pen.move(action) method is used to set the position of the VR Pen.

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`action`	The set position of the VR Pen as `UP` or `DOWN`.

**返回：**无。

UP - the pen will not draw a line on the playground.
DOWN - the pen will draw a colored line on the playground.

def main():
    # Position the VR Pen down.
    pen.move(DOWN)
    # Move forward for 400 mm to draw a line.
    drivetrain.drive_for(FORWARD, 400, MM)

pen.set_pen_color()#

The pen.set_pen_color(color) method is used to set the color of the VR Pen.

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`color`	The color of the VR Pen: `BLACK`, `RED`, `GREEN`, or `BLUE`.

**返回：**无。

def main():
    # Move the VR Pen down.
    pen.move(DOWN)
    # Set the VR Pen color to blue.
    pen.set_pen_color(BLUE)
    # Drive forward for 400 mm to draw a line.
    drivetrain.drive_for(FORWARD, 400, MM)

pen.set_pen_width()#

The pen.set_pen_width(width) method is used to set the width of the VR Pen.

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`width`	The width of the VR Pen: `EXTRA_THIN`, `THIN`, `MEDIUM`, `WIDE`, or `EXTRA-WIDE`.

**返回：**无。

The default VR Pen width is THIN.

def main():
    # Move the VR Pen down.
    pen.move(DOWN)
    # Set the VR Pen's width to medium.
    pen.set_pen_width(MEDIUM)
    # Drive forward for 400 mm to draw a line.
    drivetrain.drive_for(FORWARD, 400, MM)

pen.set_pen_color_rgb()#

The pen.set_pen_color_rgb(red, green, blue, opacity) method is used to set the RGB value for the VR Pen’s color.

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`red`	RGB 值中红色的强度，范围从 0 到 255。
`green`	RGB 值中绿色的强度，范围从 0 到 255。
`blue`	RGB 值中蓝色的强度，范围从 0 到 255。
`opacity`	VR Pen 颜色的透明度，范围从 0 到 100%。

**返回：**无。

def main():
    # Move the VR Pen down.
    pen.move(DOWN)
    # Set the color to orange at full opacity.
    pen.set_pen_color_rgb(225, 112, 52, 100)
    # Drive forward for 400 MM to draw a line.
    drivetrain.drive_for(FORWARD, 400, MM)

pen.fill()#

The pen.fill(red, green, blue, opacity) method fills in the shape of whatever the VR Pen is on top of, for example:


网格线	网格方块	在没有网格的游乐场上，它填满了整个游乐场地板。

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`red`	RGB 值中红色的强度，范围从 0 到 255。
`green`	RGB 值中绿色的强度，范围从 0 到 255。
`blue`	RGB 值中蓝色的强度，范围从 0 到 255。
`opacity`	VR Pen 颜色的透明度，范围从 0 到 100%。

**返回：**无。

def main():
    # Fill the playground's floor with blue at full opacity.
    pen.fill(43, 162, 202, 100)

打印 #

brain.print()#

The brain.print(value, precision = 0) method is used to print words, numbers, and reported values to the Print Console.

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`value`	Any words, numbers, or sensors that report a value. Words must be in quotation marks: `”`.
`precision`	Optional. The amount of decimals reported from a value from a sensor or variable, from `precision = 0`-`precision = 9`. The default print precision is `0`.

**返回：**无。

def main():
    # Print the Drivetrain's current heading in degrees with 2 decimal points.
    brain.print("Drivetrain's heading:",
        drivetrain.heading(DEGREES), precision = 2)

brain.clear()#

The brain.clear() method is used to clear all the rows in the Print Console and resets the cursor to the first line.

这是一种非等待方法，允许任何后续方法无延迟地执行。

**返回：**无。

def main():
    # Print "Project has started."
    brain.print("Project has started.")
    # Wait 3 seconds.
    wait(3, SECONDS)
    # Clear the print console.
    brain.clear()

brain.new_line()#

The brain.new_line() method is used to set the cursor to a new line in the Print Console.

这是一种非等待方法，允许任何后续方法无延迟地执行。

**返回：**无。

def main():
    # Print "Project has started."
    brain.print("Project has started.")
    # Move the cursor to a new line.
    brain.new_line()

brain.set_print_color()#

The brain.set_print_color(color) method is used to set the color of the text printed to the Print Console.

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`color`	The color of the text to be printed: `BLACK`, `RED`, `GREEN`, or `BLUE`. By default, the color is `BLACK`.

**返回：**无。

def main():
    # Set the print text color to red.
    brain.set_print_color(RED)
    # Print a message.
    brain.print("This is red!")

监控变量（）#

The monitor_variable(“variable”, …) method is used to add variables to the Monitor Console so that the value of the variables can be seen and monitored.

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`variable`	任何先前设置的全局变量。

**返回：**无。

# Create global variable.
disk_count = 1

def main():
    # Add disk_count to the Monitor Console.
    monitor_variable("disk_count")

监控传感器（）#

The monitor_sensor(“sensor”, …) method is used to add sensors to the monitor console so that the sensor values can be monitored.

这是一种非等待方法，允许任何后续方法无延迟地执行。

参数	描述
`sensor`	任何受支持的传感器标识符。

**返回：**无。

支持的传感器标识符：

brain.timer.time
drivetrain.is_done
drivetrain.is_moving
drivetrain.heading
drivetrain.rotation
drivetrain.velocity_rpm
drivetrain.velocity_percent
arm_motor.is_done
arm_motor.is_spinning
arm_motor.position_degrees
arm_motor.position_turns
arm_motor.velocity_rpm
arm_motor.velocity_percent
arm_motor_group.is_done
arm_motor_group.is_spinning
arm_motor_group.position_degrees
arm_motor_group.position_turns
arm_motor_group.velocity_rpm
arm_motor_group.velocity_percent
intake_motor.is_done
intake_motor.is_spinning
intake_motor.position_degrees
intake_motor.position_turns
intake_motor.velocity_rpm
intake_motor.velocity_percent
intake_motor_group.is_done
intake_motor_group.is_spinning
intake_motor_group.position_degrees
intake_motor_group.position_turns
intake_motor_group.velocity_rpm
intake_motor_group.velocity_percent
catapult_motor.is_done
catapult_motor.is_spinning
catapult_motor.position_degrees
catapult_motor.position_turns
catapult_motor.velocity_rpm
catapult_motor.velocity_percent
catapult_tension_motor.is_done
catapult_tension_motor.is_spinning
catapult_tension_motor.position_degrees
catapult_tension_motor.position_turns
catapult_tension_motor.velocity_rpm
catapult_tension_motor.velocity_percent
intake_bumper.pressing
bumper.pressing
front_distance.is_object_detected
front_distance.object_distance_mm
front_distance.object_distance_inches
front_optical.is_near_object
front_optical.color
front_optical.brightness
front_optical.hue
color.is_near_object
color.color
color.brightness
color.hue

def main():
    # Add the VR Robot's positional coordinates to the monitor console.
    monitor_sensor("location.position")