summaryrefslogtreecommitdiff
path: root/Build/source/utils/asymptote/doc/png/asymptote.info
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-07-11 22:39:53 +0000
committerKarl Berry <karl@freefriends.org>2010-07-11 22:39:53 +0000
commit4e8485b0ddecb55f72929dd6233f254a1e7bf5b0 (patch)
tree354324ee6f54d46053b3ce88fe9dc4acf8e2ed81 /Build/source/utils/asymptote/doc/png/asymptote.info
parent713bb91ad0467fb3b12acad03cae2fa105ed2caa (diff)
asy 2.02
git-svn-id: svn://tug.org/texlive/trunk@19378 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/utils/asymptote/doc/png/asymptote.info')
-rw-r--r--Build/source/utils/asymptote/doc/png/asymptote.info441
1 files changed, 226 insertions, 215 deletions
diff --git a/Build/source/utils/asymptote/doc/png/asymptote.info b/Build/source/utils/asymptote/doc/png/asymptote.info
index af0f271a9d2..e72ff70242c 100644
--- a/Build/source/utils/asymptote/doc/png/asymptote.info
+++ b/Build/source/utils/asymptote/doc/png/asymptote.info
@@ -1,11 +1,11 @@
This is asymptote.info, produced by makeinfo version 4.13 from
../asymptote.texi.
-This file documents `Asymptote', version 2.01.
+This file documents `Asymptote', version 2.02.
`http://asymptote.sourceforge.net'
- Copyright (C) 2004-9 Andy Hammerlindl, John Bowman, and Tom Prince.
+ Copyright (C) 2004-10 Andy Hammerlindl, John Bowman, and Tom Prince.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Lesser General Public License
@@ -23,11 +23,11 @@ File: asymptote.info, Node: Top, Next: Description, Up: (dir)
Asymptote
*********
-This file documents `Asymptote', version 2.01.
+This file documents `Asymptote', version 2.02.
`http://asymptote.sourceforge.net'
- Copyright (C) 2004-9 Andy Hammerlindl, John Bowman, and Tom Prince.
+ Copyright (C) 2004-10 Andy Hammerlindl, John Bowman, and Tom Prince.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Lesser General Public License
@@ -499,7 +499,7 @@ used; if it is old we recommend first putting
in the `Asymptote' source directory.
If your graphics card supports multisampling, we recommend using version
-`2.6.0-rc1' (or later) of `freeglut' to support antialiasing in
+`2.6.0' (or later) of `freeglut' to support antialiasing in
`Asymptote''s adaptive `OpenGL' 3D renderer (`MacOS X' users can skip
this step since `Asymptote' is configured to use the native glut
library on that platform). Download
@@ -2325,7 +2325,7 @@ number, until it saturates with one or more color components equal to 1.
at the beginning of the file (this requires the `type1cm' package
available from
- `http://www.ctan.org/tex-archive/help/Catalogue/entries/type1cm'
+ `http://www.ctan.org/tex-archive/macros/latex/contrib/type1cm/'
and included in recent `LaTeX' distributions). The font size and
line skip of a pen can be examined with the routines `real
fontsize(pen p=currentpen)' and `real lineskip(pen p=currentpen)',
@@ -4642,60 +4642,66 @@ File: asymptote.info, Node: LaTeX usage, Next: Base modules, Prev: Programmin
***************
`Asymptote' comes with a convenient `LaTeX' style file `asymptote.sty'
-that makes `LaTeX' `Asymptote'-aware. Entering `Asymptote' code
-directly into the `LaTeX' source file, at the point where it is needed,
-keeps figures organized and avoids the need to invent new file names
-for each figure. Simply add the line `\usepackage{asymptote}' at the
-beginning of your file and enclose your `Asymptote' code within a
-`\begin{asy}...\end{asy}' environment. As with the `LaTeX' `comment'
-environment, the `\end{asy}' command must appear on a line by itself,
-with no leading spaces or trailing commands/comments.
+(version 1.15 or later) that makes `LaTeX' `Asymptote'-aware. Entering
+`Asymptote' code directly into the `LaTeX' source file, at the point
+where it is needed, keeps figures organized and avoids the need to
+invent new file names for each figure. Simply add the line
+`\usepackage{asymptote}' at the beginning of your file and enclose your
+`Asymptote' code within a `\begin{asy}...\end{asy}' environment. As
+with the `LaTeX' `comment' environment, the `\end{asy}' command must
+appear on a line by itself, with no leading spaces or trailing
+commands/comments.
The sample `LaTeX' file below, named `latexusage.tex', can be run as
follows:
latex latexusage
-asy latexusage
+asy latexusage-*.asy
latex latexusage
or
pdflatex latexusage
-asy latexusage
+asy latexusage-*.asy
pdflatex latexusage
+ To switch between using `latex' and `pdflatex' you may first need to
+remove the files `latexusage-*', `latexusage.pre', and `latexusage.aux'.
- To switch between using `latex' and `pdflatex' you may first need to
-remove the files `latexusage-*', `latexusage_.pre', and
-`latexusage.aux'. Version 1.13 of `Asymptote.sty' supports processing
-each figure separately: `asy latexusage' is equivalent to `asy
-latexusage-*.asy'. For example, one may wish to reduce memory usage by
-generating each figure in a separate `UNIX' process:
-/bin/ls latexusage-*.asy | xargs --replace=% asy %
+ An even better method for processing a `LaTeX' file with embedded
+`Asymptote' code is to use the `latexmk' utility from
+
+ `http://www.ctan.org/tex-archive/support/latexmk/'
+ after putting the rules
+
+sub asy {return system("asy '$_[0]'");}
+add_cus_dep("asy","eps",0,"asy");
+add_cus_dep("asy","pdf",0,"asy");
+add_cus_dep("asy","tex",0,"asy");
+in a file `latexmkrc' in the same directory. The command
+latexmk -pdf latexusage
+ will then call `Asymptote' automatically, recompiling only the figures
+that have changed. Since each figure is compiled in a separate system
+process, this method also tends to use less memory.
One can specify `width', `height', `viewportwidth',
-`viewportheight', and `attach' `keyval'-style options to the `asy'
-environment. The current version of `asymptote.sty' supports the
-embedding of 3D PRC files, either inline or, using the `attach' option
-with the `attachfile2' (or older `attachfile') `LaTeX' package, as
-annotated (but printable) attachments. For many applications, the
-annotated attachment method tends to be more convenient. The default
-value of `viewportwidth' is `\the\linewidth' for inline 3D figures and
-`0' for attachments.
-
- If the `inline' option is given to the `asymptote.sty' package,
-inline `LaTeX' code is generated instead of EPS or PDF files. This
-makes 2D LaTeX symbols visible to the `\begin{asy}...\end{asy}'
-environment. In this mode, Asymptote correctly aligns 2D LaTeX symbols
-defined outside of `\begin{asy}...\end{asy}', but treats their size as
-zero; an optional second string can be given to `Label' to provide an
-estimate of the unknown label size.
-
- Note that if `latex' is used with the `inline' option, the labels
-might not show up in DVI viewers that cannot handle raw `PostScript'
-code. One can use `dvips'/`dvipdf' to produce `PostScript'/PDF output
-(we recommend using the modified version of `dvipdf' in the `Asymptote'
-patches directory, which accepts the `dvips -z' hyperdvi option).
-
- An excellent tutorial by Dario Teixeira on integrating `Asymptote'
-and `LaTeX' is available at `http://dario.dse.nl/projects/asylatex/'.
+`viewportheight', `attach', and `inline'. `keyval'-style options to
+the `asy' environment. Three-dimensional PRC files may either be
+embedded within the page (the default) or attached as annotated (but
+printable) attachments, using the `attach' option and the `attachfile2'
+(or older `attachfile') `LaTeX' package. The default value of
+`viewportwidth' is `\the\linewidth' for inline 3D figures and `0' for
+attachments. The `inline' option generates inline `LaTeX' code instead
+of EPS or PDF files. This makes 2D LaTeX symbols visible to the
+`\begin{asy}...\end{asy}' environment. In this mode, Asymptote
+correctly aligns 2D LaTeX symbols defined outside of
+`\begin{asy}...\end{asy}', but treats their size as zero; an optional
+second string can be given to `Label' to provide an estimate of the
+unknown label size.
+
+ Note that if the `latex' TeX engine is used with the `inline'
+option, labels might not show up in DVI viewers that cannot handle raw
+`PostScript' code. One can use `dvips'/`dvipdf' to produce
+`PostScript'/PDF output (we recommend using the modified version of
+`dvipdf' in the `Asymptote' patches directory, which accepts the `dvips
+-z' hyperdvi option).
Here now is `latexusage.tex':
@@ -4704,13 +4710,16 @@ and `LaTeX' is available at `http://dario.dse.nl/projects/asylatex/'.
% Use this form to include EPS (latex) or PDF (pdflatex) files:
\usepackage{asymptote}
-% Use this form with latex or pdflatex to include inline LaTeX code:
+% Use this form with latex or pdflatex to include inline LaTeX code by default:
%\usepackage[inline]{asymptote}
+% Use this form with latex or pdflatex to create PDF attachments by default:
+%\usepackage[attach]{asymptote}
+
% Enable this line to support PDF hyperlinks:
-%\usepackage{hyperref}\hypersetup{setpagesize=false}
+%\usepackage{hyperref}\hypersetup{setpagesize=false,unicode}
-% Enable this line for PDF attachments with asy environment option attach=true:
+% Enable this line to support the attach option:
%\usepackage[dvips]{attachfile2}
\begin{document}
@@ -4777,11 +4786,12 @@ shipout(bbox(0.25cm));
Each graph is drawn in its own environment. One can specify the width
and height to \LaTeX\ explicitly. This 3D example can be viewed
interactively either with Adobe Reader or Asymptote's fast OpenGL-based
-renderer. It is often desirable to embed such files as annotated attachments;
-this requires the optional \verb+\usepackage{attachfile2}+ package and
-the \verb+{attach=true}+ option:
+renderer. To support {\tt latexmk}, 3D figures should specify
+\verb+inline=true+. It is sometimes desirable to embed 3D files as annotated
+attachments; this requires the optional \verb+\usepackage{attachfile2}+
+package and the \verb+attach=true+ option:
\begin{center}
-\begin{asy}[height=4cm,attach=false]
+\begin{asy}[height=4cm,inline=true,attach=false]
currentprojection=orthographic(5,4,2);
draw(unitcube,blue);
label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
@@ -4790,7 +4800,7 @@ label("$V-E+F=2$",(0,1,0.5),3Y,blue+fontsize(17pt));
One can also scale the figure to the full line width:
\begin{center}
-\begin{asy}[width=\the\linewidth]
+\begin{asy}[width=\the\linewidth,inline=true]
pair z0=(0,0);
pair z1=(2,0);
pair z2=(5,0);
@@ -5201,20 +5211,18 @@ directory the commands:
tex ifdraft.dtx
texhash
+ A more portable method for embedding movie files, which should work
+on any platform and does not require the `movie15' or `ifdraft'
+packages, is provided by using the `external' module instead of
+`embed'. An example of these interfaces is provided in the file
+`embeddedmovie.asy' and `externalmovie.asy' in the `animations'
+subdirectory of the examples directory. For a higher quality movie
+generated directly by `Asymptote', use the `animate' module along with
+the `animate.sty' package to embed a portable PDF animation (*note
+animate::).
+
An example of embedding `U3D' code is provided in the file
-`embeddedu3d.asy'. As of version 7.0.8, `Adobe Reader' supports the
-`U3D' format under Linux.
-
- Unfortunately, Adobe has not yet made available an embedded movie
-plugin for the Linux version of `Adobe Reader'. A portable method for
-embedding movie files, which should work on any platform and does not
-require the `movie15' or `ifdraft' packages, is provided by using the
-`external' module instead of `embed'. An example of these interfaces is
-provided in the file `embeddedmovie.asy' and `externalmovie.asy' in the
-`animations' subdirectory of the examples directory. For a higher
-quality movie generated directly by `Asymptote', use the `animate'
-module along with the `animate.sty' package to embed a portable PDF
-animation (*note animate::).
+`embeddedu3d.asy'.

File: asymptote.info, Node: slide, Next: MetaPost, Prev: embed, Up: Base modules
@@ -8528,7 +8536,7 @@ Index
(line 6)
* atleast: Bezier curves. (line 56)
* attach <1>: graph. (line 415)
-* attach: LaTeX usage. (line 35)
+* attach: LaTeX usage. (line 46)
* autoadjust: three. (line 354)
* autoimport: Options. (line 110)
* automatic scaling: graph. (line 682)
@@ -8942,7 +8950,7 @@ Index
* guide: Paths and guides. (line 300)
* guide3: three. (line 6)
* hatch: Pens. (line 267)
-* height: LaTeX usage. (line 35)
+* height: LaTeX usage. (line 46)
* help <1>: Debugger. (line 30)
* help <2>: Help. (line 6)
* help: Interactive mode. (line 44)
@@ -8992,6 +9000,7 @@ Index
* initialized: Arrays. (line 39)
* initializers: Variable initializers.
(line 6)
+* inline: LaTeX usage. (line 46)
* InOutTicks: graph3. (line 34)
* input <1>: Interactive mode. (line 48)
* input: Files. (line 11)
@@ -9054,6 +9063,7 @@ Index
* latex: Options. (line 142)
* LaTeX fonts: Pens. (line 192)
* LaTeX usage: LaTeX usage. (line 6)
+* latexmk: LaTeX usage. (line 30)
* latin1: latin1. (line 6)
* latitude: Data types. (line 134)
* latticeshade: fill. (line 32)
@@ -9572,6 +9582,7 @@ Index
* type1cm: Pens. (line 178)
* typedef <1>: Functions. (line 36)
* typedef: Data types. (line 344)
+* U3D: embed. (line 38)
* undefined: Paths and guides. (line 268)
* UnFill: Frames and pictures. (line 152)
* unfill: fill. (line 106)
@@ -9612,10 +9623,10 @@ Index
* verbatim: Frames and pictures. (line 271)
* vertex-dependent colors: three. (line 81)
* Vertical: flowchart. (line 81)
-* viewportheight: LaTeX usage. (line 35)
+* viewportheight: LaTeX usage. (line 46)
* viewportmargin: three. (line 262)
* viewportsize: three. (line 262)
-* viewportwidth: LaTeX usage. (line 35)
+* viewportwidth: LaTeX usage. (line 46)
* views: three. (line 231)
* vim: Editing modes. (line 33)
* virtual functions: Structures. (line 181)
@@ -9626,7 +9637,7 @@ Index
* wheel mouse: GUI. (line 6)
* while: Programming. (line 29)
* white-space string delimiter mode: Arrays. (line 359)
-* width: LaTeX usage. (line 35)
+* width: LaTeX usage. (line 46)
* windingnumber: Paths and guides. (line 268)
* word: Arrays. (line 359)
* write <1>: Arrays. (line 399)
@@ -9696,146 +9707,146 @@ Index

Tag Table:
-Node: Top574
-Node: Description6832
-Node: Installation10333
-Node: UNIX binary distributions11386
-Node: MacOS X binary distributions12492
-Node: Microsoft Windows13376
-Ref: psview14086
-Node: Configuring15007
-Node: Search paths19228
-Node: Compiling from UNIX source20025
-Ref: multisampling20614
-Node: Editing modes23024
-Node: Subversion25456
-Node: Uninstall25919
-Node: Tutorial26269
-Ref: unitcircle30495
-Node: Drawing commands32431
-Node: draw34142
-Ref: arrows35290
-Node: fill40533
-Ref: gradient shading41577
-Node: clip45805
-Node: label46397
-Ref: Label47096
-Node: Bezier curves52821
-Node: Programming56398
-Ref: array iteration57212
-Node: Data types58293
-Ref: format67301
-Node: Paths and guides70904
-Ref: circle71158
-Ref: arctime76646
-Ref: extension80501
-Node: Pens87184
-Ref: fillrule94550
-Ref: basealign95447
-Ref: transparency98274
-Ref: makepen101717
-Ref: overwrite102555
-Node: Transforms103765
-Node: Frames and pictures105556
-Ref: envelope106697
-Ref: size107780
-Ref: unitsize108767
-Ref: shipout109827
-Ref: filltype112160
-Ref: add115297
-Ref: add about116243
-Ref: tex119181
-Node: Files120055
-Ref: cd121020
-Ref: scroll125452
-Node: Variable initializers128525
-Node: Structures131250
-Node: Operators138694
-Node: Arithmetic & logical139008
-Node: Self & prefix operators140982
-Node: User-defined operators141770
-Node: Implicit scaling142681
-Node: Functions143244
-Ref: stack overflow145997
-Node: Default arguments146561
-Node: Named arguments147300
-Node: Rest arguments149462
-Node: Mathematical functions152272
-Node: Arrays156879
-Ref: sort163929
-Ref: tridiagonal166333
-Ref: solve167561
-Node: Slices171754
-Node: Casts175644
-Node: Import177609
-Node: Static182836
-Node: LaTeX usage185730
-Node: Base modules191468
-Node: plain193968
-Node: simplex194620
-Node: math194893
-Node: interpolate197598
-Node: geometry197877
-Node: trembling198471
-Node: stats198822
-Node: patterns199082
-Node: markers199318
-Node: tree201101
-Node: binarytree201289
-Node: drawtree201878
-Node: syzygy202082
-Node: feynman202356
-Node: roundedpath202631
-Node: animation202914
-Ref: animate203331
-Node: embed204470
-Node: slide206259
-Node: MetaPost206599
-Node: unicode207315
-Node: latin1208203
-Node: babel208571
-Node: labelpath208800
-Node: labelpath3209620
-Node: annotate209931
-Node: CAD210402
-Node: graph210712
-Ref: ticks217841
-Ref: pathmarkers231120
-Ref: marker231585
-Ref: markuniform231936
-Ref: errorbars233727
-Ref: automatic scaling237783
-Node: palette248429
-Ref: images248547
-Ref: image252718
-Ref: logimage253196
-Ref: penimage254002
-Node: three254446
-Ref: PostScript3D278988
-Node: obj280680
-Node: graph3280932
-Ref: GaussianSurface286057
-Node: grid3287161
-Node: solids287901
-Node: tube288849
-Node: flowchart291084
-Node: contour295653
-Node: contour3300778
-Node: slopefield301085
-Node: ode302522
-Node: Options302782
-Ref: configuration file308627
-Ref: settings308627
-Ref: convert309828
-Node: Interactive mode312795
-Ref: history314948
-Node: GUI316253
-Node: GUI installation316756
-Node: GUI usage317886
-Node: PostScript to Asymptote318789
-Node: Help319545
-Node: Debugger321281
-Node: Credits323066
-Node: Index323998
+Node: Top575
+Node: Description6834
+Node: Installation10335
+Node: UNIX binary distributions11388
+Node: MacOS X binary distributions12494
+Node: Microsoft Windows13378
+Ref: psview14088
+Node: Configuring15009
+Node: Search paths19230
+Node: Compiling from UNIX source20027
+Ref: multisampling20616
+Node: Editing modes23022
+Node: Subversion25454
+Node: Uninstall25917
+Node: Tutorial26267
+Ref: unitcircle30493
+Node: Drawing commands32429
+Node: draw34140
+Ref: arrows35288
+Node: fill40531
+Ref: gradient shading41575
+Node: clip45803
+Node: label46395
+Ref: Label47094
+Node: Bezier curves52819
+Node: Programming56396
+Ref: array iteration57210
+Node: Data types58291
+Ref: format67299
+Node: Paths and guides70902
+Ref: circle71156
+Ref: arctime76644
+Ref: extension80499
+Node: Pens87182
+Ref: fillrule94548
+Ref: basealign95445
+Ref: transparency98271
+Ref: makepen101714
+Ref: overwrite102552
+Node: Transforms103762
+Node: Frames and pictures105553
+Ref: envelope106694
+Ref: size107777
+Ref: unitsize108764
+Ref: shipout109824
+Ref: filltype112157
+Ref: add115294
+Ref: add about116240
+Ref: tex119178
+Node: Files120052
+Ref: cd121017
+Ref: scroll125449
+Node: Variable initializers128522
+Node: Structures131247
+Node: Operators138691
+Node: Arithmetic & logical139005
+Node: Self & prefix operators140979
+Node: User-defined operators141767
+Node: Implicit scaling142678
+Node: Functions143241
+Ref: stack overflow145994
+Node: Default arguments146558
+Node: Named arguments147297
+Node: Rest arguments149459
+Node: Mathematical functions152269
+Node: Arrays156876
+Ref: sort163926
+Ref: tridiagonal166330
+Ref: solve167558
+Node: Slices171751
+Node: Casts175641
+Node: Import177606
+Node: Static182833
+Node: LaTeX usage185727
+Node: Base modules191768
+Node: plain194268
+Node: simplex194920
+Node: math195193
+Node: interpolate197898
+Node: geometry198177
+Node: trembling198771
+Node: stats199122
+Node: patterns199382
+Node: markers199618
+Node: tree201401
+Node: binarytree201589
+Node: drawtree202178
+Node: syzygy202382
+Node: feynman202656
+Node: roundedpath202931
+Node: animation203214
+Ref: animate203631
+Node: embed204770
+Node: slide206373
+Node: MetaPost206713
+Node: unicode207429
+Node: latin1208317
+Node: babel208685
+Node: labelpath208914
+Node: labelpath3209734
+Node: annotate210045
+Node: CAD210516
+Node: graph210826
+Ref: ticks217955
+Ref: pathmarkers231234
+Ref: marker231699
+Ref: markuniform232050
+Ref: errorbars233841
+Ref: automatic scaling237897
+Node: palette248543
+Ref: images248661
+Ref: image252832
+Ref: logimage253310
+Ref: penimage254116
+Node: three254560
+Ref: PostScript3D279102
+Node: obj280794
+Node: graph3281046
+Ref: GaussianSurface286171
+Node: grid3287275
+Node: solids288015
+Node: tube288963
+Node: flowchart291198
+Node: contour295767
+Node: contour3300892
+Node: slopefield301199
+Node: ode302636
+Node: Options302896
+Ref: configuration file308741
+Ref: settings308741
+Ref: convert309942
+Node: Interactive mode312909
+Ref: history315062
+Node: GUI316367
+Node: GUI installation316870
+Node: GUI usage318000
+Node: PostScript to Asymptote318903
+Node: Help319659
+Node: Debugger321395
+Node: Credits323180
+Node: Index324112

End Tag Table