]>
Commit | Line | Data |
---|---|---|
0c6fcb09 | 1 | \section{\class{wxSVGFileDC}}\label{wxsvgfiledc} |
164e084a CE |
2 | |
3 | A wxSVGFileDC is a {\it device context} onto which graphics and text can be drawn, and the output | |
4 | produced as a vector file, in the SVG format (see http://www.w3.org/TR/2001/REC-SVG-20010904/ ). | |
5 | This format can be read by a range of programs, including a Netscape plugin (Adobe), full details at | |
6 | http://www.w3.org/Graphics/SVG/SVG-Implementations.htm8 Vector formats may often be smaller | |
7 | than raster formats. | |
8 | ||
9 | The intention behind wxSVGFileDC is that it can be used to produce a file corresponding | |
10 | to the screen display context, wxSVGFileDC, by passing the wxSVGFileDC as a parameter instead of a wxSVGFileDC. Thus | |
11 | the wxSVGFileDC is a write-only class. | |
12 | ||
13 | As the wxSVGFileDC is a vector format, raster operations like GetPixel are unlikely to be supported. | |
14 | However, the SVG specification allows for PNG format raster files to be embedded in the SVG, and so | |
15 | bitmaps, icons and blit operations into the wxSVGFileDC are supported. | |
16 | ||
17 | A more substantial SVG library (for reading and writing) is available at | |
18 | http://www.xs4all.nl/~kholwerd/wxstuff/canvas/htmldocbook/aap.html | |
19 | ||
20 | \wxheading{Derived from} | |
21 | ||
0c6fcb09 | 22 | \helpref{wxDC}{wxdc} |
164e084a CE |
23 | |
24 | \wxheading{Include files} | |
25 | ||
26 | <wx/dcsvg.h> | |
27 | ||
a7af285d VZ |
28 | \wxheading{Library} |
29 | ||
30 | \helpref{wxCore}{librarieslist} | |
31 | ||
164e084a CE |
32 | \wxheading{See also} |
33 | ||
34 | %\helpref{Overview}{dcoverview} | |
35 | ||
36 | ||
37 | \latexignore{\rtfignore{\wxheading{Members}}} | |
38 | ||
0c6fcb09 | 39 | \membersection{wxSVGFileDC::wxSVGFileDC}\label{wxsvgfiledcctor} |
164e084a | 40 | |
0c6fcb09 FM |
41 | \func{}{wxSVGFileDC}{\param{wxString}{ f}} |
42 | ||
43 | \func{}{wxSVGFileDC}{\param{wxString}{ f}, \param{int}{ Width},\param{int}{ Height}} | |
44 | ||
45 | \func{}{wxSVGFileDC}{\param{wxString}{ f}, \param{int}{ Width},\param{int}{ Height},\param{float}{ dpi}} | |
164e084a CE |
46 | |
47 | Constructors: | |
48 | a filename {\it f} with default size 340x240 at 72.0 dots per inch (a frequent screen resolution). | |
49 | a filename {\it f} with size {\it Width} by {\it Height} at 72.0 dots per inch | |
50 | a filename {\it f} with size {\it Width} by {\it Height} at {\it dpi} resolution. | |
51 | ||
0c6fcb09 | 52 | \membersection{wxSVGFileDC::\destruct{wxSVGFileDC}}\label{wxsvgfiledcdtor} |
164e084a CE |
53 | |
54 | \func{}{\destruct{wxSVGFileDC}}{\void} | |
55 | ||
56 | Destructor. | |
57 | ||
0c6fcb09 | 58 | \membersection{wxSVGFileDC::BeginDrawing}\label{wxsvgfiledcbegindrawing} |
164e084a CE |
59 | |
60 | Does nothing | |
61 | ||
0c6fcb09 | 62 | \membersection{wxSVGFileDC::Blit}\label{wxsvgfiledcblit} |
164e084a CE |
63 | |
64 | \func{bool}{Blit}{\param{wxCoord}{ xdest}, \param{wxCoord}{ ydest}, \param{wxCoord}{ width}, \param{wxCoord}{ height}, | |
65 | \param{wxSVGFileDC* }{source}, \param{wxCoord}{ xsrc}, \param{wxCoord}{ ysrc}, \param{int}{ logicalFunc = wxCOPY}, | |
66 | \param{bool }{useMask = FALSE}, \param{wxCoord}{ xsrcMask = -1}, \param{wxCoord}{ ysrcMask = -1}} | |
67 | ||
68 | As wxDC: Copy from a source DC to this DC, specifying the destination | |
69 | coordinates, size of area to copy, source DC, source coordinates, | |
70 | logical function, whether to use a bitmap mask, and mask source position. | |
71 | ||
0c6fcb09 | 72 | \membersection{wxSVGFileDC::CalcBoundingBox}\label{wxsvgfiledccalcboundingbox} |
164e084a CE |
73 | |
74 | \func{void}{CalcBoundingBox}{\param{wxCoord }{x}, \param{wxCoord }{y}} | |
75 | ||
76 | Adds the specified point to the bounding box which can be retrieved with | |
77 | \helpref{MinX}{wxdcminx}, \helpref{MaxX}{wxdcmaxx} and | |
78 | \helpref{MinY}{wxdcminy}, \helpref{MaxY}{wxdcmaxy} functions. | |
79 | ||
80 | ||
0c6fcb09 | 81 | \membersection{wxSVGFileDC::Clear}\label{wxsvgfiledcclear} |
164e084a CE |
82 | |
83 | \func{void}{Clear}{\void} | |
84 | ||
85 | This makes no sense in wxSVGFileDC and does nothing | |
86 | ||
87 | ||
0c6fcb09 | 88 | \membersection{wxSVGFileDC::CrossHair}\label{wxsvgfiledccrosshair} |
164e084a CE |
89 | |
90 | \func{void}{CrossHair}{\param{wxCoord}{ x}, \param{wxCoord}{ y}} | |
91 | ||
92 | Not Implemented | |
93 | ||
0c6fcb09 | 94 | \membersection{wxSVGFileDC::DestroyClippingRegion}\label{wxsvgfiledcdestroyclippingregion} |
164e084a CE |
95 | |
96 | \func{void}{DestroyClippingRegion}{\void} | |
97 | ||
98 | Not Implemented | |
99 | ||
0c6fcb09 | 100 | \membersection{wxSVGFileDC::DeviceToLogicalX}\label{wxsvgfiledcdevicetologicalx} |
164e084a CE |
101 | |
102 | \func{wxCoord}{DeviceToLogicalX}{\param{wxCoord}{ x}} | |
103 | ||
104 | Convert device X coordinate to logical coordinate, using the current | |
105 | mapping mode. | |
106 | ||
0c6fcb09 | 107 | \membersection{wxSVGFileDC::DeviceToLogicalXRel}\label{wxsvgfiledcdevicetologicalxrel} |
164e084a CE |
108 | |
109 | \func{wxCoord}{DeviceToLogicalXRel}{\param{wxCoord}{ x}} | |
110 | ||
111 | Convert device X coordinate to relative logical coordinate, using the current | |
112 | mapping mode but ignoring the x axis orientation. | |
113 | Use this function for converting a width, for example. | |
114 | ||
0c6fcb09 | 115 | \membersection{wxSVGFileDC::DeviceToLogicalY}\label{wxsvgfiledcdevicetologicaly} |
164e084a CE |
116 | |
117 | \func{wxCoord}{DeviceToLogicalY}{\param{wxCoord}{ y}} | |
118 | ||
119 | Converts device Y coordinate to logical coordinate, using the current | |
120 | mapping mode. | |
121 | ||
0c6fcb09 | 122 | \membersection{wxSVGFileDC::DeviceToLogicalYRel}\label{wxsvgfiledcdevicetologicalyrel} |
164e084a CE |
123 | |
124 | \func{wxCoord}{DeviceToLogicalYRel}{\param{wxCoord}{ y}} | |
125 | ||
126 | Convert device Y coordinate to relative logical coordinate, using the current | |
127 | mapping mode but ignoring the y axis orientation. | |
128 | Use this function for converting a height, for example. | |
129 | ||
0c6fcb09 | 130 | \membersection{wxSVGFileDC::DrawArc}\label{wxsvgfiledcdrawarc} |
164e084a | 131 | |
8bdd5efa | 132 | \func{void}{DrawArc}{\param{wxCoord}{ x1}, \param{wxCoord}{ y1}, \param{wxCoord}{ x2}, \param{wxCoord}{ y2}, \param{wxCoord}{ xc}, \param{wxCoord}{ yc}} |
164e084a CE |
133 | |
134 | Draws an arc of a circle, centred on ({\it xc, yc}), with starting point ({\it x1, y1}) | |
135 | and ending at ({\it x2, y2}). The current pen is used for the outline | |
136 | and the current brush for filling the shape. | |
137 | ||
138 | The arc is drawn in an anticlockwise direction from the start point to the end point. | |
139 | ||
0c6fcb09 | 140 | \membersection{wxSVGFileDC::DrawBitmap}\label{wxsvgfiledcdrawbitmap} |
164e084a CE |
141 | |
142 | \func{void}{DrawBitmap}{\param{const wxBitmap\&}{ bitmap}, \param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{bool}{ transparent}} | |
143 | ||
ea76a6a5 | 144 | Draw a bitmap on the device context at the specified point. If {\it transparent} is true and the bitmap has |
164e084a CE |
145 | a transparency mask, the bitmap will be drawn transparently. |
146 | ||
147 | When drawing a mono-bitmap, the current text foreground colour will be used to draw the foreground | |
148 | of the bitmap (all bits set to 1), and the current text background colour to draw the background | |
149 | (all bits set to 0). See also \helpref{SetTextForeground}{wxdcsettextforeground}, | |
150 | \helpref{SetTextBackground}{wxdcsettextbackground} and \helpref{wxMemoryDC}{wxmemorydc}. | |
151 | ||
0c6fcb09 | 152 | \membersection{wxSVGFileDC::DrawCheckMark}\label{wxsvgfiledcdrawcheckmark} |
164e084a CE |
153 | |
154 | \func{void}{DrawCheckMark}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxCoord}{ width}, \param{wxCoord}{ height}} | |
155 | ||
156 | \func{void}{DrawCheckMark}{\param{const wxRect \&}{rect}} | |
157 | ||
158 | Draws a check mark inside the given rectangle. | |
159 | ||
0c6fcb09 | 160 | \membersection{wxSVGFileDC::DrawCircle}\label{wxsvgfiledcdrawcircle} |
164e084a CE |
161 | |
162 | \func{void}{DrawCircle}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxCoord}{ radius}} | |
163 | ||
164 | \func{void}{DrawCircle}{\param{const wxPoint\&}{ pt}, \param{wxCoord}{ radius}} | |
165 | ||
166 | Draws a circle with the given centre and radius. | |
167 | ||
168 | \wxheading{See also} | |
169 | ||
170 | \helpref{DrawEllipse}{wxdcdrawellipse} | |
171 | ||
0c6fcb09 | 172 | \membersection{wxSVGFileDC::DrawEllipse}\label{wxsvgfiledcdrawellipse} |
164e084a CE |
173 | |
174 | \func{void}{DrawEllipse}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxCoord}{ width}, \param{wxCoord}{ height}} | |
175 | ||
176 | \func{void}{DrawEllipse}{\param{const wxPoint\&}{ pt}, \param{const wxSize\&}{ size}} | |
177 | ||
178 | \func{void}{DrawEllipse}{\param{const wxRect\&}{ rect}} | |
179 | ||
180 | Draws an ellipse contained in the rectangle specified either with the given top | |
181 | left corner and the given size or directly. The current pen is used for the | |
182 | outline and the current brush for filling the shape. | |
183 | ||
184 | \wxheading{See also} | |
185 | ||
186 | \helpref{DrawCircle}{wxdcdrawcircle} | |
187 | ||
0c6fcb09 | 188 | \membersection{wxSVGFileDC::DrawEllipticArc}\label{wxsvgfiledcdrawellipticarc} |
164e084a CE |
189 | |
190 | \func{void}{DrawEllipticArc}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxCoord}{ width}, \param{wxCoord}{ height}, | |
191 | \param{double}{ start}, \param{double}{ end}} | |
192 | ||
193 | Draws an arc of an ellipse. The current pen is used for drawing the arc and | |
194 | the current brush is used for drawing the pie. | |
195 | ||
196 | {\it x} and {\it y} specify the x and y coordinates of the upper-left corner of the rectangle that contains | |
197 | the ellipse. | |
198 | ||
199 | {\it width} and {\it height} specify the width and height of the rectangle that contains | |
200 | the ellipse. | |
201 | ||
202 | {\it start} and {\it end} specify the start and end of the arc relative to the three-o'clock | |
203 | position from the center of the rectangle. Angles are specified | |
204 | in degrees (360 is a complete circle). Positive values mean | |
205 | counter-clockwise motion. If {\it start} is equal to {\it end}, a | |
206 | complete ellipse will be drawn. | |
207 | ||
0c6fcb09 | 208 | \membersection{wxSVGFileDC::DrawIcon}\label{wxsvgfiledcdrawicon} |
164e084a CE |
209 | |
210 | \func{void}{DrawIcon}{\param{const wxIcon\&}{ icon}, \param{wxCoord}{ x}, \param{wxCoord}{ y}} | |
211 | ||
212 | Draw an icon on the display (does nothing if the device context is PostScript). | |
213 | This can be the simplest way of drawing bitmaps on a window. | |
214 | ||
0c6fcb09 | 215 | \membersection{wxSVGFileDC::DrawLine}\label{wxsvgfiledcdrawline} |
164e084a CE |
216 | |
217 | \func{void}{DrawLine}{\param{wxCoord}{ x1}, \param{wxCoord}{ y1}, \param{wxCoord}{ x2}, \param{wxCoord}{ y2}} | |
218 | ||
219 | Draws a line from the first point to the second. The current pen is used | |
220 | for drawing the line. | |
221 | ||
0c6fcb09 | 222 | \membersection{wxSVGFileDC::DrawLines}\label{wxsvgfiledcdrawlines} |
164e084a CE |
223 | |
224 | \func{void}{DrawLines}{\param{int}{ n}, \param{wxPoint}{ points[]}, \param{wxCoord}{ xoffset = 0}, \param{wxCoord}{ yoffset = 0}} | |
225 | ||
226 | \func{void}{DrawLines}{\param{wxList *}{points}, \param{wxCoord}{ xoffset = 0}, \param{wxCoord}{ yoffset = 0}} | |
227 | ||
228 | Draws lines using an array of {\it points} of size {\it n}, or list of | |
229 | pointers to points, adding the optional offset coordinate. The current | |
230 | pen is used for drawing the lines. The programmer is responsible for | |
231 | deleting the list of points. | |
232 | ||
0c6fcb09 | 233 | \membersection{wxSVGFileDC::DrawPolygon}\label{wxsvgfiledcdrawpolygon} |
164e084a CE |
234 | |
235 | \func{void}{DrawPolygon}{\param{int}{ n}, \param{wxPoint}{ points[]}, \param{wxCoord}{ xoffset = 0}, \param{wxCoord}{ yoffset = 0},\\ | |
236 | \param{int }{fill\_style = wxODDEVEN\_RULE}} | |
237 | ||
238 | \func{void}{DrawPolygon}{\param{wxList *}{points}, \param{wxCoord}{ xoffset = 0}, \param{wxCoord}{ yoffset = 0},\\ | |
239 | \param{int }{fill\_style = wxODDEVEN\_RULE}} | |
240 | ||
241 | Draws a filled polygon using an array of {\it points} of size {\it n}, | |
242 | or list of pointers to points, adding the optional offset coordinate. | |
243 | ||
244 | The last argument specifies the fill rule: {\bf wxODDEVEN\_RULE} (the | |
245 | default) or {\bf wxWINDING\_RULE}. | |
246 | ||
247 | The current pen is used for drawing the outline, and the current brush | |
248 | for filling the shape. Using a transparent brush suppresses filling. | |
249 | The programmer is responsible for deleting the list of points. | |
250 | ||
251 | Note that wxWindows automatically closes the first and last points. | |
252 | ||
253 | ||
0c6fcb09 | 254 | \membersection{wxSVGFileDC::DrawPoint}\label{wxsvgfiledcdrawpoint} |
164e084a CE |
255 | |
256 | \func{void}{DrawPoint}{\param{wxCoord}{ x}, \param{wxCoord}{ y}} | |
257 | ||
258 | Draws a point using the current pen. | |
259 | ||
0c6fcb09 | 260 | \membersection{wxSVGFileDC::DrawRectangle}\label{wxsvgfiledcdrawrectangle} |
164e084a CE |
261 | |
262 | \func{void}{DrawRectangle}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxCoord}{ width}, \param{wxCoord}{ height}} | |
263 | ||
264 | Draws a rectangle with the given top left corner, and with the given | |
265 | size. The current pen is used for the outline and the current brush | |
266 | for filling the shape. | |
267 | ||
0c6fcb09 | 268 | \membersection{wxSVGFileDC::DrawRotatedText}\label{wxsvgfiledcdrawrotatedtext} |
164e084a CE |
269 | |
270 | \func{void}{DrawRotatedText}{\param{const wxString\& }{text}, \param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{double}{ angle}} | |
271 | ||
272 | Draws the text rotated by {\it angle} degrees. | |
273 | ||
274 | The wxMSW wxDC and wxSVGFileDC rotate the text around slightly different points, depending on the size of the font | |
275 | ||
0c6fcb09 | 276 | \membersection{wxSVGFileDC::DrawRoundedRectangle}\label{wxsvgfiledcdrawroundedrectangle} |
164e084a CE |
277 | |
278 | \func{void}{DrawRoundedRectangle}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxCoord}{ width}, \param{wxCoord}{ height}, \param{double}{ radius = 20}} | |
279 | ||
280 | Draws a rectangle with the given top left corner, and with the given | |
281 | size. The corners are quarter-circles using the given radius. The | |
282 | current pen is used for the outline and the current brush for filling | |
283 | the shape. | |
284 | ||
285 | If {\it radius} is positive, the value is assumed to be the | |
286 | radius of the rounded corner. If {\it radius} is negative, | |
287 | the absolute value is assumed to be the {\it proportion} of the smallest | |
288 | dimension of the rectangle. This means that the corner can be | |
289 | a sensible size relative to the size of the rectangle, and also avoids | |
290 | the strange effects X produces when the corners are too big for | |
291 | the rectangle. | |
292 | ||
0c6fcb09 | 293 | \membersection{wxSVGFileDC::DrawSpline}\label{wxsvgfiledcdrawspline} |
164e084a CE |
294 | |
295 | \func{void}{DrawSpline}{\param{wxList *}{points}} | |
296 | ||
297 | Draws a spline between all given control points, using the current | |
298 | pen. Doesn't delete the wxList and contents. The spline is drawn | |
299 | using a series of lines, using an algorithm taken from the X drawing | |
300 | program `XFIG'. | |
301 | ||
302 | \func{void}{DrawSpline}{\param{wxCoord}{ x1}, \param{wxCoord}{ y1}, \param{wxCoord}{ x2}, \param{wxCoord}{ y2}, \param{wxCoord}{ x3}, \param{wxCoord}{ y3}} | |
303 | ||
304 | Draws a three-point spline using the current pen. | |
305 | ||
0c6fcb09 | 306 | \membersection{wxSVGFileDC::DrawText}\label{wxsvgfiledcdrawtext} |
164e084a CE |
307 | |
308 | \func{void}{DrawText}{\param{const wxString\& }{text}, \param{wxCoord}{ x}, \param{wxCoord}{ y}} | |
309 | ||
310 | Draws a text string at the specified point, using the current text font, | |
311 | and the current text foreground and background colours. | |
312 | ||
313 | The coordinates refer to the top-left corner of the rectangle bounding | |
314 | the string. See \helpref{wxSVGFileDC::GetTextExtent}{wxdcgettextextent} for how | |
315 | to get the dimensions of a text string, which can be used to position the | |
316 | text more precisely. | |
317 | ||
318 | ||
319 | ||
0c6fcb09 | 320 | \membersection{wxSVGFileDC::EndDoc}\label{wxsvgfiledcenddoc} |
164e084a CE |
321 | |
322 | \func{void}{EndDoc}{\void} | |
323 | ||
324 | Does nothing | |
325 | ||
0c6fcb09 | 326 | \membersection{wxSVGFileDC::EndDrawing}\label{wxsvgfiledcenddrawing} |
164e084a CE |
327 | |
328 | \func{void}{EndDrawing}{\void} | |
329 | ||
330 | Does nothing | |
331 | ||
0c6fcb09 | 332 | \membersection{wxSVGFileDC::EndPage}\label{wxsvgfiledcendpage} |
164e084a CE |
333 | |
334 | \func{void}{EndPage}{\void} | |
335 | ||
336 | Does nothing | |
337 | ||
0c6fcb09 | 338 | \membersection{wxSVGFileDC::FloodFill}\label{wxsvgfiledcfloodfill} |
164e084a CE |
339 | |
340 | \func{void}{FloodFill}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{const wxColour\&}{ colour}, \param{int}{ style=wxFLOOD\_SURFACE}} | |
341 | ||
342 | Not implemented | |
343 | ||
0c6fcb09 | 344 | \membersection{wxSVGFileDC::GetBackground}\label{wxsvgfiledcgetbackground} |
164e084a CE |
345 | |
346 | \func{wxBrush\&}{GetBackground}{\void} | |
347 | ||
348 | \constfunc{const wxBrush\&}{GetBackground}{\void} | |
349 | ||
350 | Gets the brush used for painting the background (see \helpref{wxSVGFileDC::SetBackground}{wxdcsetbackground}). | |
351 | ||
0c6fcb09 | 352 | \membersection{wxSVGFileDC::GetBackgroundMode}\label{wxsvgfiledcgetbackgroundmode} |
164e084a CE |
353 | |
354 | \constfunc{int}{GetBackgroundMode}{\void} | |
355 | ||
356 | Returns the current background mode: {\tt wxSOLID} or {\tt wxTRANSPARENT}. | |
357 | ||
358 | \wxheading{See also} | |
359 | ||
360 | \helpref{SetBackgroundMode}{wxdcsetbackgroundmode} | |
361 | ||
0c6fcb09 | 362 | \membersection{wxSVGFileDC::GetBrush}\label{wxsvgfiledcgetbrush} |
164e084a CE |
363 | |
364 | \func{wxBrush\&}{GetBrush}{\void} | |
365 | ||
366 | \constfunc{const wxBrush\&}{GetBrush}{\void} | |
367 | ||
368 | Gets the current brush (see \helpref{wxSVGFileDC::SetBrush}{wxdcsetbrush}). | |
369 | ||
0c6fcb09 | 370 | \membersection{wxSVGFileDC::GetCharHeight}\label{wxsvgfiledcgetcharheight} |
164e084a CE |
371 | |
372 | \func{wxCoord}{GetCharHeight}{\void} | |
373 | ||
374 | Gets the character height of the currently set font. | |
375 | ||
0c6fcb09 | 376 | \membersection{wxSVGFileDC::GetCharWidth}\label{wxsvgfiledcgetcharwidth} |
164e084a CE |
377 | |
378 | \func{wxCoord}{GetCharWidth}{\void} | |
379 | ||
380 | Gets the average character width of the currently set font. | |
381 | ||
0c6fcb09 | 382 | \membersection{wxSVGFileDC::GetClippingBox}\label{wxsvgfiledcgetclippingbox} |
164e084a CE |
383 | |
384 | \func{void}{GetClippingBox}{\param{wxCoord}{ *x}, \param{wxCoord}{ *y}, \param{wxCoord}{ *width}, \param{wxCoord}{ *height}} | |
385 | ||
386 | Not implemented | |
387 | ||
0c6fcb09 | 388 | \membersection{wxSVGFileDC::GetFont}\label{wxsvgfiledcgetfont} |
164e084a CE |
389 | |
390 | \func{wxFont\&}{GetFont}{\void} | |
391 | ||
392 | \constfunc{const wxFont\&}{GetFont}{\void} | |
393 | ||
394 | Gets the current font (see \helpref{wxSVGFileDC::SetFont}{wxdcsetfont}). | |
395 | ||
0c6fcb09 | 396 | \membersection{wxSVGFileDC::GetLogicalFunction}\label{wxsvgfiledcgetlogicalfunction} |
164e084a CE |
397 | |
398 | \func{int}{GetLogicalFunction}{\void} | |
399 | ||
400 | Gets the current logical function (see \helpref{wxSVGFileDC::SetLogicalFunction}{wxdcsetlogicalfunction}). | |
401 | ||
0c6fcb09 | 402 | \membersection{wxSVGFileDC::GetMapMode}\label{wxsvgfiledcgetmapmode} |
164e084a CE |
403 | |
404 | \func{int}{GetMapMode}{\void} | |
405 | ||
406 | Gets the {\it mapping mode} for the device context (see \helpref{wxSVGFileDC::SetMapMode}{wxdcsetmapmode}). | |
407 | ||
0c6fcb09 | 408 | \membersection{wxSVGFileDC::GetPen}\label{wxsvgfiledcgetpen} |
164e084a CE |
409 | |
410 | \func{wxPen\&}{GetPen}{\void} | |
411 | ||
412 | \constfunc{const wxPen\&}{GetPen}{\void} | |
413 | ||
414 | Gets the current pen (see \helpref{wxSVGFileDC::SetPen}{wxdcsetpen}). | |
415 | ||
0c6fcb09 | 416 | \membersection{wxSVGFileDC::GetPixel}\label{wxsvgfiledcgetpixel} |
164e084a CE |
417 | |
418 | \func{bool}{GetPixel}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxColour *}{colour}} | |
419 | ||
420 | Not implemented | |
421 | ||
0c6fcb09 | 422 | \membersection{wxSVGFileDC::GetSize}\label{wxsvgfiledcgetsize} |
164e084a CE |
423 | |
424 | \func{void}{GetSize}{\param{wxCoord *}{width}, \param{wxCoord *}{height}} | |
425 | ||
426 | ||
427 | For a Windows printer device context, this gets the horizontal and vertical | |
428 | resolution. | |
429 | ||
0c6fcb09 | 430 | \membersection{wxSVGFileDC::GetTextBackground}\label{wxsvgfiledcgettextbackground} |
164e084a CE |
431 | |
432 | \func{wxColour\&}{GetTextBackground}{\void} | |
433 | ||
434 | \constfunc{const wxColour\&}{GetTextBackground}{\void} | |
435 | ||
436 | Gets the current text background colour (see \helpref{wxSVGFileDC::SetTextBackground}{wxdcsettextbackground}). | |
437 | ||
0c6fcb09 | 438 | \membersection{wxSVGFileDC::GetTextExtent}\label{wxsvgfiledcgettextextent} |
164e084a CE |
439 | |
440 | \func{void}{GetTextExtent}{\param{const wxString\& }{string}, \param{wxCoord *}{w}, \param{wxCoord *}{h},\\ | |
441 | \param{wxCoord *}{descent = NULL}, \param{wxCoord *}{externalLeading = NULL}, \param{wxFont *}{font = NULL}} | |
442 | ||
443 | Gets the dimensions of the string using the currently selected font. | |
444 | \rtfsp{\it string} is the text string to measure, {\it w} and {\it h} are | |
445 | the total width and height respectively, {\it descent} is the | |
446 | dimension from the baseline of the font to the bottom of the | |
447 | descender, and {\it externalLeading} is any extra vertical space added | |
448 | to the font by the font designer (usually is zero). | |
449 | ||
450 | The optional parameter {\it font} specifies an alternative | |
451 | to the currently selected font: but note that this does not | |
452 | yet work under Windows, so you need to set a font for | |
453 | the device context first. | |
454 | ||
455 | See also \helpref{wxFont}{wxfont}, \helpref{wxSVGFileDC::SetFont}{wxdcsetfont}. | |
456 | ||
0c6fcb09 | 457 | \membersection{wxSVGFileDC::GetTextForeground}\label{wxsvgfiledcgettextforeground} |
164e084a CE |
458 | |
459 | \func{wxColour\&}{GetTextForeground}{\void} | |
460 | ||
461 | \constfunc{const wxColour\&}{GetTextForeground}{\void} | |
462 | ||
463 | Gets the current text foreground colour (see \helpref{wxSVGFileDC::SetTextForeground}{wxdcsettextforeground}). | |
464 | ||
465 | ||
0c6fcb09 | 466 | \membersection{wxSVGFileDC::GetUserScale}\label{wxsvgfiledcgetuserscale} |
164e084a CE |
467 | |
468 | \func{void}{GetUserScale}{\param{double}{ *x}, \param{double}{ *y}} | |
469 | ||
470 | Gets the current user scale factor (set by \helpref{SetUserScale}{wxdcsetuserscale}). | |
471 | ||
0c6fcb09 | 472 | \membersection{wxSVGFileDC::LogicalToDeviceX}\label{wxsvgfiledclogicaltodevicex} |
164e084a CE |
473 | |
474 | \func{wxCoord}{LogicalToDeviceX}{\param{wxCoord}{ x}} | |
475 | ||
476 | Converts logical X coordinate to device coordinate, using the current | |
477 | mapping mode. | |
478 | ||
0c6fcb09 | 479 | \membersection{wxSVGFileDC::LogicalToDeviceXRel}\label{wxsvgfiledclogicaltodevicexrel} |
164e084a CE |
480 | |
481 | \func{wxCoord}{LogicalToDeviceXRel}{\param{wxCoord}{ x}} | |
482 | ||
483 | Converts logical X coordinate to relative device coordinate, using the current | |
484 | mapping mode but ignoring the x axis orientation. | |
485 | Use this for converting a width, for example. | |
486 | ||
0c6fcb09 | 487 | \membersection{wxSVGFileDC::LogicalToDeviceY}\label{wxsvgfiledclogicaltodevicey} |
164e084a CE |
488 | |
489 | \func{wxCoord}{LogicalToDeviceY}{\param{wxCoord}{ y}} | |
490 | ||
491 | Converts logical Y coordinate to device coordinate, using the current | |
492 | mapping mode. | |
493 | ||
0c6fcb09 | 494 | \membersection{wxSVGFileDC::LogicalToDeviceYRel}\label{wxsvgfiledclogicaltodeviceyrel} |
164e084a CE |
495 | |
496 | \func{wxCoord}{LogicalToDeviceYRel}{\param{wxCoord}{ y}} | |
497 | ||
498 | Converts logical Y coordinate to relative device coordinate, using the current | |
499 | mapping mode but ignoring the y axis orientation. | |
500 | Use this for converting a height, for example. | |
501 | ||
0c6fcb09 | 502 | \membersection{wxSVGFileDC::MaxX}\label{wxsvgfiledcmaxx} |
164e084a CE |
503 | |
504 | \func{wxCoord}{MaxX}{\void} | |
505 | ||
506 | Gets the maximum horizontal extent used in drawing commands so far. | |
507 | ||
0c6fcb09 | 508 | \membersection{wxSVGFileDC::MaxY}\label{wxsvgfiledcmaxy} |
164e084a CE |
509 | |
510 | \func{wxCoord}{MaxY}{\void} | |
511 | ||
512 | Gets the maximum vertical extent used in drawing commands so far. | |
513 | ||
0c6fcb09 | 514 | \membersection{wxSVGFileDC::MinX}\label{wxsvgfiledcminx} |
164e084a CE |
515 | |
516 | \func{wxCoord}{MinX}{\void} | |
517 | ||
518 | Gets the minimum horizontal extent used in drawing commands so far. | |
519 | ||
0c6fcb09 | 520 | \membersection{wxSVGFileDC::MinY}\label{wxsvgfiledcminy} |
164e084a CE |
521 | |
522 | \func{wxCoord}{MinY}{\void} | |
523 | ||
524 | Gets the minimum vertical extent used in drawing commands so far. | |
525 | ||
0c6fcb09 | 526 | \membersection{wxSVGFileDC::Ok}\label{wxsvgfiledcok} |
164e084a CE |
527 | |
528 | \func{bool}{Ok}{\void} | |
529 | ||
ea76a6a5 | 530 | Returns true if the DC is ok to use; False values arise from being unable to |
164e084a CE |
531 | write the file |
532 | ||
0c6fcb09 | 533 | \membersection{wxSVGFileDC::ResetBoundingBox}\label{wxsvgfiledcresetboundingbox} |
164e084a CE |
534 | |
535 | \func{void}{ResetBoundingBox}{\void} | |
536 | ||
537 | Resets the bounding box: after a call to this function, the bounding box | |
538 | doesn't contain anything. | |
539 | ||
540 | \wxheading{See also} | |
541 | ||
542 | \helpref{CalcBoundingBox}{wxdccalcboundingbox} | |
543 | ||
0c6fcb09 | 544 | \membersection{wxSVGFileDC::SetAxisOrientation}\label{wxsvgfiledcsetaxisorientation} |
164e084a CE |
545 | |
546 | \func{void}{SetAxisOrientation}{\param{bool}{ xLeftRight}, | |
547 | \param{bool}{ yBottomUp}} | |
548 | ||
549 | Sets the x and y axis orientation (i.e., the direction from lowest to | |
550 | highest values on the axis). The default orientation is the natural | |
551 | orientation, e.g. x axis from left to right and y axis from bottom up. | |
552 | ||
553 | \wxheading{Parameters} | |
554 | ||
555 | \docparam{xLeftRight}{True to set the x axis orientation to the natural | |
556 | left to right orientation, false to invert it.} | |
557 | ||
558 | \docparam{yBottomUp}{True to set the y axis orientation to the natural | |
559 | bottom up orientation, false to invert it.} | |
560 | ||
0c6fcb09 | 561 | \membersection{wxSVGFileDC::SetDeviceOrigin}\label{wxsvgfiledcsetdeviceorigin} |
164e084a CE |
562 | |
563 | \func{void}{SetDeviceOrigin}{\param{wxCoord}{ x}, \param{wxCoord}{ y}} | |
564 | ||
565 | Sets the device origin (i.e., the origin in pixels after scaling has been | |
566 | applied). | |
567 | ||
568 | This function may be useful in Windows printing | |
569 | operations for placing a graphic on a page. | |
570 | ||
0c6fcb09 | 571 | \membersection{wxSVGFileDC::SetBackground}\label{wxsvgfiledcsetbackground} |
164e084a CE |
572 | |
573 | \func{void}{SetBackground}{\param{const wxBrush\& }{brush}} | |
574 | ||
575 | Sets the current background brush for the DC. | |
576 | ||
0c6fcb09 | 577 | \membersection{wxSVGFileDC::SetBackgroundMode}\label{wxsvgfiledcsetbackgroundmode} |
164e084a CE |
578 | |
579 | \func{void}{SetBackgroundMode}{\param{int}{ mode}} | |
580 | ||
581 | {\it mode} may be one of wxSOLID and wxTRANSPARENT. This setting determines | |
582 | whether text will be drawn with a background colour or not. | |
583 | ||
0c6fcb09 | 584 | \membersection{wxSVGFileDC::SetClippingRegion}\label{wxsvgfiledcsetclippingregion} |
164e084a CE |
585 | |
586 | \func{void}{SetClippingRegion}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxCoord}{ width}, \param{wxCoord}{ height}} | |
587 | ||
588 | \func{void}{SetClippingRegion}{\param{const wxPoint\& }{pt}, \param{const wxSize\& }{sz}} | |
589 | ||
590 | \func{void}{SetClippingRegion}{\param{const wxRect\&}{ rect}} | |
591 | ||
592 | \func{void}{SetClippingRegion}{\param{const wxRegion\&}{ region}} | |
593 | ||
594 | Not implemented | |
595 | ||
596 | ||
0c6fcb09 | 597 | \membersection{wxSVGFileDC::SetPalette}\label{wxsvgfiledcsetpalette} |
164e084a CE |
598 | |
599 | \func{void}{SetPalette}{\param{const wxPalette\& }{palette}} | |
600 | ||
601 | Not implemented | |
602 | ||
0c6fcb09 | 603 | \membersection{wxSVGFileDC::SetBrush}\label{wxsvgfiledcsetbrush} |
164e084a CE |
604 | |
605 | \func{void}{SetBrush}{\param{const wxBrush\& }{brush}} | |
606 | ||
607 | Sets the current brush for the DC. | |
608 | ||
609 | If the argument is wxNullBrush, the current brush is selected out of the device | |
610 | context, and the original brush restored, allowing the current brush to | |
611 | be destroyed safely. | |
612 | ||
613 | See also \helpref{wxBrush}{wxbrush}. | |
614 | ||
615 | See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours | |
616 | when drawing into a monochrome bitmap. | |
617 | ||
0c6fcb09 | 618 | \membersection{wxSVGFileDC::SetFont}\label{wxsvgfiledcsetfont} |
164e084a CE |
619 | |
620 | \func{void}{SetFont}{\param{const wxFont\& }{font}} | |
621 | ||
622 | Sets the current font for the DC. It must be a valid font, in particular you | |
623 | should not pass {\tt wxNullFont} to this method. | |
624 | ||
625 | See also \helpref{wxFont}{wxfont}. | |
626 | ||
0c6fcb09 | 627 | \membersection{wxSVGFileDC::SetLogicalFunction}\label{wxsvgfiledcsetlogicalfunction} |
164e084a CE |
628 | |
629 | \func{void}{SetLogicalFunction}{\param{int}{ function}} | |
630 | ||
631 | ||
632 | Only wxCOPY is avalaible; trying to set one of the othe values will fail | |
633 | ||
0c6fcb09 | 634 | \membersection{wxSVGFileDC::SetMapMode}\label{wxsvgfiledcsetmapmode} |
164e084a CE |
635 | |
636 | \func{void}{SetMapMode}{\param{int}{ int}} | |
637 | ||
638 | The {\it mapping mode} of the device context defines the unit of | |
639 | measurement used to convert logical units to device units. Note that | |
640 | in X, text drawing isn't handled consistently with the mapping mode; a | |
641 | font is always specified in point size. However, setting the {\it | |
642 | user scale} (see \helpref{wxSVGFileDC::SetUserScale}{wxdcsetuserscale}) scales the text appropriately. In | |
643 | Windows, scaleable TrueType fonts are always used; in X, results depend | |
644 | on availability of fonts, but usually a reasonable match is found. | |
645 | ||
646 | Note that the coordinate origin should ideally be selectable, but for | |
647 | now is always at the top left of the screen/printer. | |
648 | ||
649 | Drawing to a Windows printer device context under UNIX | |
650 | uses the current mapping mode, but mapping mode is currently ignored for | |
651 | PostScript output. | |
652 | ||
653 | The mapping mode can be one of the following: | |
654 | ||
655 | \begin{twocollist}\itemsep=0pt | |
656 | \twocolitem{wxMM\_TWIPS}{Each logical unit is 1/20 of a point, or 1/1440 of | |
657 | an inch.} | |
658 | \twocolitem{wxMM\_POINTS}{Each logical unit is a point, or 1/72 of an inch.} | |
659 | \twocolitem{wxMM\_METRIC}{Each logical unit is 1 mm.} | |
660 | \twocolitem{wxMM\_LOMETRIC}{Each logical unit is 1/10 of a mm.} | |
661 | \twocolitem{wxMM\_TEXT}{Each logical unit is 1 pixel.} | |
662 | \end{twocollist} | |
663 | ||
0c6fcb09 | 664 | \membersection{wxSVGFileDC::SetPen}\label{wxsvgfiledcsetpen} |
164e084a CE |
665 | |
666 | \func{void}{SetPen}{\param{const wxPen\& }{pen}} | |
667 | ||
668 | Sets the current pen for the DC. | |
669 | ||
670 | If the argument is wxNullPen, the current pen is selected out of the device | |
671 | context, and the original pen restored. | |
672 | ||
673 | See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours | |
674 | when drawing into a monochrome bitmap. | |
675 | ||
0c6fcb09 | 676 | \membersection{wxSVGFileDC::SetTextBackground}\label{wxsvgfiledcsettextbackground} |
164e084a CE |
677 | |
678 | \func{void}{SetTextBackground}{\param{const wxColour\& }{colour}} | |
679 | ||
680 | Sets the current text background colour for the DC. | |
681 | ||
0c6fcb09 | 682 | \membersection{wxSVGFileDC::SetTextForeground}\label{wxsvgfiledcsettextforeground} |
164e084a CE |
683 | |
684 | \func{void}{SetTextForeground}{\param{const wxColour\& }{colour}} | |
685 | ||
686 | Sets the current text foreground colour for the DC. | |
687 | ||
688 | See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours | |
689 | when drawing into a monochrome bitmap. | |
690 | ||
0c6fcb09 | 691 | \membersection{wxSVGFileDC::SetUserScale}\label{wxsvgfiledcsetuserscale} |
164e084a CE |
692 | |
693 | \func{void}{SetUserScale}{\param{double}{ xScale}, \param{double}{ yScale}} | |
694 | ||
695 | Sets the user scaling factor, useful for applications which require | |
696 | `zooming'. | |
697 | ||
0c6fcb09 | 698 | \membersection{wxSVGFileDC::StartDoc}\label{wxsvgfiledcstartdoc} |
164e084a CE |
699 | |
700 | \func{bool}{StartDoc}{\param{const wxString\& }{message}} | |
701 | ||
702 | Does nothing | |
703 | ||
0c6fcb09 | 704 | \membersection{wxSVGFileDC::StartPage}\label{wxsvgfiledcstartpage} |
164e084a CE |
705 | |
706 | \func{bool}{StartPage}{\void} | |
707 | ||
708 | Does nothing |