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