DtExtentTerrainImplementation Class Reference

Inheritance diagram for DtExtentTerrainImplementation:

Public Member Functions
	DtExtentTerrainImplementation (DtConsoleCommandManager *cmdMgr)
virtual	~DtExtentTerrainImplementation ()
virtual bool	loadTerrain (const makArchives::DtGenericTerrainRecord &record)
	Loads a terrain given the terrain record.
virtual const Coordinate_System *	coordinateSystem () const
virtual bool	chordIntersect (const DtChord &chord, DtVrfChordIntersectionRecord &record, DtIntersectionRecord::DtIntersectionType irtFlag=DtIntersectionRecord::INT_ALL_DATA, bool *dataAvailable=0, bool overrideBlockingAssert=false, int flags=0) const
	Returns topmost intersection of chord with terrain in record.
virtual bool	allIntersectsAlongChord (const DtChord &chord, DtVrfChordIntersectRecordList &intList, DtIntersectionRecord::DtIntersectionType irtFlag=DtIntersectionRecord::INT_ALL_DATA, bool *dataAvailable=0, bool overrideBlockingAssert=false, int flags=0) const
	Returns all intersections of chord with terrain.
virtual const DtTerrainCapabilities *	terrainCapabilities () const
virtual void	processTrianglesInArea (DtTriangleCallbackFcn func, DtTriangleCallbackFinalizeFcn finalize, const DtTerrainProcessPolygonsBox &box, void *usr)
Public Member Functions inherited from DtTerrainImplementation
	DtTerrainImplementation (DtConsoleCommandManager *cmdManager)
virtual	~DtTerrainImplementation ()
virtual MAKVRinTerra::DtFeatureDatabase &	featureDatabase ()
	Access feature database.
virtual const MAKVRinTerra::DtFeatureDatabase &	featureDatabase () const
virtual MAKVRinTerra::DtFeatureContext &	featureContext ()
	Access feature context.
virtual const MAKVRinTerra::DtFeatureContext &	featureContext () const
virtual void	init ()
	Called immediately after creation.
virtual void	finishedLoading (const MAKVRinTerra::DtProj &proj)
	Called after terrain loaded successfully.
virtual void	shutdown (bool block=true)
	Shutdown the terrain.
virtual double	modelHeightDifferencesFromAppearances (int oldApp, int newApp) const
	If supported by the implementation, return the height difference from the currently loaded model as a transition from the old appearance to the new appearance.
virtual bool	createFromExtent (const Dt3dBoundingVolume &)
	Creates an extent from the given extent. Not all implementations will support this.
virtual bool	loadModel (const DtFilename &, const DtEntityType &t=DtEntityType())
	Defaults to loading terrain for gdb.
virtual DtTerrainInterfaceConfig &	configurationOptions ()
virtual const DtTerrainInterfaceConfig &	configurationOptions () const
virtual void	preloadTerrainAreas (const DtTerrainPagingGeometryList &preloadGeometry)
	Specifies a list of terrain areas that should be preloaded by the terrain implementation, in the case of a paging or streaming terrain source.
virtual void	setIntersectDataLoadExpireTime (const double &expireTime)
	No-op.
virtual void	expireDataLoadRequestsBeforeTime (const double &currentTime)
	No-op.
virtual void	processTrianglesInArea (DtTriangleCallbackFcn func, DtTriangleCallbackFinalizeFcn finalize, DtTerrainProcessPolygonsBox &box, void *usr) const
virtual void	breakUpChords (const MAKVRinTerra::DtProj &, const DtChord &chord, std::vector< DtChord > &chords)
virtual bool	hasFeatureContext () const
	Returns true if there is an active feature context.
virtual DtDynamicTerrainRequestHandle	addDynamicTerrainChangeRequest (double time, makVrv::DtDynamicTerrainChange *command)
	Add a dynamic terrain change request to the system.
virtual DtDynamicTerrainQueryHandle	queryDynamicTerrainFeatures (const DtDynamicTerrainQueryCallback &callback, makVrv::DtDynamicTerrainGeometry *geometry=0)
	Install a query which will call the supplied callback on matching dynamic terrain features as they are paged in.
virtual void	queryCurrentDynamicTerrainFeatures (const DtDynamicTerrainQueryCallback &callback, makVrv::DtDynamicTerrainGeometry *geometry=0)
virtual void	setAssertOnBlockingTerrainCalls (bool assertBlock)
	Determines if an exception should be thrown if a blocking terrain call is made.
virtual bool	assertOnBlockingTerrainCalls () const
virtual void	setWarnOnBlockingTerrainCalls (bool warnBlock)
	Determines if a warning should be printed out if a blocking terrain call is made.
virtual bool	warnOnBlockingTerrainCalls () const

Static Public Member Functions
static DtTerrainImplementation *	create (DtConsoleCommandManager *cmdMgr)

Protected Member Functions
void	fillHitRecord (DtChordIntersectionRecord &rec, const DtChord &chord, const DtPoint &chordNormal, double intersectTime, DtIntersectionRecord::DtIntersectionType irtFlag) const
bool	chordExtentIntersect (const DtChord &chord, DtChordIntersectionRecord &hit, DtIntersectionRecord::DtIntersectionType irtFlag) const
virtual void	cacheInformationForTerrainArea (int requestId, int lowestLOD, int highestLOD, const DtExtent &cacheArea, double &estimatedTime, double &estimatedSize, std::vector< std::string > &elevationLayers, std::vector< std::string > &modelLayers) const
	Not implemented at example level.
virtual void	cacheTerrainArea (int requestId, int lowestLOD, int highestLOD, const DtExtent &cacheArea, DtCacheProgressCallbackFunction fcn=0, void *usr=0)
	Not implemented at example level.
virtual void	cancelCacheTerrainArea (int requestId)
	Not implemented at example level.

Protected Attributes
Coordinate_System *	myCoordinateSystem
DtTerrainCapabilities	myCapabilities
Protected Attributes inherited from DtTerrainImplementation
DtTerrainInterfaceConfig	myConfig
bool	myAssertOnBlockingTerrainCalls
	Determines if an exception should be thrown if a blocking terrain call is made.
bool	myWarnOnBlockingTerrainCalls
boost::scoped_ptr < MAKVRinTerra::DtFeatureDatabase >	myFeatureDatabase
boost::scoped_ptr < MAKVRinTerra::DtFeatureContext >	myFeatureContext

Additional Inherited Members
Public Types inherited from DtTerrainImplementation
typedef boost::function< void(const makVrv::DtDynamicTerrainFeature &)>	DtDynamicTerrainQueryCallback

Constructor & Destructor Documentation

DtExtentTerrainImplementation::DtExtentTerrainImplementation

(

DtConsoleCommandManager *

cmdMgr

)

virtual DtExtentTerrainImplementation::~DtExtentTerrainImplementation ( )

virtual

Member Function Documentation

static DtTerrainImplementation* DtExtentTerrainImplementation::create ( DtConsoleCommandManager *  cmdMgr )

static

virtual bool DtExtentTerrainImplementation::loadTerrain ( const makArchives::DtGenericTerrainRecord &  rec )

virtual

Loads a terrain given the terrain record.

Implements DtTerrainImplementation.

virtual const Coordinate_System* DtExtentTerrainImplementation::coordinateSystem ( ) const

virtual

Implements DtTerrainImplementation.

virtual bool DtExtentTerrainImplementation::chordIntersect ( const DtChord &  chord, DtVrfChordIntersectionRecord &  record, DtIntersectionRecord::DtIntersectionType  irtFlag = DtIntersectionRecord::INT_ALL_DATA, bool *  dataAvailable = 0, bool  overrideBlockingAssert = false, int  flags = 0  ) const

virtual

Returns topmost intersection of chord with terrain in record.

Parameters

Input
chord	the chord to test
irtFlag	specifies what intersection data should be filled in for the record.
Output
record	the results of the intersection
dataAvailable	Please see "Synchronous and asynchronous calls with paged terrains" in DtTerrainInterface for information on how to specify that this function be blocking or non-blocking. If this parameter is specified and the required terrain data is not yet paged in, this call will return immediately and dataAvailable will be set to false.
overrideBlockingAssert	when set to true this parameter will prevent an assertion from being thrown when the terrain implementation has myAssertOnBlockingTerrainCalls set to true. This should only be done when the call is being made from outside the main simulation thread and a blocking call would not cause a a problem.
flags	optional flags to pass into the intersector. The flags are implementation dependent

Implements DtTerrainImplementation.

virtual bool DtExtentTerrainImplementation::allIntersectsAlongChord ( const DtChord &  chord, DtVrfChordIntersectRecordList &  intList, DtIntersectionRecord::DtIntersectionType  irtFlag = DtIntersectionRecord::INT_ALL_DATA, bool *  dataAvailable = 0, bool  overrideBlockingAssert = false, int  flags = 0  ) const

virtual

Returns all intersections of chord with terrain.

Parameters

Input
chord	the chord to test
irtFlag	specifies what intersection data should be filled in for the record.
Output
intList	the results of the intersection
dataAvailable	Please see "Synchronous and asynchronous calls with paged terrains" in DtTerrainInterface for information on how to specify that this function be blocking or non-blocking. If this parameter is specified and the required terrain data is not yet paged in, this call will return immediately and dataAvailable will be set to false.
overrideBlockingAssert	when set to true this parameter will prevent an assertion from being thrown when the terrain implementation has myAssertOnBlockingTerrainCalls set to true. This should only be done when the call is being made from outside the main simulation thread and a blocking call would not cause a a problem.
flags	optional flags to pass into the intersector. The flags are implementation dependent

Implements DtTerrainImplementation.

virtual const DtTerrainCapabilities* DtExtentTerrainImplementation::terrainCapabilities ( ) const

virtual

Returns

A DtTerrainCapabilites structure that describes the capabilities of the currently loaded terrain.

Implements DtTerrainImplementation.

virtual void DtExtentTerrainImplementation::processTrianglesInArea ( DtTriangleCallbackFcn  func, DtTriangleCallbackFinalizeFcn  finalize, const DtTerrainProcessPolygonsBox &  box, void *  usr  )

virtual

void DtExtentTerrainImplementation::fillHitRecord ( DtChordIntersectionRecord &  rec, const DtChord &  chord, const DtPoint &  chordNormal, double  intersectTime, DtIntersectionRecord::DtIntersectionType  irtFlag  ) const

protected

bool DtExtentTerrainImplementation::chordExtentIntersect ( const DtChord &  chord, DtChordIntersectionRecord &  hit, DtIntersectionRecord::DtIntersectionType  irtFlag  ) const

protected

virtual void DtExtentTerrainImplementation::cacheInformationForTerrainArea ( int  requestId, int  lowestLOD, int  highestLOD, const DtExtent &  cacheArea, double &  estimatedTime, double &  estimatedSize, std::vector< std::string > &  elevationLayers, std::vector< std::string > &  modelLayers  ) const

protectedvirtual

Not implemented at example level.

Implements DtTerrainImplementation.

virtual void DtExtentTerrainImplementation::cacheTerrainArea ( int  requestId, int  lowestLOD, int  highestLOD, const DtExtent &  cacheArea, DtCacheProgressCallbackFunction  fcn = 0, void *  usr = 0  )

protectedvirtual

Not implemented at example level.

Implements DtTerrainImplementation.

virtual void DtExtentTerrainImplementation::cancelCacheTerrainArea ( int  requestId )

protectedvirtual

Not implemented at example level.

Implements DtTerrainImplementation.

Member Data Documentation

Coordinate_System* DtExtentTerrainImplementation::myCoordinateSystem

protected

DtTerrainCapabilities DtExtentTerrainImplementation::myCapabilities

protected

---

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

• /exports/nfedora7-1/nightly/docs/vrforcesDevelopment.tot/examples/extentTerrainImplementation/extentTerrainImplementation.h