include/wx/msw/dc.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        dc.h
   3 // Purpose:     wxDC class
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_DC_H_
  13 #define _WX_DC_H_
  14
  15 #ifdef __GNUG__
  16     #pragma interface "dc.h"
  17 #endif
  18
  19 #include "wx/defs.h"
  20 #include "wx/dc.h"
  21
  22 // ---------------------------------------------------------------------------
  23 // macros
  24 // ---------------------------------------------------------------------------
  25
  26 #if wxUSE_DC_CACHEING
  27 /*
  28  * Cached blitting, maintaining a cache
  29  * of bitmaps required for transparent blitting
  30  * instead of constant creation/deletion
  31  */
  32
  33 class wxDCCacheEntry: public wxObject
  34 {
  35 public:
  36     wxDCCacheEntry(WXHBITMAP hBitmap, int w, int h, int depth);
  37     wxDCCacheEntry(WXHDC hDC, int depth);
  38     ~wxDCCacheEntry();
  39
  40     WXHBITMAP   m_bitmap;
  41     WXHDC       m_dc;
  42     int         m_width;
  43     int         m_height;
  44     int         m_depth;
  45 };
  46 #endif
  47
  48 class WXDLLEXPORT wxDC : public wxDCBase
  49 {
  50 public:
  51     wxDC();
  52     ~wxDC();
  53
  54     // implement base class pure virtuals
  55     // ----------------------------------
  56
  57     virtual void Clear();
  58
  59     virtual bool StartDoc(const wxString& message);
  60     virtual void EndDoc();
  61
  62     virtual void StartPage();
  63     virtual void EndPage();
  64
  65     virtual void SetFont(const wxFont& font);
  66     virtual void SetPen(const wxPen& pen);
  67     virtual void SetBrush(const wxBrush& brush);
  68     virtual void SetBackground(const wxBrush& brush);
  69     virtual void SetBackgroundMode(int mode);
  70 #if wxUSE_PALETTE
  71     virtual void SetPalette(const wxPalette& palette);
  72 #endif // wxUSE_PALETTE
  73
  74     virtual void DestroyClippingRegion();
  75
  76     virtual wxCoord GetCharHeight() const;
  77     virtual wxCoord GetCharWidth() const;
  78     virtual void DoGetTextExtent(const wxString& string,
  79                                  wxCoord *x, wxCoord *y,
  80                                  wxCoord *descent = NULL,
  81                                  wxCoord *externalLeading = NULL,
  82                                  wxFont *theFont = NULL) const;
  83
  84     virtual bool CanDrawBitmap() const;
  85     virtual bool CanGetTextExtent() const;
  86     virtual int GetDepth() const;
  87     virtual wxSize GetPPI() const;
  88
  89     virtual void SetMapMode(int mode);
  90     virtual void SetUserScale(double x, double y);
  91     virtual void SetSystemScale(double x, double y);
  92     virtual void SetLogicalScale(double x, double y);
  93     virtual void SetLogicalOrigin(wxCoord x, wxCoord y);
  94     virtual void SetDeviceOrigin(wxCoord x, wxCoord y);
  95     virtual void SetAxisOrientation(bool xLeftRight, bool yBottomUp);
  96     virtual void SetLogicalFunction(int function);
  97
  98     // implementation from now on
  99     // --------------------------
 100
 101     virtual void SetRop(WXHDC cdc);
 102     virtual void SelectOldObjects(WXHDC dc);
 103
 104     wxWindow *GetWindow() const { return m_canvas; }
 105     void SetWindow(wxWindow *win) { m_canvas = win; }
 106
 107     WXHDC GetHDC() const { return m_hDC; }
 108     void SetHDC(WXHDC dc, bool bOwnsDC = FALSE)
 109     {
 110         m_hDC = dc;
 111         m_bOwnsDC = bOwnsDC;
 112     }
 113
 114     const wxBitmap& GetSelectedBitmap() const { return m_selectedBitmap; }
 115     wxBitmap& GetSelectedBitmap() { return m_selectedBitmap; }
 116
 117     // update the internal clip box variables
 118     void UpdateClipBox();
 119
 120 #if wxUSE_DC_CACHEING
 121     static wxDCCacheEntry* FindBitmapInCache(WXHDC hDC, int w, int h);
 122     static wxDCCacheEntry* FindDCInCache(wxDCCacheEntry* notThis, WXHDC hDC);
 123
 124     static void AddToBitmapCache(wxDCCacheEntry* entry);
 125     static void AddToDCCache(wxDCCacheEntry* entry);
 126     static void ClearCache();
 127 #endif
 128
 129 protected:
 130     virtual void DoFloodFill(wxCoord x, wxCoord y, const wxColour& col,
 131                              int style = wxFLOOD_SURFACE);
 132
 133     virtual bool DoGetPixel(wxCoord x, wxCoord y, wxColour *col) const;
 134
 135     virtual void DoDrawPoint(wxCoord x, wxCoord y);
 136     virtual void DoDrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2);
 137
 138     virtual void DoDrawArc(wxCoord x1, wxCoord y1,
 139                            wxCoord x2, wxCoord y2,
 140                            wxCoord xc, wxCoord yc);
 141     virtual void DoDrawCheckMark(wxCoord x, wxCoord y,
 142                                  wxCoord width, wxCoord height);
 143     virtual void DoDrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h,
 144                                    double sa, double ea);
 145
 146     virtual void DoDrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
 147     virtual void DoDrawRoundedRectangle(wxCoord x, wxCoord y,
 148                                         wxCoord width, wxCoord height,
 149                                         double radius);
 150     virtual void DoDrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
 151
 152     virtual void DoCrossHair(wxCoord x, wxCoord y);
 153
 154     virtual void DoDrawIcon(const wxIcon& icon, wxCoord x, wxCoord y);
 155     virtual void DoDrawBitmap(const wxBitmap &bmp, wxCoord x, wxCoord y,
 156                               bool useMask = FALSE);
 157
 158     virtual void DoDrawText(const wxString& text, wxCoord x, wxCoord y);
 159     virtual void DoDrawRotatedText(const wxString& text, wxCoord x, wxCoord y,
 160                                    double angle);
 161
 162     virtual bool DoBlit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height,
 163                         wxDC *source, wxCoord xsrc, wxCoord ysrc,
 164                         int rop = wxCOPY, bool useMask = FALSE, wxCoord xsrcMask = -1, wxCoord ysrcMask = -1);
 165
 166     // this is gnarly - we can't even call this function DoSetClippingRegion()
 167     // because of virtual function hiding
 168     virtual void DoSetClippingRegionAsRegion(const wxRegion& region);
 169     virtual void DoSetClippingRegion(wxCoord x, wxCoord y,
 170                                      wxCoord width, wxCoord height);
 171     virtual void DoGetClippingRegion(wxCoord *x, wxCoord *y,
 172                                      wxCoord *width, wxCoord *height)
 173     {
 174         GetClippingBox(x, y, width, height);
 175     }
 176
 177     virtual void DoGetSize(int *width, int *height) const;
 178     virtual void DoGetSizeMM(int* width, int* height) const;
 179
 180     virtual void DoDrawLines(int n, wxPoint points[],
 181                              wxCoord xoffset, wxCoord yoffset);
 182     virtual void DoDrawPolygon(int n, wxPoint points[],
 183                                wxCoord xoffset, wxCoord yoffset,
 184                                int fillStyle = wxODDEVEN_RULE);
 185
 186
 187     // common part of DoDrawText() and DoDrawRotatedText()
 188     void DrawAnyText(const wxString& text, wxCoord x, wxCoord y);
 189
 190     // common part of DoSetClippingRegion() and DoSetClippingRegionAsRegion()
 191     void SetClippingHrgn(WXHRGN hrgn);
 192
 193     // MSW-specific member variables
 194     // -----------------------------
 195
 196     // the window associated with this DC (may be NULL)
 197     wxWindow         *m_canvas;
 198
 199     wxBitmap          m_selectedBitmap;
 200
 201     // TRUE => DeleteDC() in dtor, FALSE => only ReleaseDC() it
 202     bool              m_bOwnsDC:1;
 203
 204     // our HDC
 205     WXHDC             m_hDC;
 206
 207     // Store all old GDI objects when do a SelectObject, so we can select them
 208     // back in (this unselecting user's objects) so we can safely delete the
 209     // DC.
 210     WXHBITMAP         m_oldBitmap;
 211     WXHPEN            m_oldPen;
 212     WXHBRUSH          m_oldBrush;
 213     WXHFONT           m_oldFont;
 214
 215 #if wxUSE_PALETTE
 216     WXHPALETTE        m_oldPalette;
 217 #endif // wxUSE_PALETTE
 218
 219 #if wxUSE_DC_CACHEING
 220     static wxList     sm_bitmapCache;
 221     static wxList     sm_dcCache;
 222 #endif
 223
 224     DECLARE_DYNAMIC_CLASS(wxDC)
 225 };
 226
 227 // ----------------------------------------------------------------------------
 228 // wxDCTemp: a wxDC which doesn't free the given HDC (used by wxWindows
 229 // only/mainly)
 230 // ----------------------------------------------------------------------------
 231
 232 class WXDLLEXPORT wxDCTemp : public wxDC
 233 {
 234 public:
 235     wxDCTemp(WXHDC hdc) { SetHDC(hdc); }
 236     virtual ~wxDCTemp() { SetHDC((WXHDC)NULL); }
 237 };
 238
 239 #endif
 240     // _WX_DC_H_