]> git.saurik.com Git - wxWidgets.git/blame - wxPython/src/_dc.i
Patches from KevinO that work around issues where the widget isn't
[wxWidgets.git] / wxPython / src / _dc.i
CommitLineData
d14a1e28
RD
1/////////////////////////////////////////////////////////////////////////////
2// Name: _dc.i
3// Purpose: SWIG interface defs for wxDC and releated classes
4//
5// Author: Robin Dunn
6//
7// Created: 7-July-1997
8// RCS-ID: $Id$
9// Copyright: (c) 2003 by Total Control Software
10// Licence: wxWindows license
11/////////////////////////////////////////////////////////////////////////////
12
13// Not a %module
14
15
4942342c 16
d14a1e28
RD
17//---------------------------------------------------------------------------
18
19%{
20#include "wx/wxPython/pydrawxxx.h"
21%}
22
23// TODO: 1. wrappers for wxDrawObject and wxDC::DrawObject
24
25
26//---------------------------------------------------------------------------
27
28%typemap(in) (int points, wxPoint* points_array ) {
29 $2 = wxPoint_LIST_helper($input, &$1);
30 if ($2 == NULL) SWIG_fail;
31}
32%typemap(freearg) (int points, wxPoint* points_array ) {
33 if ($2) delete [] $2;
34}
35
36
37//---------------------------------------------------------------------------
38%newgroup;
39
40
41// wxDC is the device context - object on which any drawing is done
42class wxDC : public wxObject {
43public:
44// wxDC(); **** abstract base class, can't instantiate.
45 ~wxDC();
46
47
48 virtual void BeginDrawing();
49 virtual void EndDrawing();
50
51
52// virtual void DrawObject(wxDrawObject* drawobject);
53
54
55
4942342c 56#if defined(wxUSE_DC_OLD_METHODS)
d14a1e28
RD
57
58 bool FloodFill(wxCoord x, wxCoord y, const wxColour& col, int style = wxFLOOD_SURFACE);
59 //bool GetPixel(wxCoord x, wxCoord y, wxColour *col) const;
60 %extend {
61 wxColour GetPixel(wxCoord x, wxCoord y) {
62 wxColour col;
63 self->GetPixel(x, y, &col);
64 return col;
65 }
66 }
67 void DrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2);
68 void CrossHair(wxCoord x, wxCoord y);
69 void DrawArc(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2, wxCoord xc, wxCoord yc);
70 void DrawCheckMark(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
71 void DrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h, double sa, double ea);
72 void DrawPoint(wxCoord x, wxCoord y);
73 void DrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
74 %name(DrawRectangleRect)void DrawRectangle(const wxRect& rect);
75 void DrawRoundedRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height, double radius);
76 void DrawCircle(wxCoord x, wxCoord y, wxCoord radius);
77 void DrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
78 void DrawIcon(const wxIcon& icon, wxCoord x, wxCoord y);
dd9f7fea 79 void DrawBitmap(const wxBitmap &bmp, wxCoord x, wxCoord y, bool useMask = False);
d14a1e28
RD
80 void DrawText(const wxString& text, wxCoord x, wxCoord y);
81 void DrawRotatedText(const wxString& text, wxCoord x, wxCoord y, double angle);
82 bool Blit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height,
83 wxDC *source, wxCoord xsrc, wxCoord ysrc,
dd9f7fea 84 int rop = wxCOPY, bool useMask = False,
d14a1e28
RD
85 wxCoord xsrcMask = -1, wxCoord ysrcMask = -1);
86
87
88
89#else // The new way
4942342c 90
d14a1e28
RD
91 %name(FloodFillXY) bool FloodFill(wxCoord x, wxCoord y, const wxColour& col, int style = wxFLOOD_SURFACE);
92 bool FloodFill(const wxPoint& pt, const wxColour& col, int style = wxFLOOD_SURFACE);
93
94 //%name(GetPixelXY) bool GetPixel(wxCoord x, wxCoord y, wxColour *col) const;
95 //bool GetPixel(const wxPoint& pt, wxColour *col) const;
96 %extend {
97 wxColour GetPixelXY(wxCoord x, wxCoord y) {
98 wxColour col;
99 self->GetPixel(x, y, &col);
100 return col;
101 }
102 wxColour GetPixel(const wxPoint& pt) {
103 wxColour col;
104 self->GetPixel(pt, &col);
105 return col;
106 }
107 }
108 %name(DrawLineXY) void DrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2);
109 void DrawLine(const wxPoint& pt1, const wxPoint& pt2);
110
111 %name(CrossHairXY) void CrossHair(wxCoord x, wxCoord y);
112 void CrossHair(const wxPoint& pt);
113
114 %name(DrawArcXY) void DrawArc(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2, wxCoord xc, wxCoord yc);
115 void DrawArc(const wxPoint& pt1, const wxPoint& pt2, const wxPoint& centre);
116
117 %name(DrawCheckMarkXY) void DrawCheckMark(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
118 void DrawCheckMark(const wxRect& rect);
119
120 %name(DrawEllipticArcXY) void DrawEllipticArc(wxCoord x, wxCoord y, wxCoord w, wxCoord h, double sa, double ea);
121 void DrawEllipticArc(const wxPoint& pt, const wxSize& sz, double sa, double ea);
122
123 %name(DrawPointXY) void DrawPoint(wxCoord x, wxCoord y);
124 void DrawPoint(const wxPoint& pt);
125
126 %name(DrawRectangleXY) void DrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
127 void DrawRectangle(const wxPoint& pt, const wxSize& sz);
128 %name(DrawRectangleRect) void DrawRectangle(const wxRect& rect);
129
130 %name(DrawRoundedRectangleXY) void DrawRoundedRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height, double radius);
131 void DrawRoundedRectangle(const wxPoint& pt, const wxSize& sz, double radius);
132 %name(DrawRoundedRectangleRect) void DrawRoundedRectangle(const wxRect& r, double radius);
133
134 %name(DrawCircleXY) void DrawCircle(wxCoord x, wxCoord y, wxCoord radius);
135 void DrawCircle(const wxPoint& pt, wxCoord radius);
136
137 %name(DrawEllipseXY) void DrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
138 void DrawEllipse(const wxPoint& pt, const wxSize& sz);
139 %name(DrawEllipseRect) void DrawEllipse(const wxRect& rect);
140
141 %name(DrawIconXY) void DrawIcon(const wxIcon& icon, wxCoord x, wxCoord y);
142 void DrawIcon(const wxIcon& icon, const wxPoint& pt);
143
dd9f7fea
RD
144 %name(DrawBitmapXY) void DrawBitmap(const wxBitmap &bmp, wxCoord x, wxCoord y, bool useMask = False);
145 void DrawBitmap(const wxBitmap &bmp, const wxPoint& pt, bool useMask = False);
d14a1e28
RD
146
147 %name(DrawTextXY) void DrawText(const wxString& text, wxCoord x, wxCoord y);
148 void DrawText(const wxString& text, const wxPoint& pt);
149
150 %name(DrawRotatedTextXY) void DrawRotatedText(const wxString& text, wxCoord x, wxCoord y, double angle);
151 void DrawRotatedText(const wxString& text, const wxPoint& pt, double angle);
152
4942342c 153
d14a1e28
RD
154 %name(BlitXY) bool Blit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height,
155 wxDC *source, wxCoord xsrc, wxCoord ysrc,
dd9f7fea 156 int rop = wxCOPY, bool useMask = False,
d14a1e28 157 wxCoord xsrcMask = -1, wxCoord ysrcMask = -1);
4942342c 158 bool Blit(const wxPoint& destPt, const wxSize& sz,
d14a1e28 159 wxDC *source, const wxPoint& srcPt,
dd9f7fea 160 int rop = wxCOPY, bool useMask = False,
d14a1e28
RD
161 const wxPoint& srcPtMask = wxDefaultPosition);
162
163#endif
4942342c 164
d14a1e28
RD
165 void DrawLines(int points, wxPoint* points_array, wxCoord xoffset = 0, wxCoord yoffset = 0);
166
167 void DrawPolygon(int points, wxPoint* points_array,
168 wxCoord xoffset = 0, wxCoord yoffset = 0,
169 int fillStyle = wxODDEVEN_RULE);
170
86aafce3
RD
171 // TODO: Figure out a good typemap for this...
172 // Convert the first 3 args from a sequence of sequences?
173// void DrawPolyPolygon(int n, int count[], wxPoint points[],
174// wxCoord xoffset = 0, wxCoord yoffset = 0,
175// int fillStyle = wxODDEVEN_RULE);
d14a1e28 176
86aafce3 177
d14a1e28
RD
178 // this version puts both optional bitmap and the text into the given
179 // rectangle and aligns is as specified by alignment parameter; it also
180 // will emphasize the character with the given index if it is != -1 and
181 // return the bounding rectangle if required
182 void DrawLabel(const wxString& text, const wxRect& rect,
183 int alignment = wxALIGN_LEFT | wxALIGN_TOP,
184 int indexAccel = -1);
185 %extend {
186 wxRect DrawImageLabel(const wxString& text,
187 const wxBitmap& image,
188 const wxRect& rect,
189 int alignment = wxALIGN_LEFT | wxALIGN_TOP,
190 int indexAccel = -1) {
191 wxRect rv;
192 self->DrawLabel(text, image, rect, alignment, indexAccel, &rv);
193 return rv;
194 }
195 }
196
197
198
199 void DrawSpline(int points, wxPoint* points_array);
200
201
4942342c 202
d14a1e28
RD
203 // global DC operations
204 // --------------------
205
206 virtual void Clear();
207
208 virtual bool StartDoc(const wxString& message);
209 virtual void EndDoc();
210
211 virtual void StartPage();
212 virtual void EndPage();
213
4942342c 214
d14a1e28
RD
215 // set objects to use for drawing
216 // ------------------------------
217
218 virtual void SetFont(const wxFont& font);
219 virtual void SetPen(const wxPen& pen);
220 virtual void SetBrush(const wxBrush& brush);
221 virtual void SetBackground(const wxBrush& brush);
222 virtual void SetBackgroundMode(int mode);
223 virtual void SetPalette(const wxPalette& palette);
224
4942342c 225
d14a1e28
RD
226 // clipping region
227 // ---------------
228
4da6d35e
RD
229 %name(SetClippingRegionXY)void SetClippingRegion(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
230 void SetClippingRegion(const wxPoint& pt, const wxSize& sz);
d14a1e28
RD
231 %name(SetClippingRect) void SetClippingRegion(const wxRect& rect);
232 %name(SetClippingRegionAsRegion) void SetClippingRegion(const wxRegion& region);
233
234 virtual void DestroyClippingRegion();
235
322913ce
RD
236 DocDeclA(
237 void, GetClippingBox(wxCoord *OUTPUT, wxCoord *OUTPUT, wxCoord *OUTPUT, wxCoord *OUTPUT) const,
238 "GetClippingBox() -> (x, y, width, height)");
4942342c 239
d14a1e28
RD
240 %extend {
241 wxRect GetClippingRect() {
242 wxRect rect;
243 self->GetClippingBox(rect);
244 return rect;
245 }
246 }
d14a1e28 247
4942342c
RD
248
249
d14a1e28
RD
250 // text extent
251 // -----------
252
253 virtual wxCoord GetCharHeight() const;
254 virtual wxCoord GetCharWidth() const;
255
d14a1e28 256
322913ce
RD
257 DocDeclAStr(
258 void, GetTextExtent(const wxString& string, wxCoord *OUTPUT, wxCoord *OUTPUT),
259 "GetTextExtent(wxString string) -> (width, height)",
260 "Get the width and height of the text using the current font.\n"
261 "Only works for single line strings.");
262 DocDeclAStrName(
263 void, GetTextExtent(const wxString& string,
4942342c 264 wxCoord *OUTPUT, wxCoord *OUTPUT, wxCoord *OUTPUT, wxCoord* OUTPUT,
322913ce
RD
265 wxFont* font = NULL),
266 "GetFullTextExtent(wxString string, Font font=None) ->\n (width, height, descent, externalLeading)",
267 "Get the width, height, decent and leading of the text using the current or specified font.\n"
268 "Only works for single line strings.",
269 GetFullTextExtent);
270
4942342c 271
322913ce
RD
272 // works for single as well as multi-line strings
273 DocDeclAStr(
274 void, GetMultiLineTextExtent(const wxString& text,
275 wxCoord *OUTPUT, wxCoord *OUTPUT, wxCoord *OUTPUT,
276 wxFont *font = NULL),
277 "GetMultiLineTextExtent(wxString string, Font font=None) ->\n (width, height, descent, externalLeading)",
278 "Get the width, height, decent and leading of the text using the current or specified font.\n"
279 "Works for single as well as multi-line strings.");
280
746ee6b8
RD
281
282 %extend {
283 wxArrayInt GetPartialTextExtents(const wxString& text) {
284 wxArrayInt widths;
285 self->GetPartialTextExtents(text, widths);
286 return widths;
287 }
288 }
289
d14a1e28
RD
290
291 // size and resolution
292 // -------------------
293
322913ce 294 DocStr(GetSize, "Get the DC size in device units.");
d14a1e28 295 wxSize GetSize();
322913ce
RD
296 DocDeclAName(
297 void, GetSize( int *OUTPUT, int *OUTPUT ),
298 "GetSizeTuple() -> (width, height)",
299 GetSizeTuple);
4942342c 300
d14a1e28 301
322913ce 302 DocStr(GetSizeMM, "Get the DC size in milimeters.");
d14a1e28 303 wxSize GetSizeMM() const;
322913ce
RD
304 DocDeclAName(
305 void, GetSizeMM( int *OUTPUT, int *OUTPUT ) const,
306 "GetSizeMMTuple() -> (width, height)",
307 GetSizeMMTuple);
4942342c
RD
308
309
d14a1e28
RD
310
311 // coordinates conversions
312 // -----------------------
313
314 // This group of functions does actual conversion of the input, as you'd
315 // expect.
316 wxCoord DeviceToLogicalX(wxCoord x) const;
317 wxCoord DeviceToLogicalY(wxCoord y) const;
318 wxCoord DeviceToLogicalXRel(wxCoord x) const;
319 wxCoord DeviceToLogicalYRel(wxCoord y) const;
320 wxCoord LogicalToDeviceX(wxCoord x) const;
321 wxCoord LogicalToDeviceY(wxCoord y) const;
322 wxCoord LogicalToDeviceXRel(wxCoord x) const;
323 wxCoord LogicalToDeviceYRel(wxCoord y) const;
324
325 // query DC capabilities
326 // ---------------------
327
328 virtual bool CanDrawBitmap() const;
329 virtual bool CanGetTextExtent() const;
330
331 // colour depth
332 virtual int GetDepth() const;
333
334 // Resolution in Pixels per inch
335 virtual wxSize GetPPI() const;
336
337 virtual bool Ok() const;
338
4942342c 339
d14a1e28
RD
340
341 int GetBackgroundMode() const;
342 const wxBrush& GetBackground() const;
343 const wxBrush& GetBrush() const;
344 const wxFont& GetFont() const;
345 const wxPen& GetPen() const;
346 const wxColour& GetTextBackground() const;
347 const wxColour& GetTextForeground() const;
348
349 virtual void SetTextForeground(const wxColour& colour);
350 virtual void SetTextBackground(const wxColour& colour);
351
352 int GetMapMode() const;
353 virtual void SetMapMode(int mode);
354
4942342c 355
322913ce
RD
356 DocDeclA(
357 virtual void, GetUserScale(double *OUTPUT, double *OUTPUT) const,
358 "GetUserScale() -> (xScale, yScale)");
4942342c 359
d14a1e28
RD
360 virtual void SetUserScale(double x, double y);
361
4942342c 362
322913ce
RD
363 DocDeclA(
364 virtual void, GetLogicalScale(double *OUTPUT, double *OUTPUT),
365 "GetLogicalScale() -> (xScale, yScale)");
366
d14a1e28
RD
367 virtual void SetLogicalScale(double x, double y);
368
322913ce 369
d14a1e28 370 wxPoint GetLogicalOrigin() const;
322913ce
RD
371 DocDeclAName(
372 void, GetLogicalOrigin(wxCoord *OUTPUT, wxCoord *OUTPUT) const,
373 "GetLogicalOriginTuple() -> (x,y)",
374 GetLogicalOriginTuple);
4942342c 375
d14a1e28
RD
376 virtual void SetLogicalOrigin(wxCoord x, wxCoord y);
377
4942342c 378
d14a1e28 379 wxPoint GetDeviceOrigin() const;
322913ce
RD
380 DocDeclAName(
381 void, GetDeviceOrigin(wxCoord *OUTPUT, wxCoord *OUTPUT) const,
382 "GetDeviceOriginTuple() -> (x,y)",
383 GetDeviceOriginTuple);
4942342c 384
d14a1e28
RD
385 virtual void SetDeviceOrigin(wxCoord x, wxCoord y);
386
387 virtual void SetAxisOrientation(bool xLeftRight, bool yBottomUp);
388
389 int GetLogicalFunction() const;
390 virtual void SetLogicalFunction(int function);
391
392 virtual void SetOptimization(bool opt);
393 virtual bool GetOptimization();
4942342c 394
d14a1e28
RD
395
396 // bounding box
397 // ------------
398
399 virtual void CalcBoundingBox(wxCoord x, wxCoord y);
400 void ResetBoundingBox();
401
402 // Get the final bounding box of the PostScript or Metafile picture.
403 wxCoord MinX() const;
404 wxCoord MaxX() const;
405 wxCoord MinY() const;
406 wxCoord MaxY() const;
407
408
322913ce
RD
409 DocA(GetBoundingBox,
410 "GetBoundingBox() -> (x1,y1, x2,y2)");
d14a1e28
RD
411 %extend {
412 void GetBoundingBox(int* OUTPUT, int* OUTPUT, int* OUTPUT, int* OUTPUT);
413 // See below for implementation
4942342c 414 }
d14a1e28
RD
415 %pythoncode { def __nonzero__(self): return self.Ok() };
416
417
418
419 %extend { // See drawlist.cpp for impplementaion of these...
420 PyObject* _DrawPointList(PyObject* pyCoords, PyObject* pyPens, PyObject* pyBrushes)
421 {
422 return wxPyDrawXXXList(*self, wxPyDrawXXXPoint, pyCoords, pyPens, pyBrushes);
423 }
424
425 PyObject* _DrawLineList(PyObject* pyCoords, PyObject* pyPens, PyObject* pyBrushes)
426 {
427 return wxPyDrawXXXList(*self, wxPyDrawXXXLine, pyCoords, pyPens, pyBrushes);
428 }
429
430 PyObject* _DrawRectangleList(PyObject* pyCoords, PyObject* pyPens, PyObject* pyBrushes)
431 {
432 return wxPyDrawXXXList(*self, wxPyDrawXXXRectangle, pyCoords, pyPens, pyBrushes);
433 }
434
435 PyObject* _DrawEllipseList(PyObject* pyCoords, PyObject* pyPens, PyObject* pyBrushes)
436 {
437 return wxPyDrawXXXList(*self, wxPyDrawXXXEllipse, pyCoords, pyPens, pyBrushes);
438 }
439
440 PyObject* _DrawPolygonList(PyObject* pyCoords, PyObject* pyPens, PyObject* pyBrushes)
441 {
442 return wxPyDrawXXXList(*self, wxPyDrawXXXPolygon, pyCoords, pyPens, pyBrushes);
443 }
444
445 PyObject* _DrawTextList(PyObject* textList, PyObject* pyPoints,
446 PyObject* foregroundList, PyObject* backgroundList) {
447 return wxPyDrawTextList(*self, textList, pyPoints, foregroundList, backgroundList);
448 }
449 }
450
451 %pythoncode {
452 def DrawPointList(self, points, pens=None):
453 if pens is None:
454 pens = []
455 elif isinstance(pens, wx.Pen):
456 pens = [pens]
457 elif len(pens) != len(points):
458 raise ValueError('points and pens must have same length')
459 return self._DrawPointList(points, pens, [])
460
461
462 def DrawLineList(self, lines, pens=None):
463 if pens is None:
464 pens = []
465 elif isinstance(pens, wx.Pen):
466 pens = [pens]
467 elif len(pens) != len(lines):
468 raise ValueError('lines and pens must have same length')
469 return self._DrawLineList(lines, pens, [])
470
471
472 def DrawRectangleList(self, rectangles, pens=None, brushes=None):
473 if pens is None:
474 pens = []
475 elif isinstance(pens, wx.Pen):
476 pens = [pens]
477 elif len(pens) != len(rectangles):
478 raise ValueError('rectangles and pens must have same length')
479 if brushes is None:
480 brushes = []
481 elif isinstance(brushes, wx.Brush):
482 brushes = [brushes]
483 elif len(brushes) != len(rectangles):
484 raise ValueError('rectangles and brushes must have same length')
485 return self._DrawRectangleList(rectangles, pens, brushes)
486
487
488 def DrawEllipseList(self, ellipses, pens=None, brushes=None):
489 if pens is None:
490 pens = []
491 elif isinstance(pens, wx.Pen):
492 pens = [pens]
493 elif len(pens) != len(ellipses):
494 raise ValueError('ellipses and pens must have same length')
495 if brushes is None:
496 brushes = []
497 elif isinstance(brushes, wx.Brush):
498 brushes = [brushes]
499 elif len(brushes) != len(ellipses):
500 raise ValueError('ellipses and brushes must have same length')
501 return self._DrawEllipseList(ellipses, pens, brushes)
502
503
504 def DrawPolygonList(self, polygons, pens=None, brushes=None):
4942342c
RD
505 %## Note: This does not currently support fill style or offset
506 %## you can always use the non-List version if need be.
d14a1e28
RD
507 if pens is None:
508 pens = []
509 elif isinstance(pens, wx.Pen):
510 pens = [pens]
511 elif len(pens) != len(polygons):
512 raise ValueError('polygons and pens must have same length')
513 if brushes is None:
514 brushes = []
515 elif isinstance(brushes, wx.Brush):
516 brushes = [brushes]
517 elif len(brushes) != len(polygons):
518 raise ValueError('polygons and brushes must have same length')
519 return self._DrawPolygonList(polygons, pens, brushes)
520
521
522 def DrawTextList(self, textList, coords, foregrounds = None, backgrounds = None, fonts = None):
4942342c
RD
523 %## NOTE: this does not currently support changing the font
524 %## Make sure you set Background mode to wxSolid (DC.SetBackgroundMode)
525 %## If you want backgounds to do anything.
d14a1e28
RD
526 if type(textList) == type(''):
527 textList = [textList]
528 elif len(textList) != len(coords):
529 raise ValueError('textlist and coords must have same length')
530 if foregrounds is None:
531 foregrounds = []
fd3f2efe 532 elif isinstance(foregrounds, wx.Colour):
d14a1e28
RD
533 foregrounds = [foregrounds]
534 elif len(foregrounds) != len(coords):
535 raise ValueError('foregrounds and coords must have same length')
536 if backgrounds is None:
537 backgrounds = []
fd3f2efe 538 elif isinstance(backgrounds, wx.Colour):
d14a1e28
RD
539 backgrounds = [backgrounds]
540 elif len(backgrounds) != len(coords):
541 raise ValueError('backgrounds and coords must have same length')
542 return self._DrawTextList(textList, coords, foregrounds, backgrounds)
543 }
544
545};
546
547
548
549%{
550static void wxDC_GetBoundingBox(wxDC* dc, int* x1, int* y1, int* x2, int* y2) {
551 *x1 = dc->MinX();
552 *y1 = dc->MinY();
553 *x2 = dc->MaxX();
554 *y2 = dc->MaxY();
555}
556%}
557
558
559//---------------------------------------------------------------------------
560%newgroup
561
562class wxMemoryDC : public wxDC {
563public:
564 wxMemoryDC();
565 %name(MemoryDCFromDC) wxMemoryDC(wxDC* oldDC);
4942342c 566
d14a1e28
RD
567 void SelectObject(const wxBitmap& bitmap);
568};
569
570//---------------------------------------------------------------------------
571%newgroup
572
b159c5c4 573
ef22e3d3 574%{
ef22e3d3 575#include <wx/dcbuffer.h>
ef22e3d3
RD
576%}
577
578
d14a1e28
RD
579class wxBufferedDC : public wxMemoryDC
580{
581public:
e608d228 582 %pythonAppend wxBufferedDC
d14a1e28 583 "self._dc = args[0] # save a ref so the other dc will not be deleted before self";
d14a1e28 584
b159c5c4
RD
585 %nokwargs wxBufferedDC;
586
d14a1e28
RD
587 // Construct a wxBufferedDC using a user supplied buffer.
588 wxBufferedDC( wxDC *dc, const wxBitmap &buffer );
589
b159c5c4
RD
590 // Construct a wxBufferedDC with an internal buffer of 'area'
591 // (where area is usually something like the size of the window
592 // being buffered)
7a0b15e9 593 wxBufferedDC( wxDC *dc, const wxSize &area );
b159c5c4 594
e608d228 595
b159c5c4 596 // TODO: Keep this one too?
7a0b15e9 597 %pythonAppend wxBufferedDC( wxDC *dc, const wxSize &area )
e608d228 598 "val._dc = args[0] # save a ref so the other dc will not be deleted before self";
7a0b15e9
RD
599 %name(BufferedDCInternalBuffer) wxBufferedDC( wxDC *dc, const wxSize &area );
600
601
602 // The buffer is blit to the real DC when the BufferedDC is destroyed.
603 ~wxBufferedDC();
d14a1e28 604
e608d228 605
b159c5c4
RD
606 // Blits the buffer to the dc, and detaches the dc from
607 // the buffer. Usually called in the dtor or by the dtor
608 // of derived classes if the BufferedDC must blit before
609 // the derived class (which may own the dc it's blitting
610 // to) is destroyed.
d14a1e28
RD
611 void UnMask();
612};
613
614
7a0b15e9
RD
615
616
617// Creates a double buffered wxPaintDC, optionally allowing the
618// user to specify their own buffer to use.
d14a1e28
RD
619class wxBufferedPaintDC : public wxBufferedDC
620{
621public:
b159c5c4 622
ef22e3d3 623 // If no bitmap is supplied by the user, a temporary one will be created.
7a0b15e9 624 wxBufferedPaintDC( wxWindow *window, const wxBitmap &buffer = wxNullBitmap );
b159c5c4 625
d14a1e28
RD
626};
627
628
629//---------------------------------------------------------------------------
630%newgroup
631
632class wxScreenDC : public wxDC {
633public:
634 wxScreenDC();
635
636 %name(StartDrawingOnTopWin) bool StartDrawingOnTop(wxWindow* window);
637 bool StartDrawingOnTop(wxRect* rect = NULL);
638 bool EndDrawingOnTop();
639};
640
641//---------------------------------------------------------------------------
642%newgroup
643
644class wxClientDC : public wxDC {
645public:
646 wxClientDC(wxWindow* win);
647};
648
649//---------------------------------------------------------------------------
650%newgroup
651
652class wxPaintDC : public wxDC {
653public:
654 wxPaintDC(wxWindow* win);
655};
656
657//---------------------------------------------------------------------------
658%newgroup
659
660class wxWindowDC : public wxDC {
661public:
662 wxWindowDC(wxWindow* win);
663};
664
665//---------------------------------------------------------------------------
666%newgroup
667
668class wxMirrorDC : public wxDC
669{
670public:
671 // constructs a mirror DC associated with the given real DC
672 //
dd9f7fea 673 // if mirror parameter is True, all vertical and horizontal coordinates are
d14a1e28
RD
674 // exchanged, otherwise this class behaves in exactly the same way as a
675 // plain DC
676 //
677 wxMirrorDC(wxDC& dc, bool mirror);
678};
679
680//---------------------------------------------------------------------------
681%newgroup
682
683%{
684#include <wx/dcps.h>
685%}
686
687class wxPostScriptDC : public wxDC {
688public:
689 wxPostScriptDC(const wxPrintData& printData);
690// %name(PostScriptDC2)wxPostScriptDC(const wxString& output,
dd9f7fea 691// bool interactive = True,
d14a1e28
RD
692// wxWindow* parent = NULL);
693
694 wxPrintData& GetPrintData();
695 void SetPrintData(const wxPrintData& data);
696
697 static void SetResolution(int ppi);
698 static int GetResolution();
699};
700
701//---------------------------------------------------------------------------
702%newgroup
703
704
da457c1b 705#if defined(__WXMSW__) || defined(__WXMAC__)
d14a1e28
RD
706
707%{
708#include <wx/metafile.h>
709%}
710
711class wxMetaFile : public wxObject {
712public:
713 wxMetaFile(const wxString& filename = wxPyEmptyString);
714 ~wxMetaFile();
715
716 bool Ok();
717 bool SetClipboard(int width = 0, int height = 0);
718
719 wxSize GetSize();
720 int GetWidth();
721 int GetHeight();
722
da457c1b 723#ifdef __WXMSW__
d14a1e28 724 const wxString& GetFileName() const;
da457c1b
RD
725#endif
726
d14a1e28
RD
727 %pythoncode { def __nonzero__(self): return self.Ok() }
728};
729
730// bool wxMakeMetaFilePlaceable(const wxString& filename,
731// int minX, int minY, int maxX, int maxY, float scale=1.0);
732
733
734class wxMetaFileDC : public wxDC {
735public:
736 wxMetaFileDC(const wxString& filename = wxPyEmptyString,
737 int width = 0, int height = 0,
738 const wxString& description = wxPyEmptyString);
739 wxMetaFile* Close();
740};
741
742
743
744#else // Make some dummies for the other platforms
745
746%{
747class wxMetaFile : public wxObject {
748public:
749 wxMetaFile(const wxString&)
81cfe5e1 750 { wxPyRaiseNotImplemented(); }
d14a1e28
RD
751};
752
753class wxMetaFileDC : public wxClientDC {
754public:
755 wxMetaFileDC(const wxString&, int, int, const wxString&)
81cfe5e1 756 { wxPyRaiseNotImplemented(); }
d14a1e28
RD
757};
758
759%}
760
761class wxMetaFile : public wxObject {
762public:
763 wxMetaFile(const wxString& filename = wxPyEmptyString);
764};
765
766class wxMetaFileDC : public wxDC {
767public:
768 wxMetaFileDC(const wxString& filename = wxPyEmptyString,
769 int width = 0, int height = 0,
770 const wxString& description = wxPyEmptyString);
771};
772
773
774#endif
775
776
777//---------------------------------------------------------------------------
778
779#if defined(__WXMSW__) || defined(__WXMAC__)
780
781class wxPrinterDC : public wxDC {
782public:
783 wxPrinterDC(const wxPrintData& printData);
784// %name(PrinterDC2) wxPrinterDC(const wxString& driver,
785// const wxString& device,
786// const wxString& output,
dd9f7fea 787// bool interactive = True,
d14a1e28
RD
788// int orientation = wxPORTRAIT);
789};
790
791#else
792%{
793class wxPrinterDC : public wxClientDC {
794public:
795 wxPrinterDC(const wxPrintData&)
81cfe5e1 796 { wxPyRaiseNotImplemented(); }
4942342c 797
d14a1e28 798// wxPrinterDC(const wxString&, const wxString&, const wxString&, bool, int)
81cfe5e1 799// { wxPyRaiseNotImplemented(); }
d14a1e28
RD
800};
801%}
4942342c 802
d14a1e28
RD
803class wxPrinterDC : public wxDC {
804public:
805 wxPrinterDC(const wxPrintData& printData);
806// %name(PrinterDC2) wxPrinterDC(const wxString& driver,
807// const wxString& device,
808// const wxString& output,
dd9f7fea 809// bool interactive = True,
d14a1e28
RD
810// int orientation = wxPORTRAIT);
811};
812#endif
813
4942342c
RD
814//---------------------------------------------------------------------------
815//---------------------------------------------------------------------------
816
817// Now define some Python classes that rename the Draw methods to be
818// compatible with the DC Draw methods in 2.4. See also wxPython/_wx.py.
819
820
821%define MAKE_OLD_DC_CLASS(classname)
822 %pythoncode {
823 class classname##_old(classname):
824 """DC class that has methods with 2.4 compatible parameters."""
825 FloodFill = classname.FloodFillXY
826 GetPixel = classname.GetPixelXY
827 DrawLine = classname.DrawLineXY
828 CrossHair = classname.CrossHairXY
829 DrawArc = classname.DrawArcXY
830 DrawCheckMark = classname.DrawCheckMarkXY
831 DrawEllipticArc = classname.DrawEllipticArcXY
832 DrawPoint = classname.DrawPointXY
833 DrawRectangle = classname.DrawRectangleXY
834 DrawRoundedRectangle = classname.DrawRoundedRectangleXY
835 DrawCircle = classname.DrawCircleXY
836 DrawEllipse = classname.DrawEllipseXY
837 DrawIcon = classname.DrawIconXY
838 DrawBitmap = classname.DrawBitmapXY
839 DrawText = classname.DrawTextXY
840 DrawRotatedText = classname.DrawRotatedTextXY
841 Blit = classname.BlitXY
842 }
843%enddef
844
845MAKE_OLD_DC_CLASS(DC);
846MAKE_OLD_DC_CLASS(MemoryDC);
847MAKE_OLD_DC_CLASS(BufferedDC);
848MAKE_OLD_DC_CLASS(BufferedPaintDC);
849MAKE_OLD_DC_CLASS(ScreenDC);
850MAKE_OLD_DC_CLASS(ClientDC);
851MAKE_OLD_DC_CLASS(PaintDC);
852MAKE_OLD_DC_CLASS(WindowDC);
853MAKE_OLD_DC_CLASS(MirrorDC);
854MAKE_OLD_DC_CLASS(PostScriptDC);
855MAKE_OLD_DC_CLASS(MetaFileDC);
856MAKE_OLD_DC_CLASS(PrinterDC);
857
858
d14a1e28 859//---------------------------------------------------------------------------