axis#

position()#

The controller.axis.position() command returns the current position of the specified Controller’s axis as a percentage.

Object	Description
axis	Which axis to report the position of: `axis1` - Left and right of the right joystick. `axis2` - Up and down of the right joystick. `axis3` - Up and down of the left joystick. `axis4` - Left and right of the left joystick.

Returns: A value in the range +/- 100.

# Print the position of the current Controller's axis to the
# Brain's screen.
brain.screen.print(controller.axis1.position())

changed()#

The controller.axis.changed(callback, arg) command registers a function to be called when the specified axis’ value changes.

Object	Description
axis	Which axis to report the position of: `axis1` - Left and right of the right joystick. `axis2` - Up and down of the right joystick. `axis3` - Up and down of the left joystick. `axis4` - Left and right of the left joystick.

Parameter	Description
callback	A function that will be called when the axis value changes
arg	Optional. A tuple that is used to pass Parameter to the callback function

Returns: An instance of the Event class.

# Define a function axis_changed().
def axis_changed():
    # The Brain will print that the axis changed on the
    # Brain's screen.
    brain.screen.print("axis changed")

# Run axis_changed() when the value of axis1 changes.
controller.axis1.changed(axis_changed)