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