cansim.h

Go to the documentation of this file.

/*! \file wx/canvas/cansim.h
    \brief simple canvas which takes as view the whole of the scrollable area.   
    While a2dCanvas display and draws only what is visible, this a2dCanvasSim always
    draws all that will be scrollable. So scrolling is quick.

    \author Klaas Holwerda

    Copyright: 2001-2004 (C) Klaas Holwerda

    Licence: wxWidgets Licence

    RCS-ID: $Id: cansim.h,v 1.15 2008/07/19 18:29:43 titato Exp $
*/

#ifndef __A2DCANVASSIM_H__
#define __A2DCANVASSIM_H__

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

#include "wx/image.h"
#include "wx/txtstrm.h"
#include "wx/geometry.h"
#include "wx/canvas/candefs.h"
#include "wx/canvas/canobj.h"
#include "wx/artbase/bbox.h"
#include "wx/canvas/drawer.h"

//! Simple canvas using a whole view for all of the scrolled window
/*!
    This canvas use a wxScrolledWindow as basis.
    The a2dCanvasView used to draw has a buffer the size of the virtual scrollable area.
    The scrollable/virtual area is defined in pixels. The window show the part of the virtual area
    which is visible. One can scroll through the contents of the buffer, and the scroll bars show which
    part of the buffer is visble. 
    So the scrollable area calculated in world coordinates, defines the maximum boundaries of what can be seen 
    of the drawing in the associated a2dCanvasDocument. One can set the mapping matrixes which calculates 
    device to world coordinates and visa versa, but this does not influence the scrollbars, since the always 
    only show what part of the buffer is visible. Resizing a window, sets the drawing buffer to the new virtual 
    size of the scrolled window, but mapping from world to device coordinates stays the same.

    This is rather different from what is done in a2dCanvas, where the scrollable area is defined in 
    worldcoordinates, and zooming recalculates the scrollbar positions in such a manner that they indicate
    what part of the drawing is shown in the canvas window as compared to the total visible area.  

    \sa a2dCanvas
        a2dCanvasView
        a2dMemDcDrawer
        a2dCanvasDocument
        a2dCanvasObject

    \ingroup drawer docview
*/
class A2DCANVASDLLEXP a2dCanvasSim: public a2dDocumentViewScrolledWindow
{
public:

    //!constructor
    /*!
    construct a canvas window.

    Internal a a2dCanvasView and  a2dCanvasDocument are created
    to render all objects stored in the a2dCanvasDocument into this a2dCanvas window.

    The document and drawer or deleted in the destructor.


    \remark used for standalone a2dCanvas windows.

    \param parent parent window (use wxNO_FULL_REPAINT_ON_RESIZE on parent wxFrame)
    \param id window id
    \param pos position of window
    \param size size of window
    \param style type of window (wxHSCROLL|wxVSCROLL)

    \remark with new unknown drawer types you can derive or extend the library
    */
    a2dCanvasSim( wxWindow *parent, wxWindowID id = -1,
        const wxPoint& pos = wxDefaultPosition,
        const wxSize& size = wxDefaultSize,
        long style = wxScrolledWindowStyle );

    //!destructor
    /*!when a tool controller was set is will be deleted also.
    */
    virtual ~a2dCanvasSim();
    
    //! use the boundingbox of the ShowObject to set the mapping such that it will be displayed completely.
    /*!
        \param centre if true centre on window, else to (0,0) of device
    */
    void SetMappingShowAll( bool centre = true );
    
    //! what is the drawer
    a2dCanvasView* GetCanvasView() const { return wxStaticCastNull( m_view.Get(), a2dCanvasView ); }

    //! Get the drawer of the view
    a2dDrawer2D *GetDrawer2D() const { return GetCanvasView()->GetDrawer2D(); }

    //! Clears the canvas (like wxWindow::ClearBackground)
    /*!
     * Calls internally a2dCanvasSim::ClearBackground() 
     * Clear() was renamed in wxWin 2.5 to ClearBackground()
     *
     * \todo 
     * Remove this method after wxWin 2.6 release.
     */
    void ClearBackground();
    
    //!background fill for the canvas
    void SetBackgroundFill( const a2dFill& backgroundfill );

    //! Refresh window
    /*!
        Next to base class, makes sure all pending objects are processed, and scrolling is set right.
    */
    virtual void Refresh( bool eraseBackground = true, const wxRect* rect = NULL );

    //!Set grid setting for drawing grid in front or back
    void SetGridAtFront(bool gridatfront) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetGridAtFront(gridatfront); }

    //!Get grid setting for drawing grid in front or back
    bool GetGridAtFront() { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetGridAtFront(); }

    //!set stroke used for grid drawing
    void SetGridStroke( const a2dStroke& gridstroke) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetGridStroke(gridstroke); }

    //!set size of grid circle
    void SetGridSize( wxUint16 gridsize) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetGridSize(gridsize); }

    //!set brush used for grid drawing
    void SetGridFill( const a2dFill& gridfill) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetGridFill(gridfill); }

    //!Get grid distance in X
    double GetGridX() { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetGridX(); }

    //!Set grid distance in X
    void SetGridX(double gridx) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetGridX(gridx); }

    //!Get grid distance in Y
    double GetGridY() { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetGridY(); }

    //!Set grid distance in Y
    void SetGridY(double gridy) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetGridY(gridy); }

    //!Set grid on/off
    void SetGrid(bool grid) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetGrid(grid); }

    //!Get grid setting on/off
    bool GetGrid() { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetGrid(); }

    //!Get grid setting for line drawing
    void SetGridLines(bool gridlines) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetGridLines(gridlines); }

    //!set grid to draw lines instead of points
    bool GetGridLines() { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetGridLines(); }

    //!Set showorigin on/off
    void SetShowOrigin(bool show) { (wxStaticCast( m_view.Get(), a2dCanvasView ) )->SetShowOrigin(show); }

    //!set if the Yaxis goes up or down
    void SetYaxis(bool up);

    //!get currently used Yaxis setting
    bool GetYaxis() const;

    //! zoomout leafs a border of this amount of pixels around the drawing 
    void SetZoomOutBorder( wxUint16 border ) { m_border = border; }

    //!Returns if canvas is frozen.
    bool IsFrozen() { return m_frozen; }

    //!prevent changing the a2dCanvasView buffer and blitting it to the window
    /*! To make sure the contents displayed into the a2dCanvasView buffer does not change.
    Pending objects inside a root will be added to the update list of the a2dCanvasView,
    but not redrawn into the buffer until Thaw.
    */
    void Freeze();

    //!allow a2dCanvasView buffer to be changed and blitting it to the window
    /*! Enable updating of the a2dCanvasView buffer contents.
    */
    void Thaw();

    //!get root group that is displayed on the canvas
    a2dCanvasDocument* GetCanvasDocument();

    //!Give the virtual size to be displayed, the mappingmatrix will be calculated.
    /*!
    The current window size in pixels is used to calculate the mapping such that
    at least it will display all of the area given.

    Setting virtual area to boundingbox of  a drawing (currently visible ShowObject()
     \code
     m_worldcanvas->SetMappingWidthHeight(m_worldcanvas->GetShowObject()->GetXMin(),
                               m_worldcanvas->GetShowObject()->GetYMin(),
                               m_worldcanvas->GetShowObject()->GetWidth(),
                               m_worldcanvas->GetShowObject()->GetHeight())
     \endcode

    \remark do not use during start up since window size is not well defined in that case resulting in
    \remark bad settings for the mapping.

    \param vx1 minimum world x coordinate
    \param vy1 minimum world y coordiante ( either Lower or Upper Left corner depending on SetYaxis() )
    \param width minimum width in world coordinates which we want to display on this window
    \param height minimum height in world coordinates which we want to display on this window
    */
    void SetMappingWidthHeight( double vx1, double vy1, double width, double height );

    //!Give the virtual size to be displayed, the mappingmatrix will be calculated.
    /*!
        To display all of a drawing, set this here to the boundingbox of the show object
        of the canvas.
        So vx1 and vx2 to the miminum x and y of the boundingbox.
        Calculate xpp and ypp in such a manner that it will show the whole drawing.

        Setting virtual area to boundingbox of  a drawing (currently visible group)

        \code
            int dx2,dy2;
            m_canvas->GetClientSize(&dx2,&dy2);
            double xupp=(m_canvas->GetShowObject()->GetWidth())/dx2;
            double yupp=(m_canvas->GetShowObject()->GetHeight())/dy2;
            if (yupp > xupp)
             xupp=yupp;
            m_worldcanvas->SetMappingUpp(m_worldcanvas->GetShowObject->GetXMin(),
                                   m_worldcanvas->GetShowObject->GetYMin(),xupp,xupp);
        \endcode

        If a scrollable area is set, it will be called also to adjust it.
        \param vx1 minimum world x coordinate
        \param vy1 minimum world y coordiante ( either Lower or Upper Left corner depending on SetYaxis() )
        \param xpp: Number of world units per pixel in x
        \param ypp: Number of world units per pixel in y
    */
    void SetMappingUpp( double vx1, double vy1, double xpp, double ypp);

    //!convert x from window to virtual coordinates
    inline double DeviceToWorldX(int x) const { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetDrawer2D()->DeviceToWorldX(x); }
    //!convert y from window to virtual coordinates
    inline double DeviceToWorldY(int y) const { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetDrawer2D()->DeviceToWorldY(y); }
    //!convert x relative from window to virtual coordinates
    //!use this to convert a Length of a line for instance
    inline double DeviceToWorldXRel(int x) const { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetDrawer2D()->DeviceToWorldXRel(x); }
    //!convert y relative from window to virtual coordinates
    //!use this to convert a Length of a line for instance
    inline double DeviceToWorldYRel(int y) const  { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetDrawer2D()->DeviceToWorldYRel(y); }

    //!convert x from virtual to window coordinates
    inline int WorldToDeviceX(double x) const { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetDrawer2D()->WorldToDeviceX(x); }
    //!convert y from virtual to window coordinates
    inline int WorldToDeviceY(double y) const { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetDrawer2D()->WorldToDeviceY(y); }
    //!convert x relative from virtual to window coordinates
    //!use this to convert a Length of a line for instance
    inline int WorldToDeviceXRel(double x) const { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetDrawer2D()->WorldToDeviceXRel(x); }
    //!convert y relative from virtual to window coordinates
    //!use this to convert a Length of a line for instance
    inline int WorldToDeviceYRel(double y) const { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetDrawer2D()->WorldToDeviceYRel(y); }

    //!set object available in the a2dCanvasDocument to be shown on the canvas
    //!\param name: name of top object
    //!\return pointer to the object found else NULL
    a2dCanvasObject* SetShowObject(const wxString& name);

    //!set top object available in the a2dCanvasDocument to be shown on the canvas
    //!\param obj: pointer to object to show
    bool SetShowObject(a2dCanvasObject* obj);

    //!return pointer of then currently shown object on the canvas.
    //!\return pointer to the current object that is shown.
    a2dCanvasObject* GetShowObject() const { return (wxStaticCast( m_view.Get(), a2dCanvasView ) )->GetShowObject(); }

    //!do a hittest on the canvas at coordinates x,y
    /*!
    \param x: x of point to do hittest
    \param y: y of point to do hittest
    \param layer only if object is on this layer or if set to wxLAYER_ALL ignore layer id.
    \param option special hittest options
    \return the top object that was hit (e.g.in case of groups)

    \remark hit margin is defined in a2dCanvasDocument containing the root group
    */
    a2dCanvasObject* IsHitWorld(
        double x, double y,
        int layer = wxLAYER_ALL,
        a2dHitOption option = a2dCANOBJHITOPTION_NOROOT | a2dCANOBJHITOPTION_LAYERS
    );

    //!Mouse events are handled by the canvas.
    //!They are redirected to the object hit.
    //!You can switch this off here, used in most tools.
    void SetMouseEvents(bool onoff);

    bool GetMouseEvents();

    //! write what you see to an SVG( scalable vector graphics file )
    bool WriteSVG(const wxString& filename, double Width, double Height, wxString unit);

protected:

    //! resize, adjusting buffer of a2dCanvasView if needed.
    void OnSize( wxSizeEvent &event );

    //! repaint damaged araes, taking into acount non updated araes in a2dCanvasView.
    void OnPaint( wxPaintEvent &event );

    //! Not yet implemented
    void OnEraseBackground( wxEraseEvent &event );

    //! remove all pending update areas in a2dCanvasView
    void DeleteAllPendingAreas();

private:

    //!oversize of buffer compared to screen width and height
    int m_delta;

    //!prevent updating activity if true
    bool m_frozen;

    //! to check if drawer document was changed
    a2dCanvasDocument* m_doc;

    //! border zoomout but leaf around a border of this amount of pixels. 
    wxUint16 m_border;

    DECLARE_CLASS(a2dCanvasSim)
    DECLARE_EVENT_TABLE()

};

#endif
// A2DCANVAS

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