mxdialog.h

Go to the documentation of this file.

/**
 * \file mxdialog.h <mi32/mxdialog.h>
 * \brief Definitions for Mxd-style dialogs
 *
 *    If moving prototypes out of this header, DO NOT have this header
 *    include the new header.
 *
 * \if NODOC
 * $Id: mxdialog.h_v 1.28 2004/06/30 17:10:03 dwilliss Exp $
 *
 * $Log: mxdialog.h_v $
 * Revision 1.28  2004/06/30 17:10:03  dwilliss
 * const
 *
 * Revision 1.27  2004/06/30 16:35:56  dwilliss
 * Changed MxdViewRastHistCreate to take an RVC::OBJITEM instead of deprecated
 * fnameinodeuc
 * Changed MxdViewRastHistSetRegion to take REGION2D instead of deprecated
 * dregion
 *
 * Revision 1.26  2004/06/29 21:42:34  mju
 * Use trans2d_mapgen for rastcorr highlight.
 *
 * Revision 1.25  2004/06/29 21:19:05  mju
 * Use coordrefsys in viewprofileupdate.
 *
 * Revision 1.24  2004/03/08 20:01:20  vdronov
 * added PROFILEFLAG
 *
 * Revision 1.23  2004/02/20 20:33:03  scowan
 * Changed some view profile parms.
 *
 * Revision 1.22  2003/09/15 13:49:56  fileserver!dwilliss
 * Doxygen
 *
 * Revision 1.21  2003/03/27 18:35:04  mju
 * Remove obsolete prototype.
 *
 * Revision 1.20  2002/03/28 21:29:53  scowan
 * More cosnt.
 *
 * Revision 1.19  2001/12/31 17:49:04  mju
 * Remove MxDATABASE flags.
 *
 * Revision 1.18  2001/12/28 21:34:51  mju
 * Add MxEditColorMap using color array.
 * Use C++ linkage.
 *
 * Revision 1.17  2001/12/21 18:57:31  mju
 * Don't define anything if WIN32_NATIVE.
 *
 * Revision 1.16  2001/12/21 17:15:01  mju
 * Use const for filename in ...Create().
 *
 * Revision 1.15  2001/12/21 16:42:27  dwilliss
 * Fixed typo.  It compiles now
 *
 * Revision 1.14  2001/12/21 14:16:32  mju
 * Include xdefns so has MxRELPOSN defns.
 *
 * Revision 1.13  2001/12/21 00:42:47  scowan
 * Changed parameter to enum.
 *
 * Revision 1.12  2001/12/20 22:32:22  scowan
 * Changed to use relposn enum.
 *
 * Revision 1.11  2001/02/15 20:29:21  scowan
 * Nothing.
 *
 * Revision 1.10  2000/07/19 21:20:04  mju
 * Add MxdEditTextFileObj... prototypes.
 *
 * Revision 1.9  2000/07/07 21:38:10  sparsons
 * Genitor revision.
 *
 * Revision 1.8  2000/07/07 21:36:42  sparsons
 * Genitor documentation.
 *
 * Revision 1.7  1999/11/18 15:29:36  mju
 * MxdEditMetadataCreate now takes const title.
 *
 * Revision 1.6  1999/10/20  22:08:23  scowan
 * More const.
 *
 * Revision 1.5  1999/10/20 17:15:54  mju
 * Use const in ViewRastCorrCreate.
 *
 * Revision 1.4  1999/10/20  17:05:35  mju
 * Use const file in EditMetaDataCreate
 *
 * Revision 1.3  1999/05/26  20:16:48  mju
 * Include Intrinsic.h after all if not WIN32-native.
 *
 * Revision 1.2  1999/05/26  14:04:58  mju
 * Don't include "intrinsic" for X.
 *
 * Revision 1.1  1999/05/06  22:14:23  mju
 * Initial revision
 * \endif
**/

#if !defined(INC_MI32_MXDIALOG_H) && !defined(WIN32_NATIVE)
#define  INC_MI32_MXDIALOG_H

#ifndef  INC_MI32_STDDEFNS_H
   #include <mi32/stddefns.h>
#endif

#if !defined(WIN32_NATIVE) && !defined(INC_MI32_XDEFNS_H)
   #include <mi32/xdefns.h>
#endif

#if !defined(WIN32_NATIVE) && !defined(_XtIntrinsic_h)
   #include <X11/Intrinsic.h>
#endif

#ifndef  INC_MI32_POINT_H
   #include <mi32/point.h>
#endif

//! Forward declarations

struct COLMAPINFO;
class REGION2D;
class TRANS2D_MAPGEN;
namespace RVC {
   class OBJITEM;
   }

/*----------------------------------------------------------------------------*/
/*    Definitions for "modeless dialog" functions                             */
/*----------------------------------------------------------------------------*/

struct MxdAnyCallbackStruct {
   UINT32 reason;                   //!<  Callback reason 
   MXDHANDLE dhandle;               //!<  Dialog handle 
   };

typedef void (*MxdCallbackFunc)(MxdAnyCallbackStruct*,void*);

         /* Generic flags */
#define  MxdFLAG_SetLastPosition    0x80000000  //!<  Open dialog where it was last used (via MxSetWindowPosition())
#define  MxdFLAG_OpenOnCreate       0x40000000  //!<  Open dialog when created 
#define  MxdFLAG_DestroyOnClose     0x20000000  //!<  Destroy dialog when closed 
#define  MxdFLAG_Modal              0x10000000  //!<  Dialog is modal 
#define  MxdFLAG_ReturnWhenClose    0x08000000  //!<  Don't return from Mxd...Open() until dialog closed 
#define  MxdFLAG_NoClose            0x04000000  //!<  Don't allow dialog to be closed by user or Mxd...Close() 
#define  MxdFLAG_HaveApply          0x02000000  //!<  Include "Apply" button if appropriate 

         /* Dialog-specific flags */

         /* Flags for MxdInspRast */
#define  MxdINSPRAST_NoSelect       0x00000001  //!<  Don't allow user to select raster 
#define  MxdINSPRAST_AllowEdit      0x00000002  //!<  Allow user to edit cell values 
         /* Flags for MxdInspRastSetView */
#define  MxdINSPRAST_SetCenter      1

         /* Flags for MxdTipOfDayCreate() */
#define  MxdTIPOFDAY_NoAutoOpen     0x00000001  //!<  Auto open on startup disabled 

         /* Flags for MxdViewRastCorrSetHighlightPosn */
#define  MxdVIEWRASTCORR_PosnTransInput   0x00000001  //!<  Use input side of specified TRANSPARM 

         /* Callback reasons common to many dialogs */
#define  MxdCR_Destroy           0x80000000     //!<  Dialog is being destroyed 
#define  MxdCR_Close             0x40000000     //!<  Dialog has been closed 
#define  MxdCR_Open              0x20000000     //!<  Dialog has been opened 
#define  MxdCR_Resize            0x10000000     //!<  Dialog has been resized 
#define  MxdCR_Apply             0x08000000     //!<  User has pressed the "Apply" button 
#define  MxdCR_Modify            0x04000000     //!<  User has modified something in the dialog 
#define  MxdCR_ChangeBegin       0x02000000     //!<  User is about to change something 
#define  MxdCR_ChangeEnd         0x01000000     //!<  User has finished changing something 
#define  MxdCR_ChangeContinue    0x00800000     //!<  User is continuing to change something 
#define  MxdCR_SelectedObject    0x00400000     //!<  User selected or opened different object 
#define  MxdCR_SavedObject       0x00200000     //!<  User saved the object 

         /* Callback "reason" definitions for MxdInspRast */
#define  MxdCR_InspRastViewChanged     0x00000001


/*----------------------------------------------------------------------------*/
/*    Definitions for MxdEditColorMap                                         */
/*----------------------------------------------------------------------------*/

#define  MxdEDITCOLORMAP_LoadFromObject      0x00000001  //!<  Load color map from file/object provided 
#define  MxdEDITCOLORMAP_InitGrayscale       0x00000002  //!<  Initialize color map to linear grayscale 
#define  MxdEDITCOLORMAP_RetNewObject        0x00000004  //!<  Return new filename/inode if user does save-as 
#define  MxdEDITCOLORMAP_AllowTransparent    0x00000008  //!<  Allow colors to be set to "transparent" 
#define  MxdEDITCOLORMAP_AllowTransparency   0x00000010  //!<  Allow transparency factor to be set 

struct MxdEditColorMapCallbackStruct {
   UINT32 reason;                   //!<  Callback reason 
   MXDHANDLE dhandle;               //!<  Dialog handle 
   UNICODE *filename;               //!<  File name for save 
   INT32 inode;                        //!<  Object inode for save 
   };


/*----------------------------------------------------------------------------*/
/*    Definitions for MxdSmartLine                                            */
/*----------------------------------------------------------------------------*/

#define MxdSmartLine_StartLine      0x00000001  //!<  when start tracing new line 
#define MxdSmartLine_StopLine       0x00000002  //!<  when new line is complete 
#define MxdSmartLine_SaveLine       0x00000004  //!<  when new line is complete same as StopLine 
#define MxdSmartLine_AbortLine      0x00000008  //!<  if line started, but then error occured 
#define MxdSmartLine_NewPoint       0x00000010  //!<  when new point added to line 
#define MxdSmartLine_TraceBegin     0x00000020  //!<  when start tracing procedure 
#define MxdSmartLine_TraceEnd       0x00000040  //!<  when stop tracing procedure 
#define MxdSmartLine_StopReason     0x00000080  //!<  when stop tracing procedure 

struct MxdSmartLineCallbackStruct {
   UINT32 reason;
   MXDHANDLE dhandle;
   INT32 ElemNum;
   LPOINT3D *Line;
   INT32 NumPoints;
   int ElemType;
   };

//!:Associate with "Mxd-style dialog functions"
//!\addtogroup Mxd Mxd-style dialog functions
//!@{

//! Add callback to list.
int MxdAutoColorMapAddCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *data, 
   UINT32 reason
   );

//! Create the dialog.
int MxdAutoColorMapCreate (
   Widget pwidget,                     //!< Parent widget
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *dialoghandle,                 //!< Dialog title
   int relposn,                        //!< Relative position for dialog to appear
   UNICODE *classfilename,             //!< Input File Name
   INT32 classrastinode,               //!< Input class raster inode
   COLOR *colmap,
   int NumColors,
   int dialogflags                     //!< MxdFLAG_... flags
   );

//! Open the dialog.
int MxdAutoColorMapOpen (
   MXDHANDLE dhandle                   //!< Dialog handle
   );

//! Close the dialog.
int MxdAutoColorMapClose (
   MXDHANDLE dhandle                   //!< Dialog handle
   );

//! Destroy the dialog.
int MxdAutoColorMapDestroy (
   MXDHANDLE dhandle                   //!< Dialog handle
   );

//! Return whether not dialog is open.
int MxdAutoColorMapIsOpen (
   MXDHANDLE dhandle                   //!< Dialog handle
   );

//! Remove callback from list.
int MxdAutoColorMapRemoveCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *data, 
   UINT32 reason
   );

//! Add callback for "color map editor" dialog.
//!
//! Flags:
//!      \li \b MxdFLAG_Modal                   Make dialog modal
//!      \li \b MxdEDITCOLORMAP_LoadFromObject  Load color map from filename/inode provided if possible
//!      \li \b MxdEDITCOLORMAP_InitGrayscale      Initialize color map to linear grayscale
//!      \li \b MxdEDITCOLORMAP_RetNewObject    Return new filename/inode if user does save-as (modal only)
int MxdEditColorMapAddCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Close the dialog.
int MxdEditColorMapClose (
   MXDHANDLE dhandle
   );

//! Create "color map editor" dialog.
//!
//! Flags:     
//!      \li \b MxdFLAG_Modal                   Make dialog modal
//!      \li \b MxdEDITCOLORMAP_LoadFromObject  Load color map from filename/inode provided if possible
//!      \li \b MxdEDITCOLORMAP_InitGrayscale      Initialize color map to linear grayscale
//!      \li \b MxdEDITCOLORMAP_RetNewObject    Return new filename/inode if user does save-as (modal only)
int MxdEditColorMapCreate (
   Widget pwidget,                     //!< Parent widget for dialog
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *dialogname,                   //!< Dialog name for title ("color_palette_editor" if NULL)
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   COLMAPINFO *colmapinfo,             //!< Color map information structure (can be NULL if modal)
   UNICODE *cmapfilename,              //!< RVC filename for loading/saving color map (NULL if don't need)
   INT32 parentinode,                  //!< Parent inode for saving colormap 
   INT32 *cmapinode,                   //!< Color map object inode passed/returned 
   UINT32 dialogflags                  //!< MxdFLAG_OpenOnCreate, MxdFLAG_DestroyOnClose
   );

//! Create "color map editor" dialog.
//!
//! Flags:     
//!      \li \b MxdFLAG_Modal                   Make dialog modal
//!      \li \b MxdEDITCOLORMAP_LoadFromObject  Load color map from filename/inode provided if possible
//!      \li \b MxdEDITCOLORMAP_InitGrayscale      Initialize color map to linear grayscale
//!      \li \b MxdEDITCOLORMAP_RetNewObject    Return new filename/inode if user does save-as (modal only)
int MxdEditColorMapCreate (
   Widget pwidget,                     //!< Parent widget for dialog
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *dialogname,                   //!< Dialog name for title ("color_palette_editor" if NULL)
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   COLOR *colmap,                      //!< Pointer to color palette, data at pointer will be modified by dialog
   int NumColors,                      //!< Number of colors in palette
   UNICODE *cmapfilename,              //!< RVC filename for loading/saving color map (NULL if don't need)
   INT32 parentinode,                  //!< Parent inode for saving colormap 
   INT32 *cmapinode,                   //!< Color map object inode passed/returned 
   UINT32 dialogflags                  //!< MxdFLAG_OpenOnCreate, MxdFLAG_DestroyOnClose
   );

//! Destroy the dialog. 
int MxdEditColorMapDestroy (
   MXDHANDLE dhandle
   );

//! Return whether not dialog is open.
int MxdEditColorMapIsOpen (
   MXDHANDLE dhandle
   );

//! Open the dialog.
int MxdEditColorMapOpen (
   MXDHANDLE dhandle
   );

//! Remove callback from list.
int MxdEditColorMapRemoveCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Update dialog for external changes to color palette.
int MxdEditColorMapUpdate (
   MXDHANDLE dhandle,                  //!< Dialog handle from MxdEditColorMapCreate()
   int notify                          //!< Set if want callback list called with MxdCR_Modify
   );

//! Add callback to list.
int MxdEditMetaDataAddCallback (
   MXDHANDLE dhandle, 
   void(*)(MxdAnyCallbackStruct*,void*), 
   void *cbs, 
   UINT32 reasonmask
   );

//! Close the dialog.
int MxdEditMetaDataClose (
   MXDHANDLE dhandle
   );

//! Create the dialog.
int MxdEditMetaDataCreate (
   Widget pwidget,                     //!< Parent widget
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   const char *dialogname,             //!< Dialog name override
   MxRELPOSN relposn,                        //!< Relative position for dialog to appear
   const UNICODE *filename,            
   INT32 inode,                        //!< Inode of object metadata is for
   UINT32 dialogflags                  //!< MxdFLAG_... flags
   );

//! Destroy the dialog.
int MxdEditMetaDataDestroy (
   MXDHANDLE dhandle
   );

//! Return whether not dialog is open.
int MxdEditMetaDataIsOpen (
   MXDHANDLE dhandle
   );

//! Open the dialog.
int MxdEditMetaDataOpen (
   MXDHANDLE dhandle
   );

//! Remove callback from list.
int MxdEditMetaDataRemoveCallback (
   MXDHANDLE dhandle, 
   void(*)(MxdAnyCallbackStruct*,void*), 
   void *cbs, 
   UINT32 reasonmask
   );

//! Add callback for "text file editor" dialog.
int MxdEditTextFileAddCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Close previously opened "text file editor" dialog.
int MxdEditTextFileClose (
   MXDHANDLE dhandle
   );

//! Create "text file editor" dialog.
//!
//! Flags:
//!      \li \b MxdFLAG_Modal    Make dialog modal
int MxdEditTextFileCreate (
   Widget pwidget,                     //!< Parent widget for dialog
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *dialogname,                   //!< Dialog name ("mxAdjustShading" if NULL)
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   UNICODE *filename,                  //!< Name of text file to be edited (NULL if no default)
   char *dftextn,                      //!< Default file extension (NULL for .txt)
   char *encoding,                     //!< Initial text encoding (NULL if don't need)
   UINT32 dialogflags                  //!< MxdFLAG_OpenOnCreate, MxdFLAG_DestroyOnClose
   );

//! Get text widget so XeText functions can be called.
int MxdEditTextFileGetTextWidget (
   MXDHANDLE dhandle,                  //!< Dialog handle from Create function
   Widget *ReturnWidget                //!< Widget returned
   );

//! Destroy previously created "text file editor" dialog.
int MxdEditTextFileDestroy (
   MXDHANDLE dhandle
   );

//! Return true if "text file editor" dialog is open, false if not.
int MxdEditTextFileIsOpen (
   MXDHANDLE dhandle
   );

//! Open previously created "text file editor" dialog.
int MxdEditTextFileOpen (
   MXDHANDLE dhandle
   );

//! Remove callback for "text file editor" dialog.
int MxdEditTextFileRemoveCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Add callback for "text file/object editor" dialog.
ERRVALUE MxdEditTextFileObjAddCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Close previously opened "text file/object editor" dialog.
ERRVALUE MxdEditTextFileObjClose (
   MXDHANDLE dhandle
   );

//! Create "text file/object editor" dialog.
//!
//! Flags:
//!      \li \b MxdFLAG_Modal    Make dialog modal
ERRVALUE MxdEditTextFileObjCreate (
   Widget pwidget,                     //!< Parent widget for dialog
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *dialogname,                   //!< Dialog name ("mxAdjustShading" if NULL)
   int relposn,                  //!< Position relative to parent's shell (0=none, -1=use previous)
   UNICODE *filename,                  //!< Name of text file to be edited (NULL if no default)
   char *dftextn,                      //!< Default file extension (NULL for .txt)
   char *encoding,                     //!< Initial text encoding (NULL if don't need)
   UINT32 dialogflags                  //!< MxdFLAG_OpenOnCreate, MxdFLAG_DestroyOnClose
   );

//! Get text widget so XeText functions can be called.
ERRVALUE MxdEditTextFileObjGetTextWidget (
   MXDHANDLE dhandle,                  //!< Dialog handle from Create function
   Widget *ReturnWidget                //!< Widget returned
   );

//! Destroy previously created "text file/object editor" dialog.
ERRVALUE MxdEditTextFileObjDestroy (
   MXDHANDLE dhandle
   );

//! Return true if "text file/object editor" dialog is open, false if not.
ERRVALUE MxdEditTextFileObjIsOpen (
   MXDHANDLE dhandle
   );

//! Open previously created "text file/object editor" dialog.
ERRVALUE MxdEditTextFileObjOpen (
   MXDHANDLE dhandle
   );

//! Remove callback for "text file/object editor" dialog.
ERRVALUE MxdEditTextFileObjRemoveCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Add callback for "raster inspection" dialog.
//!
//! Reasons:   
//!      \li \b MxdCR_Open                Dialog was opened 
//!      \li \b MxdCR_Close                  Dialog was closed
//!      \li \b MxdCR_Destroy             Dialog was destroyed
//!      \li \b MxdCR_Modify              User modified raster cell value (if editing allowed)
//!      \li \b MxdCR_SelectedObject         User selected different raster object (if allowed)
//!      \li \b MxdCR_InspRastViewChanged User scrolled the view
int MxdInspRastAddCallback (
   MXDHANDLE handle,                   //!< Dialog handle
   MxdCallbackFunc,                    //!< Callback function
   void *cbdata,                       //!< Data to pass into callback
   UINT32 reason                       //!< Message reasons requested
   );

//! Close previously opened "raster inspection" dialog.
int MxdInspRastClose (
   MXDHANDLE dhandle
   );

//! Create "raster inspection" dialog.
//!
//! Flags:     
//!   \li \b MxdFLAG_OpenOnCreate      Open dialog when created
//!      \li \b MxdFLAG_DestroyOnClose Destroy dialog when closed
//!      \li \b MxdINSPRAST_NoSelect      Don't allow user to select a different raster
//!      \li \b MxdINSPRAST_AllowEdit  Allow user to edit raster data
int MxdInspRastCreate (
   Widget pwidget,                     //!< Parent widget for dialog
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *dialogname,                   //!< Dialog name ("mxInspRast" if NULL)
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   const UNICODE *dftfilename,         //!< Default RVC filename
   INT32 dftinode,                     //!< Default raster object inode
   int dialogflags                     //!< MxdFLAG_OpenOnCreate, MxdFLAG_DestroyOnClose
   );

//! Destroy previously created "raster inspection" dialog. 
int MxdInspRastDestroy (
   MXDHANDLE dhandle
   );

//! Return filename/inode of raster currently being viewed.
int MxdInspRastGetRast (
   MXDHANDLE dhandle,                  //!< Dialog handle
   UNICODE *filename,                  //!< String to store filename in
   INT32 *inode                        //!< Raster inode returned
   );

//! Return portion of raster currently being viewed.
int MxdInspRastGetView (
   MXDHANDLE dhandle,                  //!< Dialog handle
   INT32 *initlin,                     //!< Initial line being viewed [returned]
   INT32 *initcol,                     //!< Initial column being viewed [returned]
   INT32 *viewlins,                    //!< Number of lines being viewed [returned]
   INT32 *viewcols,                    //!< Number of columns being viewed [returned]
   INT32 *editlin,                     //!< Line being edited [returned]
   INT32 *editcol                      //!< Column being edited [returned]
   );

//! Return true if "contrast enhancement" dialog is open, false if not.
int MxdInspRastIsOpen (
   MXDHANDLE dhandle
   );

//! Open previously created "contrast enhancement" dialog.
int MxdInspRastOpen (
   MXDHANDLE dhandle
   );

//! Remove callback for "raster inspection" dialog.
int MxdInspRastRemoveCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Set portion of raster to be viewed.
//!
//! Flag:
//!   \li \b MxdINSPRAST_SetCenter
int MxdInspRastSetView (
   MXDHANDLE dhandle,                  //!< Dialog handle
   INT32 initlin,                      //!< Initial line to be viewed
   INT32 initcol,                      //!< Initial column to be viewed
   int flags                           //!< Flags
   );

//! Activate dialog tool.
int MxdSmartLineActivate (
   MXDHANDLE handle
   );

//! Add callback to the dialog.
int MxdSmartLineAddCallback (
   MXDHANDLE handle,                                     //!< Dialog handle
   void (*func)(MxdSmartLineCallbackStruct *cb, void*),  //! Callback function
   void *udata,                                          //!< User data to pass into callback
   UINT32 reason                                         //!< Reason for callback
   );

//! Close the dialog.
int MxdSmartLineClose (
   MXDHANDLE dhandle
   );

//! Create Smart Line Following Dialog.
int MxdSmartLineCreate (
   Widget pwidget,                     //!< Parent widget
   MXDHANDLE *handle,                  //!< Handle returned
   char *dialogname,                   //!< Dialog name override 
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   void *vview,                        //!< View to operate on
   void *vlp,                          //!< Layer to operate on
   UINT32 dialogflags                  //!< Dialog flags
   );

//! Destroy the dialog.
int MxdSmartLineDestroy (
   MXDHANDLE dhandle
   );

//! Return whether not dialog is open.
int MxdSmartLineIsOpen (
   MXDHANDLE dhandle
   );

//! Start a new view.
int MxdSmartLineNewView (
   MXDHANDLE dhandle
   );

//! Open the dialog.
int MxdSmartLineOpen (
   MXDHANDLE dhandle
   );

//! Remove callback from the dialog. 
void MxdSmartLineRemoveCallback (
   MXDHANDLE dhandle, 
   void (*func)(MxdSmartLineCallbackStruct *cb, void*), 
   void *data, 
   UINT32 reason
   );

//! Resume dialog tool.
int MxdSmartLineResume (
   MXDHANDLE handle
   );

//! Suspend dialog tool.
int MxdSmartLineSuspend (
   MXDHANDLE handle
   );

//! Add callback for "tip of day" dialog. 
int MxdTipOfDayAddCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *data, 
   UINT32 reason
   );

//! Close previously opened "tip of day" dialog.
int MxdTipOfDayClose (
   MXDHANDLE dhandle
   );

//! Create "tip of day" dialog.
//!
//! Flags:     
//!      \li \b MxdTIPOFDAY_NoAutoOpen Do not perform automatic opening
//!
//!   The TipOfDay messages are stored in tnthelp.txt in the format:
//!      [tip."AppName".[0..n]] where "AppName" is from GetAppName() and [0..n] is the sequence
//!      of Tip of the day messages.  Eg:  [tip.tntedit.0], [tip.tntedit.1], ...
//! \todo This says the TipOfDay messages are in tnthelp.txt.  Need to update.
int MxdTipOfDayCreate (
   Widget pwidget,                     //!< Parent widget for dialog
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *dialogname,                   //!< Dialog name ("mxInspRast" if NULL)
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   UINT32 dialogflags                  //!< MxdFLAG_OpenOnCreate, MxdFLAG_DestroyOnClose
   );

//! Destroy previously created "tip of day" dialog.
int MxdTipOfDayDestroy (
   MXDHANDLE dhandle
   );

//! Return true if "tip of day" dialog is open, false if not.
int MxdTipOfDayIsOpen (
   MXDHANDLE dhandle
   );

//! Open previously created "tip of day" dialog.
int MxdTipOfDayOpen (
   MXDHANDLE dhandle
   );

//! Remove callback for "tip of day" dialog.
int MxdTipOfDayRemoveCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *data, 
   UINT32 reason
   );

//! Close the dialog.
int MxdViewProfileClose (
   MXDHANDLE dhandle
   );

//! Create the dialog.
int MxdViewProfileCreate (
   Widget parent,                      //!< Parent widget
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *dialogname,                   //!< Dialog name override
   MxRELPOSN relposn,                  //!< Relative position for dialog to appear
   const UNICODE *objfilename,         //!< Object filename (if any)
   INT32 objinode,                     //!< Object inode
   int dialogflags                     //!< MxdFLAG_... flags
   );

//! Destroy the dialog. 
int MxdViewProfileDestroy (
   MXDHANDLE dhandle
   );

//! Return whether not dialog is open.
int MxdViewProfileIsOpen (
   MXDHANDLE dhandle
   );

//! Open the dialog.
int MxdViewProfileOpen (
   MXDHANDLE dhandle
   );

//! Return filename/inode for object associated with profile.
int MxdViewProfileQueryObject (
   MXDHANDLE dhandle, 
   RVC::OBJITEMLIST& ObjItemList
   );

//! Redraw contents.
int MxdViewProfileRedraw (
   MXDHANDLE dhandle
   );

//! Set function to call when object being viewed changes.
int MxdViewProfileSetChangeObjectCallback (
   MXDHANDLE dhandle,  
   void(*)(MXDHANDLE,void*,const RVC::OBJITEM&), 
   void *chgobjdata
   );

//! Set function to call when dialog closed.
int MxdViewProfileSetCloseCallback (
   MXDHANDLE dhandle, 
   void(*)(MXDHANDLE,void*), 
   void *closedata
   );

//! Set function to call when dialog destroyed.
int MxdViewProfileSetDestroyCallback (
   MXDHANDLE dhandle, 
   void(*)(MXDHANDLE,void*), 
   void *destroydata
   );

enum PROFILEFLAGS {
    PROFILEFLAG_None       =    0x00,
    PROFILEFLAG_InMapCoord    =    0x01,
    PROFILEFLAG_SeparatePoints =    0x02
    };

DEFINE_ENUM_OPERATORS(PROFILEFLAGS);

//! Notify dialog that area selected for profile has changed. 
int MxdViewProfileUpdate ( 
   MXDHANDLE dhandle, 
   DPOINT2D *mappoint, 
   INT32 numpoints, 
   const SPATREF::COORDREFSYS& CoordRefSys,
   PROFILEFLAGS flags
   );

//! Add callback to list.
int MxdViewRastCorrAddCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Close the dialog.
int MxdViewRastCorrClose (
   MXDHANDLE dhandle
   );

//! Create the dialog.
int MxdViewRastCorrCreate (
   Widget pwidget,                     //!< Parent widget
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   const char *dialogname,             //!< Dialog name override
   int relposn,                        //!< Relative position for dialog to appear
   const UNICODE *xrastfilename,       //!< Optional X raster filename
   INT32 xrastinode,                   //!< Optional inode for X raster
   const UNICODE *yrastfilename,       //!< Optional Y raster filename
   INT32 yrastinode,                   //!< Optional inode for Y raster
   UINT32 dialogflags                  //!< MxdFLAG_... flags
   );

//! Destroy the dialog.
int MxdViewRastCorrDestroy (
   MXDHANDLE dhandle
   );

//! Return whether not dialog is open.
int MxdViewRastCorrIsOpen (
   MXDHANDLE dhandle
   );

//! Open the dialog.
int MxdViewRastCorrOpen (
   MXDHANDLE dhandle
   );

//! Remove callback from list.
int MxdViewRastCorrRemoveCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbs, 
   UINT32 reasonmask
   );

//! Set coordinates for "dancing pixels" highlight position.
int MxdViewRastCorrSetHighlightPosn (
   MXDHANDLE dhandle, 
   const TRANS2D_MAPGEN& Trans,
   DPOINT2D *point, 
   UINT32 flags
   );

//! Add callback for raster histogram view dialog.
int MxdViewRastHistAddCallback (
   MXDHANDLE dhandle, 
   void(*)(MxdAnyCallbackStruct*,void*), 
   void *cbdata, 
   UINT32 reasonmask
   );

//! Close previously opened "raster histogram view" dialog.
int MxdViewRastHistClose (
   MXDHANDLE dhandle
   );

//! Create "raster histogram view".
int MxdViewRastHistCreate (
   Widget pwidget,                     //!< Parent widget for dialog
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   const char *dialogname, 
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   const RVC::OBJITEM* objitem,        //!< if NULL, will prompt user to select a raster
   UINT32 dialogflags
   );

//! Destroy previously created "raster histogram view" dialog.
int MxdViewRastHistDestroy (
   MXDHANDLE dhandle
   );

//! Open previously created "raster histogram view" dialog. 
int MxdViewRastHistOpen (
   MXDHANDLE dhandle
   );

//! Remove callback for raster histogram view dialog.
int MxdViewRastHistRemoveCallback (
   MXDHANDLE dhandle, 
   void(*)(MxdAnyCallbackStruct*,void*), 
   void *cbdata, 
   UINT32 reasonmask
   );

//! Set region for partial-raster histogram view.
//! NOTE: If region.GetCoordRefSys().IsLocal() is true, the region is expected
//!   to be in raster coordinages.  If not, the region is expected to be in
//!   the the CRS returned by GetCoordRefSys()
int MxdViewRastHistSetRegion (
   MXDHANDLE dhandle,                  //!< Dialog handle
   const REGION2D& region              //!< Region defining area to view (map coordinates)
   );

//! Assign or change variable in rose diagram display.
int MxdViewRoseAddVariable (
   MXDHANDLE dhandle,                  //!< Dialog handle
   int Num,                            //!< Variable number, started from 0
   const UNICODE *name,                      //!< Variable name to be displayed (lenght <= 25 char)
   double *Value,                      //!< Address of variable to be assigned 
   double Min,                         //!< Minimum value of this variable
   double Max,                         //!< Maximum value of this variable
   double SelPos                       //!< Reserved for future use, any value
   );

//! Add variable using direction.
int MxdViewRoseAddVariableAngle (
   MXDHANDLE dhandle,  
   double Angle, 
   UNICODE *name,  
   double *Value,  
   double Min, 
   double Max, 
   double SelPos
   );

//! Close previously opened "rose diagram" dialog. 
int MxdViewRoseClose (
   MXDHANDLE dhandle
   );

//! Create rose diagram dialog.
int MxdViewRoseCreate (
   Widget pwidget,                     //!< Parent widget 
   MXDHANDLE *dhandle,                 //!< Dialog handle returned 
   char *dialogname,                   //!< Dialog name override 
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   int NumVars,                        //!< Number of variables/dimensions 
   int dialogflags                     //!< MxdFLAG_... flags 
   );

//! Destroy previously created "rose diagram" dialog.
int MxdViewRoseDestroy (
   MXDHANDLE dhandle
   );

//! Return true if "rose diagram" dialog is open, false if not.
int MxdViewRoseIsOpen (
   MXDHANDLE dhandle
   );

//! Open previously created "rose diagram" dialog.
int MxdViewRoseOpen (
   MXDHANDLE dhandle
   );

//! Function for future use/ Get scale bar position for specified variable.
int MxdViewRoseScaleBar (
   MXDHANDLE dhandle,                  //!< Dialog handle
   int Num,                            //!< Variable number to get scalebar position
   double *Var                         //!< Scalebar position returned
   );

//! Set selection callback function.
int MxdViewRoseSetSelectCallback (
   MXDHANDLE dhandle, 
   void(*)(int,  void*), 
   void *data
   );

//! Update rose diagram display / redraw diagram.
int MxdViewRoseUpdate (
   MXDHANDLE dhandle
   );

//! Set function to call when dialog closed.
int MxdViewRoseSetCloseCallback (
   MXDHANDLE dhandle, 
   void(*)(void*,void*), 
   void *closedata
   );

//! Set function to call when dialog destroyed.
int MxdViewRoseSetDestroyCallback (
   MXDHANDLE dhandle, 
   void(*)(void*,void*), 
   void *destroydata
   );

//! Assign a callback.
int MxdViewXYPlotAddCallback (
   MXDHANDLE dhandle, 
   MxdCallbackFunc, 
   void *cbdata, 
   UINT32 reasonmask
   );

//! Assign XY data for dialog and provide name of axises.
//!
//! Note 1: If programmer pass NULL for X or Y axis, the default
//!      names will be displayed in dialog: "X" and "Y".
//!
//!   Note 2: Dialog creates own copy of "Points" and you can do
//!      what you want with it, it doesn't affect assigned data.
int MxdViewXYPlotAssignData (
   MXDHANDLE dhandle,                  //!< Dialog handle
   INT32 Num,                          //!< Number of points
   DPOINT2D *Points,                   //!< Array of points
   char *Xname,                        //!< Name of horizontal axis, can be NULL 
   char *Yname                         //!< Name of vertical axis, can be NULL
   );

//! Close previously opened dialog.
int MxdViewXYPlotClose (
   MXDHANDLE dhandle
   );

//! Create XY-plot dialog.
int MxdViewXYPlotCreate (
   Widget parent,                      //!< Parent widget
   MXDHANDLE *dhandle,                 //!< Dialog handle returned
   char *name,                         //!< Dialog name override
   int relposn,                        //!< Position relative to parent's shell (0=none, -1=use previous)
   int dialogflags                     //!< MxdFLAG_OpenOnCreate, MxdFLAG_DestroyOnClose
   );

//! Destroy previously created dialog.
int MxdViewXYPlotDestroy (
   MXDHANDLE dhandle
   );

//! Get Motif FormDialog for X-Y plot.
Widget MxdViewXYPlotGetFormDialog (
   MXDHANDLE dhandle
   );

//! Return true if dialog is open.
int MxdViewXYPlotIsOpen (
   MXDHANDLE dhandle
   );

//! Open previously created dialog.
int MxdViewXYPlotOpen (
   MXDHANDLE dhandle
   );

//! Redraw dialog contents.
int MxdViewXYPlotUpdate (
   MXDHANDLE dhandle
   );

//!@}

#endif   //!<  INC_MI32_MXDIALOG_H 

---