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
21 input.
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 -d,-debug
88 Enable debugging messages [false].
89
90 -devicepixelratio n
91 Ratio of physical to logical pixels [1].
92
93 -digits n
94 Default output file precision [7].
95
96 -divisor n
97 Garbage collect using purge(divisor=n) [2].
98
99 -embed Embed rendered preview image [true].
100
101 -envmap
102 Enable environment map image-based lighting (Experimental)
103 [false].
104
105 -exitonEOF
106 Exit interactive mode on EOF [true].
107
108 -fitscreen
109 Fit rendered image to screen [true].
110
111 -framedelay ms
112 Additional frame delay [0].
113
114 -framerate frames/s
115 Animation speed [30].
116
117 -globalread
118 Allow read from other directory [true].
119
120 -globalwrite
121 Allow write to other directory [false].
122
123 -gray Convert all colors to grayscale [false].
124
125 -h,-help
126 Show summary of options; command-line only.
127
128 -historylines n
129 Retain n lines of history [1000].
130
131 -iconify
132 Iconify rendering window [false].
133
134 -inlineimage
135 Generate inline embedded image [false].
136
137 -inlinetex
138 Generate inline TeX code [false].
139
140 -interactiveMask
141 Mask fpu exceptions in interactive mode [true].
142
143 -interactiveView
144 View output in interactive mode [true].
145
146 -interactiveWrite
147 Write expressions entered at the prompt to stdout [true].
148
149 -k,-keep
150 Keep intermediate files [false].
151
152 -keepaux
153 Keep intermediate LaTeX .aux files [false].
154
155 -level n
156 Postscript level [3].
157
158 -l,-listvariables
159 List available global functions and variables [false].
160
161 -localhistory
162 Use a local interactive history file [false].
163
164 -loop Loop 3D animations [false].
165
166 -m,-mask
167 Mask fpu exceptions; command-line only.
168
169 -maxtile pair
170 Maximum rendering tile size [(1024,768)].
171
172 -maxviewport pair
173 Maximum viewport size [(0,0)].
174
175 -multiline
176 Input code over multiple lines at the prompt [false].
177
178 -multipleView
179 View output from multiple batch-mode files [false].
180
181 -multisample n
182 Multisampling width for screen images [4].
183
184 -offline
185 Produce offline html files [false].
186
187 -O,-offset pair
188 PostScript offset [(0,0)].
189
190 -f,-outformat format
191 Convert each output file to specified format.
192
193 -o,-outname name
194 Alternative output directory/filename.
195
196 -p,-parseonly
197 Parse file [false].
198
199 -pdfreload
200 Automatically reload document in pdfviewer [false].
201
202 -pdfreloaddelay usec
203 Delay before attempting initial pdf reload [750000].
204
205 -position pair
206 Initial 3D rendering screen position [(0,0)].
207
208 -prc Embed 3D PRC graphics in PDF output [true].
209
210 -prompt string
211 Prompt [> ].
212
213 -prompt2 string
214 Continuation prompt for multiline input [..].
215
216 -q,-quiet
217 Suppress welcome text and noninteractive stdout [false].
218
219 -render n
220 Render 3D graphics using n pixels per bp (-1=auto) [-1].
221
222 -resizestep step
223 Resize step [1.2].
224
225 -reverse
226 reverse 3D animations [false].
227
228 -rgb Convert cmyk colors to rgb [false].
229
230 -safe Disable system call [true].
231
232 -scroll n
233 Scroll standard output n lines at a time [0].
234
235 -shiftHoldDistance n
236 WebGL touch screen distance limit for shift mode [20].
237
238 -shiftWaitTime ms
239 WebGL touch screen shift mode delay [200].
240
241 -spinstep deg/s
242 Spin speed [60].
243
244 -svgemulation
245 Emulate unimplemented SVG shading [true].
246
247 -tabcompletion
248 Interactive prompt auto-completion [true].
249
250 -tex engine
251 latex|pdflatex|xelatex|lualatex|tex|pdftex|luatex|context|none
252 [latex].
253
254 -thick Render thick 3D lines [true].
255
256 -thin Render thin 3D lines [true].
257
258 -threads
259 Use POSIX threads for 3D rendering [true].
260
261 -toolbar
262 Show 3D toolbar in PDF output [true].
263
264 -s,-translate
265 Show translated virtual machine code [false].
266
267 -twice Run LaTeX twice (to resolve references) [false].
268
269 -twosided
270 Use two-sided 3D lighting model for rendering [true].
271
272 -u,-user string
273 General purpose user string.
274
275 -v,-verbose
276 Increase verbosity level (can specify multiple times) [0].
277
278 -version
279 Show version; command-line only.
280
281 -vibrateTime ms
282 WebGL shift mode vibrate duration [25].
283
284 -viewportmargin pair
285 Horizontal and vertical 3D viewport margin [(0.5,0.5)].
286
287 -wait Wait for child processes to finish before exiting [false].
288
289 -warn string
290 Enable warning; command-line only.
291
292 -where Show where listed variables are declared [false].
293
294 -xasy Special interactive mode for xasy [false].
295
296 -zoomPinchCap limit
297 WebGL maximum zoom pinch [100].
298
299 -zoomPinchFactor n
300 WebGL zoom pinch sensitivity [10].
301
302 -zoomfactor factor
303 Zoom step factor [1.05].
304
305 -zoomstep step
306 Mouse motion zoom step [0.1].
307
308
310 Asymptote is documented fully in the asymptote Info page. The manual
311 can also be accessed in interactive mode with the "help" command.
312
313
315 Asymptote was written by Andy Hammerlindl, John Bowman, and Tom Prince.
316
317 This manual page was written by Hubert Chan for the Debian project (but
318 may be used by others).
319
320
321
322 1 Dec 2004 ASY(1)