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 [Center].
38
39 -autoimport string
40 Module to automatically import [""].
41
42 -autoplain
43 Enable automatic importing of plain [true].
44
45 -autorotate
46 Enable automatic PDF page rotation [false].
47
48 -batchMask
49 Mask fpu exceptions in batch mode [false].
50
51 -batchView
52 View output in batch mode [false].
53
54 -bw Convert all colors to black and white [false].
55
56 -cd directory
57 Set current directory; command-line only.
58
59 -c,-clearGUI
60 Clear GUI operations [false].
61
62 -cmyk Convert rgb colors to cmyk [false].
63
64 -compact
65 Conserve memory at the expense of speed [false].
66
67 -d,-debug
68 Enable debugging messages [false].
69
70 -x,-deconstruct X
71 Deconstruct into transparent objects magnified by X.
72
73 -divisor n
74 Free space divisor for garbage collection [2].
75
76 -globalwrite
77 Allow write to other directory; command-line only [false].
78
79 -gray Convert all colors to grayscale [false].
80
81 -h,-help
82 Show summary of options; command-line only.
83
84 -historylines n
85 Retain n lines of history [1000].
86
87 -i,-ignoreGUI
88 Ignore GUI operations [false].
89
90 -inlinetex
91 Generate inline tex code [false].
92
93 -interactiveMask
94 Mask fpu exceptions in interactive mode [true].
95
96 -interactiveView
97 View output in interactive mode [true].
98
99 -k,-keep
100 Keep intermediate files [false].
101
102 -keepaux
103 Keep intermediate LaTeX .aux files [false].
104
105 -l,-listvariables
106 List available global functions and variables [false].
107
108 -localhistory
109 Use a local interactive history file [false].
110
111 -m,-mask
112 Mask fpu exceptions; command-line only.
113
114 -multiline
115 Input code over multiple lines at the prompt [false].
116
117 -multipleView
118 View output from multiple batch-mode files [false].
119
120 -O,-offset pair
121 PostScript offset [(0,0)].
122
123 -f,-outformat format
124 Convert each output file to specified format.
125
126 -o,-outname name
127 Alternative output name for first file.
128
129 -p,-parseonly
130 Parse file [false].
131
132 -prompt string
133 Prompt ["> "].
134
135 -prompt2 string
136 Continuation prompt for multiline input [".."].
137
138 -q,-quiet
139 Suppress welcome message [false].
140
141 -rgb Convert cmyk colors to rgb [false].
142
143 -safe Disable system call; command-line only [true].
144
145 -scroll n
146 Scroll standard output n lines at a time [0].
147
148 -tabcompletion
149 Interactive prompt auto-completion [true].
150
151 -tex engine
152 TeX engine ("latex|pdflatex|tex|pdftex|none") ["latex"].
153
154 -s,-translate
155 Show translated virtual machine code [false].
156
157 -twice Run LaTeX twice (to resolve references) [false].
158
159 -unsafe
160 Enable system call (=> global); command-line only [false].
161
162 -u,-user string
163 General purpose user string [""].
164
165 -v,-verbose
166 Increase verbosity level [0].
167
168 -version
169 Show version; command-line only.
170
171 -wait Wait for child processes to finish before exiting [false].
172
173 -where Show where listed variables are declared [false].
174
175 -xformat format
176 GUI deconstruction format ["gif"].
177
178
180 Asymptote is documented fully in the asymptote Info page. The manual
181 can also be accessed in interactive mode with the "help" command.
182
183
185 Asymptote was written by Andy Hammerlindl, John Bowman, and Tom Prince.
186
187 This manual page was written by Hubert Chan for the Debian project (but
188 may be used by others).
189
190
191
192 1 Dec 2004 ASY(1)