diff options
author | Karl Berry <karl@freefriends.org> | 2009-07-08 01:04:31 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-07-08 01:04:31 +0000 |
commit | 17ee31b51081b8281b652fa06b997918003f7772 (patch) | |
tree | c5c1420540fe9a31454c1450ec5d96c096f91a9b /Build/source/utils/asymptote/doc/asymptote.texi | |
parent | bf914f81a2ff8552e1438251f4b6b56f9acf0b90 (diff) |
asymptote 1.80
git-svn-id: svn://tug.org/texlive/trunk@14179 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/utils/asymptote/doc/asymptote.texi')
-rw-r--r-- | Build/source/utils/asymptote/doc/asymptote.texi | 90 |
1 files changed, 70 insertions, 20 deletions
diff --git a/Build/source/utils/asymptote/doc/asymptote.texi b/Build/source/utils/asymptote/doc/asymptote.texi index 1e5443228b7..d4865930da7 100644 --- a/Build/source/utils/asymptote/doc/asymptote.texi +++ b/Build/source/utils/asymptote/doc/asymptote.texi @@ -357,9 +357,24 @@ A working @TeX{} implementation (such as the one available at @url{http://www.miktex.org}) will be required to typeset labels. You will also need to install @code{GPL Ghostscript} from @url{http://sourceforge.net/projects/ghostscript/}. + To view the default @code{PostScript} output, you can install the program @code{gsview} available from @url{http://www.cs.wisc.edu/~ghost/gsview/}. +@anchor{psview} +A better (and free) @code{PostScript} viewer available at +@url{http://psview.sourceforge.net/} (which in particular works properly +in interactive mode) unfortunately currently requires some manual +configuration. Specifically, if version @code{x.xx} of psview is +extracted to the directory @code{c:\Program Files\psview-x.xx} one +needs to put +@verbatim +import settings; +psviewer="c:\Program Files\psview-x.xx\psv.exe"; +@end verbatim +@noindent +in the optional @code{Asymptote} configuration file; +@pxref{configuration file}). The @code{ImageMagick} package from @@ -400,7 +415,8 @@ Users of @code{ggv} will need to enable @code{Watch file} under Users of @code{gsview} will need to enable @code{Options/Auto Redisplay} (however, under @code{MSDOS} it is still necessary to click on the @code{gsview} window; under @code{UNIX} one must manually redisplay by -pressing the @code{r} key). +pressing the @code{r} key). A better (and free) multiplatform +alternative to @code{gsview} is psview (@pxref{psview}). @cindex @code{settings} @cindex configuration file @@ -485,6 +501,15 @@ animate @end verbatim @noindent +Warnings (such as "writeoverloaded") may be enabled or disabled with +the functions +@verbatim +warn(string s); +nowarn(string s); +@end verbatim +@noindent +or by directly modifying the string array @code{warnings}. + @cindex command-line options Configuration variables may also be set or overwritten with a command-line option: @@ -3634,23 +3659,35 @@ write(fout,"List: ",1,2,3); // Writes "List: 1 2 3" @cindex @code{binput} @cindex @code{boutput} @cindex @code{single} -@cindex @code{double} +@cindex double precision +@cindex @code{signed} A file may also be opened with @code{xinput} or @code{xoutput}, instead of @code{input} or @code{output}, to read or write -double precision (64-bit) real values and single precision (32-bit) -integer values in Sun Microsystem's @acronym{XDR} (External +double precision (64-bit) reals and single precision (32-bit) +integers in Sun Microsystem's @acronym{XDR} (External Data Representation) portable binary format (available on all @code{UNIX} platforms). -A file may also be opened with @code{binput} or @code{boutput} to read -or write double precision values in the native (nonportable) -machine binary format. The function @code{file single(file,0.0)} may -be used to set a file to read single precision real @acronym{XDR} or binary -values; calling @code{file single(file,0.0,false)} sets it back to read -doubles again. The functions @code{file single(file,0)} and -@code{file single(file,0,false)} can be used to change the default -integer precision (single). The functions @code{file -single(file)} and @code{file single(file,false)} may be used to set the -precision for both real and integer values. +Alternatively, a file may also be opened with @code{binput} or +@code{boutput} to read or write double precision reals and single +precision integers in the native (nonportable) machine binary format. +The function +@code{file single(file f, bool real=true, bool int=true)} may +be used to change the precision of real and integer I/O +operations, respectively, for an @acronym{XDR} or binary file @code{f}. +Similarly, the function @code{file signed(file f, bool b=true)} +can be used to modify the signedness of integer reads and writes for +an @acronym{XDR} or binary file @code{f}. +Note that @code{single}, and @code{signed} modify and return their +file arguments (to facilitate nested function calls). + +@cindex @code{name} +@cindex @code{mode} +@cindex @code{singlereal} +@cindex @code{singleint} +@cindex @code{signed} +The virtual members @code{name}, @code{mode}, @code{singlereal}, +@code{singleint}, and @code{signed} may be used to query the +respective parameters for a given file. @cindex @code{eof} @cindex @code{eol} @@ -5325,6 +5362,18 @@ One, two, and three-dimensional arrays of the basic data types can be output with the functions @code{write(file,T[])}, @code{write(file,T[][])}, @code{write(file,T[][][])}, respectively. +@cindex @code{dimension} +@cindex @code{line} +@cindex @code{csv} +@cindex @code{word} +@cindex @code{single} +@cindex @code{signed} +Note that @code{dimension}, @code{line}, @code{csv}, +@code{word}, @code{single}, and @code{signed} modify and return their +file arguments (to facilitate nested function calls). +The virtual members @code{dimension}, @code{line}, @code{csv}, and +@code{word} may be used to query the respective parameters for a given file. + @node Slices @subsection Slices @cindex slices @@ -7475,7 +7524,7 @@ maximum screen dimension. The default settings import settings; leftbutton=new string[] {"rotate","zoom","shift","pan"}; middlebutton=new string[] {"menu"}; -rightbutton=new string[] {"zoom","rotateX","rotateY","rotateZ"}; +rightbutton=new string[] {"zoom/menu","rotateX","rotateY","rotateZ"}; wheelup=new string[] {"zoomin"}; wheeldown=new string[] {"zoomout"}; @end verbatim @@ -7485,10 +7534,10 @@ bind the mouse buttons as follows: @item Shift Left: zoom @item Ctrl Left: shift viewport @item Alt Left: pan -@item Middle: menu +@item Middle: menu (must be unmodified; ignores Shift, Ctrl, and Alt) @item Wheel Up: zoom in @item Wheel Down: zoom out -@item Right: zoom +@item Right: zoom/menu (must be unmodified) @item Right double click: menu @item Shift Right: rotate about the X axis @item Ctrl Right: rotate about the Y axis @@ -7537,8 +7586,8 @@ limited by the setting @code{maxviewport}, which restricts the maximum width and height of the viewport. On @code{UNIX} systems some graphics drivers support batch mode (@code{-noV}) rendering in an iconified window; this can be enabled with the setting @code{iconify=true}. -Other @code{UNIX} graphics drivers may require the command line setting -@code{-glOptions=-indirect}. +Some (broken) @code{UNIX} graphics drivers may require the command line setting +@code{-glOptions=-indirect}, which requests (slower) indirect rendering. @cindex @code{prc} @cindex @code{views} @@ -9259,4 +9308,5 @@ Melenchuk, Martin Wiebusch, and Stefan Knorr. @c LocalWords: addViews outprefix addAllViews xsplinetype ysplinetype rotateX @c LocalWords: usplinetype vsplinetype leftbutton middlebutton rightbutton @c LocalWords: rotateY rotateZ wheelup zoomin wheeldown zoomout TeXLive -@c LocalWords: viewportshift +@c LocalWords: viewportshift signedint signedness psview multiplatform +@c LocalWords: singlereal singleint |