126 lines
4.7 KiB
C++
126 lines
4.7 KiB
C++
// Copyright (C) 2002-2009 Nikolaus Gebhardt
|
|
// This file is part of the "Irrlicht Engine".
|
|
// For conditions of distribution and use, see copyright notice in irrlicht.h
|
|
|
|
#ifndef __C_MESH_CACHE_H_INCLUDED__
|
|
#define __C_MESH_CACHE_H_INCLUDED__
|
|
|
|
#include "IMeshCache.h"
|
|
#include "irrArray.h"
|
|
|
|
namespace irr
|
|
{
|
|
|
|
namespace scene
|
|
{
|
|
class CMeshCache : public IMeshCache
|
|
{
|
|
public:
|
|
|
|
virtual ~CMeshCache();
|
|
|
|
//! Adds a mesh to the internal list of loaded meshes.
|
|
/** Usually, ISceneManager::getMesh() is called to load a mesh from 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.
|
|
\param filename: Filename of the mesh. When called ISceneManager::getMesh() with this
|
|
parameter, the method will return the mesh parameter given with this method.
|
|
\param mesh: Pointer to a mesh which will now be referenced by this name. */
|
|
virtual void addMesh(const io::path& filename, IAnimatedMesh* mesh);
|
|
|
|
//! Removes a 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. */
|
|
virtual void removeMesh(const IAnimatedMesh* const mesh);
|
|
|
|
//! Removes a 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. */
|
|
virtual void removeMesh(const IMesh* const mesh);
|
|
|
|
//! 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 getMeshFilename() */
|
|
virtual u32 getMeshCount() const;
|
|
|
|
//! Returns current index number of the mesh, and -1 if it is not in the cache.
|
|
virtual s32 getMeshIndex(const IAnimatedMesh* const mesh) const;
|
|
|
|
//! Returns current index number of the mesh, and -1 if it is not in the cache.
|
|
virtual s32 getMeshIndex(const IMesh* const mesh) const;
|
|
|
|
//! Returns a mesh based on its index number.
|
|
/** \param 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 *
|
|
\return Returns pointer to the mesh or 0 if there is none with this number. */
|
|
virtual IAnimatedMesh* getMeshByIndex(u32 index);
|
|
|
|
//! Returns a mesh based on its file name.
|
|
/** \return Returns pointer to the mesh or 0 if there is none with this number. */
|
|
virtual IAnimatedMesh* getMeshByFilename(const io::path& filename);
|
|
|
|
//! Returns name of a mesh based on its index number.
|
|
/** \param index: Index of the mesh, number between 0 and getMeshCount()-1.
|
|
Note that this is only valid until a new mesh is loaded */
|
|
virtual const io::path& getMeshFilename(u32 index) const;
|
|
|
|
//! Returns the filename of a loaded mesh, if there is any.
|
|
/** Returns an empty path if there is none. */
|
|
virtual const io::path& getMeshFilename(const IAnimatedMesh* const mesh) const;
|
|
|
|
//! Returns the filename of a loaded mesh, if there is any.
|
|
/** Returns an empty path if there is none.*/
|
|
virtual const io::path& getMeshFilename(const IMesh* const mesh) const;
|
|
|
|
//! Renames a loaded mesh, if possible.
|
|
virtual bool setMeshFilename(u32 index, const io::path& filename);
|
|
|
|
//! Renames a loaded mesh, if possible.
|
|
virtual bool setMeshFilename(const IAnimatedMesh* const mesh, const io::path& filename);
|
|
|
|
//! Renames a loaded mesh, if possible.
|
|
virtual bool setMeshFilename(const IMesh* const mesh, const io::path& filename);
|
|
|
|
//! returns if a mesh already was loaded
|
|
virtual bool isMeshLoaded(const io::path& filename);
|
|
|
|
//! Clears the whole mesh cache, removing all meshes.
|
|
virtual void clear();
|
|
|
|
//! Clears all meshes that are held in the mesh cache but not used anywhere else.
|
|
virtual void clearUnusedMeshes();
|
|
|
|
protected:
|
|
|
|
struct MeshEntry
|
|
{
|
|
MeshEntry ( const io::path name )
|
|
: Name ( name )
|
|
{
|
|
Name.make_lower ();
|
|
}
|
|
io::path Name;
|
|
IAnimatedMesh* Mesh;
|
|
|
|
bool operator < (const MeshEntry& other) const
|
|
{
|
|
return (Name < other.Name);
|
|
}
|
|
};
|
|
|
|
//! loaded meshes
|
|
core::array<MeshEntry> Meshes;
|
|
};
|
|
|
|
|
|
} // end namespace scene
|
|
} // end namespace irr
|
|
|
|
#endif
|
|
|