The mesh cache stores already loaded meshes and provides an interface to them. More...
#include <IMeshCache.h>
The mesh cache stores already loaded meshes and provides an interface to them.
You can access it using ISceneManager::getMeshCache(). All existing scene managers will return a pointer to the same mesh cache, because it is shared between them. With this interface, it is possible to manually add new loaded meshes (if ISceneManager::getMesh() is not sufficient), to remove them and to iterate through already loaded meshes.
Definition at line 27 of file IMeshCache.h.
virtual irr::scene::IMeshCache::~IMeshCache | ( | ) | [inline, virtual] |
Destructor.
Definition at line 32 of file IMeshCache.h.
virtual void irr::scene::IMeshCache::addMesh | ( | const io::path & | name, |
IAnimatedMesh * | mesh | ||
) | [pure virtual] |
Adds a mesh to the internal list of loaded meshes.
Usually, ISceneManager::getMesh() is called to load a mesh from a file. That method searches the list of loaded meshes if a mesh has already been loaded and returns a pointer to if it is in that list and already in memory. Otherwise it loads the mesh. With IMeshCache::addMesh(), it is possible to pretend that a mesh already has been loaded. This method can be used for example by mesh loaders who need to load more than one mesh with one call. They can add additional meshes with this method to the scene manager. The COLLADA loader for example uses this method.
name | Name of the mesh. When calling ISceneManager::getMesh() with this name it will return the mesh set by this method. |
mesh | Pointer to a mesh which will now be referenced by this name. |
virtual void irr::scene::IMeshCache::clear | ( | ) | [pure virtual] |
Clears the whole mesh cache, removing all meshes.
All meshes will be reloaded completely when using ISceneManager::getMesh() after calling this method. Warning: If you have pointers to meshes that were loaded with ISceneManager::getMesh() and you did not grab them, then they may become invalid.
virtual void irr::scene::IMeshCache::clearUnusedMeshes | ( | ) | [pure virtual] |
Clears all meshes that are held in the mesh cache but not used anywhere else.
Warning: If you have pointers to meshes that were loaded with ISceneManager::getMesh() and you did not grab them, then they may become invalid.
_IRR_DEPRECATED_ IAnimatedMesh* irr::scene::IMeshCache::getMeshByFilename | ( | const io::path & | filename | ) | [inline] |
Returns a mesh based on its name (often a filename).
Definition at line 84 of file IMeshCache.h.
References getMeshByName().
virtual IAnimatedMesh* irr::scene::IMeshCache::getMeshByIndex | ( | u32 | index | ) | [pure virtual] |
Returns a mesh based on its index number.
index,: | Index of the mesh, number between 0 and getMeshCount()-1. Note that this number is only valid until a new mesh is loaded or removed. |
virtual IAnimatedMesh* irr::scene::IMeshCache::getMeshByName | ( | const io::path & | name | ) | [pure virtual] |
Returns a mesh based on its name.
name | Name of the mesh. Usually a filename. |
Referenced by getMeshByFilename().
virtual u32 irr::scene::IMeshCache::getMeshCount | ( | ) | const [pure virtual] |
Returns amount of loaded meshes in the cache.
You can load new meshes into the cache using getMesh() and addMesh(). If you ever need to access the internal mesh cache, you can do this using removeMesh(), getMeshNumber(), getMeshByIndex() and getMeshName().
_IRR_DEPRECATED_ const io::path& irr::scene::IMeshCache::getMeshFilename | ( | u32 | index | ) | const [inline] |
Get the name of a loaded mesh, based on its index. (Name is often identical to the filename).
Definition at line 92 of file IMeshCache.h.
References irr::io::SNamedPath::getInternalName(), and getMeshName().
_IRR_DEPRECATED_ const io::path& irr::scene::IMeshCache::getMeshFilename | ( | const IMesh *const | mesh | ) | const [inline] |
Get the name of a loaded mesh, if there is any. (Name is often identical to the filename).
Definition at line 100 of file IMeshCache.h.
References irr::io::SNamedPath::getInternalName(), and getMeshName().
Returns current index number of the mesh or -1 when not found.
mesh | Pointer to the mesh to search for. |
virtual const io::SNamedPath& irr::scene::IMeshCache::getMeshName | ( | u32 | index | ) | const [pure virtual] |
Get the name of a loaded mesh, based on its index.
index,: | Index of the mesh, number between 0 and getMeshCount()-1. |
Referenced by getMeshFilename().
virtual const io::SNamedPath& irr::scene::IMeshCache::getMeshName | ( | const IMesh *const | mesh | ) | const [pure virtual] |
Get the name of the loaded mesh if there is any.
mesh | Pointer to mesh to query. |
virtual bool irr::scene::IMeshCache::isMeshLoaded | ( | const io::path & | name | ) | [pure virtual] |
Check if a mesh was already loaded.
name | Name of the mesh. Usually a filename. |
virtual void irr::scene::IMeshCache::removeMesh | ( | const IMesh *const | mesh | ) | [pure virtual] |
Removes the mesh from the cache.
After loading a mesh with getMesh(), the mesh can be removed from the cache using this method, freeing a lot of memory.
mesh | Pointer to the mesh which shall be removed. |
Renames a loaded mesh.
Note that renaming meshes might change the ordering of the meshes, and so the index of the meshes as returned by getMeshIndex() or taken by some methods will change.
index | The index of the mesh in the cache. |
name | New name for the mesh. |
Referenced by setMeshFilename().
virtual bool irr::scene::IMeshCache::renameMesh | ( | const IMesh *const | mesh, |
const io::path & | name | ||
) | [pure virtual] |
Renames the loaded mesh.
Note that renaming meshes might change the ordering of the meshes, and so the index of the meshes as returned by getMeshIndex() or taken by some methods will change.
mesh | Mesh to be renamed. |
name | New name for the mesh. |
_IRR_DEPRECATED_ bool irr::scene::IMeshCache::setMeshFilename | ( | u32 | index, |
const io::path & | filename | ||
) | [inline] |
Renames a loaded mesh.
Definition at line 108 of file IMeshCache.h.
References renameMesh().
_IRR_DEPRECATED_ bool irr::scene::IMeshCache::setMeshFilename | ( | const IMesh *const | mesh, |
const io::path & | filename | ||
) | [inline] |
Renames a loaded mesh.
Definition at line 116 of file IMeshCache.h.
References renameMesh().