Looks#

Pen#

pen.move()#

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

This is a non-blocking command and allows any subsequent commands 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) command is used to set the color of the VR Pen.

This is a non-blocking command and allows any subsequent commands 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) command is used to set the width of the VR Pen.

This is a non-blocking command and allows any subsequent commands 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) command is used to set the RGB value for the VR Pen’s color.

This is a non-blocking command and allows any subsequent commands 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) command uses the VEX VR Pen on the Art Canvas+ Playground to fill an area of the Playground with a specified color.

This is a non-blocking command and allows any subsequent commands 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) command is used to print words, numbers, and reported values to the Print Console.

This is a non-blocking command and allows any subsequent commands 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() command is used to clear all the rows in the Print Console and resets the cursor to the first line.

This is a non-blocking command and allows any subsequent commands 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() command is used to set the cursor to a new line in the Print Console.

This is a non-blocking command and allows any subsequent commands 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) command is used to set the color of the text printed to the Print Console.

This is a non-blocking command and allows any subsequent commands 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", ...) command 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-blocking command and allows any subsequent commands 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", ...) command is used to add sensors to the monitor console so that the sensor values can be monitored.

This is a non-blocking command and allows any subsequent commands 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")