NL3D::CScene Class Reference

#include <scene.h>

---

Detailed Description

A CScene, which own a list of Render Traversals, and a render() method.

USER RULES:

• Before creating any CScene, call the cool method CScene::registerBasics(), to register baisc models.
• Create a CScene (NB: may be static CScene scene;).
• call first initDefaultRoot() to create / register automatically the roots:
• set your driver for this scene with setDriver().
• create any other model with createModel() (such as a camera).
• Specify a Camera (SmartPtr-ed !!)
• render().

CScene own those Traversals and those Root and kill them at ~CScene().

Coordinate System: right hand cordinates with: X to the right, Y to the far, Z to the top.

Z ^ | > Y | / | / |/ -------> X

Shape System:
The scene has an instance Managagement:

• IShape design the object that is instancied (a mesh as example).
• ITransformShape is the instance, which smart_point to a IShape.
• user can add shape manually in the scene CShapeBank with CShapeBank::add (), or remove them with CShapeBank::release ().
• user create instance of a shape with CScene::createInstance(string shapeName); This create/load auto the shape if needed (searching in CPath, shapename must be a valid file name), and then create the instance, with help of IShape::createInstance().

Author:

Lionel Berenguier

Nevrax France

Date:

2000

Definition at line 114 of file scene.h.

Flare contexts
The flare objects are designed to work with a single scene, because they simulate 'retinian persistence' based on the visibility in the current scene. Several context allow to deals with a flare rendered from several points of views. There's a limited number of contexts (MaxNumFlareContexts)
enum	{ MaxNumFlareContexts = CFlareModel::MaxNumContext }
uint	getFlareContext () const
void	setFlareContext (uint context)
Private
typedef TSkeletonModelList::iterator	ItSkeletonModelList
typedef std::list< CSkeletonModel * >	TSkeletonModelList
ItSkeletonModelList	appendSkeletonModelToList (CSkeletonModel *skel)
	Private.
void	eraseSkeletonModelToList (ItSkeletonModelList it)
ItSkeletonModelList	getSkeletonModelListBegin ()
ItSkeletonModelList	getSkeletonModelListEnd ()
LoadBalancing mgt.
enum	TPolygonBalancingMode { PolygonBalancingOff = 0, PolygonBalancingOn, PolygonBalancingClamp, CountPolygonBalancing }
uint	getGroupLoadMaxPolygon (const std::string &group)
float	getGroupNbFaceAsked (const std::string &group) const
uint	getMaxSkeletonsInNotCLodForm () const
float	getNbFaceAsked () const
TPolygonBalancingMode	getPolygonBalancingMode () const
	Get the PolygonBalancingMode.
void	setGroupLoadMaxPolygon (const std::string &group, uint nFaces)
void	setMaxSkeletonsInNotCLodForm (uint m)
void	setPolygonBalancingMode (TPolygonBalancingMode polBalMode)
	Set the PolygonBalancingMode.
Profiling
void	incrementProfileTriVBFormat (std::map< uint32, uint32 > &formatToTri, uint32 vbFormat, uint32 numTris)
bool	isNextRenderProfile () const
void	profileNextRender ()
	Misc.
UScene::CBenchResults	BenchRes
Shape/Instances.
typedef std::multimap< std::string, CTransformShape ** >	TWaitingInstancesMMap
CInstanceGroup *	_GlobalInstanceGroup
CShapeBank *	_ShapeBank
TWaitingInstancesMMap	_WaitingInstances
Public Types
Public Member Functions
CAsyncTextureManager *	getAsyncTextureManager () const
	Get the async texture manager. NULL if was not setuped.
CAnimationSet *	getAutomaticAnimationSet () const
	Get a reference to the set of automatic animations.
double	getCurrentSystemTime () const
TGlobalAnimationTime	getCurrentTime (void) const
	get the current time of the scene, in second. It start from 0 (at the firt call of animate)
double	getEllapsedSystemTime () const
	get the ellapsed time (in second) between the last 2 calls of render().
TAnimationTime	getEllapsedTime (void) const
	get the ellapsed time (in second) between the last 2 calls of animate.
CInstanceGroup *	getGlobalInstanceGroup ()
uint64	getNumRender () const
	get the number of time render has been called
CParticleSystemManager &	getParticleSystemManager ()
	Get a ref. to the particle system manager. You shouldn't call this (has methods for private processing).
IWaterSurfaceAddedCallback *	getWaterCallback () const
void	setAsyncTextureManager (CAsyncTextureManager *mgr)
	Set the async texture manager.
void	setAutomaticAnimationSet (CAnimationSet *as)
	set the automatic animation set used by this scene. It is stored as a smart pointer
void	setWaterCallback (IWaterSurfaceAddedCallback *wcb)
void	updateWaitingInstances (double systemTimeEllapsed)
Light Mgt.
void	addInstanceGroupForLightAnimation (CInstanceGroup *ig)
	Add an IG for auto PointLight Factor animation. called by CInstanceGroup::addToScene().
void	animate (TGlobalAnimationTime atTime)
	Add an IG for auto PointLight Factor animation. called by CInstanceGroup::addToScene().
void	removeInstanceGroupForLightAnimation (CInstanceGroup *ig)
	Remove an IG for auto PointLight Factor animation. called by CInstanceGroup::removeFromScene().
Instance Mgt.
CTransformShape *	createInstance (const std::string &shapeName)
void	createInstanceAsync (const std::string &shapeName, CTransformShape **pInstance, const NLMISC::CVector &position, uint selectedTexture)
void	deleteInstance (CTransformShape *model)
const CShapeBank *	getShapeBank (void) const
	Get the shape bank (const version).
CShapeBank *	getShapeBank (void)
	Get the shape bank.
void	setShapeBank (CShapeBank *pShapeBank)
	Set the shape bank.
Model mgt.
CTransform *	createModel (const NLMISC::CClassId &idModel)
void	deleteModel (CTransform *model)
Construction / destruction.
	CScene (bool bSmallScene)
	Constructor.
IDriver *	getDriver () const
	Get the driver of render Traversal.
void	initDefaultRoots ()
	Create/setRoot the defaults models roots: a CTransform and a CLightGroup.
void	initQuadGridClipManager ()
	init QuadGridClipManager
void	release ()
void	setDriver (IDriver *drv)
	Set the driver to render Traversal.
	~CScene ()
	Destructor. release().
Render Filtering
void	enableElementRender (UScene::TRenderFilter elt, bool state)
uint32	getFilterRenderFlags () const
Sun Light mgt
void	enableLightingSystem (bool enable)
NLMISC::CRGBA	getAmbientGlobal () const
	get the global Ambient used for the scene. Default to (50, 50, 50).
NLMISC::CRGBA	getAnimatedLightFactor (sint animatedLightmap, uint lightGroup) const
	get an animated light factor.
sint	getAnimatedLightNameToIndex (const std::string &name) const
	get an animated lightmap index by name. Return -1 if not found.
NLMISC::CRGBA	getLightmapGroupColor (uint lightGroup) const
	get the color of a lightmap group.
float	getLightTransitionThreshold () const
	getLightTransitionThreshold()
uint	getMaxLightContribution () const
	setMaxLightContribution()
uint	getNumLightGroup () const
	get the number of light group.
NLMISC::CRGBA	getSunAmbient () const
	get the Ambient of the Sun used for the scene.
NLMISC::CRGBA	getSunDiffuse () const
	get the Diffuse of the Sun used for the scene.
NLMISC::CVector	getSunDirection () const
	get the Direction of the Sun used for the scene.
NLMISC::CRGBA	getSunSpecular () const
	get the Specular of the Sun used for the scene.
bool	isLightingSystemEnabled () const
	see enableLightingSystem
void	setAmbientGlobal (NLMISC::CRGBA ambient)
	set the global Ambient used for the scene. Default to (50, 50, 50).
void	setLightGroupColor (uint lightmapGroup, NLMISC::CRGBA color)
	set the color of a light group.
void	setLightTransitionThreshold (float lightTransitionThreshold)
void	setMaxLightContribution (uint nlights)
void	setSunAmbient (NLMISC::CRGBA ambient)
	set the Ambient of the Sun used for the scene.
void	setSunDiffuse (NLMISC::CRGBA diffuse)
	set the Diffuse of the Sun used for the scene.
void	setSunDirection (const NLMISC::CVector &direction)
	set the Direction of the Sun used for the scene.
void	setSunSpecular (NLMISC::CRGBA specular)
	set the Specular of the Sun used for the scene.
ShadowMapping Options
void	enableShadowPolySmooth (bool enable)
	Enable Polygon Smoothing.
bool	getEnableShadowPolySmooth () const
	get Enable Polygon Smoothing flag
uint	getShadowMapBlurSize () const
	get the size of the blur (<=3 means number of fakeBlur).
float	getShadowMapDistFadeEnd () const
	Enable Polygon Smoothing.
float	getShadowMapDistFadeStart () const
	Enable Polygon Smoothing.
uint	getShadowMapMaxCasterAround () const
	Enable Polygon Smoothing.
uint	getShadowMapMaxCasterInScreen () const
	Enable Polygon Smoothing.
float	getShadowMapMaxDepth () const
	return the current ShadowMap Max Depth. This is the length in the lightDir direction where the shadow can touch receivers
uint	getShadowMapTextureSize () const
	return the current base ShadowMap TextureSize. Default is 64 texels.
void	setShadowMapBlurSize (uint bs)
	set the size of the blur (<=3 means number of fakeBlur).
void	setShadowMapDistFadeEnd (float dist)
	ShadowMap Distance Fade end (50 default).
void	setShadowMapDistFadeStart (float dist)
	ShadowMap Distance Fade Start (40 default).
void	setShadowMapMaxCasterAround (uint num)
	ShadowMap max Caster Around (optimize memory).
void	setShadowMapMaxCasterInScreen (uint num)
	ShadowMap max Caster In Screen (optimize CPU/GPU).
void	setShadowMapMaxDepth (float depth)
	set the ShadowMap Extent
void	setShadowMapTextureSize (uint size)
	must be a power of 2.
Camera/Viewport.
void	findCameraClusterSystemFromRay (CCamera *cam, CInstanceGroup *startClusterSystem, const NLMISC::CVector &startPos, const NLMISC::CVector &endPos)
CCamera *	getCam ()
CViewport	getViewport ()
void	setCam (CCamera *cam)
	Set/Get the current camera/Viewport.
void	setViewport (const class CViewport &viewport)
Trav accessor. Use it with caution. (used for mesh rendering)
CAnimDetailTrav &	getAnimDetailTrav ()
CClipTrav &	getClipTrav ()
CHrcTrav &	getHrcTrav ()
CLightTrav &	getLightTrav ()
CLoadBalancingTrav &	getLoadBalancingTrav ()
CRenderTrav &	getRenderTrav ()
CTransform *	getRoot () const
	Get the Root For Hrc and Basics Clip of the scene.
CCluster *	getRootCluster () const
	Get the RootCluster For Clip of the scene.
Coarse meshes managers.
uint8	getCoarseMeshLightingUpdate () const
	see setCoarseMeshLightingUpdate()
CCoarseMeshManager *	getCoarseMeshManager ()
	see setCoarseMeshLightingUpdate()
CLodCharacterManager *	getLodCharacterManager () const
	Get the LodCharacterManager. NULL if user did not set it. (done in DriverUser).
void	setCoarseMeshLightingUpdate (uint8 period)
void	setLodCharacterManager (CLodCharacterManager *m)
	set the LodCharacterManager
Weather mgt
const CVector &	getGlobalWindDirection () const
	get the current windDirection
float	getGlobalWindPower () const
	get the current windPower
void	setGlobalWindDirection (const CVector &gwd)
	Set the current windDirection for all the scene. dir.z set to 0 and vector normalized.
void	setGlobalWindPower (float gwp)
	Weather mgt.
transparent Layer mgt
bool	getLayersRenderingOrder () const
void	setLayersRenderingOrder (bool directOrder=true)
Render
void	render (bool doHrcPass=true)
Static Public Member Functions
Basic registration.
void	registerBasics ()
	Register Basic models.
void	registerModel (const NLMISC::CClassId &idModel, const NLMISC::CClassId &idModelBase, CTransform *(*creator)())
Private Types
typedef TAnimatedIgSet::iterator	ItAnimatedIgSet
typedef std::set< CInstanceGroup * >	TAnimatedIgSet
Private Member Functions
void	updateModels ()
	Update all models. All dirty models are cleaned.
Private Attributes
TAnimatedIgSet	_AnimatedIgSet
std::list< CAnimatedLightmap >	_AnimatedLight
std::map< std::string, uint >	_AnimatedLightNameToIndex
std::vector< CAnimatedLightmap * >	_AnimatedLightPtr
CAsyncTextureManager *	_AsyncTextureManager
NLMISC::CSmartPtr< CAnimationSet >	_AutomaticAnimationSet
uint8	_CoarseMeshLightingUpdate
	set setCoarseMeshLightingUpdate
TGlobalAnimationTime	_CurrentTime
double	_DeltaSystemTimeBetweenRender
TAnimationTime	_EllapsedTime
uint32	_FilterRenderFlags
bool	_FirstAnimateCall
uint	_FlareContext
double	_GlobalSystemTime
TGlobalAnimationTime	_InitTime
std::vector< NLMISC::CRGBA >	_LightGroupColor
bool	_LightingSystemEnabled
CPlayListManager	_LMAnimsAuto
uint	_MaxSkeletonsInNotCLodForm
std::set< CTransform * >	_Models
bool	_NextRenderProfile
uint64	_NumRender
TGlobalAnimationTime	_RealTime
uint	_ShadowMapBlurSize
float	_ShadowMapDistFadeEnd
float	_ShadowMapDistFadeStart
uint	_ShadowMapMaxCasterAround
uint	_ShadowMapMaxCasterInScreen
float	_ShadowMapMaxDepth
uint	_ShadowMapTextureSize
TSkeletonModelList	_SkeletonModelList
CTransform *	_UpdateModelList
CViewport	_Viewport
IWaterSurfaceAddedCallback *	_WaterCallback
CRefPtr< CCamera >	CurrentCamera
	The camera / Viewport.
CTransform *	Root
CCluster *	RootCluster
CRootModel *	SonsOfAncestorSkeletonModelGroup
Coarse meshes managers.
CCoarseMeshManager *	_CoarseMeshManager
CLodCharacterManager *	_LodCharacterManager
Weather mgt
CVector	_GlobalWindDirection
float	_GlobalWindPower
Particle systems specific
CParticleSystemManager	_ParticleSystemManager
Clip features
CQuadGridClipManager *	_QuadGridClipManager
The traversals
CAnimDetailTrav	AnimDetailTrav
CClipTrav	ClipTrav
CHrcTrav	HrcTrav
CLightTrav	LightTrav
CLoadBalancingTrav	LoadBalancingTrav
CRenderTrav	RenderTrav
Static Private Attributes
std::set< CModelEntry >	_RegModels
Friends
class	CClipTrav
class	CTransform

---

Member Typedef Documentation

typedef TAnimatedIgSet::iterator NL3D::CScene::ItAnimatedIgSet [private]

Definition at line 652 of file scene.h. Referenced by animate(), and removeInstanceGroupForLightAnimation().

typedef TSkeletonModelList::iterator NL3D::CScene::ItSkeletonModelList

Definition at line 514 of file scene.h. Referenced by appendSkeletonModelToList(), NL3D::CClipTrav::clipSkeletonShadowMaps(), eraseSkeletonModelToList(), getSkeletonModelListBegin(), getSkeletonModelListEnd(), NL3D::CClipTrav::loadBalanceSkeletonCLod(), and NL3D::CClipTrav::traverse().

typedef std::set<CInstanceGroup*> NL3D::CScene::TAnimatedIgSet [private]

Definition at line 651 of file scene.h.

typedef std::list<CSkeletonModel*> NL3D::CScene::TSkeletonModelList

Definition at line 513 of file scene.h.

typedef std::multimap<std::string,CTransformShape**> NL3D::CScene::TWaitingInstancesMMap [private]

Definition at line 659 of file scene.h.

---

Member Enumeration Documentation

anonymous enum

Enumeration values: MaxNumFlareContexts  Definition at line 552 of file scene.h. { MaxNumFlareContexts = CFlareModel::MaxNumContext };

enum NL3D::CScene::TPolygonBalancingMode

The mode of polygon balancing. PolygonBalancingOff => Models will be rendered with the number of faces they want to render. PolygonBalancingOn => Models will be rendered with the number of faces the LoadBalancing want. PolygonBalancingClamp => Same as PolygonBalancingOn, but factor <= 1, ie models won't be rendered with more face they want to render. Enumeration values: PolygonBalancingOff  PolygonBalancingOn  PolygonBalancingClamp  CountPolygonBalancing  Definition at line 317 of file scene.h. {PolygonBalancingOff=0, PolygonBalancingOn, PolygonBalancingClamp, CountPolygonBalancing};

---

Constructor & Destructor Documentation

NL3D::CScene::CScene (  bool  bSmallScene  )

Constructor. Definition at line 134 of file scene.cpp. References _CoarseMeshLightingUpdate, _CoarseMeshManager, _FilterRenderFlags, _FirstAnimateCall, _FlareContext, _GlobalWindDirection, _GlobalWindPower, _LightingSystemEnabled, _MaxSkeletonsInNotCLodForm, _NextRenderProfile, _NumRender, _RealTime, _ShadowMapBlurSize, _ShadowMapDistFadeEnd, _ShadowMapDistFadeStart, _ShadowMapMaxCasterAround, _ShadowMapMaxCasterInScreen, _ShadowMapMaxDepth, _ShadowMapTextureSize, _UpdateModelList, _WaterCallback, AnimDetailTrav, ClipTrav, HrcTrav, LightTrav, LoadBalancingTrav, NL3D_SCENE_COARSE_MANAGER_TEXTURE, NL3D_SCENE_DEFAULT_SHADOW_MAP_BLUR_SIZE, NL3D_SCENE_DEFAULT_SHADOW_MAP_DEPTH, NL3D_SCENE_DEFAULT_SHADOW_MAP_DIST_FADE_END, NL3D_SCENE_DEFAULT_SHADOW_MAP_DIST_FADE_START, NL3D_SCENE_DEFAULT_SHADOW_MAP_MAX_CASTER_AROUND, NL3D_SCENE_DEFAULT_SHADOW_MAP_MAX_CASTER_IN_SCREEN, NL3D_SCENE_DEFAULT_SHADOW_MAP_SIZE, Root, NL3D::CTraversal::Scene, NLMISC::CVector::set(), NL3D::CCoarseMeshManager::setTextureFile(), and SonsOfAncestorSkeletonModelGroup. : LightTrav(bSmallScene) { HrcTrav.Scene= this; ClipTrav.Scene= this; LightTrav.Scene= this; AnimDetailTrav.Scene= this; LoadBalancingTrav.Scene= this; RenderTrav.Scene= this; _ShapeBank = NULL; Root= NULL; RootCluster= NULL; SonsOfAncestorSkeletonModelGroup= NULL; _QuadGridClipManager= NULL; _CurrentTime = 0 ; _EllapsedTime = 0 ; _RealTime = 0 ; _FirstAnimateCall = true ; _LightingSystemEnabled= false; _CoarseMeshLightingUpdate= 50; _GlobalWindDirection.set(1,0,0); // Default as Sithikt wants. _GlobalWindPower= 0.2f; // global manager (created in CDriverUser) _LodCharacterManager= NULL; _AsyncTextureManager= NULL; _NumRender = 0; _MaxSkeletonsInNotCLodForm= 20; _FilterRenderFlags= ~0; _NextRenderProfile= false; // Init default _CoarseMeshManager _CoarseMeshManager= new CCoarseMeshManager; _CoarseMeshManager->setTextureFile (NL3D_SCENE_COARSE_MANAGER_TEXTURE); // Update model list to NULL _UpdateModelList= NULL; _FlareContext = 0; _ShadowMapTextureSize= NL3D_SCENE_DEFAULT_SHADOW_MAP_SIZE; _ShadowMapMaxDepth= NL3D_SCENE_DEFAULT_SHADOW_MAP_DEPTH; _ShadowMapBlurSize= NL3D_SCENE_DEFAULT_SHADOW_MAP_BLUR_SIZE; _ShadowMapDistFadeStart= NL3D_SCENE_DEFAULT_SHADOW_MAP_DIST_FADE_START; _ShadowMapDistFadeEnd= NL3D_SCENE_DEFAULT_SHADOW_MAP_DIST_FADE_END; _ShadowMapMaxCasterInScreen= NL3D_SCENE_DEFAULT_SHADOW_MAP_MAX_CASTER_IN_SCREEN; _ShadowMapMaxCasterAround= NL3D_SCENE_DEFAULT_SHADOW_MAP_MAX_CASTER_AROUND; _WaterCallback = NULL; }

NL3D::CScene::~CScene (   )

Destructor. release(). Definition at line 244 of file scene.cpp. References release(). { release(); }

---

Member Function Documentation

void NL3D::CScene::addInstanceGroupForLightAnimation (  CInstanceGroup *  ig  )

Add an IG for auto PointLight Factor animation. called by CInstanceGroup::addToScene(). Definition at line 910 of file scene.cpp. References _AnimatedIgSet, and nlassert. Referenced by NL3D::CInstanceGroup::addToSceneWhenAllShapesLoaded(). { nlassert( ig ); nlassert( _AnimatedIgSet.find(ig) == _AnimatedIgSet.end() ); _AnimatedIgSet.insert(ig); }

void NL3D::CScene::animate (  TGlobalAnimationTime  atTime  )

Add an IG for auto PointLight Factor animation. called by CInstanceGroup::addToScene(). Definition at line 710 of file scene.cpp. References _AnimatedIgSet, _AnimatedLightPtr, _FirstAnimateCall, _InitTime, _LMAnimsAuto, _RealTime, NL3D::CPlayListManager::animate(), count, ItAnimatedIgSet, NL3D::CInstanceGroup::setPointLightFactor(), NL3D::TGlobalAnimationTime, and uint. Referenced by NL3D::CSceneUser::animate(). { // todo hulud remove if (_FirstAnimateCall) { _InitTime = atTime; _RealTime = atTime; // dummy value for first frame _EllapsedTime = 0.01f ; _FirstAnimateCall = false ; } else { _EllapsedTime = (float) (atTime - _RealTime); //nlassert(_EllapsedTime >= 0); if (_EllapsedTime < 0.0f) // NT WorkStation PATCH (Yes you are not dreaming _EllapsedTime = 0.01f; // deltaTime can be less than zero!!) _EllapsedTime = fabsf(_EllapsedTime); _RealTime = atTime ; _CurrentTime += _EllapsedTime; } _LMAnimsAuto.animate( atTime ); // Change PointLightFactors of all pointLights in registered Igs. //---------------- // First list all current AnimatedLightmaps (for faster vector iteration per ig) const uint count = _AnimatedLightPtr.size (); uint i; for (i=0; i<count; i++) { // Blend final colors _AnimatedLightPtr[i]->updateGroupColors (*this); } // For all registered igs. ItAnimatedIgSet itAnIgSet; for(itAnIgSet= _AnimatedIgSet.begin(); itAnIgSet!=_AnimatedIgSet.end(); itAnIgSet++) { CInstanceGroup *ig= *itAnIgSet; // Set the light factor ig->setPointLightFactor(*this); } }

CScene::ItSkeletonModelList NL3D::CScene::appendSkeletonModelToList (  CSkeletonModel *  skel  )

Private. Definition at line 961 of file scene.cpp. References _SkeletonModelList, and ItSkeletonModelList. Referenced by NL3D::CSkeletonModel::initModel(). { _SkeletonModelList.push_front(skel); return _SkeletonModelList.begin(); }

CTransformShape * NL3D::CScene::createInstance (  const std::string &  shapeName  )

Create a model, instance of the shape "shapename". If not present, try to load "shapename" via the CPath. If fails, return NULL. Definition at line 600 of file scene.cpp. References _AutomaticAnimationSet, NL3D::CShapeBank::addRef(), NL3D::IShape::createInstance(), NL3D::CMeshBase::getAutoAnim(), NL3D::CLandscape::initAnimatedLightIndex(), NL3D::CMeshBaseInstance::initAnimatedLightIndex(), NL3D::CShapeBank::isPresent(), NL3D::CLandscapeModel::Landscape, NL3D::CShapeBank::load(), NL3D_MEM_INSTANCE, nlassert, NL3D::CMeshBaseInstance::registerToChannelMixer(), NL3D::CChannelMixer::setAnimationSet(), NL3D::CTransform::setChannelMixerOwnerShip(), NL3D::CTransformShape::setDistMax(), NL3D::CChannelMixer::setSlotAnimation(), NL3D::CTransformShape::Shape, NLMISC::strlwr(), and uint. Referenced by NL3D::CInstanceGroup::addToScene(), NL3D::CSceneUser::createInstance(), NL3D::CSceneUser::createSkeleton(), NL3D::CPSMesh::newElement(), and NL3D::CPSMesh::updatePos(). { NL3D_MEM_INSTANCE // We must attach a bank to the scene (a ShapeBank handle the shape caches and // the creation/deletion of the instances) nlassert( _ShapeBank != NULL ); // If the shape is not present in the bank if (_ShapeBank->isPresent( shapeName ) != CShapeBank::Present) { // Load it from file _ShapeBank->load( shapeName ); if (_ShapeBank->isPresent( shapeName ) != CShapeBank::Present) { return NULL; } } // Then create a reference to the shape CTransformShape *pTShp = _ShapeBank->addRef( shapeName )->createInstance(*this); if (pTShp) pTShp->setDistMax(pTShp->Shape->getDistMax()); #ifdef NL_DEBUG //pTShp->NameForDebug = shapeName; // \todo traptemp #endif // Look if this instance get lightmap information #if defined(__GNUC__) && __GNUC__ < 3 CMeshBase *pMB = (CMeshBase*)((IShape*)(pTShp->Shape)); #else // not GNUC CMeshBase *pMB = dynamic_cast<CMeshBase*>((IShape*)(pTShp->Shape)); #endif // not GNUC CMeshBaseInstance *pMBI = dynamic_cast<CMeshBaseInstance*>( pTShp ); if( ( pMB != NULL ) && ( pMBI != NULL ) ) { // Init lightmap information pMBI->initAnimatedLightIndex (*this); // Auto animations //========================== if (_AutomaticAnimationSet) { if (pMB->getAutoAnim()) { std::string animName = CFile::getFilenameWithoutExtension(shapeName); animName = strlwr (animName); uint animID = _AutomaticAnimationSet->getAnimationIdByName(animName); if (animID != CAnimationSet::NotFound) { CChannelMixer *chanMix = new CChannelMixer; chanMix->setAnimationSet((CAnimationSet *) _AutomaticAnimationSet); chanMix->setSlotAnimation(0, animID); pMBI->registerToChannelMixer(chanMix, ""); // Gives this object ownership of the channel mixer so we don't need to keep track of it pMBI->setChannelMixerOwnerShip(true); } } } } CLandscapeModel *pLM = dynamic_cast<CLandscapeModel*>( pTShp ); if( pLM != NULL ) { // Init lightmap information pLM->Landscape.initAnimatedLightIndex (*this); } return pTShp; }

void NL3D::CScene::createInstanceAsync (  const std::string &  shapeName, CTransformShape **  pInstance, const NLMISC::CVector &  position, uint  selectedTexture )

Create an instance, if the shape is not present, load the shape asynchronously. The instance is really created when we process it in the rendering. Definition at line 674 of file scene.cpp. References _WaitingInstances, getDriver(), NL3D::CShapeBank::isPresent(), NL3D::CShapeBank::loadAsync(), nlassert, NLMISC::strlwr(), and uint. Referenced by NL3D::CSceneUser::createInstanceAsync(). { // We must attach a bank to the scene (a ShapeBank handle the shape caches and // the creation/deletion of the instances) nlassert( _ShapeBank != NULL ); *pInstance = NULL; // Add the instance request _WaitingInstances.insert(TWaitingInstancesMMap::value_type(shapeName,pInstance)); // If the shape is not present in the bank if (_ShapeBank->isPresent( shapeName ) != CShapeBank::Present) { // Load it from file asynchronously _ShapeBank->loadAsync( strlwr(shapeName), getDriver(), position, NULL, selectedTexture); } }

CTransform * NL3D::CScene::createModel (  const NLMISC::CClassId &  idModel  )

Create a model according to his type id. Model must has been previously registered via registerModel(). Then, This function attach this model to the Root (for HRC and for Clip) Model are deleted with the deleteModel() or with release() which delete all models NB: Since CScene own the model, model MUST NOT be used with SmartPtrs (but CRefPtr always work...). Parameters: idModel  the Unique Id of the Model Returns: a valid model of the required type. NULL, if not found. See also: deleteModel() Definition at line 1004 of file scene.cpp. References _Models, NL3D::CTransform::_OwnerScene, _RegModels, AnimDetailTrav, NL3D::CTransform::clipAddChild(), ClipTrav, NL3D::CTransform::hrcLinkSon(), NL3D::CTransform::initModel(), LightTrav, NL3D::CTransform::linkToUpdateList(), LoadBalancingTrav, NL3D::CScene::CModelEntry::ModelId, nlassert, nlstop, NL3D::CLightTrav::reserveLightedList(), NL3D::CRenderTrav::reserveRenderList(), NL3D::CLoadBalancingTrav::reserveVisibleList(), NL3D::CAnimDetailTrav::reserveVisibleList(), NL3D::CClipTrav::reserveVisibleList(), and Root. Referenced by NL3D::CInstanceGroup::addToSceneWhenAllShapesLoaded(), NL3D::CLandscapeUser::CLandscapeUser(), NL3D::CWaveMakerShape::createInstance(), NL3D::CWaterShape::createInstance(), NL3D::CSkeletonShape::createInstance(), NL3D::IShape::createInstance(), NL3D::CSegRemanenceShape::createInstance(), NL3D::CParticleSystemShape::createInstance(), NL3D::CMeshMultiLod::createInstance(), NL3D::CMeshMRMSkinned::createInstance(), NL3D::CMeshMRM::createInstance(), NL3D::CMesh::createInstance(), NL3D::CFlareShape::createInstance(), NL3D::CSceneUser::createPointLight(), NL3D::CInstanceGroup::createRoot(), NL3D::CSceneUser::createTransform(), initDefaultRoots(), initQuadGridClipManager(), and NL3D::CPSLight::step(). { nlassert(idModel!=CClassId::Null); CModelEntry e; e.ModelId= idModel; set<CModelEntry>::iterator itModel; itModel= _RegModels.find(e); if(itModel==_RegModels.end()) { nlstop; // Warning, CScene::registerBasics () has not been called ! return NULL; } else { CTransform *m= (*itModel).Creator(); if(!m) return NULL; // Set the owner for the model. m->_OwnerScene= this; // link model to Root in HRC and in clip. NB: if exist!! (case for the Root and RootCluster :) ) if(Root) { Root->hrcLinkSon(m); Root->clipAddChild(m); } // Insert the model into the set. _Models.insert(m); // By default the model is update() in CScene::updateModels(). m->linkToUpdateList(); // Once the model is correclty created, finish init him. m->initModel(); // Ensure all the Traversals has enough space for visible list. ClipTrav.reserveVisibleList(_Models.size()); AnimDetailTrav.reserveVisibleList(_Models.size()); LoadBalancingTrav.reserveVisibleList(_Models.size()); LightTrav.reserveLightedList(_Models.size()); RenderTrav.reserveRenderList(_Models.size()); return m; } }

void NL3D::CScene::deleteInstance (  CTransformShape *  model  )

Delete an instance via his pointer. An instance is an entity which reference a shape. Definition at line 691 of file scene.cpp. References deleteModel(), NL3D::CShapeBank::release(), and NL3D::CTransformShape::Shape. Referenced by NL3D::CPSMesh::deleteElement(), NL3D::CPSMesh::releaseAllRef(), NL3D::CInstanceGroup::removeFromScene(), NL3D::CPSMesh::~CPSMesh(), and NL3D::CTransformUser::~CTransformUser(). { IShape *pShp = NULL; if( pTrfmShp == NULL ) return; pShp = pTrfmShp->Shape; deleteModel( pTrfmShp ); if (pShp) { // Even if model already deleted by smarptr the release function works _ShapeBank->release( pShp ); } }

void NL3D::CScene::deleteModel (  CTransform *  model  )

Delete a model via his pointer. The model is automatically unlinked from all other model Once a model is deleted, all pointer to him should have been deleted. Definition at line 1053 of file scene.cpp. References _Models. Referenced by NL3D::CLodCharacterBuilder::addAnim(), NL3D::CPSLight::deleteElement(), deleteInstance(), release(), NL3D::CPSLight::releaseAllRef(), NL3D::CInstanceGroup::removeFromScene(), NL3D::CLandscapeUser::~CLandscapeUser(), NL3D::CPSLight::~CPSLight(), NL3D::CTransformUser::~CTransformUser(), and NL3D::CVegetableManager::~CVegetableManager(). { if(model==NULL) return; set<CTransform*>::iterator it= _Models.find(model); if(it!=_Models.end()) { delete *it; _Models.erase(it); } }

void NL3D::CScene::enableElementRender (  UScene::TRenderFilter  elt, bool  state )

Definition at line 816 of file scene.cpp. References _FilterRenderFlags, and uint32. Referenced by NL3D::CSceneUser::enableElementRender(). { if(state) _FilterRenderFlags|= (uint32)elt; else _FilterRenderFlags&= ~(uint32)elt; }

void NL3D::CScene::enableLightingSystem (  bool  enable  )

Enable Scene Lighting system. For backward compatibility, false by default. If false, all objects will take last driver 's light setup Definition at line 833 of file scene.cpp. References _LightingSystemEnabled, NL3D::CLightTrav::LightingSystemEnabled, NL3D::CRenderTrav::LightingSystemEnabled, and LightTrav. Referenced by NL3D::CSceneUser::enableLightingSystem(). { _LightingSystemEnabled= enable; // Set to RenderTrav and LightTrav RenderTrav.LightingSystemEnabled= _LightingSystemEnabled; LightTrav.LightingSystemEnabled= _LightingSystemEnabled; }

void NL3D::CScene::enableShadowPolySmooth (  bool  enable  )

Enable Polygon Smoothing. Definition at line 1234 of file scene.cpp. References NL3D::CShadowMapManager::enableShadowPolySmooth(), and NL3D::CRenderTrav::getShadowMapManager(). Referenced by NL3D::CSceneUser::enableShadowPolySmooth(). { RenderTrav.getShadowMapManager().enableShadowPolySmooth(enable); }

void NL3D::CScene::eraseSkeletonModelToList (  ItSkeletonModelList  it  )

Definition at line 968 of file scene.cpp. References _SkeletonModelList, and ItSkeletonModelList. Referenced by NL3D::CSkeletonModel::~CSkeletonModel(). { _SkeletonModelList.erase(it); }

void NL3D::CScene::findCameraClusterSystemFromRay (  CCamera *  cam, CInstanceGroup *  startClusterSystem, const NLMISC::CVector &  startPos, const NLMISC::CVector &  endPos )

Special For Camera Third person. Traverse the ClusterSystem with a Ray (clip through portals, cluster system hierarchy...), to find where could lies the camera at End point. As result, a camera->setClusterSystem() is done with the found cluster system Definition at line 1268 of file scene.cpp. References NL3D::CClipTrav::Accel, NL3D::CQuadGrid< CCluster * >::begin(), NL3D::CQuadGrid< CCluster * >::end(), getClipTrav(), NL3D::CTransform::getClusterSystem(), NL3D::CInstanceGroup::getParentClusterSystem(), NL3D::CCluster::Group, NL3D::CCluster::isIn(), level, NL3D::CQuadGrid< CCluster * >::select(), NL3D::CTransform::setClusterSystem(), and uint. Referenced by NL3D::CSceneUser::findCameraClusterSystemFromRay(). { CClipTrav &clipTrav= getClipTrav(); // **** Search all cluster where the startPos is in static vector<CCluster*> vCluster; vCluster.clear(); bool bInWorld = true; clipTrav.Accel.select (startPos, startPos); CQuadGrid<CCluster*>::CIterator itAcc = clipTrav.Accel.begin(); while (itAcc != clipTrav.Accel.end()) { CCluster *pCluster = *itAcc; if( pCluster->Group == startClusterSystem && pCluster->isIn (startPos) ) { vCluster.push_back (pCluster); bInWorld = false; } ++itAcc; } if (bInWorld) { vCluster.push_back (RootCluster); } // **** Do a traverse starting from each start cluser, clipping the ray instead of the camera pyramid uint i; static vector<CCluster*> vClusterVisited; vClusterVisited.clear(); for(i=0;i<vCluster.size();i++) { vCluster[i]->cameraRayClip(startPos, endPos, vClusterVisited); } // **** From each cluster, select possible clusterSystem static vector<CInstanceGroup*> possibleClusterSystem; possibleClusterSystem.clear(); for(i=0;i<vClusterVisited.size();i++) { // select only cluster where the EndPos lies in. Important else in landscape, we'll always say // that we are in a Son Cluster. if(vClusterVisited[i]->isIn(endPos)) { CInstanceGroup *cs= vClusterVisited[i]->Group; // insert if not exist (NB: 1,2 possible clusterSystem so O(N2) is OK) uint j; for(j=0;j<possibleClusterSystem.size();j++) { if(possibleClusterSystem[j]==cs) break; } if(j==possibleClusterSystem.size()) possibleClusterSystem.push_back(cs); } } // **** From each possible clusterSystem, select the one that is the lower in hierarchy // common case if(possibleClusterSystem.empty()) cam->setClusterSystem(NULL); else if(possibleClusterSystem.size()==1) { // if it is the rootCluster set NULL (should have the same behavior but do like standard case) if(possibleClusterSystem[0]==RootCluster->getClusterSystem()) cam->setClusterSystem(NULL); // set this cluster system else cam->setClusterSystem(possibleClusterSystem[0]); } // conflict case else { // compute the hierarchy level of each cluster system, take the highest CInstanceGroup *highest= NULL; uint highestLevel= 0; for(i=0;i<possibleClusterSystem.size();i++) { uint level= 0; CInstanceGroup *ig= possibleClusterSystem[i]; while(ig) { ig= ig->getParentClusterSystem(); level++; } if(level>=highestLevel) { highestLevel= level; highest= possibleClusterSystem[i]; } } // set the highest cluster system cam->setClusterSystem(highest); } }

NLMISC::CRGBA NL3D::CScene::getAmbientGlobal (   )  const

get the global Ambient used for the scene. Default to (50, 50, 50). Definition at line 867 of file scene.cpp. References NL3D::CRenderTrav::AmbientGlobal. Referenced by NL3D::CSceneUser::getAmbientGlobal(). { return RenderTrav.AmbientGlobal; }

NLMISC::CRGBA NL3D::CScene::getAnimatedLightFactor (  sint  animatedLightmap, uint  lightGroup )  const [inline]

get an animated light factor. Definition at line 418 of file scene.h. References _AnimatedLightPtr, getLightmapGroupColor(), sint, and uint. Referenced by NL3D::CPointLightNamedArray::setPointLightFactor(), and NL3D::CMeshBaseInstance::traverseAnimDetail(). { if (((uint)animatedLightmap)<_AnimatedLightPtr.size ()) { return _AnimatedLightPtr[animatedLightmap]->getFactor (lightGroup); } else { return getLightmapGroupColor (lightGroup); } }

sint NL3D::CScene::getAnimatedLightNameToIndex (  const std::string &  name  )  const

get an animated lightmap index by name. Return -1 if not found. Definition at line 1101 of file scene.cpp. References _AnimatedLightNameToIndex, and sint. Referenced by NL3D::CPointLightNamedArray::initAnimatedLightIndex(), and NL3D::CMeshBaseInstance::initAnimatedLightIndex(). { std::map<std::string, uint>::const_iterator ite = _AnimatedLightNameToIndex.find (name); if (ite != _AnimatedLightNameToIndex.end ()) return (sint)ite->second; else return -1; }

CAnimDetailTrav& NL3D::CScene::getAnimDetailTrav (   )  [inline]

Definition at line 477 of file scene.h. References AnimDetailTrav. Referenced by NL3D::CClipTrav::clipSkeletonShadowMaps(), NL3D::CParticleSystemModel::insertInVisibleList(), NL3D::CClipTrav::traverse(), and NL3D::CTransform::traverseClip(). {return AnimDetailTrav;}

CAsyncTextureManager* NL3D::CScene::getAsyncTextureManager (   )  const [inline]

Get the async texture manager. NULL if was not setuped. Definition at line 501 of file scene.h. Referenced by NL3D::CSkeletonModel::computeLodTexture(), NL3D::CMeshBaseInstance::releaseCurrentAsyncTextures(), and NL3D::CMeshBaseInstance::startAsyncTextureLoading(). {return _AsyncTextureManager;}

CAnimationSet* NL3D::CScene::getAutomaticAnimationSet (   )  const [inline]

Get a reference to the set of automatic animations. Definition at line 497 of file scene.h. References _AutomaticAnimationSet. { return _AutomaticAnimationSet; }

CCamera* NL3D::CScene::getCam (   )  [inline]

Special For Camera Third person. Traverse the ClusterSystem with a Ray (clip through portals, cluster system hierarchy...), to find where could lies the camera at End point. As result, a camera->setClusterSystem() is done with the found cluster system Definition at line 180 of file scene.h. References CurrentCamera. Referenced by NL3D::CCloudScapeUser::anim(), and NL3D::CCloudScapeUser::init(). {return CurrentCamera;}

CClipTrav& NL3D::CScene::getClipTrav (   )  [inline]

Definition at line 475 of file scene.h. References ClipTrav. Referenced by NL3D::CInstanceGroup::addToSceneWhenAllShapesLoaded(), NL3D::CWaterModel::clip(), NL3D::CTransformShape::clip(), NL3D::CLandscapeModel::clipAndRenderLandscape(), NL3D::CWaterModel::computeClippedPoly(), NL3D::CSkeletonModel::computeDisplayLodCharacterPriority(), NL3D::CWaterModel::computeSimpleClippedPoly(), NL3D::CParticleSystemModel::doAnimate(), findCameraClusterSystemFromRay(), NLSOUND::CClusteredSound::getRootCluster(), NLSOUND::CClusteredSound::init(), NL3D::CParticleSystemModel::insertInVisibleList(), NL3D::CQuadGridClipManager::linkModel(), NL3D::CQuadGridClipManager::profile(), NL3D::CSceneUser::profileQuadGridClipManager(), NL3D::CCluster::recursTraverseClip(), NL3D::CInstanceGroup::removeFromScene(), NL3D::CSkeletonModel::traverseAnimDetail(), NL3D::CParticleSystemModel::traverseAnimDetail(), NL3D::CTransform::traverseClip(), NL3D::CQuadGridClipManager::traverseClip(), NL3D::CParticleSystemModel::traverseClip(), NL3D::CLandscapeModel::traverseClip(), NLSOUND::CClusteredSound::update(), NL3D::CTransform::updateClipTravForAncestorSkeleton(), NL3D::CQuadGridClipManager::updateClustersFromCamera(), and NL3D::CTransform::~CTransform(). {return ClipTrav;}

uint8 NL3D::CScene::getCoarseMeshLightingUpdate (   )  const [inline]

see setCoarseMeshLightingUpdate() Definition at line 346 of file scene.h. References _CoarseMeshLightingUpdate, and uint8. Referenced by NL3D::CSceneUser::getCoarseMeshLightingUpdate(), and NL3D::CMeshMultiLod::renderCoarseMesh(). {return _CoarseMeshLightingUpdate;}

CCoarseMeshManager* NL3D::CScene::getCoarseMeshManager (   )  [inline]

see setCoarseMeshLightingUpdate() Definition at line 335 of file scene.h. References _CoarseMeshManager. Referenced by NL3D::CMeshMultiLod::instanciateCoarseMeshSpace(), NL3D::CMeshMultiLod::render(), NL3D::CSceneUser::setCoarseMeshManagerTexture(), and NL3D::CRenderTrav::traverse(). { return _CoarseMeshManager; }

double NL3D::CScene::getCurrentSystemTime (   )  const [inline]

System time is a time that always run (independent from the animation time that run only on animate()) It is updated at beginning of render() Definition at line 279 of file scene.h. References _GlobalSystemTime. Referenced by NL3D::CLandscapeModel::clipAndRenderLandscape(). {return _GlobalSystemTime;}

TGlobalAnimationTime NL3D::CScene::getCurrentTime (  void   )  const [inline]

get the current time of the scene, in second. It start from 0 (at the firt call of animate) Definition at line 271 of file scene.h. References NL3D::TGlobalAnimationTime. Referenced by NL3D::CLandscapeModel::clipAndRenderLandscape(), NL3D::CMeshVPWindTree::setupPerMesh(), NL3D::CSegRemanence::traverseAnimDetail(), and NL3D::CMeshBaseInstance::traverseHrc(). { return _CurrentTime ; }

IDriver * NL3D::CScene::getDriver (   )  const

Get the driver of render Traversal. Definition at line 579 of file scene.cpp. Referenced by NL3D::CCloudScapeUser::CCloudScapeUser(), NL3D::CWaterModel::clip(), createInstanceAsync(), NL3D::CLandscapeUser::flushTiles(), and NL3D::CParticleSystemShape::instanciatePS(). { return (const_cast<CScene*>(this))->RenderTrav.getDriver(); }

double NL3D::CScene::getEllapsedSystemTime (   )  const [inline]

get the ellapsed time (in second) between the last 2 calls of render(). Definition at line 282 of file scene.h. References _DeltaSystemTimeBetweenRender. { return _DeltaSystemTimeBetweenRender;}

TAnimationTime NL3D::CScene::getEllapsedTime (  void   )  const [inline]

get the ellapsed time (in second) between the last 2 calls of animate. Definition at line 274 of file scene.h. References NL3D::TAnimationTime. Referenced by NL3D::CClipTrav::clipSkeletonShadowMaps(), NL3D::CParticleSystemModel::doAnimate(), NL3D::CTargetAnimCtrl::execute(), NL3D::CSegRemanence::render(), and NL3D::CFlareModel::traverseRender(). { return _EllapsedTime ; }

bool NL3D::CScene::getEnableShadowPolySmooth (   )  const

get Enable Polygon Smoothing flag Definition at line 1240 of file scene.cpp. References NL3D::CShadowMapManager::getEnableShadowPolySmooth(), and NL3D::CRenderTrav::getShadowMapManager(). Referenced by NL3D::CSceneUser::getEnableShadowPolySmooth(). { return RenderTrav.getShadowMapManager().getEnableShadowPolySmooth(); }

uint32 NL3D::CScene::getFilterRenderFlags (   )  const [inline]

Definition at line 508 of file scene.h. References _FilterRenderFlags, and uint32. Referenced by NL3D::CMeshMultiLod::renderCoarseMesh(), NL3D::CShadowMapManager::selectShadowMapsToGenerate(), NL3D::CTransform::traverseClip(), and NL3D::CParticleSystemModel::traverseClip(). {return _FilterRenderFlags;}

uint NL3D::CScene::getFlareContext (   )  const [inline]

Definition at line 556 of file scene.h. References _FlareContext, and uint. Referenced by NL3D::CSceneUser::getFlareContext(), and NL3D::CFlareModel::traverseRender(). { return _FlareContext; }

CInstanceGroup* NL3D::CScene::getGlobalInstanceGroup (   )  [inline]

Definition at line 252 of file scene.h. References _GlobalInstanceGroup. Referenced by NL3D::CInstanceGroup::addToSceneWhenAllShapesLoaded(), and NL3D::CSceneUser::setToGlobalInstanceGroup(). { return _GlobalInstanceGroup; }

const CVector& NL3D::CScene::getGlobalWindDirection (   )  const [inline]

get the current windDirection Definition at line 467 of file scene.h. References _GlobalWindDirection. Referenced by NL3D::CSceneUser::getGlobalWindDirection(), and NL3D::CMeshVPWindTree::setupPerMesh(). {return _GlobalWindDirection;}

float NL3D::CScene::getGlobalWindPower (   )  const [inline]

get the current windPower Definition at line 462 of file scene.h. References _GlobalWindPower. Referenced by NL3D::CSceneUser::getGlobalWindPower(), and NL3D::CMeshVPWindTree::setupPerMesh(). {return _GlobalWindPower;}

uint NL3D::CScene::getGroupLoadMaxPolygon (  const std::string &  group  )

Get the number of faces wanted for a LoadBlancingGroup. The Group is created if did not exist. Definition at line 772 of file scene.cpp. References NL3D::CLoadBalancingTrav::getGroupNbFaceWanted(), LoadBalancingTrav, and uint. Referenced by NL3D::CSceneUser::getGroupLoadMaxPolygon(). { return LoadBalancingTrav.getGroupNbFaceWanted(group); }

float NL3D::CScene::getGroupNbFaceAsked (  const std::string &  group  )  const

Get the last face count asked from the instances before reduction. only for the given group return 0 if the Group does not exist. Definition at line 777 of file scene.cpp. References NL3D::CLoadBalancingTrav::getGroupNbFaceAsked(), and LoadBalancingTrav. Referenced by NL3D::CSceneUser::getGroupNbFaceAsked(). { return LoadBalancingTrav.getGroupNbFaceAsked(group); }

CHrcTrav& NL3D::CScene::getHrcTrav (   )  [inline]

Definition at line 474 of file scene.h. References HrcTrav. Referenced by NL3D::CInstanceGroup::addToSceneWhenAllShapesLoaded(), NL3D::CMeshMultiLod::renderCoarseMesh(), NL3D::CClipTrav::traverse(), NL3D::CWaterModel::traverseRender(), NL3D::CTransform::update(), and NL3D::CTransform::updateWorld(). {return HrcTrav;}

bool NL3D::CScene::getLayersRenderingOrder (   )  const

Definition at line 804 of file scene.cpp. References NL3D::CRenderTrav::getLayersRenderingOrder(). Referenced by NL3D::CSceneUser::getLayersRenderingOrder(). { return RenderTrav.getLayersRenderingOrder(); }

NLMISC::CRGBA NL3D::CScene::getLightmapGroupColor (  uint  lightGroup  )  const [inline]

get the color of a lightmap group. Definition at line 410 of file scene.h. References _LightGroupColor, and uint. Referenced by getAnimatedLightFactor(), NL3D::CPointLightNamedArray::setPointLightFactor(), and NL3D::CMeshBaseInstance::traverseAnimDetail(). { if (lightGroup<_LightGroupColor.size()) return _LightGroupColor[lightGroup]; else return CRGBA::White; }

float NL3D::CScene::getLightTransitionThreshold (   )  const

getLightTransitionThreshold() Definition at line 903 of file scene.cpp. References NL3D::CLightingManager::getLightTransitionThreshold(), NL3D::CLightTrav::LightingManager, and LightTrav. Referenced by NL3D::CSceneUser::getLightTransitionThreshold(). { return LightTrav.LightingManager.getLightTransitionThreshold(); }

CLightTrav& NL3D::CScene::getLightTrav (   )  [inline]

Definition at line 476 of file scene.h. References LightTrav. Referenced by NL3D::CLandscapeModel::clipAndRenderLandscape(), NL3D::CClipTrav::clipSkeletonShadowMaps(), NL3D::CPointLightModel::initModel(), NL3D::CClipTrav::traverse(), NL3D::CTransform::traverseClip(), NL3D::CTransform::traverseLight(), NL3D::CPointLightModel::traverseLight(), NL3D::CTransform::unfreezeHRC(), NL3D::CTransform::update(), and NL3D::CTransform::~CTransform(). {return LightTrav;}

CLoadBalancingTrav& NL3D::CScene::getLoadBalancingTrav (   )  [inline]

Definition at line 478 of file scene.h. References LoadBalancingTrav. Referenced by NL3D::CTransform::initModel(), NL3D::CParticleSystemModel::insertInVisibleList(), NL3D::CTransform::setLoadBalancingGroup(), NL3D::CClipTrav::traverse(), NL3D::CTransform::traverseClip(), NL3D::CTransformShape::traverseLoadBalancing(), NL3D::CMeshMultiLodInstance::traverseLoadBalancing(), and NL3D::CTransformShape::traverseLoadBalancingPass0(). {return LoadBalancingTrav;}

CLodCharacterManager* NL3D::CScene::getLodCharacterManager (   )  const [inline]

Get the LodCharacterManager. NULL if user did not set it. (done in DriverUser). Definition at line 349 of file scene.h. Referenced by NL3D::CSkeletonModel::computeLodTexture(), NL3D::CSceneUser::deleteCLodShapeBank(), NL3D::CSceneUser::getCLodAnimIdByName(), NL3D::CSceneUser::getCLodShapeIdByName(), NL3D::CSceneUser::loadCLodShapeBank(), NL3D::CSkeletonModel::renderCLod(), NL3D::CSceneUser::resetCLodManager(), NL3D::CSkeletonModel::setLodCharacterShape(), and NL3D::CRenderTrav::traverse(). {return _LodCharacterManager;}

uint NL3D::CScene::getMaxLightContribution (   )  const

setMaxLightContribution() Definition at line 894 of file scene.cpp. References NL3D::CLightingManager::getMaxLightContribution(), NL3D::CLightTrav::LightingManager, LightTrav, and uint. Referenced by NL3D::CSceneUser::getMaxLightContribution(). { return LightTrav.LightingManager.getMaxLightContribution(); }

uint NL3D::CScene::getMaxSkeletonsInNotCLodForm (   )  const [inline]

The mode of polygon balancing. PolygonBalancingOff => Models will be rendered with the number of faces they want to render. PolygonBalancingOn => Models will be rendered with the number of faces the LoadBalancing want. PolygonBalancingClamp => Same as PolygonBalancingOn, but factor <= 1, ie models won't be rendered with more face they want to render. Definition at line 329 of file scene.h. References _MaxSkeletonsInNotCLodForm, and uint. Referenced by NL3D::CSceneUser::getMaxSkeletonsInNotCLodForm(), and NL3D::CClipTrav::loadBalanceSkeletonCLod(). {return _MaxSkeletonsInNotCLodForm;}

float NL3D::CScene::getNbFaceAsked (   )  const

Get the last face count asked from the instances before reduction. It gets the sum of All groups. Definition at line 759 of file scene.cpp. References NL3D::CLoadBalancingTrav::getNbFaceAsked(), and LoadBalancingTrav. Referenced by NL3D::CSceneUser::getNbFaceAsked(). { return LoadBalancingTrav.getNbFaceAsked (); }

uint NL3D::CScene::getNumLightGroup (   )  const [inline]

get the number of light group. Definition at line 405 of file scene.h. References _LightGroupColor, and uint. { return _LightGroupColor.size (); }

uint64 NL3D::CScene::getNumRender (   )  const [inline]

get the number of time render has been called Definition at line 285 of file scene.h. References _NumRender, and uint64. Referenced by NL3D::CShadowMapManager::renderGenerate(), NL3D::CShadowMapManager::selectShadowMapsToGenerate(), and NL3D::CSegRemanence::traverseAnimDetail(). { return _NumRender; }

CParticleSystemManager & NL3D::CScene::getParticleSystemManager (   )

Get a ref. to the particle system manager. You shouldn't call this (has methods for private processing). Definition at line 810 of file scene.cpp. References _ParticleSystemManager. Referenced by NL3D::CParticleSystemModel::reallocRsc(), NL3D::CParticleSystemModel::releasePSPointer(), and NL3D::CParticleSystemModel::traverseClip(). { return _ParticleSystemManager; }

CScene::TPolygonBalancingMode NL3D::CScene::getPolygonBalancingMode (   )  const

Get the PolygonBalancingMode. Definition at line 792 of file scene.cpp. References LoadBalancingTrav, NL3D::CLoadBalancingTrav::PolygonBalancingMode, and uint. Referenced by NL3D::CSceneUser::getPolygonBalancingMode(). { return (CScene::TPolygonBalancingMode)(uint)LoadBalancingTrav.PolygonBalancingMode; }

CRenderTrav& NL3D::CScene::getRenderTrav (   )  [inline]

Definition at line 479 of file scene.h. Referenced by NL3D::CMeshVPWindTree::begin(), NL3D::CMeshVPPerPixelLight::begin(), NL3D::CMeshVPWindTree::beginMBRInstance(), NL3D::CLandscapeModel::clipAndRenderLandscape(), NL3D::CClipTrav::clipSkeletonShadowMaps(), NL3D::CWaterModel::doSimpleRender(), NL3D::CSkeletonModel::generateShadowMap(), NL3D::CMeshInstance::generateShadowMap(), NL3D::CTransformShape::profileRender(), NL3D::CLandscapeModel::receiveShadowMap(), NL3D::CMeshMRMSkinnedGeom::render(), NL3D::CMeshMRMGeom::render(), NL3D::CMeshGeom::render(), NL3D::CSkeletonModel::renderCLod(), NL3D::CShadowMapManager::renderGenerate(), NL3D::CSkeletonModel::renderIntoSkeletonShadowMap(), NL3D::CMeshInstance::renderIntoSkeletonShadowMap(), NL3D::CShadowMapManager::renderProject(), NL3D::CSkeletonModel::renderShadowSkins(), NL3D::CMeshMRMGeom::renderSkin(), NL3D::CMeshGeom::renderSkin(), NL3D::CMeshMRMSkinnedGeom::renderSkinGroupGeom(), NL3D::CMeshMRMGeom::renderSkinGroupGeom(), NL3D::CMeshMRMSkinnedGeom::renderSkinGroupPrimitives(), NL3D::CMeshMRMGeom::renderSkinGroupPrimitives(), NL3D::CMeshMRMSkinnedGeom::renderSkinGroupSpecularRdrPass(), NL3D::CMeshMRMGeom::renderSkinGroupSpecularRdrPass(), NL3D::CSkeletonModel::renderSkinList(), NL3D::CSkeletonModel::renderSkins(), NL3D::CShadowMapManager::selectShadowMapsToGenerate(), NL3D::SetupForMaterial(), NL3D::CMeshVPPerPixelLight::setupForMaterial(), NL3D::CMeshVPWindTree::setupLighting(), NL3D::CClipTrav::traverse(), NL3D::CParticleSystemModel::traverseAnimDetail(), NL3D::CTransform::traverseClip(), NL3D::CWaterModel::traverseRender(), NL3D::CVegetableBlendLayerModel::traverseRender(), NL3D::CTransformShape::traverseRender(), NL3D::CMeshInstance::traverseRender(), NL3D::CLandscapeModel::traverseRender(), and NL3D::CFlareModel::traverseRender(). {return RenderTrav;}

CTransform* NL3D::CScene::getRoot (   )  const [inline]

Get the Root For Hrc and Basics Clip of the scene. Definition at line 482 of file scene.h. References Root. Referenced by NL3D::CInstanceGroup::addToSceneWhenAllShapesLoaded(), NL3D::CSkeletonModel::detachSkeletonSon(), NL3D::CLandscapeModel::initModel(), NL3D::CTransform::setForceClipRoot(), NL3D::CHrcTrav::traverse(), NL3D::CClipTrav::traverse(), NL3D::CTransform::unfreezeHRC(), and NL3D::CTransform::updateClipTravForAncestorSkeleton(). {return Root;}

CCluster* NL3D::CScene::getRootCluster (   )  const [inline]

Get the RootCluster For Clip of the scene. Definition at line 484 of file scene.h. Referenced by NL3D::CLandscapeModel::initModel(). {return RootCluster;}

uint NL3D::CScene::getShadowMapBlurSize (   )  const [inline]

get the size of the blur (<=3 means number of fakeBlur). Definition at line 571 of file scene.h. References _ShadowMapBlurSize, and uint. Referenced by NL3D::CSceneUser::getShadowMapBlurSize(), and NL3D::CShadowMapManager::renderGenerate(). {return _ShadowMapBlurSize;}

float NL3D::CScene::getShadowMapDistFadeEnd (   )  const [inline]

Enable Polygon Smoothing. Definition at line 584 of file scene.h. References _ShadowMapDistFadeEnd. Referenced by NL3D::CClipTrav::clipSkeletonShadowMaps(), and NL3D::CSceneUser::getShadowMapDistFadeEnd(). {return _ShadowMapDistFadeEnd;}

float NL3D::CScene::getShadowMapDistFadeStart (   )  const [inline]

Enable Polygon Smoothing. Definition at line 581 of file scene.h. References _ShadowMapDistFadeStart. Referenced by NL3D::CClipTrav::clipSkeletonShadowMaps(), and NL3D::CSceneUser::getShadowMapDistFadeStart(). {return _ShadowMapDistFadeStart;}

uint NL3D::CScene::getShadowMapMaxCasterAround (   )  const [inline]

Enable Polygon Smoothing. Definition at line 590 of file scene.h. References _ShadowMapMaxCasterAround, and uint. Referenced by NL3D::CClipTrav::clipSkeletonShadowMaps(), and NL3D::CSceneUser::getShadowMapMaxCasterAround(). {return _ShadowMapMaxCasterAround;}

uint NL3D::CScene::getShadowMapMaxCasterInScreen (   )  const [inline]

Enable Polygon Smoothing. Definition at line 587 of file scene.h. References _ShadowMapMaxCasterInScreen, and uint. Referenced by NL3D::CClipTrav::clipSkeletonShadowMaps(), and NL3D::CSceneUser::getShadowMapMaxCasterInScreen(). {return _ShadowMapMaxCasterInScreen;}

float NL3D::CScene::getShadowMapMaxDepth (   )  const [inline]

return the current ShadowMap Max Depth. This is the length in the lightDir direction where the shadow can touch receivers Definition at line 567 of file scene.h. References _ShadowMapMaxDepth. Referenced by NL3D::CShadowMap::buildProjectionInfos(), NL3D::CClipTrav::clipSkeletonShadowMaps(), and NL3D::CSceneUser::getShadowMapMaxDepth(). {return _ShadowMapMaxDepth;}

uint NL3D::CScene::getShadowMapTextureSize (   )  const [inline]

return the current base ShadowMap TextureSize. Default is 64 texels. Definition at line 563 of file scene.h. References _ShadowMapTextureSize, and uint. Referenced by NL3D::CShadowMapManager::garbageShadowTextures(), NL3D::CSceneUser::getShadowMapTextureSize(), NL3D::CShadowMapManager::renderGenerate(), NL3D::CSkeletonModel::updateShadowMap(), and NL3D::CMeshInstance::updateShadowMap(). {return _ShadowMapTextureSize;}

const CShapeBank* NL3D::CScene::getShapeBank (  void   )  const [inline]

Get the shape bank (const version). Definition at line 234 of file scene.h. { return _ShapeBank ; }

CShapeBank* NL3D::CScene::getShapeBank (  void   )  [inline]

Get the shape bank. Definition at line 231 of file scene.h. Referenced by NL3D::CPSMesh::newElement(), NL3D::CInstanceGroup::stopAddToSceneAsync(), and NL3D::CPSConstraintMesh::update(). { return _ShapeBank ; }

ItSkeletonModelList NL3D::CScene::getSkeletonModelListBegin (   )  [inline]

Definition at line 518 of file scene.h. References _SkeletonModelList, and ItSkeletonModelList. Referenced by NL3D::CClipTrav::clipSkeletonShadowMaps(), NL3D::CClipTrav::loadBalanceSkeletonCLod(), and NL3D::CClipTrav::traverse(). {return _SkeletonModelList.begin();}

ItSkeletonModelList NL3D::CScene::getSkeletonModelListEnd (   )  [inline]

Definition at line 519 of file scene.h. References _SkeletonModelList, and ItSkeletonModelList. Referenced by NL3D::CClipTrav::clipSkeletonShadowMaps(), NL3D::CClipTrav::loadBalanceSkeletonCLod(), and NL3D::CClipTrav::traverse(). {return _SkeletonModelList.end();}

NLMISC::CRGBA NL3D::CScene::getSunAmbient (   )  const

get the Ambient of the Sun used for the scene. Definition at line 871 of file scene.cpp. References NL3D::CRenderTrav::SunAmbient. Referenced by NL3D::CLandscapeModel::clipAndRenderLandscape(), NL3D::CShadowMapManager::computeShadowColors(), NL3D::CMeshMultiLodInstance::getCoarseMeshLighting(), NL3D::CSceneUser::getSunAmbient(), NL3D::CSkeletonModel::renderCLod(), and NL3D::CParticleSystemModel::traverseRender(). { return RenderTrav.SunAmbient; }

NLMISC::CRGBA NL3D::CScene::getSunDiffuse (   )  const

get the Diffuse of the Sun used for the scene. Definition at line 875 of file scene.cpp. References NL3D::CRenderTrav::SunDiffuse. Referenced by NL3D::CLandscapeModel::clipAndRenderLandscape(), NL3D::CShadowMapManager::computeShadowColors(), NL3D::CShadowMapManager::computeShadowDirection(), NL3D::CMeshMultiLodInstance::getCoarseMeshLighting(), NL3D::CSceneUser::getSunDiffuse(), NL3D::CSkeletonModel::renderCLod(), and NL3D::CParticleSystemModel::traverseRender(). { return RenderTrav.SunDiffuse; }

NLMISC::CVector NL3D::CScene::getSunDirection (   )  const

get the Direction of the Sun used for the scene. Definition at line 883 of file scene.cpp. References NL3D::CRenderTrav::getSunDirection(). Referenced by NL3D::CLandscapeModel::clipAndRenderLandscape(), NL3D::CShadowMapManager::computeShadowDirection(), NL3D::CSceneUser::getSunDirection(), and NL3D::CSkeletonModel::renderCLod(). { return RenderTrav.getSunDirection(); }

NLMISC::CRGBA NL3D::CScene::getSunSpecular (   )  const

get the Specular of the Sun used for the scene. Definition at line 879 of file scene.cpp. References NL3D::CRenderTrav::SunSpecular. Referenced by NL3D::CSceneUser::getSunSpecular(). { return RenderTrav.SunSpecular; }

CViewport NL3D::CScene::getViewport (   )  [inline]

Special For Camera Third person. Traverse the ClusterSystem with a Ray (clip through portals, cluster system hierarchy...), to find where could lies the camera at End point. As result, a camera->setClusterSystem() is done with the found cluster system Definition at line 185 of file scene.h. Referenced by NL3D::CSceneUser::getViewport(). { return _Viewport; }

IWaterSurfaceAddedCallback* NL3D::CScene::getWaterCallback (   )  const [inline]

Definition at line 594 of file scene.h. References _WaterCallback. Referenced by NL3D::CWaterShape::createInstance(), and NL3D::CSceneUser::getWaterCallback(). { return _WaterCallback; }

void NL3D::CScene::incrementProfileTriVBFormat (  std::map< uint32, uint32 > &  formatToTri, uint32  vbFormat, uint32  numTris )  [inline]

Definition at line 533 of file scene.h. References uint32. Referenced by NL3D::CMeshMRMSkinnedGeom::profileSceneRender(), NL3D::CMeshMRMGeom::profileSceneRender(), and NL3D::CMeshGeom::profileSceneRender(). { std::map<uint32, uint32>::iterator it= formatToTri.find(vbFormat); if(it==formatToTri.end()) { it= formatToTri.insert(std::make_pair(vbFormat,0)).first; } it->second+= numTris; }

void NL3D::CScene::initDefaultRoots (   )

Create/setRoot the defaults models roots: a CTransform and a CLightGroup. Definition at line 249 of file scene.cpp. References _GlobalInstanceGroup, NL3D::CInstanceGroup::addCluster(), NL3D::CTransform::clipDelChild(), ClipTrav, NL3D::ClusterId, createModel(), NL3D::CTransform::freeze(), NL3D::CCluster::Group, NL3D::CTransform::hrcUnlink(), NL3D::CCluster::Name, Root, NL3D::CClipTrav::RootCluster, NL3D::RootModelId, SonsOfAncestorSkeletonModelGroup, and NL3D::TransformId. Referenced by NL3D::CSceneUser::CSceneUser(), and NL3D::CLodCharacterBuilder::setShape(). { // Create and set root the default models. Root= static_cast<CTransform*>(createModel(TransformId)); // The root is always freezed (never move). Root->freeze(); // Init the instance group that represent the world _GlobalInstanceGroup = new CInstanceGroup; RootCluster= (CCluster*)createModel (ClusterId); // unlink from hrc. RootCluster->hrcUnlink(); RootCluster->Name = "ClusterRoot"; RootCluster->Group = _GlobalInstanceGroup; _GlobalInstanceGroup->addCluster (RootCluster); // init the ClipTrav.RootCluster. ClipTrav.RootCluster = RootCluster; // Create a SonsOfAncestorSkeletonModelGroup, for models which have a skeleton ancestor SonsOfAncestorSkeletonModelGroup= static_cast<CRootModel*>(createModel(RootModelId)); // must unlink it from all traversals, because special, only used in CClipTrav::traverse() SonsOfAncestorSkeletonModelGroup->hrcUnlink(); Root->clipDelChild(SonsOfAncestorSkeletonModelGroup); }

void NL3D::CScene::initQuadGridClipManager (   )

init QuadGridClipManager Definition at line 277 of file scene.cpp. References NL3D::CTransform::clipAddChild(), NL3D::CTransform::clipUnlinkFromAll(), createModel(), NL3D::CTransform::hrcUnlink(), NL3D::CQuadGridClipManager::init(), NL3D_QuadGridClipClusterSize, NL3D_QuadGridClipManagerRadiusMax, NL3D_QuadGridClipMaxDist, NL3D_QuadGridClipNumDist, and NL3D::QuadGridClipManagerId. Referenced by NL3D::CSceneUser::CSceneUser(), and NL3D::CLodCharacterBuilder::setShape(). { // Init clip features. if( !_QuadGridClipManager ) { // create the model _QuadGridClipManager= static_cast<CQuadGridClipManager*>(createModel(QuadGridClipManagerId)); // unlink it from hrc, and link it only to RootCluster. // NB: hence the quadGridClipManager may be clipped by the cluster system _QuadGridClipManager->hrcUnlink(); _QuadGridClipManager->clipUnlinkFromAll(); RootCluster->clipAddChild(_QuadGridClipManager); // init _QuadGridClipManager. _QuadGridClipManager->init(NL3D_QuadGridClipClusterSize, NL3D_QuadGridClipNumDist, NL3D_QuadGridClipMaxDist, NL3D_QuadGridClipManagerRadiusMax); } }

bool NL3D::CScene::isLightingSystemEnabled (   )  const [inline]

see enableLightingSystem Definition at line 378 of file scene.h. References _LightingSystemEnabled. Referenced by NL3D::CLandscapeModel::clipAndRenderLandscape(). {return _LightingSystemEnabled;}

bool NL3D::CScene::isNextRenderProfile (   )  const [inline]

Definition at line 528 of file scene.h. References _NextRenderProfile. Referenced by NL3D::CRenderTrav::traverse(). {return _NextRenderProfile;}

void NL3D::CScene::profileNextRender (   )

Misc. Definition at line 1204 of file scene.cpp. References _NextRenderProfile, BenchRes, and NL3D::UScene::CBenchResults::reset(). Referenced by NL3D::CSceneUser::profileNextRender(). { _NextRenderProfile= true; // Reset All Stats. BenchRes.reset(); }

void NL3D::CScene::registerBasics (   )  [static]

Register Basic models. Definition at line 104 of file scene.cpp. { CTransform::registerBasic(); CCamera::registerBasic(); CMeshBaseInstance::registerBasic(); CMeshInstance::registerBasic(); CMeshMRMInstance::registerBasic(); CMeshMRMSkinnedInstance::registerBasic(); CLandscapeModel::registerBasic(); CTransformShape::registerBasic(); CSkeletonModel::registerBasic(); CParticleSystemModel::registerBasic() ; CMeshMultiLodInstance::registerBasic(); CCluster::registerBasic(); CFlareModel::registerBasic(); CWaterModel::registerBasic(); CWaveMakerModel::registerBasic(); CVegetableBlendLayerModel::registerBasic(); CRootModel::registerBasic(); CPointLightModel::registerBasic(); CSegRemanence::registerBasic(); CQuadGridClipManager::registerBasic(); }

void NL3D::CScene::registerModel (  const NLMISC::CClassId &  idModel, const NLMISC::CClassId &  idModelBase, CTransform *(*  creator)() )  [static]

Register a model, indicating from which he derive. Parameters: idModel  the Unique Id of the registered model idModelBase  the Unique Id of the base calss of the registered model creator  the function which create the registered model. Definition at line 986 of file scene.cpp. References _RegModels, NL3D::CScene::CModelEntry::BaseModelId, NL3D::CScene::CModelEntry::Creator, NL3D::CScene::CModelEntry::ModelId, and nlassert. { nlassert(idModel!=CClassId::Null); nlassert(creator); // idModelBase may be Null... CModelEntry e; e.BaseModelId= idModelBase; e.ModelId= idModel; e.Creator= creator; // Insert/replace e. _RegModels.erase(e); _RegModels.insert(e); }

void NL3D::CScene::release (   )

Release all relative to the scene (Models, traversals...)... Destroy the Basic traversals too. The Lod Character Manager is reset() ed, but not deleted (at dtor only). Definition at line 194 of file scene.cpp. References _CoarseMeshManager, _GlobalInstanceGroup, _LMAnimsAuto, _Models, _UpdateModelList, ClipTrav, CurrentCamera, NL3D::CPlayListManager::deleteAll(), deleteModel(), NL3D::CLodCharacterManager::reset(), NL3D::CQuadGridClipManager::reset(), Root, NL3D::CClipTrav::setQuadGridClipManager(), and SonsOfAncestorSkeletonModelGroup. Referenced by NL3D::CLodCharacterBuilder::~CLodCharacterBuilder(), ~CScene(), and NL3D::CSceneUser::~CSceneUser(). { // terminate async loading CAsyncFileManager::terminate(); // reset the _QuadGridClipManager, => unlink models, and delete clusters. if( _QuadGridClipManager ) _QuadGridClipManager->reset(); // First, delete models set<CTransform*>::iterator it; it= _Models.begin(); while( it!=_Models.end()) { deleteModel(*it); it= _Models.begin(); } // No models at all. _UpdateModelList= NULL; // reset ptrs _ShapeBank = NULL; Root= NULL; RootCluster= NULL; SonsOfAncestorSkeletonModelGroup= NULL; CurrentCamera= NULL; _QuadGridClipManager= NULL; ClipTrav.setQuadGridClipManager(NULL); // reset the _LodCharacterManager if(_LodCharacterManager) _LodCharacterManager->reset(); // delete the coarseMeshManager if(_CoarseMeshManager) { delete _CoarseMeshManager; _CoarseMeshManager= NULL; } if(_GlobalInstanceGroup) { delete _GlobalInstanceGroup; _GlobalInstanceGroup = NULL; } // delete the play list _LMAnimsAuto.deleteAll(); }

void NL3D::CScene::removeInstanceGroupForLightAnimation (  CInstanceGroup *  ig  )

Remove an IG for auto PointLight Factor animation. called by CInstanceGroup::removeFromScene(). Definition at line 918 of file scene.cpp. References _AnimatedIgSet, ItAnimatedIgSet, and nlassert. Referenced by NL3D::CInstanceGroup::removeFromScene(). { nlassert( ig ); ItAnimatedIgSet itIg= _AnimatedIgSet.find(ig); if ( itIg != _AnimatedIgSet.end() ) _AnimatedIgSet.erase(itIg); }

void NL3D::CScene::render (  bool  doHrcPass = true  )

Render the scene, from the CurrentCamera view. This also update waiting instance that are loaded asynchronously (by calling updateWaitingInstances) NB: no Driver clear buffers (color or ZBuffer) are done.... This call t->traverse() function to registered render traversal following their order given. Parameters: doHrcPass  set it to false to indicate that the CHrcTrav have not to be traversed. UseFull to optimize if you know that NONE of your models have moved (a good example is a shoot of the scene from different cameras). Particle system handling (remove the resources of those which are too far, as their clusters may not have been parsed). Note that only a few of them are tested at each call Definition at line 300 of file scene.cpp. References _DeltaSystemTimeBetweenRender, _GlobalSystemTime, _NextRenderProfile, _NumRender, _ParticleSystemManager, AnimDetailTrav, NL3D::CClipTrav::Camera, NL3D::CTravCameraScene::CamPos, NLMISC::clamp(), ClipTrav, CurrentCamera, HrcTrav, LightTrav, LoadBalancingTrav, nlassert, NL3D::CParticleSystemManager::processAnimate(), NL3D::CParticleSystemManager::refreshModels(), NL3D::CTravCameraScene::setCamMatrix(), NL3D::CTravCameraScene::setFrustum(), NL3D::CClipTrav::setQuadGridClipManager(), NL3D::CRenderTrav::setViewport(), NLMISC::CTime::ticksToSecond(), NL3D::CRenderTrav::traverse(), NL3D::CLightTrav::traverse(), NL3D::CLoadBalancingTrav::traverse(), NL3D::CAnimDetailTrav::traverse(), NL3D::CClipTrav::traverse(), NL3D::CHrcTrav::traverse(), updateModels(), updateWaitingInstances(), and NL3D::CClipTrav::WorldFrustumPyramid. Referenced by NL3D::CSceneUser::render(). { double fNewGlobalSystemTime = NLMISC::CTime::ticksToSecond(NLMISC::CTime::getPerformanceTime()); _DeltaSystemTimeBetweenRender= fNewGlobalSystemTime - _GlobalSystemTime; _GlobalSystemTime = fNewGlobalSystemTime; // ++ _NumRender; // nlassert(CurrentCamera); // update models. updateModels(); // Use the camera to setup Clip / Render pass. float left, right, bottom, top, znear, zfar; CurrentCamera->getFrustum(left, right, bottom, top, znear, zfar); // setup basic camera. ClipTrav.setFrustum(left, right, bottom, top, znear, zfar, CurrentCamera->isPerspective()); RenderTrav.setFrustum (left, right, bottom, top, znear, zfar, CurrentCamera->isPerspective()); RenderTrav.setViewport (_Viewport); LoadBalancingTrav.setFrustum (left, right, bottom, top, znear, zfar, CurrentCamera->isPerspective()); // Set Infos for cliptrav. ClipTrav.Camera = CurrentCamera; ClipTrav.setQuadGridClipManager (_QuadGridClipManager); // **** For all render traversals, traverse them (except the Hrc one), in ascending order. if( doHrcPass ) HrcTrav.traverse(); // Set Cam World Matrix for all trav that need it ClipTrav.setCamMatrix(CurrentCamera->getWorldMatrix()); RenderTrav.setCamMatrix (CurrentCamera->getWorldMatrix()); LoadBalancingTrav.setCamMatrix (CurrentCamera->getWorldMatrix()); // clip ClipTrav.traverse(); // animDetail AnimDetailTrav.traverse(); // loadBalance LoadBalancingTrav.traverse(); // _ParticleSystemManager.processAnimate(_EllapsedTime); // deals with permanently animated particle systems // Light LightTrav.traverse(); // render RenderTrav.traverse(); // **** Misc. _ParticleSystemManager.refreshModels(ClipTrav.WorldFrustumPyramid, ClipTrav.CamPos); // Waiting Instance handling double deltaT = _DeltaSystemTimeBetweenRender; clamp (deltaT, 0.01, 0.1); updateWaitingInstances(deltaT); // Reset profiling _NextRenderProfile= false; /* uint64 total = PSStatsRegisterPSModelObserver + PSStatsRemovePSModelObserver + PSStatsUpdateOpacityInfos + PSStatsUpdateLightingInfos + PSStatsGetAABBox + PSStatsReallocRsc + PSStatsReleasePSPointer + PSStatsRefreshRscDeletion + PSStatsReleaseRsc + PSStatsReleaseRscAndInvalidate + PSStatsGetNumTriangles + PSStatsCheckAgainstPyramid + PSStatsTraverseAnimDetail + PSStatsDoAnimate + PSStatsTraverseRender + PSStatsTraverseClip + PSStatsCheckDestroyCondition + PSStatsForceInstanciate + PSStatsDoAnimatePart1 + PSStatsDoAnimatePart2 + PSStatsDoAnimatePart3 + PSStatsTraverseAnimDetailPart1 + PSStatsTraverseAnimDetailPart2 + PSStatsTraverseAnimDetailPart3 + PSStatsTraverseAnimDetailPart4 + PSAnim1 + PSAnim2+ PSAnim3+ PSAnim4+ PSAnim5+ PSAnim6+ PSAnim7+ PSAnim8+ PSAnim9+ PSAnim10+ PSAnim11; if (((double) total / (double) NLMISC::CSystemInfo::getProcessorFrequency()) > 0.01) { nlinfo("***** PS STATS ****"); #define PS_STATS(var) \ nlinfo("time for " #var " = %.2f", (float) (1000 * ((double) var / (double) CSystemInfo::getProcessorFrequency()))); PS_STATS(PSStatsRegisterPSModelObserver) PS_STATS(PSStatsRemovePSModelObserver) PS_STATS(PSStatsUpdateOpacityInfos) PS_STATS(PSStatsUpdateLightingInfos) PS_STATS(PSStatsGetAABBox) PS_STATS(PSStatsReallocRsc) PS_STATS(PSStatsReleasePSPointer) PS_STATS(PSStatsRefreshRscDeletion) PS_STATS(PSStatsReleaseRsc) PS_STATS(PSStatsReleaseRscAndInvalidate) PS_STATS(PSStatsGetNumTriangles) PS_STATS(PSStatsCheckAgainstPyramid) PS_STATS(PSStatsTraverseAnimDetail) PS_STATS(PSStatsDoAnimate) PS_STATS(PSStatsTraverseRender) PS_STATS(PSStatsTraverseClip) PS_STATS(PSStatsClipSystemInstanciated); PS_STATS(PSStatsClipSystemNotInstanciated); PS_STATS(PSStatsClipSystemCheckAgainstPyramid); PS_STATS(PSStatsInsertInVisibleList); PS_STATS(PSStatsCheckDestroyCondition) PS_STATS(PSStatsForceInstanciate) PS_STATS(PSStatsDoAnimatePart1) PS_STATS(PSStatsDoAnimatePart2) PS_STATS(PSStatsDoAnimatePart3) PS_STATS(PSStatsTraverseAnimDetailPart1) PS_STATS(PSStatsTraverseAnimDetailPart2) PS_STATS(PSStatsTraverseAnimDetailPart3) PS_STATS(PSStatsTraverseAnimDetailPart4) PS_STATS(PSAnim1) PS_STATS(PSAnim2) PS_STATS(PSAnim3) PS_STATS(PSAnim4) PS_STATS(PSAnim5) PS_STATS(PSAnim6) PS_STATS(PSAnim7) PS_STATS(PSAnim8) PS_STATS(PSAnim9) PS_STATS(PSAnim10) PS_STATS(PSAnim11) PS_STATS(PSStatsZonePlane) PS_STATS(PSStatsZoneSphere) PS_STATS(PSStatsZoneDisc) PS_STATS(PSStatsZoneRectangle) PS_STATS(PSStatsZoneCylinder) PS_STATS(PSMotion1) PS_STATS(PSMotion2) PS_STATS(PSMotion3) PS_STATS(PSMotion4) PS_STATS(PSStatCollision) PS_STATS(PSStatEmit) PS_STATS(PSStatRender) nlinfo("num do animate = %d", (int) PSStatsNumDoAnimateCalls); nlinfo("Max et = %.2f", PSMaxET); nlinfo("Max ps nb pass = %d", (int) PSMaxNBPass); PS_STATS(total) } PSStatsRegisterPSModelObserver = 0; PSStatsRemovePSModelObserver = 0; PSStatsUpdateOpacityInfos = 0; PSStatsUpdateLightingInfos = 0; PSStatsGetAABBox = 0; PSStatsReallocRsc = 0; PSStatsReleasePSPointer = 0; PSStatsRefreshRscDeletion = 0; PSStatsReleaseRsc = 0; PSStatsReleaseRscAndInvalidate = 0; PSStatsGetNumTriangles = 0; PSStatsCheckAgainstPyramid = 0; PSStatsTraverseAnimDetail = 0; PSStatsDoAnimate = 0; PSStatsTraverseRender = 0; PSStatsTraverseClip = 0; PSStatsCheckDestroyCondition = 0; PSStatsForceInstanciate = 0; PSStatsClipSystemInstanciated = 0; PSStatsClipSystemNotInstanciated = 0; PSStatsClipSystemCheckAgainstPyramid = 0; PSStatsInsertInVisibleList = 0; PSStatsDoAnimatePart1 = 0; PSStatsDoAnimatePart2 = 0; PSStatsDoAnimatePart3 = 0; PSStatsTraverseAnimDetailPart1 = 0; PSStatsTraverseAnimDetailPart2 = 0; PSStatsTraverseAnimDetailPart3 = 0; PSStatsTraverseAnimDetailPart4 = 0; PSStatsNumDoAnimateCalls = 0; PSAnim1 = 0; PSAnim2 = 0; PSAnim3 = 0; PSAnim4 = 0; PSAnim5 = 0; PSAnim6 = 0; PSAnim7 = 0; PSAnim8 = 0; PSAnim9 = 0; PSAnim10 = 0; PSAnim11 = 0; PSMaxET = 0.f; PSMaxNBPass = 0; PSStatsZonePlane = 0; PSStatsZoneSphere = 0; PSStatsZoneDisc = 0; PSStatsZoneRectangle = 0; PSStatsZoneCylinder = 0; PSMotion1 = 0; PSMotion2 = 0; PSMotion3 = 0; PSMotion4 = 0; PSStatCollision = 0; PSStatEmit = 0; PSStatRender = 0; */ }

void NL3D::CScene::setAmbientGlobal (  NLMISC::CRGBA  ambient  )

set the global Ambient used for the scene. Default to (50, 50, 50). Definition at line 844 of file scene.cpp. References NL3D::CRenderTrav::AmbientGlobal. Referenced by NL3D::CSceneUser::setAmbientGlobal(). { RenderTrav.AmbientGlobal= ambient; }

void NL3D::CScene::setAsyncTextureManager (  CAsyncTextureManager *  mgr  )  [inline]

Set the async texture manager. Definition at line 503 of file scene.h. {_AsyncTextureManager= mgr;}

void NL3D::CScene::setAutomaticAnimationSet (  CAnimationSet *  as  )

set the automatic animation set used by this scene. It is stored as a smart pointer Definition at line 1112 of file scene.cpp. References _AnimatedLight, _AnimatedLightNameToIndex, _AnimatedLightPtr, _AutomaticAnimationSet, _LightGroupColor, _LMAnimsAuto, NL3D::CChannelMixer::addChannel(), NL3D::CPlayListManager::addPlaylist(), count, NL3D::CPlayListManager::deleteAll(), NL3D::CAnimatedLightmap::getDefaultTrack(), NL3D::CAnimatedLightmap::getName(), NL3D::CAnimation::getTrackNames(), NL3D::CAnimatedLightmap::getValue(), NL3D::CAnimationPlaylist::setAnimation(), NL3D::CChannelMixer::setAnimationSet(), NL3D::CAnimatedLightmap::setName(), NL3D::CAnimationPlaylist::setWrapMode(), and uint. Referenced by NL3D::CSceneUser::setAutomaticAnimationSet(). { // Backup the animation set _AutomaticAnimationSet = as; // Delete all auto lightmap animations _LMAnimsAuto.deleteAll(); _AnimatedLightNameToIndex.clear(); _AnimatedLight.clear(); _AnimatedLightPtr.clear(); _LightGroupColor.clear(); // Register each animation as lightmap const uint count = _AutomaticAnimationSet->getNumAnimation(); uint i; for (i=0; i<count; i++) { // Pointer on the animation CAnimation *pAnim = _AutomaticAnimationSet->getAnimation(i); /* uint nAnimNb; // Reset the automatic animation if no animation wanted if( pAnim == NULL ) { _AnimatedLight.clear(); _AnimatedLightPtr.clear(); _AnimatedLightNameToIndex.clear(); nAnimNb = _LightmapAnimations.getAnimationIdByName("Automatic"); if( nAnimNb != CAnimationSet::NotFound ) { CAnimation *anim = _LightmapAnimations.getAnimation( nAnimNb ); delete anim; } _LightmapAnimations.reset(); _LMAnimsAuto.deleteAll(); return; } */ set<string> setTrackNames; pAnim->getTrackNames( setTrackNames ); // nAnimNb = _LightmapAnimations.addAnimation( "Automatic", pAnim ); // _LightmapAnimations.build(); set<string>::iterator itSel = setTrackNames.begin(); while ( itSel != setTrackNames.end() ) { string ate = *itSel; if( strncmp( itSel->c_str(), "LightmapController.", 19 ) == 0 ) { // The light name const char *lightName = strrchr ((*itSel).c_str (), '.')+1; // Light animation doesn't exist ? if (_AnimatedLightNameToIndex.find (lightName) == _AnimatedLightNameToIndex.end()) { // Channel mixer for light anim CChannelMixer *cm = new CChannelMixer(); cm->setAnimationSet( _AutomaticAnimationSet ); // Add an automatic animation _AnimatedLight.push_back ( CAnimatedLightmap (_LightGroupColor.size ()) ); _AnimatedLightPtr.push_back ( &_AnimatedLight.back () ); _AnimatedLightNameToIndex.insert ( std::map<std::string, uint>::value_type (lightName, _AnimatedLightPtr.size ()-1 ) ); CAnimatedLightmap &animLM = _AnimatedLight.back (); animLM.setName( *itSel ); cm->addChannel( animLM.getName(), &animLM, animLM.getValue(CAnimatedLightmap::FactorValue), animLM.getDefaultTrack(CAnimatedLightmap::FactorValue), CAnimatedLightmap::FactorValue, CAnimatedLightmap::OwnerBit, false); // Animated lightmap playlist CAnimationPlaylist *pl = new CAnimationPlaylist(); pl->setAnimation( 0, i ); pl->setWrapMode( 0, CAnimationPlaylist::Repeat ); _LMAnimsAuto.addPlaylist(pl,cm); } } ++itSel; } } }

void NL3D::CScene::setCam (  CCamera *  cam  )  [inline]

Set/Get the current camera/Viewport. Definition at line 179 of file scene.h. References CurrentCamera. Referenced by NL3D::CSceneUser::setCam(), and NL3D::CSceneUser::~CSceneUser(). {CurrentCamera= cam;}

void NL3D::CScene::setCoarseMeshLightingUpdate (  uint8  period  )

Each coarseMesh lighting will be updated every "period" frame. clamped to 1,255 Definition at line 928 of file scene.cpp. References _CoarseMeshLightingUpdate, and uint8. Referenced by NL3D::CSceneUser::setCoarseMeshLightingUpdate(). { _CoarseMeshLightingUpdate= max((uint8)1, period); }

void NL3D::CScene::setDriver (  IDriver *  drv  )

Set the driver to render Traversal. Definition at line 573 of file scene.cpp. References NL3D::CRenderTrav::setDriver(). Referenced by NL3D::CSceneUser::CSceneUser(), and NL3D::CSceneUser::~CSceneUser(). { RenderTrav.setDriver(drv); }

void NL3D::CScene::setFlareContext (  uint  context  )  [inline]

Definition at line 554 of file scene.h. References _FlareContext, MaxNumFlareContexts, nlassert, and uint. Referenced by NL3D::CSceneUser::setFlareContext(). { nlassert(context < MaxNumFlareContexts); _FlareContext = context; }

void NL3D::CScene::setGlobalWindDirection (  const CVector &  gwd  )

Set the current windDirection for all the scene. dir.z set to 0 and vector normalized. Definition at line 946 of file scene.cpp. References _GlobalWindDirection, NLMISC::CVector::normalize(), and NLMISC::CVector::z. Referenced by NL3D::CSceneUser::setGlobalWindDirection(). { _GlobalWindDirection= gwd; _GlobalWindDirection.z= 0; _GlobalWindDirection.normalize(); }

void NL3D::CScene::setGlobalWindPower (  float  gwp  )

Weather mgt. Definition at line 941 of file scene.cpp. References _GlobalWindPower. Referenced by NL3D::CSceneUser::setGlobalWindPower(). { _GlobalWindPower= gwp; }

void NL3D::CScene::setGroupLoadMaxPolygon (  const std::string &  group, uint  nFaces )

Set the number of faces wanted for a LoadBlancingGroup. The Group is created if did not exist. Definition at line 766 of file scene.cpp. References LoadBalancingTrav, NL3D::CLoadBalancingTrav::setGroupNbFaceWanted(), and uint. Referenced by NL3D::CSceneUser::setGroupLoadMaxPolygon(). { nFaces= max(nFaces, (uint)1); LoadBalancingTrav.setGroupNbFaceWanted(group, nFaces); }

void NL3D::CScene::setLayersRenderingOrder (  bool  directOrder = true  )

Set the order or rendering for transparent objects. In real case, with direct order, we have: Underwater is rendered. Water is rendered. Objects above water are rendered. Definition at line 798 of file scene.cpp. References NL3D::CRenderTrav::setLayersRenderingOrder(). Referenced by NL3D::CSceneUser::setLayersRenderingOrder(). { RenderTrav.setLayersRenderingOrder(directOrder); }

void NL3D::CScene::setLightGroupColor (  uint  lightmapGroup, NLMISC::CRGBA  color )

set the color of a light group. Definition at line 1087 of file scene.cpp. References _LightGroupColor, and uint. Referenced by NL3D::CSceneUser::setLightGroupColor(). { // If too small, resize with white if (lightmapGroup >= _LightGroupColor.size ()) { _LightGroupColor.resize (lightmapGroup+1, CRGBA::White); } // Set the color _LightGroupColor[lightmapGroup] = color; }

void NL3D::CScene::setLightTransitionThreshold (  float  lightTransitionThreshold  )

Advanced. When a model is influenced by more light than allowed, or when it reach the limits of the light (attenuationEnd), the light can be darkened according to some threshold. The resultLightColor begin to fade when distModelToLight== attEnd- threshold*(attEnd-attBegin). when distModelToLight== 0, resultLightColor==Black. By default, this value is 0.1f. Setting higher values will smooth transition but will generally darken the global effects of lights. NB: clamp(value, 0, 1); Definition at line 899 of file scene.cpp. References NL3D::CLightTrav::LightingManager, LightTrav, and NL3D::CLightingManager::setLightTransitionThreshold(). Referenced by NL3D::CSceneUser::setLightTransitionThreshold(). { LightTrav.LightingManager.setLightTransitionThreshold(lightTransitionThreshold); }

void NL3D::CScene::setLodCharacterManager (  CLodCharacterManager *  m  )  [inline]

set the LodCharacterManager Definition at line 351 of file scene.h. {_LodCharacterManager= m;}

void NL3D::CScene::setMaxLightContribution (  uint  nlights  )

setup the max number of point light that can influence a model. NB: clamped by NL3D_MAX_LIGHT_CONTRIBUTION Default is 3. NB: the sun contribution is not taken into account Definition at line 890 of file scene.cpp. References NL3D::CLightTrav::LightingManager, LightTrav, NL3D::CLightingManager::setMaxLightContribution(), and uint. Referenced by NL3D::CSceneUser::setMaxLightContribution(). { LightTrav.LightingManager.setMaxLightContribution(nlights); }

void NL3D::CScene::setMaxSkeletonsInNotCLodForm (  uint  m  )  [inline]

LoadBalancing for CLod and Skeletons. Setup the max number of skeletons displayed in std way (ie not CLod). Default is 20. Definition at line 328 of file scene.h. References _MaxSkeletonsInNotCLodForm, and uint. Referenced by NL3D::CSceneUser::setMaxSkeletonsInNotCLodForm(). {_MaxSkeletonsInNotCLodForm= m;}

void NL3D::CScene::setPolygonBalancingMode (  TPolygonBalancingMode  polBalMode  )

Set the PolygonBalancingMode. Definition at line 785 of file scene.cpp. References LoadBalancingTrav, NL3D::CLoadBalancingTrav::PolygonBalancingMode, and uint. Referenced by NL3D::CSceneUser::setPolygonBalancingMode(). { LoadBalancingTrav.PolygonBalancingMode= (CLoadBalancingGroup::TPolygonBalancingMode)(uint)polBalMode; }

void NL3D::CScene::setShadowMapBlurSize (  uint  bs  )

set the size of the blur (<=3 means number of fakeBlur). Definition at line 1228 of file scene.cpp. References _ShadowMapBlurSize, and uint. Referenced by NL3D::CSceneUser::setShadowMapBlurSize(). { _ShadowMapBlurSize= bs; }

void NL3D::CScene::setShadowMapDistFadeEnd (  float  dist  )

ShadowMap Distance Fade end (50 default). Definition at line 1252 of file scene.cpp. References _ShadowMapDistFadeEnd. Referenced by NL3D::CSceneUser::setShadowMapDistFadeEnd(). { _ShadowMapDistFadeEnd= max(0.f, dist); }

void NL3D::CScene::setShadowMapDistFadeStart (  float  dist  )

ShadowMap Distance Fade Start (40 default). Definition at line 1247 of file scene.cpp. References _ShadowMapDistFadeStart. Referenced by NL3D::CSceneUser::setShadowMapDistFadeStart(). { _ShadowMapDistFadeStart= max(0.f, dist); }

void NL3D::CScene::setShadowMapMaxCasterAround (  uint  num  )

ShadowMap max Caster Around (optimize memory). Definition at line 1262 of file scene.cpp. References _ShadowMapMaxCasterAround, num, and uint. Referenced by NL3D::CSceneUser::setShadowMapMaxCasterAround(). { _ShadowMapMaxCasterAround= num; }

void NL3D::CScene::setShadowMapMaxCasterInScreen (  uint  num  )

ShadowMap max Caster In Screen (optimize CPU/GPU). Definition at line 1257 of file scene.cpp. References _ShadowMapMaxCasterInScreen, num, and uint. Referenced by NL3D::CSceneUser::setShadowMapMaxCasterInScreen(). { _ShadowMapMaxCasterInScreen= num; }

void NL3D::CScene::setShadowMapMaxDepth (  float  depth  )

set the ShadowMap Extent Definition at line 1222 of file scene.cpp. References _ShadowMapMaxDepth, and depth. Referenced by NL3D::CSceneUser::setShadowMapMaxDepth(). { _ShadowMapMaxDepth= depth; }

void NL3D::CScene::setShadowMapTextureSize (  uint  size  )

must be a power of 2. Definition at line 1214 of file scene.cpp. References _ShadowMapTextureSize, NLMISC::raiseToNextPowerOf2(), size, and uint. Referenced by NL3D::CSceneUser::setShadowMapTextureSize(). { size= max(size, 2U); size= raiseToNextPowerOf2(size); _ShadowMapTextureSize= size; }

void NL3D::CScene::setShapeBank (  CShapeBank *  pShapeBank  )

Set the shape bank. Definition at line 593 of file scene.cpp. { _ShapeBank = pShapeBank; }

void NL3D::CScene::setSunAmbient (  NLMISC::CRGBA  ambient  )

set the Ambient of the Sun used for the scene. Definition at line 848 of file scene.cpp. References NL3D::CRenderTrav::SunAmbient. Referenced by NL3D::CSceneUser::setSunAmbient(). { RenderTrav.SunAmbient= ambient; }

void NL3D::CScene::setSunDiffuse (  NLMISC::CRGBA  diffuse  )

set the Diffuse of the Sun used for the scene. Definition at line 852 of file scene.cpp. References NL3D::CRenderTrav::SunDiffuse. Referenced by NL3D::CSceneUser::setSunDiffuse(). { RenderTrav.SunDiffuse= diffuse; }

void NL3D::CScene::setSunDirection (  const NLMISC::CVector &  direction  )

set the Direction of the Sun used for the scene. Definition at line 860 of file scene.cpp. References NL3D::CRenderTrav::setSunDirection(). Referenced by NL3D::CSceneUser::setSunDirection(). { RenderTrav.setSunDirection(direction); }

void NL3D::CScene::setSunSpecular (  NLMISC::CRGBA  specular  )

set the Specular of the Sun used for the scene. Definition at line 856 of file scene.cpp. References NL3D::CRenderTrav::SunSpecular. Referenced by NL3D::CSceneUser::setSunSpecular(). { RenderTrav.SunSpecular= specular; }

void NL3D::CScene::setViewport (  const class CViewport &  viewport  )  [inline]

Special For Camera Third person. Traverse the ClusterSystem with a Ray (clip through portals, cluster system hierarchy...), to find where could lies the camera at End point. As result, a camera->setClusterSystem() is done with the found cluster system Definition at line 181 of file scene.h. Referenced by NL3D::CSceneUser::CSceneUser(), and NL3D::CSceneUser::setViewport(). { _Viewport=viewport; }

void NL3D::CScene::setWaterCallback (  IWaterSurfaceAddedCallback *  wcb  )  [inline]

Definition at line 593 of file scene.h. References _WaterCallback. Referenced by NL3D::CSceneUser::setWaterCallback(). { _WaterCallback = wcb; }

void NL3D::CScene::updateModels (   )  [private]

Update all models. All dirty models are cleaned. Definition at line 1067 of file scene.cpp. References NL3D::CTransform::_NextModelToUpdate, _UpdateModelList, and NL3D::CTransform::update(). Referenced by render(). { // check all the models which must be checked. CTransform *model= _UpdateModelList; CTransform *next; while( model ) { // next to update. get next now, because model->update() may remove model from the list. next= model->_NextModelToUpdate; // update the model. model->update(); // next. model= next; } }

void NL3D::CScene::updateWaitingInstances (  double  systemTimeEllapsed  )

Update instances that are loaded asynchronously Parameters: systemTimeEllapsed  : the time between 2 calls to updateWaitingInstances, in seconds Definition at line 537 of file scene.cpp. References _WaitingInstances, NL3D::CShapeBank::addRef(), NL3D::IShape::createInstance(), NL3D::CShapeBank::isPresent(), NL3D::CShapeBank::processWaitingShapes(), NL3D::CShapeBank::setMaxBytesToUpload(), and uint32. Referenced by render(), and NL3D::CSceneUser::updateWaitingInstances(). { // First set up max AGP upload double fMaxBytesToUp = 100 * 256 * 256 * systemTimeEllapsed; _ShapeBank->setMaxBytesToUpload ((uint32)fMaxBytesToUp); // Parse all the waiting instance _ShapeBank->processWaitingShapes (); // Process waiting shapes load shape, texture, and lightmaps // and upload all maps to VRAM pieces by pieces TWaitingInstancesMMap::iterator wimmIt = _WaitingInstances.begin(); while( wimmIt != _WaitingInstances.end() ) { CShapeBank::TShapeState st = _ShapeBank->isPresent (wimmIt->first); if (st == CShapeBank::AsyncLoad_Error) { // Delete the waiting instance - Nobody can be informed of that... TWaitingInstancesMMap::iterator itDel= wimmIt; ++wimmIt; _WaitingInstances.erase(itDel); } else if (st == CShapeBank::Present) { // Then create a reference to the shape *(wimmIt->second) = _ShapeBank->addRef(wimmIt->first)->createInstance (*this); // Delete the waiting instance TWaitingInstancesMMap::iterator itDel= wimmIt; ++wimmIt; _WaitingInstances.erase(itDel); } else // st == CShapeBank::NotPresent or loading { ++wimmIt; } } }

---

Friends And Related Function Documentation

friend class CClipTrav [friend]

Definition at line 735 of file scene.h.

friend class CTransform [friend]

Definition at line 734 of file scene.h.

---

Field Documentation

TAnimatedIgSet NL3D::CScene::_AnimatedIgSet [private]

Definition at line 653 of file scene.h. Referenced by addInstanceGroupForLightAnimation(), animate(), and removeInstanceGroupForLightAnimation().

std::list<CAnimatedLightmap> NL3D::CScene::_AnimatedLight [private]

Definition at line 642 of file scene.h. Referenced by setAutomaticAnimationSet().

std::map<std::string, uint> NL3D::CScene::_AnimatedLightNameToIndex [private]

Definition at line 641 of file scene.h. Referenced by getAnimatedLightNameToIndex(), and setAutomaticAnimationSet().

std::vector<CAnimatedLightmap*> NL3D::CScene::_AnimatedLightPtr [private]

Definition at line 643 of file scene.h. Referenced by animate(), getAnimatedLightFactor(), and setAutomaticAnimationSet().

CAsyncTextureManager* NL3D::CScene::_AsyncTextureManager [private]

Definition at line 703 of file scene.h.

NLMISC::CSmartPtr<CAnimationSet> NL3D::CScene::_AutomaticAnimationSet [private]

Definition at line 699 of file scene.h. Referenced by createInstance(), getAutomaticAnimationSet(), and setAutomaticAnimationSet().

uint8 NL3D::CScene::_CoarseMeshLightingUpdate [private]

set setCoarseMeshLightingUpdate Definition at line 683 of file scene.h. Referenced by CScene(), getCoarseMeshLightingUpdate(), and setCoarseMeshLightingUpdate().

CCoarseMeshManager* NL3D::CScene::_CoarseMeshManager [private]

Definition at line 668 of file scene.h. Referenced by CScene(), getCoarseMeshManager(), and release().

TGlobalAnimationTime NL3D::CScene::_CurrentTime [private]

Definition at line 603 of file scene.h.

double NL3D::CScene::_DeltaSystemTimeBetweenRender [private]

Definition at line 616 of file scene.h. Referenced by getEllapsedSystemTime(), and render().

TAnimationTime NL3D::CScene::_EllapsedTime [private]

Definition at line 613 of file scene.h.

uint32 NL3D::CScene::_FilterRenderFlags [private]

Definition at line 712 of file scene.h. Referenced by CScene(), enableElementRender(), and getFilterRenderFlags().

bool NL3D::CScene::_FirstAnimateCall [private]

Definition at line 610 of file scene.h. Referenced by animate(), and CScene().

uint NL3D::CScene::_FlareContext [private]

Definition at line 746 of file scene.h. Referenced by CScene(), getFlareContext(), and setFlareContext().

CInstanceGroup* NL3D::CScene::_GlobalInstanceGroup [private]

Definition at line 662 of file scene.h. Referenced by getGlobalInstanceGroup(), initDefaultRoots(), and release().

double NL3D::CScene::_GlobalSystemTime [private]

Definition at line 617 of file scene.h. Referenced by getCurrentSystemTime(), and render().

CVector NL3D::CScene::_GlobalWindDirection [private]

Definition at line 694 of file scene.h. Referenced by CScene(), getGlobalWindDirection(), and setGlobalWindDirection().

float NL3D::CScene::_GlobalWindPower [private]

Definition at line 693 of file scene.h. Referenced by CScene(), getGlobalWindPower(), and setGlobalWindPower().

TGlobalAnimationTime NL3D::CScene::_InitTime [private]

Definition at line 607 of file scene.h. Referenced by animate().

std::vector<NLMISC::CRGBA> NL3D::CScene::_LightGroupColor [private]

Definition at line 648 of file scene.h. Referenced by getLightmapGroupColor(), getNumLightGroup(), setAutomaticAnimationSet(), and setLightGroupColor().

bool NL3D::CScene::_LightingSystemEnabled [private]

Definition at line 680 of file scene.h. Referenced by CScene(), enableLightingSystem(), and isLightingSystemEnabled().

CPlayListManager NL3D::CScene::_LMAnimsAuto [private]

Definition at line 644 of file scene.h. Referenced by animate(), release(), and setAutomaticAnimationSet().

CLodCharacterManager* NL3D::CScene::_LodCharacterManager [private]

Definition at line 670 of file scene.h.

uint NL3D::CScene::_MaxSkeletonsInNotCLodForm [private]

Definition at line 709 of file scene.h. Referenced by CScene(), getMaxSkeletonsInNotCLodForm(), and setMaxSkeletonsInNotCLodForm().

std::set<CTransform*> NL3D::CScene::_Models [private]

Definition at line 737 of file scene.h. Referenced by createModel(), deleteModel(), and release().

bool NL3D::CScene::_NextRenderProfile [private]

Definition at line 715 of file scene.h. Referenced by CScene(), isNextRenderProfile(), profileNextRender(), and render().

uint64 NL3D::CScene::_NumRender [private]

Definition at line 618 of file scene.h. Referenced by CScene(), getNumRender(), and render().

CParticleSystemManager NL3D::CScene::_ParticleSystemManager [private]

Definition at line 687 of file scene.h. Referenced by getParticleSystemManager(), and render().

CQuadGridClipManager* NL3D::CScene::_QuadGridClipManager [private]

Definition at line 675 of file scene.h.

TGlobalAnimationTime NL3D::CScene::_RealTime [private]

Definition at line 606 of file scene.h. Referenced by animate(), and CScene().

set< CScene::CModelEntry > NL3D::CScene::_RegModels [static, private]

Definition at line 982 of file scene.cpp. Referenced by createModel(), and registerModel().

uint NL3D::CScene::_ShadowMapBlurSize [private]

Definition at line 751 of file scene.h. Referenced by CScene(), getShadowMapBlurSize(), and setShadowMapBlurSize().

float NL3D::CScene::_ShadowMapDistFadeEnd [private]

Definition at line 753 of file scene.h. Referenced by CScene(), getShadowMapDistFadeEnd(), and setShadowMapDistFadeEnd().

float NL3D::CScene::_ShadowMapDistFadeStart [private]

Definition at line 752 of file scene.h. Referenced by CScene(), getShadowMapDistFadeStart(), and setShadowMapDistFadeStart().

uint NL3D::CScene::_ShadowMapMaxCasterAround [private]

Definition at line 755 of file scene.h. Referenced by CScene(), getShadowMapMaxCasterAround(), and setShadowMapMaxCasterAround().

uint NL3D::CScene::_ShadowMapMaxCasterInScreen [private]

Definition at line 754 of file scene.h. Referenced by CScene(), getShadowMapMaxCasterInScreen(), and setShadowMapMaxCasterInScreen().

float NL3D::CScene::_ShadowMapMaxDepth [private]

Definition at line 750 of file scene.h. Referenced by CScene(), getShadowMapMaxDepth(), and setShadowMapMaxDepth().

uint NL3D::CScene::_ShadowMapTextureSize [private]

Definition at line 749 of file scene.h. Referenced by CScene(), getShadowMapTextureSize(), and setShadowMapTextureSize().

CShapeBank* NL3D::CScene::_ShapeBank [private]

Definition at line 657 of file scene.h.

TSkeletonModelList NL3D::CScene::_SkeletonModelList [private]

Definition at line 707 of file scene.h. Referenced by appendSkeletonModelToList(), eraseSkeletonModelToList(), getSkeletonModelListBegin(), and getSkeletonModelListEnd().

CTransform* NL3D::CScene::_UpdateModelList [private]

Definition at line 738 of file scene.h. Referenced by CScene(), NL3D::CTransform::linkToUpdateList(), release(), NL3D::CTransform::unlinkFromUpdateList(), and updateModels().

CViewport NL3D::CScene::_Viewport [private]

Definition at line 600 of file scene.h.

TWaitingInstancesMMap NL3D::CScene::_WaitingInstances [private]

Definition at line 660 of file scene.h. Referenced by createInstanceAsync(), and updateWaitingInstances().

IWaterSurfaceAddedCallback* NL3D::CScene::_WaterCallback [private]

Definition at line 717 of file scene.h. Referenced by CScene(), getWaterCallback(), and setWaterCallback().

CAnimDetailTrav NL3D::CScene::AnimDetailTrav [private]

Definition at line 626 of file scene.h. Referenced by createModel(), CScene(), getAnimDetailTrav(), and render().

UScene::CBenchResults NL3D::CScene::BenchRes

Definition at line 531 of file scene.h. Referenced by NL3D::CSceneUser::getProfileResults(), profileNextRender(), NL3D::CMeshMRMSkinnedGeom::profileSceneRender(), NL3D::CMeshMRMGeom::profileSceneRender(), and NL3D::CMeshGeom::profileSceneRender().

CClipTrav NL3D::CScene::ClipTrav [private]

Definition at line 624 of file scene.h. Referenced by createModel(), CScene(), getClipTrav(), initDefaultRoots(), release(), and render().

CRefPtr<CCamera> NL3D::CScene::CurrentCamera [private]

The camera / Viewport. Definition at line 599 of file scene.h. Referenced by getCam(), release(), render(), and setCam().

CHrcTrav NL3D::CScene::HrcTrav [private]

Definition at line 623 of file scene.h. Referenced by CScene(), getHrcTrav(), and render().

CLightTrav NL3D::CScene::LightTrav [private]

Definition at line 625 of file scene.h. Referenced by createModel(), CScene(), enableLightingSystem(), getLightTransitionThreshold(), getLightTrav(), getMaxLightContribution(), render(), setLightTransitionThreshold(), and setMaxLightContribution().

CLoadBalancingTrav NL3D::CScene::LoadBalancingTrav [private]

Definition at line 627 of file scene.h. Referenced by createModel(), CScene(), getGroupLoadMaxPolygon(), getGroupNbFaceAsked(), getLoadBalancingTrav(), getNbFaceAsked(), getPolygonBalancingMode(), render(), setGroupLoadMaxPolygon(), and setPolygonBalancingMode().

CRenderTrav NL3D::CScene::RenderTrav [private]

Definition at line 628 of file scene.h.

CTransform* NL3D::CScene::Root [private]

Definition at line 632 of file scene.h. Referenced by createModel(), CScene(), getRoot(), initDefaultRoots(), and release().

CCluster* NL3D::CScene::RootCluster [private]

Definition at line 634 of file scene.h.

CRootModel* NL3D::CScene::SonsOfAncestorSkeletonModelGroup [private]

Definition at line 636 of file scene.h. Referenced by CScene(), initDefaultRoots(), release(), NL3D::CClipTrav::traverse(), and NL3D::CTransform::updateClipTravForAncestorSkeleton().

---

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

• scene.h
• scene.cpp

---