]>
Commit | Line | Data |
---|---|---|
2bda0e17 KB |
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$ | |
bbcdf8bc | 8 | // Copyright: (c) Julian Smart |
a23fd0e1 | 9 | // Licence: wxWindows licence |
2bda0e17 KB |
10 | ///////////////////////////////////////////////////////////////////////////// |
11 | ||
bbcdf8bc JS |
12 | #ifndef _WX_DC_H_ |
13 | #define _WX_DC_H_ | |
2bda0e17 KB |
14 | |
15 | #ifdef __GNUG__ | |
a23fd0e1 | 16 | #pragma interface "dc.h" |
2bda0e17 KB |
17 | #endif |
18 | ||
2662e49e RR |
19 | #include "wx/defs.h" |
20 | #include "wx/dc.h" | |
21 | ||
e6f1ad22 HH |
22 | // --------------------------------------------------------------------------- |
23 | // macros | |
24 | // --------------------------------------------------------------------------- | |
25 | ||
26 | // Logical to device | |
27 | // Absolute | |
28 | #define XLOG2DEV(x) (x) | |
29 | #define YLOG2DEV(y) (y) | |
30 | ||
31 | // Relative | |
32 | #define XLOG2DEVREL(x) (x) | |
33 | #define YLOG2DEVREL(y) (y) | |
34 | ||
35 | // Device to logical | |
36 | // Absolute | |
37 | #define XDEV2LOG(x) (x) | |
38 | ||
39 | #define YDEV2LOG(y) (y) | |
40 | ||
41 | // Relative | |
42 | #define XDEV2LOGREL(x) (x) | |
43 | #define YDEV2LOGREL(y) (y) | |
44 | ||
45 | /* | |
46 | * Have the same macros as for XView but not for every operation: | |
47 | * just for calculating window/viewport extent (a better way of scaling). | |
48 | */ | |
49 | ||
50 | // Logical to device | |
51 | // Absolute | |
52 | #define MS_XLOG2DEV(x) LogicalToDevice(x) | |
53 | ||
54 | #define MS_YLOG2DEV(y) LogicalToDevice(y) | |
55 | ||
56 | // Relative | |
57 | #define MS_XLOG2DEVREL(x) LogicalToDeviceXRel(x) | |
58 | #define MS_YLOG2DEVREL(y) LogicalToDeviceYRel(y) | |
59 | ||
60 | // Device to logical | |
61 | // Absolute | |
62 | #define MS_XDEV2LOG(x) DeviceToLogicalX(x) | |
63 | ||
64 | #define MS_YDEV2LOG(y) DeviceToLogicalY(y) | |
65 | ||
66 | // Relative | |
67 | #define MS_XDEV2LOGREL(x) DeviceToLogicalXRel(x) | |
68 | #define MS_YDEV2LOGREL(y) DeviceToLogicalYRel(y) | |
69 | ||
70 | #define YSCALE(y) (yorigin - (y)) | |
71 | ||
72 | #define wx_round(a) (int)((a)+.5) | |
73 | ||
0cbff120 JS |
74 | #if wxUSE_DC_CACHEING |
75 | /* | |
76 | * Cached blitting, maintaining a cache | |
77 | * of bitmaps required for transparent blitting | |
78 | * instead of constant creation/deletion | |
79 | */ | |
80 | ||
81 | class wxDCCacheEntry: public wxObject | |
82 | { | |
83 | public: | |
84 | wxDCCacheEntry(WXHBITMAP hBitmap, int w, int h, int depth); | |
85 | wxDCCacheEntry(WXHDC hDC, int depth); | |
86 | ~wxDCCacheEntry(); | |
87 | ||
88 | WXHBITMAP m_bitmap; | |
89 | WXHDC m_dc; | |
90 | int m_width; | |
91 | int m_height; | |
92 | int m_depth; | |
93 | }; | |
94 | #endif | |
95 | ||
a23fd0e1 | 96 | class WXDLLEXPORT wxDC : public wxDCBase |
2bda0e17 | 97 | { |
2bda0e17 | 98 | public: |
a23fd0e1 VZ |
99 | wxDC(); |
100 | ~wxDC(); | |
101 | ||
102 | // implement base class pure virtuals | |
103 | // ---------------------------------- | |
104 | ||
105 | virtual void Clear(); | |
106 | ||
107 | virtual bool StartDoc(const wxString& message); | |
108 | virtual void EndDoc(); | |
109 | ||
110 | virtual void StartPage(); | |
111 | virtual void EndPage(); | |
112 | ||
113 | virtual void SetFont(const wxFont& font); | |
114 | virtual void SetPen(const wxPen& pen); | |
115 | virtual void SetBrush(const wxBrush& brush); | |
116 | virtual void SetBackground(const wxBrush& brush); | |
117 | virtual void SetBackgroundMode(int mode); | |
118 | virtual void SetPalette(const wxPalette& palette); | |
119 | ||
120 | virtual void DestroyClippingRegion(); | |
121 | ||
72cdf4c9 VZ |
122 | virtual wxCoord GetCharHeight() const; |
123 | virtual wxCoord GetCharWidth() const; | |
124 | virtual void DoGetTextExtent(const wxString& string, | |
125 | wxCoord *x, wxCoord *y, | |
126 | wxCoord *descent = NULL, | |
127 | wxCoord *externalLeading = NULL, | |
128 | wxFont *theFont = NULL) const; | |
a23fd0e1 VZ |
129 | |
130 | virtual bool CanDrawBitmap() const; | |
131 | virtual bool CanGetTextExtent() const; | |
132 | virtual int GetDepth() const; | |
133 | virtual wxSize GetPPI() const; | |
134 | ||
135 | virtual void SetMapMode(int mode); | |
136 | virtual void SetUserScale(double x, double y); | |
137 | virtual void SetSystemScale(double x, double y); | |
138 | virtual void SetLogicalScale(double x, double y); | |
72cdf4c9 VZ |
139 | virtual void SetLogicalOrigin(wxCoord x, wxCoord y); |
140 | virtual void SetDeviceOrigin(wxCoord x, wxCoord y); | |
a23fd0e1 VZ |
141 | virtual void SetAxisOrientation(bool xLeftRight, bool yBottomUp); |
142 | virtual void SetLogicalFunction(int function); | |
143 | ||
144 | // implementation from now on | |
145 | // -------------------------- | |
146 | ||
147 | virtual void SetRop(WXHDC cdc); | |
a23fd0e1 VZ |
148 | virtual void SelectOldObjects(WXHDC dc); |
149 | ||
150 | wxWindow *GetWindow() const { return m_canvas; } | |
151 | void SetWindow(wxWindow *win) { m_canvas = win; } | |
152 | ||
153 | WXHDC GetHDC() const { return m_hDC; } | |
154 | void SetHDC(WXHDC dc, bool bOwnsDC = FALSE) | |
155 | { | |
156 | m_hDC = dc; | |
157 | m_bOwnsDC = bOwnsDC; | |
158 | } | |
2bda0e17 | 159 | |
4b7f2165 VZ |
160 | const wxBitmap& GetSelectedBitmap() const { return m_selectedBitmap; } |
161 | wxBitmap& GetSelectedBitmap() { return m_selectedBitmap; } | |
162 | ||
1e6feb95 VZ |
163 | // update the internal clip box variables |
164 | void UpdateClipBox(); | |
165 | ||
0cbff120 JS |
166 | #if wxUSE_DC_CACHEING |
167 | static wxDCCacheEntry* FindBitmapInCache(WXHDC hDC, int w, int h); | |
168 | static wxDCCacheEntry* FindDCInCache(wxDCCacheEntry* notThis, WXHDC hDC); | |
169 | ||
170 | static void AddToBitmapCache(wxDCCacheEntry* entry); | |
171 | static void AddToDCCache(wxDCCacheEntry* entry); | |
172 | static void ClearCache(); | |
173 | #endif | |
174 | ||
a23fd0e1 | 175 | protected: |
72cdf4c9 | 176 | virtual void DoFloodFill(wxCoord x, wxCoord y, const wxColour& col, |
a23fd0e1 VZ |
177 | int style = wxFLOOD_SURFACE); |
178 | ||
72cdf4c9 | 179 | virtual bool DoGetPixel(wxCoord x, wxCoord y, wxColour *col) const; |
a23fd0e1 | 180 | |
72cdf4c9 VZ |
181 | virtual void DoDrawPoint(wxCoord x, wxCoord y); |
182 | virtual void DoDrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2); | |
a23fd0e1 | 183 | |
72cdf4c9 VZ |
184 | virtual void DoDrawArc(wxCoord x1, wxCoord y1, |
185 | wxCoord x2, wxCoord y2, | |
186 | wxCoord xc, wxCoord yc); | |
cd9da200 VZ |
187 | virtual void DoDrawCheckMark(wxCoord x, wxCoord y, |
188 | wxCoord width, wxCoord height); | |
72cdf4c9 | 189 | virtual void DoDrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h, |
a23fd0e1 VZ |
190 | double sa, double ea); |
191 | ||
72cdf4c9 VZ |
192 | virtual void DoDrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height); |
193 | virtual void DoDrawRoundedRectangle(wxCoord x, wxCoord y, | |
194 | wxCoord width, wxCoord height, | |
a23fd0e1 | 195 | double radius); |
72cdf4c9 | 196 | virtual void DoDrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height); |
a23fd0e1 | 197 | |
72cdf4c9 | 198 | virtual void DoCrossHair(wxCoord x, wxCoord y); |
a23fd0e1 | 199 | |
72cdf4c9 VZ |
200 | virtual void DoDrawIcon(const wxIcon& icon, wxCoord x, wxCoord y); |
201 | virtual void DoDrawBitmap(const wxBitmap &bmp, wxCoord x, wxCoord y, | |
a23fd0e1 VZ |
202 | bool useMask = FALSE); |
203 | ||
72cdf4c9 | 204 | virtual void DoDrawText(const wxString& text, wxCoord x, wxCoord y); |
95724b1a VZ |
205 | virtual void DoDrawRotatedText(const wxString& text, wxCoord x, wxCoord y, |
206 | double angle); | |
a23fd0e1 | 207 | |
72cdf4c9 VZ |
208 | virtual bool DoBlit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height, |
209 | wxDC *source, wxCoord xsrc, wxCoord ysrc, | |
0cbff120 | 210 | int rop = wxCOPY, bool useMask = FALSE, wxCoord xsrcMask = -1, wxCoord ysrcMask = -1); |
a23fd0e1 VZ |
211 | |
212 | // this is gnarly - we can't even call this function DoSetClippingRegion() | |
213 | // because of virtual function hiding | |
214 | virtual void DoSetClippingRegionAsRegion(const wxRegion& region); | |
72cdf4c9 VZ |
215 | virtual void DoSetClippingRegion(wxCoord x, wxCoord y, |
216 | wxCoord width, wxCoord height); | |
217 | virtual void DoGetClippingRegion(wxCoord *x, wxCoord *y, | |
218 | wxCoord *width, wxCoord *height) | |
a23fd0e1 VZ |
219 | { |
220 | GetClippingBox(x, y, width, height); | |
221 | } | |
222 | ||
223 | virtual void DoGetSize(int *width, int *height) const; | |
224 | virtual void DoGetSizeMM(int* width, int* height) const; | |
225 | ||
226 | virtual void DoDrawLines(int n, wxPoint points[], | |
72cdf4c9 | 227 | wxCoord xoffset, wxCoord yoffset); |
a23fd0e1 | 228 | virtual void DoDrawPolygon(int n, wxPoint points[], |
72cdf4c9 | 229 | wxCoord xoffset, wxCoord yoffset, |
a23fd0e1 | 230 | int fillStyle = wxODDEVEN_RULE); |
6a6c0a8b | 231 | |
a23fd0e1 | 232 | |
4314ec48 VZ |
233 | // common part of DoDrawText() and DoDrawRotatedText() |
234 | void DrawAnyText(const wxString& text, wxCoord x, wxCoord y); | |
235 | ||
a23fd0e1 VZ |
236 | // MSW-specific member variables |
237 | int m_windowExtX; | |
238 | int m_windowExtY; | |
239 | ||
240 | // the window associated with this DC (may be NULL) | |
241 | wxWindow *m_canvas; | |
242 | ||
243 | wxBitmap m_selectedBitmap; | |
244 | ||
245 | // TRUE => DeleteDC() in dtor, FALSE => only ReleaseDC() it | |
246 | bool m_bOwnsDC:1; | |
247 | ||
b5badcb5 | 248 | // our HDC |
a23fd0e1 | 249 | WXHDC m_hDC; |
a23fd0e1 VZ |
250 | |
251 | // Store all old GDI objects when do a SelectObject, so we can select them | |
252 | // back in (this unselecting user's objects) so we can safely delete the | |
253 | // DC. | |
254 | WXHBITMAP m_oldBitmap; | |
255 | WXHPEN m_oldPen; | |
256 | WXHBRUSH m_oldBrush; | |
257 | WXHFONT m_oldFont; | |
258 | WXHPALETTE m_oldPalette; | |
7561aacd | 259 | |
0cbff120 JS |
260 | #if wxUSE_DC_CACHEING |
261 | static wxList sm_bitmapCache; | |
262 | static wxList sm_dcCache; | |
263 | #endif | |
264 | ||
7561aacd VZ |
265 | DECLARE_DYNAMIC_CLASS(wxDC) |
266 | }; | |
267 | ||
268 | // ---------------------------------------------------------------------------- | |
269 | // wxDCTemp: a wxDC which doesn't free the given HDC (used by wxWindows | |
270 | // only/mainly) | |
271 | // ---------------------------------------------------------------------------- | |
272 | ||
273 | class WXDLLEXPORT wxDCTemp : public wxDC | |
274 | { | |
275 | public: | |
276 | wxDCTemp(WXHDC hdc) { SetHDC(hdc); } | |
277 | virtual ~wxDCTemp() { SetHDC((WXHDC)NULL); } | |
2bda0e17 KB |
278 | }; |
279 | ||
2bda0e17 | 280 | #endif |
bbcdf8bc | 281 | // _WX_DC_H_ |