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

Ogre::UserDefinedObject Class Reference

This class is designed to be subclassed by OGRE users, to allow them to associate their own application objects with MovableObject instances in the engine. More...

#include <OgreUserDefinedObject.h>

List of all members.

Public Methods

 UserDefinedObject ()
 Standard constructor.

virtual long getTypeID (void) const
 Return a number identifying the type of user defined object.

virtual const StringgetTypeName (void) const
 Return a string identifying the type of user defined object.


Detailed Description

This class is designed to be subclassed by OGRE users, to allow them to associate their own application objects with MovableObject instances in the engine.

Remarks:
It's always been suggested that an OGRE application would likley comprise a number of game objects which would keep pointers to OGRE objects in order to maintain the link. However, in some cases it would be very useful to be able to navigate directly from an OGRE instance back to a custom application object. This abstract class exists for this purpose; MovableObjects hold a pointer to a UserDefinedObject instance, which application writers subclass in order to include their own attributes. Your game objects themselves may be subclasses of this class, or your subclasses may merely be a link between them.

Because OGRE never uses instances of this object itself, there is very little definition to this class; the application is expected to add all the detail it wants. However, as a hint, and for debugging purposes, this class does define a 'type id', which it is recommended you use to differentiate between your subclasses, if you have more than one type.

Definition at line 52 of file OgreUserDefinedObject.h.


Constructor & Destructor Documentation

Ogre::UserDefinedObject::UserDefinedObject  
 

Standard constructor.

Definition at line 32 of file OgreUserDefinedObject.cpp.


Member Function Documentation

long Ogre::UserDefinedObject::getTypeID void    const [virtual]
 

Return a number identifying the type of user defined object.

Remarks:
Can be used to differentiate between different types of object which you attach to OGRE MovableObject instances. Recommend you override this in your classes if you use more than one type of object.

Alternatively, you can override the getTypeName method and use that instead; that version is a litle more friendly and easier to scope, but obviously slightly less efficient. You choose which you prefer.

Definition at line 36 of file OgreUserDefinedObject.cpp.

const String & Ogre::UserDefinedObject::getTypeName void    const [virtual]
 

Return a string identifying the type of user defined object.

Remarks:
Can be used to differentiate between different types of object which you attach to OGRE MovableObject instances. Recommend you override this in your classes if you use more than one type of object.

Alternatively, you can override the getTypeID method and use that instead; that version is a litle more efficient, but obviously slightly less easy to read. You choose which you prefer.

Definition at line 40 of file OgreUserDefinedObject.cpp.


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

Copyright © 2002-2003 by The OGRE Team
Last modified Fri May 14 23:27:27 2004