nirt::scene::IMeshLoader Class Reference

Class which is able to load an animated mesh from a file. More...

#include <nirtcpp/core/engine/IMeshLoader.hpp>

Inheritance diagram for nirt::scene::IMeshLoader:

Collaboration diagram for nirt::scene::IMeshLoader:

Public Types
enum	E_INDEX_TYPE_HINT { EITH_16BIT , EITH_32BIT , EITH_OPTIMAL }

Public Member Functions
	IMeshLoader ()
	Constructor.
virtual	~IMeshLoader ()
	Destructor.
virtual bool	isALoadableFileExtension (const io::path &filename) const =0
	Returns true if the file might be loaded by this class.
virtual IAnimatedMesh *	createMesh (io::IReadFile *file)=0
	Creates/loads an animated mesh from the file.
virtual void	setMeshTextureLoader (IMeshTextureLoader *textureLoader)
	Set a new texture loader which this meshloader can use when searching for textures.
virtual IMeshTextureLoader *	getMeshTextureLoader () const
	Get the texture loader used when this meshloader searches for textures.
void	setIndexTypeHint (E_INDEX_TYPE_HINT typeHint)
	Give loader a hint if you would prefer 16 or 32 bit meshbuffers.
E_INDEX_TYPE_HINT	getIndexTypeHint () const
	Return current preference user has for the index type of meshbuffers.
Public Member Functions inherited from nirt::IReferenceCounted
	IReferenceCounted ()
	Constructor.
virtual	~IReferenceCounted ()
	Destructor.
void	grab () const
	Grabs the object. Increments the reference counter by one.
bool	drop () const
	Drops the object. Decrements the reference counter by one.
s32	getReferenceCount () const
	Get the reference count.
const c8 *	getDebugName () const
	Returns the debug name of the object.

Protected Attributes
IMeshTextureLoader *	TextureLoader
E_INDEX_TYPE_HINT	IndexTypeHint

Additional Inherited Members
Protected Member Functions inherited from nirt::IReferenceCounted
void	setDebugName (const c8 *newName)
	Sets the debug name of the object.

Detailed Description

Class which is able to load an animated mesh from a file.

If you want Nirtcpp be able to load meshes of currently unsupported file formats (e.g. .cob), then implement this and add your new Meshloader with ISceneManager::addExternalMeshLoader() to the engine.

Member Enumeration Documentation

E_INDEX_TYPE_HINT

enum nirt::scene::IMeshLoader::E_INDEX_TYPE_HINT

Enumerator
EITH_16BIT	Prefer to use 16-bit index buffers even if it breaks the mesh The default (and only option) before Nirtcpp 1.9
EITH_32BIT	Allow using 32-bit index buffers.
EITH_OPTIMAL	Allow 32-bit, but copy back to 16-bit when 32 is not needed. So tiny overhead (sometimes extra allocation+copying) on loading, but meshes are later more optimal. Default since Nirtcpp 1.9

Member Function Documentation

createMesh()

virtual IAnimatedMesh * nirt::scene::IMeshLoader::createMesh ( io::IReadFile *  file )

pure virtual

Creates/loads an animated mesh from the file.

Parameters

file	File handler to load the file from.

Returns

Pointer to the created mesh. Returns 0 if loading failed. If you no longer need the mesh, you should call IAnimatedMesh::drop(). See IReferenceCounted::drop() for more information.

getIndexTypeHint()

E_INDEX_TYPE_HINT nirt::scene::IMeshLoader::getIndexTypeHint ( ) const

inline

Return current preference user has for the index type of meshbuffers.

Note that this is not necessarily the type used by the meshloader

getMeshTextureLoader()

virtual IMeshTextureLoader * nirt::scene::IMeshLoader::getMeshTextureLoader ( ) const

inlinevirtual

Get the texture loader used when this meshloader searches for textures.

NOTE: not all meshloaders support this interface so this can return NULL.

isALoadableFileExtension()

virtual bool nirt::scene::IMeshLoader::isALoadableFileExtension ( const io::path &  filename ) const

pure virtual

Returns true if the file might be loaded by this class.

This decision should be based on the file extension (e.g. ".cob") only.

Parameters

filename

Name of the file to test.

Returns

True if the file might be loaded by this class.

setIndexTypeHint()

void nirt::scene::IMeshLoader::setIndexTypeHint ( E_INDEX_TYPE_HINT  typeHint )

inline

Give loader a hint if you would prefer 16 or 32 bit meshbuffers.

Before Nirtcpp 1.9 Nirtcpp worked mostly with 16-bit meshbuffers. Rendering 32-bit meshbuffers works, but some functions like mesh-writing and mesh manipulation might not work yet. NOTE: Most loaders will ignore this hint so far, but hopefully will care about it in the future.

setMeshTextureLoader()

virtual void nirt::scene::IMeshLoader::setMeshTextureLoader ( IMeshTextureLoader *  textureLoader )

inlinevirtual

Set a new texture loader which this meshloader can use when searching for textures.

NOTE: Not all meshloaders do support this interface. Meshloaders which support it will return a non-null value in getMeshTextureLoader from the start. Setting a texture-loader to a meshloader which doesn't support it won't help.

Parameters

textureLoader

The textureloader to use. When set to NULL the mesh will not load any textures.

---

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

• include/nirtcpp/core/engine/IMeshLoader.hpp