mastertool.h

Go to the documentation of this file.

/*! \file wx/editor/mastertool.h
    \brief master tools are tools on top of other tools.

    Often it is easier to use a tool which only task is to push other tools onto the tool stack.
    That way a tool can be designed for one task, while the mastertool does define when which
    tools becomes active.

    \author Michael Sögtrop
    \date Created 02/06/2004

    Copyright: 2004-2004 (c) Michael Sögtrop

    Licence: wxWidgets Licence

    RCS-ID: $Id: mastertool.h,v 1.13 2009/04/23 19:35:23 titato Exp $
*/

// This file contains master tools. This are tools that customize GUI behaviour
// by intercepting events and then deligating work to other tools

#ifndef __A2DCANVASMASTERTOOL_H__
#define __A2DCANVASMASTERTOOL_H__


#ifndef WX_PRECOMP
    #include "wx/wx.h"
#endif

#include "wx/canvas/canmod.h"
#include "wx/editor/sttool.h"
#include "wx/editor/edit.h"

//!Master tool for objects+wires graphics
/*!This tool controls other tools such that simple objects+wires graphics
can be edited without manually changing tools.

- When dragging in an empty area, the select tool (with drag box) shall be used

- When clicking on a pin, or an object that can create a dynamic pin at the mouse position the draw wire tool shall be used

- When dragging an existing object, the drag tool shall be used. If multiple object are selected, the drag-multi tool shall be used

- When dragging a wire edge, call a simple wire editing tool, that moves the edge (without first selecting it in edit mode and without showing handles)

- When dragging a vertical/horizontal wire segment, call a simple tool that moves the segment

- When dragging a diagonal wire segment, insert a new point in the segment

\ingroup  tools
*/
class A2DEDITORDLLEXP a2dGraphicsMasterTool: public a2dStTool
{
public:

    a2dGraphicsMasterTool(a2dStToolContr* controller);
    ~a2dGraphicsMasterTool();

protected:
    virtual void PushSelectTool();
    virtual void PushDrawWireTool( a2dCanvasObject *hit );
    virtual void PushDragTool( a2dCanvasObject *hit );
    virtual void PushDragMultiTool( a2dCanvasObject *hit );
    virtual void PushCopyTool( a2dCanvasObject *hit );
    virtual void PushCopyMultiTool( a2dCanvasObject *hit );
    virtual void PushEditWireVertexTool( a2dCanvasObject *hit, int vertex );
    virtual void PushEditWireSegmentHorizontalTool( a2dCanvasObject *hit, int segment );
    virtual void PushEditWireSegmentVerticalTool( a2dCanvasObject *hit, int segment );
    virtual void PushEditWireSegmentInsertTool( a2dCanvasObject *hit, int segment );

protected:
    void DeselectAll();
    virtual bool ZoomSave();
    virtual void DoStopTool( bool abort );

    void OnChar(wxKeyEvent& event);

    void OnMouseEvent(wxMouseEvent& event);

    void OnKeyDown(wxKeyEvent& event);

    void SelectHitObject( a2dCanvasObject *hit );

public:
    DECLARE_CLASS(a2dGraphicsMasterTool)
    A2D_DECLARE_EVENT_TABLE()

protected:
    // the editing mode derived from the object under the cursor
    enum Mode {
        mode_none,      // no mode
        mode_select,    // select via drag box mode
        mode_drag,      // drag object mode
        mode_dragmulti, // drag selected (multiple) objects mode
        mode_copy,      // drag-copy object mode
        mode_copymulti, // drag-copy selected (multiple) objects mode
        mode_drawwire,  // draw wire mode
        mode_editwire_segmenthorizontal, // wire editing mode: horizontal segment shift
        mode_editwire_segmentvertical,   // wire editing mode: horizontal segment shift
        mode_editwire_segmentinsert,     // wire editing mode: horizontal segment shift
        mode_editwire_vertex,            // wire editing mode: horizontal segment shift
    } m_mode;
    // the object, that was responsible for setting m_mode to what it is
    a2dCanvasObject *m_modehit;
    // the hit information for m_modehit
    a2dHit m_modehitinfo;
};

//!Simple (handle-less) wire editing tool intended as sub-tool for master tools
/*!This tool supports the following actions:

- Dragging a wire edge

- Dragging a vertical/horizontal wire segment: move the segment

- Dragging a diagonal wire segment: insert a new point in the segment

- Dragging a vertex onto another vertex: delete vertex

\ingroup  tools
*/
class A2DEDITORDLLEXP a2dSimpleEditPolygonTool: public a2dStTool
{
public:
    enum Action
    {
        action_movevertex,
        action_movesegment,
        action_insertvertex
    };

public:
    a2dSimpleEditPolygonTool( a2dStToolContr* controller, a2dCanvasObject *hit, int index, int count, Action action );
    ~a2dSimpleEditPolygonTool();

protected:
    virtual bool EnterBusyMode();
    virtual void FinishBusyMode();
    virtual void AbortBusyMode();
    virtual void DoStopTool( bool abort );
    virtual bool ZoomSave(){ return true;};
    virtual wxString GetCommandGroupName() { return _("Edit polygon" ); }

    void OnChar(wxKeyEvent& event);
    void OnMouseEvent(wxMouseEvent& event);

    virtual bool CreateToolObjects();
    virtual void CleanupToolObjects();

public:
    DECLARE_CLASS(a2dSimpleEditPolygonTool)
    A2D_DECLARE_EVENT_TABLE()

protected:
    //! Index of vertex / segment, that is edited
    int m_index;

    //! Number of vertices
    int m_count;

    //! what to edit (vertex, segment, ...)
    Action m_action;

    //! this is used to simulate a handle attached to the object,
    //! by adding 
    a2dSmrtPtr< a2dPolyHandleL > m_handle;

    //! preserve the a2dCANVAS_SELECT flag after editing.
    /*! selection is cleared in a2dCanvasObject::StartEdit */
    bool m_preserve_select;

    //! list of connected wire objects
    a2dCanvasObjectList m_connectedwirecopies;
};



//!Draw Master tool for object graphics
/*!This tool controls other tools such that simple objects graphics
can be edited without manually changing tools. It does this by pushing othere tools on the tool stack when the situation ask for. 

- When dragging in an empty area, the select tool (with drag box) shall be used

- When dragging an existing object, the drag tool shall be used. If multiple object are selected, the drag-multi tool shall be used


\ingroup  tools
*/



class A2DEDITORDLLEXP a2dToolProperty;


//! property to hold a a2dBaseTool pointer type variable to be associated with a a2dBaseTool
/*!

    \ingroup property 

*/
class A2DEDITORDLLEXP a2dToolProperty: public a2dDynamicEventProperty
{

public:

    a2dToolProperty();

    a2dToolProperty( const a2dPropertyIdDynamicEventProperty* id, a2dBaseTool* tool, wxMenuItem* menuItem, wxChar key );

    a2dToolProperty( const a2dToolProperty &other );

    virtual ~a2dToolProperty();

    a2dNamedProperty* Clone( a2dObject::CloneOptions options ) const;

    virtual void Assign( const a2dNamedProperty &other );

    inline a2dBaseTool* GetToolObject() { return m_tool; }

    wxMenuItem* GetMenuItem() { return m_menuItem; }

    wxChar GetKey() { return m_key; }

    DECLARE_DYNAMIC_CLASS(a2dToolProperty)

    //! Construct a new property object from a string
    //! If this is not appropriate, this may return NULL
    static a2dToolProperty *CreatePropertyFromString( const a2dPropertyIdDynamicEventProperty& WXUNUSED(id), const wxString& WXUNUSED(value) ) { return 0; }

protected:

    a2dBaseToolPtr m_tool;

    wxMenuItem* m_menuItem;

    wxChar m_key;

#if wxART2D_USE_CVGIO
    virtual void DoSave( wxObject* parent, a2dIOHandlerXmlSerOut &out, a2dXmlSer_flag xmlparts , a2dObjectList* towrite );
    virtual void DoLoad( wxObject* parent, a2dIOHandlerXmlSerIn& parser, a2dXmlSer_flag xmlparts );
#endif //wxART2D_USE_CVGIO

};


//!Master tool for sub drawing child objects in a2dCanvasObject
/*!

\ingroup  tools
*/
class A2DEDITORDLLEXP a2dSubDrawMasterTool: public a2dStTool
{

public:
    static const a2dPropertyIdDynamicEventProperty PROPID_toolMenu;

    a2dSubDrawMasterTool(a2dStToolContr* controller = NULL );

    ~a2dSubDrawMasterTool();

    void AppendTool( a2dBaseTool* tool, wxMenuItem* menuItem, wxChar key );

    void OnPostPushTool();

    void PushToolFromMouseMenu(  wxCommandEvent& event );

protected:

    virtual bool ZoomSave();
    virtual void DoStopTool( bool abort );

    void OnChar(wxKeyEvent& event);

    void OnMouseEvent(wxMouseEvent& event);

    a2dSmrtPtr< a2dBaseTool > m_curTool;


public:
    DECLARE_DYNAMIC_CLASS(a2dSubDrawMasterTool)
    A2D_DECLARE_EVENT_TABLE()

protected:
};



//----------------------------------------------------------------------------
// a2dMasterDrawBase
//----------------------------------------------------------------------------

//! common stuff for several master tools
/*!
    - Pushing tools used form derived master tools.
    - Cursor hints 
*/
class A2DEDITORDLLEXP a2dMasterDrawBase: public a2dStTool
{
public:

    //! constructor
    a2dMasterDrawBase(a2dStToolContr* controller);
    //! destructor
    ~a2dMasterDrawBase();

    //! tools using inverse drawing will be used.
    void SetFastTools( bool onOff ) { m_fastTools = onOff; }

    //! tools using inverse drawing will be used.
    bool GetFastTools() { return m_fastTools; }

    //! if set true, Double Click on N selected objects, leads to editing them as a group 
    void SetAllowMultiEdit( bool onOff ) { m_allowMultiEdit = onOff; }

    //! if true, Double Click on N selected objects, leads to editing them as a group 
    bool GetAllowMultiEdit() { return m_allowMultiEdit; }
    
    //!set select fill 
    void SetSelectFill( const a2dFill& fill){ m_selectFill = fill; }

    //!get the select fill
    /*!
        Return the select fill 
    */
    const a2dFill& GetSelectFill() const { return m_selectFill; }

    //!set select stroke
    void SetSelectStroke( const a2dStroke& stroke) { m_selectStroke = stroke; }

    //!get the select stroke
    /*!
        Return the select stroke 
    */
    const a2dStroke& GetSelectStroke() const { return m_selectStroke; }


protected:
    virtual void PushZoomTool();
    virtual void PushSelectTool();
    virtual void PushDeSelectTool();
    virtual void PushDragTool( a2dCanvasObject *hit );
    virtual void PushDragMultiTool( a2dCanvasObject *hit );
    virtual void PushCopyTool( a2dCanvasObject *hit );
    virtual void PushCopyMultiTool( a2dCanvasObject *hit );
    virtual void PushEditTool( a2dCanvasObject *hit );
    virtual void PushMultiEditTool( a2dCanvasObject *hit );
    virtual void PushEditSegmentTool( a2dCanvasObject *hit, int segment );
    virtual void PushEditVertexTool( a2dCanvasObject *hit, int vertex );

protected:

    void SelectHitObject( a2dCanvasObject *hit );
    void DeselectAll();
    virtual bool ZoomSave();
    virtual void DoStopTool( bool abort );

    void OnChar(wxKeyEvent& event);

    void OnKeyDown(wxKeyEvent& event);
    void OnKeyUp(wxKeyEvent& event);

public:
    DECLARE_CLASS(a2dMasterDrawBase)
    A2D_DECLARE_EVENT_TABLE()

protected:

    // the editing mode derived from the object under the cursor
    enum Mode {
        mode_none,      // no mode
        mode_edit,      // edit object tool
        mode_multiedit, // edit all selected
        mode_zoom,      // zoom via drag box mode
        mode_select,    // select via drag box mode
        mode_cntrlselect,  // de first and select via drag box mode
        mode_deselect,  // de select via drag box mode
        mode_drag,      // drag object mode
        mode_dragmulti, // drag selected (multiple) objects mode
        mode_copy,      // drag-copy object mode
        mode_copymulti, // drag-copy selected (multiple) objects mode
        mode_segment,   // segment shift
        mode_vertex,    // vertex shift
        mode_zoomdrag,  // move view with mouse
    } m_mode;

    // the object, that was responsible for setting m_mode to what it is
    a2dCanvasObject *m_modehit;

    // the hit information for m_modehit
    a2dHit m_modehitinfo;

    bool m_spaceDown;

    bool m_toolBusy;
    bool m_modehitLastSelectState;

    bool m_fastTools;

    bool m_allowMultiEdit;

    a2dFill m_selectFill;
    a2dStroke m_selectStroke;
};


//!Master tool for objects graphics slecting and dragging nd zooming
/*!This tool controls other tools such that simple object graphics
can be edited without manually changing tools.

- Left Down + Drag => select objects in rectangle
- Left Down + Drag + Shift Down => select objects in rectangle add to already selected
- Left Down + Drag + Alt Down => move selected objects if allowed else editmode
- Left Down + Drag + Alt & Ctrl Down => copy selected objects if allowed else editmode
- Right Down => Drag canvas view
- Right Down + Up => Show Popup
- SpaceDown => Zoom area with mouse
- Double Click => Edit Selected of hit

\ingroup  tools
*/
class A2DEDITORDLLEXP a2dMasterDrawSelectFirst: public a2dMasterDrawBase
{
public:

    a2dMasterDrawSelectFirst(a2dStToolContr* controller);
    ~a2dMasterDrawSelectFirst();

protected:

    void OnChar(wxKeyEvent& event);

    void OnMouseEvent(wxMouseEvent& event);

    void OnKeyDown(wxKeyEvent& event);
    void OnKeyUp(wxKeyEvent& event);

    void SelectHitObject( a2dCanvasObject *hit );
    void DecideMode( a2dCanvasObject* hit, bool shift, bool control );

public:
    DECLARE_CLASS(a2dMasterDrawSelectFirst)
    A2D_DECLARE_EVENT_TABLE()
};

//!Master tool for objects graphics slecting and dragging nd zooming
/*!This tool controls other tools such that simple object graphics
can be edited without manually changing tools.

- Left Down + Drag => zoom to rectangle
- Left Down + Drag + Shift Down => select objects in rectangle add to already selected
- Left Down + Drag + Cntrl Down => select objects in rectangle deselect already selected first
- Left Down + Drag + Alt Down => move selected objects if allowed else editmode
- Left Down + Drag + Alt & Ctrl Down => copy selected objects if allowed else editmode
- Right Down => Drag canvas view
- Right Down + Up => Show Popup
- Double Click => Edit Selected of hit

\ingroup  tools
*/
class A2DEDITORDLLEXP a2dMasterDrawZoomFirst: public a2dMasterDrawBase
{
public:

    a2dMasterDrawZoomFirst(a2dStToolContr* controller);
    ~a2dMasterDrawZoomFirst();

protected:

    void OnChar(wxKeyEvent& event);

    void OnMouseEvent(wxMouseEvent& event);

    void OnKeyDown(wxKeyEvent& event);
    void OnKeyUp(wxKeyEvent& event);
    void Render();

public:
    DECLARE_CLASS(a2dMasterDrawZoomFirst)
    A2D_DECLARE_EVENT_TABLE()

};

#endif // __A2DCANVASMASTERTOOL_H__

mastertool.h Source File -- Tue Aug 31 17:56:33 2010 -- 31 Aug 2010 -- 1.5.5 -- wxArt2D -- . -- Reference Documentation