]>
Commit | Line | Data |
---|---|---|
006162a9 | 1 | ///////////////////////////////////////////////////////////////////////////// |
4660e6ac | 2 | // Name: wx/dc.h |
006162a9 | 3 | // Purpose: wxDC class |
6d52ca53 | 4 | // Author: Vadim Zeitlin |
006162a9 VZ |
5 | // Modified by: |
6 | // Created: 05/25/99 | |
7 | // RCS-ID: $Id$ | |
77ffb593 | 8 | // Copyright: (c) wxWidgets team |
65571936 | 9 | // Licence: wxWindows licence |
006162a9 VZ |
10 | ///////////////////////////////////////////////////////////////////////////// |
11 | ||
34138703 JS |
12 | #ifndef _WX_DC_H_BASE_ |
13 | #define _WX_DC_H_BASE_ | |
c801d85f | 14 | |
a23fd0e1 VZ |
15 | // ---------------------------------------------------------------------------- |
16 | // headers which we must include here | |
17 | // ---------------------------------------------------------------------------- | |
18 | ||
19 | #include "wx/object.h" // the base class | |
20 | ||
0d80fb31 | 21 | #include "wx/intl.h" // for wxLayoutDirection |
a23fd0e1 VZ |
22 | #include "wx/cursor.h" // we have member variables of these classes |
23 | #include "wx/font.h" // so we can't do without them | |
24 | #include "wx/colour.h" | |
b494e2b0 | 25 | #include "wx/bitmap.h" // for wxNullBitmap |
a23fd0e1 VZ |
26 | #include "wx/brush.h" |
27 | #include "wx/pen.h" | |
28 | #include "wx/palette.h" | |
0919e93e | 29 | #include "wx/dynarray.h" |
19edb09c | 30 | #include "wx/math.h" |
02255e07 | 31 | #include "wx/image.h" |
888dde65 | 32 | #include "wx/cmndata.h" |
a23fd0e1 | 33 | |
888dde65 | 34 | #define wxUSE_NEW_DC 1 |
2970ae54 | 35 | |
ca7db61e | 36 | class WXDLLIMPEXP_FWD_CORE wxDC; |
ab171e95 RR |
37 | class WXDLLIMPEXP_FWD_CORE wxClientDC; |
38 | class WXDLLIMPEXP_FWD_CORE wxPaintDC; | |
39 | class WXDLLIMPEXP_FWD_CORE wxWindowDC; | |
40 | class WXDLLIMPEXP_FWD_CORE wxScreenDC; | |
41 | class WXDLLIMPEXP_FWD_CORE wxMemoryDC; | |
c8ddadff | 42 | class WXDLLIMPEXP_FWD_CORE wxPrinterDC; |
477c48bf | 43 | class WXDLLIMPEXP_FWD_CORE wxPrintData; |
888dde65 RR |
44 | |
45 | //----------------------------------------------------------------------------- | |
46 | // wxDrawObject helper class | |
47 | //----------------------------------------------------------------------------- | |
ca7db61e | 48 | |
53a2db12 | 49 | class WXDLLIMPEXP_CORE wxDrawObject |
ca7db61e RR |
50 | { |
51 | public: | |
52 | ||
53 | wxDrawObject() | |
54 | : m_isBBoxValid(false) | |
55 | , m_minX(0), m_minY(0), m_maxX(0), m_maxY(0) | |
56 | { } | |
57 | ||
58 | virtual ~wxDrawObject() { } | |
59 | ||
ca7db61e | 60 | virtual void Draw(wxDC&) const { } |
ca7db61e RR |
61 | |
62 | virtual void CalcBoundingBox(wxCoord x, wxCoord y) | |
63 | { | |
64 | if ( m_isBBoxValid ) | |
65 | { | |
66 | if ( x < m_minX ) m_minX = x; | |
67 | if ( y < m_minY ) m_minY = y; | |
68 | if ( x > m_maxX ) m_maxX = x; | |
69 | if ( y > m_maxY ) m_maxY = y; | |
70 | } | |
71 | else | |
72 | { | |
73 | m_isBBoxValid = true; | |
74 | ||
75 | m_minX = x; | |
76 | m_minY = y; | |
77 | m_maxX = x; | |
78 | m_maxY = y; | |
79 | } | |
80 | } | |
81 | ||
82 | void ResetBoundingBox() | |
83 | { | |
84 | m_isBBoxValid = false; | |
85 | ||
86 | m_minX = m_maxX = m_minY = m_maxY = 0; | |
87 | } | |
88 | ||
89 | // Get the final bounding box of the PostScript or Metafile picture. | |
90 | ||
91 | wxCoord MinX() const { return m_minX; } | |
92 | wxCoord MaxX() const { return m_maxX; } | |
93 | wxCoord MinY() const { return m_minY; } | |
94 | wxCoord MaxY() const { return m_maxY; } | |
95 | ||
96 | //to define the type of object for derived objects | |
97 | virtual int GetType()=0; | |
98 | ||
99 | protected: | |
100 | //for boundingbox calculation | |
101 | bool m_isBBoxValid:1; | |
102 | //for boundingbox calculation | |
103 | wxCoord m_minX, m_minY, m_maxX, m_maxY; | |
104 | }; | |
105 | ||
106 | ||
2970ae54 RR |
107 | //----------------------------------------------------------------------------- |
108 | // wxDCFactory | |
109 | //----------------------------------------------------------------------------- | |
110 | ||
888dde65 | 111 | class WXDLLIMPEXP_FWD_CORE wxDCImpl; |
2970ae54 RR |
112 | |
113 | class WXDLLIMPEXP_CORE wxDCFactory | |
114 | { | |
115 | public: | |
116 | wxDCFactory() {} | |
117 | virtual ~wxDCFactory() {} | |
f0875501 | 118 | |
888dde65 | 119 | virtual wxDCImpl* CreateWindowDC( wxWindowDC *owner, wxWindow *window ) = 0; |
888dde65 | 120 | virtual wxDCImpl* CreateClientDC( wxClientDC *owner, wxWindow *window ) = 0; |
888dde65 RR |
121 | virtual wxDCImpl* CreatePaintDC( wxPaintDC *owner, wxWindow *window ) = 0; |
122 | virtual wxDCImpl* CreateMemoryDC( wxMemoryDC *owner ) = 0; | |
123 | virtual wxDCImpl* CreateMemoryDC( wxMemoryDC *owner, wxBitmap &bitmap ) = 0; | |
124 | virtual wxDCImpl* CreateMemoryDC( wxMemoryDC *owner, wxDC *dc ) = 0; | |
125 | virtual wxDCImpl* CreateScreenDC( wxScreenDC *owner ) = 0; | |
6b4f4d47 | 126 | #if wxUSE_PRINTING_ARCHITECTURE |
888dde65 | 127 | virtual wxDCImpl* CreatePrinterDC( wxPrinterDC *owner, const wxPrintData &data ) = 0; |
6b4f4d47 | 128 | #endif |
f0875501 | 129 | |
f2498c4e | 130 | static void Set(wxDCFactory *factory); |
f0875501 VZ |
131 | static wxDCFactory *Get(); |
132 | ||
2970ae54 RR |
133 | private: |
134 | static wxDCFactory *m_factory; | |
135 | }; | |
136 | ||
137 | //----------------------------------------------------------------------------- | |
138 | // wxNativeDCFactory | |
139 | //----------------------------------------------------------------------------- | |
140 | ||
ab171e95 | 141 | class WXDLLIMPEXP_CORE wxNativeDCFactory: public wxDCFactory |
2970ae54 RR |
142 | { |
143 | public: | |
144 | wxNativeDCFactory() {} | |
f0875501 | 145 | |
888dde65 | 146 | virtual wxDCImpl* CreateWindowDC( wxWindowDC *owner, wxWindow *window ); |
888dde65 | 147 | virtual wxDCImpl* CreateClientDC( wxClientDC *owner, wxWindow *window ); |
888dde65 RR |
148 | virtual wxDCImpl* CreatePaintDC( wxPaintDC *owner, wxWindow *window ); |
149 | virtual wxDCImpl* CreateMemoryDC( wxMemoryDC *owner ); | |
150 | virtual wxDCImpl* CreateMemoryDC( wxMemoryDC *owner, wxBitmap &bitmap ); | |
151 | virtual wxDCImpl* CreateMemoryDC( wxMemoryDC *owner, wxDC *dc ); | |
152 | virtual wxDCImpl* CreateScreenDC( wxScreenDC *owner ); | |
6b4f4d47 | 153 | #if wxUSE_PRINTING_ARCHITECTURE |
888dde65 | 154 | virtual wxDCImpl* CreatePrinterDC( wxPrinterDC *owner, const wxPrintData &data ); |
6b4f4d47 | 155 | #endif |
2970ae54 RR |
156 | }; |
157 | ||
2970ae54 | 158 | //----------------------------------------------------------------------------- |
888dde65 | 159 | // wxDCImpl |
2970ae54 RR |
160 | //----------------------------------------------------------------------------- |
161 | ||
888dde65 | 162 | class WXDLLIMPEXP_CORE wxDCImpl: public wxObject |
2970ae54 RR |
163 | { |
164 | public: | |
888dde65 | 165 | wxDCImpl( wxDC *owner ); |
edc51344 | 166 | virtual ~wxDCImpl(); |
f0875501 | 167 | |
ab171e95 | 168 | wxDC *GetOwner() const { return m_owner; } |
f0875501 | 169 | |
888dde65 | 170 | wxWindow* GetWindow() const { return m_window; } |
f0875501 | 171 | |
2970ae54 RR |
172 | virtual bool IsOk() const { return m_ok; } |
173 | ||
174 | // query capabilities | |
175 | ||
176 | virtual bool CanDrawBitmap() const = 0; | |
177 | virtual bool CanGetTextExtent() const = 0; | |
178 | ||
0b822969 RR |
179 | // get Cairo context |
180 | virtual void* GetCairoContext() const | |
2b44ffc0 RR |
181 | { |
182 | return NULL; | |
183 | } | |
2b44ffc0 | 184 | |
2970ae54 RR |
185 | // query dimension, colour deps, resolution |
186 | ||
187 | virtual void DoGetSize(int *width, int *height) const = 0; | |
4a624f6e VZ |
188 | void GetSize(int *width, int *height) const |
189 | { | |
243ef54b CE |
190 | DoGetSize(width, height); |
191 | return ; | |
4a624f6e VZ |
192 | } |
193 | ||
194 | wxSize GetSize() const | |
195 | { | |
196 | int w, h; | |
197 | DoGetSize(&w, &h); | |
198 | return wxSize(w, h); | |
199 | } | |
200 | ||
2970ae54 | 201 | virtual void DoGetSizeMM(int* width, int* height) const = 0; |
f0875501 | 202 | |
2970ae54 RR |
203 | virtual int GetDepth() const = 0; |
204 | virtual wxSize GetPPI() const = 0; | |
f0875501 | 205 | |
2970ae54 | 206 | // Right-To-Left (RTL) modes |
f0875501 | 207 | |
2970ae54 RR |
208 | virtual void SetLayoutDirection(wxLayoutDirection WXUNUSED(dir)) { } |
209 | virtual wxLayoutDirection GetLayoutDirection() const { return wxLayout_Default; } | |
f0875501 VZ |
210 | |
211 | // page and document | |
212 | ||
2970ae54 RR |
213 | virtual bool StartDoc(const wxString& WXUNUSED(message)) { return true; } |
214 | virtual void EndDoc() { } | |
215 | ||
216 | virtual void StartPage() { } | |
217 | virtual void EndPage() { } | |
218 | ||
cc18b1c7 SC |
219 | // flushing the content of this dc immediately eg onto screen |
220 | virtual void Flush() { } | |
221 | ||
2970ae54 RR |
222 | // bounding box |
223 | ||
ca7db61e | 224 | virtual void CalcBoundingBox(wxCoord x, wxCoord y) |
2970ae54 RR |
225 | { |
226 | if ( m_isBBoxValid ) | |
227 | { | |
228 | if ( x < m_minX ) m_minX = x; | |
229 | if ( y < m_minY ) m_minY = y; | |
230 | if ( x > m_maxX ) m_maxX = x; | |
231 | if ( y > m_maxY ) m_maxY = y; | |
232 | } | |
233 | else | |
234 | { | |
235 | m_isBBoxValid = true; | |
236 | ||
237 | m_minX = x; | |
238 | m_minY = y; | |
239 | m_maxX = x; | |
240 | m_maxY = y; | |
241 | } | |
242 | } | |
ca7db61e | 243 | void ResetBoundingBox() |
2970ae54 RR |
244 | { |
245 | m_isBBoxValid = false; | |
246 | ||
247 | m_minX = m_maxX = m_minY = m_maxY = 0; | |
248 | } | |
249 | ||
250 | wxCoord MinX() const { return m_minX; } | |
251 | wxCoord MaxX() const { return m_maxX; } | |
252 | wxCoord MinY() const { return m_minY; } | |
253 | wxCoord MaxY() const { return m_maxY; } | |
f0875501 | 254 | |
2970ae54 RR |
255 | // setters and getters |
256 | ||
257 | virtual void SetFont(const wxFont& font) = 0; | |
edc51344 | 258 | virtual const wxFont& GetFont() const { return m_font; } |
f0875501 | 259 | |
2970ae54 | 260 | virtual void SetPen(const wxPen& pen) = 0; |
edc51344 | 261 | virtual const wxPen& GetPen() const { return m_pen; } |
f0875501 | 262 | |
2970ae54 | 263 | virtual void SetBrush(const wxBrush& brush) = 0; |
edc51344 | 264 | virtual const wxBrush& GetBrush() const { return m_brush; } |
f0875501 | 265 | |
2970ae54 | 266 | virtual void SetBackground(const wxBrush& brush) = 0; |
edc51344 | 267 | virtual const wxBrush& GetBackground() const { return m_backgroundBrush; } |
f0875501 | 268 | |
2970ae54 RR |
269 | virtual void SetBackgroundMode(int mode) = 0; |
270 | virtual int GetBackgroundMode() const { return m_backgroundMode; } | |
271 | ||
272 | virtual void SetTextForeground(const wxColour& colour) | |
273 | { m_textForegroundColour = colour; } | |
edc51344 VZ |
274 | virtual const wxColour& GetTextForeground() const |
275 | { return m_textForegroundColour; } | |
f0875501 | 276 | |
2970ae54 RR |
277 | virtual void SetTextBackground(const wxColour& colour) |
278 | { m_textBackgroundColour = colour; } | |
edc51344 VZ |
279 | virtual const wxColour& GetTextBackground() const |
280 | { return m_textBackgroundColour; } | |
2970ae54 RR |
281 | |
282 | #if wxUSE_PALETTE | |
283 | virtual void SetPalette(const wxPalette& palette) = 0; | |
284 | #endif // wxUSE_PALETTE | |
285 | ||
edc51344 VZ |
286 | // inherit the DC attributes (font and colours) from the given window |
287 | // | |
288 | // this is called automatically when a window, client or paint DC is | |
289 | // created | |
290 | virtual void InheritAttributes(wxWindow *win); | |
291 | ||
292 | ||
2970ae54 | 293 | // logical functions |
f0875501 | 294 | |
2970ae54 RR |
295 | virtual void SetLogicalFunction(int function) = 0; |
296 | virtual int GetLogicalFunction() const { return m_logicalFunction; } | |
297 | ||
298 | // text measurement | |
299 | ||
300 | virtual wxCoord GetCharHeight() const = 0; | |
301 | virtual wxCoord GetCharWidth() const = 0; | |
302 | virtual void DoGetTextExtent(const wxString& string, | |
303 | wxCoord *x, wxCoord *y, | |
304 | wxCoord *descent = NULL, | |
305 | wxCoord *externalLeading = NULL, | |
306 | const wxFont *theFont = NULL) const = 0; | |
307 | virtual void GetMultiLineTextExtent(const wxString& string, | |
308 | wxCoord *width, | |
309 | wxCoord *height, | |
310 | wxCoord *heightLine = NULL, | |
311 | const wxFont *font = NULL) const; | |
312 | virtual bool DoGetPartialTextExtents(const wxString& text, wxArrayInt& widths) const; | |
f0875501 | 313 | |
2970ae54 | 314 | // clearing |
f0875501 | 315 | |
2970ae54 RR |
316 | virtual void Clear() = 0; |
317 | ||
318 | // clipping | |
319 | ||
320 | virtual void DoSetClippingRegion(wxCoord x, wxCoord y, | |
321 | wxCoord width, wxCoord height) = 0; | |
fdaad94e VZ |
322 | |
323 | // NB: this function works with device coordinates, not the logical ones! | |
324 | virtual void DoSetDeviceClippingRegion(const wxRegion& region) = 0; | |
2970ae54 RR |
325 | |
326 | virtual void DoGetClippingBox(wxCoord *x, wxCoord *y, | |
327 | wxCoord *w, wxCoord *h) const | |
328 | { | |
329 | if ( x ) | |
330 | *x = m_clipX1; | |
331 | if ( y ) | |
332 | *y = m_clipY1; | |
333 | if ( w ) | |
334 | *w = m_clipX2 - m_clipX1; | |
335 | if ( h ) | |
336 | *h = m_clipY2 - m_clipY1; | |
337 | } | |
338 | ||
339 | virtual void DestroyClippingRegion() { ResetClipping(); } | |
340 | ||
341 | ||
342 | // coordinates conversions and transforms | |
343 | ||
344 | virtual wxCoord DeviceToLogicalX(wxCoord x) const; | |
345 | virtual wxCoord DeviceToLogicalY(wxCoord y) const; | |
346 | virtual wxCoord DeviceToLogicalXRel(wxCoord x) const; | |
347 | virtual wxCoord DeviceToLogicalYRel(wxCoord y) const; | |
348 | virtual wxCoord LogicalToDeviceX(wxCoord x) const; | |
349 | virtual wxCoord LogicalToDeviceY(wxCoord y) const; | |
350 | virtual wxCoord LogicalToDeviceXRel(wxCoord x) const; | |
351 | virtual wxCoord LogicalToDeviceYRel(wxCoord y) const; | |
352 | ||
353 | virtual void SetMapMode(int mode); | |
354 | virtual int GetMapMode() const { return m_mappingMode; } | |
355 | ||
356 | virtual void SetUserScale(double x, double y); | |
357 | virtual void GetUserScale(double *x, double *y) const | |
358 | { | |
359 | if ( x ) *x = m_userScaleX; | |
360 | if ( y ) *y = m_userScaleY; | |
361 | } | |
362 | ||
363 | virtual void SetLogicalScale(double x, double y); | |
364 | virtual void GetLogicalScale(double *x, double *y) | |
365 | { | |
366 | if ( x ) *x = m_logicalScaleX; | |
367 | if ( y ) *y = m_logicalScaleY; | |
368 | } | |
369 | ||
370 | virtual void SetLogicalOrigin(wxCoord x, wxCoord y); | |
371 | virtual void DoGetLogicalOrigin(wxCoord *x, wxCoord *y) const | |
372 | { | |
373 | if ( x ) *x = m_logicalOriginX; | |
374 | if ( y ) *y = m_logicalOriginY; | |
375 | } | |
376 | ||
377 | virtual void SetDeviceOrigin(wxCoord x, wxCoord y); | |
378 | virtual void DoGetDeviceOrigin(wxCoord *x, wxCoord *y) const | |
379 | { | |
380 | if ( x ) *x = m_deviceOriginX; | |
381 | if ( y ) *y = m_deviceOriginY; | |
382 | } | |
f0875501 | 383 | |
2970ae54 RR |
384 | virtual void SetDeviceLocalOrigin( wxCoord x, wxCoord y ); |
385 | ||
386 | virtual void ComputeScaleAndOrigin(); | |
387 | ||
388 | // this needs to overidden if the axis is inverted | |
389 | virtual void SetAxisOrientation(bool xLeftRight, bool yBottomUp); | |
390 | ||
391 | // --------------------------------------------------------- | |
392 | // the actual drawing API | |
393 | ||
394 | virtual bool DoFloodFill(wxCoord x, wxCoord y, const wxColour& col, | |
395 | int style = wxFLOOD_SURFACE) = 0; | |
396 | ||
397 | virtual void DoGradientFillLinear(const wxRect& rect, | |
398 | const wxColour& initialColour, | |
399 | const wxColour& destColour, | |
400 | wxDirection nDirection = wxEAST); | |
401 | ||
402 | virtual void DoGradientFillConcentric(const wxRect& rect, | |
403 | const wxColour& initialColour, | |
404 | const wxColour& destColour, | |
405 | const wxPoint& circleCenter); | |
406 | ||
407 | virtual bool DoGetPixel(wxCoord x, wxCoord y, wxColour *col) const = 0; | |
408 | ||
409 | virtual void DoDrawPoint(wxCoord x, wxCoord y) = 0; | |
410 | virtual void DoDrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2) = 0; | |
411 | ||
412 | virtual void DoDrawArc(wxCoord x1, wxCoord y1, | |
413 | wxCoord x2, wxCoord y2, | |
414 | wxCoord xc, wxCoord yc) = 0; | |
415 | virtual void DoDrawCheckMark(wxCoord x, wxCoord y, | |
416 | wxCoord width, wxCoord height); | |
417 | virtual void DoDrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h, | |
418 | double sa, double ea) = 0; | |
419 | ||
420 | virtual void DoDrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height) = 0; | |
421 | virtual void DoDrawRoundedRectangle(wxCoord x, wxCoord y, | |
422 | wxCoord width, wxCoord height, | |
423 | double radius) = 0; | |
424 | virtual void DoDrawEllipse(wxCoord x, wxCoord y, | |
425 | wxCoord width, wxCoord height) = 0; | |
426 | ||
427 | virtual void DoCrossHair(wxCoord x, wxCoord y) = 0; | |
428 | ||
429 | virtual void DoDrawIcon(const wxIcon& icon, wxCoord x, wxCoord y) = 0; | |
430 | virtual void DoDrawBitmap(const wxBitmap &bmp, wxCoord x, wxCoord y, | |
431 | bool useMask = false) = 0; | |
432 | ||
433 | virtual void DoDrawText(const wxString& text, wxCoord x, wxCoord y) = 0; | |
434 | virtual void DoDrawRotatedText(const wxString& text, | |
435 | wxCoord x, wxCoord y, double angle) = 0; | |
436 | ||
437 | virtual bool DoBlit(wxCoord xdest, wxCoord ydest, | |
438 | wxCoord width, wxCoord height, | |
439 | wxDC *source, | |
440 | wxCoord xsrc, wxCoord ysrc, | |
441 | int rop = wxCOPY, | |
442 | bool useMask = false, | |
443 | wxCoord xsrcMask = wxDefaultCoord, | |
444 | wxCoord ysrcMask = wxDefaultCoord) = 0; | |
445 | ||
446 | virtual bool DoStretchBlit(wxCoord xdest, wxCoord ydest, | |
447 | wxCoord dstWidth, wxCoord dstHeight, | |
448 | wxDC *source, | |
449 | wxCoord xsrc, wxCoord ysrc, | |
450 | wxCoord srcWidth, wxCoord srcHeight, | |
451 | int rop = wxCOPY, | |
452 | bool useMask = false, | |
453 | wxCoord xsrcMask = wxDefaultCoord, | |
454 | wxCoord ysrcMask = wxDefaultCoord); | |
455 | ||
456 | virtual wxBitmap DoGetAsBitmap(const wxRect *WXUNUSED(subrect)) const | |
457 | { return wxNullBitmap; } | |
458 | ||
459 | ||
460 | virtual void DoDrawLines(int n, wxPoint points[], | |
4f37154e RR |
461 | wxCoord xoffset, wxCoord yoffset ) = 0; |
462 | virtual void DrawLines(const wxPointList *list, | |
463 | wxCoord xoffset, wxCoord yoffset ); | |
f0875501 | 464 | |
2970ae54 RR |
465 | virtual void DoDrawPolygon(int n, wxPoint points[], |
466 | wxCoord xoffset, wxCoord yoffset, | |
467 | int fillStyle = wxODDEVEN_RULE) = 0; | |
468 | virtual void DoDrawPolyPolygon(int n, int count[], wxPoint points[], | |
469 | wxCoord xoffset, wxCoord yoffset, | |
470 | int fillStyle); | |
4f37154e RR |
471 | void DrawPolygon(const wxPointList *list, |
472 | wxCoord xoffset, wxCoord yoffset, | |
473 | int fillStyle ); | |
2970ae54 RR |
474 | |
475 | ||
476 | #if wxUSE_SPLINES | |
7210c3a1 VZ |
477 | void DrawSpline(wxCoord x1, wxCoord y1, |
478 | wxCoord x2, wxCoord y2, | |
479 | wxCoord x3, wxCoord y3); | |
480 | void DrawSpline(int n, wxPoint points[]); | |
481 | void DrawSpline(const wxPointList *points) { DoDrawSpline(points); } | |
482 | ||
b0d7707b | 483 | virtual void DoDrawSpline(const wxPointList *points); |
2970ae54 | 484 | #endif |
f0875501 | 485 | |
4f37154e RR |
486 | // --------------------------------------------------------- |
487 | // wxMemoryDC Impl API | |
488 | ||
489 | virtual void DoSelect(const wxBitmap& WXUNUSED(bmp)) | |
490 | { } | |
f0875501 | 491 | |
4f37154e RR |
492 | virtual const wxBitmap& GetSelectedBitmap() const |
493 | { return wxNullBitmap; } | |
494 | virtual wxBitmap& GetSelectedBitmap() | |
495 | { return wxNullBitmap; } | |
f0875501 | 496 | |
4f37154e RR |
497 | // --------------------------------------------------------- |
498 | // wxPrinterDC Impl API | |
499 | ||
6d52ca53 | 500 | virtual wxRect GetPaperRect() const |
4f37154e | 501 | { int w = 0; int h = 0; DoGetSize( &w, &h ); return wxRect(0,0,w,h); } |
f0875501 | 502 | |
6d52ca53 | 503 | virtual int GetResolution() const |
4f37154e RR |
504 | { return -1; } |
505 | ||
2970ae54 | 506 | private: |
888dde65 | 507 | wxDC *m_owner; |
2970ae54 | 508 | |
f0875501 | 509 | protected: |
2970ae54 RR |
510 | // unset clipping variables (after clipping region was destroyed) |
511 | void ResetClipping() | |
512 | { | |
513 | m_clipping = false; | |
514 | ||
515 | m_clipX1 = m_clipX2 = m_clipY1 = m_clipY2 = 0; | |
516 | } | |
517 | ||
2261baf7 VZ |
518 | #ifdef __WXWINCE__ |
519 | //! Generic method to draw ellipses, circles and arcs with current pen and brush. | |
520 | /*! \param x Upper left corner of bounding box. | |
521 | * \param y Upper left corner of bounding box. | |
522 | * \param w Width of bounding box. | |
523 | * \param h Height of bounding box. | |
524 | * \param sa Starting angle of arc | |
525 | * (counterclockwise, start at 3 o'clock, 360 is full circle). | |
526 | * \param ea Ending angle of arc. | |
527 | * \param angle Rotation angle, the Arc will be rotated after | |
528 | * calculating begin and end. | |
529 | */ | |
530 | void DrawEllipticArcRot( wxCoord x, wxCoord y, | |
531 | wxCoord width, wxCoord height, | |
532 | double sa = 0, double ea = 0, double angle = 0 ) | |
533 | { DoDrawEllipticArcRot( x, y, width, height, sa, ea, angle ); } | |
534 | ||
535 | void DrawEllipticArcRot( const wxPoint& pt, | |
536 | const wxSize& sz, | |
537 | double sa = 0, double ea = 0, double angle = 0 ) | |
538 | { DoDrawEllipticArcRot( pt.x, pt.y, sz.x, sz.y, sa, ea, angle ); } | |
539 | ||
540 | void DrawEllipticArcRot( const wxRect& rect, | |
541 | double sa = 0, double ea = 0, double angle = 0 ) | |
542 | { DoDrawEllipticArcRot( rect.x, rect.y, rect.width, rect.height, sa, ea, angle ); } | |
543 | ||
544 | virtual void DoDrawEllipticArcRot( wxCoord x, wxCoord y, | |
545 | wxCoord w, wxCoord h, | |
546 | double sa = 0, double ea = 0, double angle = 0 ); | |
547 | ||
548 | //! Rotates points around center. | |
549 | /*! This is a quite straight method, it calculates in pixels | |
550 | * and so it produces rounding errors. | |
551 | * \param points The points inside will be rotated. | |
552 | * \param angle Rotating angle (counterclockwise, start at 3 o'clock, 360 is full circle). | |
553 | * \param center Center of rotation. | |
554 | */ | |
555 | void Rotate( wxPointList* points, double angle, wxPoint center = wxPoint(0,0) ); | |
556 | ||
557 | // used by DrawEllipticArcRot | |
558 | // Careful: wxList gets filled with points you have to delete later. | |
559 | void CalculateEllipticPoints( wxPointList* points, | |
560 | wxCoord xStart, wxCoord yStart, | |
561 | wxCoord w, wxCoord h, | |
562 | double sa, double ea ); | |
563 | #endif // __WXWINCE__ | |
564 | ||
12ca5586 VS |
565 | // returns adjustment factor for converting wxFont "point size"; in wx |
566 | // it is point size on screen and needs to be multiplied by this value | |
567 | // for rendering on higher-resolution DCs such as printer ones | |
568 | static float GetFontPointSizeAdjustment(float dpi); | |
2261baf7 | 569 | |
888dde65 RR |
570 | // window on which the DC draws or NULL |
571 | wxWindow *m_window; | |
f0875501 | 572 | |
2970ae54 RR |
573 | // flags |
574 | bool m_colour:1; | |
575 | bool m_ok:1; | |
576 | bool m_clipping:1; | |
577 | bool m_isInteractive:1; | |
578 | bool m_isBBoxValid:1; | |
579 | ||
580 | // coordinate system variables | |
581 | ||
582 | wxCoord m_logicalOriginX, m_logicalOriginY; | |
583 | wxCoord m_deviceOriginX, m_deviceOriginY; // Usually 0,0, can be change by user | |
f0875501 | 584 | |
2970ae54 RR |
585 | wxCoord m_deviceLocalOriginX, m_deviceLocalOriginY; // non-zero if native top-left corner |
586 | // is not at 0,0. This was the case under | |
587 | // Mac's GrafPorts (coordinate system | |
588 | // used toplevel window's origin) and | |
589 | // e.g. for Postscript, where the native | |
590 | // origin in the bottom left corner. | |
591 | double m_logicalScaleX, m_logicalScaleY; | |
592 | double m_userScaleX, m_userScaleY; | |
593 | double m_scaleX, m_scaleY; // calculated from logical scale and user scale | |
594 | ||
595 | int m_signX, m_signY; // Used by SetAxisOrientation() to invert the axes | |
f0875501 | 596 | |
2970ae54 RR |
597 | // what is a mm on a screen you don't know the size of? |
598 | double m_mm_to_pix_x, | |
599 | m_mm_to_pix_y; | |
f0875501 | 600 | |
2970ae54 RR |
601 | // bounding and clipping boxes |
602 | wxCoord m_minX, m_minY, m_maxX, m_maxY; | |
603 | wxCoord m_clipX1, m_clipY1, m_clipX2, m_clipY2; | |
604 | ||
605 | int m_logicalFunction; | |
606 | int m_backgroundMode; | |
607 | int m_mappingMode; | |
608 | ||
609 | wxPen m_pen; | |
610 | wxBrush m_brush; | |
611 | wxBrush m_backgroundBrush; | |
612 | wxColour m_textForegroundColour; | |
613 | wxColour m_textBackgroundColour; | |
614 | wxFont m_font; | |
615 | ||
616 | #if wxUSE_PALETTE | |
617 | wxPalette m_palette; | |
618 | bool m_hasCustomPalette; | |
619 | #endif // wxUSE_PALETTE | |
620 | ||
621 | private: | |
888dde65 | 622 | DECLARE_ABSTRACT_CLASS(wxDCImpl) |
ca7db61e | 623 | }; |
2970ae54 RR |
624 | |
625 | ||
f0875501 | 626 | class WXDLLIMPEXP_CORE wxDC : public wxObject |
2970ae54 RR |
627 | { |
628 | public: | |
f0875501 | 629 | virtual ~wxDC() { delete m_pimpl; } |
2970ae54 | 630 | |
888dde65 | 631 | wxDCImpl *GetImpl() |
ab171e95 | 632 | { return m_pimpl; } |
888dde65 | 633 | const wxDCImpl *GetImpl() const |
32043152 RR |
634 | { return m_pimpl; } |
635 | ||
1f991c9d | 636 | wxWindow *GetWindow() const |
888dde65 | 637 | { return m_pimpl->GetWindow(); } |
ab171e95 | 638 | |
f0875501 | 639 | bool IsOk() const |
2970ae54 RR |
640 | { return m_pimpl && m_pimpl->IsOk(); } |
641 | ||
642 | // query capabilities | |
643 | ||
f0875501 | 644 | bool CanDrawBitmap() const |
2970ae54 RR |
645 | { return m_pimpl->CanDrawBitmap(); } |
646 | bool CanGetTextExtent() const | |
647 | { return m_pimpl->CanGetTextExtent(); } | |
f0875501 | 648 | |
2970ae54 RR |
649 | // query dimension, colour deps, resolution |
650 | ||
651 | void GetSize(int *width, int *height) const | |
652 | { m_pimpl->DoGetSize(width, height); } | |
2970ae54 | 653 | wxSize GetSize() const |
4a624f6e | 654 | { return m_pimpl->GetSize(); } |
2970ae54 RR |
655 | |
656 | void GetSizeMM(int* width, int* height) const | |
657 | { m_pimpl->DoGetSizeMM(width, height); } | |
658 | wxSize GetSizeMM() const | |
659 | { | |
660 | int w, h; | |
661 | m_pimpl->DoGetSizeMM(&w, &h); | |
662 | return wxSize(w, h); | |
663 | } | |
f0875501 | 664 | |
2970ae54 RR |
665 | int GetDepth() const |
666 | { return m_pimpl->GetDepth(); } | |
667 | wxSize GetPPI() const | |
668 | { return m_pimpl->GetPPI(); } | |
669 | ||
6d52ca53 | 670 | virtual int GetResolution() const |
4f37154e | 671 | { return m_pimpl->GetResolution(); } |
f0875501 | 672 | |
2970ae54 | 673 | // Right-To-Left (RTL) modes |
f0875501 | 674 | |
2970ae54 RR |
675 | void SetLayoutDirection(wxLayoutDirection dir) |
676 | { m_pimpl->SetLayoutDirection( dir ); } | |
677 | wxLayoutDirection GetLayoutDirection() const | |
678 | { return m_pimpl->GetLayoutDirection(); } | |
f0875501 VZ |
679 | |
680 | // page and document | |
681 | ||
2970ae54 RR |
682 | bool StartDoc(const wxString& message) |
683 | { return m_pimpl->StartDoc(message); } | |
684 | void EndDoc() | |
685 | { m_pimpl->EndDoc(); } | |
686 | ||
687 | void StartPage() | |
688 | { m_pimpl->StartPage(); } | |
689 | void EndPage() | |
690 | { m_pimpl->EndPage(); } | |
691 | ||
692 | // bounding box | |
f0875501 | 693 | |
2970ae54 RR |
694 | void CalcBoundingBox(wxCoord x, wxCoord y) |
695 | { m_pimpl->CalcBoundingBox(x,y); } | |
696 | void ResetBoundingBox() | |
697 | { m_pimpl->ResetBoundingBox(); } | |
f0875501 | 698 | |
2970ae54 RR |
699 | wxCoord MinX() const |
700 | { return m_pimpl->MinX(); } | |
701 | wxCoord MaxX() const | |
702 | { return m_pimpl->MaxX(); } | |
703 | wxCoord MinY() const | |
704 | { return m_pimpl->MinY(); } | |
705 | wxCoord MaxY() const | |
706 | { return m_pimpl->MaxY(); } | |
f0875501 | 707 | |
2970ae54 RR |
708 | // setters and getters |
709 | ||
710 | void SetFont(const wxFont& font) | |
711 | { m_pimpl->SetFont( font ); } | |
f0875501 | 712 | const wxFont& GetFont() const |
2970ae54 | 713 | { return m_pimpl->GetFont(); } |
f0875501 | 714 | |
2970ae54 RR |
715 | void SetPen(const wxPen& pen) |
716 | { m_pimpl->SetPen( pen ); } | |
f0875501 | 717 | const wxPen& GetPen() const |
2970ae54 | 718 | { return m_pimpl->GetPen(); } |
f0875501 | 719 | |
2970ae54 RR |
720 | void SetBrush(const wxBrush& brush) |
721 | { m_pimpl->SetBrush( brush ); } | |
722 | const wxBrush& GetBrush() const | |
723 | { return m_pimpl->GetBrush(); } | |
f0875501 | 724 | |
2970ae54 RR |
725 | void SetBackground(const wxBrush& brush) |
726 | { m_pimpl->SetBackground( brush ); } | |
727 | const wxBrush& GetBackground() const | |
728 | { return m_pimpl->GetBackground(); } | |
f0875501 | 729 | |
2970ae54 | 730 | void SetBackgroundMode(int mode) |
ca7db61e | 731 | { m_pimpl->SetBackgroundMode( mode ); } |
2970ae54 | 732 | int GetBackgroundMode() const |
ca7db61e | 733 | { return m_pimpl->GetBackgroundMode(); } |
2970ae54 RR |
734 | |
735 | void SetTextForeground(const wxColour& colour) | |
736 | { m_pimpl->SetTextForeground(colour); } | |
737 | const wxColour& GetTextForeground() const | |
738 | { return m_pimpl->GetTextForeground(); } | |
f0875501 | 739 | |
2970ae54 RR |
740 | void SetTextBackground(const wxColour& colour) |
741 | { m_pimpl->SetTextBackground(colour); } | |
f0875501 | 742 | const wxColour& GetTextBackground() const |
2970ae54 RR |
743 | { return m_pimpl->GetTextBackground(); } |
744 | ||
745 | #if wxUSE_PALETTE | |
746 | void SetPalette(const wxPalette& palette) | |
747 | { m_pimpl->SetPalette(palette); } | |
748 | #endif // wxUSE_PALETTE | |
f0875501 | 749 | |
2970ae54 | 750 | // logical functions |
f0875501 | 751 | |
2970ae54 RR |
752 | void SetLogicalFunction(int function) |
753 | { m_pimpl->SetLogicalFunction(function); } | |
754 | int GetLogicalFunction() const | |
755 | { return m_pimpl->GetLogicalFunction(); } | |
f0875501 | 756 | |
2970ae54 RR |
757 | // text measurement |
758 | ||
759 | wxCoord GetCharHeight() const | |
760 | { return m_pimpl->GetCharHeight(); } | |
761 | wxCoord GetCharWidth() const | |
762 | { return m_pimpl->GetCharWidth(); } | |
f0875501 | 763 | |
2970ae54 RR |
764 | void GetTextExtent(const wxString& string, |
765 | wxCoord *x, wxCoord *y, | |
766 | wxCoord *descent = NULL, | |
767 | wxCoord *externalLeading = NULL, | |
768 | const wxFont *theFont = NULL) const | |
769 | { m_pimpl->DoGetTextExtent(string, x, y, descent, externalLeading, theFont); } | |
770 | ||
771 | wxSize GetTextExtent(const wxString& string) const | |
772 | { | |
773 | wxCoord w, h; | |
774 | m_pimpl->DoGetTextExtent(string, &w, &h); | |
775 | return wxSize(w, h); | |
776 | } | |
f0875501 | 777 | |
2970ae54 RR |
778 | void GetMultiLineTextExtent(const wxString& string, |
779 | wxCoord *width, | |
780 | wxCoord *height, | |
781 | wxCoord *heightLine = NULL, | |
782 | const wxFont *font = NULL) const | |
783 | { m_pimpl->GetMultiLineTextExtent( string, width, height, heightLine, font ); } | |
f0875501 | 784 | |
2970ae54 RR |
785 | wxSize GetMultiLineTextExtent(const wxString& string) const |
786 | { | |
787 | wxCoord w, h; | |
788 | m_pimpl->GetMultiLineTextExtent(string, &w, &h); | |
789 | return wxSize(w, h); | |
790 | } | |
f0875501 | 791 | |
2970ae54 RR |
792 | bool GetPartialTextExtents(const wxString& text, wxArrayInt& widths) const |
793 | { return m_pimpl->DoGetPartialTextExtents(text, widths); } | |
f0875501 | 794 | |
2970ae54 | 795 | // clearing |
f0875501 | 796 | |
2970ae54 RR |
797 | void Clear() |
798 | { m_pimpl->Clear(); } | |
799 | ||
800 | // clipping | |
801 | ||
802 | void SetClippingRegion(wxCoord x, wxCoord y, wxCoord width, wxCoord height) | |
803 | { m_pimpl->DoSetClippingRegion(x, y, width, height); } | |
804 | void SetClippingRegion(const wxPoint& pt, const wxSize& sz) | |
805 | { m_pimpl->DoSetClippingRegion(pt.x, pt.y, sz.x, sz.y); } | |
806 | void SetClippingRegion(const wxRect& rect) | |
807 | { m_pimpl->DoSetClippingRegion(rect.x, rect.y, rect.width, rect.height); } | |
fdaad94e VZ |
808 | |
809 | // unlike the functions above, the coordinates of the region used in this | |
810 | // one are in device coordinates, not the logical ones | |
811 | void SetDeviceClippingRegion(const wxRegion& region) | |
812 | { m_pimpl->DoSetDeviceClippingRegion(region); } | |
813 | ||
814 | // this function is deprecated because its name is confusing: you may | |
815 | // expect it to work with logical coordinates but, in fact, it does exactly | |
816 | // the same thing as SetDeviceClippingRegion() | |
817 | // | |
818 | // please review the code using it and either replace it with calls to | |
819 | // SetDeviceClippingRegion() or correct it if it was [wrongly] passing | |
820 | // logical coordinates to this function | |
821 | wxDEPRECATED_INLINE(void SetClippingRegion(const wxRegion& region), | |
822 | SetDeviceClippingRegion(region); ) | |
2970ae54 RR |
823 | |
824 | void DestroyClippingRegion() | |
825 | { m_pimpl->DestroyClippingRegion(); } | |
826 | ||
827 | void GetClippingBox(wxCoord *x, wxCoord *y, wxCoord *w, wxCoord *h) const | |
828 | { m_pimpl->DoGetClippingBox(x, y, w, h); } | |
829 | void GetClippingBox(wxRect& rect) const | |
830 | { m_pimpl->DoGetClippingBox(&rect.x, &rect.y, &rect.width, &rect.height); } | |
f0875501 | 831 | |
2970ae54 RR |
832 | // coordinates conversions and transforms |
833 | ||
834 | wxCoord DeviceToLogicalX(wxCoord x) const | |
835 | { return m_pimpl->DeviceToLogicalX(x); } | |
ca7db61e | 836 | wxCoord DeviceToLogicalY(wxCoord y) const |
2970ae54 | 837 | { return m_pimpl->DeviceToLogicalY(y); } |
ca7db61e | 838 | wxCoord DeviceToLogicalXRel(wxCoord x) const |
2970ae54 | 839 | { return m_pimpl->DeviceToLogicalXRel(x); } |
ca7db61e | 840 | wxCoord DeviceToLogicalYRel(wxCoord y) const |
2970ae54 | 841 | { return m_pimpl->DeviceToLogicalYRel(y); } |
ca7db61e | 842 | wxCoord LogicalToDeviceX(wxCoord x) const |
2970ae54 | 843 | { return m_pimpl->LogicalToDeviceX(x); } |
ca7db61e | 844 | wxCoord LogicalToDeviceY(wxCoord y) const |
2970ae54 | 845 | { return m_pimpl->LogicalToDeviceY(y); } |
ca7db61e | 846 | wxCoord LogicalToDeviceXRel(wxCoord x) const |
2970ae54 | 847 | { return m_pimpl->LogicalToDeviceXRel(x); } |
ca7db61e | 848 | wxCoord LogicalToDeviceYRel(wxCoord y) const |
2970ae54 RR |
849 | { return m_pimpl->LogicalToDeviceYRel(y); } |
850 | ||
851 | void SetMapMode(int mode) | |
852 | { m_pimpl->SetMapMode(mode); } | |
853 | int GetMapMode() const | |
854 | { return m_pimpl->GetMapMode(); } | |
855 | ||
856 | void SetUserScale(double x, double y) | |
857 | { m_pimpl->SetUserScale(x,y); } | |
858 | void GetUserScale(double *x, double *y) const | |
859 | { m_pimpl->GetUserScale( x, y ); } | |
860 | ||
861 | void SetLogicalScale(double x, double y) | |
862 | { m_pimpl->SetLogicalScale( x, y ); } | |
863 | void GetLogicalScale(double *x, double *y) | |
864 | { m_pimpl->GetLogicalScale( x, y ); } | |
865 | ||
866 | void SetLogicalOrigin(wxCoord x, wxCoord y) | |
867 | { m_pimpl->SetLogicalOrigin(x,y); } | |
868 | void GetLogicalOrigin(wxCoord *x, wxCoord *y) const | |
869 | { m_pimpl->DoGetLogicalOrigin(x, y); } | |
870 | wxPoint GetLogicalOrigin() const | |
871 | { wxCoord x, y; m_pimpl->DoGetLogicalOrigin(&x, &y); return wxPoint(x, y); } | |
872 | ||
873 | void SetDeviceOrigin(wxCoord x, wxCoord y) | |
874 | { m_pimpl->SetDeviceOrigin( x, y); } | |
875 | void GetDeviceOrigin(wxCoord *x, wxCoord *y) const | |
876 | { m_pimpl->DoGetDeviceOrigin(x, y); } | |
877 | wxPoint GetDeviceOrigin() const | |
878 | { wxCoord x, y; m_pimpl->DoGetDeviceOrigin(&x, &y); return wxPoint(x, y); } | |
879 | ||
880 | void SetAxisOrientation(bool xLeftRight, bool yBottomUp) | |
881 | { m_pimpl->SetAxisOrientation(xLeftRight, yBottomUp); } | |
f0875501 VZ |
882 | |
883 | // mostly internal | |
2970ae54 RR |
884 | void SetDeviceLocalOrigin( wxCoord x, wxCoord y ) |
885 | { m_pimpl->SetDeviceLocalOrigin( x, y ); } | |
886 | ||
887 | ||
888 | // draw generic object | |
889 | ||
890 | void DrawObject(wxDrawObject* drawobject) | |
891 | { | |
892 | drawobject->Draw(*this); | |
893 | CalcBoundingBox(drawobject->MinX(),drawobject->MinY()); | |
894 | CalcBoundingBox(drawobject->MaxX(),drawobject->MaxY()); | |
895 | } | |
896 | ||
897 | // ----------------------------------------------- | |
898 | // the actual drawing API | |
899 | ||
900 | bool FloodFill(wxCoord x, wxCoord y, const wxColour& col, | |
901 | int style = wxFLOOD_SURFACE) | |
902 | { return m_pimpl->DoFloodFill(x, y, col, style); } | |
903 | bool FloodFill(const wxPoint& pt, const wxColour& col, | |
904 | int style = wxFLOOD_SURFACE) | |
905 | { return m_pimpl->DoFloodFill(pt.x, pt.y, col, style); } | |
906 | ||
907 | // fill the area specified by rect with a radial gradient, starting from | |
908 | // initialColour in the centre of the cercle and fading to destColour. | |
909 | void GradientFillConcentric(const wxRect& rect, | |
910 | const wxColour& initialColour, | |
911 | const wxColour& destColour) | |
ca7db61e RR |
912 | { m_pimpl->DoGradientFillConcentric( rect, initialColour, destColour, |
913 | wxPoint(rect.GetWidth() / 2, | |
914 | rect.GetHeight() / 2)); } | |
2970ae54 RR |
915 | |
916 | void GradientFillConcentric(const wxRect& rect, | |
917 | const wxColour& initialColour, | |
918 | const wxColour& destColour, | |
919 | const wxPoint& circleCenter) | |
920 | { m_pimpl->DoGradientFillConcentric(rect, initialColour, destColour, circleCenter); } | |
921 | ||
922 | // fill the area specified by rect with a linear gradient | |
923 | void GradientFillLinear(const wxRect& rect, | |
924 | const wxColour& initialColour, | |
925 | const wxColour& destColour, | |
926 | wxDirection nDirection = wxEAST) | |
927 | { m_pimpl->DoGradientFillLinear(rect, initialColour, destColour, nDirection); } | |
928 | ||
929 | bool GetPixel(wxCoord x, wxCoord y, wxColour *col) const | |
930 | { return m_pimpl->DoGetPixel(x, y, col); } | |
931 | bool GetPixel(const wxPoint& pt, wxColour *col) const | |
932 | { return m_pimpl->DoGetPixel(pt.x, pt.y, col); } | |
933 | ||
934 | void DrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2) | |
935 | { m_pimpl->DoDrawLine(x1, y1, x2, y2); } | |
936 | void DrawLine(const wxPoint& pt1, const wxPoint& pt2) | |
937 | { m_pimpl->DoDrawLine(pt1.x, pt1.y, pt2.x, pt2.y); } | |
938 | ||
939 | void CrossHair(wxCoord x, wxCoord y) | |
940 | { m_pimpl->DoCrossHair(x, y); } | |
941 | void CrossHair(const wxPoint& pt) | |
942 | { m_pimpl->DoCrossHair(pt.x, pt.y); } | |
943 | ||
944 | void DrawArc(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2, | |
945 | wxCoord xc, wxCoord yc) | |
946 | { m_pimpl->DoDrawArc(x1, y1, x2, y2, xc, yc); } | |
947 | void DrawArc(const wxPoint& pt1, const wxPoint& pt2, const wxPoint& centre) | |
948 | { m_pimpl->DoDrawArc(pt1.x, pt1.y, pt2.x, pt2.y, centre.x, centre.y); } | |
949 | ||
950 | void DrawCheckMark(wxCoord x, wxCoord y, | |
951 | wxCoord width, wxCoord height) | |
952 | { m_pimpl->DoDrawCheckMark(x, y, width, height); } | |
953 | void DrawCheckMark(const wxRect& rect) | |
954 | { m_pimpl->DoDrawCheckMark(rect.x, rect.y, rect.width, rect.height); } | |
955 | ||
956 | void DrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h, | |
957 | double sa, double ea) | |
958 | { m_pimpl->DoDrawEllipticArc(x, y, w, h, sa, ea); } | |
959 | void DrawEllipticArc(const wxPoint& pt, const wxSize& sz, | |
960 | double sa, double ea) | |
961 | { m_pimpl->DoDrawEllipticArc(pt.x, pt.y, sz.x, sz.y, sa, ea); } | |
962 | ||
963 | void DrawPoint(wxCoord x, wxCoord y) | |
964 | { m_pimpl->DoDrawPoint(x, y); } | |
965 | void DrawPoint(const wxPoint& pt) | |
966 | { m_pimpl->DoDrawPoint(pt.x, pt.y); } | |
967 | ||
968 | void DrawLines(int n, wxPoint points[], | |
969 | wxCoord xoffset = 0, wxCoord yoffset = 0) | |
970 | { m_pimpl->DoDrawLines(n, points, xoffset, yoffset); } | |
b0d7707b | 971 | void DrawLines(const wxPointList *list, |
2970ae54 | 972 | wxCoord xoffset = 0, wxCoord yoffset = 0) |
f0875501 | 973 | { m_pimpl->DrawLines( list, xoffset, yoffset ); } |
4f37154e RR |
974 | #if WXWIN_COMPATIBILITY_2_8 |
975 | wxDEPRECATED( void DrawLines(const wxList *list, | |
976 | wxCoord xoffset = 0, wxCoord yoffset = 0) ); | |
977 | #endif // WXWIN_COMPATIBILITY_2_8 | |
2970ae54 RR |
978 | |
979 | void DrawPolygon(int n, wxPoint points[], | |
980 | wxCoord xoffset = 0, wxCoord yoffset = 0, | |
981 | int fillStyle = wxODDEVEN_RULE) | |
982 | { m_pimpl->DoDrawPolygon(n, points, xoffset, yoffset, fillStyle); } | |
b0d7707b | 983 | void DrawPolygon(const wxPointList *list, |
2970ae54 RR |
984 | wxCoord xoffset = 0, wxCoord yoffset = 0, |
985 | int fillStyle = wxODDEVEN_RULE) | |
986 | { m_pimpl->DrawPolygon( list, xoffset, yoffset, fillStyle ); } | |
2970ae54 RR |
987 | void DrawPolyPolygon(int n, int count[], wxPoint points[], |
988 | wxCoord xoffset = 0, wxCoord yoffset = 0, | |
989 | int fillStyle = wxODDEVEN_RULE) | |
990 | { m_pimpl->DoDrawPolyPolygon(n, count, points, xoffset, yoffset, fillStyle); } | |
4f37154e RR |
991 | #if WXWIN_COMPATIBILITY_2_8 |
992 | wxDEPRECATED( void DrawPolygon(const wxList *list, | |
993 | wxCoord xoffset = 0, wxCoord yoffset = 0, | |
994 | int fillStyle = wxODDEVEN_RULE) ); | |
995 | #endif // WXWIN_COMPATIBILITY_2_8 | |
2970ae54 RR |
996 | |
997 | void DrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height) | |
998 | { m_pimpl->DoDrawRectangle(x, y, width, height); } | |
999 | void DrawRectangle(const wxPoint& pt, const wxSize& sz) | |
1000 | { m_pimpl->DoDrawRectangle(pt.x, pt.y, sz.x, sz.y); } | |
1001 | void DrawRectangle(const wxRect& rect) | |
1002 | { m_pimpl->DoDrawRectangle(rect.x, rect.y, rect.width, rect.height); } | |
1003 | ||
1004 | void DrawRoundedRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height, | |
1005 | double radius) | |
1006 | { m_pimpl->DoDrawRoundedRectangle(x, y, width, height, radius); } | |
1007 | void DrawRoundedRectangle(const wxPoint& pt, const wxSize& sz, | |
1008 | double radius) | |
1009 | { m_pimpl->DoDrawRoundedRectangle(pt.x, pt.y, sz.x, sz.y, radius); } | |
1010 | void DrawRoundedRectangle(const wxRect& r, double radius) | |
1011 | { m_pimpl->DoDrawRoundedRectangle(r.x, r.y, r.width, r.height, radius); } | |
1012 | ||
1013 | void DrawCircle(wxCoord x, wxCoord y, wxCoord radius) | |
1014 | { m_pimpl->DoDrawEllipse(x - radius, y - radius, 2*radius, 2*radius); } | |
1015 | void DrawCircle(const wxPoint& pt, wxCoord radius) | |
ca7db61e | 1016 | { m_pimpl->DoDrawEllipse(pt.x - radius, pt.y - radius, 2*radius, 2*radius); } |
2970ae54 RR |
1017 | |
1018 | void DrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height) | |
1019 | { m_pimpl->DoDrawEllipse(x, y, width, height); } | |
1020 | void DrawEllipse(const wxPoint& pt, const wxSize& sz) | |
1021 | { m_pimpl->DoDrawEllipse(pt.x, pt.y, sz.x, sz.y); } | |
1022 | void DrawEllipse(const wxRect& rect) | |
1023 | { m_pimpl->DoDrawEllipse(rect.x, rect.y, rect.width, rect.height); } | |
1024 | ||
1025 | void DrawIcon(const wxIcon& icon, wxCoord x, wxCoord y) | |
1026 | { m_pimpl->DoDrawIcon(icon, x, y); } | |
1027 | void DrawIcon(const wxIcon& icon, const wxPoint& pt) | |
1028 | { m_pimpl->DoDrawIcon(icon, pt.x, pt.y); } | |
1029 | ||
1030 | void DrawBitmap(const wxBitmap &bmp, wxCoord x, wxCoord y, | |
1031 | bool useMask = false) | |
1032 | { m_pimpl->DoDrawBitmap(bmp, x, y, useMask); } | |
1033 | void DrawBitmap(const wxBitmap &bmp, const wxPoint& pt, | |
1034 | bool useMask = false) | |
1035 | { m_pimpl->DoDrawBitmap(bmp, pt.x, pt.y, useMask); } | |
1036 | ||
1037 | void DrawText(const wxString& text, wxCoord x, wxCoord y) | |
1038 | { m_pimpl->DoDrawText(text, x, y); } | |
1039 | void DrawText(const wxString& text, const wxPoint& pt) | |
1040 | { m_pimpl->DoDrawText(text, pt.x, pt.y); } | |
1041 | ||
1042 | void DrawRotatedText(const wxString& text, wxCoord x, wxCoord y, double angle) | |
1043 | { m_pimpl->DoDrawRotatedText(text, x, y, angle); } | |
1044 | void DrawRotatedText(const wxString& text, const wxPoint& pt, double angle) | |
1045 | { m_pimpl->DoDrawRotatedText(text, pt.x, pt.y, angle); } | |
1046 | ||
1047 | // this version puts both optional bitmap and the text into the given | |
1048 | // rectangle and aligns is as specified by alignment parameter; it also | |
1049 | // will emphasize the character with the given index if it is != -1 and | |
1050 | // return the bounding rectangle if required | |
1051 | void DrawLabel(const wxString& text, | |
1052 | const wxBitmap& image, | |
1053 | const wxRect& rect, | |
1054 | int alignment = wxALIGN_LEFT | wxALIGN_TOP, | |
1055 | int indexAccel = -1, | |
ca7db61e | 1056 | wxRect *rectBounding = NULL); |
2970ae54 RR |
1057 | |
1058 | void DrawLabel(const wxString& text, const wxRect& rect, | |
1059 | int alignment = wxALIGN_LEFT | wxALIGN_TOP, | |
1060 | int indexAccel = -1) | |
ca7db61e | 1061 | { DrawLabel(text, wxNullBitmap, rect, alignment, indexAccel); } |
2970ae54 RR |
1062 | |
1063 | bool Blit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height, | |
1064 | wxDC *source, wxCoord xsrc, wxCoord ysrc, | |
1065 | int rop = wxCOPY, bool useMask = false, wxCoord xsrcMask = wxDefaultCoord, wxCoord ysrcMask = wxDefaultCoord) | |
1066 | { | |
1067 | return m_pimpl->DoBlit(xdest, ydest, width, height, | |
1068 | source, xsrc, ysrc, rop, useMask, xsrcMask, ysrcMask); | |
1069 | } | |
1070 | bool Blit(const wxPoint& destPt, const wxSize& sz, | |
1071 | wxDC *source, const wxPoint& srcPt, | |
1072 | int rop = wxCOPY, bool useMask = false, const wxPoint& srcPtMask = wxDefaultPosition) | |
1073 | { | |
1074 | return m_pimpl->DoBlit(destPt.x, destPt.y, sz.x, sz.y, | |
1075 | source, srcPt.x, srcPt.y, rop, useMask, srcPtMask.x, srcPtMask.y); | |
1076 | } | |
1077 | ||
f0875501 | 1078 | bool StretchBlit(wxCoord dstX, wxCoord dstY, |
2970ae54 | 1079 | wxCoord dstWidth, wxCoord dstHeight, |
f0875501 | 1080 | wxDC *source, |
2970ae54 RR |
1081 | wxCoord srcX, wxCoord srcY, |
1082 | wxCoord srcWidth, wxCoord srcHeight, | |
f0875501 | 1083 | int rop = wxCOPY, bool useMask = false, |
2970ae54 RR |
1084 | wxCoord srcMaskX = wxDefaultCoord, wxCoord srcMaskY = wxDefaultCoord) |
1085 | { | |
1086 | return m_pimpl->DoStretchBlit(dstX, dstY, dstWidth, dstHeight, | |
1087 | source, srcX, srcY, srcWidth, srcHeight, rop, useMask, srcMaskX, srcMaskY); | |
1088 | } | |
1089 | bool StretchBlit(const wxPoint& dstPt, const wxSize& dstSize, | |
1090 | wxDC *source, const wxPoint& srcPt, const wxSize& srcSize, | |
1091 | int rop = wxCOPY, bool useMask = false, const wxPoint& srcMaskPt = wxDefaultPosition) | |
1092 | { | |
1093 | return m_pimpl->DoStretchBlit(dstPt.x, dstPt.y, dstSize.x, dstSize.y, | |
1094 | source, srcPt.x, srcPt.y, srcSize.x, srcSize.y, rop, useMask, srcMaskPt.x, srcMaskPt.y); | |
1095 | } | |
1096 | ||
1097 | wxBitmap GetAsBitmap(const wxRect *subrect = (const wxRect *) NULL) const | |
1098 | { | |
1099 | return m_pimpl->DoGetAsBitmap(subrect); | |
1100 | } | |
1101 | ||
1102 | #if wxUSE_SPLINES | |
2970ae54 RR |
1103 | void DrawSpline(wxCoord x1, wxCoord y1, |
1104 | wxCoord x2, wxCoord y2, | |
1105 | wxCoord x3, wxCoord y3) | |
7210c3a1 | 1106 | { m_pimpl->DrawSpline(x1,y1,x2,y2,x3,y3); } |
2970ae54 | 1107 | void DrawSpline(int n, wxPoint points[]) |
7210c3a1 | 1108 | { m_pimpl->DrawSpline(n,points); } |
f0875501 | 1109 | void DrawSpline(const wxPointList *points) |
7210c3a1 | 1110 | { m_pimpl->DrawSpline(points); } |
2970ae54 RR |
1111 | #endif // wxUSE_SPLINES |
1112 | ||
1113 | ||
1114 | #if WXWIN_COMPATIBILITY_2_8 | |
1115 | // for compatibility with the old code when wxCoord was long everywhere | |
1116 | wxDEPRECATED( void GetTextExtent(const wxString& string, | |
1117 | long *x, long *y, | |
1118 | long *descent = NULL, | |
1119 | long *externalLeading = NULL, | |
1120 | const wxFont *theFont = NULL) const ); | |
1121 | wxDEPRECATED( void GetLogicalOrigin(long *x, long *y) const ); | |
1122 | wxDEPRECATED( void GetDeviceOrigin(long *x, long *y) const ); | |
1123 | wxDEPRECATED( void GetClippingBox(long *x, long *y, long *w, long *h) const ); | |
f5725872 | 1124 | |
2970ae54 RR |
1125 | #endif // WXWIN_COMPATIBILITY_2_8 |
1126 | ||
f5725872 VZ |
1127 | #ifdef __WXMSW__ |
1128 | WXHDC GetHDC() const; | |
1129 | #endif // __WXMSW__ | |
2970ae54 RR |
1130 | |
1131 | protected: | |
f0875501 VZ |
1132 | // ctor takes ownership of the pointer |
1133 | wxDC(wxDCImpl *pimpl) : m_pimpl(pimpl) { } | |
1134 | ||
1135 | wxDCImpl * const m_pimpl; | |
aec43716 | 1136 | |
ca7db61e | 1137 | private: |
888dde65 | 1138 | DECLARE_ABSTRACT_CLASS(wxDC) |
f0875501 | 1139 | DECLARE_NO_COPY_CLASS(wxDC) |
ca7db61e | 1140 | }; |
aec43716 | 1141 | |
1e6feb95 VZ |
1142 | // ---------------------------------------------------------------------------- |
1143 | // helper class: you can use it to temporarily change the DC text colour and | |
1144 | // restore it automatically when the object goes out of scope | |
1145 | // ---------------------------------------------------------------------------- | |
1146 | ||
53a2db12 | 1147 | class WXDLLIMPEXP_CORE wxDCTextColourChanger |
1e6feb95 VZ |
1148 | { |
1149 | public: | |
ba161d7e | 1150 | wxDCTextColourChanger(wxDC& dc) : m_dc(dc), m_colFgOld() { } |
1e6feb95 | 1151 | |
1b97b23d VS |
1152 | wxDCTextColourChanger(wxDC& dc, const wxColour& col) : m_dc(dc) |
1153 | { | |
1154 | Set(col); | |
1155 | } | |
1156 | ||
1e6feb95 VZ |
1157 | ~wxDCTextColourChanger() |
1158 | { | |
1159 | if ( m_colFgOld.Ok() ) | |
1160 | m_dc.SetTextForeground(m_colFgOld); | |
1161 | } | |
1162 | ||
1163 | void Set(const wxColour& col) | |
1164 | { | |
1165 | if ( !m_colFgOld.Ok() ) | |
1166 | m_colFgOld = m_dc.GetTextForeground(); | |
1167 | m_dc.SetTextForeground(col); | |
1168 | } | |
1169 | ||
1170 | private: | |
1171 | wxDC& m_dc; | |
1172 | ||
1173 | wxColour m_colFgOld; | |
fc7a2a60 VZ |
1174 | |
1175 | DECLARE_NO_COPY_CLASS(wxDCTextColourChanger) | |
1e6feb95 VZ |
1176 | }; |
1177 | ||
4660e6ac WS |
1178 | // ---------------------------------------------------------------------------- |
1179 | // helper class: you can use it to temporarily change the DC pen and | |
1180 | // restore it automatically when the object goes out of scope | |
1181 | // ---------------------------------------------------------------------------- | |
1182 | ||
53a2db12 | 1183 | class WXDLLIMPEXP_CORE wxDCPenChanger |
4660e6ac WS |
1184 | { |
1185 | public: | |
0164f8eb WS |
1186 | wxDCPenChanger(wxDC& dc, const wxPen& pen) : m_dc(dc), m_penOld(dc.GetPen()) |
1187 | { | |
1188 | m_dc.SetPen(pen); | |
1189 | } | |
4660e6ac WS |
1190 | |
1191 | ~wxDCPenChanger() | |
1192 | { | |
1193 | if ( m_penOld.Ok() ) | |
1194 | m_dc.SetPen(m_penOld); | |
1195 | } | |
1196 | ||
4660e6ac WS |
1197 | private: |
1198 | wxDC& m_dc; | |
1199 | ||
1200 | wxPen m_penOld; | |
1201 | ||
1202 | DECLARE_NO_COPY_CLASS(wxDCPenChanger) | |
1203 | }; | |
1204 | ||
1205 | // ---------------------------------------------------------------------------- | |
1206 | // helper class: you can use it to temporarily change the DC brush and | |
1207 | // restore it automatically when the object goes out of scope | |
1208 | // ---------------------------------------------------------------------------- | |
1209 | ||
53a2db12 | 1210 | class WXDLLIMPEXP_CORE wxDCBrushChanger |
4660e6ac WS |
1211 | { |
1212 | public: | |
0164f8eb WS |
1213 | wxDCBrushChanger(wxDC& dc, const wxBrush& brush) : m_dc(dc), m_brushOld(dc.GetBrush()) |
1214 | { | |
1215 | m_dc.SetBrush(brush); | |
1216 | } | |
4660e6ac WS |
1217 | |
1218 | ~wxDCBrushChanger() | |
1219 | { | |
1220 | if ( m_brushOld.Ok() ) | |
1221 | m_dc.SetBrush(m_brushOld); | |
1222 | } | |
1223 | ||
4660e6ac WS |
1224 | private: |
1225 | wxDC& m_dc; | |
1226 | ||
1227 | wxBrush m_brushOld; | |
1228 | ||
1229 | DECLARE_NO_COPY_CLASS(wxDCBrushChanger) | |
1230 | }; | |
1231 | ||
e26be42b VZ |
1232 | // ---------------------------------------------------------------------------- |
1233 | // another small helper class: sets the clipping region in its ctor and | |
1234 | // destroys it in the dtor | |
1235 | // ---------------------------------------------------------------------------- | |
1236 | ||
53a2db12 | 1237 | class WXDLLIMPEXP_CORE wxDCClipper |
e26be42b VZ |
1238 | { |
1239 | public: | |
fc298ea7 | 1240 | wxDCClipper(wxDC& dc, const wxRegion& r) : m_dc(dc) |
fdaad94e | 1241 | { dc.SetClippingRegion(r.GetBox()); } |
e26be42b VZ |
1242 | wxDCClipper(wxDC& dc, const wxRect& r) : m_dc(dc) |
1243 | { dc.SetClippingRegion(r.x, r.y, r.width, r.height); } | |
1244 | wxDCClipper(wxDC& dc, wxCoord x, wxCoord y, wxCoord w, wxCoord h) : m_dc(dc) | |
1245 | { dc.SetClippingRegion(x, y, w, h); } | |
1246 | ||
1247 | ~wxDCClipper() { m_dc.DestroyClippingRegion(); } | |
1248 | ||
1249 | private: | |
1250 | wxDC& m_dc; | |
fc7a2a60 VZ |
1251 | |
1252 | DECLARE_NO_COPY_CLASS(wxDCClipper) | |
e26be42b VZ |
1253 | }; |
1254 | ||
c48d6cdf FM |
1255 | // ---------------------------------------------------------------------------- |
1256 | // helper class: you can use it to temporarily change the DC font and | |
1257 | // restore it automatically when the object goes out of scope | |
1258 | // ---------------------------------------------------------------------------- | |
1259 | ||
1260 | class WXDLLIMPEXP_CORE wxDCFontChanger | |
1261 | { | |
1262 | public: | |
1263 | wxDCFontChanger(wxDC& dc, const wxFont& font) : m_dc(dc), m_fontOld(dc.GetFont()) | |
1264 | { | |
1265 | m_dc.SetFont(font); | |
1266 | } | |
1267 | ||
1268 | ~wxDCFontChanger() | |
1269 | { | |
1270 | if ( m_fontOld.Ok() ) | |
1271 | m_dc.SetFont(m_fontOld); | |
1272 | } | |
1273 | ||
1274 | private: | |
1275 | wxDC& m_dc; | |
1276 | ||
1277 | wxFont m_fontOld; | |
1278 | ||
1279 | DECLARE_NO_COPY_CLASS(wxDCFontChanger) | |
1280 | }; | |
1281 | ||
1282 | ||
8b56b16a | 1283 | #endif // _WX_DC_H_BASE_ |