Changeset 275 for experimental/TerrainTest/ModificationManager.h

Timestamp:

Mar 20, 2011, 1:14:16 PM (13 years ago)

Author:

Torben Dannhauer

Message:

 

File:

• experimental/TerrainTest/ModificationManager.h (modified) (1 diff)

experimental/TerrainTest/ModificationManager.h

@@ -17 +17 @@
 
 #include "region.h"
+#include "myTileLoadedCallback.h"
+#include "terrainModificationTechnique.h"
+#include <osgTerrain/Terrain>
+#include <osgTerrain/GeometryTechnique>
 #include <osg/observer_ptr>
+#include <vector>
 
 
+
+
+/**
+ * \brief This class provides a management interface to control terrain modification.
+ * 
+ * It is possible to modify preprocessed VirtualPLanetBuilder (VPB) Databases on the fly.
+ * The modification can be performed in two ways: 
+ * a) Modifying only the tile data and using the standard geometryTechnique to mesh the drawable.
+ * b) Using an userdefined geometryTechnique to create other meshes than the regular triangle mesh.
+ * 
+ * Currently the changes are made on run time but in the pseudo loader. This way the modification does not affect the frame rate but only the delay in the tile delivery to the rendering thread.
+ * 
+ * @author Torben Dannhauer
+ * @date  Mrz 2011
+ */ 
 class ModificationManager
 {
 public:
+        //! Destructor: Must be public to ensure the singleton can be cleand up at the end of the programm.
         ~ModificationManager(){};
 
+        /**
+         * \brief This function returns a reference to the singleton instance of the terrain manager.
+         * 
+         * @return Reference to the singleton instance of the terrain manager.
+         */ 
         static ModificationManager* getInstance() {static ModificationManager instance; return &instance;}
 
-        //void addRoi();
+        /**
+         * \brief This function adds a terrain class to the manager to be managed and accessible to terrain modifications.
+         * 
+         * @param terrain : Terrain to manage.
+         */ 
+        void addTerrainToManage(osgTerrain::Terrain* terrain);
 
-private:
-        ModificationManager(){};
-
-        ModificationManager(const ModificationManager& cc) {};
+        /**
+         * \brief This functions removes a terrain class from the manager to stop it's managing.
+         * 
+         * @param terrain : Terrain to remove.
+         * @return : True of the specified terrain was managed and is now removed. If the specified terrain was not managed it will return false.
+         */ 
+        bool removeTerrainToManage(osgTerrain::Terrain* terrain);
 
 
 
+        //void addRoi(region modificationROI, terrainModificationTechnique* technique=NULL);
+        //bool removeRoi(region modificationROI);
+
+        void setGeometryTechniquePrototype( osgTerrain::GeometryTechnique* geomTechnique, osgTerrain::Terrain* terrain=NULL );
+
+
+private:
+        //! Constructor: Private to avoid that this class can be instantiated - it should only be usable as singleton.
+        ModificationManager(){};
+
+        //! Copy-Constructor: Private to avoid that someone can create an class instance by copying the singleton instance.
+        ModificationManager(const ModificationManager& cc) {};
+
+        //! Vector of all managed terrain pointers.
+        std::vector<osgTerrain::Terrain*> managedTerrain;
+
 };