]>
Commit | Line | Data |
---|---|---|
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 | // 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 | ||
164 | class WXDLLIMPEXP_CORE wxGraphicsMatrix : public wxGraphicsObject | |
165 | { | |
166 | public : | |
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 | ||
220 | private : | |
221 | DECLARE_DYNAMIC_CLASS(wxGraphicsMatrix) | |
222 | } ; | |
223 | ||
224 | extern WXDLLEXPORT_DATA(wxGraphicsMatrix) wxNullGraphicsMatrix; | |
225 | ||
226 | class WXDLLIMPEXP_CORE wxGraphicsPathData : public wxGraphicsObjectRefData | |
227 | { | |
228 | public : | |
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 | ||
295 | class WXDLLIMPEXP_CORE wxGraphicsPath : public wxGraphicsObject | |
296 | { | |
297 | public : | |
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 | ||
375 | private : | |
376 | DECLARE_DYNAMIC_CLASS(wxGraphicsPath) | |
377 | } ; | |
378 | ||
379 | extern WXDLLEXPORT_DATA(wxGraphicsPath) wxNullGraphicsPath; | |
380 | ||
381 | ||
382 | class WXDLLIMPEXP_CORE wxGraphicsContext : public wxGraphicsObject | |
383 | { | |
384 | public: | |
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 ®ion ) = 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 | ||
549 | protected : | |
550 | ||
551 | wxGraphicsPen m_pen; | |
552 | wxGraphicsBrush m_brush; | |
553 | wxGraphicsFont m_font; | |
554 | ||
555 | private : | |
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 | ||
566 | class WXDLLIMPEXP_CORE wxGraphicsFigure : public wxGraphicsObject | |
567 | { | |
568 | public : | |
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 | ||
586 | private : | |
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 | ||
601 | class WXDLLIMPEXP_CORE wxGraphicsRenderer : public wxObject | |
602 | { | |
603 | public : | |
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 | ||
652 | private : | |
653 | DECLARE_NO_COPY_CLASS(wxGraphicsRenderer) | |
654 | DECLARE_ABSTRACT_CLASS(wxGraphicsRenderer) | |
655 | } ; | |
656 | ||
657 | #endif | |
658 | ||
659 | #endif // _WX_GRAPHICS_H_ |