Abstract class defining the interface all renderable objects must implement. More...
#include <OgreRenderable.h>
Classes | |
class | RenderSystemData |
An internal class that should be used only by a render system for internal use. More... | |
class | Visitor |
Visitor object that can be used to iterate over a collection of Renderable instances abstractly. More... | |
Public Member Functions | |
Renderable () | |
virtual | ~Renderable () |
Virtual destructor needed as class has virtual methods. More... | |
virtual void | _updateCustomGpuParameter (const GpuProgramParameters::AutoConstantEntry &constantEntry, GpuProgramParameters *params) const |
Update a custom GpuProgramParameters constant which is derived from information only this Renderable knows. More... | |
virtual bool | getCastsShadows (void) const |
Method which reports whether this renderable would normally cast a shadow. More... | |
const Vector4 & | getCustomParameter (size_t index) const |
Gets the custom value associated with this Renderable at the given index. More... | |
virtual const LightList & | getLights (void) const =0 |
Gets a list of lights, ordered relative to how close they are to this renderable. More... | |
virtual const MaterialPtr & | getMaterial (void) const =0 |
Retrieves a weak reference to the material this renderable object uses. More... | |
virtual unsigned short | getNumWorldTransforms (void) const |
Returns the number of world transform matrices this renderable requires. More... | |
virtual bool | getPolygonModeOverrideable (void) const |
Gets whether this renderable's chosen detail level can be overridden (downgraded) by the camera setting. More... | |
virtual void | getRenderOperation (RenderOperation &op)=0 |
Gets the render operation required to send this object to the frame buffer. More... | |
virtual RenderSystemData * | getRenderSystemData () const |
Sets render system private data. More... | |
virtual Real | getSquaredViewDepth (const Camera *cam) const =0 |
Returns the camera-relative squared depth of this renderable. More... | |
virtual Technique * | getTechnique (void) const |
Retrieves a pointer to the Material Technique this renderable object uses. More... | |
bool | getUseIdentityProjection (void) const |
Returns whether or not to use an 'identity' projection. More... | |
bool | getUseIdentityView (void) const |
Returns whether or not to use an 'identity' view. More... | |
virtual const Any & | getUserAny (void) const |
UserObjectBindings & | getUserObjectBindings () |
Return an instance of user objects binding associated with this class. More... | |
const UserObjectBindings & | getUserObjectBindings () const |
Return an instance of user objects binding associated with this class. More... | |
virtual void | getWorldTransforms (Matrix4 *xform) const =0 |
Gets the world transform matrix / matrices for this renderable object. More... | |
virtual void | postRender (SceneManager *sm, RenderSystem *rsys) |
Called immediately after the Renderable has been rendered. More... | |
virtual bool | preRender (SceneManager *sm, RenderSystem *rsys) |
Called just prior to the Renderable being rendered. More... | |
void | setCustomParameter (size_t index, const Vector4 &value) |
Sets a custom parameter for this Renderable, which may be used to drive calculations for this specific Renderable, like GPU program parameters. More... | |
virtual void | setPolygonModeOverrideable (bool override) |
Sets whether this renderable's chosen detail level can be overridden (downgraded) by the camera setting. More... | |
virtual void | setRenderSystemData (RenderSystemData *val) const |
gets render system private data More... | |
void | setUseIdentityProjection (bool useIdentityProjection) |
Sets whether or not to use an 'identity' projection. More... | |
void | setUseIdentityView (bool useIdentityView) |
Sets whether or not to use an 'identity' view. More... | |
virtual void | setUserAny (const Any &anything) |
Protected Types | |
typedef map< size_t, Vector4 > ::type | CustomParameterMap |
Protected Attributes | |
CustomParameterMap | mCustomParameters |
bool | mPolygonModeOverrideable |
RenderSystemData * | mRenderSystemData |
bool | mUseIdentityProjection |
bool | mUseIdentityView |
UserObjectBindings | mUserObjectBindings |
Abstract class defining the interface all renderable objects must implement.
Definition at line 62 of file OgreRenderable.h.
|
protected |
Definition at line 395 of file OgreRenderable.h.
|
inline |
Definition at line 72 of file OgreRenderable.h.
|
inlinevirtual |
Virtual destructor needed as class has virtual methods.
Definition at line 74 of file OgreRenderable.h.
|
inlinevirtual |
Update a custom GpuProgramParameters constant which is derived from information only this Renderable knows.
constantEntry | The auto constant entry referring to the parameter being updated |
params | The parameters object which this method should call to set the updated parameters. |
Reimplemented in Ogre::TerrainRenderable, Ogre::TerrainZoneRenderable, and Ogre::SubEntity.
Definition at line 288 of file OgreRenderable.h.
References Ogre::GpuProgramParameters::_writeRawConstant(), Ogre::GpuProgramParameters::AutoConstantEntry::data, Ogre::GpuProgramParameters::AutoConstantEntry::elementCount, and Ogre::GpuProgramParameters::AutoConstantEntry::physicalIndex.
|
inlinevirtual |
Method which reports whether this renderable would normally cast a shadow.
Reimplemented in Ogre::TerrainQuadTreeNode::Rend, Ogre::StaticGeometry::GeometryBucket, Ogre::InstancedGeometry::GeometryBucket, and Ogre::SubEntity.
Definition at line 223 of file OgreRenderable.h.
|
inline |
Gets the custom value associated with this Renderable at the given index.
see setCustomParameter for full details. |
Definition at line 249 of file OgreRenderable.h.
References Ogre::Exception::ERR_ITEM_NOT_FOUND, and OGRE_EXCEPT.
|
pure virtual |
Gets a list of lights, ordered relative to how close they are to this renderable.
Implemented in Ogre::BillboardSet, Ogre::Frustum, Ogre::OverlayElement, Ogre::ManualObject::ManualObjectSection, Ogre::TerrainQuadTreeNode::Rend, Ogre::BorderRenderable, Ogre::TerrainRenderable, Ogre::TerrainZoneRenderable, Ogre::BillboardChain, Ogre::StaticGeometry::GeometryBucket, Ogre::InstancedGeometry::GeometryBucket, Ogre::SubEntity, Ogre::Node::DebugRenderable, Ogre::SimpleRenderable, and Ogre::ShadowRenderable.
|
pure virtual |
Retrieves a weak reference to the material this renderable object uses.
Implemented in Ogre::BillboardSet, Ogre::Frustum, Ogre::ManualObject::ManualObjectSection, Ogre::TerrainQuadTreeNode::Rend, Ogre::BorderRenderable, Ogre::OverlayElement, Ogre::BillboardChain, Ogre::StaticGeometry::GeometryBucket, Ogre::InstancedGeometry::GeometryBucket, Ogre::TerrainRenderable, Ogre::TerrainZoneRenderable, Ogre::SubEntity, Ogre::Node::DebugRenderable, Ogre::SimpleRenderable, Ogre::TextAreaOverlayElement, and Ogre::ShadowRenderable.
|
inlinevirtual |
Returns the number of world transform matrices this renderable requires.
Reimplemented in Ogre::BorderRenderable, Ogre::InstancedGeometry::GeometryBucket, and Ogre::SubEntity.
Definition at line 152 of file OgreRenderable.h.
|
inlinevirtual |
Gets whether this renderable's chosen detail level can be overridden (downgraded) by the camera setting.
Reimplemented in Ogre::BorderRenderable.
Definition at line 313 of file OgreRenderable.h.
|
pure virtual |
Gets the render operation required to send this object to the frame buffer.
Implemented in Ogre::BillboardSet, Ogre::Frustum, Ogre::ManualObject::ManualObjectSection, Ogre::TerrainQuadTreeNode::Rend, Ogre::BorderRenderable, Ogre::BillboardChain, Ogre::StaticGeometry::GeometryBucket, Ogre::TerrainRenderable, Ogre::TerrainZoneRenderable, Ogre::SubEntity, Ogre::Node::DebugRenderable, Ogre::PanelOverlayElement, Ogre::SimpleRenderable, Ogre::TextAreaOverlayElement, and Ogre::ShadowRenderable.
|
inlinevirtual |
Sets render system private data.
Definition at line 380 of file OgreRenderable.h.
Returns the camera-relative squared depth of this renderable.
Implemented in Ogre::BillboardSet, Ogre::Frustum, Ogre::OverlayElement, Ogre::ManualObject::ManualObjectSection, Ogre::TerrainQuadTreeNode::Rend, Ogre::BorderRenderable, Ogre::TerrainRenderable, Ogre::TerrainZoneRenderable, Ogre::BillboardChain, Ogre::StaticGeometry::GeometryBucket, Ogre::InstancedGeometry::GeometryBucket, Ogre::SubEntity, Ogre::Node::DebugRenderable, Ogre::Rectangle2D, Ogre::ShadowRenderable, and Ogre::WireBoundingBox.
Referenced by Ogre::QueuedRenderableCollection::DepthSortDescendingLess::operator()(), and Ogre::QueuedRenderableCollection::RadixSortFunctorDistance::operator()().
|
inlinevirtual |
Retrieves a pointer to the Material Technique this renderable object uses.
Reimplemented in Ogre::TerrainQuadTreeNode::Rend, Ogre::StaticGeometry::GeometryBucket, Ogre::InstancedGeometry::GeometryBucket, and Ogre::SubEntity.
Definition at line 93 of file OgreRenderable.h.
|
inline |
Returns whether or not to use an 'identity' projection.
Definition at line 177 of file OgreRenderable.h.
|
inline |
Returns whether or not to use an 'identity' view.
Definition at line 202 of file OgreRenderable.h.
|
inlinevirtual |
Definition at line 330 of file OgreRenderable.h.
|
inline |
Return an instance of user objects binding associated with this class.
You can use it to associate one or more custom objects with this class instance.
Definition at line 336 of file OgreRenderable.h.
|
inline |
Return an instance of user objects binding associated with this class.
You can use it to associate one or more custom objects with this class instance.
Definition at line 342 of file OgreRenderable.h.
|
pure virtual |
Gets the world transform matrix / matrices for this renderable object.
Implemented in Ogre::BillboardSet, Ogre::Frustum, Ogre::ManualObject::ManualObjectSectionShadowRenderable, Ogre::ManualObject::ManualObjectSection, Ogre::TerrainQuadTreeNode::Rend, Ogre::BorderRenderable, Ogre::StaticGeometry::LODBucket::LODShadowRenderable, Ogre::Entity::EntityShadowRenderable, Ogre::OverlayElement, Ogre::BillboardChain, Ogre::StaticGeometry::GeometryBucket, Ogre::InstancedGeometry::GeometryBucket, Ogre::TerrainRenderable, Ogre::TerrainZoneRenderable, Ogre::SubEntity, Ogre::Node::DebugRenderable, Ogre::SimpleRenderable, Ogre::ShadowRenderable, Ogre::Rectangle2D, and Ogre::WireBoundingBox.
|
inlinevirtual |
Called immediately after the Renderable has been rendered.
Definition at line 127 of file OgreRenderable.h.
|
inlinevirtual |
Called just prior to the Renderable being rendered.
Definition at line 122 of file OgreRenderable.h.
|
inline |
Sets a custom parameter for this Renderable, which may be used to drive calculations for this specific Renderable, like GPU program parameters.
index | The index with which to associate the value. Note that this does not have to start at 0, and can include gaps. It also has no direct correlation with a GPU program parameter index - the mapping between the two is performed by the ACT_CUSTOM entry, if that is used. |
value | The value to associate. |
Definition at line 240 of file OgreRenderable.h.
|
inlinevirtual |
Sets whether this renderable's chosen detail level can be overridden (downgraded) by the camera setting.
override | true means that a lower camera detail will override this renderables detail level, false means it won't. |
Definition at line 305 of file OgreRenderable.h.
|
inlinevirtual |
gets render system private data
Definition at line 388 of file OgreRenderable.h.
|
inline |
Sets whether or not to use an 'identity' projection.
Definition at line 163 of file OgreRenderable.h.
|
inline |
Sets whether or not to use an 'identity' view.
Definition at line 188 of file OgreRenderable.h.
|
inlinevirtual |
Sets any kind of user value on this object.
Definition at line 325 of file OgreRenderable.h.
|
protected |
Definition at line 396 of file OgreRenderable.h.
|
protected |
Definition at line 397 of file OgreRenderable.h.
|
mutableprotected |
Definition at line 401 of file OgreRenderable.h.
|
protected |
Definition at line 398 of file OgreRenderable.h.
|
protected |
Definition at line 399 of file OgreRenderable.h.
|
protected |
Definition at line 400 of file OgreRenderable.h.