Joystick Class Reference

#include <Joystick.h>

Inherits GenericHID.

Collaboration diagram for Joystick:

Collaboration graph
[legend]

List of all members.

Public Member Functions

 Joystick (unsigned port)
virtual float GetX (JoystickHand hand=kRightHand)
virtual float GetY (JoystickHand hand=kRightHand)
virtual float GetZ (void)
virtual float GetTwist (void)
virtual float GetThrottle (void)
virtual float GetAxis (AxisType axis)
float GetRawAxis (unsigned axis)
virtual bool GetTrigger (JoystickHand hand=kRightHand)
virtual bool GetTop (JoystickHand hand=kRightHand)
virtual bool GetBumper (JoystickHand hand=kRightHand)
virtual bool GetButton (ButtonType button)
bool GetRawButton (unsigned button)

Protected Member Functions

 Joystick (unsigned port, unsigned numAxisTypes, unsigned numButtonTypes)


Detailed Description

Handle input from standard Joysticks connected to the Driver Station. This class handles standard input that comes from the Driver Station. Each time a value is requested the most recent value is returned. There is a single class instance for each joystick and the mapping of ports to hardware buttons depends on the code in the driver station.

Constructor & Destructor Documentation

Joystick::Joystick ( unsigned  port  ) 

Construct an instance of a joystick. The joystick index is the usb port on the drivers station.

Parameters:
port The port on the driver station that the joystick is plugged into.

Joystick::Joystick ( unsigned  port,
unsigned  numAxisTypes,
unsigned  numButtonTypes 
) [protected]

Protected version of the constructor to be called by sub-classes.

This constructor allows the subclass to configure the number of constants for axes and buttons.

Parameters:
port The port on the driver station that the joystick is plugged into.
numAxisTypes The number of axis types in the enum.
numButtonTypes The number of button types in the enum.


Member Function Documentation

float Joystick::GetX ( JoystickHand  hand = kRightHand  )  [virtual]

Get the X value of the joystick. This depends on the mapping of the joystick connected to the current port.

float Joystick::GetY ( JoystickHand  hand = kRightHand  )  [virtual]

Get the Y value of the joystick. This depends on the mapping of the joystick connected to the current port.

float Joystick::GetZ ( void   )  [virtual]

Get the Z value of the current joystick. This depends on the mapping of the joystick connected to the current port.

float Joystick::GetTwist ( void   )  [virtual]

Get the twist value of the current joystick. This depends on the mapping of the joystick connected to the current port.

float Joystick::GetThrottle ( void   )  [virtual]

Get the throttle value of the current joystick. This depends on the mapping of the joystick connected to the current port.

float Joystick::GetAxis ( AxisType  axis  )  [virtual]

For the current joystick, return the axis determined by the argument.

This is for cases where the joystick axis is returned programatically, otherwise one of the previous functions would be preferable (for example GetX()).

Parameters:
axis The axis to read.
Returns:
The value of the axis.

float Joystick::GetRawAxis ( unsigned  axis  ) 

Get the value of the axis.

Parameters:
axis The axis to read [1-6].
Returns:
The value of the axis.

bool Joystick::GetTrigger ( JoystickHand  hand = kRightHand  )  [virtual]

Read the state of the trigger on the joystick.

Look up which button has been assigned to the trigger and read its state.

Parameters:
hand This parameter is ignored for the Joystick class and is only here to complete the GenericHID interface.
Returns:
The state of the trigger.

bool Joystick::GetTop ( JoystickHand  hand = kRightHand  )  [virtual]

Read the state of the top button on the joystick.

Look up which button has been assigned to the top and read its state.

Parameters:
hand This parameter is ignored for the Joystick class and is only here to complete the GenericHID interface.
Returns:
The state of the top button.

bool Joystick::GetBumper ( JoystickHand  hand = kRightHand  )  [virtual]

This is not supported for the Joystick. This method is only here to complete the GenericHID interface.

bool Joystick::GetButton ( ButtonType  button  )  [virtual]

Get buttons based on an enumerated type.

The button type will be looked up in the list of buttons and then read.

Parameters:
button The type of button to read.
Returns:
The state of the button.

bool Joystick::GetRawButton ( unsigned  button  ) 

Get the button value for buttons 1 through 12.

The buttons are returned in a single 16 bit value with one bit representing the state of each button. The appropriate button is returned as a boolean value.

Parameters:
button The button number to be read.
Returns:
The state of the button.


The documentation for this class was generated from the following files:

Generated on Thu Oct 2 14:01:29 2008 for WPI Robotics Library by  doxygen 1.5.5