Looks#

Pen #

pen.move()#

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

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`action`	The set position of the VR Pen as `UP` or `DOWN`.

Returns: None.

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.

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`color`	The color of the VR Pen: `BLACK`, `RED`, `GREEN`, or `BLUE`.

Returns: None.

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.

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`width`	The width of the VR Pen: `EXTRA_THIN`, `THIN`, `MEDIUM`, `WIDE`, or `EXTRA-WIDE`.

Returns: None.

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.

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`red`	The intensity of the color red in the RGB value, ranging from 0 to 255.
`green`	The intensity of the color green in the RGB value, ranging from 0 to 255.
`blue`	The intensity of the color blue in the RGB value, ranging from 0 to 255.
`opacity`	The transparency of the VR Pen’s color, ranging from 0 to 100 percent.

Returns: None.

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:


Grid lines	Grid square	On Playgrounds with no grid, it fills the entire Playground floor.

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`red`	The intensity of the color red in the RGB value, ranging from 0 to 255.
`green`	The intensity of the color green in the RGB value, ranging from 0 to 255.
`blue`	The intensity of the color blue in the RGB value, ranging from 0 to 255.
`opacity`	The transparency of the VR Pen’s color, ranging from 0 to 100 percent.

Returns: None.

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

Print #

brain.print()#

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

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`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`.

Returns: None.

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.

This is a non-waiting method and allows any subsequent methods to execute without delay.

Returns: None.

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.

This is a non-waiting method and allows any subsequent methods to execute without delay.

Returns: None.

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.

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`color`	The color of the text to be printed: `BLACK`, `RED`, `GREEN`, or `BLUE`. By default, the color is `BLACK`.

Returns: None.

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

monitor_variable()#

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.

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`variable`	Any previously set global variable.

Returns: None.

# Create global variable.
disk_count = 1

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

monitor_sensor()#

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

This is a non-waiting method and allows any subsequent methods to execute without delay.

Parameters	Description
`sensor`	Any supported sensor identifier.

Returns: None.

Supported sensor identifiers:

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