1ASY(1) General Commands Manual ASY(1)
2
3
4
6 asy - Asymptote: a script-based vector graphics language
7
9 asy [options] [file ...]
10
12 Asymptote is a powerful descriptive vector graphics language for tech‐
13 nical drawings, inspired by MetaPost but with an improved C++-like syn‐
14 tax. Asymptote provides for figures the same high-quality level of
15 typesetting that LaTeX does for scientific text.
16
18 If no arguments are given, Asymptote runs in interactive mode.
19
20 If "-" is given as the file argument, Asymptote reads from standard in‐
21 put.
22
23 A summary of options is included below. The effect of most options can
24 be negated by prepending no to the option name. Default values for
25 most options may also be entered in the file .asy/config.asy in the
26 user's home directory using the long form:
27
28 import settings;
29 batchView=true;
30
31 For a complete description, see the Info files.
32
33 -V,-View
34 View output; command-line only.
35
36 -absolute
37 Use absolute WebGL dimensions [false].
38
39 -a,-align C|B|T|Z
40 Center, Bottom, Top, or Zero page alignment [C].
41
42 -aligndir pair
43 Directional page alignment (overrides align) [(0,0)].
44
45 -antialias n
46 Antialiasing width for rasterized output [2].
47
48 -auto3D
49 Automatically activate 3D scene [true].
50
51 -autobillboard
52 3D labels always face viewer by default [true].
53
54 -autoimport string
55 Module to automatically import.
56
57 -autoplain
58 Enable automatic importing of plain [true].
59
60 -autoplay
61 Autoplay 3D animations [false].
62
63 -autorotate
64 Enable automatic PDF page rotation [false].
65
66 -axes3 Show 3D axes in PDF output [true].
67
68 -batchMask
69 Mask fpu exceptions in batch mode [false].
70
71 -batchView
72 View output in batch mode [false].
73
74 -bw Convert all colors to black and white [false].
75
76 -cd directory
77 Set current directory; command-line only.
78
79 -cmyk Convert rgb colors to cmyk [false].
80
81 -c,-command string
82 Command to autoexecute.
83
84 -compact
85 Conserve memory at the expense of speed [false].
86
87 -compress
88 Compress images in PDF output [true].
89
90 -d,-debug
91 Enable debugging messages [false].
92
93 -devicepixelratio n
94 Ratio of physical to logical pixels [1].
95
96 -digits n
97 Default output file precision [7].
98
99 -divisor n
100 Garbage collect using purge(divisor=n) [2].
101
102 -embed Embed rendered preview image [true].
103
104 -envmap
105 Enable environment map image-based lighting (Experimental)
106 [false].
107
108 -exitonEOF
109 Exit interactive mode on EOF [true].
110
111 -fitscreen
112 Fit rendered image to screen [true].
113
114 -framedelay ms
115 Additional frame delay [0].
116
117 -framerate frames/s
118 Animation speed [30].
119
120 -globalread
121 Allow read from other directory [true].
122
123 -globalwrite
124 Allow write to other directory [false].
125
126 -gray Convert all colors to grayscale [false].
127
128 -h,-help
129 Show summary of options; command-line only.
130
131 -historylines n
132 Retain n lines of history [1000].
133
134 -iconify
135 Iconify rendering window [false].
136
137 -inlineimage
138 Generate inline embedded image [false].
139
140 -inlinetex
141 Generate inline TeX code [false].
142
143 -interactiveMask
144 Mask fpu exceptions in interactive mode [true].
145
146 -interactiveView
147 View output in interactive mode [true].
148
149 -interactiveWrite
150 Write expressions entered at the prompt to stdout [true].
151
152 -k,-keep
153 Keep intermediate files [false].
154
155 -keepaux
156 Keep intermediate LaTeX .aux files [false].
157
158 -level n
159 Postscript level [3].
160
161 -l,-listvariables
162 List available global functions and variables [false].
163
164 -localhistory
165 Use a local interactive history file [false].
166
167 -loop Loop 3D animations [false].
168
169 -m,-mask
170 Mask fpu exceptions; command-line only.
171
172 -maxtile pair
173 Maximum rendering tile size [(1024,768)].
174
175 -maxviewport pair
176 Maximum viewport size [(0,0)].
177
178 -multiline
179 Input code over multiple lines at the prompt [false].
180
181 -multipleView
182 View output from multiple batch-mode files [false].
183
184 -multisample n
185 Multisampling width for screen images [4].
186
187 -offline
188 Produce offline html files [false].
189
190 -O,-offset pair
191 PostScript offset [(0,0)].
192
193 -f,-outformat format
194 Convert each output file to specified format.
195
196 -o,-outname name
197 Alternative output directory/filename.
198
199 -p,-parseonly
200 Parse file [false].
201
202 -pdfreload
203 Automatically reload document in pdfviewer [false].
204
205 -pdfreloaddelay usec
206 Delay before attempting initial pdf reload [750000].
207
208 -position pair
209 Initial 3D rendering screen position [(0,0)].
210
211 -prc Embed 3D PRC graphics in PDF output [true].
212
213 -prompt string
214 Prompt [> ].
215
216 -prompt2 string
217 Continuation prompt for multiline input [..].
218
219 -q,-quiet
220 Suppress welcome text and noninteractive stdout [false].
221
222 -render n
223 Render 3D graphics using n pixels per bp (-1=auto) [-1].
224
225 -resizestep step
226 Resize step [1.2].
227
228 -reverse
229 reverse 3D animations [false].
230
231 -rgb Convert cmyk colors to rgb [false].
232
233 -safe Disable system call [true].
234
235 -scroll n
236 Scroll standard output n lines at a time [0].
237
238 -shiftHoldDistance n
239 WebGL touch screen distance limit for shift mode [20].
240
241 -shiftWaitTime ms
242 WebGL touch screen shift mode delay [200].
243
244 -spinstep deg/s
245 Spin speed [60].
246
247 -svgemulation
248 Emulate unimplemented SVG shading [true].
249
250 -tabcompletion
251 Interactive prompt auto-completion [true].
252
253 -tex engine
254 latex|pdflatex|xelatex|lualatex|tex|pdftex|luatex|context|none
255 [latex].
256
257 -thick Render thick 3D lines [true].
258
259 -thin Render thin 3D lines [true].
260
261 -threads
262 Use POSIX threads for 3D rendering [true].
263
264 -toolbar
265 Show 3D toolbar in PDF output [true].
266
267 -s,-translate
268 Show translated virtual machine code [false].
269
270 -twice Run LaTeX twice (to resolve references) [false].
271
272 -twosided
273 Use two-sided 3D lighting model for rendering [true].
274
275 -u,-user string
276 General purpose user string.
277
278 -v,-verbose
279 Increase verbosity level (can specify multiple times) [0].
280
281 -version
282 Show version; command-line only.
283
284 -vibrateTime ms
285 WebGL shift mode vibrate duration [25].
286
287 -viewportmargin pair
288 Horizontal and vertical 3D viewport margin [(0.5,0.5)].
289
290 -wait Wait for child processes to finish before exiting [false].
291
292 -warn string
293 Enable warning; command-line only.
294
295 -where Show where listed variables are declared [false].
296
297 -xasy Special interactive mode for xasy [false].
298
299 -zoomPinchCap limit
300 WebGL maximum zoom pinch [100].
301
302 -zoomPinchFactor n
303 WebGL zoom pinch sensitivity [10].
304
305 -zoomfactor factor
306 Zoom step factor [1.05].
307
308 -zoomstep step
309 Mouse motion zoom step [0.1].
310
311
313 Asymptote is documented fully in the asymptote Info page. The manual
314 can also be accessed in interactive mode with the "help" command.
315
316
318 Asymptote was written by Andy Hammerlindl, John Bowman, and Tom Prince.
319
320 This manual page was written by Hubert Chan for the Debian project (but
321 may be used by others).
322
323
324
325 1 Dec 2004 ASY(1)