1ASY(1)                      General Commands Manual                     ASY(1)
2
3
4

NAME

6       asy - Asymptote: a script-based vector graphics language
7

SYNOPSIS

9       asy [options] [file ...]
10

DESCRIPTION

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

OPTIONS

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

SEE ALSO

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

AUTHOR

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)
Impressum