5 #pragma interface "dcbase.h"
6 #pragma implementation "dcbase.h"
9 // ----------------------------------------------------------------------------
10 // headers which we must include here
11 // ----------------------------------------------------------------------------
13 #include "wx/object.h" // the base class
15 #include "wx/cursor.h" // we have member variables of these classes
16 #include "wx/font.h" // so we can't do without them
17 #include "wx/colour.h"
20 #include "wx/palette.h"
22 #include "wx/list.h" // we use wxList in inline functions
24 // ---------------------------------------------------------------------------
26 // ---------------------------------------------------------------------------
28 // type which should be used (whenever possible, i.e. as long as it doesn't
29 // break compatibility) for screen coordinates
32 // ---------------------------------------------------------------------------
34 // ---------------------------------------------------------------------------
36 WXDLLEXPORT_DATA(extern int) wxPageNumber
;
38 // ---------------------------------------------------------------------------
39 // wxDC is the device context - object on which any drawing is done
40 // ---------------------------------------------------------------------------
42 class WXDLLEXPORT wxDCBase
: public wxObject
44 DECLARE_ABSTRACT_CLASS(wxDCBase
)
52 m_minX
= m_minY
= m_maxX
= m_maxY
= 0;
54 m_signX
= m_signY
= 1;
56 m_logicalOriginX
= m_logicalOriginY
=
57 m_deviceOriginX
= m_deviceOriginY
= 0;
59 m_logicalScaleX
= m_logicalScaleY
=
60 m_userScaleX
= m_userScaleY
=
61 m_scaleX
= m_scaleY
= 1.0;
63 m_logicalFunction
= -1;
65 m_backgroundMode
= wxTRANSPARENT
;
67 m_mappingMode
= wxMM_TEXT
;
69 m_backgroundBrush
= *wxWHITE_BRUSH
;
71 m_textForegroundColour
= *wxBLACK
;
72 m_textBackgroundColour
= *wxWHITE
;
74 m_colour
= wxColourDisplay();
79 virtual void BeginDrawing() { }
80 virtual void EndDrawing() { }
85 void FloodFill(long x
, long y
, const wxColour
& col
,
86 int style
= wxFLOOD_SURFACE
)
87 { DoFloodFill(x
, y
, col
, style
); }
88 void FloodFill(const wxPoint
& pt
, const wxColour
& col
,
89 int style
= wxFLOOD_SURFACE
)
90 { DoFloodFill(pt
.x
, pt
.y
, col
, style
); }
92 bool GetPixel(long x
, long y
, wxColour
*col
) const
93 { return DoGetPixel(x
, y
, col
); }
94 bool GetPixel(const wxPoint
& pt
, wxColour
*col
) const
95 { return DoGetPixel(pt
.x
, pt
.y
, col
); }
97 void DrawLine(long x1
, long y1
, long x2
, long y2
)
98 { DoDrawLine(x1
, y1
, x2
, y2
); }
99 void DrawLine(const wxPoint
& pt1
, const wxPoint
& pt2
)
100 { DoDrawLine(pt1
.x
, pt1
.y
, pt2
.x
, pt2
.y
); }
102 void CrossHair(long x
, long y
)
103 { DoCrossHair(x
, y
); }
104 void CrossHair(const wxPoint
& pt
)
105 { DoCrossHair(pt
.x
, pt
.y
); }
107 void DrawArc(long x1
, long y1
, long x2
, long y2
, long xc
, long yc
)
108 { DoDrawArc(x1
, y1
, x2
, y2
, xc
, yc
); }
109 void DrawArc(const wxPoint
& pt1
, const wxPoint
& pt2
, const wxPoint
& centre
)
110 { DoDrawArc(pt1
.x
, pt1
.y
, pt2
.x
, pt2
.y
, centre
.x
, centre
.y
); }
112 void DrawEllipticArc(long x
, long y
, long w
, long h
, double sa
, double ea
)
113 { DoDrawEllipticArc(x
, y
, w
, h
, sa
, ea
); }
114 void DrawEllipticArc(const wxPoint
& pt
, const wxSize
& sz
,
115 double sa
, double ea
)
116 { DoDrawEllipticArc(pt
.x
, pt
.y
, sz
.x
, sz
.y
, sa
, ea
); }
118 void DrawPoint(long x
, long y
)
119 { DoDrawPoint(x
, y
); }
120 void DrawPoint(const wxPoint
& pt
)
121 { DoDrawPoint(pt
.x
, pt
.y
); }
123 void DrawLines(int n
, wxPoint points
[], long xoffset
= 0, long yoffset
= 0)
124 { DoDrawLines(n
, points
, xoffset
, yoffset
); }
125 void DrawLines(const wxList
*list
, long xoffset
= 0, long yoffset
= 0)
127 int n
= list
->Number();
128 wxPoint
*points
= new wxPoint
[n
];
131 for ( wxNode
*node
= list
->First(); node
; node
= node
->Next(), i
++ )
133 wxPoint
*point
= (wxPoint
*)node
->Data();
134 points
[i
].x
= point
->x
;
135 points
[i
].y
= point
->y
;
138 DoDrawLines(n
, points
, xoffset
, yoffset
);
143 void DrawPolygon(int n
, wxPoint points
[],
144 long xoffset
= 0, long yoffset
= 0,
145 int fillStyle
= wxODDEVEN_RULE
)
146 { DoDrawPolygon(n
, points
, xoffset
, yoffset
, fillStyle
); }
148 void DrawPolygon(const wxList
*list
,
149 long xoffset
= 0, long yoffset
= 0,
150 int fillStyle
= wxODDEVEN_RULE
)
152 int n
= list
->Number();
153 wxPoint
*points
= new wxPoint
[n
];
156 for ( wxNode
*node
= list
->First(); node
; node
= node
->Next(), i
++ )
158 wxPoint
*point
= (wxPoint
*)node
->Data();
159 points
[i
].x
= point
->x
;
160 points
[i
].y
= point
->y
;
163 DoDrawPolygon(n
, points
, xoffset
, yoffset
, fillStyle
);
168 void DrawRectangle(long x
, long y
, long width
, long height
)
169 { DoDrawRectangle(x
, y
, width
, height
); }
170 void DrawRectangle(const wxPoint
& pt
, const wxSize
& sz
)
171 { DoDrawRectangle(pt
.x
, pt
.y
, sz
.x
, sz
.y
); }
172 void DrawRectangle(const wxRect
& rect
)
173 { DoDrawRectangle(rect
.x
, rect
.y
, rect
.width
, rect
.height
); }
175 void DrawRoundedRectangle(long x
, long y
, long width
, long height
,
177 { DoDrawRoundedRectangle(x
, y
, width
, height
, radius
); }
178 void DrawRoundedRectangle(const wxPoint
& pt
, const wxSize
& sz
,
180 { DoDrawRoundedRectangle(pt
.x
, pt
.y
, sz
.x
, sz
.y
, radius
); }
181 void DrawRoundedRectangle(const wxRect
& r
, double radius
)
182 { DoDrawRoundedRectangle(r
.x
, r
.y
, r
.width
, r
.height
, radius
); }
184 void DrawCircle(long x
, long y
, long radius
)
185 { DoDrawEllipse(x
- radius
, y
- radius
, 2*radius
, 2*radius
); }
186 void DrawEllipse(long x
, long y
, long width
, long height
)
187 { DoDrawEllipse(x
, y
, width
, height
); }
188 void DrawEllipse(const wxPoint
& pt
, const wxSize
& sz
)
189 { DoDrawEllipse(pt
.x
, pt
.y
, sz
.x
, sz
.y
); }
190 void DrawEllipse(const wxRect
& rect
)
191 { DoDrawEllipse(rect
.x
, rect
.y
, rect
.width
, rect
.height
); }
193 void DrawIcon(const wxIcon
& icon
, long x
, long y
)
194 { DoDrawIcon(icon
, x
, y
); }
195 void DrawIcon(const wxIcon
& icon
, const wxPoint
& pt
)
196 { DoDrawIcon(icon
, pt
.x
, pt
.y
); }
198 void DrawBitmap(const wxBitmap
&bmp
, long x
, long y
, bool useMask
= FALSE
)
199 { DoDrawBitmap(bmp
, x
, y
, useMask
); }
200 void DrawBitmap(const wxBitmap
&bmp
, const wxPoint
& pt
,
201 bool useMask
= FALSE
)
202 { DoDrawBitmap(bmp
, pt
.x
, pt
.y
, useMask
); }
204 void DrawText(const wxString
& text
, long x
, long y
)
205 { DoDrawText(text
, x
, y
); }
206 void DrawText(const wxString
& text
, const wxPoint
& pt
)
207 { DoDrawText(text
, pt
.x
, pt
.y
); }
209 bool Blit(long xdest
, long ydest
, long width
, long height
,
210 wxDC
*source
, long xsrc
, long ysrc
,
211 int rop
= wxCOPY
, bool useMask
= FALSE
)
213 return DoBlit(xdest
, ydest
, width
, height
,
214 source
, xsrc
, ysrc
, rop
, useMask
);
216 bool Blit(const wxPoint
& destPt
, const wxSize
& sz
,
217 wxDC
*source
, const wxPoint
& srcPt
,
218 int rop
= wxCOPY
, bool useMask
= FALSE
)
220 return DoBlit(destPt
.x
, destPt
.y
, sz
.x
, sz
.y
,
221 source
, srcPt
.x
, srcPt
.y
, rop
, useMask
);
225 // TODO: this API needs fixing (wxPointList, why (!const) "wxList *"?)
226 void DrawSpline(long x1
, long y1
, long x2
, long y2
, long x3
, long y3
)
230 wxPoint
*point1
= new wxPoint
;
231 point1
->x
= x1
; point1
->y
= y1
;
232 point_list
.Append((wxObject
*)point1
);
234 wxPoint
*point2
= new wxPoint
;
235 point2
->x
= x2
; point2
->y
= y2
;
236 point_list
.Append((wxObject
*)point2
);
238 wxPoint
*point3
= new wxPoint
;
239 point3
->x
= x3
; point3
->y
= y3
;
240 point_list
.Append((wxObject
*)point3
);
242 DrawSpline(&point_list
);
244 for( wxNode
*node
= point_list
.First(); node
; node
= node
->Next() )
246 wxPoint
*p
= (wxPoint
*)node
->Data();
251 void DrawSpline(int n
, wxPoint points
[])
254 for (int i
=0; i
< n
; i
++)
256 list
.Append((wxObject
*)&points
[i
]);
262 void DrawSpline(wxList
*points
) { DoDrawSpline(points
); }
263 #endif // wxUSE_SPLINES
265 // global DC operations
266 // --------------------
268 virtual void Clear() = 0;
270 virtual bool StartDoc(const wxString
& message
) = 0;
271 virtual void EndDoc() = 0;
273 virtual void StartPage() = 0;
274 virtual void EndPage() = 0;
276 // set objects to use for drawing
277 // ------------------------------
279 virtual void SetFont(const wxFont
& font
) = 0;
280 virtual void SetPen(const wxPen
& pen
) = 0;
281 virtual void SetBrush(const wxBrush
& brush
) = 0;
282 virtual void SetBackground(const wxBrush
& brush
) = 0;
283 virtual void SetBackgroundMode(int mode
) = 0;
284 virtual void SetPalette(const wxPalette
& palette
) = 0;
289 void SetClippingRegion(long x
, long y
, long width
, long height
)
290 { DoSetClippingRegion(x
, y
, width
, height
); }
291 void SetClippingRegion(const wxPoint
& pt
, const wxSize
& sz
)
292 { DoSetClippingRegion(pt
.x
, pt
.y
, sz
.x
, sz
.y
); }
293 void SetClippingRegion(const wxRect
& rect
)
294 { DoSetClippingRegion(rect
.x
, rect
.y
, rect
.width
, rect
.height
); }
295 void SetClippingRegion(const wxRegion
& region
)
296 { DoSetClippingRegionAsRegion(region
); }
298 virtual void DestroyClippingRegion() = 0;
300 void GetClippingBox(long *x
, long *y
, long *w
, long *h
) const
301 { DoGetClippingBox(x
, y
, w
, h
); }
302 void GetClippingBox(wxRect
& rect
) const
303 { DoGetClippingBox(&rect
.x
, &rect
.y
, &rect
.width
, &rect
.height
); }
308 virtual long GetCharHeight() const = 0;
309 virtual long GetCharWidth() const = 0;
310 virtual void GetTextExtent(const wxString
& string
,
312 long *descent
= NULL
,
313 long *externalLeading
= NULL
,
314 wxFont
*theFont
= NULL
) const = 0;
316 // size and resolution
317 // -------------------
320 void GetSize(int *width
, int *height
) const
321 { DoGetSize(width
, height
); }
322 wxSize
GetSize() const
331 void GetSizeMM(int* width
, int* height
) const
332 { DoGetSizeMM(width
, height
); }
333 wxSize
GetSizeMM() const
341 // coordinates conversions
342 // -----------------------
344 // This group of functions does actual conversion of the input, as you'd
346 long DeviceToLogicalX(long x
) const;
347 long DeviceToLogicalY(long y
) const;
348 long DeviceToLogicalXRel(long x
) const;
349 long DeviceToLogicalYRel(long y
) const;
350 long LogicalToDeviceX(long x
) const;
351 long LogicalToDeviceY(long y
) const;
352 long LogicalToDeviceXRel(long x
) const;
353 long LogicalToDeviceYRel(long y
) const;
355 // query DC capabilities
356 // ---------------------
358 virtual bool CanDrawBitmap() const = 0;
359 virtual bool CanGetTextExtent() const = 0;
362 virtual int GetDepth() const = 0;
364 // Resolution in Pixels per inch
365 virtual wxSize
GetPPI() const = 0;
367 virtual bool Ok() const { return m_ok
; }
373 const wxBrush
& GetBackground() const { return m_backgroundBrush
; }
374 const wxBrush
& GetBrush() const { return m_brush
; }
375 const wxFont
& GetFont() const { return m_font
; }
376 const wxPen
& GetPen() const { return m_pen
; }
377 const wxColour
& GetTextBackground() const { return m_textBackgroundColour
; }
378 const wxColour
& GetTextForeground() const { return m_textForegroundColour
; }
381 wxBrush
& GetBackground() { return m_backgroundBrush
; }
382 wxBrush
& GetBrush() { return m_brush
; }
383 wxFont
& GetFont() { return m_font
; }
384 wxPen
& GetPen() { return m_pen
; }
385 wxColour
& GetTextBackground() { return m_textBackgroundColour
; }
386 wxColour
& GetTextForeground() { return m_textForegroundColour
; }
388 virtual void SetTextForeground(const wxColour
& colour
)
389 { m_textForegroundColour
= colour
; }
390 virtual void SetTextBackground(const wxColour
& colour
)
391 { m_textBackgroundColour
= colour
; }
393 int GetMapMode() const { return m_mappingMode
; }
394 virtual void SetMapMode(int mode
) = 0;
396 virtual void GetUserScale(double *x
, double *y
) const
398 if ( x
) *x
= m_userScaleX
;
399 if ( y
) *y
= m_userScaleY
;
401 virtual void SetUserScale(double x
, double y
) = 0;
403 virtual void GetLogicalScale(double *x
, double *y
)
405 if ( x
) *x
= m_logicalScaleX
;
406 if ( y
) *y
= m_logicalScaleY
;
408 virtual void SetLogicalScale(double x
, double y
)
414 void GetLogicalOrigin(long *x
, long *y
) const
415 { DoGetLogicalOrigin(x
, y
); }
416 wxPoint
GetLogicalOrigin() const
417 { long x
, y
; DoGetLogicalOrigin(&x
, &y
); return wxPoint(x
, y
); }
418 virtual void SetLogicalOrigin(long x
, long y
) = 0;
420 void GetDeviceOrigin(long *x
, long *y
) const
421 { DoGetDeviceOrigin(x
, y
); }
422 wxPoint
GetDeviceOrigin() const
423 { long x
, y
; DoGetDeviceOrigin(&x
, &y
); return wxPoint(x
, y
); }
424 virtual void SetDeviceOrigin(long x
, long y
) = 0;
426 virtual void SetAxisOrientation(bool xLeftRight
, bool yBottomUp
) = 0;
428 int GetLogicalFunction() const { return m_logicalFunction
; }
429 virtual void SetLogicalFunction(int function
) = 0;
431 // Sometimes we need to override optimization, e.g. if other software is
432 // drawing onto our surface and we can't be sure of who's done what.
434 // FIXME: is this (still) used?
435 virtual void SetOptimization(bool WXUNUSED(opt
)) { }
436 virtual bool GetOptimization() { return FALSE
; }
441 virtual void CalcBoundingBox(long x
, long y
)
443 if (x
< m_minX
) m_minX
= x
;
444 if (y
< m_minY
) m_minY
= y
;
445 if (x
> m_maxX
) m_maxX
= x
;
446 if (y
> m_maxY
) m_maxY
= y
;
449 // Get the final bounding box of the PostScript or Metafile picture.
450 long MinX() const { return m_minX
; }
451 long MaxX() const { return m_maxX
; }
452 long MinY() const { return m_minY
; }
453 long MaxY() const { return m_maxY
; }
455 // misc old functions
456 // ------------------
458 #if WXWIN_COMPATIBILITY
459 virtual void SetColourMap(const wxPalette
& palette
) { SetPalette(palette
); }
460 void GetTextExtent(const wxString
& string
, float *x
, float *y
,
461 float *descent
= NULL
, float *externalLeading
= NULL
,
462 wxFont
*theFont
= NULL
, bool use16bit
= FALSE
) const ;
463 void GetSize(float* width
, float* height
) const { int w
, h
; GetSize(& w
, & h
); *width
= w
; *height
= h
; }
464 void GetSizeMM(float *width
, float *height
) const { long w
, h
; GetSizeMM(& w
, & h
); *width
= (float) w
; *height
= (float) h
; }
465 #endif // WXWIN_COMPATIBILITY
468 // the pure virtual functions which should be implemented by wxDC
469 virtual void DoFloodFill(long x
, long y
, const wxColour
& col
,
470 int style
= wxFLOOD_SURFACE
) = 0;
472 virtual bool DoGetPixel(long x
, long y
, wxColour
*col
) const = 0;
474 virtual void DoDrawPoint(long x
, long y
) = 0;
475 virtual void DoDrawLine(long x1
, long y1
, long x2
, long y2
) = 0;
477 virtual void DoDrawArc(long x1
, long y1
,
479 long xc
, long yc
) = 0;
480 virtual void DoDrawEllipticArc(long x
, long y
, long w
, long h
,
481 double sa
, double ea
) = 0;
483 virtual void DoDrawRectangle(long x
, long y
, long width
, long height
) = 0;
484 virtual void DoDrawRoundedRectangle(long x
, long y
,
485 long width
, long height
,
487 virtual void DoDrawEllipse(long x
, long y
, long width
, long height
) = 0;
489 virtual void DoCrossHair(long x
, long y
) = 0;
491 virtual void DoDrawIcon(const wxIcon
& icon
, long x
, long y
) = 0;
492 virtual void DoDrawBitmap(const wxBitmap
&bmp
, long x
, long y
,
493 bool useMask
= FALSE
) = 0;
495 virtual void DoDrawText(const wxString
& text
, long x
, long y
) = 0;
497 virtual bool DoBlit(long xdest
, long ydest
, long width
, long height
,
498 wxDC
*source
, long xsrc
, long ysrc
,
499 int rop
= wxCOPY
, bool useMask
= FALSE
) = 0;
501 virtual void DoGetSize(int *width
, int *height
) const = 0;
502 virtual void DoGetSizeMM(int* width
, int* height
) const = 0;
504 virtual void DoDrawLines(int n
, wxPoint points
[],
505 long xoffset
, long yoffset
) = 0;
506 virtual void DoDrawPolygon(int n
, wxPoint points
[],
507 long xoffset
, long yoffset
,
508 int fillStyle
= wxODDEVEN_RULE
) = 0;
510 virtual void DoSetClippingRegionAsRegion(const wxRegion
& region
) = 0;
511 virtual void DoSetClippingRegion(long x
, long y
,
512 long width
, long height
) = 0;
514 // FIXME are these functions really different?
515 virtual void DoGetClippingRegion(long *x
, long *y
,
517 { DoGetClippingBox(x
, y
, w
, h
); }
518 virtual void DoGetClippingBox(long *x
, long *y
,
519 long *w
, long *h
) const
523 if ( x
) *x
= m_clipX1
;
524 if ( y
) *y
= m_clipY1
;
525 if ( w
) *w
= m_clipX2
- m_clipX1
;
526 if ( h
) *h
= m_clipY2
- m_clipY1
;
530 *x
= *y
= *w
= *h
= 0;
534 virtual void DoGetLogicalOrigin(long *x
, long *y
) const
536 if ( x
) *x
= m_logicalOriginX
;
537 if ( y
) *y
= m_logicalOriginY
;
540 virtual void DoGetDeviceOrigin(long *x
, long *y
) const
542 if ( x
) *x
= m_deviceOriginX
;
543 if ( y
) *y
= m_deviceOriginY
;
547 virtual void DoDrawSpline(wxList
*points
) = 0;
555 bool m_isInteractive
:1;
557 // coordinate system variables
559 // TODO short descriptions of what exactly they are would be nice...
561 long m_logicalOriginX
, m_logicalOriginY
;
562 long m_deviceOriginX
, m_deviceOriginY
;
564 double m_logicalScaleX
, m_logicalScaleY
;
565 double m_userScaleX
, m_userScaleY
;
566 double m_scaleX
, m_scaleY
;
568 // Used by SetAxisOrientation() to invert the axes
569 int m_signX
, m_signY
;
571 // bounding and clipping boxes
572 long m_minX
, m_minY
, m_maxX
, m_maxY
;
573 long m_clipX1
, m_clipY1
, m_clipX2
, m_clipY2
;
575 int m_logicalFunction
;
576 int m_backgroundMode
;
582 wxBrush m_backgroundBrush
;
583 wxColour m_textForegroundColour
;
584 wxColour m_textBackgroundColour
;
589 DECLARE_NO_COPY_CLASS(wxDCBase
);
592 // ----------------------------------------------------------------------------
593 // now include the declaration of wxDC class
594 // ----------------------------------------------------------------------------
596 #if defined(__WXMSW__)
597 #include "wx/msw/dc.h"
598 #elif defined(__WXMOTIF__)
599 #include "wx/motif/dc.h"
600 #elif defined(__WXGTK__)
601 #include "wx/gtk/dc.h"
602 #elif defined(__WXQT__)
603 #include "wx/qt/dc.h"
604 #elif defined(__WXMAC__)
605 #include "wx/mac/dc.h"
606 #elif defined(__WXSTUBS__)
607 #include "wx/stubs/dc.h"