外观#

#

pen.move()#

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

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

参数

描述

行动

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.

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

参数

描述

颜色

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.

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

参数

描述

宽度

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.

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

参数

描述

红色的

RGB 值中红色的强度,范围从 0 到 255。

绿色的

RGB 值中绿色的强度,范围从 0 到 255。

蓝色的

RGB 值中蓝色的强度,范围从 0 到 255。

不透明度

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:

../../_images/fill_line_grid.png

../../_images/fill_grid_square.png

../../_images/whole_floor.png

网格线

网格方块

在没有网格的游乐场上,它填满了整个游乐场地板。

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

参数

描述

红色的

RGB 值中红色的强度,范围从 0 到 255。

绿色的

RGB 值中绿色的强度,范围从 0 到 255。

蓝色的

RGB 值中蓝色的强度,范围从 0 到 255。

不透明度

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.

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

参数

描述

价值

Any words, numbers, or sensors that report a value. Words must be in quotation marks: .

精确

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.

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

参数

描述

颜色

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.

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

参数

描述

多变的

任何先前设置的全局变量。

**返回:**无。

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

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

参数

描述

传感器

任何受支持的传感器标识符。

**返回:**无。

支持的传感器标识符:

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