include/terrainCS/flatEarthCrdSys.h

Go to the documentation of this file.

/*********************************************************************
** Copyright (c) 2004 MAK Technologies, Inc.
** All rights reserved.
*********************************************************************/
/*********************************************************************
** $RCSfile: flatEarthCrdSys.h,v $ $Revision: 1.14 $ $State: Exp $
*********************************************************************/
#ifndef flatEarthCrdSys_H_
#define flatEarthCrdSys_H_

//
// \file flatEarthCrdSys.h Contains the flat earth coordinate system class declaration.
// 

#include "terrainCS/terrainCSDefines.h"
#include "terrainCS/coordSystem.h"

//
// Instances of DtFlatEarthCS are used by the terrain objects
// for performing coordinate conversions from geocentric to flat earth.
class DT_DLL_terrainCS DtFlatEarthCS : public Coordinate_System
{
public:
   // constructor
   DtFlatEarthCS(double refLatitude,
      double refLongitude, bool setUseDynamicSceneOrigin = false,
      double dynamicSceneOriginDeadband = 0.0);

   DtFlatEarthCS(bool setUseDynamicSceneOrigin = false,
      double dynamicSceneOriginDeadband = 0.0);

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

   // destructor
   virtual ~DtFlatEarthCS();

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

   // Clone operator
   virtual Coordinate_System* clone() const;

   // coordinates in the local (i.e., projected) coordinate system only
   // consist of X and Y, but we use a three element vector to store them so a
   // programmer can use the Z value for height above terrain.
   virtual void dis2local(const DtVector& in, DtVector& out) const;
   virtual void local2dis(const DtVector& in, DtVector& out) const;

   virtual DtVector down(const DtVector& location) const;
   virtual void topoToLocal(const DtVector& localPosition, DtDcm& topoToLocal) const;
   virtual void localToTopo(const DtVector& localPosition, DtDcm& localToTopo) const;

   // Returns the geodetic coordinate for a given local position.
   virtual void localToGeodetic(const DtVector& localPosition,
      DtGeodeticCoord& geodeticPosition) const;

   // Returns the local coordinate for a given geodetic position.
   virtual void geodeticToLocal(const DtGeodeticCoord& geodeticPosition,
      DtVector& localPosition) const;

   virtual void initFromLatLon(double latRadians, double lonRadians);

   virtual void init();

   // Returns name of coordinate system
   virtual DtString coordinateSystemName() const;
   virtual void setOrigin(const DtGeodeticCoord& c);

   // Override as UTM grid declination calculations should not be used for this
   virtual DtDcm topoToUtmMatrix(const DtVector& geocLoc) const;
   virtual DtDcm utmToTopoMatrix(const DtVector& geocLoc) const;

protected:
   double myRefLatitude;
   double myRefLongitude;

public:
   // Radius of the earth used in the Multigen Flat Earth projection.
   // (defined to be 6366707.02 meters).
   // This value was taken from the SRM_EOR_MFE enumerant in the 
   // SRM_Ellipsoid_Of_Revolution table on the SEDRIS web site 
   // (www.sedris.org).
   static const double theMultigenFlatEarthRadius;
};

#endif