contrib/docs/latex/svg/dcsvg.tex

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