]>
Commit | Line | Data |
---|---|---|
2e4b4ec5 CE |
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}% | |
164e084a CE |
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 | ||
8bdd5efa | 160 | \func{void}{DrawArc}{\param{wxCoord}{ x1}, \param{wxCoord}{ y1}, \param{wxCoord}{ x2}, \param{wxCoord}{ y2}, \param{wxCoord}{ xc}, \param{wxCoord}{ yc}} |
164e084a CE |
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 | ||
ea76a6a5 | 172 | Draw a bitmap on the device context at the specified point. If {\it transparent} is true and the bitmap has |
164e084a CE |
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 | ||
164e084a CE |
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 | ||
ea76a6a5 | 558 | Returns true if the DC is ok to use; False values arise from being unable to |
164e084a CE |
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 | ||
164e084a CE |
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 |