NL3D::CMeshMRM Class Reference

#include <mesh_mrm.h>

Inheritance diagram for NL3D::CMeshMRM:

NL3D::CMeshBase NL3D::IShape NLMISC::CRefCount NLMISC::IStreamable NLMISC::IClassable

Detailed Description

An instanciable MRM mesh.

To build a CMeshMRM, you should:

NB: internally, build() use CMRMBuilder, a builder of MRM.

Author:
Lionel Berenguier

Nevrax France

Date:
2001

Definition at line 684 of file mesh_mrm.h.

Public Member Functions

void build (CMeshBase::CMeshBaseBuild &m, const CMeshMRMGeom &mgeom)
void build (CMeshBase::CMeshBaseBuild &mBase, CMesh::CMeshBuild &m, std::vector< CMesh::CMeshBuild * > &listBS, const CMRMParameters &params=CMRMParameters())
void changeMRMDistanceSetup (float distanceFinest, float distanceMiddle, float distanceCoarsest)
 CMeshMRM ()
 Constructor.

void computeBonesId (CSkeletonModel *skeleton)
 Compute skinning id.

void flushTextures (IDriver &driver, uint selectedTexture)
 Flush textures.

virtual std::string getClassName ()=0
float getDistMax () const
const sintgetRefCount () const
bool isLightable () const
 Is this mesh lightable? true if one of his materials is not a lightmap. NB: result stored in file.

void optimizeMaterialUsage (std::vector< sint > &remap)
void serialMeshBase (NLMISC::IStream &f) throw (NLMISC::EStream)
 serial the base Part of this mesh.

void setDistMax (float distMax)
void updateSkeletonUsage (CSkeletonModel *sm, bool increment)
 update Skeleton Usage. increment or decrement.

virtual bool useLightingLocalAttenuation () const
 tells if the shape wants LocalAttenuation for RealTime lighting. Default is false

From IShape
virtual bool clip (const std::vector< CPlane > &pyramid, const CMatrix &worldMatrix)
 clip this mesh in a driver.

virtual CTransformShapecreateInstance (CScene &scene)
 Create a CMeshInstance, which contains materials.

virtual void getAABBox (NLMISC::CAABBox &bbox) const
 Get bbox.

virtual float getNumTriangles (float distance)
 get an approximation of the number of triangles this instance will render for a fixed distance.

 NLMISC_DECLARE_CLASS (CMeshMRM)
 clip this mesh in a driver.

virtual void profileSceneRender (CRenderTrav *rdrTrav, CTransformShape *trans, bool opaquePass)
 profiling

virtual void render (IDriver *drv, CTransformShape *trans, bool passOpaque)
 render() this mesh in a driver.

virtual void serial (NLMISC::IStream &f) throw (NLMISC::EStream)
 serial this mesh.

Geometry accessors
const NLMISC::CAABBoxExtgetBoundingBox () const
 get the extended axis aligned bounding box of the mesh

const CMeshMRMGeomgetMeshGeom () const
 Get the mesh geom.

uint getNbLod () const
uint getNbRdrPass (uint lodId) const
uint32 getRdrPassMaterial (uint lodId, uint renderingPassIndex) const
const CPrimitiveBlockgetRdrPassPrimitiveBlock (uint lodId, uint renderingPassIndex) const
const CVertexBuffergetVertexBuffer () const
 get the vertex buffer used by the mrm mesh. NB: this VB store all Vertices used by All LODs.

Mesh Block Render Interface
virtual IMeshGeomsupportMeshBlockRendering (CTransformShape *trans, float &polygonCount) const

Data Fields

TLightMapInfo _LightInfos
sint crefs
CPtrInfo * pinfo

Static Public Attributes

CPtrInfo NullPtrInfo

Protected Types

typedef std::map< uint32,
CMaterialBase
TAnimatedMaterialMap
 Animated Material mgt.


Protected Member Functions

void applyMaterialUsageOptim (const std::vector< bool > &materialUsed, std::vector< sint > &remap)
void buildMeshBase (CMeshBaseBuild &m)
 Just copy informations from a CMeshBaseBuild.

void instanciateMeshBase (CMeshBaseInstance *mi, CScene *ownerScene)
 instanciate MeshBase part to an instance (a CMeshBaseInstance).


Protected Attributes

TAnimatedMaterialMap _AnimatedMaterials
std::vector< CMorphBase_AnimatedMorph
bool _AutoAnim
CTrackDefaultRGBA _DefaultLMFactor
CTrackDefaultVector _DefaultPivot
CTrackDefaultVector _DefaultPos
 Transform default tracks. Those default tracks are instancied, ie, CInstanceMesh will have the same and can't specialize it.

CTrackDefaultVector _DefaultRotEuler
CTrackDefaultQuat _DefaultRotQuat
CTrackDefaultVector _DefaultScale
float _DistMax
 Default to -1.

bool _IsLightable
 Is this mesh lightable??

std::vector< CMaterial_Materials
 The Materials.

bool _UseLightingLocalAttenuation
 Is this mesh Use Lighting Local Attenuation ??


Private Attributes

CMeshMRMGeom _MeshMRMGeom

Friends

struct CPtrInfo


Member Typedef Documentation

typedef std::map<uint32, CMaterialBase> NL3D::CMeshBase::TAnimatedMaterialMap [protected, inherited]
 

Animated Material mgt.

Definition at line 239 of file mesh_base.h.

typedef std::map< std::string, CLightInfoMapListV7 > NL3D::CMeshBase::TLightInfoMapV7 [inherited]
 

Definition at line 76 of file mesh_base.h.

Referenced by NL3D::CMeshBase::serialMeshBase().

typedef std::vector< CLightMapInfoList > NL3D::CMeshBase::TLightMapInfo [inherited]
 

Definition at line 111 of file mesh_base.h.


Constructor & Destructor Documentation

NL3D::CMeshMRM::CMeshMRM  ) 
 

Constructor.

Definition at line 2874 of file mesh_mrm.cpp.

02875 {
02876 }


Member Function Documentation

void NL3D::CMeshBase::applyMaterialUsageOptim const std::vector< bool > &  materialUsed,
std::vector< sint > &  remap
[protected, inherited]
 

delete any material not used, and build remap table (old to new). _AnimatedMaterials are reseted resetLodCharacterTexture(); is called

Definition at line 333 of file mesh_base.cpp.

References NL3D::CMeshBase::_AnimatedMaterials, NL3D::CMeshBase::_LightInfos, count, nlassert, NL3D::CMeshBase::resetLodCharacterTexture(), sint, NL3D::CMeshBase::CLightMapInfoList::StageList, and uint.

00334 {
00335         nlassert(_Materials.size()==materialUsed.size());
00336 
00337         // security reset
00338         resetLodCharacterTexture();
00339         _AnimatedMaterials.clear();
00340 
00341         // init all ids to "Not Used"
00342         remap.clear();
00343         remap.resize(_Materials.size(), -1);
00344 
00345         // remove unused materials and build remap
00346         vector<CMaterial>::iterator             itMat= _Materials.begin();
00347         uint                                                    dstIdx= 0;
00348         uint i;
00349         for(i=0;i<materialUsed.size();i++)
00350         {
00351                 // if used, still use it, and remap.
00352                 if(materialUsed[i])
00353                 {
00354                         remap[i]= dstIdx;
00355                         itMat++;
00356                         dstIdx++;
00357                 }
00358                 // remove from the array
00359                 else
00360                 {
00361                         itMat= _Materials.erase(itMat);
00362                 }
00363         }
00364 
00365         // apply the remap to LightMaps infos
00366         const uint count = _LightInfos.size ();
00367         for (i=0; i<count; i++)
00368         {
00369                 CLightMapInfoList &mapInfoList = _LightInfos[i];
00370                 std::list<CMeshBase::CLightMapInfoList::CMatStage>::iterator ite = mapInfoList.StageList.begin ();
00371                 while (ite != mapInfoList.StageList.end ())
00372                 {
00373                         sint    newId= remap[ite->MatId];
00374                         // If material used
00375                         if(newId>=0)
00376                         {
00377                                 // apply remap on the material id
00378                                 ite->MatId= newId;
00379                                 ite++;
00380                         }
00381                         else
00382                         {
00383                                 // remove it from list of light infos
00384                                 ite= mapInfoList.StageList.erase(ite);
00385                         }
00386                 }
00387         }
00388 }

void NL3D::CMeshMRM::build CMeshBase::CMeshBaseBuild m,
const CMeshMRMGeom mgeom
 

Build a mesh, replacing old. build from a CMeshBaseBuild (materials info) and a previously builded CMeshMRMGeom. WARNING: This has a side effect of deleting AnimatedMaterials. this is much slower than CMesh::build(), because it computes the MRM.

Parameters:
params parameters of the MRM build process.

Definition at line 2889 of file mesh_mrm.cpp.

References _MeshMRMGeom.

02890 {
02892         CMeshBase::buildMeshBase(m);
02893 
02894         // Then copy the geom.
02895         _MeshMRMGeom= mgeom;
02896 }

void NL3D::CMeshMRM::build CMeshBase::CMeshBaseBuild mBase,
CMesh::CMeshBuild m,
std::vector< CMesh::CMeshBuild * > &  listBS,
const CMRMParameters params = CMRMParameters()
 

Build a mesh, replacing old. WARNING: This has a side effect of deleting AnimatedMaterials. this is much slower than CMesh::build(), because it computes the MRM.

Parameters:
params parameters of the MRM build process.

Definition at line 2878 of file mesh_mrm.cpp.

References _MeshMRMGeom, NL3D::CMeshMRMGeom::build(), NL3D::CMeshBase::CMeshBaseBuild::Materials, and params.

02881 {
02883         CMeshBase::buildMeshBase (mBase);
02884 
02885         // Then build the geom.
02886         _MeshMRMGeom.build (m, listBS, mBase.Materials.size(), params);
02887 }

void NL3D::CMeshBase::buildMeshBase CMeshBaseBuild m  )  [protected, inherited]
 

Just copy informations from a CMeshBaseBuild.

Copy default position values

Definition at line 226 of file mesh_base.cpp.

References NL3D::CMeshBase::_AnimatedMaterials, NL3D::CMeshBase::_AnimatedMorph, NL3D::CMeshBase::_DefaultPivot, NL3D::CMeshBase::_DefaultRotEuler, NL3D::CMeshBase::_DefaultRotQuat, NL3D::CMeshBase::_DefaultScale, NL3D::CMeshBase::_LightInfos, NL3D::CMeshBase::_UseLightingLocalAttenuation, NL3D::CMeshBase::CMeshBaseBuild::BSNames, NL3D::CMeshBase::computeIsLightable(), NL3D::CMeshBase::CMeshBaseBuild::DefaultBSFactors, NL3D::CMeshBase::CMeshBaseBuild::DefaultPivot, NL3D::CMeshBase::CMeshBaseBuild::DefaultPos, NL3D::CMeshBase::CMeshBaseBuild::DefaultRotEuler, NL3D::CMeshBase::CMeshBaseBuild::DefaultRotQuat, NL3D::CMeshBase::CMeshBaseBuild::DefaultScale, NL3D::CMeshBase::CMeshBaseBuild::LightInfoMap, NL3D::CMeshBase::CMeshBaseBuild::Materials, NL3D::CTrackDefaultBlendable< CQuat >::setValue(), NL3D::CTrackDefaultBlendable< CVector >::setValue(), uint32, and NL3D::CMeshBase::CMeshBaseBuild::UseLightingLocalAttenuation.

00227 {
00228         // Copy light information
00229         _LightInfos = m.LightInfoMap;
00230 
00231         // copy the materials.
00232         _Materials= m.Materials;
00233 
00234         // clear the animated materials.
00235         _AnimatedMaterials.clear();
00236 
00238         _DefaultPos.setValue (m.DefaultPos);
00239         _DefaultPivot.setValue (m.DefaultPivot);
00240         _DefaultRotEuler.setValue (m.DefaultRotEuler);
00241         _DefaultRotQuat.setValue (m.DefaultRotQuat);
00242         _DefaultScale.setValue (m.DefaultScale);
00243 
00244         _AnimatedMorph  .resize(m.DefaultBSFactors.size());
00245         for (uint32 i = 0; i < m.DefaultBSFactors.size(); ++i)
00246         {
00247                 _AnimatedMorph[i].DefaultFactor.setValue (m.DefaultBSFactors[i]);
00248                 _AnimatedMorph[i].Name = m.BSNames[i];
00249         }
00250 
00251         // update _IsLightable flag.
00252         computeIsLightable();
00253         // copy _UseLightingLocalAttenuation
00254         _UseLightingLocalAttenuation= m.UseLightingLocalAttenuation;
00255 }

void NL3D::CMeshMRM::changeMRMDistanceSetup float  distanceFinest,
float  distanceMiddle,
float  distanceCoarsest
 

Change MRM Distance setup. NB: no-op if distanceFinest<0, distanceMiddle<=distanceFinest or if distanceCoarsest<=distanceMiddle.

Parameters:
distanceFinest The MRM has its max faces when dist<=distanceFinest.
distanceMiddle The MRM has 50% of its faces at dist==distanceMiddle.
distanceCoarsest The MRM has faces/Divisor (ie near 0) when dist>=distanceCoarsest.

Definition at line 3011 of file mesh_mrm.cpp.

References _MeshMRMGeom, and NL3D::CMeshMRMGeom::changeMRMDistanceSetup().

Referenced by NL3D::CMeshMRMInstance::changeMRMDistanceSetup().

03012 {
03013         _MeshMRMGeom.changeMRMDistanceSetup(distanceFinest, distanceMiddle, distanceCoarsest);
03014 }

bool NL3D::CMeshMRM::clip const std::vector< CPlane > &  pyramid,
const CMatrix worldMatrix
[virtual]
 

clip this mesh in a driver.

Reimplemented from NL3D::IShape.

Definition at line 2946 of file mesh_mrm.cpp.

References _MeshMRMGeom, and NL3D::CMeshMRMGeom::clip().

02947 {
02948         return _MeshMRMGeom.clip(pyramid, worldMatrix);
02949 }

void NL3D::CMeshMRM::computeBonesId CSkeletonModel skeleton  ) 
 

Compute skinning id.

Definition at line 2999 of file mesh_mrm.cpp.

References _MeshMRMGeom, and NL3D::CMeshMRMGeom::computeBonesId().

Referenced by NL3D::CMeshMRMInstance::getSkinBoneSphere(), NL3D::CMeshMRMInstance::getSkinBoneUsage(), and NL3D::CMeshMRMInstance::setApplySkin().

03000 {
03001         _MeshMRMGeom.computeBonesId (skeleton);
03002 }

CTransformShape * NL3D::CMeshMRM::createInstance CScene scene  )  [virtual]
 

Create a CMeshInstance, which contains materials.

Reimplemented from NL3D::IShape.

Definition at line 2924 of file mesh_mrm.cpp.

References _MeshMRMGeom, NL3D::CScene::createModel(), NL3D::CMeshMRMGeom::initInstance(), NL3D::CMeshMRMInstance::initRenderFilterType(), and NL3D::CTransformShape::Shape.

02925 {
02926         // Create a CMeshMRMInstance, an instance of a mesh.
02927         //===============================================
02928         CMeshMRMInstance                *mi= (CMeshMRMInstance*)scene.createModel(NL3D::MeshMRMInstanceId);
02929         mi->Shape= this;
02930 
02931         // instanciate the material part of the MeshMRM, ie the CMeshBase.
02932         CMeshBase::instanciateMeshBase(mi, &scene);
02933 
02934 
02935         // do some instance init for MeshGeom
02936         _MeshMRMGeom.initInstance(mi);
02937 
02938         // init the FilterType
02939         mi->initRenderFilterType();
02940 
02941         return mi;
02942 }

void NL3D::CMeshBase::flushTextures IDriver driver,
uint  selectedTexture
[virtual, inherited]
 

Flush textures.

Flush material textures

Implements NL3D::IShape.

Definition at line 392 of file mesh_base.cpp.

References uint.

00393 {
00394         // Mat count
00395         uint matCount=_Materials.size();
00396 
00397         // Flush each material textures
00398         for (uint mat=0; mat<matCount; mat++)
00399         {
00401                 _Materials[mat].flushTextures (driver, selectedTexture);
00402         }
00403 }

virtual void NL3D::CMeshMRM::getAABBox NLMISC::CAABBox bbox  )  const [inline, virtual]
 

Get bbox.

Reimplemented from NL3D::IShape.

Definition at line 746 of file mesh_mrm.h.

References NLMISC::CAABBoxExt::getAABBox(), and getBoundingBox().

00746 {bbox= getBoundingBox().getAABBox();}

CMaterialBase * NL3D::CMeshBase::getAnimatedMaterial uint  id  )  [inherited]
 

return NULL if this material is NOT animated. (or if material do not exist)

Definition at line 90 of file mesh_base.cpp.

References NL3D::CMeshBase::_AnimatedMaterials, and uint.

00091 {
00092         TAnimatedMaterialMap::iterator  it;
00093         it= _AnimatedMaterials.find(id);
00094         if(it!=_AnimatedMaterials.end())
00095                 return &it->second;
00096         else
00097                 return NULL;
00098 }

bool NL3D::CMeshBase::getAutoAnim  )  const [inline, inherited]
 

Definition at line 212 of file mesh_base.h.

References NL3D::CMeshBase::_AutoAnim.

Referenced by NL3D::CScene::createInstance(), and NL3D::CMeshBaseInstance::traverseHrc().

00212 { return _AutoAnim; }

const NLMISC::CAABBoxExt& NL3D::CMeshMRM::getBoundingBox  )  const [inline]
 

get the extended axis aligned bounding box of the mesh

Definition at line 758 of file mesh_mrm.h.

References _MeshMRMGeom, and NL3D::CMeshMRMGeom::getBoundingBox().

Referenced by getAABBox().

00759         {
00760                 return _MeshMRMGeom.getBoundingBox();
00761         }

virtual std::string NLMISC::IClassable::getClassName  )  [pure virtual, inherited]
 

Implemented in NLAIAGENT::CNumericIndex, NLAIC::IPointerGestion, NLAIC::CIdentType, and CAutomataDesc.

Referenced by NLMISC::CClassRegistry::checkObject(), and NL3D::GetTextureSize().

CTrackDefaultRGBA* NL3D::CMeshBase::getDefaultLMFactor  )  [inline, inherited]
 

Definition at line 166 of file mesh_base.h.

References NL3D::CMeshBase::_DefaultLMFactor.

00166 {return &_DefaultLMFactor;}

CTrackDefaultVector* NL3D::CMeshBase::getDefaultPivot  )  [inline, inherited]
 

Definition at line 162 of file mesh_base.h.

References NL3D::CMeshBase::_DefaultPivot.

Referenced by NL3D::CMeshBaseInstance::getDefaultTrack().

00162 {return &_DefaultPivot;}

CTrackDefaultVector* NL3D::CMeshBase::getDefaultPos  )  [inline, inherited]
 

Definition at line 161 of file mesh_base.h.

Referenced by NL3D::CMeshBaseInstance::getDefaultTrack().

00161 {return &_DefaultPos;}

CTrackDefaultVector* NL3D::CMeshBase::getDefaultRotEuler  )  [inline, inherited]
 

Definition at line 163 of file mesh_base.h.

References NL3D::CMeshBase::_DefaultRotEuler.

Referenced by NL3D::CMeshBaseInstance::getDefaultTrack().

00163 {return &_DefaultRotEuler;}

CTrackDefaultQuat* NL3D::CMeshBase::getDefaultRotQuat  )  [inline, inherited]
 

Definition at line 164 of file mesh_base.h.

References NL3D::CMeshBase::_DefaultRotQuat.

Referenced by NL3D::CMeshBaseInstance::getDefaultTrack().

00164 {return &_DefaultRotQuat;}

CTrackDefaultVector* NL3D::CMeshBase::getDefaultScale  )  [inline, inherited]
 

Definition at line 165 of file mesh_base.h.

References NL3D::CMeshBase::_DefaultScale.

Referenced by NL3D::CMeshBaseInstance::getDefaultTrack().

00165 {return &_DefaultScale;}

float NL3D::IShape::getDistMax  )  const [inline, inherited]
 

return the DistMax where the shape is no more displayed. Default is to return -1, meaning DistMax = infinite.

Definition at line 112 of file shape.h.

00112 {return _DistMax;}

const CLodCharacterTexture* NL3D::CMeshBase::getLodCharacterTexture  )  const [inline, inherited]
 

get the lod texture info. see CSkeletonModel Lod system. NULL per default. NB: serialised

Definition at line 223 of file mesh_base.h.

References NL3D::CMeshBase::_LodCharacterTexture.

Referenced by NL3D::CSkeletonModel::computeLodTexture().

00223 {return _LodCharacterTexture;}

const CMaterial& NL3D::CMeshBase::getMaterial uint  id  )  const [inline, inherited]
 

Get a material, const version.

Definition at line 184 of file mesh_base.h.

References uint.

00185         {
00186                 return _Materials[id];
00187         }

CMaterial& NL3D::CMeshBase::getMaterial uint  id  )  [inline, inherited]
 

Get a material.

Definition at line 179 of file mesh_base.h.

References uint.

Referenced by NL3D::CZoneLighter::addTriangles(), NL3D::CCoarseMeshBuild::buildBitmap(), NL3D::CPSConstraintMesh::CMeshDisplayShare::buildRdrPassSet(), NL3D::CheckForLightableFacesInMesh(), NL3D::CheckForOpaqueAndTransparentFacesInMesh(), NL3D::CShapeBank::processWaitingShapes(), NL3D::CCoarseMeshBuild::remapCoordinates(), NL3D::CAsyncFileManager3D::CMeshLoad::run(), and NL3D::CMeshBaseInstance::selectTextureSet().

00180         {
00181                 return _Materials[id];
00182         }

const CMeshMRMGeom & NL3D::CMeshMRM::getMeshGeom  )  const
 

Get the mesh geom.

Definition at line 2992 of file mesh_mrm.cpp.

References _MeshMRMGeom.

Referenced by NL3D::CZoneLighter::addTriangles(), NL3D::CInstanceLighter::addTriangles(), NL3D::CMeshMRMInstance::getMRMLevelDetail(), NL3D::CMeshMRMInstance::getSkinBoneSphere(), NL3D::CMeshMRMInstance::getSkinBoneUsage(), NL3D::CMeshMRMInstance::initRenderFilterType(), NL3D::CMeshMRMInstance::isSkinnable(), NL3D::CMeshMRMInstance::renderShadowSkinGeom(), NL3D::CMeshMRMInstance::renderShadowSkinPrimitives(), NL3D::CMeshMRMInstance::renderSkin(), NL3D::CMeshMRMInstance::renderSkinGroupGeom(), NL3D::CMeshMRMInstance::renderSkinGroupPrimitives(), NL3D::CMeshMRMInstance::renderSkinGroupSpecularRdrPass(), NL3D::CMeshMRMInstance::supportShadowSkinGrouping(), and NL3D::CMeshMRMInstance::supportSkinGrouping().

02993 {
02994         return _MeshMRMGeom;
02995 }

uint NL3D::CMeshMRM::getNbLod  )  const [inline]
 

get the number of LOD.

Definition at line 769 of file mesh_mrm.h.

References _MeshMRMGeom, NL3D::CMeshMRMGeom::getNbLod(), and uint.

Referenced by optimizeMaterialUsage().

00769 { return _MeshMRMGeom.getNbLod()  ; }

uint NL3D::CMeshBase::getNbMaterial  )  const [inline, inherited]
 

Get the number of materials in the mesh.

Definition at line 173 of file mesh_base.h.

References uint.

Referenced by NL3D::CShapeBank::processWaitingShapes(), NL3D::CAsyncFileManager3D::CMeshLoad::run(), and NL3D::CMeshBaseInstance::selectTextureSet().

00174         {
00175                 return _Materials.size();
00176         }

uint NL3D::CMeshMRM::getNbRdrPass uint  lodId  )  const [inline]
 

get the number of rendering pass of a LOD.

Parameters:
lodId the id of the LOD.

Definition at line 775 of file mesh_mrm.h.

References _MeshMRMGeom, NL3D::CMeshMRMGeom::getNbRdrPass(), and uint.

Referenced by optimizeMaterialUsage().

00775 { return _MeshMRMGeom.getNbRdrPass(lodId) ; }

float NL3D::CMeshMRM::getNumTriangles float  distance  )  [virtual]
 

get an approximation of the number of triangles this instance will render for a fixed distance.

Implements NL3D::IShape.

Definition at line 2985 of file mesh_mrm.cpp.

References _MeshMRMGeom, and NL3D::CMeshMRMGeom::getNumTriangles().

02986 {
02987         return _MeshMRMGeom.getNumTriangles (distance);
02988 }

uint32 NL3D::CMeshMRM::getRdrPassMaterial uint  lodId,
uint  renderingPassIndex
const [inline]
 

get the material ID associated with a rendering pass of a LOD.

Parameters:
lodId the id of the LOD.
renderingPassIndex the index of the rendering pass in the matrix block

Definition at line 792 of file mesh_mrm.h.

References _MeshMRMGeom, NL3D::CMeshMRMGeom::getRdrPassMaterial(), uint, and uint32.

Referenced by optimizeMaterialUsage().

00793         {
00794                 return _MeshMRMGeom.getRdrPassMaterial(lodId, renderingPassIndex) ;
00795         }

const CPrimitiveBlock& NL3D::CMeshMRM::getRdrPassPrimitiveBlock uint  lodId,
uint  renderingPassIndex
const [inline]
 

get the primitive block associated with a rendering pass of a LOD.

Parameters:
lodId the id of the LOD.
renderingPassIndex the index of the rendering pass

Definition at line 782 of file mesh_mrm.h.

References _MeshMRMGeom, NL3D::CMeshMRMGeom::getRdrPassPrimitiveBlock(), and uint.

00783         {
00784                 return _MeshMRMGeom.getRdrPassPrimitiveBlock(lodId, renderingPassIndex) ;
00785         }

const sint& NLMISC::CRefCount::getRefCount  )  const [inline, inherited]
 

Definition at line 70 of file smart_ptr.h.

References NLMISC::CRefCount::crefs, and sint.

00071         {
00072                 return  crefs;
00073         }

const CVertexBuffer& NL3D::CMeshMRM::getVertexBuffer  )  const [inline]
 

get the vertex buffer used by the mrm mesh. NB: this VB store all Vertices used by All LODs.

Definition at line 764 of file mesh_mrm.h.

References _MeshMRMGeom, and NL3D::CMeshMRMGeom::getVertexBuffer().

00764 { return _MeshMRMGeom.getVertexBuffer(); }

void NL3D::CMeshBase::instanciateMeshBase CMeshBaseInstance mi,
CScene ownerScene
[protected, inherited]
 

instanciate MeshBase part to an instance (a CMeshBaseInstance).

Definition at line 261 of file mesh_base.cpp.

References NL3D::CMeshBase::_AnimatedMaterials, NL3D::CMeshBaseInstance::_AnimatedMaterials, NL3D::CMeshBase::_AnimatedMorph, NL3D::CMeshBaseInstance::_AnimatedMorphFactor, NL3D::CMeshBase::_DefaultPivot, NL3D::CMeshBase::_DefaultRotQuat, NL3D::CMeshBase::_DefaultScale, NL3D::CMeshBaseInstance::AsyncTextures, NL3D::CAnimatedValueQuat, NL3D::CAnimatedValueVector, NL3D::CTrackDefaultBlendable< CQuat >::getValue(), NL3D::CTrackDefaultBlendable< CVector >::getValue(), NL3D::CMeshBaseInstance::Materials, nlassert, NL3D::CMeshBaseInstance::selectTextureSet(), NL3D::IAnimatable::setFather(), NL3D::CTransform::setIsBigLightable(), NL3D::CTransform::setIsLightable(), NL3D::CAnimatedMaterial::setMaterial(), NL3D::CTransform::setOpacity(), NL3D::CTransform::setTransparency(), and uint32.

00262 {
00263         uint32 i;
00264 
00265 
00266         // setup animated blendShapes
00267         //===========================
00268         mi->_AnimatedMorphFactor.reserve(_AnimatedMorph.size());
00269         for(i = 0; i < _AnimatedMorph.size(); ++i)
00270         {
00271                 CAnimatedMorph am(&_AnimatedMorph[i]);
00272                 mi->_AnimatedMorphFactor.push_back (am);
00273         }
00274         
00275         // setup materials.
00276         //=================
00277         // Copy material. Textures are referenced only
00278         mi->Materials= _Materials;
00279 
00280         // Instanciate selectable textures (use default set)
00281         mi->selectTextureSet(0);
00282 
00283         // prepare possible AsyncTextures
00284         mi->AsyncTextures.resize(_Materials.size());
00285 
00286         // setup animated materials.
00287         //==========================
00288         TAnimatedMaterialMap::iterator  it;
00289         mi->_AnimatedMaterials.reserve(_AnimatedMaterials.size());
00290         for(it= _AnimatedMaterials.begin(); it!= _AnimatedMaterials.end(); it++)
00291         {
00292                 CAnimatedMaterial       aniMat(&it->second);
00293 
00294                 // set the target instance material.
00295                 nlassert(it->first < mi->Materials.size());
00296                 aniMat.setMaterial(&mi->Materials[it->first]);
00297 
00298                 // Must set the Animatable father of the animated material (the mesh_base_instance!).
00299                 aniMat.setFather(mi, CMeshBaseInstance::OwnerBit);
00300 
00301                 // Append this animated material.
00302                 mi->_AnimatedMaterials.push_back(aniMat);
00303         }
00304 
00305         // Misc
00306         //==========================
00307         
00308         // Setup position with the default value
00309         mi->ITransformable::setPos( ((CAnimatedValueVector&)_DefaultPos.getValue()).Value  );
00310         mi->ITransformable::setRotQuat( ((CAnimatedValueQuat&)_DefaultRotQuat.getValue()).Value  );
00311         mi->ITransformable::setScale( ((CAnimatedValueVector&)_DefaultScale.getValue()).Value  );
00312         mi->ITransformable::setPivot( ((CAnimatedValueVector&)_DefaultPivot.getValue()).Value  );
00313 
00314         // Check materials for transparency
00315         mi->setTransparency( false );
00316         mi->setOpacity( false );
00317         for( i = 0; i < mi->Materials.size(); ++i )
00318         if( mi->Materials[i].getBlend() )
00319                 mi->setTransparency( true );
00320         else
00321                 mi->setOpacity( true );
00322 
00323         // if the mesh is lightable, then the instance is
00324         mi->setIsLightable(this->isLightable());
00325 
00326         // a mesh is considered big for lightable if it uses localAttenuation
00327         mi->setIsBigLightable(this->useLightingLocalAttenuation());
00328 
00329 }

bool NL3D::CMeshBase::isLightable  )  const [inline, inherited]
 

Is this mesh lightable? true if one of his materials is not a lightmap. NB: result stored in file.

Definition at line 198 of file mesh_base.h.

References NL3D::CMeshBase::_IsLightable.

Referenced by NL3D::CInstanceLighter::light().

00198 {return _IsLightable;}

NL3D::CMeshMRM::NLMISC_DECLARE_CLASS CMeshMRM   ) 
 

clip this mesh in a driver.

void NL3D::CMeshMRM::optimizeMaterialUsage std::vector< sint > &  remap  ) 
 

Optimize material use. If a material in CMeshBase is not used by any renderPasses, it is removed, and ids are updated. WARNING: This has a side effect of deleting AnimatedMaterials.

Parameters:
remap a remap material Id: newId= remap[oldId]. -1 means "no more used"

Definition at line 2900 of file mesh_mrm.cpp.

References _MeshMRMGeom, NL3D::CMeshMRMGeom::applyMaterialRemap(), getNbLod(), getNbRdrPass(), getRdrPassMaterial(), size, and uint.

02901 {
02902         // For each material, count usage.
02903         vector<bool>    materialUsed;
02904         materialUsed.resize(CMeshBase::_Materials.size(), false);
02905         for(uint lod=0;lod<getNbLod();lod++)
02906         {
02907                 for(uint rp=0;rp<getNbRdrPass(lod);rp++)
02908                 {
02909                         uint    matId= getRdrPassMaterial(lod, rp);
02910                         // flag as used.
02911                         materialUsed[matId]= true;
02912                 }
02913         }
02914 
02915         // Apply it to meshBase
02916         CMeshBase::applyMaterialUsageOptim(materialUsed, remap);
02917 
02918         // Apply lut to meshGeom.
02919         _MeshMRMGeom.applyMaterialRemap(remap);
02920 }

void NL3D::CMeshMRM::profileSceneRender CRenderTrav rdrTrav,
CTransformShape trans,
bool  opaquePass
[virtual]
 

profiling

Reimplemented from NL3D::IShape.

Definition at line 3030 of file mesh_mrm.cpp.

References _MeshMRMGeom, NL3D::CTransformShape::getNumTrianglesAfterLoadBalancing(), NL3D::CMeshMRMGeom::profileSceneRender(), and uint32.

03031 {
03032         // 0 or 0xFFFFFFFF
03033         uint32  mask= (0-(uint32)passOpaque);
03034         uint32  rdrFlags;
03035         // select rdrFlags, without ifs.
03036         rdrFlags=       mask & (IMeshGeom::RenderOpaqueMaterial | IMeshGeom::RenderPassOpaque);
03037         rdrFlags|=      ~mask & (IMeshGeom::RenderTransparentMaterial);
03038         // profile the mesh
03039         _MeshMRMGeom.profileSceneRender(rdrTrav, trans, trans->getNumTrianglesAfterLoadBalancing(), rdrFlags);
03040 }

void NL3D::CMeshMRM::render IDriver drv,
CTransformShape trans,
bool  passOpaque
[virtual]
 

render() this mesh in a driver.

Implements NL3D::IShape.

Definition at line 2953 of file mesh_mrm.cpp.

References _MeshMRMGeom, NL3D::CTransformShape::getNumTrianglesAfterLoadBalancing(), NL3D::CMeshMRMGeom::render(), and uint32.

02954 {
02955         // 0 or 0xFFFFFFFF
02956         uint32  mask= (0-(uint32)passOpaque);
02957         uint32  rdrFlags;
02958         // select rdrFlags, without ifs.
02959         rdrFlags=       mask & (IMeshGeom::RenderOpaqueMaterial | IMeshGeom::RenderPassOpaque);
02960         rdrFlags|=      ~mask & (IMeshGeom::RenderTransparentMaterial);
02961         // render the mesh
02962         _MeshMRMGeom.render(drv, trans, trans->getNumTrianglesAfterLoadBalancing(), rdrFlags, 1);
02963 }

void NL3D::CMeshBase::resetLodCharacterTexture  )  [inherited]
 

reset the lod texture info. see CSkeletonModel Lod system.

Definition at line 436 of file mesh_base.cpp.

References NL3D::CMeshBase::_LodCharacterTexture.

Referenced by NL3D::CMeshBase::applyMaterialUsageOptim(), NL3D::CMeshBase::setupLodCharacterTexture(), and NL3D::CMeshBase::~CMeshBase().

00437 {
00438         if(_LodCharacterTexture)
00439         {
00440                 delete _LodCharacterTexture;
00441                 _LodCharacterTexture= NULL;
00442         }
00443 }

void NL3D::CMeshMRM::serial NLMISC::IStream f  )  throw (NLMISC::EStream) [virtual]
 

serial this mesh.

Implements NLMISC::IStreamable.

Definition at line 2967 of file mesh_mrm.cpp.

02968 {
02969         /*
02970         Version 0:
02971                 - base version.
02972         */
02973         (void)f.serialVersion(0);
02974 
02975         // serial Materials infos contained in CMeshBase.
02976         CMeshBase::serialMeshBase(f);
02977 
02978 
02979         // serial the geometry.
02980         _MeshMRMGeom.serial(f);
02981 }

void NL3D::CMeshBase::serialMeshBase NLMISC::IStream f  )  throw (NLMISC::EStream) [inherited]
 

serial the base Part of this mesh.

Definition at line 149 of file mesh_base.cpp.

References NL3D::CMeshBase::_AnimatedMaterials, NL3D::CMeshBase::_AnimatedMorph, NL3D::CMeshBase::_AutoAnim, NL3D::CMeshBase::_DefaultPivot, NL3D::CMeshBase::_DefaultRotEuler, NL3D::CMeshBase::_DefaultRotQuat, NL3D::CMeshBase::_DefaultScale, NL3D::CMeshBase::_IsLightable, NL3D::CMeshBase::_LightInfos, NL3D::CMeshBase::_LodCharacterTexture, NL3D::CMeshBase::_UseLightingLocalAttenuation, NL3D::CMeshBase::computeIsLightable(), sint, and NL3D::CMeshBase::TLightInfoMapV7.

00150 {
00151         /*
00152         Version 8:
00153                 - new format for CLightMapInfoList
00154         Version 7:
00155                 - _LodCharacterTexture
00156         Version 6:
00157                 - _DistMax
00158         Version 5:
00159                 - _AutoAnim
00160         Version 4:
00161                 - _UseLightingLocalAttenuation
00162         Version 3:
00163                 - _IsLightable
00164         Version 2:
00165                 - Added Blend Shapes factors
00166         Version 1:
00167                 - Cut in version because of badly coded ITexture* serialisation. throw an exception if 
00168                         find a version < 1.
00169         Version 0:
00170                 - 1st version.
00171         */
00172         sint ver = f.serialVersion(8);
00173 
00174         if (ver >= 2)
00175         {
00176                 f.serialCont (_AnimatedMorph);
00177         }
00178 
00179         if(ver<1)
00180                 throw NLMISC::EStream(f, "Mesh in Stream is too old (MeshBase version < 1)");
00181 
00182         f.serial (_DefaultPos);
00183         f.serial (_DefaultPivot);
00184         f.serial (_DefaultRotEuler);
00185         f.serial (_DefaultRotQuat);
00186         f.serial (_DefaultScale);
00187 
00188         f.serialCont(_Materials);
00189         f.serialCont(_AnimatedMaterials);
00190 
00191         if(ver >= 8)
00192                 f.serialCont(_LightInfos);
00193         else
00194         {
00195                 TLightInfoMapV7 temp;
00196                 f.serialCont(temp);
00197         }
00198 
00199         if(ver>=3)
00200                 // read/write _IsLightable flag.
00201                 f.serial(_IsLightable);
00202         else if( f.isReading() )
00203                 // update _IsLightable flag.
00204                 computeIsLightable();
00205 
00206         if(ver>=4)
00207                 f.serial(_UseLightingLocalAttenuation);
00208         else if( f.isReading() )
00209                 _UseLightingLocalAttenuation= false;
00210 
00211         if (ver >= 5)
00212         {
00213                 f.serial(_AutoAnim);
00214         }
00215 
00216         if(ver >= 6)
00217                 f.serial(_DistMax);
00218 
00219         if(ver >= 7)
00220                 f.serialPtr(_LodCharacterTexture);
00221 
00222 }

void NL3D::CMeshBase::setAnimatedMaterial uint  id,
const std::string &  matName
[inherited]
 

setup a material as animated. Material must exist or else no-op.

Definition at line 77 of file mesh_base.cpp.

References NL3D::CMeshBase::_AnimatedMaterials, nlassert, and uint.

00078 {
00079         nlassert(!matName.empty());
00080         if(id<_Materials.size())
00081         {
00082                 // add / replace animated material.
00083                 _AnimatedMaterials[id].Name= matName;
00084                 // copy Material default.
00085                 _AnimatedMaterials[id].copyFromMaterial(&_Materials[id]);
00086         }
00087 }

void NL3D::CMeshBase::setAutoAnim bool  on = true  )  [inline, inherited]
 

Tells that the model instanciated from this shape should be automatically animated. If so the scene will search for an automatic anim that has the same name than this shape and will bind it. This state is serialized. NB: This is a clue to scene::createInstance, a call to createInstance of this object won't make the animation binding.

Definition at line 210 of file mesh_base.h.

References NL3D::CMeshBase::_AutoAnim.

00210 { _AutoAnim = on; }

void NL3D::IShape::setDistMax float  distMax  )  [inherited]
 

setup the DistMax where the shape is no more displayed. Take effect only for the next created instances. setting <0 means -1 and so means DistMax = infinite.

Definition at line 66 of file shape.cpp.

Referenced by NL3D::CFlareShape::CFlareShape().

00067 {
00068         _DistMax= distMax;
00069         // normalize infinite setup.
00070         if(distMax<0)
00071                 _DistMax= -1;
00072 }

void NL3D::CMeshBase::setupLodCharacterTexture CLodCharacterTexture lodText  )  [inherited]
 

setup the lod texture info. see CSkeletonModel Lod system

Definition at line 446 of file mesh_base.cpp.

References NL3D::CMeshBase::_LodCharacterTexture, and NL3D::CMeshBase::resetLodCharacterTexture().

00447 {
00448         // delete old
00449         resetLodCharacterTexture();
00450         // seutp new
00451         _LodCharacterTexture= new CLodCharacterTexture;
00452         *_LodCharacterTexture= lodText;
00453 }

IMeshGeom * NL3D::CMeshMRM::supportMeshBlockRendering CTransformShape trans,
float &  polygonCount
const [virtual]
 

return !NULL if this shape can support MeshBlock rendering for a special instance. NB: Mesh Block render cannot occurs if the Mesh is Skinned/MeshMorphed. NB: Mesh Block render can occurs only in Opaque pass NB: Mesh block render can occurs only for CMeshBase meshes.

Parameters:
trans the instance to take into account (meshMultiLod may return NULL in blend transition).
polygonCount the number of polygons to render for the meshGeom returned
Returns:
the meshgeom to render per block if OK, else NULL (default)

Reimplemented from NL3D::IShape.

Definition at line 3017 of file mesh_mrm.cpp.

References _MeshMRMGeom, NL3D::CTransformShape::getNumTrianglesAfterLoadBalancing(), and NL3D::CMeshMRMGeom::supportMeshBlockRendering().

03018 {
03019         // Ok if meshGeom is ok.
03020         if(_MeshMRMGeom.supportMeshBlockRendering())
03021         {
03022                 polygonCount= trans->getNumTrianglesAfterLoadBalancing();
03023                 return (IMeshGeom*)&_MeshMRMGeom;
03024         }
03025         else
03026                 return NULL;
03027 }

void NL3D::CMeshMRM::updateSkeletonUsage CSkeletonModel sm,
bool  increment
 

update Skeleton Usage. increment or decrement.

Definition at line 3005 of file mesh_mrm.cpp.

References _MeshMRMGeom, and NL3D::CMeshMRMGeom::updateSkeletonUsage().

Referenced by NL3D::CMeshMRMInstance::setApplySkin().

03006 {
03007         _MeshMRMGeom.updateSkeletonUsage(skeleton, increment);
03008 }

bool NL3D::CMeshBase::useLightingLocalAttenuation  )  const [virtual, inherited]
 

tells if the shape wants LocalAttenuation for RealTime lighting. Default is false

Reimplemented from NL3D::IShape.

Definition at line 429 of file mesh_base.cpp.

References NL3D::CMeshBase::_UseLightingLocalAttenuation.

00430 {
00431         return _UseLightingLocalAttenuation;
00432 }


Friends And Related Function Documentation

friend struct CPtrInfo [friend, inherited]
 

Definition at line 67 of file smart_ptr.h.


Field Documentation

TAnimatedMaterialMap NL3D::CMeshBase::_AnimatedMaterials [protected, inherited]
 

Definition at line 240 of file mesh_base.h.

Referenced by NL3D::CMeshBase::applyMaterialUsageOptim(), NL3D::CMeshBase::buildMeshBase(), NL3D::CMeshBase::getAnimatedMaterial(), NL3D::CMeshBase::instanciateMeshBase(), NL3D::CMeshBase::serialMeshBase(), and NL3D::CMeshBase::setAnimatedMaterial().

std::vector<CMorphBase> NL3D::CMeshBase::_AnimatedMorph [protected, inherited]
 

Definition at line 251 of file mesh_base.h.

Referenced by NL3D::CMeshBase::buildMeshBase(), NL3D::CMeshBase::instanciateMeshBase(), and NL3D::CMeshBase::serialMeshBase().

bool NL3D::CMeshBase::_AutoAnim [protected, inherited]
 

Definition at line 258 of file mesh_base.h.

Referenced by NL3D::CMeshBase::CMeshBase(), NL3D::CMeshBase::getAutoAnim(), NL3D::CMeshBase::serialMeshBase(), and NL3D::CMeshBase::setAutoAnim().

CTrackDefaultRGBA NL3D::CMeshBase::_DefaultLMFactor [protected, inherited]
 

Definition at line 249 of file mesh_base.h.

Referenced by NL3D::CMeshBase::CMeshBase(), and NL3D::CMeshBase::getDefaultLMFactor().

CTrackDefaultVector NL3D::CMeshBase::_DefaultPivot [protected, inherited]
 

Definition at line 245 of file mesh_base.h.

Referenced by NL3D::CMeshBase::buildMeshBase(), NL3D::CMeshBase::CMeshBase(), NL3D::CMeshBase::getDefaultPivot(), NL3D::CMeshBase::instanciateMeshBase(), and NL3D::CMeshBase::serialMeshBase().

CTrackDefaultVector NL3D::CMeshBase::_DefaultPos [protected, inherited]
 

Transform default tracks. Those default tracks are instancied, ie, CInstanceMesh will have the same and can't specialize it.

Definition at line 244 of file mesh_base.h.

CTrackDefaultVector NL3D::CMeshBase::_DefaultRotEuler [protected, inherited]
 

Definition at line 246 of file mesh_base.h.

Referenced by NL3D::CMeshBase::buildMeshBase(), NL3D::CMeshBase::CMeshBase(), NL3D::CMeshBase::getDefaultRotEuler(), and NL3D::CMeshBase::serialMeshBase().

CTrackDefaultQuat NL3D::CMeshBase::_DefaultRotQuat [protected, inherited]
 

Definition at line 247 of file mesh_base.h.

Referenced by NL3D::CMeshBase::buildMeshBase(), NL3D::CMeshBase::CMeshBase(), NL3D::CMeshBase::getDefaultRotQuat(), NL3D::CMeshBase::instanciateMeshBase(), and NL3D::CMeshBase::serialMeshBase().

CTrackDefaultVector NL3D::CMeshBase::_DefaultScale [protected, inherited]
 

Definition at line 248 of file mesh_base.h.

Referenced by NL3D::CMeshBase::buildMeshBase(), NL3D::CMeshBase::CMeshBase(), NL3D::CMeshBase::getDefaultScale(), NL3D::CMeshBase::instanciateMeshBase(), and NL3D::CMeshBase::serialMeshBase().

float NL3D::IShape::_DistMax [protected, inherited]
 

Default to -1.

Definition at line 165 of file shape.h.

bool NL3D::CMeshBase::_IsLightable [protected, inherited]
 

Is this mesh lightable??

Definition at line 254 of file mesh_base.h.

Referenced by NL3D::CMeshBase::computeIsLightable(), NL3D::CMeshBase::isLightable(), and NL3D::CMeshBase::serialMeshBase().

TLightMapInfo NL3D::CMeshBase::_LightInfos [inherited]
 

Definition at line 234 of file mesh_base.h.

Referenced by NL3D::CMeshBase::applyMaterialUsageOptim(), NL3D::CMeshBase::buildMeshBase(), NL3D::UShape::cameraCollisionable(), NL3D::CMeshBaseInstance::getLightMapName(), NL3D::CMeshBaseInstance::getNbLightMap(), NL3D::CMeshBaseInstance::initAnimatedLightIndex(), NL3D::CMeshBase::serialMeshBase(), and NL3D::CMeshBaseInstance::traverseAnimDetail().

std::vector<CMaterial> NL3D::CMeshBase::_Materials [protected, inherited]
 

The Materials.

Definition at line 230 of file mesh_base.h.

CMeshMRMGeom NL3D::CMeshMRM::_MeshMRMGeom [private]
 

Definition at line 812 of file mesh_mrm.h.

Referenced by build(), changeMRMDistanceSetup(), clip(), computeBonesId(), createInstance(), getBoundingBox(), getMeshGeom(), getNbLod(), getNbRdrPass(), getNumTriangles(), getRdrPassMaterial(), getRdrPassPrimitiveBlock(), getVertexBuffer(), optimizeMaterialUsage(), profileSceneRender(), render(), supportMeshBlockRendering(), and updateSkeletonUsage().

bool NL3D::CMeshBase::_UseLightingLocalAttenuation [protected, inherited]
 

Is this mesh Use Lighting Local Attenuation ??

Definition at line 256 of file mesh_base.h.

Referenced by NL3D::CMeshBase::buildMeshBase(), NL3D::CMeshBase::CMeshBase(), NL3D::CMeshBase::serialMeshBase(), and NL3D::CMeshBase::useLightingLocalAttenuation().

sint NLMISC::CRefCount::crefs [mutable, inherited]
 

Definition at line 79 of file smart_ptr.h.

Referenced by NLMISC::CRefCount::CRefCount(), NLMISC::CRefCount::getRefCount(), and NLMISC::CRefCount::~CRefCount().

CRefCount::CPtrInfo NLMISC::CRefCount::NullPtrInfo [static, inherited]
 

Referenced by NLMISC::CRefCount::CRefCount().

CPtrInfo* NLMISC::CRefCount::pinfo [mutable, inherited]
 

Definition at line 80 of file smart_ptr.h.

Referenced by NLMISC::CRefCount::CRefCount(), and NLMISC::CRefCount::~CRefCount().


The documentation for this class was generated from the following files:
Generated on Tue Mar 16 06:52:53 2004 for NeL by doxygen 1.3.6