lrsurface.h

Go to the documentation of this file.

/**
 * \file lrsurface.h <gre/lrsurface.h>
 * \brief GRE_LAYER_SURFACE definitions
 * \if NODOC
 * $Id: lrsurface.h_v 1.5 2005/06/17 17:06:29 vdronov Exp $
 *
 * $Log: lrsurface.h_v $
 * Revision 1.5  2005/06/17 17:06:29  vdronov
 * added saving of optimization structure
 *
 * Revision 1.4  2005/06/13 16:14:53  vdronov
 * removed sparse and dense raycasting
 *
 * Revision 1.3  2005/03/31 16:57:06  fileserver!dwilliss
 * Rename one of our types to MIUNICODE because it conflicted with a Microsoft #define
 *
 * Revision 1.2  2005/02/28 18:04:40  scowan
 * Support layer copy virtual method.
 *
 * Revision 1.1  2005/01/20 16:57:42  mju
 * Initial revision
 *
 * \endif
**/

#ifndef  INC_GRE_LRSURFACE_H
#define  INC_GRE_LRSURFACE_H

#ifndef  INC_GRE_LAYER_H
   #include <gre/layer.h>
#endif

#ifndef  INC_GRE_3DTERRA_H
   #include <gre/3dterra.h>
#endif

//===================================================================================================================

class GRE_LAYER_SURFACE : public GRE_LAYER {
   public:

      enum RENDERING_MODE {
         RENDERING_MODE_None = -1,
         RENDERING_MODE_VariableTriangulation = 0,
         RENDERING_MODE_PiecewiseTIN = 1,
         RENDERING_MODE_FlatTriangulation = 2
         };

      // GRE_LAYER_SURFACE::DISPPARM
      class DISPPARM : public GRE_LAYER::DISPPARM {
         public:

            class DLG;

            MIUNICODE filename[FILENAME_MAX];         //!< Filename of the object
            RVC::OBJECTNAME m_GeorefName;          //!< Name of georeference object
            int fhandle;                           //!< RVC file handle
            int ohandle;                           //!< RVC object handle
            RVCRASTINFO objinfo;
            INT32 WireSample;                //!< Wireframe sampling rate
            double RastNullValue;            //!< Raster null cell value as double
            DRANGE *TileRange;               //!< Range of values for each raster tile in base tier
            RENDERING_MODE m_RenderingMode;
            bool m_SaveOptimizationStructure;
            double m_ErrorTolerance;

            DISPPARM ();
            DISPPARM (
               const DISPPARM& rhs
               ): GRE_LAYER::DISPPARM(rhs) { Copy(rhs); }
            virtual ~DISPPARM (
               ) { Free(); }

            DISPPARM& operator= (const DISPPARM& rhs) {
               if (this != &rhs) {
                  Free();
                  Copy(rhs);
                  }
               return (*this);
               }

            int OpenObject (UINT32 filemode = RVCFILE_ReadLock, MDLGPARENT parent = NULL);

         protected:
            virtual const SERIALIZER::ITEMDEF* SerialGetItemDef (SERIALIZER& serializer) const;

         private:
            #ifndef GENERATING_DOXYGEN_OUTPUT
            void CloseObject ();
            void Copy (const DISPPARM&);
            void Free ();

            virtual ERRVALUE v_SetObjItem (const RVC::OBJITEM& objitem, bool replace);
            virtual ERRVALUE v_Validate ();

            friend class GRE_LAYER_SURFACE;
            #endif // GENERATING_DOXYGEN_OUTPUT
         }; // End of GRE_LAYER_SURFACE::DISPPARM

      //! Register this layer type
      static void RegisterType (
         );

      //! Construct layer and insert into list
      explicit GRE_LAYER_SURFACE (
         GRE_GROUP *group,                            //!< Group to contain layer
         CREATEFLAGS createflags = CREATEFLAG_None,   //!< Creation flags
         GRE::LISTPOS listpos = GRE::LISTPOS_Last,    //!< Position in list
         GRE_LAYER *reflayer = 0                      //!< Reference layer for insertion
         );

      virtual ~GRE_LAYER_SURFACE ();

      //! Open object(s) for this layer
      //! @return TRUE if was opened, FALSE if open already, < 0 if error
      virtual int OpenObject (
         UINT32 filemode = RVCFILE_ReadLock,    //!< RVC file access mode
         MDLGPARENT dlgparent = 0               //!< Parent for dialog
         );

      //! Retrieve layer-specific display parameters.
      const DISPPARM& GetDispParm (
         ) const { return (m_dispparm); }

      //! Get Z coordinates for set of points.
      //! This method is used mainly in 3D rendering and measurement to obtain the Z coordinates
      //! of one or more points in some other map projection or layer coordinate system.
      int GetPointsZ (
         const TRANSPARM& PtoS,                 //!< Transformation from point to surface object coordinates
         DPOINT3D *points,                      //!< Points to obtain Z values for
         INT32 NumPoints,                       //!< Number of points
         double dftz                            //!< Default Z value for off-surface points
         );

      int GetPointsZ (
         const TRANS2D_MAPGEN& PtoS,            //!< Transformation from point to surface object coordinates
         DPOINT3D *points,                      //!< Points to obtain Z values for
         INT32 NumPoints,                       //!< Number of points
         double dftz                            //!< Default Z value for off-surface points
         ) { return (GetPointsZ(PtoS.GetTransParm(),points,NumPoints,dftz)); }

      //! Get Z coordinates for set of points.
      //! This method is used mainly in 3D rendering and measurement to obtain the Z coordinates
      //! of one or more points in some other map projection or layer coordinate system.
      ERRVALUE GetPointsZ (
         const TRANS2D_MAPGEN& PtoS,            //!< Transformation from point to surface object coordinates
         POLYLINE& PolyLine,                    //!< Points to obtain Z values for
         double dftz                            //!< Default Z value for off-surface points
         );

      //! Set layer-specific display parameters.
      //! This is the recommended method for changing how an existing layer is to be
      //! rendered.  Validation will be performed on the specified parameters and
      //! adjustments made to the layer's copy if necessary.  Use of this method
      //! usually results in a ChangeBegin / ChangeEnd message pair, and will also
      //! generate a ChangeObject message if the spatial object used in the layer
      //! is changed.
      ERRVALUE SetDispParm (
         const DISPPARM& dispparm               //!< Parameters to set
         );

      GRE::TERRAIN* GetTerrain (
         ) { return m_Terrain; };

   protected:

      DISPPARM m_dispparm;                      //!< Layer-specific display parameters

   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT

      GRE::TERRAIN *m_Terrain;

      int WireReadRaster ();
      void CheckTerrain ();

      //! Overrides from GRE_LAYER.
      virtual ERRVALUE v_AssignObject (const RVC::OBJITEM& objitem, MDLGPARENT dlgparent);
   #if defined(X_NATIVE) || defined(WIN32_MFC)
      virtual int v_ControlPanel (MDLGPARENT dlgparent,UINT32 flags = 0);
   #endif
      virtual GRE_LAYER* v_Copy (GRE_GROUP *group) const;
      virtual ERRVALUE v_Draw (GRE_LAYERDC& layerdc);
      virtual bool v_GetGeorefName (RVC::OBJECTNAME& name, int component = 0) const;
      virtual const RVC::OBJITEM& v_GetObjItem (int component) const;
   #if defined(X_NATIVE) || defined(WIN32_MFC)
      virtual ERRVALUE v_PromptObject (bool OpenCtrlPanel, MDLGPARENT dlgparent);
   #endif
      virtual const char* v_SerialGetTagName () const;
      virtual void v_SetDftName (bool ReplaceExisting);
      virtual int v_UpdateExtents (bool forceupdate);

      GRE_LAYER_SURFACE (const GRE_LAYER_SURFACE&);
      GRE_LAYER_SURFACE& operator= (const GRE_LAYER_SURFACE&);

      #endif // GENERATING_DOXYGEN_OUTPUT
   };


//===================================================================================================================

#endif   // INC_GRE_LRSURFACE_H

---