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 -absolute
37 Use absolute WebGL dimensions [false].
38 -a,-align C|B|T|Z
40 Center, Bottom, Top, or Zero page alignment [C].
41 -aligndir pair
43 Directional page alignment (overrides align) [(0,0)].
44 -antialias n
46 Antialiasing width for rasterized output [2].
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 -devicepixelratio n
91 Ratio of physical to logical pixels [1].
92 -digits n
94 Default output file precision [7].
95 -divisor n
97 Garbage collect using purge(divisor=n) [2].
98 -embed Embed rendered preview image [true].
100 -envmap
102 Enable environment map image-based lighting (Experimental)
103 [false].
104 -exitonEOF
106 Exit interactive mode on EOF [true].
107 -fitscreen
109 Fit rendered image to screen [true].
110 -framedelay ms
112 Additional frame delay [0].
113 -framerate frames/s
115 Animation speed [30].
116 -globalread
118 Allow read from other directory [true].
119 -globalwrite
121 Allow write to other directory [false].
122 -gray Convert all colors to grayscale [false].
124 -h,-help
126 Show summary of options; command-line only.
127 -historylines n
129 Retain n lines of history [1000].
130 -iconify
132 Iconify rendering window [false].
133 -inlineimage
135 Generate inline embedded image [false].
136 -inlinetex
138 Generate inline TeX code [false].
139 -interactiveMask
141 Mask fpu exceptions in interactive mode [true].
142 -interactiveView
144 View output in interactive mode [true].
145 -interactiveWrite
147 Write expressions entered at the prompt to stdout [true].
148 -k,-keep
150 Keep intermediate files [false].
151 -keepaux
153 Keep intermediate LaTeX .aux files [false].
154 -level n
156 Postscript level [3].
157 -l,-listvariables
159 List available global functions and variables [false].
160 -localhistory
162 Use a local interactive history file [false].
163 -loop Loop 3D animations [false].
165 -m,-mask
167 Mask fpu exceptions; command-line only.
168 -maxtile pair
170 Maximum rendering tile size [(1024,768)].
171 -maxviewport pair
173 Maximum viewport size [(0,0)].
174 -multiline
176 Input code over multiple lines at the prompt [false].
177 -multipleView
179 View output from multiple batch-mode files [false].
180 -multisample n
182 Multisampling width for screen images [4].
183 -offline
185 Produce offline html files [false].
186 -O,-offset pair
188 PostScript offset [(0,0)].
189 -f,-outformat format
191 Convert each output file to specified format.
192 -o,-outname name
194 Alternative output directory/filename.
195 -p,-parseonly
197 Parse file [false].
198 -pdfreload
200 Automatically reload document in pdfviewer [false].
201 -pdfreloaddelay usec
203 Delay before attempting initial pdf reload [750000].
204 -position pair
206 Initial 3D rendering screen position [(0,0)].
207 -prc Embed 3D PRC graphics in PDF output [true].
209 -prompt string
211 Prompt [> ].
212 -prompt2 string
214 Continuation prompt for multiline input [..].
215 -q,-quiet
217 Suppress welcome text and noninteractive stdout [false].
218 -render n
220 Render 3D graphics using n pixels per bp (-1=auto) [-1].
221 -resizestep step
223 Resize step [1.2].
224 -reverse
226 reverse 3D animations [false].
227 -rgb Convert cmyk colors to rgb [false].
229 -safe Disable system call [true].
231 -scroll n
233 Scroll standard output n lines at a time [0].
234 -shiftHoldDistance n
236 WebGL touch screen distance limit for shift mode [20].
237 -shiftWaitTime ms
239 WebGL touch screen shift mode delay [200].
240 -spinstep deg/s
242 Spin speed [60].
243 -svgemulation
245 Emulate unimplemented SVG shading [true].
246 -tabcompletion
248 Interactive prompt auto-completion [true].
249 -tex engine
251 latex|pdflatex|xelatex|lualatex|tex|pdftex|luatex|context|none
252 [latex].
253 -thick Render thick 3D lines [true].
255 -thin Render thin 3D lines [true].
257 -threads
259 Use POSIX threads for 3D rendering [true].
260 -toolbar
262 Show 3D toolbar in PDF output [true].
263 -s,-translate
265 Show translated virtual machine code [false].
266 -twice Run LaTeX twice (to resolve references) [false].
268 -twosided
270 Use two-sided 3D lighting model for rendering [true].
271 -u,-user string
273 General purpose user string.
274 -v,-verbose
276 Increase verbosity level (can specify multiple times) [0].
277 -version
279 Show version; command-line only.
280 -vibrateTime ms
282 WebGL shift mode vibrate duration [25].
283 -viewportmargin pair
285 Horizontal and vertical 3D viewport margin [(0.5,0.5)].
286 -wait Wait for child processes to finish before exiting [false].
288 -warn string
290 Enable warning; command-line only.
291 -where Show where listed variables are declared [false].
293 -xasy Special interactive mode for xasy [false].
295 -zoomPinchCap limit
297 WebGL maximum zoom pinch [100].
298 -zoomPinchFactor n
300 WebGL zoom pinch sensitivity [10].
301 -zoomfactor factor
303 Zoom step factor [1.05].
304 -zoomstep step
306 Mouse motion zoom step [0.1].
307
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
315 Asymptote was written by Andy Hammerlindl, John Bowman, and Tom Prince.
316 This manual page was written by Hubert Chan for the Debian project (but
318 may be used by others).
319 1 Dec 2004 ASY(1)