mgui/toolpolyline.h

Go to the documentation of this file.

#ifndef  INC_MGUI_TOOLPOLYLINE_H
#define  INC_MGUI_TOOLPOLYLINE_H

#ifndef  INC_MGUI_TOOLGPS_H
#include <mgui/toolgps.h>
#endif

#ifndef  INC_MI32_POLYLINE_H
#include <mi32/polyline.h>
#endif

namespace MGUI {

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

class TOOL_POLYLINE : public TOOL_GPS {
   public:
      enum DRAWMODE {
         DRAWMODE_Draw = 256,
         DRAWMODE_Stretch
         };
      
      enum EDITMODE {
         EDITMODE_Automatic = 0,             
         EDITMODE_AddEnd,                    
         EDITMODE_AddStart,                  
         EDITMODE_InsertVertex,              
         EDITMODE_DragVertex,                
         EDITMODE_DeleteVertex,              
         EDITMODE_Move                       
         };

      explicit TOOL_POLYLINE (
         TOOLCANVAS *canvas,                 
         bool AllowMulti = false             
         );

      typedef fastdelegate::FastDelegate<bool(CHANGESEQ, EDITMODE, DPOINT3D&)> DELEGATE_ONSETVERTEX;
      typedef fastdelegate::FastDelegate<bool(POLYLINE&)> DELEGATE_ONVERTICESCHANGED;

      virtual ~TOOL_POLYLINE ();

      const POLYLINE& GetActiveLine (
         ) const { return (*m_pActiveLine); }

      EDITMODE GetEditMode (
         ) const { return (m_EditMode); }

      const POLYLINELIST& GetLineList (
         ) const { return (m_LineList); }

      int GetNumLines (
         ) const { return (m_LineList.GetNumItems()); }

      bool IsActiveValid (
         ) const { return (m_pActiveLine != 0); }

      bool IsClosed (
         ) const { return (m_IsClosed); }

      void LockEndPoint (
         bool locked = true                  
         );

      void LockStartPoint (
         bool locked = true                  
         );

      void SetClosed (
         bool closed = true
         );

      void SetDelegateOnSetVertex (
         DELEGATE_ONSETVERTEX delegate
         ) { m_DelegateOnSetVertex = delegate; }

      void SetDelegateOnVerticesChanged (
         DELEGATE_ONVERTICESCHANGED delegate
         ) { m_DelegateOnVerticesChanged = delegate; }
      
      void SetDrawMode (
         DRAWMODE DrawMode                   
         );

      void SetEditMode (
         EDITMODE EditMode                   
         );

      void SetFilterDistance (
         double distance
         );

      void SetLine (
         const POLYLINE& polyline            
         );

      void SetLineList (
         const POLYLINELIST& LineList        
         );

      void SetMarkerColors (
         PENCOLOR startcolor,                
         PENCOLOR endcolor                   
         );

      void SetMarkers (
         MARKER startmarker,                 
         MARKER endmarker,                   
         UINT16 startmarkersize = 0,         
         UINT16 endmarkersize = 0            
         );

      void UpdateActiveLine (
         const POLYLINE& polyline            
         );

   private:
      #ifndef GENERATING_DOXYGEN_OUTPUT

      enum ZONE {
         ZONE_NoFunction = 0,
         ZONE_Outside,
         ZONE_Vertex,
         ZONE_Segment,
         ZONE_StartVertex
         };

      // Tool settings
      bool m_AllowMulti;
      bool m_IsClosed;
      bool m_LockStart;
      bool m_LockEnd;
      bool m_ShowPrefiltered;
      MARKER m_startmarker;
      MARKER m_endmarker;
      UINT16 m_startmarkersize;
      UINT16 m_endmarkersize;
      PENCOLOR m_startmarkercolor;              // Starting point marker color setting
      PENCOLOR m_endmarkercolor;                // Ending point marker color setting
      EDITMODE m_EditMode;
      // Tool position values
      POLYLINELIST m_LineList;
      POLYLINE *m_pActiveLine;               // Pointer to active line
      // Values used during interaction
      ZONE m_CursorZone;                  // Current cursor zone
      DPOINT3D m_prevpt;                  // Previous point during button-down
      double m_MaxZoneDist;               // Maximum distance to use when searching for a non outside zone
      double m_MaxVertexDist;             // Maximum distance to use when searching for a vertex zone
      double m_FilterDistance;            // Distance in pixel units for filter
      int m_ActivePoint;
      bool m_RubberBand;
      bool m_AutoEditMode;
      INT32 m_CurVertexNum;
      INT32 m_BeginVertexNum;             // Vertex in active line corresponding to start of last drawn section
      INT32 m_EndVertexNum;               // Vertex in active line corresponding to end of last drawn section
      ZONE m_CurCursorZone;
      POLYLINE m_LastDrawnSection;           // Last drawn section in continuous tracing mode
      TRANS2D_AFFINE m_TransToolToLastDrawn; // Transformation from tool to last drawn section coordinates

      // Delegates for TOOL_POLYLINE specific operations
      DELEGATE_ONSETVERTEX m_DelegateOnSetVertex;
      DELEGATE_ONVERTICESCHANGED m_DelegateOnVerticesChanged;
      
      // Manual Line Vertex Entry form forward declaration
      class MANUAL_POLYLINE;
      friend class MANUAL_POLYLINE;
      class FORM_POLYLINE;
      FORM_POLYLINE* m_pFormPolyLine;

      // Methods
      void AddLineIfNoActive ();
      void AddPoint (const DPOINT3D&, EDITMODE);
      void AdjustTool (DPOINT3D&, CHANGESEQ, KEYSTATE);
      bool CloseLine ();
      void ComputeCursorZone (const DPOINT2D&, bool showmarker);
      void DeletePoint (int);
      void DeletePoints (MGUI::POINT devpt);
      void DrawLastDrawnSection ();
      void DrawMarkerCursor (const DPOINT3D& markpt);
      void DrawMarkerEnd ();
      void DrawMarkerStart ();
      void DrawNeighborSegments (const LRECT2D& rectCanvas, bool SkipActive=true, int SkipSegment1=-2, int SkipSegment2=-2);
      void DrawNeighborSegments (const DRECT2D& rectTool, const POLYLINE& plTool, int SkipSegment1=-2, int SkipSegment2=-2);
      void DrawSegment (const POLYLINE&, int);
      void DrawSegment (int, bool);
      void DrawSingleLine (const POLYLINE&);
      void EraseLine ();
      void EraseMarkerCursor ();
      void EraseMarkerEnd (bool DrawSegment, bool RestoreActiveLineEnds);
      void EraseMarkerStart (bool DrawSegment, bool RestoreActiveLineEnds);
      void ErasePoint (int);
      void EraseSegment (int);
      void FilterVertices (bool FirstTime);
      void InsertPoint (int, const DPOINT3D&, UINT32);
      void MovePoint (int PointIndex, const DPOINT3D&, UINT32);
      bool PrefilterVertices (POLYLINE& PolyLine) const;
      void ResetLastDrawnSection (bool UpdateDisplay);
      bool SelectNextLine (bool SelectNext);
      void UpdateCursor () const;

      // TOOL_BASE overrides.
      virtual MGUI::FORM* v_CreateControlForm (LAYOUT_PANE_BASE& ParentPane, CTRLOPT ctrlopt);
      virtual MANUAL_BASE* v_CreateManualBase ();
      virtual void v_DoDraw ();
      virtual int v_GenerateRegion (REGION2D& region) const;
      virtual void v_OnClear ();
      virtual bool v_OnKey (MGUI::POINT point, KEYCODE keycode, KEYSTATE keystate);
      virtual bool v_OnPointerButtonDown (MGUI::POINT point, POINTERBUTTON button, KEYSTATE keystate);
      virtual bool v_OnPointerButtonUp (MGUI::POINT point, POINTERBUTTON button, KEYSTATE keystate);
      virtual void v_OnPointerMove (MGUI::POINT point, POINTERBUTTON button, KEYSTATE keystate);
      virtual void v_OnPointerLeave ();
      virtual void v_OnSet3D ();
      virtual void v_OnSetTransToWindow ();

      // TOOL_GPS overrides.
      virtual void v_OnGPSCoordinate (const DPOINT3D& point);
      #endif // GENERATING_DOXYGEN_OUTPUT
   };

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

}  // End namespace MGUI

#endif   // INC_MGUI_TOOLPOLYLINE_H

---