Ogre::Controller< T > Class Template Reference

Instances of this class 'control' the value of another object in the system. More...

#include <OgreController.h>

Inheritance diagram for Ogre::Controller< T >:

[legend]List of all members.


Public Member Functions
	Controller (const SharedPtr< ControllerValue< T > > &src, const SharedPtr< ControllerValue< T > > &dest, const SharedPtr< ControllerFunction< T > > &func)
	Usual constructor.
virtual	~Controller ()
	Default d-tor.
void	setSource (const SharedPtr< ControllerValue< T > > &src)
	Sets the input controller value.
const SharedPtr< ControllerValue< T > > &	getSource (void) const
	Gets the input controller value.
void	setDestination (const SharedPtr< ControllerValue< T > > &dest)
	Sets the output controller value.
const SharedPtr< ControllerValue< T > > &	getDestination (void) const
	Gets the output controller value.
bool	getEnabled (void) const
	Returns true if this controller is currently enabled.
void	setEnabled (bool enabled)
	Sets whether this controller is enabled.
void	setFunction (const SharedPtr< ControllerFunction< T > > &func)
	Sets the function object to be used by this controller.
const SharedPtr< ControllerFunction< T > > &	getFunction (void) const
	Returns a pointer to the function object used by this controller.
void	update (void)
	Tells this controller to map it's input controller value to it's output controller value, via the controller function.
void *	operator new (size_t sz, const char file, int line, const char func)
	operator new, with debug line info
void *	operator new (size_t sz)
void *	operator new (size_t sz, void *ptr)
	placement operator new
void *	operator new[] (size_t sz, const char file, int line, const char func)
	array operator new, with debug line info
void *	operator new[] (size_t sz)
void	operator delete (void *ptr)
void	operator delete (void ptr, void )
void	operator delete (void ptr, const char , int, const char *)
void	operator delete[] (void *ptr)
void	operator delete[] (void ptr, const char , int, const char *)
Protected Attributes
SharedPtr< ControllerValue< T > >	mSource
	Source value.
SharedPtr< ControllerValue< T > >	mDest
	Destination value.
SharedPtr< ControllerFunction< T > >	mFunc
	Function.
bool	mEnabled
	Controller is enabled or not.

Detailed Description

template<typename T>
class Ogre::Controller< T >

Instances of this class 'control' the value of another object in the system.

Remarks:: Controller classes are used to manage the values of object automatically based on the value of some input. For example, a Controller could animate a texture by controlling the current frame of the texture based on time, or a different Controller could change the colour of a material used for a spaceship shield mesh based on the remaining shield power level of the ship.

: The Controller is an intentionally abstract concept - it can generate values based on input and a function, which can either be one of the standard ones supplied, or a function can be 'plugged in' for custom behaviour - see the ControllerFunction class for details. Both the input and output values are via ControllerValue objects, meaning that any value can be both input and output of the controller.

: Whilst this is very flexible, it can be a little bit confusing so to make it simpler the most often used controller setups are available by calling methods on the ControllerManager object.

See also:: ControllerFunction

Definition at line 131 of file OgreController.h.

Constructor & Destructor Documentation

template<typename T>

Ogre::Controller< T >::Controller ( const SharedPtr< ControllerValue< T > > & src,

const SharedPtr< ControllerValue< T > > & dest,

const SharedPtr< ControllerFunction< T > > & func

)

Usual constructor.

Remarks:
Requires source and destination values, and a function object. None of these are destroyed with the Controller when it is deleted (they can be shared) so you must delete these as appropriate.

Definition at line 151 of file OgreController.h.

template<typename T>

virtual Ogre::Controller< T >::~Controller ( ) [virtual]

Default d-tor.

Definition at line 160 of file OgreController.h.

Member Function Documentation

template<typename T>

const SharedPtr< ControllerValue<T> >& Ogre::Controller< T >::getDestination ( void ) const

Gets the output controller value.

Definition at line 180 of file OgreController.h.

template<typename T>

bool Ogre::Controller< T >::getEnabled ( void ) const

Returns true if this controller is currently enabled.

Definition at line 186 of file OgreController.h.

template<typename T>

const SharedPtr< ControllerFunction<T> >& Ogre::Controller< T >::getFunction ( void ) const

Returns a pointer to the function object used by this controller.

Definition at line 206 of file OgreController.h.

template<typename T>

const SharedPtr< ControllerValue<T> >& Ogre::Controller< T >::getSource ( void ) const

Gets the input controller value.

Definition at line 169 of file OgreController.h.

template<class Alloc>

void Ogre::AllocatedObject< Alloc >::operator delete ( void * ptr,

const char * ,

int ,

const char *

) [inherited]

Definition at line 101 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void Ogre::AllocatedObject< Alloc >::operator delete ( void * ptr,

void *

) [inherited]

Definition at line 95 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void Ogre::AllocatedObject< Alloc >::operator delete ( void * ptr ) [inherited]

Definition at line 89 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void * ptr,

const char * ,

int ,

const char *

) [inherited]

Definition at line 112 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void Ogre::AllocatedObject< Alloc >::operator delete[] ( void * ptr ) [inherited]

Definition at line 106 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void* Ogre::AllocatedObject< Alloc >::operator new ( size_t sz,

void * ptr

) [inherited]

placement operator new

Definition at line 73 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void* Ogre::AllocatedObject< Alloc >::operator new ( size_t sz ) [inherited]

Definition at line 67 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void* Ogre::AllocatedObject< Alloc >::operator new ( size_t sz,

const char * file,

int line,

const char * func

) [inherited]

operator new, with debug line info

Definition at line 62 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void* Ogre::AllocatedObject< Alloc >::operator new[] ( size_t sz ) [inherited]

Definition at line 84 of file OgreMemoryAllocatedObject.h.

template<class Alloc>

void* Ogre::AllocatedObject< Alloc >::operator new[] ( size_t sz,

const char * file,

int line,

const char * func

) [inherited]

array operator new, with debug line info

Definition at line 79 of file OgreMemoryAllocatedObject.h.

template<typename T>

void Ogre::Controller< T >::setDestination ( const SharedPtr< ControllerValue< T > > & dest )

Sets the output controller value.

Definition at line 174 of file OgreController.h.

template<typename T>

void Ogre::Controller< T >::setEnabled ( bool enabled )

Sets whether this controller is enabled.

Definition at line 192 of file OgreController.h.

template<typename T>

void Ogre::Controller< T >::setFunction ( const SharedPtr< ControllerFunction< T > > & func )

Sets the function object to be used by this controller.

Definition at line 199 of file OgreController.h.

template<typename T>

void Ogre::Controller< T >::setSource ( const SharedPtr< ControllerValue< T > > & src )

Sets the input controller value.

Definition at line 164 of file OgreController.h.

template<typename T>

void Ogre::Controller< T >::update ( void )

Tells this controller to map it's input controller value to it's output controller value, via the controller function.

Remarks:
This method is called automatically every frame by ControllerManager.

Definition at line 216 of file OgreController.h.