]>
Commit | Line | Data |
---|---|---|
50581042 SC |
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 | ||
8acd14d1 SC |
15 | #if wxUSE_GRAPHICS_CONTEXT |
16 | ||
50581042 | 17 | #include "wx/geometry.h" |
50581042 SC |
18 | #include "wx/dynarray.h" |
19 | ||
9e605538 | 20 | class WXDLLIMPEXP_CORE wxWindowDC; |
773ccc31 | 21 | class WXDLLIMPEXP_CORE wxMemoryDC; |
9e605538 SC |
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; | |
774f4d12 | 30 | |
50581042 SC |
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 | ||
9e605538 SC |
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 | |
2c820406 SC |
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 | // | |
9e605538 | 47 | |
2c820406 SC |
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 | ||
9e605538 SC |
60 | class WXDLLIMPEXP_CORE wxGraphicsObject : public wxObject |
61 | { | |
62 | public : | |
2c820406 SC |
63 | wxGraphicsObject() ; |
64 | wxGraphicsObject( wxGraphicsRenderer* renderer ) ; | |
65 | virtual ~wxGraphicsObject() ; | |
0d3675a6 | 66 | |
2c820406 SC |
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 ; | |
9e605538 | 72 | protected : |
2c820406 SC |
73 | virtual wxObjectRefData* CreateRefData() const; |
74 | virtual wxObjectRefData* CloneRefData(const wxObjectRefData* data) const; | |
75 | ||
0d3675a6 | 76 | DECLARE_DYNAMIC_CLASS(wxGraphicsObject); |
9e605538 SC |
77 | } ; |
78 | ||
79 | class WXDLLIMPEXP_CORE wxGraphicsPen : public wxGraphicsObject | |
80 | { | |
81 | public : | |
2c820406 | 82 | wxGraphicsPen() {} |
9e605538 | 83 | virtual ~wxGraphicsPen() {} |
9e605538 | 84 | private : |
2c820406 | 85 | DECLARE_DYNAMIC_CLASS(wxGraphicsPen) |
9e605538 SC |
86 | } ; |
87 | ||
2c820406 SC |
88 | extern WXDLLEXPORT_DATA(wxGraphicsPen) wxNullGraphicsPen; |
89 | ||
9e605538 SC |
90 | class WXDLLIMPEXP_CORE wxGraphicsBrush : public wxGraphicsObject |
91 | { | |
92 | public : | |
2c820406 | 93 | wxGraphicsBrush() {} |
9e605538 | 94 | virtual ~wxGraphicsBrush() {} |
9e605538 | 95 | private : |
2c820406 | 96 | DECLARE_DYNAMIC_CLASS(wxGraphicsBrush) |
9e605538 SC |
97 | } ; |
98 | ||
2c820406 SC |
99 | extern WXDLLEXPORT_DATA(wxGraphicsBrush) wxNullGraphicsBrush; |
100 | ||
9e605538 | 101 | class WXDLLIMPEXP_CORE wxGraphicsFont : public wxGraphicsObject |
50581042 SC |
102 | { |
103 | public : | |
2c820406 | 104 | wxGraphicsFont() {} |
9e605538 | 105 | virtual ~wxGraphicsFont() {} |
9e605538 | 106 | private : |
2c820406 | 107 | DECLARE_DYNAMIC_CLASS(wxGraphicsFont) |
9e605538 SC |
108 | } ; |
109 | ||
2c820406 SC |
110 | extern WXDLLEXPORT_DATA(wxGraphicsFont) wxNullGraphicsFont; |
111 | ||
112 | ||
a4e73390 | 113 | class WXDLLIMPEXP_CORE wxGraphicsMatrixData : public wxGraphicsObjectRefData |
9e605538 SC |
114 | { |
115 | public : | |
a4e73390 SC |
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() {} | |
9e605538 | 231 | |
50581042 SC |
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; | |
a4e73390 | 244 | |
0d3675a6 | 245 | // adds another path |
a4e73390 | 246 | virtual void AddPath( const wxGraphicsPathData* path ) =0; |
50581042 SC |
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 | |
a4e73390 | 252 | virtual void GetCurrentPoint( wxDouble* x, wxDouble* y) const = 0; |
50581042 SC |
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 | ||
59720690 | 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) |
50581042 | 272 | virtual void AddArcToPoint( wxDouble x1, wxDouble y1 , wxDouble x2, wxDouble y2, wxDouble r ) ; |
a4e73390 | 273 | |
59720690 SC |
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 | ||
0d3675a6 RD |
280 | // returns the native path |
281 | virtual void * GetNativePath() const = 0; | |
a4e73390 | 282 | |
0d3675a6 | 283 | // give the native path returned by GetNativePath() back (there might be some deallocations necessary) |
a4e73390 SC |
284 | virtual void UnGetNativePath(void *p) const= 0; |
285 | ||
0d3675a6 | 286 | // transforms each point of this path by the matrix |
a4e73390 SC |
287 | virtual void Transform( const wxGraphicsMatrixData* matrix ) =0; |
288 | ||
0d3675a6 | 289 | // gets the bounding box enclosing all points (possibly including control points) |
a4e73390 SC |
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; | |
50581042 SC |
293 | }; |
294 | ||
a4e73390 | 295 | class WXDLLIMPEXP_CORE wxGraphicsPath : public wxGraphicsObject |
774f4d12 SC |
296 | { |
297 | public : | |
a4e73390 SC |
298 | wxGraphicsPath() {} |
299 | virtual ~wxGraphicsPath() {} | |
0d3675a6 | 300 | |
a4e73390 SC |
301 | // |
302 | // These are the path primitives from which everything else can be constructed | |
303 | // | |
9e605538 | 304 | |
a4e73390 SC |
305 | // begins a new subpath at (x,y) |
306 | virtual void MoveToPoint( wxDouble x, wxDouble y ); | |
307 | void MoveToPoint( const wxPoint2DDouble& p); | |
0d3675a6 | 308 | |
a4e73390 SC |
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); | |
0d3675a6 | 312 | |
a4e73390 SC |
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); | |
0d3675a6 | 316 | |
a4e73390 SC |
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 | ||
774f4d12 | 331 | // |
a4e73390 SC |
332 | // These are convenience functions which - if not available natively will be assembled |
333 | // using the primitives from above | |
774f4d12 | 334 | // |
a4e73390 SC |
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 ) ; | |
774f4d12 | 347 | |
a4e73390 SC |
348 | // appends an ellipse |
349 | virtual void AddEllipse( wxDouble x, wxDouble y, wxDouble w, wxDouble h); | |
774f4d12 | 350 | |
a4e73390 SC |
351 | // appends a rounded rectangle |
352 | virtual void AddRoundedRectangle( wxDouble x, wxDouble y, wxDouble w, wxDouble h, wxDouble radius); | |
774f4d12 | 353 | |
a4e73390 SC |
354 | // returns the native path |
355 | virtual void * GetNativePath() const; | |
0d3675a6 | 356 | |
a4e73390 SC |
357 | // give the native path returned by GetNativePath() back (there might be some deallocations necessary) |
358 | virtual void UnGetNativePath(void *p)const; | |
0d3675a6 | 359 | |
a4e73390 SC |
360 | // transforms each point of this path by the matrix |
361 | virtual void Transform( const wxGraphicsMatrix& matrix ); | |
0d3675a6 | 362 | |
a4e73390 SC |
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; | |
0d3675a6 | 366 | |
a4e73390 SC |
367 | virtual bool Contains( wxDouble x, wxDouble y, int fillStyle = wxODDEVEN_RULE)const; |
368 | bool Contains( const wxPoint2DDouble& c, int fillStyle = wxODDEVEN_RULE)const; | |
0d3675a6 | 369 | |
a4e73390 SC |
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) | |
774f4d12 | 377 | } ; |
774f4d12 | 378 | |
a4e73390 SC |
379 | extern WXDLLEXPORT_DATA(wxGraphicsPath) wxNullGraphicsPath; |
380 | ||
381 | ||
9e605538 | 382 | class WXDLLIMPEXP_CORE wxGraphicsContext : public wxGraphicsObject |
50581042 SC |
383 | { |
384 | public: | |
9e605538 | 385 | wxGraphicsContext(wxGraphicsRenderer* renderer); |
774f4d12 | 386 | |
9e605538 | 387 | virtual ~wxGraphicsContext(); |
50581042 SC |
388 | |
389 | static wxGraphicsContext* Create( const wxWindowDC& dc) ; | |
0d3675a6 | 390 | |
773ccc31 SC |
391 | #ifdef __WXMSW__ |
392 | static wxGraphicsContext * Create( const wxMemoryDC& dc) ; | |
393 | #endif | |
394 | ||
bf2185eb | 395 | static wxGraphicsContext* CreateFromNative( void * context ) ; |
774f4d12 | 396 | |
bf2185eb | 397 | static wxGraphicsContext* CreateFromNativeWindow( void * window ) ; |
9a02779a | 398 | |
774f4d12 | 399 | static wxGraphicsContext* Create( wxWindow* window ) ; |
50581042 | 400 | |
ad667945 SC |
401 | // create a context that can be used for measuring texts only, no drawing allowed |
402 | static wxGraphicsContext * Create(); | |
403 | ||
a4e73390 | 404 | wxGraphicsPath CreatePath() const; |
0d3675a6 | 405 | |
a4e73390 | 406 | virtual wxGraphicsPen CreatePen(const wxPen& pen) const; |
9e605538 | 407 | |
a4e73390 | 408 | virtual wxGraphicsBrush CreateBrush(const wxBrush& brush ) const; |
9e605538 SC |
409 | |
410 | // sets the brush to a linear gradient, starting at (x1,y1) with color c1 to (x2,y2) with color c2 | |
2c820406 | 411 | virtual wxGraphicsBrush CreateLinearGradientBrush( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2, |
a4e73390 | 412 | const wxColour&c1, const wxColour&c2) const; |
9e605538 SC |
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 | |
2c820406 | 416 | virtual wxGraphicsBrush CreateRadialGradientBrush( wxDouble xo, wxDouble yo, wxDouble xc, wxDouble yc, wxDouble radius, |
a4e73390 | 417 | const wxColour &oColor, const wxColour &cColor) const; |
9e605538 SC |
418 | |
419 | // sets the font | |
a4e73390 | 420 | virtual wxGraphicsFont CreateFont( const wxFont &font , const wxColour &col = *wxBLACK ) const; |
9e605538 | 421 | |
0d3675a6 | 422 | // create a 'native' matrix corresponding to these values |
a4e73390 SC |
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; | |
0d3675a6 | 425 | |
50581042 SC |
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 | ||
774f4d12 | 432 | // clips drawings to the region, combined to current clipping region |
50581042 SC |
433 | virtual void Clip( const wxRegion ®ion ) = 0; |
434 | ||
774f4d12 SC |
435 | // clips drawings to the rect |
436 | virtual void Clip( wxDouble x, wxDouble y, wxDouble w, wxDouble h ) = 0; | |
0d3675a6 RD |
437 | |
438 | // resets the clipping to original extent | |
439 | virtual void ResetClip() = 0 ; | |
774f4d12 | 440 | |
0d3675a6 RD |
441 | // returns the native context |
442 | virtual void * GetNativeContext() = 0; | |
774f4d12 | 443 | |
50581042 | 444 | // |
774f4d12 | 445 | // transformation : changes the current transformation matrix CTM of the context |
50581042 SC |
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; | |
0d3675a6 RD |
456 | |
457 | // concatenates this transform with the current transform of this context | |
a4e73390 | 458 | virtual void ConcatTransform( const wxGraphicsMatrix& matrix ) = 0; |
9e605538 | 459 | |
0d3675a6 | 460 | // sets the transform of this context |
a4e73390 | 461 | virtual void SetTransform( const wxGraphicsMatrix& matrix ) = 0; |
50581042 | 462 | |
0d3675a6 | 463 | // gets the matrix of this context |
a4e73390 | 464 | virtual wxGraphicsMatrix GetTransform() const = 0; |
50581042 SC |
465 | // |
466 | // setting the paint | |
467 | // | |
468 | ||
9e605538 | 469 | // sets the pen |
2c820406 | 470 | virtual void SetPen( const wxGraphicsPen& pen ); |
9e605538 SC |
471 | |
472 | void SetPen( const wxPen& pen ); | |
50581042 SC |
473 | |
474 | // sets the brush for filling | |
2c820406 | 475 | virtual void SetBrush( const wxGraphicsBrush& brush ); |
9e605538 SC |
476 | |
477 | void SetBrush( const wxBrush& brush ); | |
50581042 SC |
478 | |
479 | // sets the font | |
2c820406 | 480 | virtual void SetFont( const wxGraphicsFont& font ); |
9e605538 SC |
481 | |
482 | void SetFont( const wxFont& font, const wxColour& colour ); | |
0d3675a6 | 483 | |
50581042 | 484 | |
50581042 | 485 | // strokes along a path with the current pen |
a4e73390 | 486 | virtual void StrokePath( const wxGraphicsPath& path ) = 0; |
50581042 SC |
487 | |
488 | // fills a path with the current brush | |
a4e73390 | 489 | virtual void FillPath( const wxGraphicsPath& path, int fillStyle = wxODDEVEN_RULE ) = 0; |
50581042 SC |
490 | |
491 | // draws a path by first filling and then stroking | |
a4e73390 | 492 | virtual void DrawPath( const wxGraphicsPath& path, int fillStyle = wxODDEVEN_RULE ); |
0d3675a6 | 493 | |
50581042 SC |
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 | ||
068eb463 SC |
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 | ||
50581042 SC |
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 | |
a4e73390 | 533 | virtual void DrawLines( size_t n, const wxPoint2DDouble *points, int fillStyle = wxODDEVEN_RULE ); |
50581042 SC |
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 | ||
9e605538 | 544 | // wrappers using wxPoint2DDouble TODO |
50581042 | 545 | |
de3cb39f RD |
546 | // helper to determine if a 0.5 offset should be applied for the drawing operation |
547 | virtual bool ShouldOffset() const { return false; } | |
9e605538 | 548 | |
9da34e21 JS |
549 | protected : |
550 | ||
2c820406 SC |
551 | wxGraphicsPen m_pen; |
552 | wxGraphicsBrush m_brush; | |
553 | wxGraphicsFont m_font; | |
9e605538 SC |
554 | |
555 | private : | |
50581042 | 556 | DECLARE_NO_COPY_CLASS(wxGraphicsContext) |
8ddf8e82 | 557 | DECLARE_ABSTRACT_CLASS(wxGraphicsContext) |
50581042 SC |
558 | }; |
559 | ||
9e605538 SC |
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 : | |
0d3675a6 RD |
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 | ||
9e605538 | 586 | private : |
0d3675a6 RD |
587 | wxGraphicsMatrix* m_matrix; |
588 | wxGraphicsPath* m_path; | |
9e605538 SC |
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 | ||
0d3675a6 | 608 | static wxGraphicsRenderer* GetDefaultRenderer(); |
9e605538 | 609 | |
0d3675a6 | 610 | // Context |
9e605538 | 611 | |
0d3675a6 | 612 | virtual wxGraphicsContext * CreateContext( const wxWindowDC& dc) = 0 ; |
773ccc31 SC |
613 | #ifdef __WXMSW__ |
614 | virtual wxGraphicsContext * CreateContext( const wxMemoryDC& dc) = 0 ; | |
615 | #endif | |
0d3675a6 | 616 | virtual wxGraphicsContext * CreateContextFromNativeContext( void * context ) = 0; |
9e605538 | 617 | |
0d3675a6 | 618 | virtual wxGraphicsContext * CreateContextFromNativeWindow( void * window ) = 0; |
9e605538 | 619 | |
0d3675a6 | 620 | virtual wxGraphicsContext * CreateContext( wxWindow* window ) = 0; |
9e605538 | 621 | |
ad667945 SC |
622 | // create a context that can be used for measuring texts only, no drawing allowed |
623 | virtual wxGraphicsContext * CreateMeasuringContext() = 0; | |
624 | ||
0d3675a6 RD |
625 | // Path |
626 | ||
a4e73390 | 627 | virtual wxGraphicsPath CreatePath() = 0; |
9e605538 | 628 | |
0d3675a6 RD |
629 | // Matrix |
630 | ||
a4e73390 | 631 | virtual wxGraphicsMatrix CreateMatrix( wxDouble a=1.0, wxDouble b=0.0, wxDouble c=0.0, wxDouble d=1.0, |
0d3675a6 | 632 | wxDouble tx=0.0, wxDouble ty=0.0) = 0; |
9e605538 SC |
633 | |
634 | // Paints | |
635 | ||
2c820406 | 636 | virtual wxGraphicsPen CreatePen(const wxPen& pen) = 0 ; |
9e605538 | 637 | |
2c820406 | 638 | virtual wxGraphicsBrush CreateBrush(const wxBrush& brush ) = 0 ; |
9e605538 SC |
639 | |
640 | // sets the brush to a linear gradient, starting at (x1,y1) with color c1 to (x2,y2) with color c2 | |
2c820406 | 641 | virtual wxGraphicsBrush CreateLinearGradientBrush( wxDouble x1, wxDouble y1, wxDouble x2, wxDouble y2, |
9e605538 SC |
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 | |
2c820406 | 646 | virtual wxGraphicsBrush CreateRadialGradientBrush( wxDouble xo, wxDouble yo, wxDouble xc, wxDouble yc, wxDouble radius, |
9e605538 SC |
647 | const wxColour &oColor, const wxColour &cColor) = 0; |
648 | ||
649 | // sets the font | |
2c820406 | 650 | virtual wxGraphicsFont CreateFont( const wxFont &font , const wxColour &col = *wxBLACK ) = 0; |
9e605538 SC |
651 | |
652 | private : | |
0d3675a6 | 653 | DECLARE_NO_COPY_CLASS(wxGraphicsRenderer) |
9e605538 SC |
654 | DECLARE_ABSTRACT_CLASS(wxGraphicsRenderer) |
655 | } ; | |
656 | ||
774f4d12 | 657 | #endif |
50581042 | 658 | |
8acd14d1 | 659 | #endif // _WX_GRAPHICS_H_ |