gre/layer.h

Go to the documentation of this file.

/**
 * \file gre/layer.h
 * \brief GRE::LAYER class definition
 *
 * \if NODOC
 * $Id: layer.h_v 1.114 2007/03/12 17:41:05 mju Exp $
 *
 * $Log: layer.h_v $
 * Revision 1.114  2007/03/12 17:41:05  mju
 * Add v_setObjectDescriptor.
 *
 * Revision 1.113  2006/09/19 17:29:19  mju
 * Add globaloptions.forceGeorefAffine.
 *
 * Revision 1.112  2006/08/01 17:51:26  mju
 * Add layerflag_noInvalidateViews.
 *
 * Revision 1.111  2006/04/19 20:36:28  mju
 * Add treeViewUpdateDetails.
 *
 * Revision 1.110  2006/02/22 17:16:54  mju
 * Add typedefn support for 'edit' icon.
 *
 * Revision 1.109  2006/02/16 21:02:03  mju
 * Add treeview tooltip delegates.
 *
 * Revision 1.108  2006/01/05 17:50:04  dwilliss
 * changed parm type on a method
 *
 * Revision 1.107  2006/01/04 16:53:15  mju
 * Deprecate loadDispParmSubObject.
 *
 * Revision 1.106  2005/12/22 14:19:31  mju
 * Add comment.
 *
 * Revision 1.105  2005/12/22 14:16:49  mju
 * Exclude type_next if no_deprecated.
 *
 * Revision 1.104  2005/12/19 17:12:14  mju
 * Allow getMenuItemCreate unless deprecate_all.
 *
 * Revision 1.103  2005/12/08 22:40:26  mju
 * Remove mem24 virtual.
 *
 * Revision 1.102  2005/11/28 16:37:58  mju
 * Support legend update in treeview.
 *
 * Revision 1.101  2005/11/21 16:05:47  scowan
 * Allow using layer type as counter.
 *
 * Revision 1.100  2005/11/16 22:46:42  mju
 * Add promptGeoDatabasesAndConstruct.
 *
 * Revision 1.99  2005/11/11 21:39:46  mju
 * Add treeViewOnCustomDraw for layer.
 *
 * Revision 1.98  2005/11/10 20:38:46  scowan
 * Do not define v_setupTreeViewShared if not mGUI.
 *
 * Revision 1.97  2005/11/10 18:46:11  mju
 * Add treeview delegate for getItemInfo.
 *
 * Revision 1.96  2005/11/07 21:10:37  mju
 * Deprecate getMenuItemCreate.
 *
 * Revision 1.95  2005/11/07 17:21:51  mju
 * Add compinfo method to handle treeview child visibility changing.
 *
 * Revision 1.94  2005/11/04 18:52:03  mju
 * enums in gre namespace.
 * Add showSystemTables to compinfo.
 *
 * Revision 1.93  2005/11/03 19:44:00  mju
 * Remove stuff to get setting for showing internal tables.
 *
 * Revision 1.92  2005/11/03 18:27:02  mju
 * Make v_MenuAddToolItems protected instead of private.
 *
 * Revision 1.91  2005/11/02 23:00:44  mju
 * Remove objmgr stuff.
 *
 * Revision 1.90  2005/10/27 14:04:53  mju
 * Fix doc comments.
 *
 * Revision 1.89  2005/10/26 16:55:13  mju
 * Remove stuff for tabular view toggle in tableinfo.
 *
 * Revision 1.88  2005/10/19 20:03:37  mju
 * Use gre namespace instead of legacy typedefs.
 *
 * Revision 1.87  2005/10/14 17:30:20  mju
 * GRE namespace and treeview.
 *
 * Revision 1.86  2005/09/02 17:05:09  mju
 * Add global option for dftMultiPassRendering.
 *
 * Revision 1.85  2005/08/29 20:44:20  scowan
 * Fixed g++ duplication warning.
 *
 * Revision 1.84  2005/08/16 20:29:05  dwilliss
 * Added a private static method
 *
 * Revision 1.83  2005/06/17 16:48:10  mju
 * Forward-declare mgui:;dlgshell.
 *
 * Revision 1.82  2005/05/24 16:12:13  mju
 * Add layerflag_DataTipIgnoreDrawnSet.
 *
 * Revision 1.81  2005/05/11 20:58:18  mju
 * Add dispflag_noMergeLegendDups.
 *
 * Revision 1.80  2005/05/02 17:43:45  mju
 * Remove highlightmode for layer.
 *
 * Revision 1.79  2005/04/29 17:49:30  mju
 * Support rendertarget.
 *
 * Revision 1.78  2005/04/14 19:39:50  mju
 * Add dispflag_enableMultiPassRender.
 *
 * Revision 1.77  2005/03/31 16:57:06  fileserver!dwilliss
 * Rename one of our types to MIUNICODE because it conflicted with a Microsoft #define
 *
 * Revision 1.76  2005/03/22 22:00:50  mju
 * Add invalidateAllViews.
 *
 * Revision 1.75  2005/03/07 17:23:15  scowan
 * Fixed some unix warnings.
 *
 * Revision 1.74  2005/03/01 16:50:27  scowan
 * Made v_copy pure virtual and created an interface to call it.
 * Support v_copy method.
 *
 * Revision 1.73  2005/03/01 14:20:38  mju
 * Add getElemHighlightSet, remove elemsearch stuff.
 *
 * Revision 1.72  2005/02/25 18:57:47  mju
 * Add v_hasHighighlighted.
 *
 * Revision 1.71  2005/02/25 18:54:20  mju
 * Remove layerview defns to own header.
 * Add v_Copy virtual method.
 *
 * Revision 1.70  2005/02/25 17:47:16  mju
 * More layerview methods.
 *
 * Revision 1.69  2005/02/24 18:52:23  mju
 * Remove layerview getBackgroundColor.
 *
 * Revision 1.68  2005/02/23 18:52:32  mju
 * Add layerview stuff for highlight device.
 * Move labelplacement methods to layerview.
 * Add layerview_labeled for common labelplacement handling.
 *
 * Revision 1.67  2005/02/18 19:06:32  mju
 * Changes to layerview for separated rendering.
 *
 * Revision 1.66  2005/02/17 21:18:55  mju
 * Add layerview stuff for separate rendering.
 *
 * Revision 1.65  2005/02/15 17:50:24  scowan
 * No real changes.
 *
 * Revision 1.64  2005/02/15 17:34:28  scowan
 * Do not include grtree unless in x only.
 *
 * Revision 1.63  2005/02/15 17:22:20  mju
 * Add full/used rectangles to layerview.
 *
 * Revision 1.62  2005/02/14 21:39:36  mju
 * Use device in usesTransparency.
 *
 * Revision 1.61  2005/02/14 18:52:47  mju
 * Move some stuff from layerview to groupview.
 *
 * Revision 1.60  2005/01/27 21:42:32  mju
 * Add layerview stuff for labels.
 *
 * Revision 1.59  2005/01/24 21:31:08  mju
 * Move members to layerview from layerdc.
 *
 * Revision 1.58  2005/01/20 16:54:34  mju
 * Enums for createflags, drawmode, highlightmode.
 * Add static methods to replace legacy mdisp fns.
 * Redesign typedefn class to use textid, iconid, virtual methods, etc.
 *
 * Revision 1.57  2005/01/12 17:12:42  mju
 * Include transformations in layerview.
 *
 * Revision 1.56  2005/01/04 15:22:53  mju
 * Deprecate assign method using fnameinode.
 *
 * Revision 1.55  2005/01/03 21:46:48  mju
 * Add trans and mgd dev to layerview.
 *
 * Revision 1.54  2004/10/15 21:25:33  ldyas
 * added method for needsmem24
 *
 * Revision 1.49  2004/10/06 13:53:48  mju
 * Not necessary to forward-declare inlines for get/set antialias/thinhint methods.
 *
 * Revision 1.47  2004/10/01 17:19:32  mju
 * Add methods for detail density checking.
 * Add dlgparent to assignObject.
 *
 * Revision 1.46  2004/09/29 18:25:42  ldyas
 * now when set antialias also set use transparency.
 *
 * Revision 1.45  2004/09/28 22:17:59  ldyas
 * added antialiasing to globals.
 *
 * Revision 1.43  2004/09/24 00:48:53  ldyas
 * added thin line width hinting
 *
 * Revision 1.41  2004/09/23 22:55:02  ldyas
 * added antialiasing to dispparm.
 *
 * Revision 1.40  2004/09/20 19:11:44  dglasser
 * added setOldPrj for sml grelayer.
 *
 * Revision 1.39  2004/09/03 22:49:50  dwilliss
 * Added some members to dispparm
 * DrawLabel no longer needs to be virtual
 *
 * Revision 1.38  2004/08/19 22:19:50  vdronov
 * changed transp from 100 to 255
 *
 * Revision 1.37  2004/08/18 16:25:33  mju
 * Make updateExtents non-inline.
 *
 * Revision 1.35  2004/07/21 21:55:54  mju
 * Add layerview support.
 *
 * Revision 1.31  2004/07/19 22:56:10  dwilliss
 * LABELPLACEMENT changes
 *
 * Revision 1.30  2004/07/14 20:02:22  dwilliss
 * Forgot to add the inline wrapper to call a private virtaul method
 *
 * Revision 1.29  2004/07/13 22:33:03  dwilliss
 * Added a virtual method for labels
 *
 * Revision 1.28  2004/07/12 23:14:34  mju
 * Nod georegion.
 *
 * Revision 1.27  2004/07/07 22:00:34  mju
 * Add updateMapRegion.
 *
 * Revision 1.26  2004/07/07 20:51:29  vdronov
 * added SetPedestal and IsPedestalSet
 *
 * Revision 1.25  2004/06/29 21:35:24  mju
 * Add highlightElementsByRegion using region2d.
 *
 * Revision 1.24  2004/06/28 17:53:20  mju
 * Convert to spatref system.
 *
 * Revision 1.22  2004/06/11 17:48:34  vdronov
 * removed flags related to RayCasting
 *
 * Revision 1.21  2004/06/04 19:20:44  dglasser
 * Don't use memset with TEXTSTYLEs in SML.  Added SMLSET_TextStyleMember.
 *
 * Revision 1.20  2004/05/05 22:49:56  dwilliss
 * Started adding support for LABELPLACEMENT
 *
 * Revision 1.19  2004/04/02 18:54:43  mju
 * Add ModifyStamp methods.
 *
 * Revision 1.18  2004/03/31 21:32:04  mju
 * Add DrawElement using rvc::ELEMENT.
 *
 * Revision 1.17  2004/02/12 22:43:22  dwilliss
 * deprecate old mgd
 *
 * Revision 1.16  2004/02/06 16:23:28  mju
 * Reorder fns.
 *
 * Revision 1.15  2004/02/06 16:01:34  mju
 * Use GRE::FINDFLAGS.
 *
 * Revision 1.14  2004/02/05 22:08:25  mju
 * Integrate datatip support.
 *
 * Revision 1.13  2003/12/22 16:31:11  vdronov
 * made CanViewIn... methods not inline.
 *
 * Revision 1.12  2003/12/15 16:52:51  mju
 * Add dispflag_VectNoFillHighlighted.
 *
 * Revision 1.11  2003/11/20 13:26:33  mju
 * Add SetVisiblityGroupFromLayout.
 *
 * Revision 1.7  2003/09/23 13:08:08  mju
 * Explicitly init serializble in copy dispparm copy ctor.
 *
 * Revision 1.4  2003/07/31 13:38:40  mju
 * Add Filter method to LAYER::FILTER.
 *
 * Revision 1.3  2003/07/30 15:15:58  mju
 * Ignore private sections.
 * Move DISPPARM defn outside layer so will be doc'd.  Add inlines where req'd.
 *
 * Revision 1.1  2003/06/16 19:39:43  mju
 * Initial revision
 * \endif
**/

#ifndef  INC_GRE_LAYER_H
#define  INC_GRE_LAYER_H

#ifndef  INC_GRE_OBJECTBASE_H
   #include <gre/objectbase.h>
#endif

#ifndef  INC_GRE_VIEWABLE_H
   #include <gre/viewable.h>
#endif

#ifndef  INC_GRE_3DWIREFRAME_H
   #include <gre/3dwireframe.h>
#endif

#if !defined(INC_MGUI_TREE_H) && defined(USE_MGUI)
   #include <mgui/tree.h>
#endif

#if !defined(INC_MI32_GRTREE_H)
   #include <mi32/grtree.h>
#endif

#ifndef  INC_MI32_RANGE_H
   #include <mi32/range.h>
#endif

#ifndef  INC_RVC_ELEMENT_H
   #include <rvc/element.h>
#endif

#ifndef  INC_MI32_RVCPARMS_H
   #include <mi32/rvcparms.h>
#endif

#ifndef  INC_MI32_DBEDIT_H
   #include <mi32/dbedit.h>
#endif

#ifndef  INC_MI32_REGION2D_H
   #include <mi32/region2d.h>
#endif

#ifndef  INC_MI32_TRANS2DC_H
   #include <mi32/trans2dc.h>
#endif

#ifndef GENERATING_DOXYGEN_OUTPUT

class BITSET;
class BITSET_UNOWNED;
struct SMLCONTEXT;
struct SMLCLASSMEMBER;
union SMLARG;
struct DATATIPPARMS;
namespace RVC {
   class GETOBJFILTER;
   class DESCRIPTOR;
   }
namespace MGD {
   class DEVICE;
   }
#ifdef USE_MGUI
namespace MGUI {
   class DLGSHELL;
   class MENU;
   }
#endif

#endif   // GENERATING_DOXYGEN_OUTPUT

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

//! Flags stored in xxxxDISPPARM.dispflags
enum DISPFLAGS {
   DISPFLAG_None =                  0x00000000,
   DISPFLAG_SaveDrawnSetOBS =       0x00000001, //!< OBSOLETE, DO NOT USE, retain def so can read old dispparms
   DISPFLAG_KeepOpenOBS =           0x00000002, //!< OBSOLETE, DO NOT USE, retain so can read old dispparms
   DISPFLAG_UseTempFile =           0x00000004, //!< Object is in a temporary file
   DISPFLAG_EditObjectOBS =         0x00000008, //!< OBSOLETE, DO NOT USE, retain so can read old dispparms
   DISPFLAG_NoDrawLabels =          0x40000000, //!< Don't draw labels
   DISPFLAG_DrawLabelsOnly =        0x80000000, //!< Only draw labels

   DISPFLAG_WarpToGeorefModel =     0x00000100, //!< Warp to model specified with georeference
   DISPFLAG_UsesTransparency =      0x00000200, //!< Uses transparency effects
   DISPFLAG_NoDrawWireframe =       0x00000400, //!< Don't draw layer in wireframe mode
   DISPFLAG_MayUseTransparency =    0x00000800, //!< Use of transparency unknown, assume it does until first time draw
   DISPFLAG_Antialias =             0x00001000, //!< Draw Antialiased
   DISPFLAG_HintThinLines =         0x00002000, //!< Imply thin lines via transparency
   DISPFLAG_EnableMultiPassRender = 0x00004000, //!< Enable multipass rendering for styles
   DISPFLAG_NoMergeLegendDups =     0x00008000, //!< Don't combine duplicate styles in legend

   DISPFLAG_VectDrawNodes =         0x00010000, //!< Draw nodes for vector object
   DISPFLAG_VectLinesFirst =        0x00020000, //!< Draw vector lines before polygons
   DISPFLAG_VectNoFillPoly =        0x00040000, //!< Disable polygon filling
   DISPFLAG_VectNoFillHighlighted = 0x00080000, //!< Disable polygon filling when highlighted

   DISPFLAG_TINEdgesFirst =         0x00020000, //!< Draw TIN edges before triangles
   DISPFLAG_TINNoFillTri =          0x00040000, //!< Don't fill TIN triangles

   DISPFLAG_RastNullTransp =        0x00010000, //!< Make "null" cells transparent
   DISPFLAG_RastSkipOddLines =      0x00020000, //!< Skip odd screen lines (for 3Dmax glasses)
   DISPFLAG_RastSkipEvenLines =     0x00040000, //!< Skip even screen lines (for 3Dmax glasses)
   DISPFLAG_RastDoBlendMask =       0x00080000, //!< Do mask transparency blending if possible
   DISPFLAG_RastHyperspectLossy =   0x00400000, //!< Display hyperspectral in fast-lossy mode

   DISPFLAG_SurfProjOffEdge =       0x00010000, //!< Project data off edge of surface

   DISPFLAG_FormulaNullTransp =     0x00010000, //!< Make "null" cells transparent
   DISPFLAG_FormulaSkipOddLines =   0x00020000, //!< Skip odd screen lines (for 3Dmax glasses)
   DISPFLAG_FormulaSkipEvenLines =  0x00040000, //!< Skip even screen lines (for 3Dmax glasses)
   };
DEFINE_ENUM_OP_BITWISE(DISPFLAGS);

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

enum LAYERDRAWFLAGS {
   LAYERDRAWFLAG_None =             0x0000,  //!< No flags
// LAYERDRAWFLAG_ClipTo =           0x0001,
   LAYERDRAWFLAG_Clip =             0x0002,  //!< Clip layer
   LAYERDRAWFLAG_NoClipToGroup =    0x0004,  //!< Don't clip layer to group
   LAYERDRAWFLAG_SaveToTemplate =   0x0008,  //!< Save layer as-is to template
   LAYERDRAWFLAG_EditInTNTserver =  0x0010,  //!< Allow layer to be edited in TNTserver
   LAYERDRAWFLAG_MaskAll =          0xFFFF,  //!< Mask for setting all flags
   };
DEFINE_ENUM_OP_BITWISE(LAYERDRAWFLAGS);

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

enum LAYERFLAGS {
   LAYERFLAG_None =                    0x00000000, //!< No flags
   LAYERFLAG_NoSelNewObj =             0x00000010, //!< Don't allow user to select new object(s) via CtrlPanel
   LAYERFLAG_HiliteColorSet =          0x00000040, //!< Separate highlight color has been set for layer
   LAYERFLAG_DataTipIgnoreDrawnSet =   0x00000080, //!< Ignore DrawnSet when searching for DataTip element
   LAYERFLAG_NoInvalidateViews =       0x00000100, //!< Don't allow invalidation of render buffers
   LAYERFLAG_3D =                      0x00000200, //!< Layer is fully 3-D, no "surface" required
   LAYERFLAG_KeepOpen =                0x00020000, //!< Set if object should remain open until layer is destroyed
   LAYERFLAG_Editable =                0x00040000, //!< Set if layer can be edited
   LAYERFLAG_CanShowInLocator =        0x00100000, //!< Set if can show this layer in the Locator window
   LAYERFLAG_IgnoreExtents =           0x00400000, //!< Ignore this layer when determining group extents
   LAYERFLAG_NoGeoreference =          0x00080000, //!< Set if no georeference info should be read for layer
   LAYERFLAG_NoDrawActiveElem =        0x01000000, //!< Don't draw "active" element
   LAYERFLAG_NoShowInLayerMgr =        0x02000000, //!< Don't show in layer manager, must also set LAYERFLAG_Temporary
   LAYERFLAG_NoAllowHide =             0x04000000, //!< Don't allow user to hide layer
   LAYERFLAG_NoAllowDelete =           0x08000000, //!< Don't allow user to delete layer
   LAYERFLAG_Temporary =               0x10000000, //!< Layer is temporary, cannot save in layout
   LAYERFLAG_MaskAll =                 0xFFFFFFFF, //!< Mask for setting all flags
   };
DEFINE_ENUM_OP_BITWISE(LAYERFLAGS);

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

namespace GRE {

#define  GRE_MAXLAYERTYPES    32

//! Layer base class.
class LAYER : public GRE::OBJECT {
   public:

      //! Layer types.
      enum TYPE {
         TYPE_None =       0,
         TYPE_Raster =     1,
         TYPE_Vector =     2,
         TYPE_CAD =        3,
         TYPE_DBPinmap =   4,
         TYPE_MapGrid =    5,
         TYPE_ScaleBar =   6,
         TYPE_Text =       7,
         TYPE_Legend =     8,
         TYPE_TIN =        9,
         TYPE_Sketch =     10,
         TYPE_Region =     11,
         TYPE_Surface =    12,
         TYPE_Script =     13,
         TYPE_Formula =    14,
         TYPE_Legend2 =    15,
         TYPE_Shape =      16,
         TYPE_COUNT,
      #ifndef NO_DEPRECATED
         TYPE_NEXT = TYPE_COUNT           //!< Deprecated, use TYPE_COUNT instead
      #endif
         //! Check GRE_MAXLAYERTYPES when add new types
         };

      enum CREATEFLAGS {
         CREATEFLAG_None =             0x0000,
         CREATEFLAG_NoCallCreateCB =   0x0001,
         CREATEFLAG_Temporary =        0x0002,
         CREATEFLAG_NoSelNewObj =      0x0004,  //!< Don't allow user to select new object(s) via CtrlPanel
         CREATEFLAG_KeepOpen =         0x0008,  //!< Set if object should remain open until layer is destroyed
         CREATEFLAG_Editable =         0x0010,  //!< Set if creating layer to be edited
         CREATEFLAG_NoGeoreference =   0x0020,  //!< Set if no georeference info should be read for layer
         CREATEFLAG_IgnoreExtents =    0x0040,  //!< Ignore layer extents in group
         CREATEFLAG_NoAllowDelete =    0x0080,  //!< Don't allow user to delete layer
         CREATEFLAG_NoControlPanel =   0x0100,  //!< Don't allow control panel for layer
         CREATEFLAG_NoComputePos =     0x0200,  //!< Don't call ComputeLayerPositions() when adding new layer
         CREATEFLAG_NoSetActive =      0x0400,  //!< Don't make newly-created layer "active"
         CREATEFLAG_NoShowInMgr =      0x0800,  //!< Don't show this layer in layer manager
         };

      enum SETACTIVEFLAGS {
         SETACTIVEFLAG_None =          0x0000,
         SETACTIVEFLAG_First =         0x0001,
         SETACTIVEFLAG_Previous =      0x0002,
         SETACTIVEFLAG_Next =          0x0004,
         SETACTIVEFLAG_Last =          0x0008,
         SETACTIVEFLAG_KeepCurrent =   0x0010,  //!< Keep current active element if highlighted
         SETACTIVEFLAG_NoWrap =        0x0020,  //!< Don't wrap around end/beginning if reached
         SETACTIVEFLAG_UpdateScreen =  0x0040,  //!< Update display window
         SETACTIVEFLAG_UpdateBuffers = 0x0080,  //!< Update rendering buffer
         };


      //! Container for global layer options.
      class GLOBALOPTIONS {      // LAYER::GLOBALOPTIONS
         public:

            class FORM;                         //!< Global options form, defined in <gre/uilrglob.h>

            enum DFTNAMEMODE {
               DFTNAMEMODE_ObjectDesc =      0,    //!< Use object description (or name if no description)
               DFTNAMEMODE_ObjectName =      1,    //!< Use object name
               DFTNAMEMODE_FileObjNames =    2     //!< Use combined file and object names
               };

            GLOBALOPTIONS (
               );

         #ifdef X_NATIVE
            Widget CreateEditForm (
               Widget parent,
               const Arg *arglist,
               int argcount
               );
         #endif

            bool GetAntialiasing (
               ) const {return(m_Antialiasing); }

            bool GetAutoOpenDftTableOnSel (
               ) const { return (m_AutoOpenDftTableOnSel); }

            DFTNAMEMODE GetDftNameMode (
               ) const { return (m_DftNameMode); }

            bool GetDftRenderMultiPass (
               ) const { return (m_DftRenderMultiPass); }

            bool GetDftShowSystemTables (
               ) const { return (m_DftShowSystemTables); }

            bool GetForceGeorefAffine (
               ) const { return (m_ForceGeorefAffine); }

            bool GetHintThinLines (
               ) const {return(m_HintThinLines);}

            //! Read settings from Ini file.
            //! By default, settings are shared among all processes.
            //! To retain settings separately, use GRE::SYSTEM::SetGlobalIniGroup() during application initialization.
            void IniRead ();

            //! Write settings to Ini file.
            //! By default, settings are shared among all processes.
            //! To retain settings separately, use GRE::SYSTEM::SetGlobalIniGroup() during application initialization.
            void IniWrite () const;

            void SetAntialiasing (
               bool antialias
               ) { m_Antialiasing = antialias; }

            void SetAutoOpenDftTableOnSel (
               bool AutoOpenDftTableOnSel
               ) { m_AutoOpenDftTableOnSel = AutoOpenDftTableOnSel; }

            void SetDftNameMode (
               DFTNAMEMODE DftNameMode
               ) { m_DftNameMode = DftNameMode; }

            void SetDftShowSystemTables (
               bool DftShowSystemTables
               ) { m_DftShowSystemTables = DftShowSystemTables; }

            void SetForceGeorefAffine (
               bool ForceGeorefAffine
               ) { m_ForceGeorefAffine = ForceGeorefAffine; }
               
            void SetHintThinLines (
               bool hint
               ) { m_HintThinLines = hint;}

         private:
            #ifndef GENERATING_DOXYGEN_OUTPUT
            DFTNAMEMODE m_DftNameMode;
            bool m_AutoOpenDftTableOnSel;       //!< Automatically open default table on element selection (highlighting)
            friend class LAYER;
            bool m_Antialiasing;
            bool m_HintThinLines;
            bool m_DftRenderMultiPass;
            bool m_DftShowSystemTables;
            bool m_ForceGeorefAffine;

            #endif // GENERATING_DOXYGEN_OUTPUT
         }; // End of LAYER::GLOBALOPTIONS

      class DISPPARM;

      class TYPEDEFN;
      class COMPINFO;
      class FILTER;
      class FILTER_EXCLUDE;

      //! Determine if can construct layer from RVC object.
      static bool CanConstructFromObject (
         const RVC::OBJITEM& objitem
         );

      //! Compute default maximum visible scale based on object element detail/density.
      //! Maximum scale returned, 0 if none.
      static double ComputeDftMaxVisibleScale (
         const RVC::OBJITEM& objitem            //!< Object to use
         );

      //! Construct layer of specified type and assign specified object.
      static ERRVALUE ConstructAndAssignObject (
         GRE::GROUP *group,                        //!< Group to add layer to
         LAYER::TYPE layertype,              //!< Type of layer to construct
         const RVC::OBJITEM& objitem,           //!< Object to assign
         LAYER **retlayer = 0,               //!< Layer returned, NULL if not needed
         CREATEFLAGS createflags = LAYER::CREATEFLAG_None,  //!< Layer creation flags
         GRE::LISTPOS listpos = GRE::LISTPOS_Last, //!< Position for new layer in list
         LAYER *reflayer = 0                 //!< Reference layer for insertion before or after
         );

   #ifdef USE_MGUI
      //! Construct layer of specified type, prompt for object, and optional open settings window.
      static ERRVALUE ConstructAndPromptObject (
         MDLGPARENT dlgparent,                  //!< Parent for dialogs
         GRE::GROUP *group,                        //!< Group to add layer to
         LAYER::TYPE layertype,              //!< Type of layer to construct
         LAYER **retlayer,                //!< Layer returned, NULL if not needed
         CREATEFLAGS createflags,               //!< Layer creation flags
         GRE::LISTPOS listpos,                  //!< Position for new layer in list
         LAYER *reflayer,                    //!< Reference layer for insertion before or after
         bool OpenSettings                      //!< true to open settings window
         );
   #endif

   #ifdef USE_MGUI
      //! Construct layers using geospatial catalog.
      static ERRVALUE ConstructFromGeoCat (
         MDLGPARENT dlgparent,
         GRE::GROUP *group
         );
   #endif

      //! Construct layer from specified object.
      static ERRVALUE ConstructFromObject (
         GRE::GROUP *group,                           //!< Group to contain new layer
         const RVC::OBJITEM& objitem,              //!< Object to construct layer for
         LAYER **retlayer = 0,                  //!< New layer returned
         CREATEFLAGS createflags = CREATEFLAG_None,//!< Creation flags
         GRE::LISTPOS listpos = GRE::LISTPOS_Last, //!< Position of new layer in list
         LAYER *reflayer = 0,                //!< Reference layer for insertion
         MDLGPARENT dlgparent = 0                  //!< Parent for verification dialogs, NULL to not use
         );

      //! Construct multiple layers using object list (quick-add).
      static ERRVALUE ConstructFromObjList (
         GRE::GROUP *group,                        //!< Group to construct layers in, layers will be added after active layer
         const RVC::OBJITEMLIST& objlist,       //!< List of objects to construct layers for
         MDLGPARENT dlgparent = 0               //!< Parent for verification dialogs, NULL to not use
         );

      static void DataTipSystemInit ();

      //! Edit global settings via dialog
      //! @return true if settings changed, false if not
      static bool EditGlobalSettings (
         MDLGPARENT dlgparent
         );

      //! Get default layer naming mode.
      static GLOBALOPTIONS::DFTNAMEMODE GetDftNameMode (
         ) { return (s_GlobalOptions.m_DftNameMode); }

      //! Get global options applying to all layers.
      static const GLOBALOPTIONS& GetGlobalOptions (
         ) { InitStatic(); return (s_GlobalOptions); }

      //! Get number of registered layer types
      static UINT16 GetNumTypes (
         ) { return (s_NumTypes); }

      //! Get type definition for specific layer type index
      static const TYPEDEFN& GetTypeDefn (
         UINT16 idx
         ) { return (*s_TypeDefns[idx]); }

      //! Get type definition for specific layer type
      static const TYPEDEFN* GetTypeDefn (
         TYPE layertype
         );

      //! Get TEXTID for specific layer type name.
      static TEXTID GetTypeName (
         TYPE layertype
         );

      //! Determine if object has high density/detail.
      static bool HasDenseDetail (
         const RVC::OBJITEM& objitem            //!< Object to check
         );

   #ifdef USE_MGUI
      //! Prompt for geospatial databases/links construct layers in specified group.
      static ERRVALUE PromptGeoDatabasesAndConstruct (
         MDLGPARENT dlgparent,                  //!< Parent for dialog
         GRE::GROUP *group                      //!< Group to add layers to
         );
   #endif

   #ifdef USE_MGUI
      //! Prompt for multiple objects for quick-add.
      static ERRVALUE PromptObjects (
         MDLGPARENT dlgparent,                  //!< Parent for dialog
         RVC::OBJITEMLIST& objlist,             //!< List of selected objects returned
         GETOBJFLAGS flags=GETOBJFLAG_None,     //!< Additional flags for selection dialog
         const MIUNICODE *prompt = 0               //!< Prompt message for use in dialog ( Default is TEXTID_Prompt_Objects_Display )
         );
   #endif

   #ifdef USE_MGUI
      //! Prompt for multiple objects and construct layers in specified group.
      static ERRVALUE PromptObjectsAndConstruct (
         MDLGPARENT dlgparent,                  //!< Parent for dialog
         GRE::GROUP *group                      //!< Group to add layers to
         );
   #endif

      //! Register layer type
      static void RegisterLayerType (
         TYPEDEFN& typedefn
         );

      //! Set whether the default attribute table should be opened on element selection.
      static void SetAutoOpenDftTableOnSel (
         bool AutoOpenDftTableOnSel
         ) { s_GlobalOptions.m_AutoOpenDftTableOnSel = AutoOpenDftTableOnSel; }

      //! Set default layer naming mode
      static void SetDftNameMode (
         GLOBALOPTIONS::DFTNAMEMODE DftNameMode
         ) { s_GlobalOptions.m_DftNameMode = DftNameMode; }

      //! Set global options applying to all layers.
      static void SetGlobalOptions (
         const GLOBALOPTIONS& options
         ) { s_GlobalOptions = options; }

      //! Method to install SML class, called by internal SML function.
      static void SMLClassInstall (
         SMLCONTEXT *context                    //!< SML context
         );

      static SMLCLASSMEMBER* GetSMLClassMembers (
         );

      //! Constructor.
      LAYER (
         GRE::GROUP *group,                           //!< Group to contain layer
         TYPE layertype,                           //!< Layer type
         DISPPARM& dispparm,                       //!< Reference to layer's internal DISPPARM
         CREATEFLAGS createflags,                  //!< Creation flags
         GRE::LISTPOS listpos = GRE::LISTPOS_Last, //!< Position in list
         LAYER *reflayer = 0                    //!< Reference layer for insertion
         );

      //! Destructor
      virtual ~LAYER ();

   #ifdef X_NATIVE
      //! Append items to popup menu (X only).
      void AppendPopupMenuItems (
         Widget widget,                      //!< Widget popup event occurred in
         const DPOINT2D *point,              //!< Point in layer coordinates where popup event occurred, NULL if not in view
         MENUITEMARRAY& menuitems            //!< Menu item array to append to
         ) { v_AppendPopupMenuItems(widget,point,menuitems); }
   #endif

      //! Assign layer to use specified object.
      ERRVALUE AssignObject (
         const RVC::OBJITEM& objitem,           //!< Object to assign
         MDLGPARENT dlgparent = 0               //!< Parent for verification/setting dialogs, NULL to not use such dialogs
         ) { return (v_AssignObject(objitem,dlgparent)); }

   #ifndef NO_DEPRECATED
      //! Assign layer to use specified object.
      //! \deprecated Use variant with RVC::OBJITEM.
      DEPRECATED ERRVALUE AssignObject (
         const FNAMEINODEUC *fnip
         );
   #endif

      //! Determine if layer is set to be editable via TNTserver.
      bool CanEditInTNTserver (
         ) const { return ((drawflags & LAYERDRAWFLAG_EditInTNTserver) != 0); }

      //! Determine if capable of retrieving element extents
      bool CanGetElemExtents (
         ) const { return (m_CanGetElemExtents); }

      //! Determine if can open control dialog for layer
      bool CanOpenControlPanel (
         ) const { return (!m_IsControlPanelDisabled); }

      //! Determine if capable of reporting raw element information
      bool CanReportRawElemInfo (
         ) const { return (m_CanReportRawElemInfo); }

      //! Determine if can show "details" (components).
      bool CanShowDetails (
         ) const { return (v_CanShowDetails()); }

      //! Determine if element can be tested if inside/outside region
      bool CanTestElementByRegion (
         ) const { return (m_CanTestElementByRegion); }

      //! Determine if layer can be viewed in 2D.
      bool CanViewIn2D (
         );

      //! Determine if layer can be viewed in 3D.
      bool CanViewIn3D (
         );

      //! Change position in list
      bool ChangeListPos (
         LAYER* reflayer,                    //!< Reference layer for LISTPOS_Before and LISTPOS_After
         GRE::LISTPOS listpos                   //!< New position in list
         );

      //! Check for high feature density/detail and let user set visibility options if exceeds threshold.
      ERRVALUE CheckDenseDetail (
         MDLGPARENT dlgparent                   //!< Parent for dialog