CrystalSpace

Public API Reference

iMeshObjectFactory Struct Reference
[Mesh plugins]

This object is a factory which can generate mesh objects of a certain type. More...

#include <imesh/object.h>

Inheritance diagram for iMeshObjectFactory:

List of all members.

Public Member Functions

virtual csPtr< iMeshObjectFactoryClone ()=0
 Creates a copy of this factory and returns the clone.
virtual csFlagsGetFlags ()=0
 Get flags for this factory.
virtual iMaterialWrapperGetMaterialWrapper () const =0
 Get the material of the factory.
virtual iMeshFactoryWrapperGetMeshFactoryWrapper () const =0
 Get the logical parent for this mesh factory.
virtual iMeshObjectTypeGetMeshObjectType () const =0
 Get the ObjectType for this mesh factory.
virtual uint GetMixMode () const =0
 Get mix mode.
virtual iObjectModelGetObjectModel ()=0
 Get the generic interface describing the geometry of this mesh factory.
virtual void HardTransform (const csReversibleTransform &t)=0
 Do a hard transform of this factory.
virtual csPtr< iMeshObjectNewInstance ()=0
 Create an instance of iMeshObject.
virtual bool SetMaterialWrapper (iMaterialWrapper *material)=0
 Set the material of the mesh.
virtual void SetMeshFactoryWrapper (iMeshFactoryWrapper *logparent)=0
 Set a reference to the mesh factory wrapper parent.
virtual void SetMixMode (uint mode)=0
 Set mix mode. Note that not all meshes may support this.
virtual bool SupportsHardTransform () const =0
 Return true if HardTransform is supported for this factory.

Detailed Description

This object is a factory which can generate mesh objects of a certain type.

For example, if you want to have multiple sets of sprites from the same sprite template then you should have an instance of iMeshObjectFactory for every sprite template and an instance of iMeshObject for every sprite.

To use a mesh factory in the engine, you have to create a mesh factory wrapper for it.

Main creators of instances implementing this interface:

Main ways to get pointers to this interface:

Main users of this interface:

Definition at line 314 of file object.h.


Member Function Documentation

virtual csPtr<iMeshObjectFactory> iMeshObjectFactory::Clone (  )  [pure virtual]

Creates a copy of this factory and returns the clone.

virtual csFlags& iMeshObjectFactory::GetFlags (  )  [pure virtual]

Get flags for this factory.

The following flags are at least supported:

Mesh factories may implement additional flags. These mesh factory specific flags must be equal to at least 0x00010000.

virtual iMaterialWrapper* iMeshObjectFactory::GetMaterialWrapper (  )  const [pure virtual]

Get the material of the factory.

If not supported this will return 0.

virtual iMeshFactoryWrapper* iMeshObjectFactory::GetMeshFactoryWrapper (  )  const [pure virtual]

Get the logical parent for this mesh factory.

See SetMeshFactoryWrapper() for more information.

virtual iMeshObjectType* iMeshObjectFactory::GetMeshObjectType (  )  const [pure virtual]

Get the ObjectType for this mesh factory.

virtual uint iMeshObjectFactory::GetMixMode (  )  const [pure virtual]

Get mix mode.

virtual iObjectModel* iMeshObjectFactory::GetObjectModel (  )  [pure virtual]

Get the generic interface describing the geometry of this mesh factory.

It is possible that this will return 0 if the factory itself doesn't support the geometry. In that case you need to get the object model from the individual instance instead. Note that for collision detection and other parts of CS it is prefered to use the factory object model when available as that reduces the amount of redundant memory usage.

virtual void iMeshObjectFactory::HardTransform ( const csReversibleTransform t  )  [pure virtual]

Do a hard transform of this factory.

This transformation and the original coordinates are not remembered but the object space coordinates are directly computed (world space coordinates are set to the object space coordinates by this routine). Note that some implementations of mesh objects will not change the orientation of the object but only the position.

virtual csPtr<iMeshObject> iMeshObjectFactory::NewInstance (  )  [pure virtual]

Create an instance of iMeshObject.

virtual bool iMeshObjectFactory::SetMaterialWrapper ( iMaterialWrapper material  )  [pure virtual]

Set the material of the mesh.

This only works for single-material factories. If not supported this function will return false.

virtual void iMeshObjectFactory::SetMeshFactoryWrapper ( iMeshFactoryWrapper logparent  )  [pure virtual]

Set a reference to the mesh factory wrapper parent.

Note that this function should NOT increase the ref-count of the given logical parent because this would cause a circular reference (since the logical parent already holds a reference to this mesh factory).

virtual void iMeshObjectFactory::SetMixMode ( uint  mode  )  [pure virtual]

Set mix mode. Note that not all meshes may support this.

virtual bool iMeshObjectFactory::SupportsHardTransform (  )  const [pure virtual]

Return true if HardTransform is supported for this factory.


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

Generated for Crystal Space 1.4.1 by doxygen 1.7.1