]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/graphics.h
fix Normalize() test by using dummy working directory allowing the test to work even...
[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_CORE wxWindowDC;
21class WXDLLIMPEXP_CORE wxMemoryDC;
22class WXDLLIMPEXP_CORE wxGraphicsContext;
23class WXDLLIMPEXP_CORE wxGraphicsPath;
24class WXDLLIMPEXP_CORE wxGraphicsMatrix;
25class WXDLLIMPEXP_CORE wxGraphicsFigure;
26class WXDLLIMPEXP_CORE wxGraphicsRenderer;
27class WXDLLIMPEXP_CORE wxGraphicsPen;
28class WXDLLIMPEXP_CORE wxGraphicsBrush;
29class 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
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 // makes this the inverse matrix
129 virtual void Invert() = 0;
130
131 // returns true if the elements of the transformation matrix are equal ?
132 virtual bool IsEqual( const wxGraphicsMatrixData* t) const = 0;
133
134 // return true if this is the identity matrix
135 virtual bool IsIdentity() const = 0;
136
137 //
138 // transformation
139 //
140
141 // add the translation to this matrix
142 virtual void Translate( wxDouble dx , wxDouble dy ) = 0;
143
144 // add the scale to this matrix
145 virtual void Scale( wxDouble xScale , wxDouble yScale ) = 0;
146
147 // add the rotation to this matrix (radians)
148 virtual void Rotate( wxDouble angle ) = 0;
149
150 //
151 // apply the transforms
152 //
153
154 // applies that matrix to the point
155 virtual void TransformPoint( wxDouble *x, wxDouble *y ) const = 0;
156
157 // applies the matrix except for translations
158 virtual void TransformDistance( wxDouble *dx, wxDouble *dy ) const =0;
159
160 // returns the native representation
161 virtual void * GetNativeMatrix() const = 0;
162} ;
163
164class WXDLLIMPEXP_CORE wxGraphicsMatrix : public wxGraphicsObject
165{
166public :
167 wxGraphicsMatrix() {}
168
169 virtual ~wxGraphicsMatrix() {}
170
171 // concatenates the matrix
172 virtual void Concat( const wxGraphicsMatrix *t );
173 void Concat( const wxGraphicsMatrix &t ) { Concat( &t ); }
174
175 // sets the matrix to the respective values
176 virtual void Set(wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0,
177 wxDouble tx=0.0, wxDouble ty=0.0);
178
179 // makes this the inverse matrix
180 virtual void Invert();
181
182 // returns true if the elements of the transformation matrix are equal ?
183 virtual bool IsEqual( const wxGraphicsMatrix* t) const;
184 bool IsEqual( const wxGraphicsMatrix& t) const { return IsEqual( &t ); }
185
186 // return true if this is the identity matrix
187 virtual bool IsIdentity() const;
188
189 //
190 // transformation
191 //
192
193 // add the translation to this matrix
194 virtual void Translate( wxDouble dx , wxDouble dy );
195
196 // add the scale to this matrix
197 virtual void Scale( wxDouble xScale , wxDouble yScale );
198
199 // add the rotation to this matrix (radians)
200 virtual void Rotate( wxDouble angle );
201
202 //
203 // apply the transforms
204 //
205
206 // applies that matrix to the point
207 virtual void TransformPoint( wxDouble *x, wxDouble *y ) const;
208
209 // applies the matrix except for translations
210 virtual void TransformDistance( wxDouble *dx, wxDouble *dy ) const;
211
212 // returns the native representation
213 virtual void * GetNativeMatrix() const;
214
215 const wxGraphicsMatrixData* GetMatrixData() const
216 { return (const wxGraphicsMatrixData*) GetRefData(); }
217 wxGraphicsMatrixData* GetMatrixData()
218 { return (wxGraphicsMatrixData*) GetRefData(); }
219
220private :
221 DECLARE_DYNAMIC_CLASS(wxGraphicsMatrix)
222} ;
223
224extern WXDLLEXPORT_DATA(wxGraphicsMatrix) wxNullGraphicsMatrix;
225
226class WXDLLIMPEXP_CORE wxGraphicsPathData : public wxGraphicsObjectRefData
227{
228public :
229 wxGraphicsPathData(wxGraphicsRenderer* renderer) : wxGraphicsObjectRefData(renderer) {}
230 virtual ~wxGraphicsPathData() {}
231
232 //
233 // These are the path primitives from which everything else can be constructed
234 //
235
236 // begins a new subpath at (x,y)
237 virtual void MoveToPoint( wxDouble x, wxDouble y ) = 0;
238
239 // adds a straight line from the current point to (x,y)
240 virtual void AddLineToPoint( wxDouble x, wxDouble y ) = 0;
241
242 // adds a cubic Bezier curve from the current point, using two control points and an end point
243 virtual void AddCurveToPoint( wxDouble cx1, wxDouble cy1, wxDouble cx2, wxDouble cy2, wxDouble x, wxDouble y ) = 0;
244
245 // adds another path
246 virtual void AddPath( const wxGraphicsPathData* path ) =0;
247
248 // closes the current sub-path
249 virtual void CloseSubpath() = 0;
250
251 // gets the last point of the current path, (0,0) if not yet set
252 virtual void GetCurrentPoint( wxDouble* x, wxDouble* y) const = 0;
253
254 // adds an arc of a circle centering at (x,y) with radius (r) from startAngle to endAngle
255 virtual void AddArc( wxDouble x, wxDouble y, wxDouble r, wxDouble startAngle, wxDouble endAngle, bool clockwise ) = 0;
256
257 //
258 // These are convenience functions which - if not available natively will be assembled
259 // using the primitives from above
260 //
261
262 // adds a quadratic Bezier curve from the current point, using a control point and an end point
263 virtual void AddQuadCurveToPoint( wxDouble cx, wxDouble cy, wxDouble x, wxDouble y );
264
265 // appends a rectangle as a new closed subpath
266 virtual void AddRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h );
267
268 // appends an ellipsis as a new closed subpath fitting the passed rectangle
269 virtual void AddCircle( wxDouble x, wxDouble y, wxDouble r );
270
271 // 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)
272 virtual void AddArcToPoint( wxDouble x1, wxDouble y1 , wxDouble x2, wxDouble y2, wxDouble r ) ;
273
274 // appends an ellipse
275 virtual void AddEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h);
276
277 // appends a rounded rectangle
278 virtual void AddRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius);
279
280 // returns the native path
281 virtual void * GetNativePath() const = 0;
282
283 // give the native path returned by GetNativePath() back (there might be some deallocations necessary)
284 virtual void UnGetNativePath(void *p) const= 0;
285
286 // transforms each point of this path by the matrix
287 virtual void Transform( const wxGraphicsMatrixData* matrix ) =0;
288
289 // gets the bounding box enclosing all points (possibly including control points)
290 virtual void GetBox(wxDouble *x, wxDouble *y, wxDouble *w, wxDouble *h) const=0;
291
292 virtual bool Contains( wxDouble x, wxDouble y, int fillStyle = wxODDEVEN_RULE) const=0;
293};
294
295class WXDLLIMPEXP_CORE wxGraphicsPath : public wxGraphicsObject
296{
297public :
298 wxGraphicsPath() {}
299 virtual ~wxGraphicsPath() {}
300
301 //
302 // These are the path primitives from which everything else can be constructed
303 //
304
305 // begins a new subpath at (x,y)
306 virtual void MoveToPoint( wxDouble x, wxDouble y );
307 void MoveToPoint( const wxPoint2DDouble& p);
308
309 // adds a straight line from the current point to (x,y)
310 virtual void AddLineToPoint( wxDouble x, wxDouble y );
311 void AddLineToPoint( const wxPoint2DDouble& p);
312
313 // adds a cubic Bezier curve from the current point, using two control points and an end point
314 virtual void AddCurveToPoint( wxDouble cx1, wxDouble cy1, wxDouble cx2, wxDouble cy2, wxDouble x, wxDouble y ) ;
315 void AddCurveToPoint( const wxPoint2DDouble& c1, const wxPoint2DDouble& c2, const wxPoint2DDouble& e);
316
317 // adds another path
318 virtual void AddPath( const wxGraphicsPath& path );
319
320 // closes the current sub-path
321 virtual void CloseSubpath() ;
322
323 // gets the last point of the current path, (0,0) if not yet set
324 virtual void GetCurrentPoint( wxDouble* x, wxDouble* y) const;
325 wxPoint2DDouble GetCurrentPoint() const;
326
327 // adds an arc of a circle centering at (x,y) with radius (r) from startAngle to endAngle
328 virtual void AddArc( wxDouble x, wxDouble y, wxDouble r, wxDouble startAngle, wxDouble endAngle, bool clockwise ) ;
329 void AddArc( const wxPoint2DDouble& c, wxDouble r, wxDouble startAngle, wxDouble endAngle, bool clockwise);
330
331 //
332 // These are convenience functions which - if not available natively will be assembled
333 // using the primitives from above
334 //
335
336 // adds a quadratic Bezier curve from the current point, using a control point and an end point
337 virtual void AddQuadCurveToPoint( wxDouble cx, wxDouble cy, wxDouble x, wxDouble y );
338
339 // appends a rectangle as a new closed subpath
340 virtual void AddRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h );
341
342 // appends an ellipsis as a new closed subpath fitting the passed rectangle
343 virtual void AddCircle( wxDouble x, wxDouble y, wxDouble r );
344
345 // 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)
346 virtual void AddArcToPoint( wxDouble x1, wxDouble y1 , wxDouble x2, wxDouble y2, wxDouble r ) ;
347
348 // appends an ellipse
349 virtual void AddEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h);
350
351 // appends a rounded rectangle
352 virtual void AddRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius);
353
354 // returns the native path
355 virtual void * GetNativePath() const;
356
357 // give the native path returned by GetNativePath() back (there might be some deallocations necessary)
358 virtual void UnGetNativePath(void *p)const;
359
360 // transforms each point of this path by the matrix
361 virtual void Transform( const wxGraphicsMatrix& matrix );
362
363 // gets the bounding box enclosing all points (possibly including control points)
364 virtual void GetBox(wxDouble *x, wxDouble *y, wxDouble *w, wxDouble *h)const;
365 wxRect2DDouble GetBox()const;
366
367 virtual bool Contains( wxDouble x, wxDouble y, int fillStyle = wxODDEVEN_RULE)const;
368 bool Contains( const wxPoint2DDouble& c, int fillStyle = wxODDEVEN_RULE)const;
369
370 const wxGraphicsPathData* GetPathData() const
371 { return (const wxGraphicsPathData*) GetRefData(); }
372 wxGraphicsPathData* GetPathData()
373 { return (wxGraphicsPathData*) GetRefData(); }
374
375private :
376 DECLARE_DYNAMIC_CLASS(wxGraphicsPath)
377} ;
378
379extern WXDLLEXPORT_DATA(wxGraphicsPath) wxNullGraphicsPath;
380
381
382class WXDLLIMPEXP_CORE wxGraphicsContext : public wxGraphicsObject
383{
384public:
385 wxGraphicsContext(wxGraphicsRenderer* renderer);
386
387 virtual ~wxGraphicsContext();
388
389 static wxGraphicsContext* Create( const wxWindowDC& dc) ;
390
391#ifdef __WXMSW__
392 static wxGraphicsContext * Create( const wxMemoryDC& dc) ;
393#endif
394
395 static wxGraphicsContext* CreateFromNative( void * context ) ;
396
397 static wxGraphicsContext* CreateFromNativeWindow( void * window ) ;
398
399 static wxGraphicsContext* Create( wxWindow* window ) ;
400
401 // create a context that can be used for measuring texts only, no drawing allowed
402 static wxGraphicsContext * Create();
403
404 wxGraphicsPath CreatePath() const;
405
406 virtual wxGraphicsPen CreatePen(const wxPen& pen) const;
407
408 virtual wxGraphicsBrush CreateBrush(const wxBrush& brush ) const;
409
410 // sets the brush to a linear gradient, starting at (x1,y1) with color c1 to (x2,y2) with color c2
411 virtual wxGraphicsBrush CreateLinearGradientBrush( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2,
412 const wxColour&c1, const wxColour&c2) const;
413
414 // sets the brush to a radial gradient originating at (xo,yc) with color oColor and ends on a circle around (xc,yc)
415 // with radius r and color cColor
416 virtual wxGraphicsBrush CreateRadialGradientBrush( wxDouble xo, wxDouble yo, wxDouble xc, wxDouble yc, wxDouble radius,
417 const wxColour &oColor, const wxColour &cColor) const;
418
419 // sets the font
420 virtual wxGraphicsFont CreateFont( const wxFont &font , const wxColour &col = *wxBLACK ) const;
421
422 // create a 'native' matrix corresponding to these values
423 virtual wxGraphicsMatrix CreateMatrix( wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0,
424 wxDouble tx=0.0, wxDouble ty=0.0) const;
425
426 // push the current state of the context, ie the transformation matrix on a stack
427 virtual void PushState() = 0;
428
429 // pops a stored state from the stack
430 virtual void PopState() = 0;
431
432 // clips drawings to the region, combined to current clipping region
433 virtual void Clip( const wxRegion &region ) = 0;
434
435 // clips drawings to the rect
436 virtual void Clip( wxDouble x, wxDouble y, wxDouble w, wxDouble h ) = 0;
437
438 // resets the clipping to original extent
439 virtual void ResetClip() = 0 ;
440
441 // returns the native context
442 virtual void * GetNativeContext() = 0;
443
444 //
445 // transformation : changes the current transformation matrix CTM of the context
446 //
447
448 // translate
449 virtual void Translate( wxDouble dx , wxDouble dy ) = 0;
450
451 // scale
452 virtual void Scale( wxDouble xScale , wxDouble yScale ) = 0;
453
454 // rotate (radians)
455 virtual void Rotate( wxDouble angle ) = 0;
456
457 // concatenates this transform with the current transform of this context
458 virtual void ConcatTransform( const wxGraphicsMatrix& matrix ) = 0;
459
460 // sets the transform of this context
461 virtual void SetTransform( const wxGraphicsMatrix& matrix ) = 0;
462
463 // gets the matrix of this context
464 virtual wxGraphicsMatrix GetTransform() const = 0;
465 //
466 // setting the paint
467 //
468
469 // sets the pen
470 virtual void SetPen( const wxGraphicsPen& pen );
471
472 void SetPen( const wxPen& pen );
473
474 // sets the brush for filling
475 virtual void SetBrush( const wxGraphicsBrush& brush );
476
477 void SetBrush( const wxBrush& brush );
478
479 // sets the font
480 virtual void SetFont( const wxGraphicsFont& font );
481
482 void SetFont( const wxFont& font, const wxColour& colour );
483
484
485 // strokes along a path with the current pen
486 virtual void StrokePath( const wxGraphicsPath& path ) = 0;
487
488 // fills a path with the current brush
489 virtual void FillPath( const wxGraphicsPath& path, int fillStyle = wxODDEVEN_RULE ) = 0;
490
491 // draws a path by first filling and then stroking
492 virtual void DrawPath( const wxGraphicsPath& path, int fillStyle = wxODDEVEN_RULE );
493
494 //
495 // text
496 //
497
498 virtual void DrawText( const wxString &str, wxDouble x, wxDouble y ) = 0;
499
500 virtual void DrawText( const wxString &str, wxDouble x, wxDouble y, wxDouble angle );
501
502 virtual void DrawText( const wxString &str, wxDouble x, wxDouble y, const wxGraphicsBrush& backgroundBrush ) ;
503
504 virtual void DrawText( const wxString &str, wxDouble x, wxDouble y, wxDouble angle, const wxGraphicsBrush& backgroundBrush );
505
506 virtual void GetTextExtent( const wxString &text, wxDouble *width, wxDouble *height,
507 wxDouble *descent, wxDouble *externalLeading ) const = 0;
508
509 virtual void GetPartialTextExtents(const wxString& text, wxArrayDouble& widths) const = 0;
510
511 //
512 // image support
513 //
514
515 virtual void DrawBitmap( const wxBitmap &bmp, wxDouble x, wxDouble y, wxDouble w, wxDouble h ) = 0;
516
517 virtual void DrawIcon( const wxIcon &icon, wxDouble x, wxDouble y, wxDouble w, wxDouble h ) = 0;
518
519 //
520 // convenience methods
521 //
522
523 // strokes a single line
524 virtual void StrokeLine( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2);
525
526 // stroke lines connecting each of the points
527 virtual void StrokeLines( size_t n, const wxPoint2DDouble *points);
528
529 // stroke disconnected lines from begin to end points
530 virtual void StrokeLines( size_t n, const wxPoint2DDouble *beginPoints, const wxPoint2DDouble *endPoints);
531
532 // draws a polygon
533 virtual void DrawLines( size_t n, const wxPoint2DDouble *points, int fillStyle = wxODDEVEN_RULE );
534
535 // draws a polygon
536 virtual void DrawRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h);
537
538 // draws an ellipse
539 virtual void DrawEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h);
540
541 // draws a rounded rectangle
542 virtual void DrawRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius);
543
544 // wrappers using wxPoint2DDouble TODO
545
546 // helper to determine if a 0.5 offset should be applied for the drawing operation
547 virtual bool ShouldOffset() const { return false; }
548
549protected :
550
551 wxGraphicsPen m_pen;
552 wxGraphicsBrush m_brush;
553 wxGraphicsFont m_font;
554
555private :
556 DECLARE_NO_COPY_CLASS(wxGraphicsContext)
557 DECLARE_ABSTRACT_CLASS(wxGraphicsContext)
558};
559
560#if 0
561
562//
563// A graphics figure allows to cache path, pen etc creations, also will be a basis for layering/grouping elements
564//
565
566class WXDLLIMPEXP_CORE wxGraphicsFigure : public wxGraphicsObject
567{
568public :
569 wxGraphicsFigure(wxGraphicsRenderer* renderer) ;
570
571 virtual ~wxGraphicsFigure() ;
572
573 void SetPath( wxGraphicsMatrix* matrix );
574
575 void SetMatrix( wxGraphicsPath* path);
576
577 // draws this object on the context
578 virtual void Draw( wxGraphicsContext* cg );
579
580 // returns the path of this object
581 wxGraphicsPath* GetPath() { return m_path; }
582
583 // returns the transformation matrix of this object, may be null if there is no transformation necessary
584 wxGraphicsMatrix* GetMatrix() { return m_matrix; }
585
586private :
587 wxGraphicsMatrix* m_matrix;
588 wxGraphicsPath* m_path;
589
590 DECLARE_DYNAMIC_CLASS(wxGraphicsFigure)
591} ;
592
593#endif
594
595//
596// The graphics renderer is the instance corresponding to the rendering engine used, eg there is ONE core graphics renderer
597// instance on OSX. This instance is pointed back to by all objects created by it. Therefore you can create eg additional
598// paths at any point from a given matrix etc.
599//
600
601class WXDLLIMPEXP_CORE wxGraphicsRenderer : public wxObject
602{
603public :
604 wxGraphicsRenderer() {}
605
606 virtual ~wxGraphicsRenderer() {}
607
608 static wxGraphicsRenderer* GetDefaultRenderer();
609
610 // Context
611
612 virtual wxGraphicsContext * CreateContext( const wxWindowDC& dc) = 0 ;
613#ifdef __WXMSW__
614 virtual wxGraphicsContext * CreateContext( const wxMemoryDC& dc) = 0 ;
615#endif
616 virtual wxGraphicsContext * CreateContextFromNativeContext( void * context ) = 0;
617
618 virtual wxGraphicsContext * CreateContextFromNativeWindow( void * window ) = 0;
619
620 virtual wxGraphicsContext * CreateContext( wxWindow* window ) = 0;
621
622 // create a context that can be used for measuring texts only, no drawing allowed
623 virtual wxGraphicsContext * CreateMeasuringContext() = 0;
624
625 // Path
626
627 virtual wxGraphicsPath CreatePath() = 0;
628
629 // Matrix
630
631 virtual wxGraphicsMatrix CreateMatrix( wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0,
632 wxDouble tx=0.0, wxDouble ty=0.0) = 0;
633
634 // Paints
635
636 virtual wxGraphicsPen CreatePen(const wxPen& pen) = 0 ;
637
638 virtual wxGraphicsBrush CreateBrush(const wxBrush& brush ) = 0 ;
639
640 // sets the brush to a linear gradient, starting at (x1,y1) with color c1 to (x2,y2) with color c2
641 virtual wxGraphicsBrush CreateLinearGradientBrush( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2,
642 const wxColour&c1, const wxColour&c2) = 0;
643
644 // sets the brush to a radial gradient originating at (xo,yc) with color oColor and ends on a circle around (xc,yc)
645 // with radius r and color cColor
646 virtual wxGraphicsBrush CreateRadialGradientBrush( wxDouble xo, wxDouble yo, wxDouble xc, wxDouble yc, wxDouble radius,
647 const wxColour &oColor, const wxColour &cColor) = 0;
648
649 // sets the font
650 virtual wxGraphicsFont CreateFont( const wxFont &font , const wxColour &col = *wxBLACK ) = 0;
651
652private :
653 DECLARE_NO_COPY_CLASS(wxGraphicsRenderer)
654 DECLARE_ABSTRACT_CLASS(wxGraphicsRenderer)
655} ;
656
657#endif
658
659#endif // _WX_GRAPHICS_H_