]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/graphics.h
build fixes
[wxWidgets.git] / include / wx / graphics.h
... / ...
CommitLineData
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
20class WXDLLIMPEXP_FWD_CORE wxWindowDC;
21class WXDLLIMPEXP_FWD_CORE wxMemoryDC;
22class WXDLLIMPEXP_FWD_CORE wxGraphicsContext;
23class WXDLLIMPEXP_FWD_CORE wxGraphicsPath;
24class WXDLLIMPEXP_FWD_CORE wxGraphicsMatrix;
25class WXDLLIMPEXP_FWD_CORE wxGraphicsFigure;
26class WXDLLIMPEXP_FWD_CORE wxGraphicsRenderer;
27class WXDLLIMPEXP_FWD_CORE wxGraphicsPen;
28class WXDLLIMPEXP_FWD_CORE wxGraphicsBrush;
29class WXDLLIMPEXP_FWD_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
48class WXDLLIMPEXP_CORE wxGraphicsObjectRefData : public wxObjectRefData
49{
50public :
51 wxGraphicsObjectRefData( wxGraphicsRenderer* renderer );
52 wxGraphicsObjectRefData( const wxGraphicsObjectRefData* data );
53 wxGraphicsRenderer* GetRenderer() const ;
54 virtual wxGraphicsObjectRefData* Clone() const ;
55
56protected :
57 wxGraphicsRenderer* m_renderer;
58} ;
59
60class WXDLLIMPEXP_CORE wxGraphicsObject : public wxObject
61{
62public :
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 ;
72protected :
73 virtual wxObjectRefData* CreateRefData() const;
74 virtual wxObjectRefData* CloneRefData(const wxObjectRefData* data) const;
75
76 DECLARE_DYNAMIC_CLASS(wxGraphicsObject)
77} ;
78
79class WXDLLIMPEXP_CORE wxGraphicsPen : public wxGraphicsObject
80{
81public :
82 wxGraphicsPen() {}
83 virtual ~wxGraphicsPen() {}
84private :
85 DECLARE_DYNAMIC_CLASS(wxGraphicsPen)
86} ;
87
88extern WXDLLEXPORT_DATA(wxGraphicsPen) wxNullGraphicsPen;
89
90class WXDLLIMPEXP_CORE wxGraphicsBrush : public wxGraphicsObject
91{
92public :
93 wxGraphicsBrush() {}
94 virtual ~wxGraphicsBrush() {}
95private :
96 DECLARE_DYNAMIC_CLASS(wxGraphicsBrush)
97} ;
98
99extern WXDLLEXPORT_DATA(wxGraphicsBrush) wxNullGraphicsBrush;
100
101class WXDLLIMPEXP_CORE wxGraphicsFont : public wxGraphicsObject
102{
103public :
104 wxGraphicsFont() {}
105 virtual ~wxGraphicsFont() {}
106private :
107 DECLARE_DYNAMIC_CLASS(wxGraphicsFont)
108} ;
109
110extern WXDLLEXPORT_DATA(wxGraphicsFont) wxNullGraphicsFont;
111
112
113class WXDLLIMPEXP_CORE wxGraphicsMatrixData : public wxGraphicsObjectRefData
114{
115public :
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
168class WXDLLIMPEXP_CORE wxGraphicsMatrix : public wxGraphicsObject
169{
170public :
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
228private :
229 DECLARE_DYNAMIC_CLASS(wxGraphicsMatrix)
230} ;
231
232extern WXDLLEXPORT_DATA(wxGraphicsMatrix) wxNullGraphicsMatrix;
233
234class WXDLLIMPEXP_CORE wxGraphicsPathData : public wxGraphicsObjectRefData
235{
236public :
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
303class WXDLLIMPEXP_CORE wxGraphicsPath : public wxGraphicsObject
304{
305public :
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
383private :
384 DECLARE_DYNAMIC_CLASS(wxGraphicsPath)
385} ;
386
387extern WXDLLEXPORT_DATA(wxGraphicsPath) wxNullGraphicsPath;
388
389
390class WXDLLIMPEXP_CORE wxGraphicsContext : public wxGraphicsObject
391{
392public:
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 &region ) = 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
563protected :
564
565 wxGraphicsPen m_pen;
566 wxGraphicsBrush m_brush;
567 wxGraphicsFont m_font;
568 int m_logicalFunction;
569
570private :
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
581class WXDLLIMPEXP_CORE wxGraphicsFigure : public wxGraphicsObject
582{
583public :
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
601private :
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
616class WXDLLIMPEXP_CORE wxGraphicsRenderer : public wxObject
617{
618public :
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
667private :
668 DECLARE_NO_COPY_CLASS(wxGraphicsRenderer)
669 DECLARE_ABSTRACT_CLASS(wxGraphicsRenderer)
670} ;
671
672#endif
673
674#endif // _WX_GRAPHICS_H_