docs/latex/wx/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::GetPen}\label{wxdcgetpen}
 437
 438 \func{wxPen\&}{GetPen}{\void}
 439
 440 \constfunc{const wxPen\&}{GetPen}{\void}
 441
 442 Gets the current pen (see \helpref{wxSVGFileDC::SetPen}{wxdcsetpen}).
 443
 444 \membersection{wxSVGFileDC::GetPixel}\label{wxdcgetpixel}
 445
 446 \func{bool}{GetPixel}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxColour *}{colour}}
 447
 448 Not implemented
 449
 450 \membersection{wxSVGFileDC::GetSize}\label{wxdcgetsize}
 451
 452 \func{void}{GetSize}{\param{wxCoord *}{width}, \param{wxCoord *}{height}}
 453
 454
 455 For a Windows printer device context, this gets the horizontal and vertical
 456 resolution.
 457
 458 \membersection{wxSVGFileDC::GetTextBackground}\label{wxdcgettextbackground}
 459
 460 \func{wxColour\&}{GetTextBackground}{\void}
 461
 462 \constfunc{const wxColour\&}{GetTextBackground}{\void}
 463
 464 Gets the current text background colour (see \helpref{wxSVGFileDC::SetTextBackground}{wxdcsettextbackground}).
 465
 466 \membersection{wxSVGFileDC::GetTextExtent}\label{wxdcgettextextent}
 467
 468 \func{void}{GetTextExtent}{\param{const wxString\& }{string}, \param{wxCoord *}{w}, \param{wxCoord *}{h},\\
 469   \param{wxCoord *}{descent = NULL}, \param{wxCoord *}{externalLeading = NULL}, \param{wxFont *}{font = NULL}}
 470
 471 Gets the dimensions of the string using the currently selected font.
 472 \rtfsp{\it string} is the text string to measure, {\it w} and {\it h} are
 473 the total width and height respectively, {\it descent} is the
 474 dimension from the baseline of the font to the bottom of the
 475 descender, and {\it externalLeading} is any extra vertical space added
 476 to the font by the font designer (usually is zero).
 477
 478 The optional parameter {\it font} specifies an alternative
 479 to the currently selected font: but note that this does not
 480 yet work under Windows, so you need to set a font for
 481 the device context first.
 482
 483 See also \helpref{wxFont}{wxfont}, \helpref{wxSVGFileDC::SetFont}{wxdcsetfont}.
 484
 485 \membersection{wxSVGFileDC::GetTextForeground}\label{wxdcgettextforeground}
 486
 487 \func{wxColour\&}{GetTextForeground}{\void}
 488
 489 \constfunc{const wxColour\&}{GetTextForeground}{\void}
 490
 491 Gets the current text foreground colour (see \helpref{wxSVGFileDC::SetTextForeground}{wxdcsettextforeground}).
 492
 493
 494 \membersection{wxSVGFileDC::GetUserScale}\label{wxdcgetuserscale}
 495
 496 \func{void}{GetUserScale}{\param{double}{ *x}, \param{double}{ *y}}
 497
 498 Gets the current user scale factor (set by \helpref{SetUserScale}{wxdcsetuserscale}).
 499
 500 \membersection{wxSVGFileDC::LogicalToDeviceX}\label{wxdclogicaltodevicex}
 501
 502 \func{wxCoord}{LogicalToDeviceX}{\param{wxCoord}{ x}}
 503
 504 Converts logical X coordinate to device coordinate, using the current
 505 mapping mode.
 506
 507 \membersection{wxSVGFileDC::LogicalToDeviceXRel}\label{wxdclogicaltodevicexrel}
 508
 509 \func{wxCoord}{LogicalToDeviceXRel}{\param{wxCoord}{ x}}
 510
 511 Converts logical X coordinate to relative device coordinate, using the current
 512 mapping mode but ignoring the x axis orientation.
 513 Use this for converting a width, for example.
 514
 515 \membersection{wxSVGFileDC::LogicalToDeviceY}\label{wxdclogicaltodevicey}
 516
 517 \func{wxCoord}{LogicalToDeviceY}{\param{wxCoord}{ y}}
 518
 519 Converts logical Y coordinate to device coordinate, using the current
 520 mapping mode.
 521
 522 \membersection{wxSVGFileDC::LogicalToDeviceYRel}\label{wxdclogicaltodeviceyrel}
 523
 524 \func{wxCoord}{LogicalToDeviceYRel}{\param{wxCoord}{ y}}
 525
 526 Converts logical Y coordinate to relative device coordinate, using the current
 527 mapping mode but ignoring the y axis orientation.
 528 Use this for converting a height, for example.
 529
 530 \membersection{wxSVGFileDC::MaxX}\label{wxdcmaxx}
 531
 532 \func{wxCoord}{MaxX}{\void}
 533
 534 Gets the maximum horizontal extent used in drawing commands so far.
 535
 536 \membersection{wxSVGFileDC::MaxY}\label{wxdcmaxy}
 537
 538 \func{wxCoord}{MaxY}{\void}
 539
 540 Gets the maximum vertical extent used in drawing commands so far.
 541
 542 \membersection{wxSVGFileDC::MinX}\label{wxdcminx}
 543
 544 \func{wxCoord}{MinX}{\void}
 545
 546 Gets the minimum horizontal extent used in drawing commands so far.
 547
 548 \membersection{wxSVGFileDC::MinY}\label{wxdcminy}
 549
 550 \func{wxCoord}{MinY}{\void}
 551
 552 Gets the minimum vertical extent used in drawing commands so far.
 553
 554 \membersection{wxSVGFileDC::Ok}\label{wxdcok}
 555
 556 \func{bool}{Ok}{\void}
 557
 558 Returns true if the DC is ok to use; False values arise from being unable to
 559 write the file
 560
 561 \membersection{wxSVGFileDC::ResetBoundingBox}\label{wxdcresetboundingbox}
 562
 563 \func{void}{ResetBoundingBox}{\void}
 564
 565 Resets the bounding box: after a call to this function, the bounding box
 566 doesn't contain anything.
 567
 568 \wxheading{See also}
 569
 570 \helpref{CalcBoundingBox}{wxdccalcboundingbox}
 571
 572 \membersection{wxSVGFileDC::SetAxisOrientation}\label{wxdcsetaxisorientation}
 573
 574 \func{void}{SetAxisOrientation}{\param{bool}{ xLeftRight},
 575                                 \param{bool}{ yBottomUp}}
 576
 577 Sets the x and y axis orientation (i.e., the direction from lowest to
 578 highest values on the axis). The default orientation is the natural
 579 orientation, e.g. x axis from left to right and y axis from bottom up.
 580
 581 \wxheading{Parameters}
 582
 583 \docparam{xLeftRight}{True to set the x axis orientation to the natural
 584 left to right orientation, false to invert it.}
 585
 586 \docparam{yBottomUp}{True to set the y axis orientation to the natural
 587 bottom up orientation, false to invert it.}
 588
 589 \membersection{wxSVGFileDC::SetDeviceOrigin}\label{wxdcsetdeviceorigin}
 590
 591 \func{void}{SetDeviceOrigin}{\param{wxCoord}{ x}, \param{wxCoord}{ y}}
 592
 593 Sets the device origin (i.e., the origin in pixels after scaling has been
 594 applied).
 595
 596 This function may be useful in Windows printing
 597 operations for placing a graphic on a page.
 598
 599 \membersection{wxSVGFileDC::SetBackground}\label{wxdcsetbackground}
 600
 601 \func{void}{SetBackground}{\param{const wxBrush\& }{brush}}
 602
 603 Sets the current background brush for the DC.
 604
 605 \membersection{wxSVGFileDC::SetBackgroundMode}\label{wxdcsetbackgroundmode}
 606
 607 \func{void}{SetBackgroundMode}{\param{int}{ mode}}
 608
 609 {\it mode} may be one of wxSOLID and wxTRANSPARENT. This setting determines
 610 whether text will be drawn with a background colour or not.
 611
 612 \membersection{wxSVGFileDC::SetClippingRegion}\label{wxdcsetclippingregion}
 613
 614 \func{void}{SetClippingRegion}{\param{wxCoord}{ x}, \param{wxCoord}{ y}, \param{wxCoord}{ width}, \param{wxCoord}{ height}}
 615
 616 \func{void}{SetClippingRegion}{\param{const wxPoint\& }{pt}, \param{const wxSize\& }{sz}}
 617
 618 \func{void}{SetClippingRegion}{\param{const wxRect\&}{ rect}}
 619
 620 \func{void}{SetClippingRegion}{\param{const wxRegion\&}{ region}}
 621
 622 Not implemented
 623
 624
 625 \membersection{wxSVGFileDC::SetPalette}\label{wxdcsetpalette}
 626
 627 \func{void}{SetPalette}{\param{const wxPalette\& }{palette}}
 628
 629 Not implemented
 630
 631 \membersection{wxSVGFileDC::SetBrush}\label{wxdcsetbrush}
 632
 633 \func{void}{SetBrush}{\param{const wxBrush\& }{brush}}
 634
 635 Sets the current brush for the DC.
 636
 637 If the argument is wxNullBrush, the current brush is selected out of the device
 638 context, and the original brush restored, allowing the current brush to
 639 be destroyed safely.
 640
 641 See also \helpref{wxBrush}{wxbrush}.
 642
 643 See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours
 644 when drawing into a monochrome bitmap.
 645
 646 \membersection{wxSVGFileDC::SetFont}\label{wxdcsetfont}
 647
 648 \func{void}{SetFont}{\param{const wxFont\& }{font}}
 649
 650 Sets the current font for the DC. It must be a valid font, in particular you
 651 should not pass {\tt wxNullFont} to this method.
 652
 653 See also \helpref{wxFont}{wxfont}.
 654
 655 \membersection{wxSVGFileDC::SetLogicalFunction}\label{wxdcsetlogicalfunction}
 656
 657 \func{void}{SetLogicalFunction}{\param{int}{ function}}
 658
 659
 660 Only wxCOPY is avalaible; trying to set one of the othe values will fail
 661
 662 \membersection{wxSVGFileDC::SetMapMode}\label{wxdcsetmapmode}
 663
 664 \func{void}{SetMapMode}{\param{int}{ int}}
 665
 666 The {\it mapping mode} of the device context defines the unit of
 667 measurement used to convert logical units to device units. Note that
 668 in X, text drawing isn't handled consistently with the mapping mode; a
 669 font is always specified in point size. However, setting the {\it
 670 user scale} (see \helpref{wxSVGFileDC::SetUserScale}{wxdcsetuserscale}) scales the text appropriately. In
 671 Windows, scaleable TrueType fonts are always used; in X, results depend
 672 on availability of fonts, but usually a reasonable match is found.
 673
 674 Note that the coordinate origin should ideally be selectable, but for
 675 now is always at the top left of the screen/printer.
 676
 677 Drawing to a Windows printer device context under UNIX
 678 uses the current mapping mode, but mapping mode is currently ignored for
 679 PostScript output.
 680
 681 The mapping mode can be one of the following:
 682
 683 \begin{twocollist}\itemsep=0pt
 684 \twocolitem{wxMM\_TWIPS}{Each logical unit is 1/20 of a point, or 1/1440 of
 685   an inch.}
 686 \twocolitem{wxMM\_POINTS}{Each logical unit is a point, or 1/72 of an inch.}
 687 \twocolitem{wxMM\_METRIC}{Each logical unit is 1 mm.}
 688 \twocolitem{wxMM\_LOMETRIC}{Each logical unit is 1/10 of a mm.}
 689 \twocolitem{wxMM\_TEXT}{Each logical unit is 1 pixel.}
 690 \end{twocollist}
 691
 692 \membersection{wxSVGFileDC::SetPen}\label{wxdcsetpen}
 693
 694 \func{void}{SetPen}{\param{const wxPen\& }{pen}}
 695
 696 Sets the current pen for the DC.
 697
 698 If the argument is wxNullPen, the current pen is selected out of the device
 699 context, and the original pen restored.
 700
 701 See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours
 702 when drawing into a monochrome bitmap.
 703
 704 \membersection{wxSVGFileDC::SetTextBackground}\label{wxdcsettextbackground}
 705
 706 \func{void}{SetTextBackground}{\param{const wxColour\& }{colour}}
 707
 708 Sets the current text background colour for the DC.
 709
 710 \membersection{wxSVGFileDC::SetTextForeground}\label{wxdcsettextforeground}
 711
 712 \func{void}{SetTextForeground}{\param{const wxColour\& }{colour}}
 713
 714 Sets the current text foreground colour for the DC.
 715
 716 See also \helpref{wxMemoryDC}{wxmemorydc} for the interpretation of colours
 717 when drawing into a monochrome bitmap.
 718
 719 \membersection{wxSVGFileDC::SetUserScale}\label{wxdcsetuserscale}
 720
 721 \func{void}{SetUserScale}{\param{double}{ xScale}, \param{double}{ yScale}}
 722
 723 Sets the user scaling factor, useful for applications which require
 724 `zooming'.
 725
 726 \membersection{wxSVGFileDC::StartDoc}\label{wxdcstartdoc}
 727
 728 \func{bool}{StartDoc}{\param{const wxString\& }{message}}
 729
 730 Does nothing
 731
 732 \membersection{wxSVGFileDC::StartPage}\label{wxdcstartpage}
 733
 734 \func{bool}{StartPage}{\void}
 735
 736 Does nothing