]> git.saurik.com Git - wxWidgets.git/blame - docs/latex/wx/dcsvg.tex
Moved desktop margin options to a more sensible place
[wxWidgets.git] / docs / latex / wx / dcsvg.tex
CommitLineData
0c6fcb09 1\section{\class{wxSVGFileDC}}\label{wxsvgfiledc}
164e084a
CE
2
3A wxSVGFileDC is a {\it device context} onto which graphics and text can be drawn, and the output
4produced as a vector file, in the SVG format (see http://www.w3.org/TR/2001/REC-SVG-20010904/ ).
5This format can be read by a range of programs, including a Netscape plugin (Adobe), full details at
6http://www.w3.org/Graphics/SVG/SVG-Implementations.htm8 Vector formats may often be smaller
7than raster formats.
8
9The intention behind wxSVGFileDC is that it can be used to produce a file corresponding
10to the screen display context, wxSVGFileDC, by passing the wxSVGFileDC as a parameter instead of a wxSVGFileDC. Thus
11the wxSVGFileDC is a write-only class.
12
13As the wxSVGFileDC is a vector format, raster operations like GetPixel are unlikely to be supported.
14However, the SVG specification allows for PNG format raster files to be embedded in the SVG, and so
15bitmaps, icons and blit operations into the wxSVGFileDC are supported.
16
17A more substantial SVG library (for reading and writing) is available at
ebdbecff 18http://wxart2d.sourceforge.net/
164e084a
CE
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
47Constructors:
48a filename {\it f} with default size 340x240 at 72.0 dots per inch (a frequent screen resolution).
49a filename {\it f} with size {\it Width} by {\it Height} at 72.0 dots per inch
50a 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
56Destructor.
57
0c6fcb09 58\membersection{wxSVGFileDC::BeginDrawing}\label{wxsvgfiledcbegindrawing}
164e084a
CE
59
60Does 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
68As wxDC: Copy from a source DC to this DC, specifying the destination
69coordinates, size of area to copy, source DC, source coordinates,
70logical 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
76Adds 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
85This 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
92Not Implemented
93
0c6fcb09 94\membersection{wxSVGFileDC::DestroyClippingRegion}\label{wxsvgfiledcdestroyclippingregion}
164e084a
CE
95
96\func{void}{DestroyClippingRegion}{\void}
97
98Not Implemented
99
0c6fcb09 100\membersection{wxSVGFileDC::DeviceToLogicalX}\label{wxsvgfiledcdevicetologicalx}
164e084a
CE
101
102\func{wxCoord}{DeviceToLogicalX}{\param{wxCoord}{ x}}
103
104Convert device X coordinate to logical coordinate, using the current
105mapping mode.
106
0c6fcb09 107\membersection{wxSVGFileDC::DeviceToLogicalXRel}\label{wxsvgfiledcdevicetologicalxrel}
164e084a
CE
108
109\func{wxCoord}{DeviceToLogicalXRel}{\param{wxCoord}{ x}}
110
111Convert device X coordinate to relative logical coordinate, using the current
112mapping mode but ignoring the x axis orientation.
113Use 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
119Converts device Y coordinate to logical coordinate, using the current
120mapping mode.
121
0c6fcb09 122\membersection{wxSVGFileDC::DeviceToLogicalYRel}\label{wxsvgfiledcdevicetologicalyrel}
164e084a
CE
123
124\func{wxCoord}{DeviceToLogicalYRel}{\param{wxCoord}{ y}}
125
126Convert device Y coordinate to relative logical coordinate, using the current
127mapping mode but ignoring the y axis orientation.
128Use 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
134Draws an arc of a circle, centred on ({\it xc, yc}), with starting point ({\it x1, y1})
135and ending at ({\it x2, y2}). The current pen is used for the outline
136and the current brush for filling the shape.
137
138The 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 144Draw a bitmap on the device context at the specified point. If {\it transparent} is true and the bitmap has
164e084a
CE
145a transparency mask, the bitmap will be drawn transparently.
146
147When drawing a mono-bitmap, the current text foreground colour will be used to draw the foreground
148of 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
158Draws 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
166Draws 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
180Draws an ellipse contained in the rectangle specified either with the given top
181left corner and the given size or directly. The current pen is used for the
182outline 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
193Draws an arc of an ellipse. The current pen is used for drawing the arc and
194the 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
197the ellipse.
198
199{\it width} and {\it height} specify the width and height of the rectangle that contains
200the ellipse.
201
202{\it start} and {\it end} specify the start and end of the arc relative to the three-o'clock
203position from the center of the rectangle. Angles are specified
204in degrees (360 is a complete circle). Positive values mean
205counter-clockwise motion. If {\it start} is equal to {\it end}, a
206complete 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
212Draw an icon on the display (does nothing if the device context is PostScript).
213This 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
219Draws a line from the first point to the second. The current pen is used
220for 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
228Draws lines using an array of {\it points} of size {\it n}, or list of
229pointers to points, adding the optional offset coordinate. The current
230pen is used for drawing the lines. The programmer is responsible for
231deleting 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
241Draws a filled polygon using an array of {\it points} of size {\it n},
242or list of pointers to points, adding the optional offset coordinate.
243
244The last argument specifies the fill rule: {\bf wxODDEVEN\_RULE} (the
245default) or {\bf wxWINDING\_RULE}.
246
247The current pen is used for drawing the outline, and the current brush
248for filling the shape. Using a transparent brush suppresses filling.
249The programmer is responsible for deleting the list of points.
250
251Note 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
258Draws 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
264Draws a rectangle with the given top left corner, and with the given
265size. The current pen is used for the outline and the current brush
266for 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
272Draws the text rotated by {\it angle} degrees.
273
274The 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
280Draws a rectangle with the given top left corner, and with the given
281size. The corners are quarter-circles using the given radius. The
282current pen is used for the outline and the current brush for filling
283the shape.
284
285If {\it radius} is positive, the value is assumed to be the
286radius of the rounded corner. If {\it radius} is negative,
287the absolute value is assumed to be the {\it proportion} of the smallest
288dimension of the rectangle. This means that the corner can be
289a sensible size relative to the size of the rectangle, and also avoids
290the strange effects X produces when the corners are too big for
291the rectangle.
292
0c6fcb09 293\membersection{wxSVGFileDC::DrawSpline}\label{wxsvgfiledcdrawspline}
164e084a
CE
294
295\func{void}{DrawSpline}{\param{wxList *}{points}}
296
297Draws a spline between all given control points, using the current
298pen. Doesn't delete the wxList and contents. The spline is drawn
299using a series of lines, using an algorithm taken from the X drawing
300program `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
304Draws 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
310Draws a text string at the specified point, using the current text font,
311and the current text foreground and background colours.
312
313The coordinates refer to the top-left corner of the rectangle bounding
314the string. See \helpref{wxSVGFileDC::GetTextExtent}{wxdcgettextextent} for how
315to get the dimensions of a text string, which can be used to position the
316text more precisely.
317
318
319
0c6fcb09 320\membersection{wxSVGFileDC::EndDoc}\label{wxsvgfiledcenddoc}
164e084a
CE
321
322\func{void}{EndDoc}{\void}
323
324Does nothing
325
0c6fcb09 326\membersection{wxSVGFileDC::EndDrawing}\label{wxsvgfiledcenddrawing}
164e084a
CE
327
328\func{void}{EndDrawing}{\void}
329
330Does nothing
331
0c6fcb09 332\membersection{wxSVGFileDC::EndPage}\label{wxsvgfiledcendpage}
164e084a
CE
333
334\func{void}{EndPage}{\void}
335
336Does 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
342Not 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
350Gets 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
356Returns 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
368Gets 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
374Gets 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
380Gets 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
386Not 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
394Gets 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
400Gets 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
406Gets 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
414Gets 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
420Not implemented
421
0c6fcb09 422\membersection{wxSVGFileDC::GetSize}\label{wxsvgfiledcgetsize}
164e084a
CE
423
424\func{void}{GetSize}{\param{wxCoord *}{width}, \param{wxCoord *}{height}}
425
426
427For a Windows printer device context, this gets the horizontal and vertical
428resolution.
429
0c6fcb09 430\membersection{wxSVGFileDC::GetTextBackground}\label{wxsvgfiledcgettextbackground}
164e084a
CE
431
432\func{wxColour\&}{GetTextBackground}{\void}
433
434\constfunc{const wxColour\&}{GetTextBackground}{\void}
435
436Gets 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
443Gets 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
445the total width and height respectively, {\it descent} is the
446dimension from the baseline of the font to the bottom of the
447descender, and {\it externalLeading} is any extra vertical space added
448to the font by the font designer (usually is zero).
449
450The optional parameter {\it font} specifies an alternative
451to the currently selected font: but note that this does not
452yet work under Windows, so you need to set a font for
453the device context first.
454
455See 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
463Gets 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
470Gets 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
476Converts logical X coordinate to device coordinate, using the current
477mapping mode.
478
0c6fcb09 479\membersection{wxSVGFileDC::LogicalToDeviceXRel}\label{wxsvgfiledclogicaltodevicexrel}
164e084a
CE
480
481\func{wxCoord}{LogicalToDeviceXRel}{\param{wxCoord}{ x}}
482
483Converts logical X coordinate to relative device coordinate, using the current
484mapping mode but ignoring the x axis orientation.
485Use 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
491Converts logical Y coordinate to device coordinate, using the current
492mapping mode.
493
0c6fcb09 494\membersection{wxSVGFileDC::LogicalToDeviceYRel}\label{wxsvgfiledclogicaltodeviceyrel}
164e084a
CE
495
496\func{wxCoord}{LogicalToDeviceYRel}{\param{wxCoord}{ y}}
497
498Converts logical Y coordinate to relative device coordinate, using the current
499mapping mode but ignoring the y axis orientation.
500Use this for converting a height, for example.
501
0c6fcb09 502\membersection{wxSVGFileDC::MaxX}\label{wxsvgfiledcmaxx}
164e084a
CE
503
504\func{wxCoord}{MaxX}{\void}
505
506Gets 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
512Gets 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
518Gets 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
524Gets 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 530Returns true if the DC is ok to use; False values arise from being unable to
164e084a
CE
531write the file
532
0c6fcb09 533\membersection{wxSVGFileDC::ResetBoundingBox}\label{wxsvgfiledcresetboundingbox}
164e084a
CE
534
535\func{void}{ResetBoundingBox}{\void}
536
537Resets the bounding box: after a call to this function, the bounding box
538doesn'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
549Sets the x and y axis orientation (i.e., the direction from lowest to
550highest values on the axis). The default orientation is the natural
551orientation, 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
556left to right orientation, false to invert it.}
557
558\docparam{yBottomUp}{True to set the y axis orientation to the natural
559bottom 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
565Sets the device origin (i.e., the origin in pixels after scaling has been
566applied).
567
568This function may be useful in Windows printing
569operations 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
575Sets 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
582whether 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
594Not implemented
595
596
0c6fcb09 597\membersection{wxSVGFileDC::SetPalette}\label{wxsvgfiledcsetpalette}
164e084a
CE
598
599\func{void}{SetPalette}{\param{const wxPalette\& }{palette}}
600
601Not implemented
602
0c6fcb09 603\membersection{wxSVGFileDC::SetBrush}\label{wxsvgfiledcsetbrush}
164e084a
CE
604
605\func{void}{SetBrush}{\param{const wxBrush\& }{brush}}
606
607Sets the current brush for the DC.
608
609If the argument is wxNullBrush, the current brush is selected out of the device
610context, and the original brush restored, allowing the current brush to
611be destroyed safely.
612
613See also \helpref{wxBrush}{wxbrush}.
614
615See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours
616when 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
622Sets the current font for the DC. It must be a valid font, in particular you
623should not pass {\tt wxNullFont} to this method.
624
625See also \helpref{wxFont}{wxfont}.
626
0c6fcb09 627\membersection{wxSVGFileDC::SetLogicalFunction}\label{wxsvgfiledcsetlogicalfunction}
164e084a
CE
628
629\func{void}{SetLogicalFunction}{\param{int}{ function}}
630
631
632Only 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
638The {\it mapping mode} of the device context defines the unit of
639measurement used to convert logical units to device units. Note that
640in X, text drawing isn't handled consistently with the mapping mode; a
641font is always specified in point size. However, setting the {\it
642user scale} (see \helpref{wxSVGFileDC::SetUserScale}{wxdcsetuserscale}) scales the text appropriately. In
643Windows, scaleable TrueType fonts are always used; in X, results depend
644on availability of fonts, but usually a reasonable match is found.
645
646Note that the coordinate origin should ideally be selectable, but for
647now is always at the top left of the screen/printer.
648
649Drawing to a Windows printer device context under UNIX
650uses the current mapping mode, but mapping mode is currently ignored for
651PostScript output.
652
653The 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
668Sets the current pen for the DC.
669
670If the argument is wxNullPen, the current pen is selected out of the device
671context, and the original pen restored.
672
673See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours
674when 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
680Sets 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
686Sets the current text foreground colour for the DC.
687
688See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours
689when 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
695Sets 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
702Does nothing
703
0c6fcb09 704\membersection{wxSVGFileDC::StartPage}\label{wxsvgfiledcstartpage}
164e084a
CE
705
706\func{bool}{StartPage}{\void}
707
708Does nothing