VR-Forces Developer's Guide
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
DtTerrain.h
Go to the documentation of this file.
1 /******************************************************************************
2 ** Copyright (c) 2023 MAK Technologies, Inc.
3 ** All rights reserved.
4 ******************************************************************************/
5 
9 
10 #pragma once
11 
12 #include <vrvCore/vrvCore.h>
13 #include <vrvCore/DtForest.h>
14 #include <vrvCore/DtTerrainPatch.h>
17 
18 #include <matrix/vlVector.h>
19 
21 
22 #include <vrvUtil/signalslib.h>
23 #include <boost/shared_ptr.hpp>
24 
25 #include <string>
26 #include <list>
27 #include <vector>
28 
29 namespace makArchives
30 {
31  class DtFeatureLayerRecord;
32  class DtOceanLayerRecord;
33  class DtTerrainPatchRecord;
34 }
35 
36 namespace makVrv
37 {
38  class DtBuoyOrBeaconFacade;
39  class DtDe;
40  class DtFeature;
41  class DtFeatureLayer;
42  class DtModelAgent;
43  class DtOceanLayer;
44  class DtDynamicFeatureLayer;
45  class DtProp;
46  class DtTerrainPatchObjectAgent;
47  class DtTerrainPatchObject;
48  class DtTerrainSignaler;
49  class DtTexturedQuad;
50  class DtBuoyBeaconLayer;
51  class DtStreamedFeatureLayer;
52  class DtNavigationLightManager;
53  class DtNavigationFeatureManager;
54  class DtLightPointUpdater;
55 
59  {
60 
61  public:
62 
63  typedef std::list<DtTerrainPatch*> TerrainPatches;
64  typedef std::list<DtFeatureLayer*> FeatureLayers;
65  typedef std::list<DtOceanLayer*> OceanLayers;
66 
68  typedef std::map<int, makArchives::DtTerrainOperationRecord> TerrainOperationsMap;
69 
71  DtTerrain(DtDe& de, DtAgentManagerInterface& sceneManagerInterface);
72 
74  virtual ~DtTerrain();
75 
78  void clear(bool reload=false);
79 
81 
82 
86  bool globalScaleTerrain() const;
87 
91  void updateGlobalScaleTerrain();
92 
94  virtual void getRecord(makArchives::DtTerrainRecord& rec) const;
95 
98  virtual void setFromRecord(const makArchives::DtTerrainRecord& rec, bool clearFirst=true);
99 
101  virtual void reloadTerrain();
102 
104 
106 
107 
112  virtual DtTerrainPatch& addTerrainPatch(const makArchives::DtTerrainPatchRecord& rec);
113 
121  virtual DtTerrainPatch& addTerrainPatch(const std::string& terrainDefinitionName, bool minimapOnly=false,
123 
125  virtual DtTerrainPatch* findTerrainPatch(const std::string& terrainDefinitionName);
126 
128  virtual DtTerrainPatch* findTerrainPatch(DtUniqueID id);
129 
134  virtual bool removeTerrainPatch(const std::string& terrainDefinitionName, bool minimapOnly=false);
135 
138  const TerrainPatches& terrainPatches() const ;
139 
142  TerrainPatches& terrainPatches();
143 
145  bool lightPointsEnabled() const;
147 
148 
150 
151  virtual const TerrainOperationsMap& terrainOperationsMap() const;
153 
155 
156 
157 
160  virtual DtFeatureLayer& addFeatureLayer(const makArchives::DtFeatureLayerRecord& rec,
163 
168  virtual DtFeatureLayer& addFeatureLayer(const std::string& featureLayerFilename,
171 
173  virtual void removeFeatureLayer(const std::string& featureLayerFilename);
174 
176  virtual const FeatureLayers& featureLayers() const;
177 
179  virtual FeatureLayers& featureLayers();
180 
182  virtual DtFeatureLayer* findFeatureLayer(const std::string& featureLayerFilename);
183 
187  virtual DtStreamedFeatureLayer& streamedFeatureLayer();
188 
190  virtual DtBuoyBeaconLayer& buoyBeaconLayer();
191 
195  virtual DtDynamicFeatureLayer& dynamicFeatureLayer();
196 
198  virtual DtNavigationLightManager& navigationLightManager();
199 
201  virtual DtNavigationFeatureManager& navigationDaymarkManager();
202 
204  virtual DtNavigationFeatureManager& navigationTopmarkManager();
205 
207 
209 
210 
213  virtual DtOceanLayer& addOceanLayer( const makArchives::DtOceanLayerRecord& rec );
214 
219  virtual DtOceanLayer& addOceanLayer( const std::string& layerName );
220 
222  virtual void removeOceanLayer( const std::string& layerName );
223 
225  virtual const OceanLayers& oceanLayers() const;
226 
228  virtual OceanLayers& oceanLayers();
229 
231  virtual DtOceanLayer* findOceanLayer( const std::string& layerName );
232 
235  virtual void onOceanNodesExtracted( DtTerrainPatchObject& patchObject );
237 
239 
240 
242  std::string generatePropName(const std::string& propType);
243 
245 
247 
248 
252  virtual DtForest& forest();
253 
255  bool isPropNameUsed(const std::string& propName) const;
257 
261  virtual bool getTerrainIntersection(double x, double y, double z,
262  double upX, double upY, double upZ, double& retX, double& retY,
263  double& retZ );
264 
268  virtual void clearElevationCache();
270 
272 
273 
276  virtual bool exportTerrainAndProps(const std::string&);
277 
279 
283  virtual const std::string* findOptionalParameter(const std::string& name) const;
284 
286  virtual void setOptionalParameter(const std::string& name, const std::string& value);
287 
290  virtual void setOptionalParameters(const makArchives::DtTerrainRecord::OptionalParameterMap&);
291 
293  virtual void removeOptionalParameter(const std::string& name);
294 
296  const makArchives::DtTerrainRecord::OptionalParameterMap& optionalParameters() const;
297 
299  virtual const std::string& description();
300 
302  virtual void setDescription(const std::string& description);
303 
305  virtual bool useICO() const;
306 
308  virtual void setUseICO(bool flag);
309 
311  virtual unsigned int maxPagedLODs() const;
312 
314  virtual void setMaxPagedLODs( unsigned int maxPagedLODs );
315 
317  virtual bool reloadingTerrain() { return myReloadingTerrain;}
318 
319  protected:
320 
322  void executeTerrainOperation(const makArchives::DtTerrainOperationRecord& operation,
323  const makArchives::DtTerrainRecord& terrainRec);
324 
326  void addTerrainOperationRecord(const makArchives::DtTerrainOperationRecord& operation);
327 
329  void removeTerrainOperationRecord( const makArchives::DtTerrainOperationRecord& operation);
330 
332  void removeTerrainOperationRecord(int id);
333 
335  void clearTerrainOperations();
336 
338  void slot_handleIsDayChanged(bool isDay);
339 
341  virtual bool checkIfTerrainOperationRecordsMatch
344 
345  virtual void connectForestAndOceanSignals(void);
346 
347  protected:
348  typedef std::map<std::string,int> PropNameMap;
349 
353 
364 
368 
370 
373 
374  std::string myDescription;
375 
376  bool myUseICO;
377  unsigned int myMaxPagedLODs;
378 
380 
382  };
383 
389  {
390  public:
391 
393  static DtTerrainSignaler& instance(DtDe& de);
394 
396  virtual ~DtTerrainSignaler();
397 
398  //@name Signals
400 
401  boost::signalslib::signal< void(const makArchives::DtTerrainRecord&) > signal_terrainLoaded;
402 
403  boost::signalslib::signal< void(unsigned int) > signal_terrainMaxPagedLODChanged;
404 
406  boost::signalslib::signal< void (const DtTerrainPatch&) > signal_terrainPatchAdded;
407 
409  boost::signalslib::signal< void (const DtTerrainPatch&) > signal_terrainPatchToBeDeleted;
410 
412  boost::signalslib::signal< void (const DtFeatureLayer&) > signal_featureLayerAdded;
413 
415  boost::signalslib::signal< void (const DtFeatureLayer&) > signal_featureLayerToBeDeleted;
416 
418  boost::signalslib::signal< void (const DtOceanLayer&) > signal_oceanLayerAdded;
419 
421  boost::signalslib::signal< void (const DtOceanLayer&) > signal_oceanLayerToBeDeleted;
422 
424  boost::signalslib::signal< void(const std::string&) > signal_oceanLayerDeleted;
425 
427  boost::signalslib::signal< void (const DtOceanLayer&, double) > signal_oceanLayerSeaLevelChanged;
428 
430  boost::signalslib::signal< void (const DtOceanLayer&, int) > signal_oceanLayerLodRangeChanged;
431 
434  boost::signalslib::signal<void (bool reload) > signal_terrainToBeCleared;
435 
437  boost::signalslib::signal< void () > signal_terrainCleared;
438 
440  boost::signalslib::signal< void (DtProp& prop) > signal_propCreated;
441 
443  boost::signalslib::signal< void (const DtProp& prop) > signal_propAboutToBeDestroyed;
444 
446  boost::signalslib::signal< void (DtBuoyOrBeaconFacade& buoy,
447  const DtVector& initialPosition) > signal_buoyOrBeaconCreated;
448 
450  boost::signalslib::signal< void (const DtBuoyOrBeaconFacade& buoy) >
452 
454  boost::signalslib::signal< void (const DtProp& prop, double x, double y, double z) >
456 
458  boost::signalslib::signal< void (const DtProp& prop, double x, double y, double z, double w) > signal_propOrientationAboutToChange;
459 
461  boost::signalslib::signal< void (const DtFeature&) > signal_featureAdded;
462 
464  boost::signalslib::signal< void (const DtFeature&) > signal_featureToBeDeleted;
465 
467  boost::signalslib::signal< void(int id, const makArchives::DtTerrainOperationRecord& rec) > signal_terrainOperationAdded;
468 
470  boost::signalslib::signal< void(int id) > signal_terrainOperationRemoved;
471 
473  boost::signalslib::signal< void(bool) > signal_terrainIsGlobalScaleChanged;
474 
476 
477  protected:
479  };
480 
481 
485  {
486 
487  public:
490  static DtTerrainCreator& instance(DtDe& de);
491 
493  static void registerInstance(DtDe& de, DtTerrainCreator* instance);
494 
496  virtual DtTerrain* create( DtDe& de,
497  DtAgentManagerInterface& agentManager );
498  };
499 
500 }
501 
502 
DtDe & myDe
Definition: DtTerrain.h:350
std::list< DtFeatureLayer * > FeatureLayers
Definition: DtTerrain.h:64
The feature layer is a type of terrain layer which contains features, such as points, lines, areas, and props created from them.
Definition: DtFeatureLayer.h:25
boost::signalslib::signal< void(int id) > signal_terrainOperationRemoved
Emitted when an operation is removed.
Definition: DtTerrain.h:470
int myNextTerrainOperationId
Definition: DtTerrain.h:366
A wrapper around the forest driver and some local state of the forest.
Definition: DtForest.h:35
A DtOceanLayerRecord contains the information to add dynamic water.
Definition: DtOceanLayerRecord.h:21
Virtual base class. Allows for RTTI and proper virtual destruction. Used by Creators, Factories, Providers, Assemblers and User Interfaces.
Definition: DtVirtualBaseClass.h:19
std::map< int, makArchives::DtTerrainOperationRecord > TerrainOperationsMap
Map of terrain operation ids, to terrain operations.
Definition: DtTerrain.h:68
DtNavigationFeatureManager * myNavigationDaymarkManager
Definition: DtTerrain.h:362
A global signaler object for the DtTerrain class. These signals are raised on the master by DtTerrain...
Definition: DtTerrain.h:388
OceanLayers myOceanLayers
Definition: DtTerrain.h:356
DtStreamedFeatureLayer * myStreamedFeatureLayer
Definition: DtTerrain.h:359
A DtFeatureLayerRecord contains the information to add features from a single source file and ruleset...
Definition: DtFeatureLayerRecord.h:22
The DtStreamedFeatureLayer is the base implementation of a layer of data which contains buoys and bea...
Definition: DtStreamedFeatureLayer.h:34
boost::signalslib::signal< void(const DtFeature &) > signal_featureToBeDeleted
Emitted when a DtFeature is about to be removed.
Definition: DtTerrain.h:464
DtNavigationFeatureManager * myNavigationTopmarkManager
Definition: DtTerrain.h:363
boost::signalslib::signal< void(const makArchives::DtTerrainRecord &) > signal_terrainLoaded
Emitted when a DtTerrainPatch is added.
Definition: DtTerrain.h:401
DtTerrainSignaler & mySignaler
Definition: DtTerrain.h:351
boost::signalslib::signal< void(const DtFeatureLayer &) > signal_featureLayerToBeDeleted
Emitted when a DtFeatureLayer is about to be removed.
Definition: DtTerrain.h:415
FeatureLayers myFeatureLayers
Definition: DtTerrain.h:355
The DtBuoyBeaconLayer is the base implementation of a layer of data which contains buoys and beacons ...
Definition: DtBuoyBeaconLayer.h:35
boost::signalslib::signal< void(bool) > signal_terrainIsGlobalScaleChanged
Emitted when an terrain is global changes.
Definition: DtTerrain.h:473
virtual bool reloadingTerrain()
is the terrain currently reloading
Definition: DtTerrain.h:317
bool myGlobalScaleFlag
Definition: DtTerrain.h:367
boost::signalslib::signal< void(const DtFeature &) > signal_featureAdded
Emitted when a DtFeature is added.
Definition: DtTerrain.h:461
A container for a single piece of terrain, containing settings needed to recreate it...
Definition: DtTerrainPatch.h:42
boost::signalslib::signal< void(const std::string &) > signal_oceanLayerDeleted
Emitted when a ocean layer is removed.
Definition: DtTerrain.h:424
std::list< DtOceanLayer * > OceanLayers
Definition: DtTerrain.h:65
boost::signalslib::signal< void(const DtBuoyOrBeaconFacade &buoy) > signal_buoyOrBeaconAboutToBeDestroyed
Emitted when a buoy is destroyed.
Definition: DtTerrain.h:451
The DtDynamicFeatureLayer is the base implementation of a layer of data which contains features that ...
Definition: DtDynamicFeatureLayer.h:34
boost::signalslib::signal< void() > signal_terrainCleared
Emitted when the terrain is cleared.
Definition: DtTerrain.h:437
The DtNavigationFeatureManager matches streamed features to other streamed features (buoys and beacon...
Definition: DtNavigationFeatureManager.h:38
A DtTerrainPatchObject contains the methods for loading a file as a terrain. When loading a file as a...
Definition: DtTerrainPatchObject.h:35
DtBuoyBeaconLayer * myBuoyLayer
Definition: DtTerrain.h:358
std::list< DtGenericTerrainRecord > GenericRecords
Definition: DtTerrainRecord.h:36
Record of pageable terrain patch settings.
Definition: DtTerrainPatchRecord.h:33
Definition: feature.h:26
Contains makVrv::DtVirtualBaseClass class.
Record of a VR-Vantage terrain Contains: Terrain coordinate system Terrain patches Feature layers Ter...
Definition: DtTerrainRecord.h:29
A DtTerrainOperationRecord contains information about a single terrain operation. ...
Definition: DtTerrainOperationRecord.h:19
DtNavigationLightManager * myNavigationLightManager
Definition: DtTerrain.h:361
#define DT_DLL_VRVCORE
Definition: vrvCore.h:20
boost::signalslib::signal< void(DtBuoyOrBeaconFacade &buoy, const DtVector &initialPosition) > signal_buoyOrBeaconCreated
Emitted when a buoy is created.
Definition: DtTerrain.h:447
boost::signalslib::signal< void(const DtOceanLayer &) > signal_oceanLayerAdded
Emitted when a DtFeatureLayer is added.
Definition: DtTerrain.h:418
Class to manage disconnection of boost connections on deletion.
Definition: DtSignalConnectionManager.h:20
boost::signalslib::signal< void(unsigned int) > signal_terrainMaxPagedLODChanged
Emitted when a DtTerrainPatch is added.
Definition: DtTerrain.h:403
The terrain creator for the DtTerrain class.
Definition: DtTerrain.h:484
std::string myDescription
Definition: DtTerrain.h:374
boost::signalslib::signal< void(DtProp &prop) > signal_propCreated
Emitted when a prop is created.
Definition: DtTerrain.h:440
TerrainPatches myTerrainPatches
Definition: DtTerrain.h:354
unsigned int myMaxPagedLODs
Definition: DtTerrain.h:377
bool myReloadingTerrain
Definition: DtTerrain.h:379
std::map< std::string, int > PropNameMap
Definition: DtTerrain.h:348
Definition: DtTexturedQuad.h:24
unsigned long long DtUniqueID
Definition: DtUniqueID.h:19
boost::signalslib::signal< void(const DtTerrainPatch &) > signal_terrainPatchToBeDeleted
Emitted when a DtTerrainPatch is about to be removed.
Definition: DtTerrain.h:409
The DtNavigationLightManager matches streamed light controllers to other streamed features (buoys and...
Definition: DtNavigationLightManager.h:56
boost::signalslib::signal< void(bool reload) > signal_terrainToBeCleared
Emitted when the terrain is about to be cleared. If the terrain is being cleared due to a reloadTerra...
Definition: DtTerrain.h:434
DtDynamicFeatureLayer * myDynamicFeatureLayer
Definition: DtTerrain.h:360
The ocean layer is a type of terrain layer which contains information about an area that should be re...
Definition: DtOceanLayer.h:25
boost::signalslib::signal< void(const DtProp &prop, double x, double y, double z, double w) > signal_propOrientationAboutToChange
Emitted when a prop orientation is about to be changed.
Definition: DtTerrain.h:458
Base class to provide boost signal/slot management.
makArchives::DtTerrainRecord::OptionalParameterMap myOptionalParameters
Definition: DtTerrain.h:371
PropNameMap myPropNameMap
Definition: DtTerrain.h:369
std::list< DtTerrainPatch * > TerrainPatches
Definition: DtTerrain.h:63
makArchives::DtTerrainRecord::GenericRecords myGenericRecords
Definition: DtTerrain.h:372
Contains makVrv::DtTerrainPatch class.
boost::signalslib::signal< void(const DtTerrainPatch &) > signal_terrainPatchAdded
Emitted when a DtTerrainPatch is added.
Definition: DtTerrain.h:406
boost::signalslib::signal< void(int id, const makArchives::DtTerrainOperationRecord &rec) > signal_terrainOperationAdded
Emitted when an operation is added.
Definition: DtTerrain.h:467
TargetApplication
Definition: DtTerrainOperationRecord.h:26
The abstract interface necessary for agents.
Definition: DtAgentManagerInterface.h:33
DtTexturedQuad * myLogo
Definition: DtTerrain.h:381
boost::signalslib::signal< void(const DtOceanLayer &, double) > signal_oceanLayerSeaLevelChanged
Emitted when an ocean layer changes its sea level.
Definition: DtTerrain.h:427
The DtDe is the core component of any VR-Vantage application. It owns a DtRenderer, DtDeCommunicator, as well as a DtDisplay and other things.
Definition: DtDe.h:72
std::map< std::string, std::string > OptionalParameterMap
Definition: DtTerrainRecord.h:38
DtForest * myForest
Definition: DtTerrain.h:357
bool myUseICO
Definition: DtTerrain.h:376
A DtTerrainPatchRecord contains the information to construct a single DtTerrainPatch.
Definition: DtTerrainPatchRecord.h:27
Contains makVrv::DtForest class.
TerrainOperationsMap myTerrainOperationsMap
Definition: DtTerrain.h:365
boost::signalslib::signal< void(const DtOceanLayer &) > signal_oceanLayerToBeDeleted
Emitted when a ocean layer is about to be removed.
Definition: DtTerrain.h:421
boost::signalslib::signal< void(const DtProp &prop) > signal_propAboutToBeDestroyed
Emitted when a prop is destroyed.
Definition: DtTerrain.h:443
DtTerrain is a facade around terrain functionality.
Definition: DtTerrain.h:58
The DtEntityFacade is a facade around agents that make up an entity. This entity facade represents a ...
Definition: DtBuoyOrBeaconFacade.h:24
Contains makArchives::DtTerrainRecord class.
boost::signalslib::signal< void(const DtFeatureLayer &) > signal_featureLayerAdded
Emitted when a DtFeatureLayer is added.
Definition: DtTerrain.h:412
boost::signalslib::signal< void(const DtOceanLayer &, int) > signal_oceanLayerLodRangeChanged
Emitted when an ocean layer changes its lod range.
Definition: DtTerrain.h:430
DtAgentManagerInterface & myAgentManagerInterface
Definition: DtTerrain.h:352
boost::signalslib::signal< void(const DtProp &prop, double x, double y, double z) > signal_propPositionAboutToChange
Emitted when a prop position is about to be changed.
Definition: DtTerrain.h:455
Contains DLL export macros.

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)