| 1 | ///////////////////////////////////////////////////////////////////////////// |
| 2 | // Name: wx/graphics.h |
| 3 | // Purpose: graphics context header |
| 4 | // Author: Stefan Csomor |
| 5 | // Modified by: |
| 6 | // Created: |
| 7 | // Copyright: (c) Stefan Csomor |
| 8 | // RCS-ID: $Id$ |
| 9 | // Licence: wxWindows licence |
| 10 | ///////////////////////////////////////////////////////////////////////////// |
| 11 | |
| 12 | #ifndef _WX_GRAPHICS_H_ |
| 13 | #define _WX_GRAPHICS_H_ |
| 14 | |
| 15 | #if wxUSE_GRAPHICS_CONTEXT |
| 16 | |
| 17 | #include "wx/geometry.h" |
| 18 | #include "wx/dynarray.h" |
| 19 | |
| 20 | class WXDLLIMPEXP_CORE wxWindowDC; |
| 21 | class WXDLLIMPEXP_CORE wxMemoryDC; |
| 22 | class WXDLLIMPEXP_CORE wxGraphicsContext; |
| 23 | class WXDLLIMPEXP_CORE wxGraphicsPath; |
| 24 | class WXDLLIMPEXP_CORE wxGraphicsMatrix; |
| 25 | class WXDLLIMPEXP_CORE wxGraphicsFigure; |
| 26 | class WXDLLIMPEXP_CORE wxGraphicsRenderer; |
| 27 | class WXDLLIMPEXP_CORE wxGraphicsPen; |
| 28 | class WXDLLIMPEXP_CORE wxGraphicsBrush; |
| 29 | class WXDLLIMPEXP_CORE wxGraphicsFont; |
| 30 | |
| 31 | /* |
| 32 | * notes about the graphics context apis |
| 33 | * |
| 34 | * angles : are measured in radians, 0.0 being in direction of positiv x axis, PI/2 being |
| 35 | * in direction of positive y axis. |
| 36 | */ |
| 37 | |
| 38 | // Base class of all objects used for drawing in the new graphics API, the always point back to their |
| 39 | // originating rendering engine, there is no dynamic unloading of a renderer currently allowed, |
| 40 | // these references are not counted |
| 41 | |
| 42 | // |
| 43 | // The data used by objects like graphics pens etc is ref counted, in order to avoid unnecessary expensive |
| 44 | // duplication. Any operation on a shared instance that results in a modified state, uncouples this |
| 45 | // instance from the other instances that were shared - using copy on write semantics |
| 46 | // |
| 47 | |
| 48 | class WXDLLIMPEXP_CORE wxGraphicsObjectRefData : public wxObjectRefData |
| 49 | { |
| 50 | public : |
| 51 | wxGraphicsObjectRefData( wxGraphicsRenderer* renderer ); |
| 52 | wxGraphicsObjectRefData( const wxGraphicsObjectRefData* data ); |
| 53 | wxGraphicsRenderer* GetRenderer() const ; |
| 54 | virtual wxGraphicsObjectRefData* Clone() const ; |
| 55 | |
| 56 | protected : |
| 57 | wxGraphicsRenderer* m_renderer; |
| 58 | } ; |
| 59 | |
| 60 | class WXDLLIMPEXP_CORE wxGraphicsObject : public wxObject |
| 61 | { |
| 62 | public : |
| 63 | wxGraphicsObject() ; |
| 64 | wxGraphicsObject( wxGraphicsRenderer* renderer ) ; |
| 65 | virtual ~wxGraphicsObject() ; |
| 66 | |
| 67 | bool IsNull() const ; |
| 68 | |
| 69 | // returns the renderer that was used to create this instance, or NULL if it has not been initialized yet |
| 70 | wxGraphicsRenderer* GetRenderer() const ; |
| 71 | wxGraphicsObjectRefData* GetGraphicsData() const ; |
| 72 | protected : |
| 73 | virtual wxObjectRefData* CreateRefData() const; |
| 74 | virtual wxObjectRefData* CloneRefData(const wxObjectRefData* data) const; |
| 75 | |
| 76 | DECLARE_DYNAMIC_CLASS(wxGraphicsObject) |
| 77 | } ; |
| 78 | |
| 79 | class WXDLLIMPEXP_CORE wxGraphicsPen : public wxGraphicsObject |
| 80 | { |
| 81 | public : |
| 82 | wxGraphicsPen() {} |
| 83 | virtual ~wxGraphicsPen() {} |
| 84 | private : |
| 85 | DECLARE_DYNAMIC_CLASS(wxGraphicsPen) |
| 86 | } ; |
| 87 | |
| 88 | extern WXDLLEXPORT_DATA(wxGraphicsPen) wxNullGraphicsPen; |
| 89 | |
| 90 | class WXDLLIMPEXP_CORE wxGraphicsBrush : public wxGraphicsObject |
| 91 | { |
| 92 | public : |
| 93 | wxGraphicsBrush() {} |
| 94 | virtual ~wxGraphicsBrush() {} |
| 95 | private : |
| 96 | DECLARE_DYNAMIC_CLASS(wxGraphicsBrush) |
| 97 | } ; |
| 98 | |
| 99 | extern WXDLLEXPORT_DATA(wxGraphicsBrush) wxNullGraphicsBrush; |
| 100 | |
| 101 | class WXDLLIMPEXP_CORE wxGraphicsFont : public wxGraphicsObject |
| 102 | { |
| 103 | public : |
| 104 | wxGraphicsFont() {} |
| 105 | virtual ~wxGraphicsFont() {} |
| 106 | private : |
| 107 | DECLARE_DYNAMIC_CLASS(wxGraphicsFont) |
| 108 | } ; |
| 109 | |
| 110 | extern WXDLLEXPORT_DATA(wxGraphicsFont) wxNullGraphicsFont; |
| 111 | |
| 112 | |
| 113 | class WXDLLIMPEXP_CORE wxGraphicsMatrixData : public wxGraphicsObjectRefData |
| 114 | { |
| 115 | public : |
| 116 | wxGraphicsMatrixData( wxGraphicsRenderer* renderer) : |
| 117 | wxGraphicsObjectRefData(renderer) {} |
| 118 | |
| 119 | virtual ~wxGraphicsMatrixData() {} |
| 120 | |
| 121 | // concatenates the matrix |
| 122 | virtual void Concat( const wxGraphicsMatrixData *t ) = 0; |
| 123 | |
| 124 | // sets the matrix to the respective values |
| 125 | virtual void Set(wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0, |
| 126 | wxDouble tx=0.0, wxDouble ty=0.0) = 0; |
| 127 | |
| 128 | // gets the component valuess of the matrix |
| 129 | virtual void Get(wxDouble* a=NULL, wxDouble* b=NULL, wxDouble* c=NULL, |
| 130 | wxDouble* d=NULL, wxDouble* tx=NULL, wxDouble* ty=NULL) const = 0; |
| 131 | |
| 132 | // makes this the inverse matrix |
| 133 | virtual void Invert() = 0; |
| 134 | |
| 135 | // returns true if the elements of the transformation matrix are equal ? |
| 136 | virtual bool IsEqual( const wxGraphicsMatrixData* t) const = 0; |
| 137 | |
| 138 | // return true if this is the identity matrix |
| 139 | virtual bool IsIdentity() const = 0; |
| 140 | |
| 141 | // |
| 142 | // transformation |
| 143 | // |
| 144 | |
| 145 | // add the translation to this matrix |
| 146 | virtual void Translate( wxDouble dx , wxDouble dy ) = 0; |
| 147 | |
| 148 | // add the scale to this matrix |
| 149 | virtual void Scale( wxDouble xScale , wxDouble yScale ) = 0; |
| 150 | |
| 151 | // add the rotation to this matrix (radians) |
| 152 | virtual void Rotate( wxDouble angle ) = 0; |
| 153 | |
| 154 | // |
| 155 | // apply the transforms |
| 156 | // |
| 157 | |
| 158 | // applies that matrix to the point |
| 159 | virtual void TransformPoint( wxDouble *x, wxDouble *y ) const = 0; |
| 160 | |
| 161 | // applies the matrix except for translations |
| 162 | virtual void TransformDistance( wxDouble *dx, wxDouble *dy ) const =0; |
| 163 | |
| 164 | // returns the native representation |
| 165 | virtual void * GetNativeMatrix() const = 0; |
| 166 | } ; |
| 167 | |
| 168 | class WXDLLIMPEXP_CORE wxGraphicsMatrix : public wxGraphicsObject |
| 169 | { |
| 170 | public : |
| 171 | wxGraphicsMatrix() {} |
| 172 | |
| 173 | virtual ~wxGraphicsMatrix() {} |
| 174 | |
| 175 | // concatenates the matrix |
| 176 | virtual void Concat( const wxGraphicsMatrix *t ); |
| 177 | void Concat( const wxGraphicsMatrix &t ) { Concat( &t ); } |
| 178 | |
| 179 | // sets the matrix to the respective values |
| 180 | virtual void Set(wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0, |
| 181 | wxDouble tx=0.0, wxDouble ty=0.0); |
| 182 | |
| 183 | // gets the component valuess of the matrix |
| 184 | virtual void Get(wxDouble* a=NULL, wxDouble* b=NULL, wxDouble* c=NULL, |
| 185 | wxDouble* d=NULL, wxDouble* tx=NULL, wxDouble* ty=NULL) const; |
| 186 | |
| 187 | // makes this the inverse matrix |
| 188 | virtual void Invert(); |
| 189 | |
| 190 | // returns true if the elements of the transformation matrix are equal ? |
| 191 | virtual bool IsEqual( const wxGraphicsMatrix* t) const; |
| 192 | bool IsEqual( const wxGraphicsMatrix& t) const { return IsEqual( &t ); } |
| 193 | |
| 194 | // return true if this is the identity matrix |
| 195 | virtual bool IsIdentity() const; |
| 196 | |
| 197 | // |
| 198 | // transformation |
| 199 | // |
| 200 | |
| 201 | // add the translation to this matrix |
| 202 | virtual void Translate( wxDouble dx , wxDouble dy ); |
| 203 | |
| 204 | // add the scale to this matrix |
| 205 | virtual void Scale( wxDouble xScale , wxDouble yScale ); |
| 206 | |
| 207 | // add the rotation to this matrix (radians) |
| 208 | virtual void Rotate( wxDouble angle ); |
| 209 | |
| 210 | // |
| 211 | // apply the transforms |
| 212 | // |
| 213 | |
| 214 | // applies that matrix to the point |
| 215 | virtual void TransformPoint( wxDouble *x, wxDouble *y ) const; |
| 216 | |
| 217 | // applies the matrix except for translations |
| 218 | virtual void TransformDistance( wxDouble *dx, wxDouble *dy ) const; |
| 219 | |
| 220 | // returns the native representation |
| 221 | virtual void * GetNativeMatrix() const; |
| 222 | |
| 223 | const wxGraphicsMatrixData* GetMatrixData() const |
| 224 | { return (const wxGraphicsMatrixData*) GetRefData(); } |
| 225 | wxGraphicsMatrixData* GetMatrixData() |
| 226 | { return (wxGraphicsMatrixData*) GetRefData(); } |
| 227 | |
| 228 | private : |
| 229 | DECLARE_DYNAMIC_CLASS(wxGraphicsMatrix) |
| 230 | } ; |
| 231 | |
| 232 | extern WXDLLEXPORT_DATA(wxGraphicsMatrix) wxNullGraphicsMatrix; |
| 233 | |
| 234 | class WXDLLIMPEXP_CORE wxGraphicsPathData : public wxGraphicsObjectRefData |
| 235 | { |
| 236 | public : |
| 237 | wxGraphicsPathData(wxGraphicsRenderer* renderer) : wxGraphicsObjectRefData(renderer) {} |
| 238 | virtual ~wxGraphicsPathData() {} |
| 239 | |
| 240 | // |
| 241 | // These are the path primitives from which everything else can be constructed |
| 242 | // |
| 243 | |
| 244 | // begins a new subpath at (x,y) |
| 245 | virtual void MoveToPoint( wxDouble x, wxDouble y ) = 0; |
| 246 | |
| 247 | // adds a straight line from the current point to (x,y) |
| 248 | virtual void AddLineToPoint( wxDouble x, wxDouble y ) = 0; |
| 249 | |
| 250 | // adds a cubic Bezier curve from the current point, using two control points and an end point |
| 251 | virtual void AddCurveToPoint( wxDouble cx1, wxDouble cy1, wxDouble cx2, wxDouble cy2, wxDouble x, wxDouble y ) = 0; |
| 252 | |
| 253 | // adds another path |
| 254 | virtual void AddPath( const wxGraphicsPathData* path ) =0; |
| 255 | |
| 256 | // closes the current sub-path |
| 257 | virtual void CloseSubpath() = 0; |
| 258 | |
| 259 | // gets the last point of the current path, (0,0) if not yet set |
| 260 | virtual void GetCurrentPoint( wxDouble* x, wxDouble* y) const = 0; |
| 261 | |
| 262 | // adds an arc of a circle centering at (x,y) with radius (r) from startAngle to endAngle |
| 263 | virtual void AddArc( wxDouble x, wxDouble y, wxDouble r, wxDouble startAngle, wxDouble endAngle, bool clockwise ) = 0; |
| 264 | |
| 265 | // |
| 266 | // These are convenience functions which - if not available natively will be assembled |
| 267 | // using the primitives from above |
| 268 | // |
| 269 | |
| 270 | // adds a quadratic Bezier curve from the current point, using a control point and an end point |
| 271 | virtual void AddQuadCurveToPoint( wxDouble cx, wxDouble cy, wxDouble x, wxDouble y ); |
| 272 | |
| 273 | // appends a rectangle as a new closed subpath |
| 274 | virtual void AddRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h ); |
| 275 | |
| 276 | // appends an ellipsis as a new closed subpath fitting the passed rectangle |
| 277 | virtual void AddCircle( wxDouble x, wxDouble y, wxDouble r ); |
| 278 | |
| 279 | // appends a an arc to two tangents connecting (current) to (x1,y1) and (x1,y1) to (x2,y2), also a straight line from (current) to (x1,y1) |
| 280 | virtual void AddArcToPoint( wxDouble x1, wxDouble y1 , wxDouble x2, wxDouble y2, wxDouble r ) ; |
| 281 | |
| 282 | // appends an ellipse |
| 283 | virtual void AddEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h); |
| 284 | |
| 285 | // appends a rounded rectangle |
| 286 | virtual void AddRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius); |
| 287 | |
| 288 | // returns the native path |
| 289 | virtual void * GetNativePath() const = 0; |
| 290 | |
| 291 | // give the native path returned by GetNativePath() back (there might be some deallocations necessary) |
| 292 | virtual void UnGetNativePath(void *p) const= 0; |
| 293 | |
| 294 | // transforms each point of this path by the matrix |
| 295 | virtual void Transform( const wxGraphicsMatrixData* matrix ) =0; |
| 296 | |
| 297 | // gets the bounding box enclosing all points (possibly including control points) |
| 298 | virtual void GetBox(wxDouble *x, wxDouble *y, wxDouble *w, wxDouble *h) const=0; |
| 299 | |
| 300 | virtual bool Contains( wxDouble x, wxDouble y, int fillStyle = wxODDEVEN_RULE) const=0; |
| 301 | }; |
| 302 | |
| 303 | class WXDLLIMPEXP_CORE wxGraphicsPath : public wxGraphicsObject |
| 304 | { |
| 305 | public : |
| 306 | wxGraphicsPath() {} |
| 307 | virtual ~wxGraphicsPath() {} |
| 308 | |
| 309 | // |
| 310 | // These are the path primitives from which everything else can be constructed |
| 311 | // |
| 312 | |
| 313 | // begins a new subpath at (x,y) |
| 314 | virtual void MoveToPoint( wxDouble x, wxDouble y ); |
| 315 | void MoveToPoint( const wxPoint2DDouble& p); |
| 316 | |
| 317 | // adds a straight line from the current point to (x,y) |
| 318 | virtual void AddLineToPoint( wxDouble x, wxDouble y ); |
| 319 | void AddLineToPoint( const wxPoint2DDouble& p); |
| 320 | |
| 321 | // adds a cubic Bezier curve from the current point, using two control points and an end point |
| 322 | virtual void AddCurveToPoint( wxDouble cx1, wxDouble cy1, wxDouble cx2, wxDouble cy2, wxDouble x, wxDouble y ) ; |
| 323 | void AddCurveToPoint( const wxPoint2DDouble& c1, const wxPoint2DDouble& c2, const wxPoint2DDouble& e); |
| 324 | |
| 325 | // adds another path |
| 326 | virtual void AddPath( const wxGraphicsPath& path ); |
| 327 | |
| 328 | // closes the current sub-path |
| 329 | virtual void CloseSubpath() ; |
| 330 | |
| 331 | // gets the last point of the current path, (0,0) if not yet set |
| 332 | virtual void GetCurrentPoint( wxDouble* x, wxDouble* y) const; |
| 333 | wxPoint2DDouble GetCurrentPoint() const; |
| 334 | |
| 335 | // adds an arc of a circle centering at (x,y) with radius (r) from startAngle to endAngle |
| 336 | virtual void AddArc( wxDouble x, wxDouble y, wxDouble r, wxDouble startAngle, wxDouble endAngle, bool clockwise ) ; |
| 337 | void AddArc( const wxPoint2DDouble& c, wxDouble r, wxDouble startAngle, wxDouble endAngle, bool clockwise); |
| 338 | |
| 339 | // |
| 340 | // These are convenience functions which - if not available natively will be assembled |
| 341 | // using the primitives from above |
| 342 | // |
| 343 | |
| 344 | // adds a quadratic Bezier curve from the current point, using a control point and an end point |
| 345 | virtual void AddQuadCurveToPoint( wxDouble cx, wxDouble cy, wxDouble x, wxDouble y ); |
| 346 | |
| 347 | // appends a rectangle as a new closed subpath |
| 348 | virtual void AddRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h ); |
| 349 | |
| 350 | // appends an ellipsis as a new closed subpath fitting the passed rectangle |
| 351 | virtual void AddCircle( wxDouble x, wxDouble y, wxDouble r ); |
| 352 | |
| 353 | // appends a an arc to two tangents connecting (current) to (x1,y1) and (x1,y1) to (x2,y2), also a straight line from (current) to (x1,y1) |
| 354 | virtual void AddArcToPoint( wxDouble x1, wxDouble y1 , wxDouble x2, wxDouble y2, wxDouble r ) ; |
| 355 | |
| 356 | // appends an ellipse |
| 357 | virtual void AddEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h); |
| 358 | |
| 359 | // appends a rounded rectangle |
| 360 | virtual void AddRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius); |
| 361 | |
| 362 | // returns the native path |
| 363 | virtual void * GetNativePath() const; |
| 364 | |
| 365 | // give the native path returned by GetNativePath() back (there might be some deallocations necessary) |
| 366 | virtual void UnGetNativePath(void *p)const; |
| 367 | |
| 368 | // transforms each point of this path by the matrix |
| 369 | virtual void Transform( const wxGraphicsMatrix& matrix ); |
| 370 | |
| 371 | // gets the bounding box enclosing all points (possibly including control points) |
| 372 | virtual void GetBox(wxDouble *x, wxDouble *y, wxDouble *w, wxDouble *h)const; |
| 373 | wxRect2DDouble GetBox()const; |
| 374 | |
| 375 | virtual bool Contains( wxDouble x, wxDouble y, int fillStyle = wxODDEVEN_RULE)const; |
| 376 | bool Contains( const wxPoint2DDouble& c, int fillStyle = wxODDEVEN_RULE)const; |
| 377 | |
| 378 | const wxGraphicsPathData* GetPathData() const |
| 379 | { return (const wxGraphicsPathData*) GetRefData(); } |
| 380 | wxGraphicsPathData* GetPathData() |
| 381 | { return (wxGraphicsPathData*) GetRefData(); } |
| 382 | |
| 383 | private : |
| 384 | DECLARE_DYNAMIC_CLASS(wxGraphicsPath) |
| 385 | } ; |
| 386 | |
| 387 | extern WXDLLEXPORT_DATA(wxGraphicsPath) wxNullGraphicsPath; |
| 388 | |
| 389 | |
| 390 | class WXDLLIMPEXP_CORE wxGraphicsContext : public wxGraphicsObject |
| 391 | { |
| 392 | public: |
| 393 | wxGraphicsContext(wxGraphicsRenderer* renderer); |
| 394 | |
| 395 | virtual ~wxGraphicsContext(); |
| 396 | |
| 397 | static wxGraphicsContext* Create( const wxWindowDC& dc) ; |
| 398 | |
| 399 | #ifdef __WXMSW__ |
| 400 | static wxGraphicsContext * Create( const wxMemoryDC& dc) ; |
| 401 | #endif |
| 402 | |
| 403 | static wxGraphicsContext* CreateFromNative( void * context ) ; |
| 404 | |
| 405 | static wxGraphicsContext* CreateFromNativeWindow( void * window ) ; |
| 406 | |
| 407 | static wxGraphicsContext* Create( wxWindow* window ) ; |
| 408 | |
| 409 | // create a context that can be used for measuring texts only, no drawing allowed |
| 410 | static wxGraphicsContext * Create(); |
| 411 | |
| 412 | wxGraphicsPath CreatePath() const; |
| 413 | |
| 414 | virtual wxGraphicsPen CreatePen(const wxPen& pen) const; |
| 415 | |
| 416 | virtual wxGraphicsBrush CreateBrush(const wxBrush& brush ) const; |
| 417 | |
| 418 | // sets the brush to a linear gradient, starting at (x1,y1) with color c1 to (x2,y2) with color c2 |
| 419 | virtual wxGraphicsBrush CreateLinearGradientBrush( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2, |
| 420 | const wxColour&c1, const wxColour&c2) const; |
| 421 | |
| 422 | // sets the brush to a radial gradient originating at (xo,yc) with color oColor and ends on a circle around (xc,yc) |
| 423 | // with radius r and color cColor |
| 424 | virtual wxGraphicsBrush CreateRadialGradientBrush( wxDouble xo, wxDouble yo, wxDouble xc, wxDouble yc, wxDouble radius, |
| 425 | const wxColour &oColor, const wxColour &cColor) const; |
| 426 | |
| 427 | // sets the font |
| 428 | virtual wxGraphicsFont CreateFont( const wxFont &font , const wxColour &col = *wxBLACK ) const; |
| 429 | |
| 430 | // create a 'native' matrix corresponding to these values |
| 431 | virtual wxGraphicsMatrix CreateMatrix( wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0, |
| 432 | wxDouble tx=0.0, wxDouble ty=0.0) const; |
| 433 | |
| 434 | // push the current state of the context, ie the transformation matrix on a stack |
| 435 | virtual void PushState() = 0; |
| 436 | |
| 437 | // pops a stored state from the stack |
| 438 | virtual void PopState() = 0; |
| 439 | |
| 440 | // clips drawings to the region, combined to current clipping region |
| 441 | virtual void Clip( const wxRegion ®ion ) = 0; |
| 442 | |
| 443 | // clips drawings to the rect |
| 444 | virtual void Clip( wxDouble x, wxDouble y, wxDouble w, wxDouble h ) = 0; |
| 445 | |
| 446 | // resets the clipping to original extent |
| 447 | virtual void ResetClip() = 0 ; |
| 448 | |
| 449 | // returns the native context |
| 450 | virtual void * GetNativeContext() = 0; |
| 451 | |
| 452 | // returns the current logical function |
| 453 | virtual int GetLogicalFunction() const { return m_logicalFunction; } |
| 454 | |
| 455 | // sets the current logical function, returns true if it supported |
| 456 | virtual bool SetLogicalFunction(int function) ; |
| 457 | |
| 458 | // |
| 459 | // transformation : changes the current transformation matrix CTM of the context |
| 460 | // |
| 461 | |
| 462 | // translate |
| 463 | virtual void Translate( wxDouble dx , wxDouble dy ) = 0; |
| 464 | |
| 465 | // scale |
| 466 | virtual void Scale( wxDouble xScale , wxDouble yScale ) = 0; |
| 467 | |
| 468 | // rotate (radians) |
| 469 | virtual void Rotate( wxDouble angle ) = 0; |
| 470 | |
| 471 | // concatenates this transform with the current transform of this context |
| 472 | virtual void ConcatTransform( const wxGraphicsMatrix& matrix ) = 0; |
| 473 | |
| 474 | // sets the transform of this context |
| 475 | virtual void SetTransform( const wxGraphicsMatrix& matrix ) = 0; |
| 476 | |
| 477 | // gets the matrix of this context |
| 478 | virtual wxGraphicsMatrix GetTransform() const = 0; |
| 479 | // |
| 480 | // setting the paint |
| 481 | // |
| 482 | |
| 483 | // sets the pen |
| 484 | virtual void SetPen( const wxGraphicsPen& pen ); |
| 485 | |
| 486 | void SetPen( const wxPen& pen ); |
| 487 | |
| 488 | // sets the brush for filling |
| 489 | virtual void SetBrush( const wxGraphicsBrush& brush ); |
| 490 | |
| 491 | void SetBrush( const wxBrush& brush ); |
| 492 | |
| 493 | // sets the font |
| 494 | virtual void SetFont( const wxGraphicsFont& font ); |
| 495 | |
| 496 | void SetFont( const wxFont& font, const wxColour& colour ); |
| 497 | |
| 498 | |
| 499 | // strokes along a path with the current pen |
| 500 | virtual void StrokePath( const wxGraphicsPath& path ) = 0; |
| 501 | |
| 502 | // fills a path with the current brush |
| 503 | virtual void FillPath( const wxGraphicsPath& path, int fillStyle = wxODDEVEN_RULE ) = 0; |
| 504 | |
| 505 | // draws a path by first filling and then stroking |
| 506 | virtual void DrawPath( const wxGraphicsPath& path, int fillStyle = wxODDEVEN_RULE ); |
| 507 | |
| 508 | // |
| 509 | // text |
| 510 | // |
| 511 | |
| 512 | virtual void DrawText( const wxString &str, wxDouble x, wxDouble y ) = 0; |
| 513 | |
| 514 | virtual void DrawText( const wxString &str, wxDouble x, wxDouble y, wxDouble angle ); |
| 515 | |
| 516 | virtual void DrawText( const wxString &str, wxDouble x, wxDouble y, const wxGraphicsBrush& backgroundBrush ) ; |
| 517 | |
| 518 | virtual void DrawText( const wxString &str, wxDouble x, wxDouble y, wxDouble angle, const wxGraphicsBrush& backgroundBrush ); |
| 519 | |
| 520 | virtual void GetTextExtent( const wxString &text, wxDouble *width, wxDouble *height, |
| 521 | wxDouble *descent, wxDouble *externalLeading ) const = 0; |
| 522 | |
| 523 | virtual void GetPartialTextExtents(const wxString& text, wxArrayDouble& widths) const = 0; |
| 524 | |
| 525 | // |
| 526 | // image support |
| 527 | // |
| 528 | |
| 529 | virtual void DrawBitmap( const wxBitmap &bmp, wxDouble x, wxDouble y, wxDouble w, wxDouble h ) = 0; |
| 530 | |
| 531 | virtual void DrawIcon( const wxIcon &icon, wxDouble x, wxDouble y, wxDouble w, wxDouble h ) = 0; |
| 532 | |
| 533 | // |
| 534 | // convenience methods |
| 535 | // |
| 536 | |
| 537 | // strokes a single line |
| 538 | virtual void StrokeLine( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2); |
| 539 | |
| 540 | // stroke lines connecting each of the points |
| 541 | virtual void StrokeLines( size_t n, const wxPoint2DDouble *points); |
| 542 | |
| 543 | // stroke disconnected lines from begin to end points |
| 544 | virtual void StrokeLines( size_t n, const wxPoint2DDouble *beginPoints, const wxPoint2DDouble *endPoints); |
| 545 | |
| 546 | // draws a polygon |
| 547 | virtual void DrawLines( size_t n, const wxPoint2DDouble *points, int fillStyle = wxODDEVEN_RULE ); |
| 548 | |
| 549 | // draws a polygon |
| 550 | virtual void DrawRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h); |
| 551 | |
| 552 | // draws an ellipse |
| 553 | virtual void DrawEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h); |
| 554 | |
| 555 | // draws a rounded rectangle |
| 556 | virtual void DrawRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius); |
| 557 | |
| 558 | // wrappers using wxPoint2DDouble TODO |
| 559 | |
| 560 | // helper to determine if a 0.5 offset should be applied for the drawing operation |
| 561 | virtual bool ShouldOffset() const { return false; } |
| 562 | |
| 563 | protected : |
| 564 | |
| 565 | wxGraphicsPen m_pen; |
| 566 | wxGraphicsBrush m_brush; |
| 567 | wxGraphicsFont m_font; |
| 568 | int m_logicalFunction; |
| 569 | |
| 570 | private : |
| 571 | DECLARE_NO_COPY_CLASS(wxGraphicsContext) |
| 572 | DECLARE_ABSTRACT_CLASS(wxGraphicsContext) |
| 573 | }; |
| 574 | |
| 575 | #if 0 |
| 576 | |
| 577 | // |
| 578 | // A graphics figure allows to cache path, pen etc creations, also will be a basis for layering/grouping elements |
| 579 | // |
| 580 | |
| 581 | class WXDLLIMPEXP_CORE wxGraphicsFigure : public wxGraphicsObject |
| 582 | { |
| 583 | public : |
| 584 | wxGraphicsFigure(wxGraphicsRenderer* renderer) ; |
| 585 | |
| 586 | virtual ~wxGraphicsFigure() ; |
| 587 | |
| 588 | void SetPath( wxGraphicsMatrix* matrix ); |
| 589 | |
| 590 | void SetMatrix( wxGraphicsPath* path); |
| 591 | |
| 592 | // draws this object on the context |
| 593 | virtual void Draw( wxGraphicsContext* cg ); |
| 594 | |
| 595 | // returns the path of this object |
| 596 | wxGraphicsPath* GetPath() { return m_path; } |
| 597 | |
| 598 | // returns the transformation matrix of this object, may be null if there is no transformation necessary |
| 599 | wxGraphicsMatrix* GetMatrix() { return m_matrix; } |
| 600 | |
| 601 | private : |
| 602 | wxGraphicsMatrix* m_matrix; |
| 603 | wxGraphicsPath* m_path; |
| 604 | |
| 605 | DECLARE_DYNAMIC_CLASS(wxGraphicsFigure) |
| 606 | } ; |
| 607 | |
| 608 | #endif |
| 609 | |
| 610 | // |
| 611 | // The graphics renderer is the instance corresponding to the rendering engine used, eg there is ONE core graphics renderer |
| 612 | // instance on OSX. This instance is pointed back to by all objects created by it. Therefore you can create eg additional |
| 613 | // paths at any point from a given matrix etc. |
| 614 | // |
| 615 | |
| 616 | class WXDLLIMPEXP_CORE wxGraphicsRenderer : public wxObject |
| 617 | { |
| 618 | public : |
| 619 | wxGraphicsRenderer() {} |
| 620 | |
| 621 | virtual ~wxGraphicsRenderer() {} |
| 622 | |
| 623 | static wxGraphicsRenderer* GetDefaultRenderer(); |
| 624 | |
| 625 | // Context |
| 626 | |
| 627 | virtual wxGraphicsContext * CreateContext( const wxWindowDC& dc) = 0 ; |
| 628 | #ifdef __WXMSW__ |
| 629 | virtual wxGraphicsContext * CreateContext( const wxMemoryDC& dc) = 0 ; |
| 630 | #endif |
| 631 | virtual wxGraphicsContext * CreateContextFromNativeContext( void * context ) = 0; |
| 632 | |
| 633 | virtual wxGraphicsContext * CreateContextFromNativeWindow( void * window ) = 0; |
| 634 | |
| 635 | virtual wxGraphicsContext * CreateContext( wxWindow* window ) = 0; |
| 636 | |
| 637 | // create a context that can be used for measuring texts only, no drawing allowed |
| 638 | virtual wxGraphicsContext * CreateMeasuringContext() = 0; |
| 639 | |
| 640 | // Path |
| 641 | |
| 642 | virtual wxGraphicsPath CreatePath() = 0; |
| 643 | |
| 644 | // Matrix |
| 645 | |
| 646 | virtual wxGraphicsMatrix CreateMatrix( wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0, |
| 647 | wxDouble tx=0.0, wxDouble ty=0.0) = 0; |
| 648 | |
| 649 | // Paints |
| 650 | |
| 651 | virtual wxGraphicsPen CreatePen(const wxPen& pen) = 0 ; |
| 652 | |
| 653 | virtual wxGraphicsBrush CreateBrush(const wxBrush& brush ) = 0 ; |
| 654 | |
| 655 | // sets the brush to a linear gradient, starting at (x1,y1) with color c1 to (x2,y2) with color c2 |
| 656 | virtual wxGraphicsBrush CreateLinearGradientBrush( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2, |
| 657 | const wxColour&c1, const wxColour&c2) = 0; |
| 658 | |
| 659 | // sets the brush to a radial gradient originating at (xo,yc) with color oColor and ends on a circle around (xc,yc) |
| 660 | // with radius r and color cColor |
| 661 | virtual wxGraphicsBrush CreateRadialGradientBrush( wxDouble xo, wxDouble yo, wxDouble xc, wxDouble yc, wxDouble radius, |
| 662 | const wxColour &oColor, const wxColour &cColor) = 0; |
| 663 | |
| 664 | // sets the font |
| 665 | virtual wxGraphicsFont CreateFont( const wxFont &font , const wxColour &col = *wxBLACK ) = 0; |
| 666 | |
| 667 | private : |
| 668 | DECLARE_NO_COPY_CLASS(wxGraphicsRenderer) |
| 669 | DECLARE_ABSTRACT_CLASS(wxGraphicsRenderer) |
| 670 | } ; |
| 671 | |
| 672 | #endif |
| 673 | |
| 674 | #endif // _WX_GRAPHICS_H_ |