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