wxPython/src/_graphics.i

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        _graphics.i
   3 // Purpose:     Wrapper definitions for wx.GraphicsPath, wx.GraphicsContext
   4 //
   5 // Author:      Robin Dunn
   6 //
   7 // Created:     2-Oct-2006
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 2006 by Total Control Software
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 // Not a %module
  14
  15
  16 //---------------------------------------------------------------------------
  17 %newgroup
  18
  19 %{
  20 #include <wx/graphics.h>
  21 %}
  22
  23 // Turn off the aquisition of the Global Interpreter Lock for the classes and
  24 // functions in this file
  25 %threadWrapperOff
  26
  27
  28 //---------------------------------------------------------------------------
  29 //---------------------------------------------------------------------------
  30
  31 %{
  32 #if !wxUSE_GRAPHICS_CONTEXT
  33 // C++ stub classes for platforms or build configurations that don't have
  34 // wxGraphicsContext yet.
  35
  36
  37 class wxGraphicsObject : public wxObject
  38 {
  39 public :
  40     wxGraphicsObject( wxGraphicsRenderer*  ) {
  41         PyErr_SetString(PyExc_NotImplementedError,
  42                         "wx.GraphicsObject is not available on this platform.");
  43     }
  44     wxGraphicsObject( const wxGraphicsObject&  ) {}
  45     virtual ~wxGraphicsObject() {}
  46     bool IsNull() const { return false; }
  47     wxGraphicsRenderer* GetRenderer() const { return NULL; }
  48 } ;
  49
  50
  51
  52 class wxGraphicsPen : public wxGraphicsObject
  53 {
  54     wxGraphicsPen()  {}
  55     virtual ~wxGraphicsPen() {}
  56 } ;
  57 wxGraphicsPen wxNullGraphicsPen;
  58
  59
  60
  61 class wxGraphicsBrush : public wxGraphicsObject
  62 {
  63 public :
  64     wxGraphicsBrush() {}
  65     virtual ~wxGraphicsBrush() {}
  66 } ;
  67 wxGraphicsBrush wxNullGraphicsBrush;
  68
  69
  70
  71 class wxGraphicsFont : public wxGraphicsObject
  72 {
  73 public :
  74     wxGraphicsFont() {}
  75     virtual ~wxGraphicsFont() {}
  76 } ;
  77 wxGraphicsFont wxNullGraphicsFont;
  78
  79
  80
  81 class wxGraphicsPath : public wxGraphicsObject
  82 {
  83 public :
  84     wxGraphicsPath(wxGraphicsRenderer* ) {
  85         PyErr_SetString(PyExc_NotImplementedError,
  86                         "wx.GraphicsPath is not available on this platform.");
  87     }
  88     virtual ~wxGraphicsPath() {}
  89
  90     void MoveToPoint( wxDouble, wxDouble ) {}
  91     void MoveToPoint( const wxPoint2DDouble& ) {}
  92     void AddLineToPoint( wxDouble, wxDouble ) {}
  93     void AddLineToPoint( const wxPoint2DDouble& ) {}
  94     void AddCurveToPoint( wxDouble, wxDouble, wxDouble, wxDouble, wxDouble, wxDouble ) {}
  95     void AddCurveToPoint( const wxPoint2DDouble&, const wxPoint2DDouble&, const wxPoint2DDouble&) {}
  96     void AddPath( const wxGraphicsPath* ) {}
  97     void CloseSubpath() {}
  98     void GetCurrentPoint( wxDouble&, wxDouble&) {}
  99     wxPoint2DDouble GetCurrentPoint() { reutrn wxPoint2D(0,0); }
 100     void AddArc( wxDouble, wxDouble, wxDouble, wxDouble, wxDouble, bool ) {}
 101     void AddArc( const wxPoint2DDouble& , wxDouble, wxDouble , wxDouble , bool ) {}
 102
 103     void AddQuadCurveToPoint( wxDouble, wxDouble, wxDouble, wxDouble ) {}
 104     void AddRectangle( wxDouble, wxDouble, wxDouble, wxDouble ) {}
 105     void AddCircle( wxDouble, wxDouble, wxDouble ) {}
 106     void AddArcToPoint( wxDouble, wxDouble , wxDouble, wxDouble, wxDouble )  {}
 107
 108     void AddEllipse( wxDouble , wxDouble , wxDouble , wxDouble ) {}
 109     void AddRoundedRectangle( wxDouble , wxDouble , wxDouble , wxDouble , wxDouble ) {}
 110     void * GetNativePath() const { return NULL; }
 111     void UnGetNativePath(void *) {}
 112     void Transform( wxGraphicsMatrix* ) {}
 113     void GetBox(wxDouble *, wxDouble *, wxDouble *, wxDouble *) {}
 114     wxRect2D GetBox() { return wxRect2D(0,0,0,0); }
 115
 116     bool Contains( wxDouble , wxDouble , int ) { return false; }
 117     bool Contains( const wxPoint2DDouble& , int ) { return false; }
 118 };
 119 wxGraphicsPath wxNullGraphicsPath;
 120
 121
 122 class wxGraphicsMatrix : public wxGraphicsObject
 123 {
 124 public :
 125     wxGraphicsMatrix(wxGraphicsRenderer* ) {
 126         PyErr_SetString(PyExc_NotImplementedError,
 127                         "wx.GraphicsMatrix is not available on this platform.");
 128     }
 129     virtual ~wxGraphicsMatrix() {}
 130     virtual void Concat( const wxGraphicsMatrix * ) {}
 131     virtual void Copy( const wxGraphicsMatrix * )  {}
 132     virtual void Set(wxDouble , wxDouble , wxDouble , wxDouble ,
 133                      wxDouble , wxDouble ) {}
 134     virtual void Invert() {}
 135     virtual bool IsEqual( const wxGraphicsMatrix* t) const  {}
 136     virtual bool IsIdentity() { return false; }
 137     virtual void Translate( wxDouble , wxDouble ) {}
 138     virtual void Scale( wxDouble , wxDouble  ) {}
 139     virtual void Rotate( wxDouble  ) {}
 140     virtual void TransformPoint( wxDouble *, wxDouble * ) {}
 141     virtual void TransformDistance( wxDouble *, wxDouble * ) {}
 142     virtual void * GetNativeMatrix() const { return NULL; }
 143 };
 144 wxGraphicsMatrix wxNullGraphicsMatrix;
 145
 146
 147 class wxGraphicsContext : public wxGraphicsObject
 148 {
 149 public:
 150
 151     wxGraphicsContext(wxGraphicsRenderer* ) {
 152         PyErr_SetString(PyExc_NotImplementedError,
 153                         "wx.GraphicsContext is not available on this platform.");
 154     }
 155
 156     virtual ~wxGraphicsContext() {}
 157
 158     static wxGraphicsContext* Create( const wxWindowDC& )  {
 159         PyErr_SetString(PyExc_NotImplementedError,
 160                         "wx.GraphicsContext is not available on this platform.");
 161     }
 162
 163     static wxGraphicsContext* CreateFromNative( void *  )  {
 164         PyErr_SetString(PyExc_NotImplementedError,
 165                         "wx.GraphicsContext is not available on this platform.");
 166     }
 167
 168     static wxGraphicsContext* CreateFromNativeWindow( void *  )  {
 169         PyErr_SetString(PyExc_NotImplementedError,
 170                         "wx.GraphicsContext is not available on this platform.");
 171     }
 172
 173     static wxGraphicsContext* Create( wxWindow*  )  {
 174         PyErr_SetString(PyExc_NotImplementedError,
 175                         "wx.GraphicsContext is not available on this platform.");
 176     }
 177
 178     wxGraphicsPath * CreatePath()  { return NULL; }
 179
 180     virtual wxGraphicsPen CreatePen(const wxPen& )  { return NULL; }
 181
 182     virtual wxGraphicsBrush CreateBrush(const wxBrush& ) { return NULL; }
 183
 184     virtual wxGraphicsBrush CreateLinearGradientBrush( wxDouble , wxDouble , wxDouble , wxDouble ,
 185                                                         const wxColour&, const wxColour&) { return NULL; }
 186
 187     virtual wxGraphicsBrush CreateRadialGradientBrush( wxDouble xo, wxDouble yo,
 188                                                         wxDouble xc, wxDouble yc, wxDouble radius,
 189                                                         const wxColour &oColor, const wxColour &cColor) { return NULL; }
 190
 191     virtual wxGraphicsFont CreateFont( const wxFont &, const wxColour & )  { return NULL; }
 192
 193     virtual wxGraphicsMatrix* CreateMatrix( wxDouble, wxDouble, wxDouble, wxDouble,
 194                                             wxDouble, wxDouble)  { return NULL; }
 195
 196     virtual void PushState() {}
 197     virtual void PopState() {}
 198     virtual void Clip( const wxRegion & ) {}
 199     virtual void Clip( wxDouble , wxDouble , wxDouble , wxDouble  ) {}
 200     virtual void ResetClip() {}
 201     virtual void * GetNativeContext() { return NULL; }
 202     virtual void Translate( wxDouble , wxDouble ) {}
 203     virtual void Scale( wxDouble , wxDouble ) {}
 204     virtual void Rotate( wxDouble ) {}
 205     virtual void ConcatTransform( const wxGraphicsMatrix* ) {}
 206     virtual void SetTransform( const wxGraphicsMatrix* ) {}
 207     virtual void GetTransform( wxGraphicsMatrix* ) {}
 208
 209     virtual void SetPen( const wxGraphicsPen& ) {}
 210     void SetPen( const wxPen& ) {}
 211
 212     virtual void SetBrush( const wxGraphicsBrush& ) {}
 213     void SetBrush( const wxBrush& ) {}
 214
 215     virtual void SetFont( const wxGraphicsFont& ) {}
 216     void SetFont( const wxFont&, const wxColour& ) {}
 217
 218     virtual void StrokePath( const wxGraphicsPath * ) {}
 219     virtual void FillPath( const wxGraphicsPath *, int ) {}
 220     virtual void DrawPath( const wxGraphicsPath *, int ) {}
 221
 222     virtual void DrawText( const wxString &, wxDouble , wxDouble  )  {}
 223     virtual void DrawText( const wxString &, wxDouble , wxDouble , wxDouble ) {}
 224     virtual void GetTextExtent( const wxString &, wxDouble *, wxDouble *,
 225                                 wxDouble *, wxDouble * ) const {}
 226     virtual void GetPartialTextExtents(const wxString& , wxArrayDouble& ) const  {}
 227
 228     virtual void DrawBitmap( const wxBitmap &, wxDouble , wxDouble , wxDouble , wxDouble  )  {}
 229     virtual void DrawIcon( const wxIcon &, wxDouble , wxDouble , wxDouble , wxDouble  )  {}
 230
 231     virtual void StrokeLine( wxDouble , wxDouble , wxDouble , wxDouble ) {}
 232     virtual void StrokeLines( size_t , const wxPoint2DDouble *) {}
 233     virtual void StrokeLines( size_t , const wxPoint2DDouble *, const wxPoint2DDouble *) {}
 234     virtual void DrawLines( size_t , const wxPoint2DDouble *, int ) {}
 235     virtual void DrawRectangle( wxDouble , wxDouble , wxDouble , wxDouble ) {}
 236     virtual void DrawEllipse( wxDouble , wxDouble , wxDouble , wxDouble ) {}
 237     virtual void DrawRoundedRectangle( wxDouble  wxDouble , wxDouble , wxDouble , wxDouble ) {}
 238     virtual bool ShouldOffset() const { return false; }
 239 };
 240
 241
 242 class wxGraphicsRenderer : public wxObject
 243 {
 244 public :
 245     wxGraphicsRenderer() {
 246         PyErr_SetString(PyExc_NotImplementedError,
 247                         "wx.GraphicsRenderer is not available on this platform.");
 248     }
 249
 250     virtual ~wxGraphicsRenderer() {}
 251
 252     static wxGraphicsRenderer* GetDefaultRenderer(
 253         PyErr_SetString(PyExc_NotImplementedError,
 254                         "wx.GraphicsRenderer is not available on this platform.");
 255     );
 256
 257     virtual wxGraphicsContext * CreateContext( const wxWindowDC& ) { return NULL; }
 258     virtual wxGraphicsContext * CreateContextFromNativeContext( void *  ) { return NULL; }
 259     virtual wxGraphicsContext * CreateContextFromNativeWindow( void *  )  { return NULL; }
 260     virtual wxGraphicsContext * CreateContext( wxWindow*  ) { return NULL; }
 261
 262     virtual wxGraphicsPath * CreatePath()  { return NULL; }
 263
 264     virtual wxGraphicsMatrix * CreateMatrix( wxDouble , wxDouble , wxDouble , wxDouble ,
 265                                              wxDouble , wxDouble ) { return NULL; }
 266
 267     virtual wxGraphicsPen CreatePen(const wxPen& )  { return wxNullGaphicsPen; }
 268     virtual wxGraphicsBrush CreateBrush(const wxBrush&  )  { return wxNullGaphicsBrush; }
 269     virtual wxGraphicsBrush CreateLinearGradientBrush(xDouble , wxDouble , wxDouble , wxDouble ,
 270                                                       const wxColour&, const wxColour&)  { return wxNullGaphicsBrush; }
 271     virtual wxGraphicsBrush CreateRadialGradientBrush(wxDouble , wxDouble , wxDouble , wxDouble , wxDouble ,
 272                                                       const wxColour &, const wxColour &)  { return wxNullGaphicsBrush; }
 273     virtual wxGraphicsFont CreateFont( const wxFont & , const wxColour & ) { return wxNullGaphicsFont; }
 274 };
 275
 276
 277
 278 class wxGCDC: public wxWindowDC
 279 {
 280 public:
 281     wxGCDC(const wxWindowDC&) {
 282         wxPyBlock_t blocked = wxPyBeginBlockThreads();
 283         PyErr_SetString(PyExc_NotImplementedError,
 284                         "wxGCDC is not available on this platform.");
 285         wxPyEndBlockThreads(blocked);
 286      }
 287
 288     wxGCDC() {
 289         wxPyBlock_t blocked = wxPyBeginBlockThreads();
 290         PyErr_SetString(PyExc_NotImplementedError,
 291                         "wxGCDC is not available on this platform.");
 292         wxPyEndBlockThreads(blocked);
 293     }
 294
 295     virtual ~wxGCDC() {}
 296
 297     wxGraphicsContext* GetGraphicsContext() { return NULL; }
 298     void SetGraphicsContext( wxGraphicsContext* ) {}
 299 };
 300
 301 #endif
 302 %}
 303
 304 //---------------------------------------------------------------------------
 305 //---------------------------------------------------------------------------
 306
 307
 308 %typemap(in) (size_t points, wxPoint2D* points_array ) {
 309     $2 = wxPoint2D_LIST_helper($input, &$1);
 310     if ($2 == NULL) SWIG_fail;
 311 }
 312 %typemap(freearg) (size_t points, wxPoint2D* points_array ) {
 313     if ($2) delete [] $2;
 314 }
 315
 316
 317
 318 MustHaveApp(wxGraphicsPath);
 319 MustHaveApp(wxGraphicsContext);
 320 MustHaveApp(wxGCDC);
 321
 322 typedef double wxDouble;
 323
 324
 325 //---------------------------------------------------------------------------
 326
 327
 328 class wxGraphicsObject : public wxObject
 329 {
 330 public :
 331     wxGraphicsObject( wxGraphicsRenderer* renderer = NULL );
 332     virtual ~wxGraphicsObject();
 333     bool IsNull() const ;
 334     wxGraphicsRenderer* GetRenderer() const;
 335 };
 336
 337
 338 class wxGraphicsPen : public wxGraphicsObject
 339 {
 340 public :
 341     wxGraphicsPen();
 342     virtual ~wxGraphicsPen();
 343 };
 344
 345
 346 class wxGraphicsBrush : public wxGraphicsObject
 347 {
 348 public :
 349     wxGraphicsBrush();
 350     virtual ~wxGraphicsBrush();
 351 };
 352
 353
 354 class wxGraphicsFont : public wxGraphicsObject
 355 {
 356 public :
 357     wxGraphicsFont();
 358     virtual ~wxGraphicsFont();
 359 };
 360
 361
 362 //---------------------------------------------------------------------------
 363
 364 class wxGraphicsMatrix : public wxGraphicsObject
 365 {
 366 public :
 367     // wxGraphicsMatrix(wxGraphicsRenderer* renderer);     *** This class is an ABC
 368
 369     virtual ~wxGraphicsMatrix();
 370
 371     DocDeclStr(
 372         virtual void , Concat( const wxGraphicsMatrix& t ),
 373         "concatenates the matrix", "");
 374
 375     %extend  {
 376         DocStr(Copy,
 377                "Copy the passed in matrix to this one.", "");
 378         void Copy( const wxGraphicsMatrix& t ) {
 379             *self = t;
 380         }
 381     }
 382
 383
 384     DocDeclStr(
 385         virtual void , Set(wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0,
 386                            wxDouble tx=0.0, wxDouble ty=0.0),
 387         "sets the matrix to the respective values", "");
 388
 389
 390     DocDeclStr(
 391         virtual void , Invert(),
 392         "makes this the inverse matrix", "");
 393
 394
 395     DocDeclStr(
 396         virtual bool , IsEqual( const wxGraphicsMatrix& t) const,
 397         "returns true if the elements of the transformation matrix are equal", "");
 398
 399
 400     DocDeclStr(
 401         virtual bool , IsIdentity() const,
 402         "return true if this is the identity matrix", "");
 403
 404
 405     DocDeclStr(
 406         virtual void , Translate( wxDouble dx , wxDouble dy ),
 407         "add the translation to this matrix", "");
 408
 409
 410     DocDeclStr(
 411         virtual void , Scale( wxDouble xScale , wxDouble yScale ),
 412         "add the scale to this matrix", "");
 413
 414
 415     DocDeclStr(
 416         virtual void , Rotate( wxDouble angle ),
 417         "add the rotation to this matrix (radians)", "");
 418
 419
 420     DocDeclAStr(
 421         virtual void , TransformPoint( wxDouble *INOUT, wxDouble *INOUT ) const,
 422         "TransformPoint(self, x, y) --> (x, y)",
 423         "applies that matrix to the point", "");
 424
 425
 426     DocDeclAStr(
 427         virtual void , TransformDistance( wxDouble *INOUT, wxDouble *INOUT ) const,
 428         "TransformDistance(self, dx, dy) --> (dx, dy)",
 429         "applies the matrix except for translations", "");
 430
 431
 432     DocDeclStr(
 433         virtual void * , GetNativeMatrix() const,
 434         "returns the native representation", "");
 435 };
 436
 437 //---------------------------------------------------------------------------
 438
 439 class wxGraphicsPath : public wxGraphicsObject
 440 {
 441 public :
 442     //wxGraphicsPath(wxGraphicsRenderer* renderer);            *** This class is an ABC, so we can't allow instances to be created directly
 443     virtual ~wxGraphicsPath();
 444
 445
 446     %nokwargs MoveToPoint;
 447     DocStr(MoveToPoint,
 448         "Begins a new subpath at (x,y)", "");
 449     virtual void  MoveToPoint( wxDouble x, wxDouble y );
 450     void MoveToPoint( const wxPoint2D& p);
 451
 452
 453     %nokwargs AddLineToPoint;
 454     DocStr(AddLineToPoint,
 455         "Adds a straight line from the current point to (x,y) ", "");
 456     virtual void AddLineToPoint( wxDouble x, wxDouble y );
 457     void AddLineToPoint( const wxPoint2D& p);
 458
 459
 460     %nokwargs AddCurveToPoint;
 461     DocStr(AddCurveToPoint,
 462         "Adds a cubic Bezier curve from the current point, using two control
 463 points and an end point", "");
 464     virtual void AddCurveToPoint( wxDouble cx1, wxDouble cy1,
 465                                   wxDouble cx2, wxDouble cy2,
 466                                   wxDouble x, wxDouble y );
 467     void AddCurveToPoint( const wxPoint2D& c1, const wxPoint2D& c2, const wxPoint2D& e);
 468
 469
 470
 471     DocDeclStr(
 472         virtual void , AddPath( const wxGraphicsPath& path ),
 473         "adds another path", "");
 474
 475
 476     DocDeclStr(
 477         virtual void , CloseSubpath(),
 478         "closes the current sub-path", "");
 479
 480
 481     DocDeclStr(
 482         wxPoint2D , GetCurrentPoint() const,
 483         "Gets the last point of the current path, (0,0) if not yet set", "");
 484
 485
 486     %nokwargs AddArc;
 487     DocStr(AddArc,
 488         "Adds an arc of a circle centering at (x,y) with radius (r) from
 489 startAngle to endAngle", "");
 490     virtual void AddArc( wxDouble x, wxDouble y, wxDouble r,
 491                          wxDouble startAngle, wxDouble endAngle, bool clockwise );
 492     void AddArc( const wxPoint2D& c, wxDouble r, wxDouble startAngle, wxDouble endAngle, bool clockwise);
 493
 494
 495     DocDeclStr(
 496         virtual void , AddQuadCurveToPoint( wxDouble cx, wxDouble cy, wxDouble x, wxDouble y ),
 497         "Adds a quadratic Bezier curve from the current point, using a control
 498 point and an end point", "");
 499
 500
 501     DocDeclStr(
 502         virtual void , AddRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h ),
 503         "Appends a rectangle as a new closed subpath", "");
 504
 505
 506     DocDeclStr(
 507         virtual void , AddCircle( wxDouble x, wxDouble y, wxDouble r ),
 508         "Appends a circle as a new closed subpath with the given radius.", "");
 509
 510
 511     DocDeclStr(
 512         virtual void , AddArcToPoint( wxDouble x1, wxDouble y1 , wxDouble x2, wxDouble y2, wxDouble r ) ,
 513         "Draws a an arc to two tangents connecting (current) to (x1,y1) and (x1,y1)
 514 to (x2,y2), also a straight line from (current) to (x1,y1)", "");
 515
 516
 517     DocDeclStr(
 518         virtual void , AddEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h),
 519         "appends an ellipse", "");
 520
 521
 522     DocDeclStr(
 523         virtual void , AddRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius),
 524         "appends a rounded rectangle", "");
 525
 526
 527     DocDeclStr(
 528         virtual void * , GetNativePath() const,
 529         "returns the native path", "");
 530
 531
 532     DocDeclStr(
 533         virtual void , UnGetNativePath(void *p) const,
 534         "give the native path returned by GetNativePath() back (there might be some
 535 deallocations necessary)", "");
 536
 537
 538     DocDeclStr(
 539         virtual void , Transform( const wxGraphicsMatrix& matrix ),
 540         "transforms each point of this path by the matrix", "");
 541
 542
 543     DocDeclStr(
 544         wxRect2DDouble , GetBox() const,
 545         "gets the bounding box enclosing all points (possibly including control points)", "");
 546
 547
 548     %nokwargs Contains;
 549     DocStr(Contains,
 550         "", "");
 551     virtual bool Contains( wxDouble x, wxDouble y, int fillStyle = wxODDEVEN_RULE) const;
 552     bool Contains( const wxPoint2DDouble& c, int fillStyle = wxODDEVEN_RULE) const;
 553
 554 };
 555
 556
 557 //---------------------------------------------------------------------------
 558
 559 %immutable;
 560 const wxGraphicsPen     wxNullGraphicsPen;
 561 const wxGraphicsBrush   wxNullGraphicsBrush;
 562 const wxGraphicsFont    wxNullGraphicsFont;
 563 const wxGraphicsMatrix  wxNullGraphicsMatrix;
 564 const wxGraphicsPath    wxNullGraphicsPath;
 565 %mutable;
 566
 567 //---------------------------------------------------------------------------
 568
 569
 570 class wxGraphicsContext : public wxGraphicsObject
 571 {
 572 public:
 573     // wxGraphicsContext()         This is also an ABC, use Create to make an instance...
 574     virtual ~wxGraphicsContext();
 575
 576     %newobject Create;
 577     %nokwargs Create;
 578     %pythonAppend Create
 579         "val.__dc = args[0] # save a ref so the dc will not be deleted before self";
 580     static wxGraphicsContext* Create( const wxWindowDC& dc);
 581
 582     static wxGraphicsContext* Create( wxWindow* window ) ;
 583
 584     %newobject CreateFromNative;
 585     static wxGraphicsContext* CreateFromNative( void * context ) ;
 586
 587     %newobject CreateFromNative;
 588     static wxGraphicsContext* CreateFromNativeWindow( void * window ) ;
 589
 590
 591     DocDeclStr(
 592         virtual wxGraphicsPath , CreatePath(),
 593         "creates a path instance that corresponds to the type of graphics context, ie GDIPlus, Cairo, CoreGraphics ...", "");
 594
 595
 596     DocDeclStr(
 597         virtual wxGraphicsPen , CreatePen(const wxPen& pen),
 598         "", "");
 599
 600
 601     DocDeclStr(
 602         virtual wxGraphicsBrush , CreateBrush(const wxBrush& brush ),
 603         "", "");
 604
 605
 606     DocDeclStr(
 607         virtual wxGraphicsBrush ,
 608         CreateLinearGradientBrush( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2,
 609                                    const wxColour& c1, const wxColour& c2),
 610         "sets the brush to a linear gradient, starting at (x1,y1) with color c1
 611 to (x2,y2) with color c2", "");
 612
 613
 614     DocDeclStr(
 615         virtual wxGraphicsBrush ,
 616         CreateRadialGradientBrush( wxDouble xo, wxDouble yo, wxDouble xc, wxDouble yc, wxDouble radius,
 617                                    const wxColour &oColor, const wxColour &cColor),
 618         "sets the brush to a radial gradient originating at (xo,yc) with color
 619 oColor and ends on a circle around (xc,yc) with radius r and color
 620 cColor
 621 ", "");
 622
 623
 624     DocDeclStr(
 625         virtual wxGraphicsFont , CreateFont( const wxFont &font , const wxColour &col = *wxBLACK ),
 626         "sets the font", "");
 627
 628
 629     DocDeclStr(
 630         virtual wxGraphicsMatrix , CreateMatrix( wxDouble a=1.0, wxDouble b=0.0,
 631                                                  wxDouble c=0.0, wxDouble d=1.0,
 632                                                  wxDouble tx=0.0, wxDouble ty=0.0),
 633         "create a 'native' matrix corresponding to these values", "");
 634
 635
 636
 637     DocDeclStr(
 638         virtual void , PushState(),
 639         "push the current state of the context, ie the transformation matrix on a stack", "");
 640
 641
 642     DocDeclStr(
 643         virtual void , PopState(),
 644         "pops a stored state from the stack", "");
 645
 646
 647     DocDeclStrName(
 648         virtual void , Clip( const wxRegion &region ),
 649         "clips drawings to the region", "",
 650         ClipRegion);
 651
 652
 653     DocDeclStr(
 654         virtual void , Clip( wxDouble x, wxDouble y, wxDouble w, wxDouble h ),
 655         "clips drawings to the rect", "");
 656
 657
 658     DocDeclStr(
 659         virtual void , ResetClip(),
 660         "resets the clipping to original extent", "");
 661
 662
 663     DocDeclStr(
 664         virtual void * , GetNativeContext(),
 665         "returns the native context", "");
 666
 667
 668     DocDeclStr(
 669         virtual void , Translate( wxDouble dx , wxDouble dy ),
 670         "translate the current transformation matrix CTM of the context", "");
 671
 672
 673     DocDeclStr(
 674         virtual void , Scale( wxDouble xScale , wxDouble yScale ),
 675         "scale the current transformation matrix CTM of the context", "");
 676
 677
 678     DocDeclStr(
 679         virtual void , Rotate( wxDouble angle ),
 680         "rotate (radians) the current transformation matrix CTM of the context", "");
 681
 682
 683     DocDeclStr(
 684         virtual void , ConcatTransform( const wxGraphicsMatrix& matrix ),
 685         "concatenates this transform with the current transform of this context", "");
 686
 687
 688     DocDeclStr(
 689         virtual void , SetTransform( const wxGraphicsMatrix& matrix ),
 690         "sets the transform of this context", "");
 691
 692
 693     DocDeclStr(
 694         virtual wxGraphicsMatrix , GetTransform() const,
 695         "gets the matrix of this context", "");
 696
 697
 698
 699
 700     DocStr(SetPen, "sets the stroke pen", "");
 701     %nokwargs SetPen;
 702     virtual void SetPen( const wxGraphicsPen& pen );
 703     void SetPen( const wxPen& pen );
 704
 705
 706     DocStr(SetBrush, "sets the brush for filling", "");
 707     %nokwargs SetBrush;
 708     virtual void SetBrush( const wxGraphicsBrush& brush );
 709     void SetBrush( const wxBrush& brush );
 710
 711
 712     DocStr(SetFont, "sets the font", "");
 713     %nokwargs SetFont;
 714     virtual void SetFont( const wxGraphicsFont& font );
 715     void SetFont( const wxFont& font, const wxColour& colour = *wxBLACK);
 716
 717
 718
 719     DocDeclStr(
 720         virtual void , StrokePath( const wxGraphicsPath& path ),
 721         "strokes along a path with the current pen", "");
 722
 723
 724     DocDeclStr(
 725         virtual void , FillPath( const wxGraphicsPath& path, int fillStyle = wxODDEVEN_RULE ),
 726         "fills a path with the current brush", "");
 727
 728
 729     DocDeclStr(
 730         virtual void , DrawPath( const wxGraphicsPath& path, int fillStyle = wxODDEVEN_RULE ),
 731         "draws a path by first filling and then stroking", "");
 732
 733
 734     DocDeclStr(
 735         virtual void , DrawText( const wxString &str, wxDouble x, wxDouble y ),
 736         "", "");
 737
 738
 739     DocDeclStrName(
 740         virtual void , DrawText( const wxString &str, wxDouble x, wxDouble y, wxDouble angle ),
 741         "", "",
 742         DrawRotatedText);
 743
 744
 745     DocDeclAStrName(
 746         virtual void , GetTextExtent( const wxString &text,
 747                                       wxDouble *OUTPUT /*width*/,
 748                                       wxDouble *OUTPUT /*height*/,
 749                                       wxDouble *OUTPUT /*descent*/,
 750                                       wxDouble *OUTPUT /*externalLeading*/ ) const ,
 751         "GetFullTextExtent(self, text) --> (width, height, descent, externalLeading)",
 752         "", "",
 753         GetFullTextExtent);
 754
 755     %extend {
 756         DocAStr(GetTextExtent,
 757                 "GetTextExtent(self, text) --> (width, height)",
 758                 "", "");
 759
 760         PyObject* GetTextExtent( const wxString &text )
 761         {
 762             wxDouble width = 0.0,
 763                      height = 0.0;
 764             self->GetTextExtent(text, &width, &height, NULL, NULL);
 765             // thread wrapers are turned off for this .i file, so no need to acquire GIL...
 766             PyObject* rv = PyTuple_New(2);
 767             PyTuple_SET_ITEM(rv, 0, PyFloat_FromDouble(width));
 768             PyTuple_SET_ITEM(rv, 1, PyFloat_FromDouble(height));
 769             return rv;
 770         }
 771     }
 772
 773
 774     %extend {
 775         DocAStr(GetPartialTextExtents,
 776                 "GetPartialTextExtents(self, text) -> [widths]",
 777                 "", "");
 778         wxArrayDouble GetPartialTextExtents(const wxString& text) {
 779             wxArrayDouble widths;
 780             self->GetPartialTextExtents(text, widths);
 781             return widths;
 782         }
 783     }
 784
 785
 786     DocDeclStr(
 787         virtual void , DrawBitmap( const wxBitmap &bmp, wxDouble x, wxDouble y, wxDouble w, wxDouble h ),
 788         "", "");
 789
 790
 791     DocDeclStr(
 792         virtual void , DrawIcon( const wxIcon &icon, wxDouble x, wxDouble y, wxDouble w, wxDouble h ),
 793         "", "");
 794
 795
 796
 797     DocDeclStr(
 798         virtual void , StrokeLine( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2),
 799         "strokes a single line", "");
 800
 801
 802     DocDeclAStr(
 803         virtual void , StrokeLines( size_t points, const wxPoint2D *points_array),
 804         "StrokeLines(self, List points)",
 805         "stroke lines connecting each of the points", "");
 806
 807
 808     %extend {
 809         DocStr(StrokeLineSegements,
 810                "stroke disconnected lines from begin to end points", "");
 811         void StrokeLineSegements(PyObject* beginPoints, PyObject* endPoints)
 812         {
 813             size_t c1, c2, count;
 814             wxPoint2D* beginP = wxPoint2D_LIST_helper(beginPoints, &c1);
 815             wxPoint2D* endP =   wxPoint2D_LIST_helper(endPoints, &c2);
 816
 817             if ( beginP != NULL && endP != NULL )
 818             {
 819                 count = wxMin(c1, c2);
 820                 self->StrokeLines(count, beginP, endP);
 821             }
 822             delete [] beginP;
 823             delete [] endP;
 824         }
 825     }
 826
 827
 828     DocDeclStr(
 829         virtual void , DrawLines( size_t points, const wxPoint2D *points_array,
 830                                   int fillStyle = wxODDEVEN_RULE ),
 831         "draws a polygon", "");
 832
 833
 834     DocDeclStr(
 835         virtual void , DrawRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h),
 836         "draws a rectangle", "");
 837
 838
 839     DocDeclStr(
 840         virtual void , DrawEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h),
 841         "draws an ellipse", "");
 842
 843
 844     DocDeclStr(
 845         virtual void , DrawRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius),
 846         "draws a rounded rectangle", "");
 847
 848
 849
 850     DocDeclStr(
 851         virtual bool , ShouldOffset() const,
 852         "helper to determine if a 0.5 offset should be applied for the drawing operation", "");
 853
 854 };
 855
 856
 857 //---------------------------------------------------------------------------
 858
 859 class wxGraphicsRenderer : public wxObject
 860 {
 861 public :
 862     // wxGraphicsRenderer();  This is an ABC, use GetDefaultRenderer
 863
 864     virtual ~wxGraphicsRenderer();
 865
 866     // %newobject GetDefaultRenderer;  ???
 867     static wxGraphicsRenderer* GetDefaultRenderer();
 868
 869     %nokwargs CreateContext;
 870     %newobject CreateContext;
 871     virtual wxGraphicsContext * CreateContext( const wxWindowDC& dc) ;
 872     virtual wxGraphicsContext * CreateContext( wxWindow* window );
 873
 874     %newobject CreateContextFromNativeContext;
 875     virtual wxGraphicsContext * CreateContextFromNativeContext( void * context );
 876
 877     %newobject CreateContextFromNativeWindow;
 878     virtual wxGraphicsContext * CreateContextFromNativeWindow( void * window );
 879
 880
 881     virtual wxGraphicsPath CreatePath();
 882
 883     virtual wxGraphicsMatrix CreateMatrix( wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0,
 884                                            wxDouble tx=0.0, wxDouble ty=0.0);
 885
 886     virtual wxGraphicsPen CreatePen(const wxPen& pen) ;
 887
 888     virtual wxGraphicsBrush CreateBrush(const wxBrush& brush ) ;
 889
 890     virtual wxGraphicsBrush CreateLinearGradientBrush( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2,
 891                                                         const wxColour&c1, const wxColour&c2);
 892
 893     virtual wxGraphicsBrush CreateRadialGradientBrush( wxDouble xo, wxDouble yo, wxDouble xc, wxDouble yc, wxDouble radius,
 894                                                         const wxColour &oColor, const wxColour &cColor);
 895
 896     virtual wxGraphicsFont CreateFont( const wxFont &font , const wxColour &col = *wxBLACK );
 897
 898 };
 899
 900
 901
 902 //---------------------------------------------------------------------------
 903
 904 %{
 905 #include "wx/dcgraph.h"
 906 %}
 907
 908 class wxGCDC: public wxDC
 909 {
 910 public:
 911     %pythonAppend wxGCDC
 912         "self.__dc = args[0] # save a ref so the other dc will not be deleted before self";
 913     wxGCDC(const wxWindowDC& dc);
 914     //wxGCDC();
 915     virtual ~wxGCDC();
 916
 917     wxGraphicsContext* GetGraphicsContext();
 918     virtual void SetGraphicsContext( wxGraphicsContext* ctx );
 919
 920     %property(GraphicsContext, GetGraphicsContext, SetGraphicsContext);
 921 };
 922
 923
 924 //---------------------------------------------------------------------------
 925
 926 // Turn GIL acquisition back on.
 927 %threadWrapperOn
 928