VR-Forces Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
terrainSourceTracker.h
Go to the documentation of this file.
1 /*******************************************************************************
2 ** Copyright (c) 2023 MAK Technologies, Inc.
3 ** All rights reserved.
4 *******************************************************************************/
5 
8 
9 #pragma once
10 
14 
15 #include <geometry/sphere.h>
16 
19 
21 
23 #include <vrfutil/sphere2.h>
24 
25 #include <tbb/atomic.h>
26 #include <tbb/spin_rw_mutex.h>
27 
28 #include <boost/unordered_map.hpp>
29 #include <boost/optional.hpp>
30 
31 #include <osgEarth/TileKey>
32 
33 typedef boost::unordered_multimap<DtNodeId, boost::shared_ptr<btCollisionObject> > DtNodeToCollObjMMap;
34 typedef std::pair<DtNodeToCollObjMMap::iterator, DtNodeToCollObjMMap::iterator>
36 
38 struct DtTileData;
39 
41 struct TileCache
42 {
43 public:
44  TileCache(boost::shared_ptr<DtTileData> tilePointer, const DtChord* chord = NULL) :
45  myTilePointer(tilePointer),
46  myIsChord(false)
47  {
48  if (chord != NULL)
49  {
50  myIsChord = true;
51  myPt0 = chord->endpoint0();
52  myPt1 = chord->endpoint1();
53  }
54  }
55  TileCache(const TileCache& tile) :
57  myIsChord(tile.myIsChord),
58  myPt0(tile.myPt0),
59  myPt1(tile.myPt1)
60  {
61 
62  }
63 
64  boost::shared_ptr<DtTileData> myTilePointer;
65  bool myIsChord;
68 };
69 
70 typedef std::vector<TileCache> tileDataCacheVector;
71 
76 {
77 public:
78 
80  DtTerrainSourceTracker(DtVantageTerrainEngine*, DtPagerCommandQueue* commandQueue, osgEarth::MapNode* mapNode);
81 
83  virtual ~DtTerrainSourceTracker();
84 
86  virtual DtTerrainInterfaceConfig& configOptions();
87  virtual const DtTerrainInterfaceConfig& configOptions() const;
88 
91  virtual bool init(DtTerrainSourcePager&);
92 
97  virtual boost::optional<DtTerrainIntersectOptions::Fidelity> intersectFidelity() const;
98 
100  virtual bool dataAvailable(DtPagingMetaDataPtr metaData,
101  DtTerrainPagingGeometryPtr geometry) = 0;
102 
110  virtual void pageInData(DtPagingMetaDataPtr metaData,
111  DtTerrainPagingGeometryPtr geometry) = 0;
112 
113  //Should return true if the tracker is capable of paging out data.
114  virtual bool canPageOutData(DtTerrainIntersectIDType intersectId) = 0;
115 
121  virtual DtTerrainIntersectIDType findOldestPagedData(unsigned int& numTriangles) = 0;
122 
125  virtual void pageOutOldestData(const int priority) = 0;
126 
128  virtual void addNodesToCollisionMapping(DtNodeId node,
129  DtCollisionObjectList* collObjList);
130 
132  virtual void removeNodeToCollisionMappings(DtNodeId node);
133 
135  virtual DtCollisionObjectList collisionObjectsForNode(DtNodeId node);
136 
138  virtual osgEarth::MapNode* mapNode() const;
139 
141  virtual const osgEarth::Profile* profile() const;
142 
144  virtual const Coordinate_System* localCS() const;
145 
147  virtual void setLabel(const DtString&);
148 
150  virtual void printInfo() const;
151 
153  virtual void getPageOutData(DtNodeBoundingList& nodeBoundingList);
154 
156  virtual void getPageInData(DtNodeBoundingList& nodeBoundingList);
157 
159  virtual void getProceduralTreeTile(DtDebugDrawTerrainOutputInterface::terrainLineList& nodeBoundingList);
160 
162  virtual unsigned getMaxLODForBilinearIntersection() const;
163 
165  virtual double intersetionTriangleMergeTolerance() const;
166 
168  virtual bool useLandCoverData() const;
169 
171  virtual bool useLifeMapLayer() const;
172 
174  virtual void getSoilFromString(const std::string & soilType, DtSurface& surface) const;
175 
177  virtual double triangleOutputMergeTolerance() const;
178 
180  virtual unsigned minElevationIndexLOD() const;
181 
183  virtual unsigned maxElevationIndexLOD() const;
184 
186  virtual unsigned maxLOD() const;
187 
189  virtual bool useRawElevation() const;
190 
192  virtual osgEarth::TileKey getBestTileKey(const osgEarth::TileKey&) const;
193 
196  virtual bool findTileInCache(const DtTerrainPagingGeometry* geometry, std::vector< boost::shared_ptr<DtTileData> >& data,
197  const DtChord* chord=NULL) const;
198 
202  virtual void addTileToCache(const boost::shared_ptr<DtTileData>& data, const DtChord* chord = NULL);
203 
205  virtual void clearTileCache();
206 
209  virtual unsigned minElevationTileLoadingLOD() const;
210  virtual void setMinElevationTileLoading(unsigned lod);
211 
212 
213 protected:
214 
216 
218 
220 
222 
223  mutable tbb::spin_rw_mutex myMutex;
224 
225  mutable tbb::spin_rw_mutex myTileCacheMutex;
226 
228 
231  const osgEarth::Map* myMap;
232  const osgEarth::Profile* myMapProfile;
233 
236 
238  tbb::atomic<int> myTileCacheHit;
239  tbb::atomic<int> myTileCacheQuery;
240 
243 
245 };
246 
248 {
249 public:
250  TileDataCallback() { myIsFinished = false; };
251 
252  virtual bool operator()(const boost::shared_ptr<DtTileData>& tile) = 0;
253 
254  virtual bool finish() const { return myIsFinished; }
255  virtual void setFinish(bool finish) { myIsFinished=finish; }
256 
257 protected:
258 
260 };
DtTileData is tracked by the DtOsgEarthTerrainSourceTracker for paging out tiles. ...
Definition: tileData.h:38
NOTE: This entire class is deprecated, in favor of Dt3dChord.
Definition: chord.h:40
Class DtTerrainInterfaceConfig is a readable-writable class holding terrain interface configuration o...
Definition: terrainInterfaceConfig.h:32
DtBoost::shared_ptr< DtTerrainPagingGeometry > DtTerrainPagingGeometryPtr
Definition: terrainPagingGeometry.h:46
TileCache(boost::shared_ptr< DtTileData > tilePointer, const DtChord *chord=NULL)
Definition: terrainSourceTracker.h:44
DtTerrainSourcePager is the base class for terrain pagers. There will be one terrainSourcePager per t...
Definition: terrainSourcePager.h:58
DtPoint myPt1
Definition: terrainSourceTracker.h:67
std::vector< makVrf::DtLine > terrainLineList
Lines structure/calls/list.
Definition: debugDrawTerrainOutputInterface.h:103
DtString myLabel
map node for whole terrain
Definition: terrainSourceTracker.h:215
bool myIsChord
Definition: terrainSourceTracker.h:65
unsigned long long DtTerrainIntersectIDType
Definition: terrainInterfaceDefines.h:28
tbb::atomic< int > myTileCacheQuery
map node for whole terrain
Definition: terrainSourceTracker.h:239
tbb::spin_rw_mutex myMutex
map node for whole terrain
Definition: terrainSourceTracker.h:223
Definition: surface.h:181
boost::unordered_multimap< DtNodeId, boost::shared_ptr< btCollisionObject > > DtNodeToCollObjMMap
Definition: terrainSourceTracker.h:33
tbb::concurrent_queue< DtTerrainPagerCommand * > DtPagerCommandQueue
Definition: vantageTerrainImplementationUtil.h:41
DtPagerCommandQueue * myCommandQueue
map node for whole terrain
Definition: terrainSourceTracker.h:219
bool myIsFinished
Definition: terrainSourceTracker.h:259
const osg::ref_ptr< osgEarth::MapNode > myMapNode
map node for whole terrain
Definition: terrainSourceTracker.h:230
TileCache(const TileCache &tile)
Definition: terrainSourceTracker.h:55
TileDataCallback()
Definition: terrainSourceTracker.h:250
Definition: coordSystem.h:54
DtVantageTerrainEngine * myVantageTerrainEngine
map node for whole terrain
Definition: terrainSourceTracker.h:227
DtTerrainSourcePager * myPager
map node for whole terrain
Definition: terrainSourceTracker.h:244
boost::shared_ptr< DtTileData > myTilePointer
Definition: terrainSourceTracker.h:64
std::pair< DtNodeToCollObjMMap::iterator, DtNodeToCollObjMMap::iterator > DtNodeToCollObjRangePair
Definition: terrainSourceTracker.h:35
std::list< DtSphere2 > DtNodeBoundingList
Definition: sphere2.h:20
Base class for Terrain Source trackers. Determines if the necessary data To perform an intersection i...
Definition: terrainSourceTracker.h:75
const osgEarth::Map * myMap
map node for whole terrain
Definition: terrainSourceTracker.h:231
unsigned myMinElevationTileLoadingLOD
Min lod an elevation tile can loaded.
Definition: terrainSourceTracker.h:242
Definition: terrainSourceTracker.h:247
virtual bool finish() const
Definition: terrainSourceTracker.h:254
const osgEarth::Profile * myMapProfile
map node for whole terrain
Definition: terrainSourceTracker.h:232
Abstract base class for defining geometric areas for paging of terrain. Subclasses of this class will...
Definition: terrainPagingGeometry.h:24
DtNodeToCollObjMMap myNodeToCollObjMMap
map node for whole terrain
Definition: terrainSourceTracker.h:221
DtTerrainInterfaceConfig myConfig
map node for whole terrain
Definition: terrainSourceTracker.h:217
#define DT_DLL_vantageTerrainImplementation
This file is used to determine how to build.
Definition: vantageTerrainImplementationDefines.h:28
DT_DLL_DEBUGDRAWRENDERER void init(makVrv::DtDe &de)
Work function for the plugin initialization.
tbb::spin_rw_mutex myTileCacheMutex
map node for whole terrain
Definition: terrainSourceTracker.h:225
This class wraps the VR-Vantage Display Engine, and uses as a terrain loader and intersector. This is the terrain engine that powers the DtVantageTerrainImplementation. The DtVantageTerrainEngine runs the DtDe it its own thread, and processes commands thought the command queue.
Definition: vantageTerrainEngine.h:109
virtual void setFinish(bool finish)
Definition: terrainSourceTracker.h:255
std::vector< TileCache > tileDataCacheVector
Definition: terrainSourceTracker.h:70
DtBoost::shared_ptr< DtPagingMetaData > DtPagingMetaDataPtr
Definition: terrainPagingGeometry.h:101
tileDataCacheVector myTileDataCache
Tile Data cache to speed up intersections.
Definition: terrainSourceTracker.h:235
DtPoint myPt0
Definition: terrainSourceTracker.h:66
std::list< boost::shared_ptr< btCollisionObject > > DtCollisionObjectList
Definition: bulletUtil.h:49
Definition: terrainSourceTracker.h:41
Definition: point.h:34
tbb::atomic< int > myTileCacheHit
Stats for cache.
Definition: terrainSourceTracker.h:238
Interface to query terrain polygon.

Document ID: Generated on Wed Mar 27 22:49:11 EDT 2024 from SVN revision 264633
Copyright © 2005-2024 MAK Technologies. All Rights Reserved (www.mak.com)