---

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 String &	getTypeName (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:

• OgreUserDefinedObject.h
• OgreUserDefinedObject.cpp

Copyright © 2002-2003 by The OGRE Team
Last modified Wed Jan 21 00:21:13 2004