OSDL::Events::Joystick Class Reference

#include <OSDLJoystick.h>

Inheritance diagram for OSDL::Events::Joystick:

[legend]

Collaboration diagram for OSDL::Events::Joystick:

[legend]

List of all members.

Detailed Description

Models a basic joystick, including relevant axes, hats, balls and buttons.

Usually, joystick directions should be interpreted this way:

axis 0: left-right direction, negative values are left, positive are right
axis 1: up-down direction, negative values are up, positive are down

All events for this joystick are propagated to the associated controller, if any, which allows to finely master all available informations, at the expense of a higher complexity on the controller part.

For usual needs, ClassicalJoystick child class should be more convenient, since it is a higher-level (but a little less general-purpose) model.

See also:: ClassicalJoystick

Definition at line 67 of file OSDLJoystick.h.


Public Member Functions
	Joystick (JoystickNumber index) throw ( JoystickException )
	Constructs a new joystick manager.
virtual	~Joystick () throw ()
	Virtual destructor, closing corresponding joystick device.
virtual const std::string &	getName () const throw ()
	Returns the implementation dependent name of this joystick.
virtual bool	isOpen () const throw ()
	Tells whether this joystick is currently opened.
virtual void	open () throw ( JoystickException )
	Opens the joystick, so that it can be used.
virtual void	close () throw ( JoystickException )
	Closes the joystick.
virtual JoystickAxesCount	getNumberOfAxes () const throw ()
	Returns the number of joystick axes.
virtual JoystickTrackballsCount	getNumberOfTrackballs () const throw ()
	Returns the number of joystick trackballs.
virtual JoystickHatsCount	getNumberOfHats () const throw ()
	Returns the number of joystick hats.
virtual JoystickButtonsCount	getNumberOfButtons () const throw ()
	Returns the number of joystick buttons.
virtual AxisPosition	getAbscissaPosition () const throw ()
	Returns the absolute position of the X axis.
virtual AxisPosition	getOrdinatePosition () const throw ()
	Returns the absolute position of the Y axis.
virtual AxisPosition	getPositionOfAxis (JoystickAxesCount index) const throw ( JoystickException )
	Returns the absolute position of the specified axis.
virtual HatPosition	getPositionOfHat (JoystickHatsCount index) const throw ( JoystickException )
	Returns the absolute position of the specified hat.
virtual bool	isButtonPressed (JoystickButtonsCount buttonNumber) const throw ( JoystickException )
	Tells whether specified joystick button is pressed.
virtual bool	getPositionOfTrackball (JoystickTrackballsCount ball, BallMotion &deltaX, BallMotion &deltaY) const throw ( JoystickException )
	Returns the relative position of the specified trackball.
virtual void	update () throw ()
	Updates the description of this joystick (trackballs, hats, buttons, etc.
virtual const std::string	toString (Ceylan::VerbosityLevels level=Ceylan::high) const throw ()
	Returns an user-friendly description of the state of this object.
virtual OSDL::MVC::Controller &	getActualController () const throw ( EventsException )
	Returns the actual (OSDL) controller this input device should be linked to.
Protected Member Functions
virtual JoystickNumber	getIndex () const throw ()
	Returns the index of this joystick in the platform list.
virtual void	axisChanged (const JoystickAxisEvent &joystickEvent) throw ()
	Called whenever an axis of this joystick changed, and notifies the linked controller, if any.
virtual void	trackballChanged (const JoystickTrackballEvent &joystickEvent) throw ()
	Called whenever a trackball of this joystick changed, and notifies the linked controller, if any.
virtual void	hatChanged (const JoystickHatEvent &joystickEvent) throw ()
	Called whenever a hat of this joystick changed, and notifies the linked controller, if any.
virtual void	buttonPressed (const JoystickButtonEvent &joystickEvent) throw ()
	Called whenever a button of this joystick was pressed, and notifies the linked controller, if any.
virtual void	buttonReleased (const JoystickButtonEvent &joystickEvent) throw ()
	Called whenever a button of this joystick was released, and notifies the linked controller, if any.
Protected Attributes
std::string	_name
	The implementation dependent name of this joystick, if any.
JoystickNumber	_index
	The number of this joystick in platform list.
LowLevelJoystick *	_internalJoystick
	The internal raw joystick being used.
JoystickAxesCount	_axisCount
	The number of axes for this joystick.
JoystickTrackballsCount	_trackballCount
	The number of trackballs for this joystick.
JoystickHatsCount	_hatCount
	The number of hats for this joystick.
JoystickButtonsCount	_buttonCount
	The number of buttons for this joystick.
Private Member Functions
	Joystick (const Joystick &source) throw ()
	Copy constructor made private to ensure that it will never be called.
Joystick &	operator= (const Joystick &source) throw ()
	Assignment operator made private to ensure that it will never be called.
Friends
class	OSDL::Events::JoystickHandler

Constructor & Destructor Documentation

Joystick::Joystick ( JoystickNumber index ) throw ( JoystickException ) [explicit]

Constructs a new joystick manager.

Dummy values will be returned by non-static methods in case there is no SDL support available.

Parameters:

index

the index of this joystick in platform list.

Exceptions:

JoystickException

if the operation failed or is not supported.

It is not a problem as these methods cannot be called: constructors always throw exceptions in that case, thus no instance can be available for these method calls.

Definition at line 56 of file OSDLJoystick.cc.

Joystick::~Joystick ( ) throw () [virtual]

Virtual destructor, closing corresponding joystick device.

Definition at line 86 of file OSDLJoystick.cc.

References close(), and isOpen().

OSDL::Events::Joystick::Joystick ( const Joystick & source ) throw () [explicit, private]

Copy constructor made private to ensure that it will never be called.

The compiler should complain whenever this undefined constructor is called, implicitly or not.

Member Function Documentation

const string & Joystick::getName ( ) const throw () [virtual]

Returns the implementation dependent name of this joystick.

Definition at line 103 of file OSDLJoystick.cc.

References _name.

bool Joystick::isOpen ( ) const throw () [virtual]

Tells whether this joystick is currently opened.

Note:: A joystick must be opened before being used.

Definition at line 111 of file OSDLJoystick.cc.

References _index, _internalJoystick, and OSDL::Video::Pixels::toString().

Referenced by close(), getAbscissaPosition(), getNumberOfAxes(), getNumberOfButtons(), getNumberOfHats(), getNumberOfTrackballs(), getOrdinatePosition(), getPositionOfAxis(), getPositionOfHat(), getPositionOfTrackball(), isButtonPressed(), open(), toString(), and ~Joystick().

void Joystick::open ( ) throw ( JoystickException ) [virtual]

Opens the joystick, so that it can be used.

Exceptions:

JoystickException

if the joystick was already open.

Definition at line 138 of file OSDLJoystick.cc.

References _index, _internalJoystick, isOpen(), and update().

Referenced by OSDL::Events::JoystickHandler::openJoystick().

void Joystick::close ( ) throw ( JoystickException ) [virtual]

Closes the joystick.

Exceptions:

JoystickException

if the joystick was not open.

Definition at line 156 of file OSDLJoystick.cc.

References _internalJoystick, and isOpen().

Referenced by ~Joystick().

JoystickAxesCount Joystick::getNumberOfAxes ( ) const throw () [virtual]

Returns the number of joystick axes.

Note:: The joystick must already have been opened.

Definition at line 254 of file OSDLJoystick.cc.

References _axisCount, and isOpen().

JoystickTrackballsCount Joystick::getNumberOfTrackballs ( ) const throw () [virtual]

Returns the number of joystick trackballs.

Note:: The joystick must already have been opened.

Definition at line 268 of file OSDLJoystick.cc.

References _trackballCount, and isOpen().

JoystickHatsCount Joystick::getNumberOfHats ( ) const throw () [virtual]

Returns the number of joystick hats.

Note:: The joystick must already have been opened.

Definition at line 282 of file OSDLJoystick.cc.

References _hatCount, and isOpen().

JoystickButtonsCount Joystick::getNumberOfButtons ( ) const throw () [virtual]

Returns the number of joystick buttons.

Note:: The joystick must already have been opened.

Definition at line 296 of file OSDLJoystick.cc.

References _buttonCount, and isOpen().

AxisPosition Joystick::getAbscissaPosition ( ) const throw () [virtual]

Returns the absolute position of the X axis.

Note:: On most modern joysticks the X axis is represented by axis 0, which is the axis that is used by this method.
Joystick must be already open.

Definition at line 310 of file OSDLJoystick.cc.

References _axisCount, _internalJoystick, and isOpen().

AxisPosition Joystick::getOrdinatePosition ( ) const throw () [virtual]

Returns the absolute position of the Y axis.

Note:: On most modern joysticks the Y axis is represented by axis 1, which is the axis that is used by this method.
Joystick must be already open.

Definition at line 337 of file OSDLJoystick.cc.

References _axisCount, _internalJoystick, and isOpen().

AxisPosition Joystick::getPositionOfAxis ( JoystickAxesCount index ) const throw ( JoystickException ) [virtual]

Returns the absolute position of the specified axis.

Parameters:

index

the index of the axis for this joystick.

Returns:: the axis position.

Exceptions:

JoystickException

if the joystick is not already opened or if index is out of bounds.

Definition at line 364 of file OSDLJoystick.cc.

References _axisCount, _internalJoystick, isOpen(), and OSDL::Video::Pixels::toString().

HatPosition Joystick::getPositionOfHat ( JoystickHatsCount index ) const throw ( JoystickException ) [virtual]

Returns the absolute position of the specified hat.

Parameters:

index

the index of the hat for this joystick.

Returns:: the hat position.

Exceptions:

JoystickException

if the joystick is not already open or if index is out of bounds.

Definition at line 389 of file OSDLJoystick.cc.

References _hatCount, _internalJoystick, isOpen(), and OSDL::Video::Pixels::toString().

bool Joystick::isButtonPressed ( JoystickButtonsCount buttonNumber ) const throw ( JoystickException ) [virtual]

Tells whether specified joystick button is pressed.

Parameters:

buttonNumber

the number of the button for this joystick.

Returns:: true iff the button is currently pressed.

Exceptions:

JoystickException

if the joystick is not already open or if the button number is out of bounds.

Definition at line 414 of file OSDLJoystick.cc.

References _buttonCount, _internalJoystick, isOpen(), and OSDL::Video::Pixels::toString().

bool Joystick::getPositionOfTrackball	(	JoystickTrackballsCount	ball,
		BallMotion &	deltaX,
		BallMotion &	deltaY
	)			const throw ( JoystickException ) `[virtual]`

Returns the relative position of the specified trackball.

Parameters:

	ball	the number of the ball for this joystick.
	deltaX	the abscissa motion delta, since last call to this method, will be stored here.
	deltaY	the ordinate motion delta, since last call to this method, will be stored here.

Returns:: true iff the operation succeeded.

Exceptions:

JoystickException

if the joystick is not already open or if index is out of bounds.

Note:: Trackballs can only return relative motion since the last call of this method.

Definition at line 439 of file OSDLJoystick.cc.

References _internalJoystick, _trackballCount, isOpen(), and OSDL::Video::Pixels::toString().

void Joystick::update ( ) throw () [virtual]

Updates the description of this joystick (trackballs, hats, buttons, etc.

)

Note:: The joystick must be open.

Definition at line 499 of file OSDLJoystick.cc.

References _axisCount, _buttonCount, _hatCount, _internalJoystick, and _trackballCount.

Referenced by open().

const string Joystick::toString ( Ceylan::VerbosityLevels level = Ceylan::high ) const throw () [virtual]

Returns an user-friendly description of the state of this object.

Parameters:

level

the requested verbosity level.

Note:: Text output format is determined from overall settings.

See also:: Ceylan::TextDisplayable

Reimplemented from OSDL::Events::InputDevice.

Reimplemented in OSDL::Events::ClassicalJoystick.

Definition at line 514 of file OSDLJoystick.cc.

References _axisCount, _buttonCount, _hatCount, _index, _name, _trackballCount, isOpen(), and OSDL::Video::Pixels::toString().

JoystickNumber Joystick::getIndex ( ) const throw () [protected, virtual]

Returns the index of this joystick in the platform list.

Note:: Should be useless.

Definition at line 466 of file OSDLJoystick.cc.

References _index, _internalJoystick, and OSDL::Video::Pixels::toString().

void Joystick::axisChanged ( const JoystickAxisEvent & joystickEvent ) throw () [protected, virtual]

Called whenever an axis of this joystick changed, and notifies the linked controller, if any.

Parameters:

joystickEvent

the corresponding joystick event.

Note:: Expected to be triggered by the Joystick handler.

Reimplemented in OSDL::Events::ClassicalJoystick.

Definition at line 175 of file OSDLJoystick.cc.

References OSDL::Events::EventsModule::DescribeEvent(), OSDL::Events::InputDevice::getActualController(), OSDL::MVC::Controller::joystickAxisChanged(), and OSDL_JOYSTICK_LOG.

Referenced by OSDL::Events::JoystickHandler::axisChanged().

void Joystick::trackballChanged ( const JoystickTrackballEvent & joystickEvent ) throw () [protected, virtual]

Called whenever a trackball of this joystick changed, and notifies the linked controller, if any.

Parameters:

joystickEvent

the corresponding joystick event.

Note:: Expected to be triggered by the Joystick handler.

Definition at line 191 of file OSDLJoystick.cc.

References OSDL::Events::EventsModule::DescribeEvent(), OSDL::Events::InputDevice::getActualController(), OSDL::MVC::Controller::joystickTrackballChanged(), and OSDL_JOYSTICK_LOG.

Referenced by OSDL::Events::JoystickHandler::trackballChanged().

void Joystick::hatChanged ( const JoystickHatEvent & joystickEvent ) throw () [protected, virtual]

Called whenever a hat of this joystick changed, and notifies the linked controller, if any.

Parameters:

joystickEvent

the corresponding joystick event.

Note:: Expected to be triggered by the Joystick handler.

Definition at line 207 of file OSDLJoystick.cc.

References OSDL::Events::EventsModule::DescribeEvent(), OSDL::Events::InputDevice::getActualController(), OSDL::MVC::Controller::joystickHatChanged(), and OSDL_JOYSTICK_LOG.

Referenced by OSDL::Events::JoystickHandler::hatChanged().

void Joystick::buttonPressed ( const JoystickButtonEvent & joystickEvent ) throw () [protected, virtual]

Called whenever a button of this joystick was pressed, and notifies the linked controller, if any.

Parameters:

joystickEvent

the corresponding joystick event.

Note:: Expected to be triggered by the Joystick handler.

Reimplemented in OSDL::Events::ClassicalJoystick.

Definition at line 222 of file OSDLJoystick.cc.

References OSDL::Events::EventsModule::DescribeEvent(), OSDL::Events::InputDevice::getActualController(), OSDL::MVC::Controller::joystickButtonPressed(), and OSDL_JOYSTICK_LOG.

Referenced by OSDL::Events::JoystickHandler::buttonPressed().

void Joystick::buttonReleased ( const JoystickButtonEvent & joystickEvent ) throw () [protected, virtual]

Called whenever a button of this joystick was released, and notifies the linked controller, if any.

Parameters:

joystickEvent

the corresponding joystick event.

Note:: Expected to be triggered by the Joystick handler.

Reimplemented in OSDL::Events::ClassicalJoystick.

Definition at line 238 of file OSDLJoystick.cc.

References OSDL::Events::EventsModule::DescribeEvent(), OSDL::Events::InputDevice::getActualController(), OSDL::MVC::Controller::joystickButtonReleased(), and OSDL_JOYSTICK_LOG.

Referenced by OSDL::Events::JoystickHandler::buttonReleased().

Joystick& OSDL::Events::Joystick::operator= ( const Joystick & source ) throw () [private]

Assignment operator made private to ensure that it will never be called.

The compiler should complain whenever this undefined operator is called, implicitly or not.

Reimplemented in OSDL::Events::ClassicalJoystick.

OSDL::MVC::Controller & InputDevice::getActualController ( ) const throw ( EventsException ) [virtual, inherited]

Returns the actual (OSDL) controller this input device should be linked to.

Exceptions:

EventException

if this input device is not linked to any controller, or if the controller is not an OSDL one.

See also:: isLinkedToController

Definition at line 33 of file OSDLInputDevice.cc.

Referenced by axisChanged(), OSDL::Events::ClassicalJoystick::axisChanged(), OSDL::Events::Mouse::buttonPressed(), buttonPressed(), OSDL::Events::ClassicalJoystick::buttonPressed(), OSDL::Events::Mouse::buttonReleased(), buttonReleased(), OSDL::Events::ClassicalJoystick::buttonReleased(), OSDL::Events::Mouse::focusGained(), OSDL::Events::Mouse::focusLost(), hatChanged(), OSDL::Events::Mouse::mouseMoved(), and trackballChanged().

Friends And Related Function Documentation

friend class OSDL::Events::JoystickHandler [friend]

Reimplemented in OSDL::Events::ClassicalJoystick.

Definition at line 76 of file OSDLJoystick.h.

Member Data Documentation

std::string OSDL::Events::Joystick::_name [protected]

The implementation dependent name of this joystick, if any.

Definition at line 391 of file OSDLJoystick.h.

Referenced by getName(), and toString().

JoystickNumber OSDL::Events::Joystick::_index [protected]

The number of this joystick in platform list.

Definition at line 395 of file OSDLJoystick.h.

Referenced by getIndex(), isOpen(), open(), and toString().

LowLevelJoystick* OSDL::Events::Joystick::_internalJoystick [protected]

The internal raw joystick being used.

Definition at line 399 of file OSDLJoystick.h.

Referenced by close(), getAbscissaPosition(), getIndex(), getOrdinatePosition(), getPositionOfAxis(), getPositionOfHat(), getPositionOfTrackball(), isButtonPressed(), isOpen(), open(), and update().

JoystickAxesCount OSDL::Events::Joystick::_axisCount [protected]

The number of axes for this joystick.

Definition at line 403 of file OSDLJoystick.h.

Referenced by getAbscissaPosition(), getNumberOfAxes(), getOrdinatePosition(), getPositionOfAxis(), toString(), and update().

JoystickTrackballsCount OSDL::Events::Joystick::_trackballCount [protected]

The number of trackballs for this joystick.

Definition at line 407 of file OSDLJoystick.h.

Referenced by getNumberOfTrackballs(), getPositionOfTrackball(), toString(), and update().

JoystickHatsCount OSDL::Events::Joystick::_hatCount [protected]

The number of hats for this joystick.

Definition at line 411 of file OSDLJoystick.h.

Referenced by getNumberOfHats(), getPositionOfHat(), toString(), and update().

JoystickButtonsCount OSDL::Events::Joystick::_buttonCount [protected]

The number of buttons for this joystick.

Definition at line 415 of file OSDLJoystick.h.

Referenced by getNumberOfButtons(), isButtonPressed(), toString(), and update().

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

OSDL::Events::Joystick Class Reference

Detailed Description

Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Friends

Constructor & Destructor Documentation

Member Function Documentation

Friends And Related Function Documentation

Member Data Documentation