mdisp.h

Go to the documentation of this file.

/**
 * \file mdisp.h <mi32/mdisp.h>
 * \brief Include file for Mdisp library
 *
 * \if NODOC
 * $Id: mdisp.h_v 1.405 2004/10/01 17:19:19 mju Exp $
 *
 * $Log: mdisp.h_v $
 * Revision 1.405  2004/10/01 17:19:19  mju
 * Add dlgparent to assignObject.
 *
 * Revision 1.404  2004/09/03 22:50:40  dwilliss
 * *** empty log message ***
 *
 * Revision 1.403  2004/09/01 17:48:04  mju
 * Change regionGenerateFromTool to use trans2d_mapgen.
 *
 * Revision 1.402  2004/08/04 20:22:44  scowan
 * Removed unused include files.
 * More should be removed!!
 *
 * Revision 1.401  2004/07/22 22:17:08  dwilliss
 * Added label placement methods to pinmap layer
 *
 * Revision 1.400  2004/07/21 22:51:04  dwilliss
 * added some virtual methods to pinmap layer
 *
 * Revision 1.399  2004/07/20 13:09:16  mju
 * Remove region hdr.
 *
 * Revision 1.398  2004/07/15 20:14:14  dwilliss
 * Added a mdispdraw flag
 *
 * Revision 1.397  2004/07/12 23:14:30  mju
 * No georegion.
 *
 * Revision 1.396  2004/06/28 17:55:32  mju
 * Convert to spatref system.
 *
 * Revision 1.395  2004/06/16 21:54:45  scowan
 * Replaced script call using legacy cad element class with current class.
 *
 * Revision 1.394  2004/06/16 13:11:14  vdronov
 * delete Raycasing methods
 *
 * Revision 1.393  2004/06/15 14:37:28  vdronov
 * remove DenseTriangulation enum item
 *
 * Revision 1.392  2004/06/11 17:44:33  vdronov
 * removed RayCasting rendering mode
 *
 * Revision 1.391  2004/06/11 17:40:58  scowan
 * Added an evaluate method to gre script class.
 *
 * Revision 1.390  2004/06/04 20:50:31  scowan
 * Moved cad and sketch definitions to own include file.
 *
 * Revision 1.389  2004/04/30 14:05:31  mju
 * Remove unneeded hdr for mfc.
 *
 * Revision 1.388  2004/04/08 12:41:24  mju
 * Exclude previous change from non-X builds.
 *
 * Revision 1.387  2004/04/07 21:12:53  mju
 * Add toolhyperindexGetToolBarIconItems.
 *
 * Revision 1.386  2004/03/05 15:12:35  mju
 * Add virtual dtor for all classes with virtual functions.
 *
 * Revision 1.385  2004/03/04 18:57:47  mju
 * Move more common stuff to gre/base.h
 * Move raster layer to gre/lrraster.h
 *
 * Revision 1.384  2004/02/19 23:10:16  scowan
 * Added entry to pinmap layer.
 *
 * Revision 1.383  2004/02/18 21:16:33  mju
 * Add raster dispparm PreferredZoom1X member.
 *
 * Revision 1.382  2004/02/12 22:43:39  dwilliss
 * Deprecate old mgd
 *
 * Revision 1.381  2004/02/06 16:01:00  mju
 * Use GRE_FIND_FLAGS enum.
 *
 * Revision 1.380  2004/02/05 22:07:34  mju
 * Rework DataTip support to integrate with view/layer.
 *
 * Revision 1.379  2004/02/04 20:32:51  mju
 * Add datatipparms.setdefaultsuffix, remove legacy version.
 *
 * Revision 1.378  2003/12/12 17:09:50  vdronov
 * added RENDERING_MODE_PiecewiseTIN
 *
 * Revision 1.377  2003/11/26 20:06:04  mju
 * Add datatip fn to get menu.
 *
 * Revision 1.376  2003/11/20 13:26:45  mju
 * Add DesignScale to scriptcontext_draw.drawsyms.
 *
 * Revision 1.375  2003/11/04 20:56:48  mju
 * Fix prototype.
 *
 * Revision 1.374  2003/11/04 18:43:08  mju
 * Add MdispxdLayoutManager prototypes.
 *
 * Revision 1.373  2003/10/24 17:44:13  mju
 * Add autolabelparms members for scale control.
 *
 * Revision 1.372  2003/09/23 13:14:43  mju
 * In dispparm copy ctors explicitly init base class.
 *
 * Revision 1.371  2003/09/15 17:06:13  dwilliss
 * Fixed mismatched ifdef
 *
 * Revision 1.370  2003/09/15 13:49:56  fileserver!dwilliss
 * Doxygen
 *
 * Revision 1.369  2003/09/08 21:04:59  dwilliss
 * Added doxygen start/end tags for functions groups
 *
 * Revision 1.368  2003/08/26 16:11:12  vdronov
 * added RENDERING_MODE_VariableTriangulation
 *
 * Revision 1.367  2003/08/21 21:07:53  dwilliss
 * Added v_ComputeMargins method to script layer
 *
 * Revision 1.366  2003/08/19 21:38:42  dwilliss
 * Added a margin member to script layer's dispparm and add a parameter to
 * a private method.
 *
 * Revision 1.365  2003/07/30 16:04:06  mju
 * Ignore private sections.
 *
 * Revision 1.364  2003/06/24 17:52:49  dwilliss
 * Added some methods to SCRIPTCONTEXT_LABEL to let you get/set script variables
 *
 * Revision 1.363  2003/06/24 16:49:45  mju
 * Move most 3D stuff to own headers.
 *
 * Revision 1.362  2003/06/24 16:25:49  mju
 * Move VIEW and LAYER_VECTOR classes to own headers.
 *
 * Revision 1.361  2003/06/24 14:59:33  dwilliss
 * Started implementing frames around labels, but not ready yet.  Mike needs
 * to modify this file, so I just commented out my changes for now
 *
 * Revision 1.360  2003/06/17 13:39:19  mju
 * Add MFC_TREEVIEW decl.
 *
 * Revision 1.359  2003/06/16 20:07:05  mju
 * Move stuff to own headers.
 *
 * Revision 1.358  2003/06/16 16:04:06  mju
 * More viewscript stuff for attaching to viewable.
 *
 * Revision 1.357  2003/06/14 02:09:43  scowan
 * Changed some method prototypes to not use dregion.
 * Moved gre layer region to its own include file.
 *
 * Revision 1.356  2003/06/13 13:14:05  mju
 * Don't define scriptlists in viewable except for X.
 *
 * Revision 1.355  2003/06/12 21:47:52  mju
 * ViewScript redesign to allow attachment to viewable.
 *
 * Revision 1.354  2003/05/28 22:43:01  scowan
 * Moved dispparm validate virtual metho to private.
 *
 * Revision 1.353  2003/05/28 22:19:57  vdronov
 * added DenseRayCasting method
 *
 * Revision 1.352  2003/05/28 22:17:06  mju
 * Add viewscript FromViewable members.
 *
 * Revision 1.351  2003/05/28 16:38:19  scowan
 * Removed vector getobjfilter declaration, it has been replaced.
 *
 * Revision 1.350  2003/05/28 15:08:38  scowan
 * Changed some fields in type defn layer's sub class.
 *
 * Revision 1.349  2003/05/23 20:36:16  scowan
 * Changed prompt object parms.
 *
 * Revision 1.348  2003/05/21 22:13:25  dwilliss
 * Added an optional parameter to RenderToRaster
 *
 * Revision 1.347  2003/05/21 17:00:08  mju
 * Add ScalePosGetCoordString.
 *
 * Revision 1.346  2003/05/12 20:47:01  mju
 * Add tooltip handles to STATUSINFO.
 *
 * Revision 1.345  2003/05/12 17:45:23  mju
 * Remove TransPointToString fn as replaced by statusinfo.GetCoordString.
 *
 * Revision 1.344  2003/05/12 14:53:53  mju
 * Add view scaleposgetlatlonformat and getneedsredraw.
 *
 * Revision 1.343  2003/05/09 21:44:53  mju
 * MFC fixes.
 *
 * Revision 1.342  2003/05/09 21:33:53  mju
 * Fix MFC private member problem.
 *
 * Revision 1.341  2003/05/09 20:12:40  mju
 * Add dual position report.
 * Add view::SAVESETTINGS container.
 * Make most view members private.
 * Add view::create and createx methods.
 *
 * Revision 1.340  2003/05/01 21:49:33  scowan
 * Added shape enum type.
 *
 * Revision 1.338  2003/04/30 21:40:34  mju
 * Move HyperIndex stuff to gre/hypermgr hdr.
 *
 * Revision 1.337  2003/04/30 20:17:21  mju
 * Add fields for 'Macros' menubar entry.
 *
 * Revision 1.336  2003/04/30 14:58:59  mju
 * Make viewscript/macroscript classes non-nested in GRE namespace.
 * Add viewscript setting for showing icon.
 *
 * Revision 1.335  2003/04/28 19:32:03  mju
 * Add vector:;setupdrape3d.
 *
 * Revision 1.334  2003/04/28 15:29:15  mju
 * Add autolabelparms::checktable.
 *
 * Revision 1.333  2003/04/14 17:14:55  vdronov
 * added CheckTerrain method for surface layer
 *
 * Revision 1.332  2003/04/11 16:35:49  vdronov
 * added more rendering modes
 *
 * Revision 1.331  2003/04/10 16:47:10  vdronov
 * added MipMapSharpness to raster dispparm
 *
 * Revision 1.330  2003/04/08 20:32:26  scowan
 * Changed color map ionode to a color palette name.
 *
 * Revision 1.329  2003/04/02 19:33:25  vdronov
 * added RENDERING_MODE_None
 *
 * Revision 1.328  2003/04/01 18:38:44  mju
 * Make layer objmgrgetcontainer non-inline.
 *
 * Revision 1.326  2003/03/25 23:28:48  vdronov
 * multiple 3d changes
 *
 * Revision 1.325  2003/03/24 21:25:47  vdronov
 * added GetTerrain method for surface layer
 *
 * Revision 1.323  2003/03/24 19:13:00  vdronov
 * added texture filter and rendering mode
 *
 * Revision 1.322  2003/03/20 23:15:19  vdronov
 * new trans
 *
 * Revision 1.321  2003/03/04 17:42:09  mju
 * Add accessor methods for globaloptions.
 *
 * Revision 1.320  2003/03/04 16:58:00  mju
 * Add nested FORM classes to GLOBALOPTIONS.
 *
 * Revision 1.319  2003/02/14 21:59:10  mju
 * Add docs for all view::trans methods.
 *
 * Revision 1.318  2003/02/14 21:12:51  mju
 * Add validate methods for point/line/polyparms and related.
 *
 * Revision 1.317  2003/02/05 16:30:02  mju
 * Make group name private and define GRE_GROUP_NAMELEN and make longer.
 *
 * Revision 1.316  2003/02/03 15:31:38  mju
 * Add v_usestransparency for region.
 *
 * Revision 1.315  2003/01/30 22:36:47  mju
 * nc.
 *
 * Revision 1.314  2003/01/24 15:23:37  mju
 * Add raster m_TempObjItem so can return in v_GetObjItem.
 *
 * Revision 1.313  2003/01/22 23:14:30  dwilliss
 * Added methods to view to get/set wireframe drawing mode
 *
 * Revision 1.312  2003/01/14 23:27:30  dwilliss
 * Added a timerid to view to let us defer resize events
 * Added a static timer method to view.
 * Made view's CB_ViewResize a static method of the view so it could access
 *    private members
 *
 * Revision 1.311  2003/01/09 16:57:28  dwilliss
 * Added several methods to layouts to control the GroupControls dialog
 *
 * Revision 1.310  2002/12/16 15:05:59  mju
 * Move geolocksettings to own header.
 *
 * Revision 1.309  2002/12/11 15:20:05  mju
 * No more contrib w stuff.
 *
 * Revision 1.308  2002/12/10 15:16:33  scowan
 * Fixed some g++ warnings.
 *
 * Revision 1.307  2002/12/03 17:04:29  scowan
 * Added link to data source stuff.
 *
 * Revision 1.306  2002/11/07 17:32:30  mju
 * Add viewable::rendertoraster.
 *
 * Revision 1.305  2002/11/05 23:04:37  mju
 * Add Get/SetDesignScale for VIEWABLE, GROUP, LAYOUT.
 * Make group relscale private and add method to set.
 *
 * Revision 1.304  2002/11/05 19:03:21  mju
 * Add sketch v_serialGetTagName.
 *
 * Revision 1.303  2002/10/24 20:58:19  mju
 * Add geolocksettings.SerialGetItemDef.
 * Add viewflag_NoShowInLocator.
 *
 * Revision 1.302  2002/10/23 22:04:24  mju
 * Make highlightelementsbyregion virtual and add v_GetElemSetByExtent.
 *
 * Revision 1.301  2002/10/23 15:36:36  mju
 * Add serial read log for group instead of simple bool.
 * Add GetSerialReadLog for group/layout.
 *
 * Revision 1.300  2002/10/22 15:56:37  mju
 * Use geolocksettings in view.
 *
 * Revision 1.299  2002/10/22 13:35:02  mju
 * Change GEOLOCKSETTINGS class to have fewer modes and range for zoomscale.
 *
 * Revision 1.298  2002/10/16 14:58:43  mju
 * Make cad v_assignobject protected so can call from sketch.
 *
 * Revision 1.297  2002/09/30 20:53:38  scowan
 * Added new surface method.
 *
 * Revision 1.296  2002/09/27 14:00:05  mju
 * Fix GetObjItem as was always passing 0 for component to virtual.
 *
 * Revision 1.295  2002/09/23 17:19:27  mju
 * Add GRE_LAYER::FILTER and parm to group::GetExtentsInProj.
 *
 * Revision 1.294  2002/09/23 15:23:21  mju
 * Add vector::openprivateobject.
 *
 * Revision 1.293  2002/09/20 17:48:00  mju
 * Move text layer to own header.
 *
 * Revision 1.292  2002/09/20 17:37:01  mju
 * Move scalebar, legend, legend2 classes to own headers.
 *
 * Revision 1.291  2002/09/20 17:02:50  mju
 * Only declare v_ControlPanel if X or MFC.
 *
 * Revision 1.290  2002/09/19 22:06:43  mju
 * Forgot to make v_GetToolMenu virtual.
 *
 * Revision 1.289  2002/09/19 17:07:35  mju
 * Restructure to require use of GetObjItem() for layer and eliminate fhandle/ohandle for vector and TIN.
 *
 * Revision 1.288  2002/09/10 14:24:32  mju
 * Move mapgrid layer to own header.
 *
 * Revision 1.287  2002/09/09 21:01:44  mju
 * Removed deprecated getfile/objhandle methods.
 * Move TIN layer to gre/lrtin.h
 *
 * Revision 1.286  2002/09/06 22:07:19  mju
 * Minor TIN dispparm reorg.
 *
 * Revision 1.285  2002/09/06 20:42:44  mju
 * Add tin::dispparm::m_IsEditable and SetObject.
 *
 * Revision 1.284  2002/09/03 21:56:48  mju
 * Don't declare DlgGetClipSettings unless X or MFC.
 *
 * Revision 1.283  2002/08/29 21:11:52  mju
 * Add parm to layer::setflags for notify.
 *
 * Revision 1.282  2002/08/26 15:14:21  mju
 * Eliminate shadow warnings.
 *
 * Revision 1.281  2002/08/21 21:04:41  mju
 * Add DISPPARM::v_SetObjItem.
 *
 * Revision 1.280  2002/08/19 20:27:26  mju
 * Add raster ioparm SetCacheRect.
 *
 * Revision 1.279  2002/08/14 20:42:20  mju
 * Make view::getscaleposproj return group proj if not fixed.
 *
 * Revision 1.277  2002/08/13 20:55:04  mju
 * Include from mi32, not miwin.
 *
 * Revision 1.276  2002/08/12 13:25:01  mju
 * Add geolocksettings and related.
 *
 * Revision 1.275  2002/07/12 15:45:40  scowan
 * Added ctor for label style parms.
 *
 * Revision 1.274  2002/07/09 14:55:53  mju
 * Add group::getlast static method.
 *
 * Revision 1.273  2002/06/20 19:52:10  mju
 * Add ctor for gre_viewtrans3d.
 *
 * Revision 1.272  2002/06/05 14:27:24  mju
 * Change AppendPopupMenuItems to non-const.
 *
 * Revision 1.271  2002/05/24 21:46:15  mju
 * Add legend sampleflags.
 * Add vector label option for scale range.
 * Add vector label baseline style and flag to draw.
 *
 * Revision 1.270  2002/05/23 14:44:42  mju
 * Make SetClipRect not inline.
 *
 * Revision 1.269  2002/05/14 15:57:15  dwilliss
 * Had to add a rect for SampleRect member to point to, too.
 *
 * Revision 1.268  2002/05/14 15:26:42  dwilliss
 * Added a SampleRect member to GRE_SCRIPTCONTEXT_STYLE
 *
 * Revision 1.267  2002/05/13 22:50:34  dwilliss
 * UsesTransparency method now takes optional GC.
 *
 * Revision 1.264  2002/05/03 20:45:12  scowan
 * Removed commented save georef inode numbers.
 *
 * Revision 1.262  2002/04/30 23:03:12  dwilliss
 * Various changes needed for style samples from cartoscripts
 *
 * Revision 1.261  2002/04/26 22:42:48  scowan
 * Removed use of georef inode and replaced with georef name.
 *
 * Revision 1.260  2002/04/22 20:51:53  mju
 * Make layer::usestransparency virtual.
 *
 * Revision 1.259  2002/04/19 22:03:58  mju
 * Add layer::datatipsetdefaultprefix().
 *
 * Revision 1.258  2002/04/19 16:43:12  mju
 * Add GetActiveElem returning ELEMENT.
 *
 * Revision 1.257  2002/04/19 14:27:16  mju
 * Add STYLE object to sketch layer.
 *
 * Revision 1.256  2002/04/18 20:45:49  mju
 * Add SCRIPTCONTEXT classes.
 * Remove SMLCONTEXT* and Segments from dispparms.
 *
 * Revision 1.255  2002/04/12 14:14:31  scowan
 * Moved select mode and style mode to own include file.
 *
 * Revision 1.254  2002/04/11 22:06:43  mju
 * Legend redesigned to allow element table.
 *
 * Revision 1.253  2002/04/05 14:39:48  mju
 * Add const for SetTitle fn.
 *
 * Revision 1.252  2002/04/04 22:35:42  mju
 * Legend elem now uses table.
 *
 * Revision 1.251  2002/04/03 23:00:21  mju
 * Add parm to AppendPopupMenuItems.
 *
 * Revision 1.250  2002/04/02 23:07:23  mju
 * Add layer::AppendPopupMenuItems.
 * Move some nested layer class defns outside of layer so easier to read.
 *
 * Revision 1.249  2002/04/02 16:23:16  mju
 * Add system::Get/SetReturnSerialReadErr.
 *
 * Revision 1.248  2002/04/01 22:01:16  mju
 * Add Setup() methods for some legend types.
 *
 * Revision 1.247  2002/03/28 22:29:38  mju
 * Add UpdateMessage using TEXTID.
 * Change SCALEBAR dispparm to to use MISTRING for label.
 *
 * Revision 1.246  2002/03/28 17:28:28  mju
 * Remove UpdateMessageF.
 *
 * Revision 1.245  2002/03/27 22:54:41  dwilliss
 * Added some bools to allow controling of interior/exterior toggles
 *
 * Revision 1.244  2002/03/27 22:46:46  dwilliss
 * Polygon Legend Items can now have labels inside the sample
 *
 * Revision 1.242  2002/03/26 21:17:41  dwilliss
 * Oops.  Now that LAYERREF.name isn't an MISTRING, we can't just use a
 * copy constructor on it.
 *
 * Revision 1.241  2002/03/26 21:11:15  dwilliss
 * Changed legend2 layreref to have fixed size string instead of MISTRING.
 * We malloc an array of these and no constructors get called.
 *
 * Revision 1.240  2002/03/22 16:40:05  mju
 * Use RVC::OBJECTNAME for all table/field names.
 *
 * Revision 1.238  2002/03/05 16:10:16  mju
 * Add raster::dispparm::serializercb_colorpalette.
 *
 * Revision 1.237  2002/02/26 17:26:14  dwilliss
 * Needed to add a parameter to one of LEGNED2's private methods
 *
 * Revision 1.236  2002/02/26 16:50:34  dwilliss
 * Added Layer ID member to GRE_LAYER_LEGEND2::LAYERREF
 *
 * Revision 1.235  2002/02/25 21:47:37  mju
 * Add LayerID stuff.
 *
 * Revision 1.234  2002/02/19 23:00:27  mju
 * Add TableName to SELECT/STYLEPARMS.
 *
 * Revision 1.233  2002/02/15 21:23:16  scowan
 * Added version to get draw and hightlight set that use a bitset unowned.
 *
 * Revision 1.232  2002/02/14 22:52:20  mju
 * Eliminate unimplemented SELECTMODE_bytheme and rename ByKeyAttrib as ByAttribute.
 *
 * Revision 1.231  2002/02/08 23:02:51  scowan
 * More cleanup of vector drawing methods.
 *
 * Revision 1.230  2002/02/06 23:46:02  scowan
 * Removed Draw....() methods from the dispparms, not being used!
 * Moved vector drawing methods to internal class.
 *
 * Revision 1.229  2002/01/28 21:35:07  scowan
 * Added parameters to the vector label drawing methods.
 *
 * Revision 1.228  2002/01/23 22:34:01  scowan
 * Added default parameters to draw label.
 *
 * Revision 1.227  2002/01/09 15:05:49  mju
 * Add layer;:SetName using objitem.
 *
 * Revision 1.226  2002/01/04 18:22:18  mju
 * Add VIEWFLAG_NoFillBackground.
 * Change RASTER::SetColorMap to use simple-array.
 *
 * Revision 1.225  2002/01/02 17:14:03  mju
 * Add AssignObject overrides using OBJITEM for all appropriate layers.
 *
 * Revision 1.223  2001/12/31 17:31:36  mju
 * Fix to compile for win32-native.
 *
 * Revision 1.222  2001/12/28 22:33:49  mju
 * Add LAYER::SetToolMenuItem() method.
 *
 * Revision 1.221  2001/12/28 21:34:21  mju
 * Make all LAYER members protected/private.
 * Retire all previously deprecated functions/typedefs.
 *
 * Revision 1.220  2001/11/21 17:18:15  mju
 * Add vector::drawraised... methods.
 *
 * Revision 1.219  2001/11/15 16:13:31  mju
 * Make group::setcliprect non-inline and add 'notify' parm.
 *
 * Revision 1.218  2001/11/14 16:46:31  mju
 * Add SerialRead override for pinmap.
 *
 * Revision 1.217  2001/11/05 16:55:27  mju
 * MFC_VIEW::DlgEditPref stuff.
 *
 * Revision 1.216  2001/11/05 15:15:20  mju
 * Add AutoRedrawDelay to view GLOBALOPTIONS.
 *
 * Revision 1.215  2001/10/31 18:46:51  mju
 * Use COLOR ColorRef methods to get/set.
 *
 * Revision 1.214  2001/10/29 17:28:51  mju
 * Add TREEVIEW::GetDlgParent().
 *
 * Revision 1.213  2001/10/25 15:13:57  mju
 * Simplify MFC TreeView popup menus to not need command routing mechanism.
 *
 * Revision 1.212  2001/10/23 16:04:32  vdronov
 * Changed argument's list for WireReadVector
 *
 * Revision 1.211  2001/10/22 23:58:18  vdronov
 * removed Selected from wireframes structures,
 * added Init field
 *
 * Revision 1.210  2001/10/22 20:31:18  mju
 * Make UpdateMessage() and related 'const' again.
 *
 * Revision 1.209  2001/10/22 20:18:40  mju
 * Add StatusBar support for MFC.
 *
 * Revision 1.208  2001/10/22 17:17:29  vdronov
 * added WireReadD3Poly and WireReadD3Point as private methods
 * of GRE_LAYER_VECTOR
 *
 * Revision 1.207  2001/10/19 20:48:00  vdronov
 * added Selected bit array to MDISPWIREFRAME
 *
 * Revision 1.206  2001/10/19 16:16:45  mju
 * Add MFC_VIEW::PopupScaleMenu.
 *
 * Revision 1.205  2001/10/18 20:07:02  mju
 * Rework MFC TreeView popup menus for layers and add for components.
 *
 * Revision 1.204  2001/10/16 16:58:14  mju
 * Consolidate COMPINFO form/dialog destruction into Destroy() method.
 *
 * Revision 1.203  2001/10/15 14:26:46  mju
 * Retire MdispLayerMgr functions as no longer used.
 *
 * Revision 1.202  2001/10/09 21:50:21  mju
 * Add MFC_VIEW::OnUpdateIndicatorScale().
 *
 * Revision 1.198  2001/10/01 21:16:03  dwilliss
 * Added a matte to the layout
 *
 * Revision 1.197  2001/09/21 21:09:52  mju
 * Change GetDbEdit() to non-const so can create DbEdit if necessary.
 *
 * Revision 1.196  2001/09/19 21:22:55  dwilliss
 * Added OnPrint() method to GRE_MFC_VIEW
 *
 * Revision 1.195  2001/09/14 16:25:27  mju
 * Don't define subclass promptobject for win32native.
 *
 * Revision 1.194  2001/09/13 15:15:44  dwilliss
 * Added a method to return a reference to the group's MATTE
 *
 * Revision 1.193  2001/09/12 22:59:17  dwilliss
 * Added a MATTE member to GRE_GROUP.
 *
 * Revision 1.192  2001/09/11 20:29:29  mju
 * Mark obsolete members for deletion.
 *
 * Revision 1.191  2001/09/11 16:06:21  mju
 * Don't include addl sketch stuff for WIN32-native only.
 *
 * Revision 1.190  2001/09/10 16:16:57  mju
 * Add colorscale::item::ValueToPosition method.
 * Add layer::DbListIsIndexElemNum.
 *
 * Revision 1.189  2001/09/07 21:50:52  mju
 * Add sketch layer methods for use by geotoolbox.
 * Add layer methods to convert between dblist index and element number.
 *
 * Revision 1.188  2001/09/06 15:38:12  mju
 * Add layer::GetStyleObjItem()
 * Add sketch::SetupStyleObject().
 *
 * Revision 1.187  2001/08/22 17:03:25  mju
 * Add dispparm::setmayusetransparency.
 *
 * Revision 1.186  2001/08/17 21:46:03  mju
 * Use MGUI namespace for MFC classes.
 *
 * Revision 1.185  2001/08/14 19:06:41  mju
 * In ShowSelectedRecords don't set in DBEDIT unless from selection or have highlightd.
 *
 * Revision 1.184  2001/08/14 17:05:00  mju
 * TreeView methods only implemented if WIN32_MFC.
 *
 * Revision 1.183  2001/08/14 15:37:25  mju
 * Merge MFC version as was inclusion order dependent.
 *
 * Revision 1.182  2001/08/13 20:56:43  mju
 * Add TreeView members to COMPINFO and TABLEINFO.
 *
 * Revision 1.181  2001/08/06 17:19:37  mju
 * Add layer::HasNullCells.
 *
 * Revision 1.180  2001/08/03 17:03:00  mju
 * Remove COMPINFO methods not wanted for non-X/MFC.
 *
 * Revision 1.179  2001/08/02 21:48:56  mju
 * Redesign object/layer manager to integrate with GRE classes.
 *
 * Revision 1.178  2001/07/25 15:00:04  mju
 * Add layer::seteditintntserver.
 *
 * Revision 1.177  2001/07/24 17:23:19  mju
 * GPS name changes.
 *
 * Revision 1.176  2001/07/12 17:35:10  dwilliss
 * Text layer encoding is now an MISTRING
 *
 * Revision 1.174  2001/07/05 21:32:47  dwilliss
 * Text layers now store text in an MISTRING.  Old char* still hangs around
 * but only temporarly during serial read to read old non-unicode layouts
 *
 * Revision 1.173  2001/06/19 22:02:58  mju
 * Add layer::GetObjItem().
 *
 * Revision 1.172  2001/06/19 19:06:37  mju
 * Add layer::CanEditInTNTserver().
 *
 * Revision 1.171  2001/06/18 17:40:17  mju
 * Add datatip showmode for AllVisible.
 *
 * Revision 1.170  2001/06/08 15:18:15  mju
 * Add dispparm::UpdateSaveInfo for raster, vector, cad, tin.
 *
 * Revision 1.169  2001/06/07 17:28:52  mju
 * Make layer::savedispparmsubobject public again.
 *
 * Revision 1.168  2001/06/07 16:09:02  mju
 * Make serialization of layers/dispparms simpler and more consistent.
 * DISPPARM now inherits from SERIALIZABLE.
 * Add LAYERDRAWFLAG_EditInTNTserver.
 *
 * Revision 1.167  2001/05/21 17:30:37  mju
 * Add CreateLink method.
 *
 * Revision 1.166  2001/05/09 20:59:53  mju
 * Add GetVisibleScaleRange method for LAYER.
 *
 * Revision 1.165  2001/04/17 19:41:34  vdronov
 * added more sml methods for VIEWPOINT3D
 *
 * Revision 1.164  2001/04/11 20:15:42  vdronov
 * added DBCallbacks for extruded polygons and points
 *
 * Revision 1.163  2001/04/05 16:32:01  mju
 * Add pvt vector layer methods for dealing with zscale.
 *
 * Revision 1.162  2001/04/04 14:12:52  mju
 * Add view::AutoResizeDialog.
 *
 * Revision 1.161  2001/03/15 15:25:26  mju
 * Add view::ClearPreviousViewList().
 *
 * Revision 1.160  2001/03/08 17:01:11  vdronov
 * completed implementation of raised points.
 *
 * Revision 1.158  2001/03/08 14:17:47  mju
 * Add view::setscaleposunits().
 *
 * Revision 1.157  2001/03/05 18:12:17  mju
 * Add view::GetBackgroundColorIniName.
 *
 * Revision 1.156  2001/03/01 22:58:46  mju
 * Add view method to zoom any raster layer to 1X.
 *
 * Revision 1.155  2001/03/01 14:58:21  vdronov
 * added D3POINTPARMS, changed D3PARMS to D3POLYPARMS
 *
 * Revision 1.154  2001/03/01 14:52:12  mju
 * Add view::getscale which returns scale.
 *
 * Revision 1.153  2001/02/28 22:52:37  mju
 * Add 'mode' to view::HighlightElementsByPoint.
 *
 * Revision 1.152  2001/02/27 18:39:20  mju
 * Add highlighting methods for view/group.
 * Add TreeCtrl stuff for region layer.
 *
 * Revision 1.151  2001/02/23 21:35:30  mju
 * Add LAYER::TYPEDEFN::FLAG_NonRotatable.
 *
 * Revision 1.150  2001/02/23 14:30:48  dwilliss
 * Added places setting for scale legend
 *
 * Revision 1.149  2001/02/22 21:11:07  vdronov
 * added useColorStack to D3PARMS struct.
 *
 * Revision 1.148  2001/02/22 21:01:11  mju
 * Add ELEMSAMPLE_DC ctor that doesn't use gc.
 *
 * Revision 1.147  2001/02/21 23:00:02  mju
 * Add style file/object path/inode to ELEMSAMPLE_DC.
 * Add TreeView legend stuff.
 *
 * Revision 1.146  2001/02/21 16:24:55  vdronov
 * added MinElevation and MaxElevation to MDISPWIREFRAME.RaisedPoly.
 *
 * Revision 1.145  2001/02/16 16:29:17  mju
 * Add raster::SetShadeAngles.
 *
 * Revision 1.144  2001/02/15 17:31:26  vdronov
 * added POLYPARMS struct to D#PARMS struct.
 *
 * Revision 1.143  2001/02/15 17:28:26  mju
 * Add TreeView stuff for vector, cad, tin, raster layers.
 *
 * Revision 1.142  2001/02/13 18:06:11  mju
 * Add view::TransPointToString.
 *
 * Revision 1.141  2001/02/12 22:09:13  mju
 * Add layer::is/setcomponentselectable.
 *
 * Revision 1.140  2001/02/12 17:22:39  vdronov
 * ADDED sun location
 *
 * Revision 1.139  2001/02/12 17:01:29  mju
 * Add virtual methods for TreeView support for WIN32_NATIVE & WIN32_MFC.
 *
 * Revision 1.138  2001/02/09 00:20:41  vdronov
 * added _mdisp3dFillFlatPolygon
 *
 * Revision 1.137  2001/02/07 23:45:33  dwilliss
 * Added more legend settings to raster layers
 *
 * Revision 1.136  2001/02/01 23:30:52  vdronov
 * added RaisedPoly struct to MDISPWIREWRAME
 *
 * Revision 1.135  2001/01/31 20:54:12  vdronov
 * move enums inside structure d3parms
 *
 * Revision 1.134  2001/01/31 19:59:28  vdronov
 * added D3PARMS structure to VECTOR dispparm
 *
 * Revision 1.133  2001/01/25 22:56:53  mju
 * Add MDISPDRAW_NoCheckVisible and gre_layerdc.m_CheckVisible.
 *
 * Revision 1.131  2001/01/23 16:43:03  mju
 * Make some GRE_SYSTEM members non-static.
 *
 * Revision 1.130  2001/01/23 14:41:07  mju
 * Add margin settings for view.
 *
 * Revision 1.129  2001/01/23 14:23:02  mju
 * win32 don't have inlines for X-specific system stuff.
 *
 * Revision 1.128  2001/01/22 22:02:23  mju
 * Rework GRE_SYSTEM init/stop stuff.
 * Define GRE_CALLBACK_MSG_EXTRACTED and remove system kludge for same.
 *
 * Revision 1.127  2001/01/22 15:35:24  mju
 * Add raster::dispparm::ioparm::onserialread/write.
 *
 * Revision 1.126  2001/01/19 22:58:41  mju
 * Add stuff for "saved" file/object for use in sdedit.
 *
 * Revision 1.125  2001/01/12 18:34:42  mju
 * Fix SetScaleOneToOne to set NeedsRedraw.
 *
 * Revision 1.124  2001/01/04 21:14:53  mju
 * Add surflayer.getpointsz using TRANS2D_MAPGEN.
 *
 * Revision 1.123  2001/01/03 22:30:50  mju
 * Use cast in MdispLayerGetType to avoid warning.
 *
 * Revision 1.122  2001/01/02 18:28:24  mju
 * Use const in MdispSelectFromPoint.
 *
 * Revision 1.121  2000/12/27 22:43:08  mju
 * Add pinmap SymbolOffsetX/Y.
 *
 * Revision 1.120  2000/12/21 17:05:25  mju
 * Add raster color scale range support.
 *
 * Revision 1.119  2000/12/06 16:27:02  scowan
 * Fixed conversion warning.
 *
 * Revision 1.118  2000/12/05 23:09:32  mju
 * Add group::MutualExclusiveGroupSet stuff.
 *
 * Revision 1.117  2000/12/01 18:38:29  mju
 * Make ElemSet const in DrawLayerElements.
 *
 * Revision 1.116  2000/11/29 23:03:57  mju
 * Add "mutually exclusive layers" stuff.
 *
 * Revision 1.115  2000/11/29 17:33:14  mju
 * Add raster::dispparm:;ioparm::serializercb.
 *
 * Revision 1.114  2000/11/16 18:48:06  mju
 * Add StatusInfo field for MGRS string.
 *
 * Revision 1.113  2000/11/13 15:00:44  mju
 * Change formula layer to use geoformula class.
 *
 * Revision 1.112  2000/11/01 14:55:53  mju
 * Add option to view;;addtoolicons to control whether scripts added or not.
 *
 * Revision 1.111  2000/10/20 21:26:54  mju
 * Add view::getdrawingareaform().
 *
 * Revision 1.110  2000/10/19 14:25:40  mju
 * Add layer;:datatipgetstring.
 *
 * Revision 1.109  2000/10/17 21:41:09  mju
 * Rename old MDISP constants as GRE constants.
 *
 * Revision 1.108  2000/10/17 21:18:10  mju
 * Add layer::findelementsbyqueryext.
 *
 * Revision 1.107  2000/10/17 16:35:28  mju
 * Rename group clipregion member to force to access through methods.
 * Add group::getcliptrans.
 *
 * Revision 1.106  2000/10/13 15:58:47  dwilliss
 * Must use "friend class NAME", not "friend NAME"
 *
 * Revision 1.105  2000/10/09 21:10:06  mju
 * Add group::ClipToAutoMatched stuff.
 *
 * Revision 1.104  2000/10/05 16:57:33  mju
 * Add layer::GetElemSetExtents.
 *
 * Revision 1.103  2000/09/22 14:43:42  mju
 * Fix typo.
 *
 * Revision 1.102  2000/09/22 14:23:45  mju
 * Change ToolScript to take VIEWSCRIPT& in ctor.
 * Do SetScriptFilename() before parse viewscript.
 *
 * Revision 1.101  2000/09/20 17:48:28  mju
 * Add group::geocatdlg fns.
 *
 * Revision 1.100  2000/09/13 17:09:26  mju
 * Add view::stopdrawonerror stuff.
 *
 * Revision 1.99  2000/09/08 20:51:31  mju
 * Add tool::setname().
 *
 * Revision 1.98  2000/09/08 20:34:51  mju
 * Add gre_tool::m_toolnamestr so can have unicode names.
 *
 * Revision 1.97  2000/09/01 14:49:19  dwilliss
 * Gave old LEGENDs a SampleOffset
 *
 * Revision 1.96  2000/08/31 22:06:04  mju
 * Add DISPFLAG_MayUseTransparency.
 *
 * Revision 1.95  2000/08/22 22:17:13  dwilliss
 * Added GRE_LAYER_LEGEND2
 *
 * Revision 1.94  2000/08/17 22:11:48  mju
 * Add view::m_lvswform.
 *
 * Revision 1.93  2000/08/16 17:35:07  mju
 * Add GetIcon, GetComponentName, GetComponentIcon virtual methods.
 *
 * Revision 1.92  2000/08/15 21:15:08  mju
 * Add vector::setup3d() private method.
 *
 * Revision 1.91  2000/08/15 20:49:38  dwilliss
 * Prototypes for MdispLayerSelect()
 * Define layer TYPE_Legend2
 *
 * Revision 1.90  2000/08/14 17:08:05  mju
 * Make tool_sml::callfunction noninline.
 *
 * Revision 1.88  2000/08/11 20:19:52  mju
 * Redesign viewscript stuff so works with toolscript.
 * Move GRE_TOOL_SML here as need public interface.
 *
 * Revision 1.86  2000/08/09 22:05:23  mju
 * Use MILIST for view tools.
 * Change GetMenu/IconItem methods to use SIMPLE_ARRAY.
 *
 * Revision 1.85  2000/08/08 16:49:27  mju
 * Add GRE_LEGEND::DRAWCONTEXT::SetDrawLabels().
 *
 * Revision 1.84  2000/08/04 17:53:11  mju
 * Remove raster::m_LegendValid member as is in layer.
 *
 * Revision 1.82  2000/07/31 20:11:16  mju
 * Add raster::getcolorsamplelegend.
 *
 * Revision 1.81  2000/07/28 21:46:01  mju
 * Legend redesign.
 *
 * Revision 1.80  2000/07/26 21:40:07  mju
 * Add initial GRE_LEGEND defns.
 * Make layer;ReportRawElemInfo use MISTRING&.
 *
 * Revision 1.79  2000/07/24 21:03:42  mju
 * Add layer;:constructfromgeocat.
 *
 * Revision 1.78  2000/07/11 16:09:33  mju
 * Add parm to view::updategrouplegend.
 *
 * Revision 1.77  2000/07/07 17:11:25  mju
 * Mark view::ViewWireframe for deletion.
 *
 * Revision 1.1  1997/05/23  21:06:34  mju
 * Initial revision
 * \endif
**/

#ifndef INC_MI32_MDISP_H
#define INC_MI32_MDISP_H

#if !defined(INC_MI32_STDAFX_H) && defined(WIN32_MFC)
#include <mi32/stdafx.h>
#endif

#ifdef WIN32_MFC
   #include <mgui/oxttctrl.h>
   #include <mgui/sizingcb.h>
#endif

#ifndef  INC_MI32_RVCDEFNS_H
   #include <mi32/rvcdefns.h>
#endif

#ifndef  INC_MI32_RVCRAST_H
   #include <mi32/rvcrast.h>
#endif

#ifndef  INC_MI32_RVCDBASE_H
   #include <mi32/rvcdbase.h>
#endif

#ifndef  INC_MI32_RVCLEGND_H
   #include <mi32/rvclegnd.h>
#endif

#ifndef INC_MI32_MGUI_H
   #include <mi32/mgui.h>
#endif

#ifndef  INC_MI32_MATTE_H
   #include <mi32/matte.h>
#endif

#ifndef  INC_MI32_CONTPARM_H
   #include <mi32/contparm.h>
#endif

#ifndef INC_MI32_TRANSGEN_H
   #include <mi32/transgen.h>
#endif

#ifndef INC_MI32_GEOFRMLA_H
   #include <mi32/geofrmla.h>
#endif

#ifndef INC_MI32_MGD2_H
   #include <mi32/mgd2.h>
#endif

#ifndef INC_MI32_DRAWGEN_H
   #include <mi32/drawgen.h>
#endif

#ifndef INC_MI32_CONTRAST_H
   #include <mi32/contrast.h>
#endif

#ifndef INC_MI32_COLORBAL_H
   #include <mi32/colorbal.h>    //! for defn of CBPARMS
#endif

#ifndef INC_MI32_COLRCONV_H
   #include <mi32/colrconv.h>
#endif

#ifndef INC_MI32_TRANS2D_H
   #include <mi32/trans2d.h>
#endif

#ifndef INC_MI32_TRANS3D_H
   #include <mi32/trans3d.h>
#endif

#if !defined(INC_MI32_MXTOOLS_H) && defined(X_NATIVE)
   #include <mi32/mxtools.h>
#endif

#ifndef INC_MI32_GRTREE_H
   #include <mi32/grtree.h>
#endif

#ifndef INC_MI32_UCSTRING_H
   #include <mi32/ucstring.h>
#endif

#ifndef INC_STRING_H
   #include <string.h>
   #define INC_STRING_H
#endif

#ifndef INC_MI32_SERIALIZ_H
   #include <mi32/serializ.h>
#endif

#ifndef INC_MI32_SML_H
   #include <mi32/sml.h>
#endif

#ifndef INC_MI32_MPLAYOUT_H
   #include <mi32/mplayout.h>
#endif

#ifndef  INC_MI32_LATLONFM_H
   #include <mi32/latlonfm.h>
#endif

#ifndef  INC_MI32_GRLAYOUT_H
   #include <mi32/grlayout.h>
#endif

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

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

#ifndef  INC_RVC_DBTABLE_H
   #include <rvc/dbtable.h>
#endif

#ifndef  INC_RVC_CAD_H
   #include <rvc/cad.h>
#endif

#ifndef  INC_GRE_BASE_H
   #include <gre/base.h>
#endif

#ifndef  INC_MI32_SIMPLEAR_H
   #include <mi32/simplear.h>
#endif

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

#ifndef  INC_GRE_VIEWSCRIPT_H
   #include <gre/viewscript.h>
#endif

#ifndef  INC_GRE_SYSTEM_H
   #include <gre/system.h>
#endif

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

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

#ifndef  INC_GRE_GROUP_H
   #include <gre/group.h>
#endif

#ifndef  INC_GRE_LAYOUT_H
   #include <gre/layout.h>
#endif

#ifndef  INC_GRE_VIEW_H
   #include <gre/view.h>
#endif

#ifndef  INC_GRE_GEOLOCK_H
   #include <gre/geolock.h>
#endif

#ifndef  INC_GRE_3DSCENE_H
   #include <gre/3dscene.h>
#endif

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

#ifndef  INC_GRE_VIEWPOINT3D_H
   #include <gre/viewpoint3d.h>
#endif

/*----------------------------------------------------------------------------*/

#ifndef GENERATING_DOXYGEN_OUTPUT

//! Forward class/structure definitions
class BITSET_UNOWNED;
struct POINTPARMS;
struct LINEPARMS;
struct POLYPARMS;
class GEOCAT_DIALOG;
class QUADTREE;

namespace MGPS {
   class SOURCE;
   }

namespace RVC {
   class GEOMETRIC;
   class VECTOR;
   class TIN;
   class CAD;
   class GETOBJFILTER;
   }

#ifdef WIN32_MFC
class CRect;
#endif

#endif // GENERATING_DOXYGEN_OUTPUT

/*----------------------------------------------------------------------------*/
/*    Flags used in various Mdisp... functions                                */
/*----------------------------------------------------------------------------*/

#define  MDISP_View3dNoViewPointIcon   0x0001   //!< Don't include "viewpoint" icon on toolbar in 3D view
#define  MDISP_View3dNoStereoIcon      0x0002   //!< Don't include "stereo" icon on toolbar in 3D view

#define  MDISP_LocatorDftOpen       0x00000001  //!< Default to having locator open
#define  MDISP_LocatorViewParent    0x00000002  //!< Use reference view as parent to locator window

#define  MDISPEXTENTS_LayoutCoords  0x0001      //!< Return extents in layout coordinates
#define  MDISPEXTENTS_ViewCoords    0x0002      //!< Return extents in "view" coordinates

         //! Flags for MdispGroupControlPanelOpen()
#define  MDISP_GCP_OrientOnly    0x00000001     //!< Only put "orientation" controls on dialog

         //! Flags for Mdisp...Draw... and MdispLayerHighlight...
#define  MDISPDRAW_Unselected          0x00000001  //!< Draw only "unselected" elements
#define  MDISPDRAW_Selected            0x00000002  //!< Draw only "selected" elements
#define  MDISPDRAW_NoLabels            0x00000004  //!< Don't draw label elements
#define  MDISPDRAW_LabelsOnly          0x00000008  //!< Only draw label elements
#define  MDISPDRAW_AllBackground       0x00000010  //!< Draw everything in background pixel
#define  MDISPDRAW_ForceDraw           0x00000020  //!< Force all specified elements to draw even if not "selected"
#define  MDISPDRAW_UpdateSearchTree    0x00000040  //!< Update search tree when drawing even if in tree already
#define  MDISPDRAW_UpdateScreen        0x00000080  //!< Refresh screen after drawing
#define  MDISPDRAW_IfNeeded            0x00000100  //!< Only draw if needed
#define  MDISPDRAW_NoLocator           0x00000200  //!< Don't draw locator views
#define  MDISPDRAW_OnlyLocator         0x00000400  //!< Only draw locator views
#define  MDISPDRAW_DirectScreen        0x00000800  //!< Draw directly to screen, bypassing pixmap/memory
#define  MDISPDRAW_AllNonLocViews      0x00001000  //!< Draw all non-locator views
#define  MDISPDRAW_SelectChanged       0x00002000  //!< Draw elements changed by HighlightElement...
#define  MDISPDRAW_NoMessage           0x00004000  //!< Don't display messages while drawing
#define  MDISPDRAW_Wireframe           0x00008000  //!< Only draw wireframes
#define  MDISPDRAW_NoResumeTool        0x00010000  //!< Don't "resume" tool after drawing view
#define  MDISPDRAW_DirectPixmap        0x00020000  //!< Draw directly to pixmap, bypassing Mem24
#define  MDISPDRAW_NoBlankScreen       0x00040000  //!< Don't "blank" screen when start drawing view
#define  MDISPDRAW_IfAutoUpdate        0x00080000  //!< Draw if auto-update option on and if needed
#define  MDISPDRAW_SetDrawnBit         0x00100000  //!< Set bit in DrawnSet if element drawn
#define  MDISPDRAW_MemAndPixmap        0x00200000  //!< Draw both to Mem24 and Pixmap
#define  MDISPDRAW_NoCallbacks         0x00400000  //!< Don't invoke callback lists while drawing
#define  MDISPDRAW_CheckDrawnSet       0x00800000  //!< Check "drawn" set for highlighting (by region)
#define  MDISPDRAW_ReduceSpeckle3D     0x01000000  //!< Perform 3D background speckle reduction
#define  MDISPDRAW_NoScanColorUse      0x02000000  //!< Don't scan for color usage
#define  MDISPDRAW_UseHighlightColor   0x04000000  //!< Draw elements in "highlight" color
#define  MDISPDRAW_UseActiveColor      0x08000000  //!< Draw element in "active" color
#define  MDISPDRAW_NoCheckVisible      0x10000000  //!< Don't check visiblity of layer/group in view
#define  MDISPDRAW_LabelPlacementPass  0x20000000  //!< Internal use: 2nd pass to render just labels

         //! Flags for MdispSelect... functions
#define  MDISPSELECT_ViewCoords           0x0000   //!< Point(s) in "view" coordinates
#define  MDISPSELECT_DisplayCoords        0x0001   //!< Point(s) in "display" coordinates
#define  MDISPSELECT_AutoOpenDefaultLayer 0x0002   //!< Automatically make "default" layer elements selectable
#define  MDISPSELECT_AutoOpenActiveLayer  0x0004   //!< Automatically make "active" layer elements selectable
#define  MDISPSELECT_AutoOpenTable        0x0008   //!< Automatically open table(s) for selectable element types

#define  MDISPELEMSELECT_NotSet     0     //!< Not set, use parent's selection mode
#define  MDISPELEMSELECT_Replace    1     //!< Replace selected set with elements provided
#define  MDISPELEMSELECT_Add        2     //!< Add elements provided to selected set
#define  MDISPELEMSELECT_Subtract   3     //!< Subtract elements from selected set
#define  MDISPELEMSELECT_Toggle     4     //!< Toggle selection status of elements
#define  MDISPELEMSELECT_Last       4

#define  MDISPELEMACTIVE_First         0x0001
#define  MDISPELEMACTIVE_Previous      0x0002
#define  MDISPELEMACTIVE_Next          0x0004
#define  MDISPELEMACTIVE_Last          0x0008
#define  MDISPELEMACTIVE_KeepCurrent   0x0010   //!< Keep current active element if highlighted
#define  MDISPELEMACTIVE_NoWrap        0x0020   //!< Don't wrap around end/beginning if reached

#define  MDISPTOOLGENERIC_NoSetTrans      0x0001   //!< Don't set tool-view transformation
#define  MDISPTOOLGENERIC_SetTransToGroup 0x0002   //!< Set transformation to be from tool<-->group

#define  MDISPGROUPGETEXT_IgnoreMargins   0x00000001  //!< Ignore margins when computing group extents


//! Macros for definition of sml functions and class members.
#define SMLMEMBER_LAYERDISPFLAG(name,invert,flag,desc) {name, STYPE_Num, GRE_LAYER::SMLGET_LayerDispFlag, GRE_LAYER::SMLSET_LayerDispFlag, 0, 0, invert, flag, 0,0,0,0, desc}


//===================================================================================================================
//!      Constants used in Mdisp... functions

#define  GRE_WorldRange    1000000        //!< Range of "world" coordinates
#define  GRE_WorldRangeFP  1000000.0      //!< Range in floating-point



#define  MDISPVISIBLE_AllViews         0xFFFFFFFF
#define  MDISPVISIBLE_Locator          0x00000001
#define  MDISPVISIBLE_Hardcopy         0x80000000

#define  LEGENDVIEW_SHOW_NotSet  0
#define  LEGENDVIEW_SHOW_None    1
#define  LEGENDVIEW_SHOW_Left    2
#define  LEGENDVIEW_SHOW_Right   3

#define  LEGENDVIEW_VISIND_Checkbox 0
#define  LEGENDVIEW_VISIND_Glasses  1


#define  ROTBASE_Projection      0
#define  ROTBASE_North           1

#define  ATTACHMENT_None         0
#define  ATTACHMENT_Left         1
#define  ATTACHMENT_Bottom       1
#define  ATTACHMENT_Center       2
#define  ATTACHMENT_Right        3
#define  ATTACHMENT_Top          3
#define  ATTACHMENT_Geographic   4

#define  ATTACHREF_None          0
#define  ATTACHREF_Group         1
#define  ATTACHREF_Page          2
#define  ATTACHREF_Margin        3

#define  OFFSETTYPE_AtScale      0
#define  OFFSETTYPE_AtOutput     1        //!< Group positioning offsets are in absolute values for hardcopy output

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


#define  LABELPOSN_Default             0

#define  LABELPOSN_PointAboveLeft      1
#define  LABELPOSN_PointAboveCenter    2
#define  LABELPOSN_PointAboveRight     3
#define  LABELPOSN_PointCenterLeft     4
#define  LABELPOSN_PointCenter         5
#define  LABELPOSN_PointCenterRight    6
#define  LABELPOSN_PointBelowLeft      7
#define  LABELPOSN_PointBelowCenter    8
#define  LABELPOSN_PointBelowRight     9

#define  AUTOLABELOPTM_None            0x00
#define  AUTOLABELOPTM_Fast            0x01
#define  AUTOLABELOPTM_Full            0x02
#define  AUTOLABELOPTM_HideOverlap     0x04

#define  AUTOLABELPRIORITY_AllSame     0
#define  AUTOLABELPRIORITY_ByField     1
#define  AUTOLABELPRIORITY_ByScript    2


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

#ifndef GENERATING_DOXYGEN_OUTPUT
#ifdef WIN32_MFC

class GRE_MFC_STATUSBAR : public CStatusBar {
   public:

      //! Constructor.
      GRE_MFC_STATUSBAR (
         );

      //! Create the actual control.
      BOOL Create (
         CWnd *pParentWnd
         );

      //! Set view to associate with status bar.
      //! The view is used by the message handler.
      void SetView (
         GRE_MFC_VIEW *mfcview
         ) { m_LastView = mfcview; return; }

   protected:
      //! Message map.
      afx_msg void OnRButtonDown (UINT nFlags, CPoint point);
      DECLARE_MESSAGE_MAP()

   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT
      GRE_MFC_VIEW *m_LastView;

      GRE_MFC_STATUSBAR (const GRE_MFC_STATUSBAR&);
      GRE_MFC_STATUSBAR& operator= (const GRE_MFC_STATUSBAR&);
      #endif // GENERATING_DOXYGEN_OUTPUT
   };

#endif
#endif // GENERATING_DOXYGEN_OUTPUT

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

class GRE_SCRIPTCONTEXT_DRAW {
   public:

      //! Constructor.
      GRE_SCRIPTCONTEXT_DRAW (
         );

      //! Destructor.
      virtual ~GRE_SCRIPTCONTEXT_DRAW (
         );

      //! Attach SML context.
      //! After attachment the SCRIPTCONTEXT_DRAW 'owns' the context and will destroy it when
      //! necessary.  The context pointer is passed by reference and set to NULL on return to
      //! prevent external use of the context.
      void AttachContext (
         SMLCONTEXT *& context               //!< Context to attach, will set to NULL on return
         );

      //! Create SML context using RVC::GEOMETRIC object.
      ERRVALUE CreateContext (
         RVC::GEOMETRIC& GeoObj              //!< Geometric object (VECTOR, TIN, CAD, etc)
         );

      //! Destroy attached SML context if any.
      void DestroyContext (
         ) { if (m_context != 0) { m_context->Destroy(); m_context = 0; } }

      //! Get attached SMLCONTEXT pointer.
      //! Do not free or Destroy() the returned pointer.
      SMLCONTEXT * GetContext (
         ) const { return (m_context); }

      //! Determine if have SMLCONTEXT attached.
      bool HasContext (
         ) const { return (m_context != 0); }

      //! Initialize context variables for drawing.
      ERRVALUE InitDraw (
         GRE_LAYER *layer,                   //!< Layer
         MGD::CONTEXT *gc,                   //!< Drawing device context
         const TRANS2D_MAPGEN& trans,
         bool Is3D = false                   //!< 3D setting for CartoScript
         );

      //! Initialize using layer drawing context.
      ERRVALUE InitDraw (
         GRE_LAYERDC& layerdc
         );

   protected:

      virtual void CreateSymbols (
         );

   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT

      //! SML symbol pointers for standard symbols.
      struct DRAWSYMS {
         SMLSYMBOL *CurMapScale;       //!< Current Mapscale at time of drawing
         SMLSYMBOL *LayoutMapScale;    //!< Layout Mapscale at time of drawing
         SMLSYMBOL *DesignScale;       //!< Design scale at time of drawing
         };

      SMLCONTEXT *m_context;
      DRAWSYMS m_drawsym;

      GRE_SCRIPTCONTEXT_DRAW (const GRE_SCRIPTCONTEXT_DRAW&);
      GRE_SCRIPTCONTEXT_DRAW& operator= (const GRE_SCRIPTCONTEXT_DRAW&);

      #endif // GENERATING_DOXYGEN_OUTPUT
   };


class GRE_SCRIPTCONTEXT_STYLE : public GRE_SCRIPTCONTEXT_DRAW {
   public:

      //! Constructor.
      GRE_SCRIPTCONTEXT_STYLE (
         );

      //! Destructor.
      virtual ~GRE_SCRIPTCONTEXT_STYLE (
         );

      //! Create script segment for element and parse specified script.
      //! @return SML 'Segment' for parsed script or error < 0.
      int CreateSegment (
         ELEMTYPE elemtype,                  //!< Element type
         const UNICODE *scriptstr            //!< Script string
         );

      ERRVALUE Evaluate (
         int segment,                        //!< SML segment
         INT32 ElemNum,                      //!< Element number, type determined from 'segment'
         const RVC::STYLE& StyleObj,         //!< RVC Style object
         POINTSTYLE& style,                  //!< Style passed/returned
         const DPOINT2D* pt = 0,             //!< Sample point for style sample
         bool bDrawingLegendView = false     //!< true if drawing sample for legend view
         ) const;

      ERRVALUE Evaluate (
         int segment,                        //!< SML segment
         INT32 ElemNum,                      //!< Element number, type determined from 'segment'
         const RVC::STYLE& StyleObj,         //!< RVC Style object
         LINESTYLE& style,                   //!< Style passed/returned
         const SIMPLE_ARRAY<DPOINT2D>* pt = 0,     //!< Sample points for style sample
         bool bDrawingLegendView = false     //!< true if drawing sample for legend view
         ) const;

      ERRVALUE Evaluate (
         int segment,                        //!< SML segment
         INT32 ElemNum,                      //!< Element number, type determined from 'segment'
         const RVC::STYLE& StyleObj,         //!< RVC Style object
         POLYSTYLE& style,                   //!< Style passed/returned
         const SIMPLE_ARRAY<DPOINT2D>* pt = 0,     //!< Sample points for style sample
         bool bDrawingLegendView = false     //!< true if drawing sample for legend view
         ) const;

      ERRVALUE Evaluate (
         int segment,                        //!< SML segment
         RVC::CAD::ELEMENT& Element,         //!< CAD element
         const RVC::STYLE& StyleObj,         //!< RVC Style object
         const SIMPLE_ARRAY<DPOINT2D>* pt = 0,     //!< Sample points for style sample
         bool bDrawingLegendView = false     //!< true if drawing sample for legend view
         ) const;

      //! Sets the value of the sample rectangle
      void SetSampleRect (
         const DRECT2D& rect
         ) { m_stylesym.rect = rect; }

   protected:

      virtual void CreateSymbols (
         );

   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT

      //! SML symbol pointers for standard symbols.
      struct STYLESYMS {
         SMLSYMBOL *Style;             //!< Style name (string)
         SMLSYMBOL *Symbol;            //!< Point symbol name (string)
         SMLSYMBOL *DrawPatt;          //!< Pattern for line drawing (string)
         SMLSYMBOL *FillPatt;          //!< Pattern for filling (string)
         SMLSYMBOL *DrawColor;         //!< Line or Point color (string)
         SMLSYMBOL *FillColor;         //!< Fill color (string)
         SMLSYMBOL *LineScale;         //!< Line Scaling (number)
         SMLSYMBOL *XScale;            //!< X scaling (number)
         SMLSYMBOL *YScale;            //!< Y scaling (number)
         SMLSYMBOL *Angle;             //!< Rotation angle (number)
         SMLSYMBOL *UseStyle;          //!< Flag to use specified style (number)
         SMLSYMBOL *DrawSymbol;        //!< Flag to use point symbol (number)
         SMLSYMBOL *DrawLinePatt;      //!< Flag to use line pattern for drawing (number)
         SMLSYMBOL *DrawBitmapPatt;    //!< Flag to use bitmap pattern for drawing (line or symbol) (number)
         SMLSYMBOL *FillBitmapPatt;    //!< Flag to use bitmap pattern for filling (number)
         SMLSYMBOL *FillHatchPatt;     //!< Flag to use hatch pattern for filling (number)
         SMLSYMBOL *FillInside;        //!< Flag set to fill inside (number)
         SMLSYMBOL *DrawBorder;        //!< Flag set to draw border (number)
         SMLSYMBOL *MapScale;          //!< Mapscale for relative sizes
         SMLSYMBOL *DrawDone;          //!< Flag shows that drawing was already done by query
         SMLSYMBOL *DrawTransPct;      //!< Transparency percentage for "DrawColor"
         SMLSYMBOL *FillTransPct;      //!< Transparency percentage for "FillColor"
         SMLSYMBOL *DrawingSample;     //!< Drawing Sample
         SMLSYMBOL *DrawingLegendView;    //!< Drawing Sample
         SMLSYMBOL *SampleRect;        //!< Symbol when drawing a style sample
         DRECT2D rect;                 //!< The rectangle that SampleRect points to
         };

      STYLESYMS m_stylesym;

      void GetColor (
         SMLSYMBOL*,
         SMLSYMBOL*,
         COLOR& color
         ) const;

      GRE_SCRIPTCONTEXT_STYLE (const GRE_SCRIPTCONTEXT_STYLE&);
      GRE_SCRIPTCONTEXT_STYLE& operator= (const GRE_SCRIPTCONTEXT_STYLE&);

      #endif // GENERATING_DOXYGEN_OUTPUT
   };


class GRE_SCRIPTCONTEXT_LABEL : public GRE_SCRIPTCONTEXT_DRAW {
   public:

      //! Constructor.
      GRE_SCRIPTCONTEXT_LABEL (
         );

      //! Destructor.
      virtual ~GRE_SCRIPTCONTEXT_LABEL (
         );