include/gdb/terrainDatabaseTool.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2005 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/
/*******************************************************************************
** $RCSfile: terrainDatabaseTool.h,v $ $Revision: 1.5 $ $State: Exp $
*******************************************************************************/
#ifndef terrainDbTool_H_
#define terrainDbTool_H_

//
// \file terrainDbTool.h 
// \brief Contains the DtTerrainDatabaseTool class declaration.
// 

#include "gdb/gdbDefines.h"

class DtTerrainDatabase;
class DtTerrainDatabaseToolConfiguration;
class Coordinate_System;
class DtPoint;

// 
// The DtTerrainDatabaseTool is a tool for manipulating a specified terrain
// database.  It provides capabilities such as clipping/planarizing the vector
// data, eliminating duplicate vertices, and other common terrain modifications.
class DT_DLL_gdb DtTerrainDatabaseTool
{
public:

   DtTerrainDatabaseTool();

   // Copy constructor and Assignment operator are left 
   // to default, compiler generated versions.
   // @note The DtTerrainDatabaseTool @b is copyable and assignable.
   //
   // DtTerrainDatabaseTool(const DtTerrainDatabaseTool& original);
   // DtTerrainDatabaseTool& operator=(const DtTerrainDatabaseTool& original);

   virtual ~DtTerrainDatabaseTool();

   // Eliminate duplicate vertices with tolerance
   void eliminateDuplicateVertices(double tolerance, DtTerrainDatabase& terrainDb) const;

   // Eliminate duplicate surfaces
   void eliminateDuplicateSurfaces(DtTerrainDatabase& terrainDb) const;

   // Turn 3-sided polygons into triangles, if any.
   void convert3SidedPolygonsToTriangles(DtTerrainDatabase& terrainDb) const;

   // Apply all transformation nodes
   void collapseNodeTree(DtTerrainDatabase& terrainDb) const;

   // Transform the existing coordinate system to another coordinate system.
   void transformCoordinateSystem(Coordinate_System& toCs, 
      bool allowReflect, DtTerrainDatabase& terrainDb) const;

   void setOrigin(double radiansLatitude, double radiansLongitude, 
      unsigned int zone, DtTerrainDatabase& terrainDb) const;

   // Clip vector data
   void clipVectorData(DtTerrainDatabase& terrainDb) const;

   void clipVectorData(const DtPoint& swPoint, const DtPoint& nePoint, 
      DtTerrainDatabase& terrainDb) const;

   // Planarize vector data
   void planarizeVectorData(double tolerance, unsigned int excessiveEdgeCount, 
      DtTerrainDatabase& terrainDb) const;

   // Eliminate duplicate specifications
   void eliminateDuplicateSpecifications(DtTerrainDatabase& terrainDb) const;
   
   // Re-balance the node tree - is this exposed or not?
   void rebalanceTerrain(unsigned int branching, unsigned int leafing, 
      DtTerrainDatabase& terrainDb) const;

   bool processDatabase(DtTerrainDatabase& terrainDatabase, 
                        const DtTerrainDatabaseToolConfiguration& config);


private:



};

#endif