Mercurial > octave
comparison scripts/plot/util/print.m @ 26102:15ebd65f18c9
print.m: Rewrite complex docstring in an attempt to be clearer.
* print.m: Rewrite complex docstring in an attempt to be clearer.
author | Rik <rik@octave.org> |
---|---|
date | Tue, 20 Nov 2018 14:06:40 -0800 |
parents | 4407b315339d |
children | 9cfbe7688368 |
comparison
equal
deleted
inserted
replaced
26101:9e5caa6acb00 | 26102:15ebd65f18c9 |
---|---|
18 | 18 |
19 ## -*- texinfo -*- | 19 ## -*- texinfo -*- |
20 ## @deftypefn {} {} print () | 20 ## @deftypefn {} {} print () |
21 ## @deftypefnx {} {} print (@var{options}) | 21 ## @deftypefnx {} {} print (@var{options}) |
22 ## @deftypefnx {} {} print (@var{filename}, @var{options}) | 22 ## @deftypefnx {} {} print (@var{filename}, @var{options}) |
23 ## @deftypefnx {} {} print (@var{h}, @var{filename}, @var{options}) | 23 ## @deftypefnx {} {} print (@var{hfig}, @dots{}) |
24 ## @deftypefnx {} {@var{rgb} =} print (@var{-RGBImage}, @dots{}) | 24 ## @deftypefnx {} {@var{rgb} =} print (@qcode{"-RGBImage"}, @dots{}) |
25 ## Format a figure for printing and send it to a printer, save it to a file, or | 25 ## Format a figure for printing and either save it to a file, send it to a |
26 ## return an RGB image. | 26 ## printer, or return an RGB image. |
27 ## | 27 ## |
28 ## @var{filename} defines the name of the output file. If the filename has | 28 ## @var{filename} defines the name of the output file. If the filename has |
29 ## no suffix, one is inferred from the specified device and appended to the | 29 ## no suffix then one is inferred from the specified device and appended to the |
30 ## filename. In the absence of a filename or @qcode{"-RGBImage"} option, the | 30 ## filename. When neither a filename nor the @qcode{"-RGBImage"} option is |
31 ## output is sent to the printer. The filename and options may be given in | 31 ## present, the output is sent to the printer. The various options and |
32 ## any order. | 32 ## filename arguments may be given in any order, except for the figure handle |
33 ## | 33 ## argument @var{hfig} which must be first if it is present. |
34 ## Example: Print to a file using the PDF and JPEG formats. | 34 ## |
35 ## Example: Print to a file using PDF and JPEG formats. | |
35 ## | 36 ## |
36 ## @example | 37 ## @example |
37 ## @group | 38 ## @group |
38 ## figure (1); | 39 ## figure (1); |
39 ## clf (); | 40 ## clf (); |
41 ## print figure1.pdf # The extension specifies the format | 42 ## print figure1.pdf # The extension specifies the format |
42 ## print -djpg figure1 # Will produce "figure1.jpg" file | 43 ## print -djpg figure1 # Will produce "figure1.jpg" file |
43 ## @end group | 44 ## @end group |
44 ## @end example | 45 ## @end example |
45 ## | 46 ## |
46 ## If the first argument @var{h} is a handle to a figure object, it specifies | 47 ## If the first argument is a handle @var{hfig} to a figure object then it |
47 ## the figure to print. By default, the current figure is printed. | 48 ## specifies the figure to print. By default, the current figure returned |
48 ## | 49 ## by @code{gcf} is printed. |
49 ## For outputs to paged formats, PostScript and PDF, the paper size is | 50 ## |
50 ## specified by the figure's @code{papersize} property. The location and | 51 ## For outputs to paged formats, for example, PostScript and PDF, the page size |
51 ## size of the image on the page are specified by the figure's | 52 ## is specified by the figure's @code{papersize} property together with the |
52 ## @code{paperposition} property. The orientation of the page is specified | 53 ## @code{paperunits} property. The location and size of the plot on the page |
53 ## by the figure's @code{paperorientation} property. | 54 ## are specified by the figure's @code{paperposition} property. The |
54 ## | 55 ## orientation of the page is specified by the figure's @code{paperorientation} |
55 ## The width and height of images are specified by the figure's | 56 ## property. |
56 ## @code{paperposition(3:4)} property values. | 57 ## |
58 ## For non-page formats---for example, image formats like JPEG---the width and | |
59 ## height of the output are specified by the figure's @code{paperposition(3:4)} | |
60 ## property values. | |
57 ## | 61 ## |
58 ## The @code{print} command supports many @var{options}: | 62 ## The @code{print} command supports many @var{options}: |
59 ## | 63 ## |
60 ## @table @code | 64 ## @table @code |
61 ## @item -f@var{h} | 65 ## @item -f@var{h} |
62 ## Specify the handle, @var{h}, of the figure to be printed. The default | 66 ## Specify the handle, @var{h}, of the figure to be printed. |
63 ## is the current figure. | |
64 ## | 67 ## |
65 ## Example: Print figure 1. | 68 ## Example: Print figure 1. |
66 ## | 69 ## |
67 ## @example | 70 ## @example |
68 ## @group | 71 ## @group |
90 ## @end group | 93 ## @end group |
91 ## @end example | 94 ## @end example |
92 ## | 95 ## |
93 ## @item -RGBImage | 96 ## @item -RGBImage |
94 ## Return an M-by-N-by-3 RGB image of the figure. The size of the image | 97 ## Return an M-by-N-by-3 RGB image of the figure. The size of the image |
95 ## depends on the formatting options. | 98 ## depends on the formatting options. This is similar to taking a screen |
99 ## capture of the plot, but formatting options may be changed such as the | |
100 ## resolution or monochrome/color. | |
96 ## | 101 ## |
97 ## Example: Get the pixels of a figure image. | 102 ## Example: Get the pixels of a figure image. |
98 ## | 103 ## |
99 ## @example | 104 ## @example |
100 ## @group | 105 ## @group |
101 ## clf (); | 106 ## clf (); |
102 ## surf (peaks); | 107 ## surf (peaks); |
103 ## rgb = print ("-RGBImage"); | 108 ## @var{rgb} = print ("-RGBImage"); |
104 ## @end group | 109 ## @end group |
105 ## @end example | 110 ## @end example |
111 ## | |
112 ## @item -opengl | |
113 ## @itemx -painters | |
114 ## Specifies whether the opengl (pixel-based) or painters (vector-based) | |
115 ## renderer is used. This is equivalent to changing the figure's | |
116 ## @qcode{"Renderer"} property. When the figure @code{RendererMode} property | |
117 ## is @qcode{"auto"} Octave will use the @qcode{"opengl"} renderer for raster | |
118 ## formats (e.g., JPEG) and @qcode{"painters"} for vector formats (e.g., PDF). | |
119 ## | |
120 ## @item -svgconvert | |
121 ## For OpenGL-based graphic toolkits, this enables a different backend | |
122 ## toolchain with enhanced characteristics. The toolchain adds support for | |
123 ## printing arbitrary characters and fonts in PDF outputs; it avoids some | |
124 ## anti-aliasing artifacts in the rendering of patch and surface objects | |
125 ## (particularly for 2-D scenes); and it supports transparency of line, patch, | |
126 ## and surface objects. | |
127 ## | |
128 ## This option only affects PDF outputs, unless it is combined with | |
129 ## @option{-painters} option, in which case raster outputs are also affected. | |
130 ## | |
131 ## Caution: @option{-svgconvert} may lead to inaccurate rendering of image | |
132 ## objects. | |
106 ## | 133 ## |
107 ## @item -portrait | 134 ## @item -portrait |
108 ## @itemx -landscape | 135 ## @itemx -landscape |
109 ## Specify the orientation of the plot for printed output. | 136 ## Specify the orientation of the plot for printed output. |
110 ## For non-printed output the aspect ratio of the output corresponds to the | 137 ## For non-printed output the aspect ratio of the output corresponds to the |
111 ## plot area defined by the @qcode{"paperposition"} property in the | 138 ## plot area defined by the @qcode{"paperposition"} property in the |
112 ## orientation specified. This option is equivalent to changing the figure's | 139 ## orientation specified. This option is equivalent to changing the figure's |
113 ## @qcode{"paperorientation"} property. | 140 ## @qcode{"paperorientation"} property. |
114 ## | 141 ## |
115 ## @item -append | 142 ## @item -color |
116 ## Append PostScript or PDF output to a pre-existing file of the same type. | 143 ## @itemx -mono |
144 ## Color or monochrome output. | |
145 ## | |
146 ## @item -solid | |
147 ## @itemx -dashed | |
148 ## Force all lines to be solid or dashed, respectively. | |
117 ## | 149 ## |
118 ## @item -r@var{NUM} | 150 ## @item -r@var{NUM} |
119 ## Resolution of bitmaps in pixels per inch. For both metafiles and SVG | 151 ## Resolution of bitmaps in dots per inch (DPI). For both metafiles and SVG |
120 ## the default is the screen resolution; for other formats it is 150 dpi. To | 152 ## the default is the screen resolution; for other formats the default is 150 |
121 ## specify screen resolution, use @qcode{"-r0"}. | 153 ## DPI@. To specify screen resolution, use @qcode{"-r0"}. |
122 ## | 154 ## |
123 ## Example: Get high resolution raster output. | 155 ## Example: high resolution raster output. |
124 ## | 156 ## |
125 ## @example | 157 ## @example |
126 ## @group | 158 ## @group |
127 ## clf (); | 159 ## clf (); |
128 ## surf (peaks (), "facelighting", "gouraud"); | 160 ## surf (peaks (), "facelighting", "gouraud"); |
130 ## print ("-r600", "lit_peaks.png"); | 162 ## print ("-r600", "lit_peaks.png"); |
131 ## @end group | 163 ## @end group |
132 ## @end example | 164 ## @end example |
133 ## | 165 ## |
134 ## @item -S@var{xsize},@var{ysize} | 166 ## @item -S@var{xsize},@var{ysize} |
135 ## Plot size in pixels for EMF, GIF, JPEG, PBM, PNG, and SVG@. | 167 ## Plot size in pixels for raster formats including PNG, JPEG, PNG, and |
136 ## For PS, EPS, PDF, and other vector formats the plot size is in points. | 168 ## (unusually (SVG))@. For all vector formats, including PDF, PS, and EPS, the |
137 ## This option is equivalent to changing the size of the plot box associated | 169 ## plot size is specified in points. This option is equivalent to changing the |
138 ## with the @qcode{"paperposition"} property. When using the command form of | 170 ## width and height of the output by setting the figure property |
139 ## the print function you must quote the @var{xsize},@var{ysize} option. For | 171 ## @code{paperposition(3:4)}. When using the command form of the print |
140 ## example, by writing @w{"-S640,480"}. | 172 ## function you must quote the @var{xsize},@var{ysize} option to prevent the |
141 ## | 173 ## Octave interpreter from recognizing the embedded comma (','). For example, |
142 ## @item -painters | 174 ## by writing @w{"-S640,480"}. |
143 ## @itemx -opengl | |
144 ## For raster formats, specifies which of the opengl (pixel based) or | |
145 ## painters (vector based) renderers is used. This is equivalent to changing | |
146 ## the figure's "renderer" property. By default the renderer is "opengl" for | |
147 ## raster formats and "painters" for vector formats. | |
148 ## | 175 ## |
149 ## @item -loose | 176 ## @item -loose |
150 ## @itemx -tight | 177 ## @itemx -tight |
151 ## Force a tight or loose bounding box for EPS files. The default is loose. | 178 ## Force a tight or loose bounding box for EPS files. The default is loose. |
152 ## | 179 ## |
164 ## Provide a pict preview. | 191 ## Provide a pict preview. |
165 ## | 192 ## |
166 ## @item -tiff | 193 ## @item -tiff |
167 ## Provide a TIFF preview. | 194 ## Provide a TIFF preview. |
168 ## @end table | 195 ## @end table |
196 ## | |
197 ## @item -append | |
198 ## Append PostScript or PDF output to an existing file of the same type. | |
169 ## | 199 ## |
170 ## @item -F@var{fontname} | 200 ## @item -F@var{fontname} |
171 ## @itemx -F@var{fontname}:@var{size} | 201 ## @itemx -F@var{fontname}:@var{size} |
172 ## @itemx -F:@var{size} | 202 ## @itemx -F:@var{size} |
173 ## Use @var{fontname} and/or @var{fontsize} for all text. | 203 ## Use @var{fontname} and/or @var{fontsize} for all text. |
174 ## @var{fontname} is ignored for some devices: dxf, fig, hpgl, etc. | 204 ## @var{fontname} is ignored for some devices: dxf, fig, hpgl, etc. |
175 ## | 205 ## |
176 ## @item -color | |
177 ## @itemx -mono | |
178 ## Color or monochrome output. | |
179 ## | |
180 ## @item -solid | |
181 ## @itemx -dashed | |
182 ## Force all lines to be solid or dashed, respectively. | |
183 ## | |
184 ## @item -d@var{device} | 206 ## @item -d@var{device} |
185 ## The available output format is specified by the option @var{device}, and | 207 ## The available output format is specified by the option @var{device}, and |
186 ## is one of (devices marked with a "*" are only available with the Gnuplot | 208 ## is one of the following (devices marked with a "*" are only available with |
187 ## toolkit): | 209 ## the Gnuplot toolkit): |
210 ## | |
211 ## Vector Formats | |
188 ## | 212 ## |
189 ## @table @code | 213 ## @table @code |
214 ## @item pdf | |
215 ## @itemx pdfcrop | |
216 ## Portable Document Format. The @code{pdfcrop} device removes the default | |
217 ## surrounding page. | |
218 ## | |
219 ## The OpenGL-based graphics toolkits have limited support for text. | |
220 ## Limitations include using only ASCII characters (e.g., no Greek letters) | |
221 ## and support for just three base PostScript fonts: Helvetica (the default), | |
222 ## Times, or Courier. Any other font will be replaced by Helvetica. | |
223 ## | |
224 ## For an enhanced output with complete text support and basic transparency, | |
225 ## use the @option{-svgconvert} option. | |
226 ## | |
190 ## @item ps | 227 ## @item ps |
191 ## @itemx ps2 | 228 ## @itemx ps2 |
192 ## @itemx psc | 229 ## @itemx psc |
193 ## @itemx psc2 | 230 ## @itemx psc2 |
194 ## PostScript (level 1 and 2, mono and color). The OpenGL-based toolkits | 231 ## PostScript (level 1 and 2, mono and color). The OpenGL-based graphics |
195 ## always generate PostScript level 3.0 and have a limited support for text. | 232 ## toolkits always generate PostScript level 3.0 and have limited support for |
233 ## text. | |
196 ## | 234 ## |
197 ## @item eps | 235 ## @item eps |
198 ## @itemx eps2 | 236 ## @itemx eps2 |
199 ## @itemx epsc | 237 ## @itemx epsc |
200 ## @itemx epsc2 | 238 ## @itemx epsc2 |
201 ## Encapsulated PostScript (level 1 and 2, mono and color). The | 239 ## Encapsulated PostScript (level 1 and 2, mono and color). The |
202 ## OpenGL-based toolkits always generate PostScript level 3.0 and have a | 240 ## OpenGL-based toolkits always generate PostScript level 3.0 and have |
203 ## limited support for text. Only the set of ASCII characters may be used and | 241 ## limited support for text. |
204 ## the only supported fonts are the base PostScript fonts: Helvetica (the | |
205 ## default), Times, Courier and their variants (bold or italic). Any other | |
206 ## font will be replaced by Helvetica. | |
207 ## | 242 ## |
208 ## @item pslatex | 243 ## @item pslatex |
209 ## @itemx epslatex | 244 ## @itemx epslatex |
210 ## @itemx pdflatex | 245 ## @itemx pdflatex |
211 ## @itemx pslatexstandalone | 246 ## @itemx pslatexstandalone |
222 ## automatically included when the @LaTeX{} file is processed. The text that | 257 ## automatically included when the @LaTeX{} file is processed. The text that |
223 ## is written to the @LaTeX{} file contains the strings @strong{exactly} as | 258 ## is written to the @LaTeX{} file contains the strings @strong{exactly} as |
224 ## they were specified in the plot. If any special characters of the @TeX{} | 259 ## they were specified in the plot. If any special characters of the @TeX{} |
225 ## mode interpreter were used, the file must be edited before @LaTeX{} | 260 ## mode interpreter were used, the file must be edited before @LaTeX{} |
226 ## processing. Specifically, the special characters must be enclosed with | 261 ## processing. Specifically, the special characters must be enclosed with |
227 ## dollar signs (@code{$ @dots{} $}), and other characters that are recognized | 262 ## dollar signs @w{(@code{$ @dots{} $})}, and other characters that are |
228 ## by @LaTeX{} may also need editing (e.g., braces). The @samp{pdflatex} | 263 ## recognized by @LaTeX{} may also need editing (e.g., braces). The |
229 ## device, and any of the @samp{standalone} formats, are not available with the | 264 ## @samp{pdflatex} device, and any of the @samp{standalone} formats, are not |
230 ## Gnuplot toolkit. | 265 ## available with the Gnuplot toolkit. |
231 ## | 266 ## |
232 ## @item epscairo* | 267 ## @item epscairo* |
233 ## @itemx pdfcairo* | 268 ## @itemx pdfcairo* |
234 ## @itemx epscairolatex* | 269 ## @itemx epscairolatex* |
235 ## @itemx pdfcairolatex* | 270 ## @itemx pdfcairolatex* |
236 ## @itemx epscairolatexstandalone* | 271 ## @itemx epscairolatexstandalone* |
237 ## @itemx pdfcairolatexstandalone* | 272 ## @itemx pdfcairolatexstandalone* |
238 ## Generate Cairo based output. The @samp{epscairo} and @samp{pdfcairo} | 273 ## Generate output with Cairo renderer. The devices @samp{epscairo} and |
239 ## devices are synonymous with the @samp{epsc} device. The @LaTeX{} variants | 274 ## @samp{pdfcairo} are synonymous with the @samp{epsc} device. The @LaTeX{} |
240 ## generate a @LaTeX{} file, @file{@var{filename}.tex}, for the text portions | 275 ## variants generate a @LaTeX{} file, @file{@var{filename}.tex}, for the text |
241 ## of a plot, and an image file, @file{@var{filename}.(eps|pdf)}, for the graph | 276 ## portions of a plot, and an image file, @file{@var{filename}.(eps|pdf)}, for |
242 ## portion of the plot. The @samp{standalone} variants behave as described for | 277 ## the graph portion of the plot. The @samp{standalone} variants behave as |
243 ## @samp{epslatexstandalone} above. | 278 ## described for @samp{epslatexstandalone} above. |
244 ## | 279 ## |
245 ## @item ill | 280 ## @item svg |
246 ## @itemx @nospell{aifm} | 281 ## Scalable Vector Graphics |
247 ## Adobe Illustrator (obsolete for Gnuplot versions > 4.2) | |
248 ## | 282 ## |
249 ## @item canvas* | 283 ## @item canvas* |
250 ## Javascript-based drawing on HTML5 canvas viewable in a web browser. | 284 ## Javascript-based drawing on an HTML5 canvas viewable in a web browser. |
251 ## | 285 ## |
252 ## @item cdr* | 286 ## @item cdr* |
253 ## @itemx @nospell{corel*} | 287 ## @itemx @nospell{corel*} |
254 ## CorelDraw | 288 ## CorelDraw |
255 ## | 289 ## |
256 ## @item cgm | 290 ## @item cgm* |
257 ## Computer Graphics Metafile, Version 1, ANSI X3.122-1986 | 291 ## Computer Graphics Metafile, Version 1, ANSI X3.122-1986 |
258 ## (only available for the Gnuplot graphics toolkit). | |
259 ## | 292 ## |
260 ## @item dxf | 293 ## @item dxf |
261 ## AutoCAD | 294 ## AutoCAD |
262 ## | 295 ## |
263 ## @item emf | 296 ## @item emf |
268 ## XFig. For the Gnuplot graphics toolkit, the additional options | 301 ## XFig. For the Gnuplot graphics toolkit, the additional options |
269 ## @option{-textspecial} or @option{-textnormal} can be used to control | 302 ## @option{-textspecial} or @option{-textnormal} can be used to control |
270 ## whether the special flag should be set for the text in the figure. | 303 ## whether the special flag should be set for the text in the figure. |
271 ## (default is @option{-textnormal}) | 304 ## (default is @option{-textnormal}) |
272 ## | 305 ## |
273 ## @item gif* | |
274 ## GIF image | |
275 ## | |
276 ## @item hpgl | 306 ## @item hpgl |
277 ## HP plotter language | 307 ## HP plotter language |
278 ## | 308 ## |
279 ## @item jpg | 309 ## @item ill |
280 ## @itemx jpeg | 310 ## @itemx @nospell{aifm} |
281 ## JPEG image | 311 ## Adobe Illustrator (obsolete for Gnuplot versions > 4.2) |
282 ## | 312 ## |
283 ## @item latex* | 313 ## @item latex* |
284 ## @itemx eepic* | 314 ## @itemx eepic* |
285 ## @LaTeX{} picture environment and extended picture environment. | 315 ## @LaTeX{} picture environment and extended picture environment. |
286 ## | 316 ## |
287 ## @item mf | 317 ## @item mf* |
288 ## Metafont | 318 ## Metafont |
289 ## | |
290 ## @item png | |
291 ## Portable Network Graphics | |
292 ## | |
293 ## @item pbm | |
294 ## PBMplus | |
295 ## | |
296 ## @item pdf | |
297 ## @itemx pdfcrop | |
298 ## Portable Document Format. The @code{pdfcrop} device removes the default | |
299 ## surrounding page. | |
300 ## | |
301 ## By default PDF output has limited support for text and doesn't support | |
302 ## transparency at all. For complete text support and basic transparency, use | |
303 ## the @option{-svgconvert} option. | |
304 ## | |
305 ## @item svg | |
306 ## Scalable Vector Graphics | |
307 ## | |
308 ## @item tif | |
309 ## @itemx tiff | |
310 ## @itemx tiffn | |
311 ## TIFF image with LZW compression (@nospell{tif}, tiff) or uncompressed | |
312 ## (@nospell{tiffn}). | |
313 ## | 319 ## |
314 ## @item tikz | 320 ## @item tikz |
315 ## @itemx tikzstandalone* | 321 ## @itemx tikzstandalone* |
316 ## Generate a @LaTeX{} file using PGF/TikZ format. The OpenGL-based | 322 ## Generate a @LaTeX{} file using PGF/TikZ format. The OpenGL-based |
317 ## toolkits create a PGF file while Gnuplot creates a TikZ file. The | 323 ## toolkits create a PGF file while Gnuplot creates a TikZ file. The |
318 ## @samp{tikzstandalone} device produces a @LaTeX{} document which includes the | 324 ## @samp{tikzstandalone} device produces a @LaTeX{} document which includes the |
319 ## TikZ file. | 325 ## TikZ file. |
326 ## | |
327 ## | |
320 ## @end table | 328 ## @end table |
321 ## | 329 ## |
330 ## Raster Formats | |
331 ## | |
332 ## @table @code | |
333 ## @item png | |
334 ## Portable Network Graphics | |
335 ## | |
336 ## @item jpg | |
337 ## @itemx jpeg | |
338 ## JPEG image | |
339 ## | |
340 ## @item tif | |
341 ## @itemx tiff | |
342 ## @itemx tiffn | |
343 ## TIFF image with LZW compression (@nospell{tif}, tiff) or uncompressed | |
344 ## (@nospell{tiffn}). | |
345 ## | |
346 ## @item gif | |
347 ## GIF image | |
348 ## | |
349 ## @item pbm | |
350 ## PBMplus | |
351 ## | |
352 ## @end table | |
353 ## | |
322 ## If the device is omitted, it is inferred from the file extension, | 354 ## If the device is omitted, it is inferred from the file extension, |
323 ## or if there is no filename it is sent to the printer as PostScript. | 355 ## or if there is no filename then it is sent to the printer as PostScript. |
324 ## | 356 ## |
325 ## @item -d@var{ghostscript_device} | 357 ## @item -d@var{ghostscript_device} |
326 ## Additional devices are supported by Ghostscript. | 358 ## Additional devices are supported by Ghostscript. |
327 ## Some examples are; | 359 ## Some examples are: |
328 ## | 360 ## |
329 ## @table @code | 361 ## @table @code |
330 ## @item ljet2p | 362 ## @item ljet2p |
331 ## HP LaserJet @nospell{IIP} | 363 ## HP LaserJet @nospell{IIP} |
332 ## | 364 ## |
335 ## | 367 ## |
336 ## @item ppm | 368 ## @item ppm |
337 ## Portable Pixel Map file format | 369 ## Portable Pixel Map file format |
338 ## @end table | 370 ## @end table |
339 ## | 371 ## |
340 ## For a complete list, type @code{system ("gs -h")} to see what formats | 372 ## For a complete list of available formats and devices type |
341 ## and devices are available. | 373 ## @code{system ("gs -h")}. |
342 ## | 374 ## |
343 ## When Ghostscript output is sent to a printer the size is determined by | 375 ## When Ghostscript output is sent to a printer the size is determined by |
344 ## the figure's @qcode{"papersize"} property. When the output is sent to a | 376 ## the figure's @qcode{"papersize"} property. When the output is sent to a |
345 ## file the size is determined by the plot box defined by the figure's | 377 ## file the size is determined by the plot box defined by the figure's |
346 ## @qcode{"paperposition"} property. | 378 ## @qcode{"paperposition"} property. |
347 ## | 379 ## |
348 ## @item -G@var{ghostscript_command} | 380 ## @item -G@var{ghostscript_command} |
349 ## Specify the command for calling Ghostscript. For Unix the default is | 381 ## Specify the command for calling Ghostscript. For Unix the default is |
350 ## @qcode{"gs"} and for Windows it is @qcode{"gswin32c"}. | 382 ## @qcode{"gs"} and for Windows it is @qcode{"gswin32c"}. |
351 ## | |
352 ## @item -svgconvert | |
353 ## For OpenGL based toolkits, this option adds support for printing | |
354 ## arbitrary characters and fonts in PDF outputs. It also avoids some | |
355 ## anti-aliasing artifacts in patch and surface objects rendering. Finally, it | |
356 ## adds support for printing transparent line, patch, and surface objects. | |
357 ## | |
358 ## This option only affects PDF outputs, unless it is combined with | |
359 ## @option{-painters} option, in which case raster outputs are also affected. | |
360 ## | |
361 ## Caution: @option{-svgconvert} may lead to innacurate rendering of image | |
362 ## objects. | |
363 ## | 383 ## |
364 ## @item -TextAlphaBits=@var{n} | 384 ## @item -TextAlphaBits=@var{n} |
365 ## @itemx -GraphicsAlphaBits=@var{n} | 385 ## @itemx -GraphicsAlphaBits=@var{n} |
366 ## Octave is able to produce output for various printers, bitmaps, and | 386 ## Octave is able to produce output for various printers, bitmaps, and |
367 ## vector formats by using Ghostscript. For bitmap and printer output | 387 ## vector formats by using Ghostscript. For bitmap and printer output |