- Cal3D 0.11 API Reference -

Public Member Functions
CalModel Class Reference
Inheritance diagram for CalModel:
cal3d::noncopyable

List of all members.

Public Member Functions

 CalModel (CalCoreModel *pCoreModel)
 Constructs the model instance.
 ~CalModel ()
 Destructs the model instance.
bool attachMesh (int coreMeshId)
 Attachs a mesh.
bool detachMesh (int coreMeshId)
 Detaches a mesh.
CalCoreModelgetCoreModel () const
 Provides access to the core model.
CalMeshgetMesh (int coreMeshId) const
 Provides access to an attached mesh.
CalMixergetMixer () const
 Returns the mixer.
CalAbstractMixergetAbstractMixer () const
 Returns the mixer.
void setAbstractMixer (CalAbstractMixer *pMixer)
 Sets the mixer to a CalAbstractMixer subclass instance.
CalMorphTargetMixergetMorphTargetMixer () const
 Provides access to the morph target mixer.
CalPhysiquegetPhysique () const
 Provides access to the physique.
CalRenderergetRenderer () const
 Provides access to the renderer.
CalSkeletongetSkeleton () const
 Provides access to the skeleton.
CalSpringSystemgetSpringSystem () const
 Provides access to the spring system.
CalBoundingBoxgetBoundingBox (bool precision=false)
 Returns the global bounding box of the model.
Cal::UserData getUserData () const
 Provides access to the user data.
std::vector< CalMesh * > & getVectorMesh ()
 Returns the mesh vector.
void setLodLevel (float lodLevel)
 Sets the LOD level.
void setMaterialSet (int setId)
 Sets the material set.
void setUserData (Cal::UserData userData)
 Stores user data.
void update (float deltaTime)
 Updates the model instance.
void disableInternalData ()
 Disable internal data (and thus springs system)

Constructor & Destructor Documentation

CalModel::CalModel ( CalCoreModel pCoreModel)

Constructs the model instance.

This function is the default constructor of the model instance.

CalModel::~CalModel ( )

Destructs the model instance.

This function is the destructor of the model instance.


Member Function Documentation

bool CalModel::attachMesh ( int  coreMeshId)

Attachs a mesh.

This function attachs a mesh to the model instance.

Parameters:
coreMeshIdThe ID of the mesh that should be attached.
Returns:
One of the following values:
  • true if successful
  • false if an error happend
bool CalModel::detachMesh ( int  coreMeshId)

Detaches a mesh.

This function detaches a mesh from the model instance.

Parameters:
coreMeshIdThe ID of the mesh that should be detached.
Returns:
One of the following values:
  • true if successful
  • false if an error happend
void CalModel::disableInternalData ( )

Disable internal data (and thus springs system)

CalAbstractMixer * CalModel::getAbstractMixer ( ) const

Returns the mixer.

Returns:
  • a pointer to the mixer
  • 0 if no mixer was set
CalBoundingBox & CalModel::getBoundingBox ( bool  precision = false)

Returns the global bounding box of the model.

This function returns the global bounding box of the model.

Parameters:
precision: indicate if the function need to compute a correct bounding box
Returns:
bounding box.
CalCoreModel * CalModel::getCoreModel ( ) const

Provides access to the core model.

This function returns the core model on which this model instance is based on.

Returns:
One of the following values:
  • a pointer to the core model
  • 0 if an error happend
CalMesh * CalModel::getMesh ( int  coreMeshId) const

Provides access to an attached mesh.

This function returns the attached mesh with the given core mesh ID.

Parameters:
coreMeshIdThe core mesh ID of the mesh that should be returned.
Returns:
One of the following values:
  • a pointer to the mesh
  • 0 if an error happend
CalMixer * CalModel::getMixer ( ) const

Returns the mixer.

If a mixer that is not an instance of CalMixer was set with the CalModel::setAbstractMixer method, an INVALID_MIXER_TYPE error (see CalError) is set and 0 is returned.

Returns:
  • a pointer to the mixer
  • 0 if an error happend
CalMorphTargetMixer * CalModel::getMorphTargetMixer ( ) const

Provides access to the morph target mixer.

This function returns the morph target mixer.

Returns:
One of the following values:
  • a pointer to the morph target mixer
  • 0 if an error happend
CalPhysique * CalModel::getPhysique ( ) const

Provides access to the physique.

This function returns the physique.

Returns:
One of the following values:
  • a pointer to the physique
  • 0 if an error happend
CalRenderer * CalModel::getRenderer ( ) const

Provides access to the renderer.

This function returns the renderer.

Returns:
One of the following values:
  • a pointer to the renderer
  • 0 if an error happend
CalSkeleton * CalModel::getSkeleton ( ) const

Provides access to the skeleton.

This function returns the skeleton.

Returns:
One of the following values:
  • a pointer to the skeleton
  • 0 if an error happend
CalSpringSystem * CalModel::getSpringSystem ( ) const

Provides access to the spring system.

This function returns the spring system.

Returns:
One of the following values:
  • a pointer to the spring system
  • 0 if an error happend
Cal::UserData CalModel::getUserData ( ) const

Provides access to the user data.

This function returns the user data stored in the model instance.

Returns:
The user data stored in the model instance.
std::vector< CalMesh * > & CalModel::getVectorMesh ( )

Returns the mesh vector.

This function returns the vector that contains all attached meshes of the model instance.

Returns:
A reference to the mesh vector.
void CalModel::setAbstractMixer ( CalAbstractMixer pMixer)

Sets the mixer to a CalAbstractMixer subclass instance.

If a mixer was already set (with CalModel::setAbstractMixer or because the CalModel::create method created a CalMixer instance), its destroy method is called. The existing mixer is not deallocated, it is the responsibility of the caller to call the getAbstractMixer method and deallocate the returned instance if appropriate.

pMixer will be deallocated by cal3d if and only if the CalModel::destroy function is called.

The create method of pMixer is called.

pMixer may be null. After setting a null pointer, the caller MUST call CalModel::create or CalModel::setAbstractMixer with a non-null pointer before any other method is called.

Parameters:
pMixeris a pointer to a CalAbstractMixer subclass instance.
void CalModel::setLodLevel ( float  lodLevel)

Sets the LOD level.

This function sets the LOD level of all attached meshes.

Parameters:
lodLevelThe LOD level in the range [0.0, 1.0].
void CalModel::setMaterialSet ( int  setId)

Sets the material set.

This function sets the material set of all attached meshes.

Parameters:
setIdThe ID of the material set.
void CalModel::setUserData ( Cal::UserData  userData)

Stores user data.

This function stores user data in the model instance.

Parameters:
userDataThe user data that should be stored.
void CalModel::update ( float  deltaTime)

Updates the model instance.

This function updates the model instance for a given amount of time.

Parameters:
deltaTimeThe elapsed time in seconds since the last update.

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

Generated at Sat Jul 2 2011 13:53:45 by The Cal3D Team with Doxygen 1.7.4