A DtBoundingVolumeTerrainSourceTracker tracks data from a paging terrain source for purposes such as determining whether the data necessary to intersect with specified geometry is available, generating commands to page in that geometry, and to determine what to page out when necessary.

Inheritance diagram for DtBoundingVolumeTerrainSourceTracker:

[legend]

Classes
struct	DtNodeStatusSSELement

Public Types
typedef std::shared_ptr < DtNodeStatusSSELement >	DtNodeStatusSSElementPtr

typedef DtSpatialSubdivision < DtNodeBoundingInfoPtr >	DtSpatialNodeBoundingInfoContainer

typedef DtSpatialSubdivision < DtNodeStatusSSElementPtr >	DtSpatialNodeStatusContainer

Public Member Functions
	DtBoundingVolumeTerrainSourceTracker (DtVantageTerrainEngine , DtPagerCommandQueue commandQueue)

virtual	~DtBoundingVolumeTerrainSourceTracker () override

virtual void	updatePagedOutInfo (const DtNodeBoundingInfoList &volumes, bool invalid=false)

virtual void	updatePagedOutInfo (const DtNodeBoundingInfoList &volumes, const DtNodeBoundingInfoList &removed, bool invalid=false)

virtual void	updatePagedInInfo (const DtNodeBoundingInfoMap &volumes, DtTerrainIntersectIDType intersectId=0)

virtual void	removePagedInInfo (DtNodeId node)

virtual bool	dataAvailable (DtPagingMetaDataPtr metaData, DtTerrainPagingGeometryPtr geometry) override

virtual bool	isPagedOut (DtTerrainPagingGeometryPtr geometry, std::set< std::string > &retVec)

virtual void	pageInData (DtPagingMetaDataPtr metaData, DtTerrainPagingGeometryPtr geometry) override

virtual bool	canPageOutData (DtTerrainIntersectIDType intersectId) override

virtual void	pageOutOldestData (const int priority) override

virtual DtTerrainIntersectIDType	findOldestPagedData (unsigned int &numTrianglesOut) override

virtual void	printInfo () const override

virtual bool	geometryIntersectPagedOutNodes (DtTerrainPagingGeometryPtr geometry)

virtual bool	geometryIntersectPagedOutNodes (DtTerrainPagingGeometryPtr geometry, std::set< std::string > &retVec)

virtual bool	geometryIntersectPagedInNodes (DtPagingMetaDataPtr metaData, DtTerrainPagingGeometryPtr geometry)

virtual void	getPageOutData (DtNodeBoundingList &nodeBoundingList) override

virtual void	getPageInData (DtNodeBoundingList &nodeBoundingList) override

Public Member Functions inherited from DtTerrainSourceTracker
	DtTerrainSourceTracker (DtVantageTerrainEngine , DtPagerCommandQueue commandQueue, osgEarth::MapNode *mapNode)

virtual	~DtTerrainSourceTracker ()

virtual DtTerrainInterfaceConfig &	configOptions ()

virtual const DtTerrainInterfaceConfig &	configOptions () const

virtual bool	init (DtTerrainSourcePager &)

virtual boost::optional < DtTerrainIntersectOptions::Fidelity >	intersectFidelity () const

virtual DtTerrainCategoryMask	terrainCategories () const

virtual void	addNodesToCollisionMapping (DtNodeId node, DtCollisionObjectList *collObjList)

virtual void	removeNodeToCollisionMappings (DtNodeId node)

virtual DtCollisionObjectList	collisionObjectsForNode (DtNodeId node)

virtual osgEarth::MapNode *	mapNode () const

virtual const osgEarth::Profile *	profile () const

virtual const Coordinate_System *	localCS () const

virtual void	setLabel (const DtString &)

virtual DtString	label () const

virtual void	getProceduralTreeTile (DtDebugDrawTerrainOutputInterface::terrainLineList &nodeBoundingList)

virtual unsigned	getMaxLODForBilinearIntersection () const

virtual double	intersetionTriangleMergeTolerance () const

virtual bool	useLandCoverData () const

virtual bool	useLifeMapLayer () const

virtual void	getSoilFromString (const std::string &soilType, DtSurface &surface) const

virtual double	triangleOutputMergeTolerance () const

virtual unsigned	minElevationIndexLOD () const

virtual unsigned	maxElevationIndexLOD () const

virtual unsigned	maxLOD () const

virtual bool	useRawElevation () const

virtual osgEarth::TileKey	getBestTileKey (const osgEarth::TileKey &) const

virtual bool	findTileInCache (const DtTerrainPagingGeometry geometry, std::vector< std::shared_ptr< DtTileData > > &data, const DtChord chord=NULL) const

virtual void	addTileToCache (const std::shared_ptr< DtTileData > &data, const DtChord *chord=NULL)

virtual void	clearTileCache ()

virtual unsigned	minElevationTileLoadingLOD () const

virtual void	setMinElevationTileLoading (unsigned lod)

Protected Member Functions
virtual bool	geometryIntersectPagedOutNodes (const DtSphere &sphere)

virtual bool	geometryIntersectPagedOutNodes (const DtLocalVertexList &vertexList)

virtual bool	geometryIntersectPagedOutNodes (const DtChord &chord)

virtual bool	geometryIntersectPagedOutNodes (const DtSphere &sphere, std::set< std::string > &retVec)

virtual bool	geometryIntersectPagedOutNodes (const DtLocalVertexList &vertexList, std::set< std::string > &retVec)

virtual bool	geometryIntersectPagedOutNodes (const DtChord &chord, std::set< std::string > &retVec)

virtual bool	geometryIntersectPagedInNodes (DtPagingMetaDataPtr metaData, const DtSphere &sphere)

virtual bool	geometryIntersectPagedInNodes (DtPagingMetaDataPtr metaData, const DtLocalVertexList &vertexList)

virtual bool	geometryIntersectPagedInNodes (DtPagingMetaDataPtr metaData, const DtChord &chord)

virtual DtTerrainIntersectIDType	findOldestPagedDataUnlocked (unsigned int &numTrianglesOut)

virtual DtPageInGeometryCommand *	createPageInGeometryCommand (DtPagingMetaDataPtr metaData)

virtual DtPageOutNodesCommand *	createPageOutNodesCommand (DtPagingMetaDataPtr metaData)

virtual unsigned int	getNumTriangles (DtNodeId node)

Protected Attributes
DtNodeBoundingInfoList	myPagedOutAreas

DtPagedNodeStatusMap	myPagedInAreas

std::atomic< bool >	myInvalidFlag

DtNodeId	myOldestPagedObject

std::atomic< bool >	myRecomputeOldestPagedObject

DtSpatialNodeBoundingInfoContainer *	myPagedOutSpatialNodeContainer

DtSpatialNodeStatusContainer *	myPagedInSpatialNodeContainer

const Coordinate_System *	myCoordSys

tbb::spin_rw_mutex	myPagedInMutex

tbb::spin_rw_mutex	myPagedOutMutex

DtVector	mySpatialSubdivisionDimensions

Protected Attributes inherited from DtTerrainSourceTracker
DtString	myLabel

DtTerrainInterfaceConfig	myConfig

DtPagerCommandQueue *	myCommandQueue

DtNodeToCollObjMMap	myNodeToCollObjMMap

tbb::spin_rw_mutex	myMutex

tbb::spin_rw_mutex	myTileCacheMutex

DtVantageTerrainEngine *	myVantageTerrainEngine

const osg::ref_ptr < osgEarth::MapNode >	myMapNode

const osgEarth::Map *	myMap

const osgEarth::Profile *	myMapProfile

tileDataCacheVector	myTileDataCache

std::atomic< int >	myTileCacheHit

std::atomic< int >	myTileCacheQuery

unsigned	myMinElevationTileLoadingLOD

DtTerrainSourcePager *	myPager

Member Typedef Documentation

typedef std::shared_ptr<DtNodeStatusSSELement> DtBoundingVolumeTerrainSourceTracker::DtNodeStatusSSElementPtr

typedef DtSpatialSubdivision<DtNodeBoundingInfoPtr> DtBoundingVolumeTerrainSourceTracker::DtSpatialNodeBoundingInfoContainer

typedef DtSpatialSubdivision<DtNodeStatusSSElementPtr> DtBoundingVolumeTerrainSourceTracker::DtSpatialNodeStatusContainer

Constructor & Destructor Documentation

DtBoundingVolumeTerrainSourceTracker::DtBoundingVolumeTerrainSourceTracker	(	DtVantageTerrainEngine *	,
		DtPagerCommandQueue *	commandQueue
	)

virtual DtBoundingVolumeTerrainSourceTracker::~DtBoundingVolumeTerrainSourceTracker ( )

overridevirtual

Member Function Documentation

virtual void DtBoundingVolumeTerrainSourceTracker::updatePagedOutInfo	(	const DtNodeBoundingInfoList &	volumes,
		bool	invalid = `false`
	)

virtual

virtual void DtBoundingVolumeTerrainSourceTracker::updatePagedOutInfo	(	const DtNodeBoundingInfoList &	volumes,
		const DtNodeBoundingInfoList &	removed,
		bool	invalid = `false`
	)

virtual

This version allows the caller to pass in a list of volumes which have been removed, which can be much more efficient if there are a lot of volumes.

virtual void DtBoundingVolumeTerrainSourceTracker::updatePagedInInfo	(	const DtNodeBoundingInfoMap &	volumes,
		DtTerrainIntersectIDType	intersectId = `0`
	)

virtual

virtual void DtBoundingVolumeTerrainSourceTracker::removePagedInInfo ( DtNodeId node )

virtual

virtual bool DtBoundingVolumeTerrainSourceTracker::dataAvailable	(	DtPagingMetaDataPtr	metaData,
		DtTerrainPagingGeometryPtr	geometry
	)

overridevirtual

Returns: True if all data along this chord has been paged in.

Implements DtTerrainSourceTracker.

Reimplemented in DtPagedNode2TerrainSourceTracker.

virtual bool DtBoundingVolumeTerrainSourceTracker::isPagedOut	(	DtTerrainPagingGeometryPtr	geometry,
		std::set< std::string > &	retVec
	)

virtual

virtual void DtBoundingVolumeTerrainSourceTracker::pageInData	(	DtPagingMetaDataPtr	metaData,
		DtTerrainPagingGeometryPtr	geometry
	)

overridevirtual

Page in data within geometry. Determines which tiles are within the geometry and adds a page in command to myCommandQueue to page in any tiles within the geometry that have not yet been paged in.

Parameters

geometry	The geometry to page in data within.
intersectId	Id to assign to the page in command to seed tileData for newly paged-in tiles.
priority	Priority to use for commands generated by this call.

Implements DtTerrainSourceTracker.

Reimplemented in DtPagedNode2TerrainSourceTracker.

virtual bool DtBoundingVolumeTerrainSourceTracker::canPageOutData ( DtTerrainIntersectIDType intersectId )

overridevirtual

Implements DtTerrainSourceTracker.

Reimplemented in DtPagedNode2TerrainSourceTracker.

virtual void DtBoundingVolumeTerrainSourceTracker::pageOutOldestData ( const int priority )

overridevirtual

Adds a page out command for the least-recently-used tileID to myCommandQueue.

Parameters

priority Priority to use for commands generated by this call.

Implements DtTerrainSourceTracker.

Reimplemented in DtPagedNode2TerrainSourceTracker.

virtual DtTerrainIntersectIDType DtBoundingVolumeTerrainSourceTracker::findOldestPagedData ( unsigned int & numTriangles )

overridevirtual

Finds the least-recently-used tile and set myOldestPagedObject to it.

Parameters

numTrianglesOut The number of triangles the least-recently-used tileId represents in the collision world.

Returns: The id of the last intersect test for which this tracker's least-recently-used data was necessary.

Implements DtTerrainSourceTracker.

Reimplemented in DtPagedNode2TerrainSourceTracker.

virtual void DtBoundingVolumeTerrainSourceTracker::printInfo ( ) const

overridevirtual

Reimplemented from DtTerrainSourceTracker.

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedOutNodes ( DtTerrainPagingGeometryPtr geometry )

virtual

check if the geometry intersect a paged out nodes (return true if it does, false otherwise) exist on the first intersection it gets

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedOutNodes	(	DtTerrainPagingGeometryPtr	geometry,
		std::set< std::string > &	retVec
	)

virtual

check if the geometry intersect a paged out nodes (return true if it does, false otherwise) insert paged out nodes filename found into the retVec (and does not exits when intersection found)

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedInNodes	(	DtPagingMetaDataPtr	metaData,
		DtTerrainPagingGeometryPtr	geometry
	)

virtual

check if the geometry intersect a paged int nodes (return true if it does, false otherwise) exist on the first intersection it gets

virtual void DtBoundingVolumeTerrainSourceTracker::getPageOutData ( DtNodeBoundingList & nodeBoundingList )

overridevirtual

Return a copy of the paged out node bounding sphere.

Reimplemented from DtTerrainSourceTracker.

virtual void DtBoundingVolumeTerrainSourceTracker::getPageInData ( DtNodeBoundingList & nodeBoundingList )

overridevirtual

Return a copy of the paged in node bounding sphere.

Reimplemented from DtTerrainSourceTracker.

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedOutNodes ( const DtSphere & sphere )

protectedvirtual

check if the geometry intersect a paged out nodes (return true if it does, false otherwise) exist on the first intersection it gets

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedOutNodes ( const DtLocalVertexList & vertexList )

protectedvirtual

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedOutNodes ( const DtChord & chord )

protectedvirtual

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedOutNodes	(	const DtSphere &	sphere,
		std::set< std::string > &	retVec
	)

protectedvirtual

check if the geometry intersect a paged out nodes (return true if it does, false otherwise) insert paged out nodes filename found into the retVec (and does not exits when intersection found) Note: these function are duplicated on purpose for performance reason

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedOutNodes	(	const DtLocalVertexList &	vertexList,
		std::set< std::string > &	retVec
	)

protectedvirtual

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedOutNodes	(	const DtChord &	chord,
		std::set< std::string > &	retVec
	)

protectedvirtual

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedInNodes	(	DtPagingMetaDataPtr	metaData,
		const DtSphere &	sphere
	)

protectedvirtual

check if the geometry intersect a paged in nodes (return true if it does, false otherwise) exist on the first intersection it gets

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedInNodes	(	DtPagingMetaDataPtr	metaData,
		const DtLocalVertexList &	vertexList
	)

protectedvirtual

virtual bool DtBoundingVolumeTerrainSourceTracker::geometryIntersectPagedInNodes	(	DtPagingMetaDataPtr	metaData,
		const DtChord &	chord
	)

protectedvirtual

virtual DtTerrainIntersectIDType DtBoundingVolumeTerrainSourceTracker::findOldestPagedDataUnlocked ( unsigned int & numTrianglesOut )

protectedvirtual

virtual DtPageInGeometryCommand* DtBoundingVolumeTerrainSourceTracker::createPageInGeometryCommand ( DtPagingMetaDataPtr metaData )

protectedvirtual

virtual DtPageOutNodesCommand* DtBoundingVolumeTerrainSourceTracker::createPageOutNodesCommand ( DtPagingMetaDataPtr metaData )

protectedvirtual

virtual unsigned int DtBoundingVolumeTerrainSourceTracker::getNumTriangles ( DtNodeId node )

protectedvirtual

Member Data Documentation

DtNodeBoundingInfoList DtBoundingVolumeTerrainSourceTracker::myPagedOutAreas

protected

For now, just a primitive list of spheres. This should be an optimized data structure for speed.

DtPagedNodeStatusMap DtBoundingVolumeTerrainSourceTracker::myPagedInAreas

protected

List of paged in volumes. Used for tracking usage for paging out.

std::atomic<bool> DtBoundingVolumeTerrainSourceTracker::myInvalidFlag

protected

DtNodeId DtBoundingVolumeTerrainSourceTracker::myOldestPagedObject

protected

std::atomic<bool> DtBoundingVolumeTerrainSourceTracker::myRecomputeOldestPagedObject

protected

DtSpatialNodeBoundingInfoContainer* DtBoundingVolumeTerrainSourceTracker::myPagedOutSpatialNodeContainer

protected

Spatial subdivision for finding relevant bounding nodes. The subdivision is projected into topo from the origin of the terrain. Dimensions are specified in terrainOptions.mtl as "spatial-subdivision-dimensions".

DtSpatialNodeStatusContainer* DtBoundingVolumeTerrainSourceTracker::myPagedInSpatialNodeContainer

protected

const Coordinate_System* DtBoundingVolumeTerrainSourceTracker::myCoordSys

protected

tbb::spin_rw_mutex DtBoundingVolumeTerrainSourceTracker::myPagedInMutex

mutableprotected

tbb::spin_rw_mutex DtBoundingVolumeTerrainSourceTracker::myPagedOutMutex

mutableprotected

DtVector DtBoundingVolumeTerrainSourceTracker::mySpatialSubdivisionDimensions

protected

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

/data/exports/nrhent7-1/nightly/docs/vrForces.vrf5-2-branch/include/vantageTerrainImplementation/boundingVolumeTerrainSourceTracker.h

Classes

Public Types

Public Member Functions

Protected Member Functions

Protected Attributes

Member Typedef Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation