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