include/wx/motif/dcclient.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        dcclient.h
   3 // Purpose:     wxClientDC, wxPaintDC and wxWindowDC classes
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     17/09/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_DCCLIENT_H_
  13 #define _WX_DCCLIENT_H_
  14
  15 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  16 #pragma interface "dcclient.h"
  17 #endif
  18
  19 #include "wx/dc.h"
  20
  21 // ----------------------------------------------------------------------------
  22 // fwd declarations
  23 // ----------------------------------------------------------------------------
  24
  25 class WXDLLEXPORT wxWindowDC;
  26 class WXDLLEXPORT wxWindow;
  27
  28 // Under Windows, wxClientDC, wxPaintDC and wxWindowDC are implemented
  29 // differently. On many platforms, however, they will be the same.
  30
  31 //-----------------------------------------------------------------------------
  32 // wxWindowDC
  33 //-----------------------------------------------------------------------------
  34
  35 class WXDLLEXPORT wxWindowDC : public wxDC
  36 {
  37     DECLARE_DYNAMIC_CLASS(wxWindowDC)
  38
  39 public:
  40     wxWindowDC();
  41     wxWindowDC( wxWindow *win );
  42
  43     ~wxWindowDC();
  44
  45     // TODO this function is Motif-only for now - should it go into base class?
  46     void Clear(const wxRect& rect);
  47
  48     // implement base class pure virtuals
  49     // ----------------------------------
  50
  51     virtual void Clear();
  52
  53     virtual void SetFont(const wxFont& font);
  54     virtual void SetPen(const wxPen& pen);
  55     virtual void SetBrush(const wxBrush& brush);
  56     virtual void SetBackground(const wxBrush& brush);
  57     virtual void SetBackgroundMode(int mode);
  58     virtual void SetPalette(const wxPalette& palette);
  59     virtual void SetLogicalFunction( int function );
  60
  61     virtual void SetTextForeground(const wxColour& colour);
  62     virtual void SetTextBackground(const wxColour& colour);
  63
  64     virtual wxCoord GetCharHeight() const;
  65     virtual wxCoord GetCharWidth() const;
  66     virtual void DoGetTextExtent(const wxString& string,
  67         wxCoord *x, wxCoord *y,
  68         wxCoord *descent = NULL,
  69         wxCoord *externalLeading = NULL,
  70         wxFont *theFont = NULL) const;
  71
  72     virtual bool CanDrawBitmap() const;
  73     virtual bool CanGetTextExtent() const;
  74
  75     virtual int GetDepth() const;
  76     virtual wxSize GetPPI() const;
  77
  78     virtual void DestroyClippingRegion();
  79
  80     // Helper function for setting clipping
  81     void SetDCClipping(WXRegion region);
  82
  83     // implementation from now on
  84     // --------------------------
  85
  86     WXGC GetGC() const { return m_gc; }
  87     WXGC GetBackingGC() const { return m_gcBacking; }
  88     WXDisplay* GetDisplay() const { return m_display; }
  89     bool GetAutoSetting() const { return m_autoSetting; }
  90     void SetAutoSetting(bool flag) { m_autoSetting = flag; }
  91
  92 protected:
  93     // note that this function will call colour.SetPixel,
  94     // and will do one of curCol = colour, curCol = wxWHITE, curCol = wxBLACK
  95     // roundToWhite has an effect for monochrome display only
  96     // if roundToWhite == true then the colour will be set to white unless
  97     // it is RGB 0x000000;if roundToWhite == true the colour wull be set to
  98     // black unless it id RGB 0xffffff
  99     int CalculatePixel(wxColour& colour, wxColour& curCol,
 100                        bool roundToWhite) const;
 101     // sets the foreground pixel taking into account the
 102     // currently selected logical operation
 103     void SetForegroundPixelWithLogicalFunction(int pixel);
 104
 105     virtual bool DoFloodFill(wxCoord x, wxCoord y, const wxColour& col,
 106         int style = wxFLOOD_SURFACE);
 107
 108     virtual bool DoGetPixel(wxCoord x, wxCoord y, wxColour *col) const;
 109
 110     virtual void DoDrawPoint(wxCoord x, wxCoord y);
 111     virtual void DoDrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2);
 112
 113     virtual void DoDrawArc(wxCoord x1, wxCoord y1,
 114         wxCoord x2, wxCoord y2,
 115         wxCoord xc, wxCoord yc);
 116     virtual void DoDrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h,
 117         double sa, double ea);
 118
 119     virtual void DoDrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
 120     virtual void DoDrawRoundedRectangle(wxCoord x, wxCoord y,
 121         wxCoord width, wxCoord height,
 122         double radius);
 123     virtual void DoDrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
 124
 125     virtual void DoCrossHair(wxCoord x, wxCoord y);
 126
 127     virtual void DoDrawText(const wxString& text, wxCoord x, wxCoord y);
 128     virtual void DoDrawRotatedText(const wxString &text, wxCoord x, wxCoord y, double angle);
 129
 130     virtual bool DoBlit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height,
 131         wxDC *source, wxCoord xsrc, wxCoord ysrc,
 132         int rop = wxCOPY, bool useMask = false, wxCoord xsrcMask = -1, wxCoord ysrcMask = -1);
 133
 134     virtual void DoSetClippingRegionAsRegion(const wxRegion& region);
 135     virtual void DoSetClippingRegion(wxCoord x, wxCoord y,
 136         wxCoord width, wxCoord height);
 137
 138     virtual void DoDrawLines(int n, wxPoint points[],
 139         wxCoord xoffset, wxCoord yoffset);
 140     virtual void DoDrawPolygon(int n, wxPoint points[],
 141         wxCoord xoffset, wxCoord yoffset,
 142         int fillStyle = wxODDEVEN_RULE);
 143
 144     void DoGetSize( int *width, int *height ) const;
 145
 146     // common part of constructors
 147     void Init();
 148
 149     WXGC         m_gc;
 150     WXGC         m_gcBacking;
 151     WXDisplay*   m_display;
 152     wxWindow*    m_window;
 153     // Pixmap for drawing on
 154     WXPixmap     m_pixmap;
 155     // Last clipping region set on th GC, this is the combination
 156     // of paint clipping region and all user-defined clipping regions
 157     WXRegion     m_clipRegion;
 158
 159     // Not sure if we'll need all of these
 160     int          m_backgroundPixel;
 161     wxColour     m_currentColour;
 162     int          m_currentPenWidth ;
 163     int          m_currentPenJoin ;
 164     int          m_currentPenCap ;
 165     int          m_currentPenDashCount ;
 166     wxX11Dash*   m_currentPenDash ;
 167     wxBitmap     m_currentStipple ;
 168     int          m_currentStyle ;
 169     int          m_currentFill ;
 170     int          m_autoSetting ; // See comment in dcclient.cpp
 171     WXFont       m_oldFont;
 172 };
 173
 174 class WXDLLEXPORT wxPaintDC: public wxWindowDC
 175 {
 176     DECLARE_DYNAMIC_CLASS(wxPaintDC)
 177
 178 public:
 179     wxPaintDC() { }
 180     wxPaintDC(wxWindow* win);
 181
 182     ~wxPaintDC();
 183 };
 184
 185 class WXDLLEXPORT wxClientDC: public wxWindowDC
 186 {
 187     DECLARE_DYNAMIC_CLASS(wxClientDC)
 188
 189 public:
 190     wxClientDC() { }
 191     wxClientDC(wxWindow* win) : wxWindowDC(win) { }
 192 };
 193
 194 #endif
 195 // _WX_DCCLIENT_H_