flightTerrainInitializer.h

Go to the documentation of this file.

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

#include "flt/fltDefines.h"
#include <matrix/mapDatum.h>
#include "geometry/point.h"
#include "gdb/terrainFileInitializer.h"
#include "gdb/terrainDatabaseToolConfiguration.h"

// class DtFlightTerrainInitializer: has the parameters to create 
// a gdb based off of flight files. Namely it holds the reference Ellipsoid
// and datum shift to create the map datum for the coordinate system, 
// as well as external reference and LOD parameters.
class DT_DLL_flt DtFlightTerrainInitializer : public DtTerrainFileInitializer
{

public:

   DtFlightTerrainInitializer();

   virtual ~DtFlightTerrainInitializer();

   // copy constructor
   DtFlightTerrainInitializer(const DtFlightTerrainInitializer& orig);

   // assignment operator
   DtFlightTerrainInitializer& operator=(const DtFlightTerrainInitializer& orig);

   virtual DtString type() const;

   // set/get Semi-Major axis for ellipsoid
   virtual void setMajorAxis(double major);
   virtual const double majorAxis() const;

   // set/get Semi-Minor axis for ellipsoid
   virtual void setMinorAxis(double minor);
   virtual const double minorAxis() const;

   // Sets from major/minor and shifts.  If resetToCurrent is true,
   // uses DtCurrentMapDatum()
   virtual const DtMapDatum mapDatum() const;

   // set/get datum shift
   virtual void setDatumShift(const DtPoint & shift);
   virtual const DtPoint datumShift() const;

   // The following is only relevant for projected coordinate systems:

   // set/get the projection's central scale
   virtual void setProjectionScale(double scale);
   virtual const double projectionScale() const;

   // Get/set the number of levels to keep as external files
   // For instance, if this is set to 0, then the entire flight file will be 
   // read into a single gdb, with no referenced pieces maintained as external
   // references.
   virtual void setNumberOfExternalLevelsToKeep(unsigned int numLevels);
   virtual const unsigned int numberOfExternalLevelsToKeep() const;

   virtual void setLodDistance(double newLodDistance);
   virtual const double lodDistance() const;

   virtual void setLowLodDistance(double distance);
   virtual const double lowLodDistance() const;

   // If inverse flattening is non-zero, when the minor axis is requested,
   // even if it has been defined in the map file, it will still be defined
   // in terms of the inverse flattening (i.e. inverse flattening takes
   // precedence)
   virtual void setInverseFlattening(double);
   virtual const double inverseFlattening() const;

   // If switch nodes are present in the flt file, only load from the
   // supplied path.
   virtual void setFlightPath(const DtString&);
   virtual const DtString flightPath() const;

   virtual void setDefaultSwitchNodeChildIndex(unsigned int index);
   virtual unsigned int defaultSwitchNodeChildIndex() const;

   virtual DtTerrainDatabaseToolConfiguration terrainDbConfig() const;
   virtual void setTerrainDbConfig(const DtTerrainDatabaseToolConfiguration& newTerrainDbConfig);

protected:

   mutable DtMapDatum  myMapDatum;
   double      myProjectionCentralScale;

   // The number levels of external nodes to keep as DtFileNodes (default = 0).
   // Note: if this is > 0, loading them will also cause them to save as gdb
   // files.
   unsigned int myNumberOfExternalLevelsToKeep;

   double       myLodDistance;

   // The low level of detail that is used to generate alternate
   // representations for DtFileNodes (<0 to disable).
   double       myLowLodDistance; 

   double      myInverseFlattening;
   bool        mySetMapDatumFromCurrent;
   DtString    myFlightPath;

   unsigned int myDefaultSwitchNodeChildIndex;

   // Processing parameters
   //
   // These only apply when "keeping external levels" as described above.
   // These are the parameters that indicate the processing that needs to
   // happen to the external files before they are written out as "gdb" files.
   //
   // Since this kind of processing is done using a DtTerrainDatabaseTool, 
   // that's what we have a processing config file for.  
   DtTerrainDatabaseToolConfiguration myTerrainDbToolConfig;
};

#endif