NL3D::CZone Class Reference

#include <zone.h>

---

Detailed Description

A landscape zone. There is 2 ways for building a zone:

• use build(). (then you can use serial to save the zone, don't need to compile() the zone).
• use serial() for loading this zone.

Before a zone may be rendered, it must be compile()-ed, to compile and bind patch, to make vertices etc...

NB: you must call release() before deleting a compiled zone. (else assert in destruction).

Author:

Lionel Berenguier

Nevrax France

Date:

2000

Definition at line 297 of file src/3d/zone.h.

Public Member Functions
void	applyHeightField (const CLandscape &landScape)
void	averageTesselationVertices ()
void	build (const CZone &zone)
void	build (uint16 zoneId, const std::vector< CPatchInfo > &patchs, const std::vector< CBorderVertex > &borderVertices, uint32 numVertices=0)
void	build (const CZoneInfo &zoneInfo, uint32 numVertices=0)
void	changePatchTextureAndColor (sint numPatch, const std::vector< CTileElement > *tiles, const std::vector< CTileColor > *colors)
void	clip (const std::vector< CPlane > &pyramid)
	Clip a zone. To know if must be rendered etc... A zone is IN if in BACK of at least one plane of the pyramid.
void	compile (CLandscape *landscape, TZoneMap &loadedZones)
bool	compiled () const
void	copyTilesFlags (sint destPatchId, const CPatch *srcPatch)
	CZone ()
	Constructor.
void	debugBinds (FILE *f=stdout)
void	excludePatchFromRefineAll (uint patch, bool exclude)
	This is especially for Pacs. exlude a patch to be refineAll()ed.
void	forceMergeAtTileLevel ()
	For changing TileMaxSubdivision. force tesselation to be under tile.
CLandscape *	getLandscape () const
sint	getNumPatchs () const
const CPatch *	getPatch (sint patch) const
const CVector &	getPatchBias () const
const CBSphere &	getPatchBSphere (uint patch) const
const std::vector< CTileColor > &	getPatchColor (sint numPatch) const
const CPatchConnect *	getPatchConnect (sint patch) const
float	getPatchScale () const
const std::vector< CTileElement > &	getPatchTexture (sint numPatch) const
const CAABBoxExt &	getZoneBB () const
uint16	getZoneId () const
bool	isPatchRenderClipped (uint patch) const
	Is the patch clipped (ie not visible). crash if bad Id.
void	preRender ()
	PreRender a zone (if needed).
void	refineAll ()
	force Refine a zone.
void	refreshTesselationGeometry (sint numPatch)
void	release (TZoneMap &loadedZones)
void	resetRenderFarAndDeleteVBFV ()
void	retrieve (std::vector< CPatchInfo > &patchs, std::vector< CBorderVertex > &borderVertices)
void	retrieve (CZoneInfo &zoneInfo)
void	serial (NLMISC::IStream &f)
void	setTileColor (bool monochrome, float factor)
void	setupColorsFromTileFlags (const NLMISC::CRGBA colors[4])
	~CZone ()
	Destructor.
Private Types
typedef NLMISC::CSmartPtr< CTessBaseVertex >	PBaseVertex
typedef std::vector< PBaseVertex >	TBaseVerticesVec
enum	TClipResult { ClipIn = 0, ClipOut = 1, ClipSide = 2 }
Private Member Functions
void	buildBindInfo (uint patchId, uint edge, CZone *neighborZone, CPatch::CBindInfo &paBind)
void	clipPatchs (const std::vector< CPlane > &pyramid)
void	computeBBScaleBias (const CAABBox &bb)
PBaseVertex	getBaseVertex (sint vert) const
CPatch *	getPatch (sint patch)
bool	patchOnBorder (const CPatchConnect &pc) const
void	rebindBorder (TZoneMap &loadedZones)
Static Private Member Functions
void	bindPatch (TZoneMap &loadedZones, CPatch &pa, CPatchConnect &pc, bool rebind)
CPatch *	getZonePatch (TZoneMap &loadedZones, sint zoneId, sint patch)
void	unbindPatch (CPatch &pa)
Private Attributes
std::vector< CBSphere >	_PatchBSpheres
NLMISC::CBitSet	_PatchOldRenderClipped
NLMISC::CBitSet	_PatchRenderClipped
CPointLightNamedArray	_PointLightArray
TBaseVerticesVec	BaseVertices
std::vector< CBorderVertex >	BorderVertices
sint	ClipResult
bool	Compiled
CLandscape *	Landscape
sint32	NumVertices
CVector	PatchBias
std::vector< CPatchConnect >	PatchConnects
std::vector< CPatch >	Patchs
float	PatchScale
CAABBoxExt	ZoneBB
uint16	ZoneId
Friends
class	CLandscape
class	CPatch
class	CTessFace

---

Member Typedef Documentation

typedef NLMISC::CSmartPtr<CTessBaseVertex> NL3D::CZone::PBaseVertex [private]

Definition at line 551 of file src/3d/zone.h. Referenced by getBaseVertex().

typedef std::vector<PBaseVertex> NL3D::CZone::TBaseVerticesVec [private]

Definition at line 552 of file src/3d/zone.h.

---

Member Enumeration Documentation

enum NL3D::CZone::TClipResult [private]

Enumeration values: ClipIn  ClipOut  ClipSide  Definition at line 596 of file src/3d/zone.h. {ClipIn= 0, ClipOut= 1, ClipSide= 2};

---

Constructor & Destructor Documentation

NL3D::CZone::CZone (   )

Constructor. Definition at line 83 of file 3d/zone.cpp. References ClipOut, ClipResult, and Compiled. { ZoneId= 0; Compiled= false; Landscape= NULL; ClipResult= ClipOut; }

NL3D::CZone::~CZone (   )

Destructor. Definition at line 91 of file 3d/zone.cpp. References Compiled, and nlassert. { // release() must have been called. nlassert(!Compiled); }

---

Member Function Documentation

void NL3D::CZone::applyHeightField (  const CLandscape &  landScape  )

apply a landscape heightfield on a zone (modification of Z control points values). NB: this is done in Landscape addZone(), before compile(). Parameters: landScape  the landscape which gives Z delta values, for a x,y point. Definition at line 1452 of file 3d/zone.cpp. References computeBBScaleBias(), NLMISC::CAABBox::extend(), NL3D::CLandscape::getHeightFieldDeltaZ(), NL3D::CBezierPatch::Interiors, NL3D::CPatch::Interiors, NL3D::CVector3s::pack(), PatchBias, PatchScale, NLMISC::CAABBox::setCenter(), NLMISC::CAABBox::setHalfSize(), sint, NL3D::CBezierPatch::Tangents, NL3D::CPatch::Tangents, NL3D::CVector3s::unpack(), NL3D::CBezierPatch::Vertices, NL3D::CPatch::Vertices, NLMISC::CVector::x, and NLMISC::CVector::y. Referenced by NL3D::CLandscape::addZone(). { sint i,j; vector<CBezierPatch> patchs; // no patch, do nothing. if(Patchs.size()==0) return; // 0. Unpack patchs to Bezier Patchs. //=================================== patchs.resize(Patchs.size()); for(j=0;j<(sint)patchs.size();j++) { CBezierPatch &p= patchs[j]; CPatch &pa= Patchs[j]; // re-Build the uncompressed bezier patch. for(i=0;i<4;i++) pa.Vertices[i].unpack(p.Vertices[i], PatchBias, PatchScale); for(i=0;i<8;i++) pa.Tangents[i].unpack(p.Tangents[i], PatchBias, PatchScale); for(i=0;i<4;i++) pa.Interiors[i].unpack(p.Interiors[i], PatchBias, PatchScale); } // 1. apply heightfield on bezier patchs. //=================================== for(j=0;j<(sint)patchs.size();j++) { CBezierPatch &p= patchs[j]; // apply delta. for(i=0;i<4;i++) p.Vertices[i]+= landScape.getHeightFieldDeltaZ(p.Vertices[i].x, p.Vertices[i].y); for(i=0;i<8;i++) p.Tangents[i]+= landScape.getHeightFieldDeltaZ(p.Tangents[i].x, p.Tangents[i].y); for(i=0;i<4;i++) p.Interiors[i]+= landScape.getHeightFieldDeltaZ(p.Interiors[i].x, p.Interiors[i].y); } // 2. Re-compute Patch Scale/Bias, and Zone BBox. //=================================== CAABBox bb; bb.setCenter(patchs[0].Vertices[0]); bb.setHalfSize(CVector::Null); for(j=0;j<(sint)patchs.size();j++) { // extend bbox. const CBezierPatch &p= patchs[j]; for(i=0;i<4;i++) bb.extend(p.Vertices[i]); for(i=0;i<8;i++) bb.extend(p.Tangents[i]); for(i=0;i<4;i++) bb.extend(p.Interiors[i]); } // Compute BBox, and Patch Scale Bias, according to Noise. computeBBScaleBias(bb); // 3. Re-pack patchs. //=================================== for(j=0;j<(sint)patchs.size();j++) { CBezierPatch &p= patchs[j]; CPatch &pa= Patchs[j]; // Build the packed patch. for(i=0;i<4;i++) pa.Vertices[i].pack(p.Vertices[i], PatchBias, PatchScale); for(i=0;i<8;i++) pa.Tangents[i].pack(p.Tangents[i], PatchBias, PatchScale); for(i=0;i<4;i++) pa.Interiors[i].pack(p.Interiors[i], PatchBias, PatchScale); } }

void NL3D::CZone::averageTesselationVertices (   )

This is especially for Pacs. see CLandscape desc. Definition at line 1157 of file 3d/zone.cpp. References NL3D::CPatch::averageTesselationVertices(), Compiled, nlassert, and sint. { nlassert(Compiled); // Fuck stlport.... if(Patchs.size()==0) return; // averageTesselationVertices of ALL patchs. CPatch *pPatch= &(*Patchs.begin()); for(sint n=(sint)Patchs.size();n>0;n--, pPatch++) { pPatch->averageTesselationVertices(); } }

void NL3D::CZone::bindPatch (  TZoneMap &  loadedZones, CPatch &  pa, CPatchConnect &  pc, bool  rebind )  [static, private]

Definition at line 776 of file 3d/zone.cpp. References NL3D::CPatch::bind(), NL3D::CZone::CPatchConnect::BindEdges, NL3D::CPatchInfo::CBindInfo::Edge, NL3D::CPatch::CBindInfo::Edge, NL3D::CPatch::getBindNeighbor(), NL3D::CPatchInfo::CBindInfo::Next, NL3D::CPatch::CBindInfo::Next, nlassert, NL3D::CPatch::CBindInfo::NPatchs, NL3D::CPatchInfo::CBindInfo::NPatchs, sint, NL3D::TZoneMap, NL3D::CPatch::unbind(), NL3D::CPatch::CBindInfo::Zone, and NL3D::CPatchInfo::CBindInfo::ZoneId. Referenced by compile(), and rebindBorder(). { CPatch::CBindInfo edges[4]; // Fill all edges. for(sint i=0;i<4;i++) { CPatchInfo::CBindInfo &pcBind= pc.BindEdges[i]; CPatch::CBindInfo &paBind= edges[i]; nlassert(pcBind.NPatchs==0 || pcBind.NPatchs==1 || pcBind.NPatchs==2 || pcBind.NPatchs==4 || pcBind.NPatchs==5); paBind.NPatchs= pcBind.NPatchs; // Find the zone. TZoneMap::iterator itZoneMap; // If no neighbor, or if zone neighbor not loaded. if( paBind.NPatchs==0 || (itZoneMap=loadedZones.find(pcBind.ZoneId)) == loadedZones.end() ) paBind.Zone= NULL; else paBind.Zone= itZoneMap->second; // Special case of a small patch connected to a bigger. if(paBind.NPatchs==5) { paBind.Edge[0]= pcBind.Edge[0]; paBind.Next[0]= CZone::getZonePatch(loadedZones, pcBind.ZoneId, pcBind.Next[0]); // If not loaded, don't bind to this edge. if(!paBind.Next[0]) paBind.NPatchs=0; else { // Get the BindInfo on me stored in our neighbor bigger CPatch CPatch::CBindInfo nbOnMe; paBind.Next[0]->getBindNeighbor(paBind.Edge[0], nbOnMe); // if this patch has not already been binded on me, nbOnMe.Zone==NULL if( nbOnMe.Zone == NULL ) { // Simple case: do nothing: don't need to rebind() to the bigger patch since // himself is not bound paBind.NPatchs=0; paBind.Zone= NULL; } else { // pa.bind() will do the job. // Leave it flagged with NPatchs==5. continue; } } } // Bind 1/1 and 1/2,1/4 if(paBind.NPatchs>=1) { paBind.Edge[0]= pcBind.Edge[0]; paBind.Next[0]= CZone::getZonePatch(loadedZones, pcBind.ZoneId, pcBind.Next[0]); // If not loaded, don't bind to this edge. if(!paBind.Next[0]) paBind.NPatchs=0; } if(paBind.NPatchs>=2) { paBind.Edge[1]= pcBind.Edge[1]; paBind.Next[1]= CZone::getZonePatch(loadedZones, pcBind.ZoneId, pcBind.Next[1]); // If not loaded, don't bind to this edge. if(!paBind.Next[1]) paBind.NPatchs=0; } if(paBind.NPatchs>=4) { paBind.Edge[2]= pcBind.Edge[2]; paBind.Edge[3]= pcBind.Edge[3]; paBind.Next[2]= CZone::getZonePatch(loadedZones, pcBind.ZoneId, pcBind.Next[2]); paBind.Next[3]= CZone::getZonePatch(loadedZones, pcBind.ZoneId, pcBind.Next[3]); // If not loaded, don't bind to this edge. if(!paBind.Next[2] || !paBind.Next[3]) paBind.NPatchs=0; } } // First, unbind. pa.unbind(); // Then bind. pa.bind(edges, rebind); }

void NL3D::CZone::build (  const CZone &  zone  )

Build a copy of a zone. This method do a copy of zone (should be builded but maybe not compiled). NB: cannot build on a compiled zone. must release the zone before.... Definition at line 365 of file 3d/zone.cpp. References _PatchOldRenderClipped, _PatchRenderClipped, _PointLightArray, BorderVertices, Compiled, nlassert, NumVertices, PatchBias, PatchConnects, Patchs, PatchScale, NLMISC::CBitSet::resize(), NLMISC::CBitSet::setAll(), ZoneBB, and ZoneId. { nlassert(!Compiled); ZoneId= zone.ZoneId; BorderVertices= zone.BorderVertices; // Compute the bbox and the bias/scale. //===================================== ZoneBB= zone.ZoneBB; PatchScale= zone.PatchScale; PatchBias= zone.PatchBias; // Compute/compress Patchs. //========================= Patchs= zone.Patchs; PatchConnects= zone.PatchConnects; // Init the Clip Arrays _PatchRenderClipped.resize(Patchs.size()); _PatchOldRenderClipped.resize(Patchs.size()); _PatchRenderClipped.setAll(); _PatchOldRenderClipped.setAll(); // copy pointLights. //========================= _PointLightArray= zone._PointLightArray; NumVertices= zone.NumVertices; }

void NL3D::CZone::build (  uint16  zoneId, const std::vector< CPatchInfo > &  patchs, const std::vector< CBorderVertex > &  borderVertices, uint32  numVertices = 0 )

Build a zone. Deprecated. Should use build(CZoneInfo &) instead. see this method Definition at line 112 of file 3d/zone.cpp. References NL3D::CZoneInfo::BorderVertices, build(), NL3D::CZoneInfo::Patchs, uint16, uint32, and NL3D::CZoneInfo::ZoneId. { CZoneInfo zinfo; zinfo.ZoneId= zoneId; zinfo.Patchs= patchs; zinfo.BorderVertices= borderVertices; build(zinfo, numVertices); }

void NL3D::CZone::build (  const CZoneInfo &  zoneInfo, uint32  numVertices = 0 )

Build a zone. This method do: compress the patchs coordinates. build the patchs of the zone, but doesn't compile() them. compress Lumels. sort PointLights by name, and hence remap TileLightInfluences coordinates. NB: cannot build on a compiled zone. must release the zone before.... Parameters: numVertices  maximize the numgber of vertices used by this zone with this value. Definition at line 122 of file 3d/zone.cpp. References _PatchOldRenderClipped, _PatchRenderClipped, NL3D::CPatchInfo::BaseVertices, NL3D::CZone::CPatchConnect::BaseVertices, NL3D::CPatchInfo::BindEdges, NL3D::CZone::CPatchConnect::BindEdges, NL3D::CZoneInfo::BorderVertices, NL3D::CPointLightNamedArray::build(), Compiled, computeBBScaleBias(), NL3D::CPatchInfo::ErrorSize, NL3D::CZone::CPatchConnect::ErrorSize, NLMISC::CAABBox::extend(), NL3D::CPatchInfo::Flags, NL3D::CPatch::Flags, NL3D::CPatchInfo::getCornerSmoothFlag(), NL3D::CPointLightNamedArray::getPointLights(), NL3D::CPatch::Interiors, NL3D::CBezierPatch::Interiors, NL3D::CTileLightInfluence::Light, NL3D::CPatchInfo::Lumels, NL_LUMEL_BY_TILE, NL_PATCH_SMOOTH_FLAG_MASK, NL_PATCH_SMOOTH_FLAG_SHIFT, nlassert, NL3D::CPatchInfo::NoiseRotation, NL3D::CPatch::NoiseRotation, NL3D::CPatchInfo::OrderS, NL3D::CPatch::OrderS, NL3D::CPatchInfo::OrderT, NL3D::CPatch::OrderT, NL3D::CVector3s::pack(), NL3D::CPatch::packShadowMap(), NL3D::CPatchInfo::Patch, PatchBias, PatchConnects, NL3D::CZoneInfo::Patchs, PatchScale, NL3D::CZoneInfo::PointLights, NL3D::CPatch::resetCompressedLumels(), NL3D::CPatch::resetTileLightInfluences(), NLMISC::CBitSet::resize(), NLMISC::CBitSet::setAll(), NLMISC::CAABBox::setCenter(), NL3D::CPatch::setCornerSmoothFlag(), NLMISC::CAABBox::setHalfSize(), sint, NL3D::CPatch::Tangents, NL3D::CBezierPatch::Tangents, NL3D::CPatchInfo::TileColors, NL3D::CPatch::TileColors, NL3D::CPatch::TileLightInfluences, NL3D::CPatchInfo::TileLightInfluences, NL3D::CPatchInfo::Tiles, NL3D::CPatch::Tiles, uint, uint16, uint32, NL3D::CPatch::Vertices, NL3D::CBezierPatch::Vertices, and NL3D::CZoneInfo::ZoneId. Referenced by NL3D::CLandscape::addZone(), build(), and NL3D::CZoneLighter::light(). { sint i,j; nlassert(!Compiled); // Ref inupt uint16 zoneId= zoneInfo.ZoneId; const std::vector<CPatchInfo> &patchs= zoneInfo.Patchs; const std::vector<CBorderVertex> &borderVertices= zoneInfo.BorderVertices; ZoneId= zoneId; BorderVertices= borderVertices; // Compute the bbox and the bias/scale. //===================================== CAABBox bb; if(patchs.size()) bb.setCenter(patchs[0].Patch.Vertices[0]); bb.setHalfSize(CVector::Null); for(j=0;j<(sint)patchs.size();j++) { const CBezierPatch &p= patchs[j].Patch; for(i=0;i<4;i++) bb.extend(p.Vertices[i]); for(i=0;i<8;i++) bb.extend(p.Tangents[i]); for(i=0;i<4;i++) bb.extend(p.Interiors[i]); } // Compute BBox, and Patch Scale Bias, according to Noise. computeBBScaleBias(bb); // Compute/compress Patchs. //========================= Patchs.resize(patchs.size()); PatchConnects.resize(patchs.size()); sint maxVertex=-1; for(j=0;j<(sint)patchs.size();j++) { const CPatchInfo &pi= patchs[j]; const CBezierPatch &p= pi.Patch; CPatch &pa= Patchs[j]; CPatchConnect &pc= PatchConnects[j]; // Smoothing flags pa.Flags&=~NL_PATCH_SMOOTH_FLAG_MASK; pa.Flags|=NL_PATCH_SMOOTH_FLAG_MASK&(pi.Flags<<NL_PATCH_SMOOTH_FLAG_SHIFT); // Noise Data // copy noise rotation. pa.NoiseRotation= pi.NoiseRotation; // copy all noise smoothing info. for(i=0;i<4;i++) { pa.setCornerSmoothFlag(i, pi.getCornerSmoothFlag(i)); } // Copy order of the patch pa.OrderS= pi.OrderS; pa.OrderT= pi.OrderT; // Build the patch. for(i=0;i<4;i++) pa.Vertices[i].pack(p.Vertices[i], PatchBias, PatchScale); for(i=0;i<8;i++) pa.Tangents[i].pack(p.Tangents[i], PatchBias, PatchScale); for(i=0;i<4;i++) pa.Interiors[i].pack(p.Interiors[i], PatchBias, PatchScale); pa.Tiles= pi.Tiles; pa.TileColors= pi.TileColors; /* Copy TileLightInfluences. It is possible that pi.TileLightInfluences.size()!= 0 and pi.TileLightInfluences.size()!= (uint)(pi.OrderS/2+1)*(pi.OrderT/2+1) Because of a preceding bug where pa.OrderS and pa.OrderT were not initialized before the pa.resetTileLightInfluences(); */ if( pi.TileLightInfluences.size()!= (uint)(pi.OrderS/2+1)*(pi.OrderT/2+1) ) { pa.resetTileLightInfluences(); } else { pa.TileLightInfluences= pi.TileLightInfluences; } // Number of lumels in this patch uint lumelCount=(pi.OrderS*NL_LUMEL_BY_TILE)*(pi.OrderT*NL_LUMEL_BY_TILE); // Lumel empty ? if (pi.Lumels.size ()==lumelCount) { // Pack the lumel map pa.packShadowMap (&pi.Lumels[0]); } else { // Reset lightmap pa.resetCompressedLumels (); } nlassert(pa.Tiles.size()== (uint)pi.OrderS*pi.OrderT); nlassert(pa.TileColors.size()== (uint)(pi.OrderS+1)*(pi.OrderT+1)); // Build the patchConnect. pc.ErrorSize= pi.ErrorSize; for(i=0;i<4;i++) { pc.BaseVertices[i]= pi.BaseVertices[i]; maxVertex= max((sint)pc.BaseVertices[i], maxVertex); } for(i=0;i<4;i++) pc.BindEdges[i]= pi.BindEdges[i]; } NumVertices= maxVertex+1; NumVertices= max((uint32)NumVertices, numVertices); // Init the Clip Arrays _PatchRenderClipped.resize(Patchs.size()); _PatchOldRenderClipped.resize(Patchs.size()); _PatchRenderClipped.setAll(); _PatchOldRenderClipped.setAll(); // Copy PointLights. //========================= // build array, lights are sorted std::vector<uint> plRemap; _PointLightArray.build(zoneInfo.PointLights, plRemap); // Check TileLightInfluences integrity, and remap PointLight Indices. for(j=0;j<(sint)patchs.size();j++) { CPatch &pa= Patchs[j]; for(uint k= 0; k<pa.TileLightInfluences.size(); k++) { CTileLightInfluence &tli= pa.TileLightInfluences[k]; for(uint l=0; l<CTileLightInfluence::NumLightPerCorner; l++) { // If NULL light, break and continue to next TileLightInfluence. if(tli.Light[l]== 0xFF) break; else { // Check good index. nlassert(tli.Light[l] < _PointLightArray.getPointLights().size()); // Remap index, because of light sorting. tli.Light[l]= plRemap[tli.Light[l]]; } } } } }

void NL3D::CZone::buildBindInfo (  uint  patchId, uint  edge, CZone *  neighborZone, CPatch::CBindInfo &  paBind )  [private]

Definition at line 718 of file 3d/zone.cpp. References NL3D::CZone::CPatchConnect::BindEdges, NL3D::CPatchInfo::CBindInfo::Edge, NL3D::CPatch::CBindInfo::Edge, getPatch(), getPatchConnect(), NL3D::CPatch::CBindInfo::MultipleBindId, NL3D::CPatch::CBindInfo::MultipleBindNum, NL3D::CPatchInfo::CBindInfo::Next, NL3D::CPatch::CBindInfo::Next, nlassert, NL3D::CPatch::CBindInfo::NPatchs, NL3D::CPatchInfo::CBindInfo::NPatchs, PatchConnects, sint, uint, and NL3D::CPatch::CBindInfo::Zone. Referenced by NL3D::CPatch::getBindNeighbor(). { nlassert(patchId < Patchs.size()); nlassert(neighborZone); CPatchConnect &pc= PatchConnects[patchId]; // Get the bind info of this patch to his neighbor on "edge". CPatchInfo::CBindInfo &pcBind= pc.BindEdges[edge]; nlassert(pcBind.NPatchs==0 || pcBind.NPatchs==1 || pcBind.NPatchs==2 || pcBind.NPatchs==4 || pcBind.NPatchs==5); // copy zone ptr. paBind.Zone= neighborZone; // Special case of a small patch connected to a bigger. if(pcBind.NPatchs==5) { paBind.NPatchs= 1; paBind.Next[0]= neighborZone->getPatch(pcBind.Next[0]); paBind.Edge[0]= pcBind.Edge[0]; // Get the twin bindInfo of pcBind. const CPatchInfo::CBindInfo &pcBindNeighbor= neighborZone->getPatchConnect(pcBind.Next[0])->BindEdges[pcBind.Edge[0]]; // must have a multiple bind. nlassert(pcBindNeighbor.NPatchs == 2 || pcBindNeighbor.NPatchs == 4); // number of bind is stored on the twin bindInfo. paBind.MultipleBindNum= pcBindNeighbor.NPatchs; // Search our patchId on neighbor; paBind.MultipleBindId= 255; for(sint i=0; i<paBind.MultipleBindNum; i++) { if(pcBindNeighbor.Next[i]==patchId) paBind.MultipleBindId= i; } nlassert(paBind.MultipleBindId!= 255); } else { paBind.MultipleBindNum= 0; paBind.NPatchs= pcBind.NPatchs; for(sint i=0;i<paBind.NPatchs; i++) { paBind.Next[i]= neighborZone->getPatch(pcBind.Next[i]); paBind.Edge[i]= pcBind.Edge[i]; } } }

void NL3D::CZone::changePatchTextureAndColor (  sint  numPatch, const std::vector< CTileElement > *  tiles, const std::vector< CTileColor > *  colors )

Update and refresh a patch texture. Usefull for Tile edition. Even if patch is in tile mode, it is refreshed... Parameters: numPatch  the index of patch in this zone which will receive his new texture. assert if bad id. tiles  the patch texture. assert if not of good size (OrderS*OrderT). Can be NULL if you don't want to change the patch texture. colors  the patch texture. assert if not of good size ((OrderS+1)*(OrderT+1)). Can be NULL if you don't want to change the patch colors. Definition at line 1279 of file 3d/zone.cpp. References _PatchRenderClipped, Compiled, getNumPatchs(), nlassert, sint, NL3D::CLandscape::unlockBuffers(), NL3D::CLandscape::updateGlobalsAndLockBuffers(), and NL3D::CLandscape::updateTessBlocksFaceVector(). { nlassert(numPatch>=0); nlassert(numPatch<getNumPatchs()); // Update the patch texture. if (tiles) { nlassert( Patchs[numPatch].Tiles.size() == tiles->size() ); Patchs[numPatch].Tiles = *tiles; } // Update the patch colors. if (colors) { nlassert( Patchs[numPatch].TileColors.size() == colors->size() ); Patchs[numPatch].TileColors = *colors; } if (Compiled) { // If the patch is visible, then we must LockBuffers, because new VertexVB may be created. if(!_PatchRenderClipped[numPatch]) Landscape->updateGlobalsAndLockBuffers(CVector::Null); // Recompute UVs for new setup of Tiles. Patchs[numPatch].deleteTileUvs(); Patchs[numPatch].recreateTileUvs(); // unlockBuffers() if necessary. if(!_PatchRenderClipped[numPatch]) { Landscape->unlockBuffers(); // This patch is visible, and TileFaces have been deleted / added. // So must update TessBlock. Landscape->updateTessBlocksFaceVector(); } } }

void NL3D::CZone::clip (  const std::vector< CPlane > &  pyramid  )

Clip a zone. To know if must be rendered etc... A zone is IN if in BACK of at least one plane of the pyramid. Definition at line 922 of file 3d/zone.cpp. References _PatchOldRenderClipped, _PatchRenderClipped, NLMISC::CBitSet::clearAll(), NLMISC::CAABBoxExt::clipBack(), NLMISC::CAABBoxExt::clipFront(), ClipIn, ClipOut, clipPatchs(), ClipResult, ClipSide, Compiled, NLMISC::CBitSet::getVector(), H_AUTO, min, nlassert, NLMISC::CBitSet::setAll(), sint, uint, uint32, and ZoneBB. { H_AUTO( NLMISC_ClipZone ); nlassert(Compiled); // bkup old ClipResult. NB: by default, it is ClipOut (no VB created). sint oldClipResult= ClipResult; // Pyramid with only the planes that clip the zone static std::vector<CPlane> patchPyramid(10); static std::vector<uint> patchPyramidIndex(10); patchPyramidIndex.clear(); // Compute ClipResult. //------------------- ClipResult= ClipIn; for(sint i=0;i<(sint)pyramid.size();i++) { // If entirely out. if(!ZoneBB.clipBack(pyramid[i])) { ClipResult= ClipOut; // If out of only one plane, out of all. break; } // If partially IN (ie not entirely out, and not entirely IN) else if(ZoneBB.clipFront(pyramid[i])) { // Force ClipResult to be ClipSide, and not ClipIn. ClipResult=ClipSide; // Append the plane index to list to test patchPyramidIndex.push_back(i); } } // Easy Clip :) if(Patchs.empty()) { ClipResult= ClipOut; // don't need to go below... return; } // Clip By Patch Pass. //-------------------- if(ClipResult==ClipOut) { H_AUTO( NLMISC_ClipZone_Out ); // Set All RenderClip flags to true. _PatchRenderClipped.setAll(); } else if(ClipResult==ClipIn) { H_AUTO( NLMISC_ClipZone_In ); // Set All RenderClip flags to false. _PatchRenderClipped.clearAll(); } else { H_AUTO( NLMISC_ClipZone_Side ); // Copy only the pyramid planes of interest patchPyramid.resize(patchPyramidIndex.size()); uint i; for(i=0;i<patchPyramidIndex.size();i++) { patchPyramid[i]= pyramid[patchPyramidIndex[i]]; } // clip all patchs with the simplified pyramid clipPatchs(patchPyramid); } // delete / reallocate / fill VBuffers. //------------------- // If there is a change in the Clip of the zone, or if patchs may have change (ie ClipSide is undetermined). if(oldClipResult!=ClipResult || oldClipResult==ClipSide) { // get BitSet as Raw Array of uint32 uint32 *oldRenderClip= const_cast<uint32*>(&_PatchOldRenderClipped.getVector()[0]); const uint32 *newRenderClip= &_PatchRenderClipped.getVector()[0]; uint numPatchs= Patchs.size(); // Then, we must test by patch. for(uint i=0;i<numPatchs;oldRenderClip++, newRenderClip++) { uint32 oldWord= *oldRenderClip; uint32 newWord= *newRenderClip; // process at max 32 patch uint maxNumBits= min((numPatchs-i), 32U); uint32 mask= 1; for(;maxNumBits>0;maxNumBits--, mask<<=1, i++) { // same as: if(_PatchOldRenderClipped[i] != _PatchRenderClipped[i]) if( (oldWord^newWord)&mask ) { // set the flag. *oldRenderClip&= ~mask; *oldRenderClip|= newWord&mask; // update clip patch Patchs[i].updateClipPatchVB( (newWord&mask)!=0 ); } } } } }

void NL3D::CZone::clipPatchs (  const std::vector< CPlane > &  pyramid  )  [private]

Definition at line 1038 of file 3d/zone.cpp. References _PatchBSpheres, _PatchRenderClipped, NLMISC::CBitSet::clearAll(), NLMISC::CBSphere::clipBack(), NLMISC::CBitSet::set(), sint, and uint. Referenced by clip(). { // Init all to Not clipped _PatchRenderClipped.clearAll(); for(uint j=0;j<_PatchBSpheres.size();j++) { CBSphere &bSphere= _PatchBSpheres[j]; for(sint i=0;i<(sint)pyramid.size();i++) { // If entirely out. if(!bSphere.clipBack(pyramid[i])) { _PatchRenderClipped.set(j, true); break; } } } }

void NL3D::CZone::compile (  CLandscape *  landscape, TZoneMap &  loadedZones )

Compile a zone. Make it usable for clip()/refine()/render(). This method do: attach this to loadedZones. create/link the base vertices (internal..), according to present neigbor zones. compile() the patchs. bind() the patchs. rebindBorder() on neighbor zones. A zone must keep a pointer on a landscape, for texture management. NB: assert if already compiled. assert if zone already exist in loadedZones. Definition at line 499 of file 3d/zone.cpp. References _PatchBSpheres, NL3D::CZone::CPatchConnect::BaseVertices, bindPatch(), NL3D::CPatch::buildBBox(), NL3D::CPatch::compile(), Compiled, NL3D::CZone::CPatchConnect::ErrorSize, NLMISC::CAABBox::getCenter(), NLMISC::CAABBox::getRadius(), NL3D::ItZoneMap, nlassert, NL3D::CPatch::OrderS, NL3D::CPatch::OrderT, PatchConnects, sint, and NL3D::TZoneMap. Referenced by NL3D::CLandscape::addZone(). { sint i,j; TZoneMap neighborZones; //nlinfo("Compile Zone: %d \n", (sint32)getZoneId()); // Can't compile if compiled. nlassert(!Compiled); Landscape= landscape; // Attach this to loadedZones. //============================ nlassert(loadedZones.find(ZoneId)==loadedZones.end()); loadedZones[ZoneId]= this; // Create/link the base vertices according to present neigbor zones. //============================ BaseVertices.clear(); BaseVertices.resize(NumVertices); // First try to link vertices to other. for(i=0;i<(sint)BorderVertices.size();i++) { sint cur= BorderVertices[i].CurrentVertex; sint vertto= BorderVertices[i].NeighborVertex; sint zoneto= BorderVertices[i].NeighborZoneId; nlassert(cur<NumVertices); if(loadedZones.find(zoneto)!=loadedZones.end()) { CZone *zone; zone= (*loadedZones.find(zoneto)).second; nlassert(zone!=this); // insert the zone in the neigborood (if not done...). neighborZones[zoneto]= zone; // Doesn't matter if BaseVertices is already linked to an other zone... // This should be the same pointer in this case... BaseVertices[cur]= zone->getBaseVertex(vertto); } } // Else, create unbounded vertices. for(i=0;i<(sint)BaseVertices.size();i++) { if(BaseVertices[i]==NULL) { BaseVertices[i]= new CTessBaseVertex; } } // compile() the patchs. //====================== for(j=0;j<(sint)Patchs.size();j++) { CPatch &pa= Patchs[j]; CPatchConnect &pc= PatchConnects[j]; CTessVertex *baseVertices[4]; baseVertices[0]= &(BaseVertices[pc.BaseVertices[0]]->Vert); baseVertices[1]= &(BaseVertices[pc.BaseVertices[1]]->Vert); baseVertices[2]= &(BaseVertices[pc.BaseVertices[2]]->Vert); baseVertices[3]= &(BaseVertices[pc.BaseVertices[3]]->Vert); pa.compile(this, j, pa.OrderS, pa.OrderT, baseVertices, pc.ErrorSize); }; // compile() the Clip information for the patchs. //====================== _PatchBSpheres.resize(Patchs.size()); for(j=0;j<(sint)Patchs.size();j++) { CPatch &pa= Patchs[j]; // Buil the BSPhere of the patch. CAABBox bb= pa.buildBBox(); _PatchBSpheres[j].Center= bb.getCenter(); _PatchBSpheres[j].Radius= bb.getRadius(); } // bind() the patchs. (after all compiled). //=================== for(j=0;j<(sint)Patchs.size();j++) { CPatch &pa= Patchs[j]; CPatchConnect &pc= PatchConnects[j]; // bind the patch. This is the original bind, not a rebind. bindPatch(loadedZones, pa, pc, false); } // rebindBorder() on neighbor zones. //================================== ItZoneMap zoneIt; // Traverse the neighborood. for(zoneIt= neighborZones.begin(); zoneIt!=neighborZones.end(); zoneIt++) { (*zoneIt).second->rebindBorder(loadedZones); } // End!! Compiled= true; }

bool NL3D::CZone::compiled (   )  const [inline]

Definition at line 487 of file src/3d/zone.h. References Compiled. {return Compiled;}

void NL3D::CZone::computeBBScaleBias (  const CAABBox &  bb  )  [private]

Definition at line 99 of file 3d/zone.cpp. References NLMISC::CAABBoxExt::getCenter(), NLMISC::CAABBoxExt::getHalfSize(), NL3D_NOISE_MAX, PatchBias, PatchScale, NLMISC::CAABBoxExt::setHalfSize(), NLMISC::CVector::x, NLMISC::CVector::y, NLMISC::CVector::z, and ZoneBB. Referenced by applyHeightField(), and build(). { ZoneBB= bb; // Take a security for noise. (usefull for zone clipping). ZoneBB.setHalfSize(ZoneBB.getHalfSize()+CVector(NL3D_NOISE_MAX, NL3D_NOISE_MAX, NL3D_NOISE_MAX)); CVector hs= ZoneBB.getHalfSize(); float rmax= maxof(hs.x, hs.y, hs.z); PatchScale= rmax / 32760; // Prevent from float imprecision by taking 32760 and not 32767. PatchBias= ZoneBB.getCenter(); }

void NL3D::CZone::copyTilesFlags (  sint  destPatchId, const CPatch *  srcPatch )

Copy the tiles flags from a src patch to a patch of this zone. the patch must match of course... Definition at line 1542 of file 3d/zone.cpp. References NL3D::CPatch::copyTileFlagsFromPatch(), getPatch(), and sint. Referenced by NL3D::CZoneLighter::copyTileFlags(). { CPatch *destPatch = getPatch(destPatchId); destPatch->copyTileFlagsFromPatch(srcPatch); }

void NL3D::CZone::debugBinds (  FILE *  f = stdout  )

Debug a zone, print binds in display. Definition at line 1420 of file 3d/zone.cpp. References NL3D::CZone::CPatchConnect::BindEdges, NL3D::CPatchInfo::CBindInfo::Edge, NL3D::CPatchInfo::CBindInfo::Next, NL3D::CPatchInfo::CBindInfo::NPatchs, PatchConnects, sint, and NL3D::CPatchInfo::CBindInfo::ZoneId. { fprintf(f, "*****************************\n"); fprintf(f, "ZoneId: %d. NPatchs:%d\n", ZoneId, PatchConnects.size()); sint i; for(i=0;i<(sint)PatchConnects.size();i++) { CPatchConnect &pc= PatchConnects[i]; fprintf(f, "patch%d:\n", i); for(sint j=0;j<4;j++) { CPatchInfo::CBindInfo &bd= pc.BindEdges[j]; fprintf(f, " edge%d: Zone:%d. NPatchs:%d. ", j, bd.ZoneId, bd.NPatchs); for(sint k=0;k<bd.NPatchs;k++) { fprintf(f, "p%de%d - ", bd.Next[k], bd.Edge[k]); } fprintf(f, "\n"); } } fprintf(f,"Vertices :\n"); for(i=0;i<(sint)BorderVertices.size();i++) { fprintf(f,"current : %d -> (zone %d) vertex %d\n",BorderVertices[i].CurrentVertex, BorderVertices[i].NeighborZoneId, BorderVertices[i].NeighborVertex); } }

void NL3D::CZone::excludePatchFromRefineAll (  uint  patch, bool  exclude )

This is especially for Pacs. exlude a patch to be refineAll()ed. Definition at line 1119 of file 3d/zone.cpp. References Compiled, nlassert, and uint. { nlassert(Compiled); nlassert(patch<Patchs.size()); if(patch>=Patchs.size()) return; Patchs[patch].ExcludeFromRefineAll= exclude; }

void NL3D::CZone::forceMergeAtTileLevel (   )

For changing TileMaxSubdivision. force tesselation to be under tile. Definition at line 1259 of file 3d/zone.cpp. References NL3D::CPatch::forceMergeAtTileLevel(), and sint. { CPatch *pPatch=0; if(Patchs.size()>0) pPatch= &(*Patchs.begin()); for(sint n=(sint)Patchs.size();n>0;n--, pPatch++) { pPatch->forceMergeAtTileLevel(); } }

PBaseVertex NL3D::CZone::getBaseVertex (  sint  vert  )  const [inline, private]

Definition at line 606 of file src/3d/zone.h. References PBaseVertex, and sint. {return BaseVertices[vert];}

CLandscape* NL3D::CZone::getLandscape (   )  const [inline]

Get the landscape in which is placed this zone. If no landscape, return NULL. Returns: the pointer of the landscape of the zone or NULL if the zone hasn't be compiled. Definition at line 461 of file src/3d/zone.h. Referenced by NL3D::CPatch::computeDisplaceRawInteger(), NL3D::CPatch::getLandscape(), and NL3D::CTextureFar::rebuildPatch(). { return Landscape; }

sint NL3D::CZone::getNumPatchs (   )  const [inline]

Definition at line 489 of file src/3d/zone.h. References sint. Referenced by NL3D::CMiniCol::addZone(), NL3D::CLandscape::addZone(), NL3D::CZoneLighter::buildZoneInformation(), changePatchTextureAndColor(), NL3D::CLandscape::checkZoneBinds(), NL3D::CZoneCornerSmoother::computeAllCornerSmoothFlags(), NL3D::CZoneLighter::copyTileFlags(), NL3D::CZoneLighter::excludeAllPatchFromRefineAll(), NL3D::CInstanceLighter::excludeAllPatchFromRefineAll(), getPatchColor(), getPatchTexture(), refreshTesselationGeometry(), and NL3D::CLandscape::removeZone(). {return Patchs.size();}

CPatch* NL3D::CZone::getPatch (  sint  patch  )  [inline, private]

Definition at line 607 of file src/3d/zone.h. References nlassert, and sint. {nlassert(patch>=0 && patch<(sint)Patchs.size()); return &(Patchs[patch]);}

const CPatch* NL3D::CZone::getPatch (  sint  patch  )  const [inline]

Get a read only patch pointer. Parameters: patch  the index of patch to get. Returns: A patch pointer in read only. Definition at line 499 of file src/3d/zone.h. References nlassert, and sint. Referenced by buildBindInfo(), NL3D::CZoneLighter::copyTileFlags(), and copyTilesFlags(). {nlassert(patch>=0 && patch<(sint)Patchs.size()); return &(Patchs[patch]);}

const CVector& NL3D::CZone::getPatchBias (   )  const [inline]

Definition at line 485 of file src/3d/zone.h. References PatchBias. Referenced by NL3D::CPatch::unpack(). {return PatchBias;}

const CBSphere & NL3D::CZone::getPatchBSphere (  uint  patch  )  const

Get the Bounding spehere of a patch. Stored in Zone as an array and not in CPatch for Fast Memory access consideration during clipping. Work only when zone compiled. Definition at line 911 of file 3d/zone.cpp. References _PatchBSpheres, and uint. Referenced by NL3D::CMiniCol::addZone(), and NL3D::CLandscape::computeDynamicLighting(). { static CBSphere dummySphere; if(patch<_PatchBSpheres.size()) return _PatchBSpheres[patch]; else return dummySphere; }

const std::vector< CTileColor > & NL3D::CZone::getPatchColor (  sint  numPatch  )  const

Get a patch colors Return the color array. Parameters: numPatch  the index of patch in this zone which will get his colors. assert if bad id. \return  The tiles the patch colors. The size should be (OrderS+1)*(OrderT+1). See also: getPatch() Definition at line 1347 of file 3d/zone.cpp. References getNumPatchs(), nlassert, and sint. { nlassert(numPatch>=0); nlassert(numPatch<getNumPatchs()); // Update the patch texture. return Patchs[numPatch].TileColors; }

const CPatchConnect* NL3D::CZone::getPatchConnect (  sint  patch  )  const [inline]

Get a read only patch connect pointer. Parameters: patch  the index of patch to get. Returns: A patch pointer in read only. Definition at line 507 of file src/3d/zone.h. References nlassert, PatchConnects, and sint. Referenced by buildBindInfo(), NL3D::CLandscape::checkZoneBinds(), and NL3D::CZoneCornerSmoother::computeAllCornerSmoothFlags(). {nlassert(patch>=0 && patch<(sint)Patchs.size()); return &(PatchConnects[patch]);}

float NL3D::CZone::getPatchScale (   )  const [inline]

Definition at line 486 of file src/3d/zone.h. References PatchScale. Referenced by NL3D::CPatch::unpack(). {return PatchScale;}

const std::vector< CTileElement > & NL3D::CZone::getPatchTexture (  sint  numPatch  )  const

Get a patch texture. Return the tile array. Parameters: numPatch  the index of patch in this zone which will get his texture. assert if bad id. \return  The tiles the patch texture. The size should be OrderS*OrderT. See also: getPatch() Definition at line 1336 of file 3d/zone.cpp. References getNumPatchs(), nlassert, and sint. { nlassert(numPatch>=0); nlassert(numPatch<getNumPatchs()); // Update the patch texture. return Patchs[numPatch].Tiles; }

const CAABBoxExt& NL3D::CZone::getZoneBB (   )  const [inline]

Definition at line 491 of file src/3d/zone.h. References ZoneBB. Referenced by NL3D::CMiniCol::addZone(), NL3D::CLandscape::addZone(), NL3D::CZoneLighter::buildZoneInformation(), NL3D::CZoneLighter::light(), and NL3D::CLandscape::removeZone(). {return ZoneBB;}

uint16 NL3D::CZone::getZoneId (   )  const [inline]

Definition at line 488 of file src/3d/zone.h. References uint16. Referenced by NL3D::CLandscape::addZone(), NL3D::CZoneLighter::buildZoneInformation(), NL3D::CLandscape::checkZoneBinds(), NL3D::CZoneLighter::copyTileFlags(), NL3D::CZoneLighter::getNormal(), NL3D::CLandscapeUser::refreshZonesAround(), NL3D::CLandscape::removeZone(), and retrieve(). {return ZoneId;}

CPatch * NL3D::CZone::getZonePatch (  TZoneMap &  loadedZones, sint  zoneId, sint  patch )  [static, private]

Definition at line 705 of file 3d/zone.cpp. References sint, and NL3D::TZoneMap. { #ifdef NL3D_DEBUG_DONT_BIND_PATCH return NULL; #endif if(loadedZones.find(zoneId)==loadedZones.end()) return NULL; else return (loadedZones[zoneId])->getPatch(patch); }

bool NL3D::CZone::isPatchRenderClipped (  uint  patch  )  const [inline]

Is the patch clipped (ie not visible). crash if bad Id. Definition at line 539 of file src/3d/zone.h. References _PatchRenderClipped, NLMISC::CBitSet::get(), and uint. Referenced by NL3D::CPatch::isRenderClipped(). {return _PatchRenderClipped.get(patch);}

bool NL3D::CZone::patchOnBorder (  const CPatchConnect &  pc  )  const [private]

Definition at line 882 of file 3d/zone.cpp. References NL3D::CZone::CPatchConnect::BindEdges, nlassert, NL3D::CPatchInfo::CBindInfo::NPatchs, sint, and NL3D::CPatchInfo::CBindInfo::ZoneId. Referenced by rebindBorder(). { // If only one of neighbor patch is not of this zone, we are on a border. // Test all edges. for(sint i=0;i<4;i++) { const CPatchInfo::CBindInfo &pcBind= pc.BindEdges[i]; nlassert(pcBind.NPatchs==0 || pcBind.NPatchs==1 || pcBind.NPatchs==2 || pcBind.NPatchs==4 || pcBind.NPatchs==5); if(pcBind.NPatchs>=1) { if(pcBind.ZoneId != ZoneId) return true; } } return false; }

void NL3D::CZone::preRender (   )

PreRender a zone (if needed). Definition at line 1175 of file 3d/zone.cpp. References _PatchBSpheres, _PatchRenderClipped, ClipOut, ClipResult, ClipSide, Compiled, nlassert, and uint. { nlassert(Compiled); // Must be 2^X-1. static const uint updateFarRefineFreq= 15; // Take the renderDate here. uint curDateMod= CLandscapeGlobals::CurrentRenderDate & updateFarRefineFreq; // If no patchs, do nothing. if(Patchs.empty()) return; /* If patchs invisible, must still update their Far Textures, else, there may be slowdown when we turn the head. */ // If all the zone is invisible. if(ClipResult==ClipOut) { // No patchs are visible, but maybe update the far textures. if( curDateMod==(ZoneId & updateFarRefineFreq) ) { // updateTextureFarOnly for all patchs. for(uint i=0;i<Patchs.size();i++) { Patchs[i].updateTextureFarOnly(_PatchBSpheres[i]); } } } // else If some patchs only are visible. else if(ClipResult==ClipSide) { // PreRender Pass, or updateTextureFarOnly(), according to _PatchRenderClipped state. for(uint i=0;i<Patchs.size();i++) { // If the patch is visible if(!_PatchRenderClipped[i]) { // Then preRender it. Patchs[i].preRender(_PatchBSpheres[i]); } else { // else maybe updateFar it. // ZoneId+i for better repartition. if( curDateMod==((ZoneId+i) & updateFarRefineFreq) ) Patchs[i].updateTextureFarOnly(_PatchBSpheres[i]); } } } else // ClipResult==ClipIn { // PreRender Pass for All for(uint i=0;i<Patchs.size();i++) { Patchs[i].preRender(_PatchBSpheres[i]); } } }

void NL3D::CZone::rebindBorder (  TZoneMap &  loadedZones  )  [private]

Force border patchs (those who don't bind to current zone) to re bind() them, using new neighborood. no-op if zone is not compiled. Definition at line 686 of file 3d/zone.cpp. References bindPatch(), PatchConnects, patchOnBorder(), sint, and NL3D::TZoneMap. { sint j; // rebind patchs which are on border. for(j=0;j<(sint)Patchs.size();j++) { CPatch &pa= Patchs[j]; CPatchConnect &pc= PatchConnects[j]; if(patchOnBorder(pc)) { // rebind the patch. This is a rebind. bindPatch(loadedZones, pa, pc, true); } } }

void NL3D::CZone::refineAll (   )

force Refine a zone. Definition at line 1132 of file 3d/zone.cpp. References Compiled, NL3D::CPatch::ExcludeFromRefineAll, nlassert, NL3D::CPatch::refineAll(), and sint. { nlassert(Compiled); // Fuck stlport.... if(Patchs.size()==0) return; // DO NOT do a forceNoRenderClip(), to avoid big allocation of Near/Far VB vertices in driver. // DO NOT modify ClipResult, to avoid big allocation of Near/Far VB vertices in driver. // refine ALL patchs (even those which may be invisible). CPatch *pPatch= &(*Patchs.begin()); sint n; for(n=(sint)Patchs.size();n>0;n--, pPatch++) { // For Pacs construction: may exclude some patch from refineAll (for speed improvement). if(!pPatch->ExcludeFromRefineAll) pPatch->refineAll(); } }

void NL3D::CZone::refreshTesselationGeometry (  sint  numPatch  )

refresh the geometry (re-compute vertices). Usefull for Tile Noise edition. Do it after calling changePatchTextureAndColor(). NB: a refreshTesselationGeometry() should be done on All patchs, and all direct neighbors of this patch (including patchs on corners). WARNING: specially coded for Tile edition. Result is not perfect: only EndPos of tesselation is modified. because Tile edition always subdivide at max. Pos=EndPos. because TileEdition always subdivide at max, and don't refine... TessBlocks BSphere may be too big. Clip is worse (too big), but doesn't matter. Parameters: numPatch  the index of patch in this zone. assert if bad id. Definition at line 1322 of file 3d/zone.cpp. References NL3D::CLandscape::_RenderMustRefillVB, Compiled, getNumPatchs(), nlassert, and sint. { nlassert(numPatch>=0); nlassert(numPatch<getNumPatchs()); nlassert(Compiled); // At next render, we must re-fill the entire unclipped VB, so change are taken into account. Landscape->_RenderMustRefillVB= true; Patchs[numPatch].refreshTesselationGeometry(); }

void NL3D::CZone::release (  TZoneMap &  loadedZones  )

Release a zone. This method do: detach this zone to loadedZones. destroy/unlink the base vertices (internal..), according to present neigbor zones. unbind() the patchs. release() the patchs. rebindBorder() on neighbor zones. NB: no-op if not compiled. Definition at line 603 of file 3d/zone.cpp. References ClipOut, ClipResult, Compiled, NL3D::ItZoneMap, nlassert, NL3D::CPatch::release(), sint, NL3D::TZoneMap, and unbindPatch(). Referenced by NL3D::CLandscape::removeZone(). { sint i,j; if(!Compiled) return; // detach this zone to loadedZones. //================================= nlassert(loadedZones.find(ZoneId)!=loadedZones.end()); loadedZones.erase(ZoneId); // It doesn't server to unbindPatch(), since patch is not binded to neigbors. // unbind() the patchs. //===================== for(j=0;j<(sint)Patchs.size();j++) { CPatch &pa= Patchs[j]; unbindPatch(pa); } // rebindBorder() on neighbor zones. //================================== // Build the nieghborood. TZoneMap neighborZones; for(i=0;i<(sint)BorderVertices.size();i++) { sint cur= BorderVertices[i].CurrentVertex; sint zoneto= BorderVertices[i].NeighborZoneId; nlassert(cur<NumVertices); if(loadedZones.find(zoneto)!=loadedZones.end()) { CZone *zone; zone= (*loadedZones.find(zoneto)).second; nlassert(zone!=this); // insert the zone in the neigborood (if not done...). neighborZones[zoneto]= zone; } } // rebind borders. ItZoneMap zoneIt; // Traverse the neighborood. for(zoneIt= neighborZones.begin(); zoneIt!=neighborZones.end(); zoneIt++) { // Since (*zoneIt).second->rebindBorder(loadedZones); } // release() the patchs. //====================== // unbind() need compiled neigbor patchs, so do the release after all unbind (so after rebindBorder() too...). for(j=0;j<(sint)Patchs.size();j++) { CPatch &pa= Patchs[j]; pa.release(); } // destroy/unlink the base vertices (internal..), according to present neigbor zones. //================================= // Just release the smartptrs (easy!!). Do it after patchs released... BaseVertices.clear(); // End!! Compiled= false; Landscape= NULL; ClipResult= ClipOut; }

void NL3D::CZone::resetRenderFarAndDeleteVBFV (   )

Definition at line 1240 of file 3d/zone.cpp. References _PatchRenderClipped, NLMISC::CBitSet::set(), and uint. { for(uint i=0;i<Patchs.size();i++) { // If patch is visible if(!_PatchRenderClipped[i]) { // release VertexBuffer, and FaceBuffer Patchs[i].deleteVBAndFaceVector(); // Flag. _PatchRenderClipped.set(i, true); } Patchs[i].resetRenderFar(); } }

void NL3D::CZone::retrieve (  std::vector< CPatchInfo > &  patchs, std::vector< CBorderVertex > &  borderVertices )

Retrieve zone patchinfo. Deprecated. Should use retrieve(CZoneInfo &) instead. see this method. Definition at line 278 of file 3d/zone.cpp. References NL3D::CZoneInfo::BorderVertices, NL3D::CZoneInfo::Patchs, and retrieve(). { CZoneInfo zinfo; retrieve(zinfo); patchs= zinfo.Patchs; borderVertices= zinfo.BorderVertices; }

void NL3D::CZone::retrieve (  CZoneInfo &  zoneInfo  )

Retrieve zone patchinfo. This method uncompress the patchs coordinates and all info into the patch info/borderVertices. Warning!!! Due to compression, data won't be the same as those given in build(). Same remark for TileLightInfluences, due to light sorting. Definition at line 289 of file 3d/zone.cpp. References NL3D::CZone::CPatchConnect::BaseVertices, NL3D::CPatchInfo::BaseVertices, NL3D::CZone::CPatchConnect::BindEdges, NL3D::CPatchInfo::BindEdges, NL3D::CZoneInfo::BorderVertices, NL3D::CZone::CPatchConnect::ErrorSize, NL3D::CPatchInfo::ErrorSize, NL3D::CPatch::Flags, NL3D::CPatchInfo::Flags, NL3D::CPatch::getCornerSmoothFlag(), NL3D::CPointLightNamedArray::getPointLights(), getZoneId(), NL3D::CBezierPatch::Interiors, NL3D::CPatch::Interiors, NL3D::CPatchInfo::Lumels, NL_PATCH_SMOOTH_FLAG_MASK, NL_PATCH_SMOOTH_FLAG_SHIFT, NL3D::CPatch::NoiseRotation, NL3D::CPatchInfo::NoiseRotation, NL3D::CPatchInfo::OrderS, NL3D::CPatch::OrderS, NL3D::CPatchInfo::OrderT, NL3D::CPatch::OrderT, NL3D::CPatchInfo::Patch, PatchBias, PatchConnects, NL3D::CZoneInfo::Patchs, PatchScale, NL3D::CZoneInfo::PointLights, NL3D::CPatchInfo::setCornerSmoothFlag(), sint, NL3D::CBezierPatch::Tangents, NL3D::CPatch::Tangents, NL3D::CPatch::TileColors, NL3D::CPatchInfo::TileColors, NL3D::CPatch::TileLightInfluences, NL3D::CPatchInfo::TileLightInfluences, NL3D::CPatch::Tiles, NL3D::CPatchInfo::Tiles, NL3D::CVector3s::unpack(), NL3D::CPatch::unpackShadowMap(), NL3D::CBezierPatch::Vertices, NL3D::CPatch::Vertices, and NL3D::CZoneInfo::ZoneId. Referenced by NL3D::CZoneLighter::light(), and retrieve(). { sint i,j; // Ref on input. std::vector<CPatchInfo> &patchs= zoneInfo.Patchs; std::vector<CBorderVertex> &borderVertices= zoneInfo.BorderVertices; // Copy zoneId. zoneInfo.ZoneId= getZoneId(); // uncompress Patchs. //========================= patchs.resize(Patchs.size()); for(j=0;j<(sint)patchs.size();j++) { CPatchInfo &pi= patchs[j]; CBezierPatch &p= pi.Patch; CPatch &pa= Patchs[j]; CPatchConnect &pc= PatchConnects[j]; // Smoothing flags pi.Flags= (pa.Flags&NL_PATCH_SMOOTH_FLAG_MASK)>>NL_PATCH_SMOOTH_FLAG_SHIFT; // Noise Data // copy noise rotation. pi.NoiseRotation= pa.NoiseRotation; // copy all noise smoothing info. for(i=0;i<4;i++) { pi.setCornerSmoothFlag(i, pa.getCornerSmoothFlag(i)); } // re-Build the uncompressed bezier patch. for(i=0;i<4;i++) pa.Vertices[i].unpack(p.Vertices[i], PatchBias, PatchScale); for(i=0;i<8;i++) pa.Tangents[i].unpack(p.Tangents[i], PatchBias, PatchScale); for(i=0;i<4;i++) pa.Interiors[i].unpack(p.Interiors[i], PatchBias, PatchScale); pi.Tiles= pa.Tiles; pi.TileColors= pa.TileColors; pi.TileLightInfluences= pa.TileLightInfluences; pi.Lumels.resize ((pa.OrderS*4)*(pa.OrderT*4)); pi.Flags=(pa.Flags&NL_PATCH_SMOOTH_FLAG_MASK)>>NL_PATCH_SMOOTH_FLAG_SHIFT; // Unpack the lumel map pa.unpackShadowMap (&pi.Lumels[0]); // from the patchConnect. pi.OrderS= pa.OrderS; pi.OrderT= pa.OrderT; pi.ErrorSize= pc.ErrorSize; for(i=0;i<4;i++) { pi.BaseVertices[i]= pc.BaseVertices[i]; } for(i=0;i<4;i++) pi.BindEdges[i]= pc.BindEdges[i]; } // retrieve bordervertices. //========================= borderVertices= BorderVertices; // retrieve PointLights. //========================= zoneInfo.PointLights= _PointLightArray.getPointLights(); }

void NL3D::CZone::serial (  NLMISC::IStream &  f  )

Load/save a zone. Save work even if zone is not compiled, but load must be done on a not compiled zone... Definition at line 432 of file 3d/zone.cpp. References _PatchOldRenderClipped, _PatchRenderClipped, NLMISC::IStream::isReading(), PatchBias, PatchConnects, PatchScale, NLMISC::CBitSet::resize(), NLMISC::IStream::serial(), NLMISC::IStream::serialCheck(), NLMISC::IStream::serialCont(), NLMISC::IStream::serialVersion(), NLMISC::CBitSet::setAll(), uint, uint32, NLMISC::IStream::xmlPop(), NLMISC::IStream::xmlPush(), NLMISC::IStream::xmlSerial(), and ZoneBB. Referenced by NL3D::CZoneLoadingTask::run(). { /* Version 4: - PointLights Version 3: - Lumels compression version 2. Version 2: - Lumels. Version 1: - Tile color. Version 0: - base verison. */ uint ver= f.serialVersion(4); // No more compatibility before version 3 if (ver<3) { throw EOlderStream(f); } f.serialCheck((uint32)'ENOZ'); f.xmlSerial (ZoneId, "ZONE_ID"); f.xmlSerial (ZoneBB, "BB"); f.xmlSerial (PatchBias, "PATCH_BIAS"); f.xmlSerial (PatchScale, "PATCH_SCALE"); f.xmlSerial (NumVertices, "NUM_VERTICES"); f.xmlPush ("BORDER_VERTICES"); f.serialCont(BorderVertices); f.xmlPop (); f.xmlPush ("PATCHES"); f.serialCont(Patchs); f.xmlPop (); f.xmlPush ("PATCH_CONNECTS"); f.serialCont(PatchConnects); f.xmlPop (); if (ver>=4) { f.xmlPush ("POINT_LIGHTS"); f.serial(_PointLightArray); f.xmlPop (); } // If read, must create and init Patch Clipped state to true (clipped even if not compiled) if(f.isReading()) { _PatchRenderClipped.resize(Patchs.size()); _PatchOldRenderClipped.resize(Patchs.size()); _PatchRenderClipped.setAll(); _PatchOldRenderClipped.setAll(); } // If read and version 0, must init default TileColors of patchs. //=============================================================== // if(f.isReading() && ver<2) ... // Deprecated, because ver<3 not supported }

void NL3D::CZone::setTileColor (  bool  monochrome, float  factor )

Set the zone tile color to monochrome or not and apply multiplier factor Set all tile colors of all patch of this zone to monochrome or not and apply a multiplier factor convertion to monochrome is done by that formula : newR = newG = newB = 0.28 * R + 0.59 * G + 0.13 * B; for monochrome the factor is applied like for the color mode Definition at line 1357 of file 3d/zone.cpp. References nlassert, uint16, and uint32. Referenced by NL3D::CZoneLoadingTask::run(). { nlassert(factor >= 0.0f); // factor must not be negative as its a multiplier if (monochrome) { for (uint32 i = 0; i < Patchs.size(); ++i) { vector<CTileColor> &rTC = Patchs[i].TileColors; for (uint32 j = 0; j < rTC.size(); ++j) { float fR = (rTC[j].Color565 & 31) / 32.0f; float fG = ((rTC[j].Color565 >> 5) & 63) / 64.0f; float fB = ((rTC[j].Color565 >> 11) & 31) / 32.0f; fR = 0.28f * fR + 0.59f * fG + 0.13f * fB; nlassert(fR < 0.99f); fR *= factor; if (fR > 0.99f) fR = 0.99f; // Avoid reaching 1 uint16 nR = (uint16)(fR * 32.0f); uint16 nG = (uint16)(fR * 64.0f); uint16 nB = (uint16)(fR * 32.0f); rTC[j].Color565 = nR + (nG << 5) + (nB << 11); } } } else { if (factor != 1.0f) { for (uint32 i = 0; i < Patchs.size(); ++i) { vector<CTileColor> &rTC = Patchs[i].TileColors; for (uint32 j = 0; j < rTC.size(); ++j) { float fR = (rTC[j].Color565 & 31) / 32.0f; float fG = ((rTC[j].Color565 >> 5) & 63) / 64.0f; float fB = ((rTC[j].Color565 >> 11) & 31) / 32.0f; fR *= factor; fG *= factor; fB *= factor; if (fR > 0.99f) fR = 0.99f; if (fG > 0.99f) fG = 0.99f; if (fB > 0.99f) fB = 0.99f; uint16 nR = (uint16)(fR * 32.0f); uint16 nG = (uint16)(fG * 64.0f); uint16 nB = (uint16)(fB * 32.0f); rTC[j].Color565 = nR + (nG << 5) + (nB << 11); } } } } }

void NL3D::CZone::setupColorsFromTileFlags (  const NLMISC::CRGBA  colors[4]  )

Debug purpose only : setup the colors of the patch of this zone so that it shows which tiles have vegetable disabled, or are above, below water. User provides a table with 4 colors for each state : color 0 = above water color 1 = underwater color 2 = intersect water color 3 = vegetable disabled Definition at line 1532 of file 3d/zone.cpp. References uint. { for (uint k = 0; k < Patchs.size(); ++k) { Patchs[k].setupColorsFromTileFlags(colors); } }

void NL3D::CZone::unbindPatch (  CPatch &  pa  )  [static, private]

Definition at line 868 of file 3d/zone.cpp. References NL3D::CPatch::unbind(). Referenced by release(). { /* Remind: the old version with CPatch::unbindFrom*() doesn't work because of CZone::release(). This function first erase the zone from loadedZones... Not matter here. We use CPatch::unbind() which should do all the good job correctly (unbind pa from ohters , and unbind others from pa at same time). */ pa.unbind(); }

---

Friends And Related Function Documentation

friend class CLandscape [friend]

Definition at line 590 of file src/3d/zone.h.

friend class CPatch [friend]

Definition at line 593 of file src/3d/zone.h.

friend class CTessFace [friend]

Definition at line 591 of file src/3d/zone.h.

---

Field Documentation

std::vector<CBSphere> NL3D::CZone::_PatchBSpheres [private]

Definition at line 579 of file src/3d/zone.h. Referenced by clipPatchs(), compile(), getPatchBSphere(), and preRender().

NLMISC::CBitSet NL3D::CZone::_PatchOldRenderClipped [private]

Definition at line 581 of file src/3d/zone.h. Referenced by build(), clip(), NL3D::CPatch::release(), and serial().

NLMISC::CBitSet NL3D::CZone::_PatchRenderClipped [private]

Definition at line 580 of file src/3d/zone.h. Referenced by build(), changePatchTextureAndColor(), clip(), clipPatchs(), isPatchRenderClipped(), preRender(), NL3D::CPatch::release(), resetRenderFarAndDeleteVBFV(), and serial().

CPointLightNamedArray NL3D::CZone::_PointLightArray [private]

List of PointLights that may influences Patchs and objects walking on them. Definition at line 586 of file src/3d/zone.h. Referenced by NL3D::CLandscape::addZone(), NL3D::CPatch::appendTileLightInfluences(), build(), and NL3D::CPatch::getCurrentTileTLIColors().

TBaseVerticesVec NL3D::CZone::BaseVertices [private]

Definition at line 570 of file src/3d/zone.h.

std::vector<CBorderVertex> NL3D::CZone::BorderVertices [private]

Definition at line 572 of file src/3d/zone.h. Referenced by build().

sint NL3D::CZone::ClipResult [private]

Definition at line 595 of file src/3d/zone.h. Referenced by clip(), CZone(), preRender(), and release().

bool NL3D::CZone::Compiled [private]

Definition at line 562 of file src/3d/zone.h. Referenced by averageTesselationVertices(), build(), changePatchTextureAndColor(), clip(), compile(), compiled(), CZone(), excludePatchFromRefineAll(), preRender(), refineAll(), refreshTesselationGeometry(), release(), and ~CZone().

CLandscape* NL3D::CZone::Landscape [private]

Definition at line 558 of file src/3d/zone.h. Referenced by NL3D::CPatch::computeNewFar(), NL3D::CPatch::getTileLightMap(), NL3D::CPatch::getTileLightMapUvInfo(), NL3D::CPatch::getTileRenderPass(), NL3D::CPatch::getTileUvInfo(), NL3D::CPatch::releaseTileLightMap(), NL3D::CPatch::resetRenderFar(), and NL3D::CPatch::updateTessBlockLighting().

sint32 NL3D::CZone::NumVertices [private]

Definition at line 568 of file src/3d/zone.h. Referenced by build().

CVector NL3D::CZone::PatchBias [private]

Definition at line 564 of file src/3d/zone.h. Referenced by applyHeightField(), build(), computeBBScaleBias(), getPatchBias(), retrieve(), and serial().

std::vector<CPatchConnect> NL3D::CZone::PatchConnects [private]

Definition at line 577 of file src/3d/zone.h. Referenced by build(), buildBindInfo(), compile(), debugBinds(), getPatchConnect(), rebindBorder(), retrieve(), and serial().

std::vector<CPatch> NL3D::CZone::Patchs [private]

Definition at line 576 of file src/3d/zone.h. Referenced by build().

float NL3D::CZone::PatchScale [private]

Definition at line 565 of file src/3d/zone.h. Referenced by applyHeightField(), build(), computeBBScaleBias(), getPatchScale(), retrieve(), and serial().

CAABBoxExt NL3D::CZone::ZoneBB [private]

Definition at line 563 of file src/3d/zone.h. Referenced by build(), clip(), computeBBScaleBias(), getZoneBB(), and serial().

uint16 NL3D::CZone::ZoneId [private]

Definition at line 561 of file src/3d/zone.h. Referenced by build().

---

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

• src/3d/zone.h
• 3d/zone.cpp

---