OGRE  13.6
Object-Oriented Graphics Rendering Engine
Ogre::RTShader::HardwareSkinningFactory Class Reference

A factory that enables creation of HardwareSkinning instances. More...

#include <OgreShaderExHardwareSkinning.h>

+ Inheritance diagram for Ogre::RTShader::HardwareSkinningFactory:

Public Member Functions

 HardwareSkinningFactory ()
 
 ~HardwareSkinningFactory ()
 
SubRenderStatecreateInstance (ScriptCompiler *compiler, PropertyAbstractNode *prop, Pass *pass, SGScriptTranslator *translator) override
 
const MaterialPtrgetCustomShadowCasterMaterial (const SkinningType skinningType, ushort index) const
 Returns the name of a custom shadow caster material for a given number of weights. More...
 
const MaterialPtrgetCustomShadowReceiverMaterial (const SkinningType skinningType, ushort index) const
 Returns the name of a custom shadow receiver material for a given number of weights. More...
 
ushort getMaxCalculableBoneCount () const
 The maximum number of bones for which hardware skinning is performed. More...
 
const StringgetType () const override
 
void prepareEntityForSkinning (const Entity *pEntity, SkinningType skinningType=ST_LINEAR, bool correctAntidpodalityHandling=false, bool shearScale=false)
 Prepares an entity's material for use in the hardware skinning (HS). More...
 
virtual void setCustomShadowCasterMaterials (const SkinningType skinningType, const MaterialPtr &caster1Weight, const MaterialPtr &caster2Weight, const MaterialPtr &caster3Weight, const MaterialPtr &caster4Weight)
 Sets the list of custom shadow caster materials. More...
 
virtual void setCustomShadowReceiverMaterials (const SkinningType skinningType, const MaterialPtr &receiver1Weight, const MaterialPtr &receiver2Weight, const MaterialPtr &receiver3Weight, const MaterialPtr &receiver4Weight)
 Sets the list of custom shadow receiver materials. More...
 
void setMaxCalculableBoneCount (ushort count)
 Sets the maximum number of bones for which hardware skinning is performed. More...
 
void writeInstance (MaterialSerializer *ser, SubRenderState *subRenderState, Pass *srcPass, Pass *dstPass) override
 
- Public Member Functions inherited from Ogre::RTShader::SubRenderStateFactory
 SubRenderStateFactory ()
 
virtual ~SubRenderStateFactory ()
 
virtual SubRenderStatecreateInstance ()
 Create an instance of the SubRenderState sub class it suppose to create. More...
 
virtual SubRenderStatecreateInstance (ScriptCompiler *compiler, PropertyAbstractNode *prop, TextureUnitState *texState, SGScriptTranslator *translator)
 Create an instance of the SubRenderState based on script properties. More...
 
virtual SubRenderStatecreateOrRetrieveInstance (SGScriptTranslator *translator)
 Retrieve the previous instance the SRS in the script translator or create a new instance if not found. More...
 
virtual void destroyAllInstances ()
 Destroy all the instances that created by this factory. More...
 
virtual void destroyInstance (SubRenderState *subRenderState)
 Destroy the given instance. More...
 
virtual void writeInstance (MaterialSerializer *ser, SubRenderState *subRenderState, const TextureUnitState *srcTextureUnit, const TextureUnitState *dstTextureUnit)
 Write the given sub-render state instance using the material serializer. More...
 
- Public Member Functions inherited from Ogre::Singleton< HardwareSkinningFactory >
 Singleton (void)
 
 ~Singleton (void)
 

Static Public Member Functions

static HardwareSkinningFactorygetSingleton (void)
 Override standard Singleton retrieval. More...
 
static HardwareSkinningFactorygetSingletonPtr (void)
 Get the singleton instance. More...
 
- Static Public Member Functions inherited from Ogre::Singleton< HardwareSkinningFactory >
static HardwareSkinningFactory & getSingleton (void)
 Get the singleton instance. More...
 
static HardwareSkinningFactory * getSingletonPtr (void)
 Get the singleton instance. More...
 

Detailed Description

A factory that enables creation of HardwareSkinning instances.

Remarks
Sub class of SubRenderStateFactory

Constructor & Destructor Documentation

◆ HardwareSkinningFactory()

Ogre::RTShader::HardwareSkinningFactory::HardwareSkinningFactory ( )

◆ ~HardwareSkinningFactory()

Ogre::RTShader::HardwareSkinningFactory::~HardwareSkinningFactory ( )

Member Function Documentation

◆ getType()

const String& Ogre::RTShader::HardwareSkinningFactory::getType ( ) const
overridevirtual

◆ createInstance()

SubRenderState* Ogre::RTShader::HardwareSkinningFactory::createInstance ( ScriptCompiler compiler,
PropertyAbstractNode prop,
Pass pass,
SGScriptTranslator translator 
)
overridevirtual

◆ writeInstance()

void Ogre::RTShader::HardwareSkinningFactory::writeInstance ( MaterialSerializer ser,
SubRenderState subRenderState,
Pass srcPass,
Pass dstPass 
)
overridevirtual

◆ setCustomShadowCasterMaterials()

virtual void Ogre::RTShader::HardwareSkinningFactory::setCustomShadowCasterMaterials ( const SkinningType  skinningType,
const MaterialPtr caster1Weight,
const MaterialPtr caster2Weight,
const MaterialPtr caster3Weight,
const MaterialPtr caster4Weight 
)
virtual

Sets the list of custom shadow caster materials.

◆ setCustomShadowReceiverMaterials()

virtual void Ogre::RTShader::HardwareSkinningFactory::setCustomShadowReceiverMaterials ( const SkinningType  skinningType,
const MaterialPtr receiver1Weight,
const MaterialPtr receiver2Weight,
const MaterialPtr receiver3Weight,
const MaterialPtr receiver4Weight 
)
virtual

Sets the list of custom shadow receiver materials.

◆ getCustomShadowCasterMaterial()

const MaterialPtr& Ogre::RTShader::HardwareSkinningFactory::getCustomShadowCasterMaterial ( const SkinningType  skinningType,
ushort  index 
) const

Returns the name of a custom shadow caster material for a given number of weights.

◆ getCustomShadowReceiverMaterial()

const MaterialPtr& Ogre::RTShader::HardwareSkinningFactory::getCustomShadowReceiverMaterial ( const SkinningType  skinningType,
ushort  index 
) const

Returns the name of a custom shadow receiver material for a given number of weights.

◆ prepareEntityForSkinning()

void Ogre::RTShader::HardwareSkinningFactory::prepareEntityForSkinning ( const Entity pEntity,
SkinningType  skinningType = ST_LINEAR,
bool  correctAntidpodalityHandling = false,
bool  shearScale = false 
)

Prepares an entity's material for use in the hardware skinning (HS).

This function prepares an entity's material for use by the HS sub-render state. This function scans the entity and extracts the information of the amount of bones and weights in the entity. This function replaces the need specify in the material script the amount of bones and weights needed to make the HS work.

Note that this class does not save the the bone and weight count information internally. Rather this information is stored in the entity's materials as a user binded object.

pEntity A pointer to an entity who's materials need preparing.

◆ getMaxCalculableBoneCount()

ushort Ogre::RTShader::HardwareSkinningFactory::getMaxCalculableBoneCount ( ) const
inline

The maximum number of bones for which hardware skinning is performed.

This number should be limited to avoid problems of using to many parameters in a shader. For example, in pixel shader 3 this should be around 70-90 dependent on other sub-render states in the shader.

The default value for this property is 70 which correspond to pixel shader model 3 limitations

◆ setMaxCalculableBoneCount()

void Ogre::RTShader::HardwareSkinningFactory::setMaxCalculableBoneCount ( ushort  count)
inline

Sets the maximum number of bones for which hardware skinning is performed.

See also
getMaxCalculableBoneCount()

◆ getSingleton()

static HardwareSkinningFactory& Ogre::RTShader::HardwareSkinningFactory::getSingleton ( void  )
static

Override standard Singleton retrieval.

Remarks
Why do we do this? Well, it's because the Singleton implementation is in a .h file, which means it gets compiled into anybody who includes it. This is needed for the Singleton template to work, but we actually only want it compiled into the implementation of the class based on the Singleton, not all of them. If we don't change this, we get link errors when trying to use the Singleton-based class from an outside dll.
This method just delegates to the template version anyway, but the implementation stays in this single compilation unit, preventing link errors.

◆ getSingletonPtr()

static HardwareSkinningFactory* Ogre::RTShader::HardwareSkinningFactory::getSingletonPtr ( void  )
static

Get the singleton instance.


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