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 -a,-align C|B|T|Z
37 Center, Bottom, Top, or Zero page alignment [C].
38
39 -antialias n
40 Antialiasing width for rasterized output [2].
41
42 -arcballradius pixels
43 Arcball radius [750].
44
45 -auto3D
46 Automatically activate 3D scene [true].
47
48 -autobillboard
49 3D labels always face viewer by default [true].
50
51 -autoimport string
52 Module to automatically import.
53
54 -autoplain
55 Enable automatic importing of plain [true].
56
57 -autoplay
58 Autoplay 3D animations [false].
59
60 -autorotate
61 Enable automatic PDF page rotation [false].
62
63 -batchMask
64 Mask fpu exceptions in batch mode [false].
65
66 -batchView
67 View output in batch mode [false].
68
69 -bw Convert all colors to black and white [false].
70
71 -cd directory
72 Set current directory; command-line only.
73
74 -cmyk Convert rgb colors to cmyk [false].
75
76 -c,-command string
77 Command to autoexecute.
78
79 -compact
80 Conserve memory at the expense of speed [false].
81
82 -d,-debug
83 Enable debugging messages [false].
84
85 -divisor n
86 Garbage collect using purge(divisor=n) [2].
87
88 -doubleclick ms
89 Emulated double-click timeout [200].
90
91 -embed Embed rendered preview image [true].
92
93 -exitonEOF
94 Exit interactive mode on EOF [true].
95
96 -fitscreen
97 Fit rendered image to screen [true].
98
99 -framedelay ms
100 Additional frame delay [0].
101
102 -framerate frames/s
103 Animation speed [30].
104
105 -globalwrite
106 Allow write to other directory [false].
107
108 -gray Convert all colors to grayscale [false].
109
110 -h,-help
111 Show summary of options; command-line only.
112
113 -historylines n
114 Retain n lines of history [1000].
115
116 -iconify
117 Iconify rendering window [false].
118
119 -inlineimage
120 Generate inline embedded image [false].
121
122 -inlinetex
123 Generate inline TeX code [false].
124
125 -interactiveMask
126 Mask fpu exceptions in interactive mode [true].
127
128 -interactiveView
129 View output in interactive mode [true].
130
131 -interactiveWrite
132 Write expressions entered at the prompt to stdout [true].
133
134 -k,-keep
135 Keep intermediate files [false].
136
137 -keepaux
138 Keep intermediate LaTeX .aux files [false].
139
140 -level n
141 Postscript level [3].
142
143 -l,-listvariables
144 List available global functions and variables [false].
145
146 -localhistory
147 Use a local interactive history file [false].
148
149 -loop Loop 3D animations [false].
150
151 -m,-mask
152 Mask fpu exceptions; command-line only.
153
154 -maxtile pair
155 Maximum rendering tile size [(0,0)].
156
157 -maxviewport pair
158 Maximum viewport size [(2048,2048)].
159
160 -multiline
161 Input code over multiple lines at the prompt [false].
162
163 -multipleView
164 View output from multiple batch-mode files [false].
165
166 -multisample n
167 Multisampling width for screen images [4].
168
169 -O,-offset pair
170 PostScript offset [(0,0)].
171
172 -f,-outformat format
173 Convert each output file to specified format.
174
175 -o,-outname name
176 Alternative output directory/filename.
177
178 -p,-parseonly
179 Parse file [false].
180
181 -pdfreload
182 Automatically reload document in pdfviewer [false].
183
184 -pdfreloaddelay usec
185 Delay before attempting initial pdf reload [750000].
186
187 -position pair
188 Initial 3D rendering screen position [(0,0)].
189
190 -prc Embed 3D PRC graphics in PDF output [true].
191
192 -prompt string
193 Prompt [> ].
194
195 -prompt2 string
196 Continuation prompt for multiline input [..].
197
198 -q,-quiet
199 Suppress welcome message [false].
200
201 -render n
202 Render 3D graphics using n pixels per bp (-1=auto) [-1].
203
204 -resizestep step
205 Resize step [1.2].
206
207 -reverse
208 reverse 3D animations [false].
209
210 -rgb Convert cmyk colors to rgb [false].
211
212 -safe Disable system call [true].
213
214 -scroll n
215 Scroll standard output n lines at a time [0].
216
217 -spinstep deg/s
218 Spin speed [60].
219
220 -svgemulation
221 Emulate unimplemented SVG shading [false].
222
223 -tabcompletion
224 Interactive prompt auto-completion [true].
225
226 -tex engine
227 latex|pdflatex|xelatex|tex|pdftex|context|none [latex].
228
229 -thick Render thick 3D lines [true].
230
231 -thin Render thin 3D lines [true].
232
233 -threads
234 Use POSIX threads for 3D rendering [true].
235
236 -toolbar
237 Show 3D toolbar in PDF output [true].
238
239 -s,-translate
240 Show translated virtual machine code [false].
241
242 -twice Run LaTeX twice (to resolve references) [false].
243
244 -twosided
245 Use two-sided 3D lighting model for rendering [true].
246
247 -u,-user string
248 General purpose user string.
249
250 -v,-verbose
251 Increase verbosity level (can specify multiple times) [0].
252
253 -version
254 Show version; command-line only.
255
256 -wait Wait for child processes to finish before exiting [false].
257
258 -warn string
259 Enable warning; command-line only.
260
261 -where Show where listed variables are declared [false].
262
263 -zoomfactor factor
264 Zoom step factor [1.05].
265
266 -zoomstep step
267 Mouse motion zoom step [0.1].
268
269
271 Asymptote is documented fully in the asymptote Info page. The manual
272 can also be accessed in interactive mode with the "help" command.
273
274
276 Asymptote was written by Andy Hammerlindl, John Bowman, and Tom Prince.
277
278 This manual page was written by Hubert Chan for the Debian project (but
279 may be used by others).
280
281
282
283 1 Dec 2004 ASY(1)