Main Page Namespace List Class Hierarchy Alphabetical List Compound List File List Namespace Members Compound Members File Members Related Pages

Ogre::InputReader Class Reference

Abstract class which allows input to be read from various controllers. More...

#include <OgreInput.h>

Inheritance diagram for Ogre::InputReader:

List of all members.

Public Methods
	InputReader ()
virtual	~InputReader ()
void	useBufferedInput (EventQueue *pEventQueue)
	Tells the reader to use buffered input and update the passed in queue. More...
virtual void	initialise (RenderWindow *pWindow, bool useKeyboard=true, bool useMouse=true, bool useGameController=false)=0
	Initialise the input system. More...
virtual void	capture ()=0
	Captures the state of all the input devices. More...
virtual bool	isKeyDown (KeyCode kc) const=0
	Determines if the specified key is currently depressed. More...
virtual long	getMouseRelativeX () const
	Retrieves the relative position of the mouse when capture was called relative to the last time. More...
virtual long	getMouseRelativeY () const
	Retrieves the relative position of the mouse when capture was called relative to the last time. More...
virtual long	getMouseRelativeZ () const
	Retrieves the relative position of the mouse when capture was called relative to the last time. More...
virtual long	getMouseRelX () const=0
	Retrieves the relative (compared to the last input poll) mouse movement on the X (horizontal) axis. More...
virtual long	getMouseRelY () const=0
	Retrieves the relative (compared to the last input poll) mouse movement on the Y (vertical) axis. More...
virtual long	getMouseRelZ () const=0
	Retrieves the relative (compared to the last input poll) mouse movement on the Z (mouse wheel) axis. More...
virtual long	getMouseAbsX () const=0
	Retrieves the absolute mouse position on the X (horizontal) axis. More...
virtual long	getMouseAbsY () const=0
	Retrieves the absolute mouse position on the Y (vertical) axis. More...
virtual long	getMouseAbsZ () const=0
	Retrieves the absolute mouse position on the Z (mouse wheel) axis. More...
virtual void	getMouseState (MouseState &state) const=0
	Retrieves the current state of the mouse. More...
virtual bool	getMouseButton (uchar button) const=0
	Retrieves the state of a mouse button. More...
void	addCursorMoveListener (MouseMotionListener *c)
	Adds a mouse motion listener to the cursor object. More...
void	removeCursorMoveListener (MouseMotionListener *c)
	Remove a mouse motion listener to the cursor object. More...
Protected Methods
void	mouseMoved ()
	Creates mouse moved or dragged events depending if any button is pressed. More...
void	createMouseEvent (int id, int button)
	Creates a MouseEvent that first gets processed by the cursor, then gets pushed on the queue. More...
void	triggerMouseButton (int nMouseCode, bool mousePressed)
	Creates mouse pressed, released, and clicked events. More...
Protected Attributes
long	mModifiers
	The modifiers are a binary flags that represent what buttons are pressed, and what key modifiers are down (e.g. More...
Cursor *	mCursor
	Internal Cursor object. More...
EventQueue *	mEventQueue
	EventQueue is used for buffered input support. More...
bool	mUseBuffered
	Wether to use buffering input support - buffering support relies on using an EventQueue. More...
MouseState	mMouseState
	The mouse state in immediate mode. More...

Detailed Description

Abstract class which allows input to be read from various controllers.

Remarks:: You can access an appropriate concrete subclass of this interface by calling PlatformManager::createInputReader.

Warning:: Temporary implementation only. This class is likely to be refactored into a better design when I get time to look at it properly. For now it's a quick-and-dirty way to get what I need.

See also:: PlatformManager::createInputReader

Constructor & Destructor Documentation

Ogre::InputReader::InputReader ( )

Ogre::InputReader::~InputReader ( ) [virtual]

Member Function Documentation

void Ogre::InputReader::addCursorMoveListener ( MouseMotionListener * c )

Adds a mouse motion listener to the cursor object.
This keeps the Cursor object hidden.

virtual void Ogre::InputReader::capture ( ) [pure virtual]

Captures the state of all the input devices.

Remarks:
This method captures the state of all input devices and stores it internally for use when the enquiry methods are next called. This is done to ensure that all input is captured at once and therefore combinations of input are not subject to time differences when methods are called.

Implemented in Ogre::SDLInput.

void Ogre::InputReader::createMouseEvent ( int id,

int button

) [protected]

Creates a MouseEvent that first gets processed by the cursor, then gets pushed on the queue.

virtual long Ogre::InputReader::getMouseAbsX ( ) const [pure virtual]

Retrieves the absolute mouse position on the X (horizontal) axis.

Implemented in Ogre::SDLInput.

virtual long Ogre::InputReader::getMouseAbsY ( ) const [pure virtual]

Retrieves the absolute mouse position on the Y (vertical) axis.

Implemented in Ogre::SDLInput.

virtual long Ogre::InputReader::getMouseAbsZ ( ) const [pure virtual]

Retrieves the absolute mouse position on the Z (mouse wheel) axis.

Implemented in Ogre::SDLInput.

virtual bool Ogre::InputReader::getMouseButton ( uchar button ) const [pure virtual]

Retrieves the state of a mouse button.

Implemented in Ogre::SDLInput.

virtual long Ogre::InputReader::getMouseRelativeX ( void ) const [inline, virtual]

Retrieves the relative position of the mouse when capture was called relative to the last time.

Reimplemented in Ogre::Win32Input.

virtual long Ogre::InputReader::getMouseRelativeY ( void ) const [inline, virtual]

Retrieves the relative position of the mouse when capture was called relative to the last time.

Reimplemented in Ogre::Win32Input.

virtual long Ogre::InputReader::getMouseRelativeZ ( ) const [inline, virtual]

Retrieves the relative position of the mouse when capture was called relative to the last time.

virtual long Ogre::InputReader::getMouseRelX ( ) const [pure virtual]

Retrieves the relative (compared to the last input poll) mouse movement on the X (horizontal) axis.

Implemented in Ogre::SDLInput.

virtual long Ogre::InputReader::getMouseRelY ( ) const [pure virtual]

Retrieves the relative (compared to the last input poll) mouse movement on the Y (vertical) axis.

Implemented in Ogre::SDLInput.

virtual long Ogre::InputReader::getMouseRelZ ( ) const [pure virtual]

Retrieves the relative (compared to the last input poll) mouse movement on the Z (mouse wheel) axis.

Implemented in Ogre::SDLInput.

virtual void Ogre::InputReader::getMouseState ( MouseState & state ) const [pure virtual]

Retrieves the current state of the mouse.

Implemented in Ogre::SDLInput.

virtual void Ogre::InputReader::initialise ( RenderWindow * pWindow,

bool useKeyboard = true,

bool useMouse = true,

bool useGameController = false

) [pure virtual]

Initialise the input system.

Note:
Only keyboard and mouse currently implemented.
Parameters:

pWindow The window to capture input for

useKeyboard If true, keyboard input will be supported.

useMouse If true, mouse input will be supported.

useGameController If true, joysticks/gamepads will be supported.

Implemented in Ogre::SDLInput.

virtual bool Ogre::InputReader::isKeyDown ( KeyCode kc ) const [pure virtual]

Determines if the specified key is currently depressed.

Note:
This enquiry method uses the state of the keyboard at the last 'capture' call.

Implemented in Ogre::SDLInput.

void Ogre::InputReader::mouseMoved ( ) [protected]

Creates mouse moved or dragged events depending if any button is pressed.

void Ogre::InputReader::removeCursorMoveListener ( MouseMotionListener * c )

Remove a mouse motion listener to the cursor object.
This keeps the Cursor object hidden.

void Ogre::InputReader::triggerMouseButton ( int nMouseCode,

bool mousePressed

) [protected]

Creates mouse pressed, released, and clicked events.

void Ogre::InputReader::useBufferedInput ( EventQueue * pEventQueue )

Tells the reader to use buffered input and update the passed in queue.

Remarks:
The default behaviour of the input reader is simply to capture the current state of the mouse / keyboard on demand. An alternative is to use buffered input where all events are registered on a queue.

Member Data Documentation

Cursor* Ogre::InputReader::mCursor [protected]

Internal Cursor object.

Remarks:
This is a mathematical representation of where the cursor is, it does not draw a cursor.
See also:
CursorGuiElement.

EventQueue* Ogre::InputReader::mEventQueue [protected]

EventQueue is used for buffered input support.

long Ogre::InputReader::mModifiers [protected]

The modifiers are a binary flags that represent what buttons are pressed, and what key modifiers are down (e.g.
shift/alt).

MouseState Ogre::InputReader::mMouseState [protected]

The mouse state in immediate mode.

bool Ogre::InputReader::mUseBuffered [protected]

Wether to use buffering input support - buffering support relies on using an EventQueue.

See also:
class EventQueue

Ogre::InputReader Class Reference

Public Methods

Protected Methods

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation