summaryrefslogtreecommitdiff
path: root/Build/source/utils/asymptote/doc/asymptote.texi
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-05-18 21:58:51 +0000
committerKarl Berry <karl@freefriends.org>2013-05-18 21:58:51 +0000
commit1b4cb2401e932a47c4e736a0197d22c7797b58ad (patch)
tree8e478eee9868a06467931e053ec06658ae3a8e06 /Build/source/utils/asymptote/doc/asymptote.texi
parent93dcab8a877f998aafe2bef5e59b7c6ea2f7f434 (diff)
asy 2.22 sources
git-svn-id: svn://tug.org/texlive/trunk@30552 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/utils/asymptote/doc/asymptote.texi')
-rw-r--r--Build/source/utils/asymptote/doc/asymptote.texi98
1 files changed, 62 insertions, 36 deletions
diff --git a/Build/source/utils/asymptote/doc/asymptote.texi b/Build/source/utils/asymptote/doc/asymptote.texi
index bd245e2c3cc..f7acf237532 100644
--- a/Build/source/utils/asymptote/doc/asymptote.texi
+++ b/Build/source/utils/asymptote/doc/asymptote.texi
@@ -89,7 +89,7 @@ Drawing commands
Programming
* Data types:: void, bool, int, real, pair, triple, string
-* Paths and guides::
+* Paths and guides::
* Pens:: Colors, line types, line widths, font sizes
* Transforms:: Affine transforms
* Frames and pictures:: Canvases for immediate and deferred drawing
@@ -167,7 +167,7 @@ Base modules
Graphical User Interface
* GUI installation:: Installing @code{xasy}
-* GUI usage::
+* GUI usage::
@end detailmenu
@end menu
@@ -390,7 +390,7 @@ The @code{ImageMagick} package from
@noindent
is required to support output formats other than @acronym{EPS},
@acronym{PDF}, @acronym{SVG}, and @acronym{PNG} (@pxref{convert}).
-The @code{Python} interpreter from @url{http://www.python.org} is only required
+The @code{Python 2} interpreter from @url{http://www.python.org} is only required
if you wish to try out the graphical user interface (@pxref{GUI}).
@noindent
@@ -587,30 +587,24 @@ used; if it is old we recommend first putting
@url{http://www.hpl.hp.com/personal/Hans_Boehm/gc/gc_source/gc-7.2d.tar.gz}
in the @code{Asymptote} source directory.
-@cindex @code{freeglut}
-@cindex 3D rendering
-@cindex antialiasing
-@cindex multisampling
-@anchor{multisampling}
-@noindent
-If your graphics card supports multisampling, we recommend using version
-@code{2.6.0} of @code{freeglut} to support antialiasing in
-@code{Asymptote}'s adaptive @code{OpenGL} 3D renderer
-(@code{MacOS X} users can skip this step since @code{Asymptote} is configured
-to use the native glut library on that platform). Download
+On @code{UNIX} platforms (other than @code{MacOS X}), we recommend
+using version @code{2.8.1} of the @code{freeglut} library. To compile
+@code{freeglut}, download
@quotation
-@url{http://prdownloads.sourceforge.net/freeglut/freeglut-2.6.0.tar.gz}
+@url{http://prdownloads.sourceforge.net/freeglut/freeglut-2.8.1.tar.gz}
@end quotation
@noindent
and type (as the root user):
@verbatim
-tar -zxf freeglut-2.6.0.tar.gz
-cd freeglut-2.6.0
+gunzip freeglut-2.8.1.tar.gz
+tar -xf freeglut-2.8.1.tar
+cd freeglut-2.8.1
./configure --prefix=/usr
make install
cd ..
@end verbatim
@noindent
+
Then compile @code{Asymptote} with the commands
@verbatim
./configure
@@ -1281,9 +1275,13 @@ Axial gradient shading varying smoothly from @code{pena} to @code{penb} in the
direction of the line segment @code{a--b} can be achieved with
@verbatim
void axialshade(picture pic=currentpicture, path g, bool stroke=false,
- pen pena, pair a,
- pen penb, pair b);
+ pen pena, pair a, bool extenda=true,
+ pen penb, pair b, bool extendb=true);
@end verbatim
+@noindent
+The boolean parameters @code{extenda} and @code{extendb} indicate
+whether the shading should extend beyond the axis endpoints @code{a}
+and @code{b}.
@cindex @code{radialshade}
Radial gradient shading varying smoothly from
@@ -1292,10 +1290,12 @@ Radial gradient shading varying smoothly from
is similar:
@verbatim
void radialshade(picture pic=currentpicture, path g, bool stroke=false,
- pen pena, pair a, real ra,
- pen penb, pair b, real rb);
+ pen pena, pair a, real ra, bool extenda=true,
+ pen penb, pair b, real rb, bool extendb=true);
@end verbatim
@noindent
+The boolean parameters @code{extenda} and @code{extendb} indicate
+whether the shading should extend beyond the radii @code{a} and @code{b}.
Illustrations of radial shading are provided in the example files
@code{shade.asy}, @code{ring.asy}, and @code{shadestroke.asy}.
@@ -1639,10 +1639,13 @@ real value greater than or equal to 0.75 (cf. John D. Hobby, Discrete and
Computational Geometry 1, 1986):
@verbatim
draw((100,0)..tension 2 ..(100,100)..(0,100));
-draw((100,0)..tension 2 and 1 ..(100,100)..(0,100));
-draw((100,0)..tension atleast 1 ..(100,100)..(0,100));
+draw((100,0)..tension 3 and 2 ..(100,100)..(0,100));
+draw((100,0)..tension atleast 2 ..(100,100)..(0,100));
@end verbatim
+In these examples there is a space between @code{2} and @code{..}.
+This is needed as @code{2.} is interpreted as a numerical constant.
+
@cindex @code{curl}
The curl parameter specifies the curvature at the endpoints of a path
(0 means straight; the default value of 1 means approximately circular):
@@ -1734,7 +1737,7 @@ In addition, it supports many features beyond the ones found in those languages.
@menu
* Data types:: void, bool, int, real, pair, triple, string
-* Paths and guides::
+* Paths and guides::
* Pens:: Colors, line types, line widths, font sizes
* Transforms:: Affine transforms
* Frames and pictures:: Canvases for immediate and deferred drawing
@@ -3568,6 +3571,7 @@ or more subpictures, group them two at a time:
Alternatively, one can use @code{attach} to automatically increase the
size of picture @code{dest} to accommodate adding a frame @code{src}
about the user coordinate @code{position}:
+@cindex @code{attach}
@verbatim
void attach(picture dest=currentpicture, frame src,
pair position=0, bool group=true,
@@ -6289,8 +6293,7 @@ including an extensive set of examples,
@cindex @code{trembling}
This module, written by Philippe Ivaldi and illustrated in the example
@code{floatingdisk.asy}, allows one to draw wavy lines, as if drawn by
-hand. Further examples are posted at
-@url{http://www.piprime.fr/files/asymptote/trembling/}
+hand.
@node stats
@section @code{stats}
@@ -7767,9 +7770,7 @@ renderer (with the command-line option @code{-V} and the default settings
@code{outformat=""} and @code{render=-1}). If you encounter warnings
from your graphics card driver, try specifying @code{-glOptions=-indirect}
on the command line. On @code{UNIX} systems with graphics support for
-multisampling, we recommend installing the latest SVN (antialiased)
-version of the @code{freeglut} library
-(@pxref{multisampling}); the sample width can be
+multisampling, the sample width can be
controlled with the setting @code{multisample}. An initial screen
position can be specified with the pair setting @code{position}, where
negative values are interpreted as relative to the corresponding
@@ -8844,8 +8845,7 @@ guide[][] contour(pair[][] z, real[][] f, real[] c,
To construct contours for an array of values @code{f} specified at
irregularly positioned points @code{z}, use the routine
@verbatim
-guide[][] contour(pair[] z, real[] f, real[] c,
- interpolate join=operator --, int subsample=1);
+guide[][] contour(pair[] z, real[] f, real[] c, interpolate join=operator --);
@end verbatim
@noindent
The contours themselves can be drawn with one of the routines
@@ -9258,7 +9258,7 @@ The modified figure can then be saved as a normal @code{Asymptote} file.
@menu
* GUI installation:: Installing @code{xasy}
-* GUI usage::
+* GUI usage::
@end menu
@node GUI installation
@@ -9282,9 +9282,9 @@ and @code{tk-devel} packages.
Pictures are deconstructed into the @acronym{PNG} image format, which
supports full alpha channel transparency. Under @code{Microsoft Windows},
-this requires @code{Python 2.7.3} and the @code{Python Imaging Library}:
+this requires @code{Python 2.7.4} and the @code{Python Imaging Library}:
@quotation
-@url{http://www.python.org/ftp/python/2.7.3/python-2.7.3.msi}
+@url{http://www.python.org/ftp/python/2.7.4/python-2.7.4.msi}
@end quotation
@quotation
@url{http://effbot.org/downloads/PIL-1.1.7.win32-py2.7.exe}.
@@ -9654,7 +9654,7 @@ Mark Henning, Steve Melenchuk, Martin Wiebusch, and Stefan Knorr.
@c LocalWords: pdfreloadOptions deferred OpenGL Phong Blinn renderer unitbox
@c LocalWords: bezulate Shardt's rasterized viewport unitdisk unitplane devel
@c LocalWords: unitcylinder unitcone solidcone unitfrustum unitsphere nslices
-@c LocalWords: DPostScript YZZero freeglut externalprc nonrendered nosafe KDE
+@c LocalWords: DPostScript YZZero externalprc nonrendered nosafe KDE
@c LocalWords: unithemisphere versa XYplane xypart unitsolidcone YZEquals xml
@c LocalWords: XZEquals XYEquals XZZero XYZero InTicks OutTicks InOutTicks
@c LocalWords: fitscreen planeproject strokepath meshlight nullpens arrowdir
@@ -9686,4 +9686,30 @@ Mark Henning, Steve Melenchuk, Martin Wiebusch, and Stefan Knorr.
@c LocalWords: ascii piecewise arcpoint spacings tilings sncndn resizing
@c LocalWords: differentiable vectorization vectorized asydir normals quartic
@c LocalWords: wavepacket kerned parametrized specular hyperboloid Bourke's
-@c LocalWords: Michail
+@c LocalWords: Michail 0pt 1filll 's 3D latin1 labelpath3 2D graph3
+@c LocalWords: grid3 contour3 i386 psv a4 gsview32 freeglut 'load '
+@c LocalWords: 'asy 'lasy 'auto 5bp 1cm sqrtx01 4g extenda extendb
+@c LocalWords: bb llx 2S 100pt 3t bezier2 bool3 x0 angle1 angle2 z1
+@c LocalWords: z2 before' struct X11 x11colors type1cm 12pt OT1 5mm
+@c LocalWords: cmr12 x' y' xsize ysize 25cm s1 s2 neighbourhood u''
+@c LocalWords: s'' 3x 5x 3y 602e 2x 2y 3sin 10cm 204e addby7 10x Ai
+@c LocalWords: only'' pow10 log10 expm1 log1p atan2 Ai Ai Ai Ai Ai
+@c LocalWords: Ai Ai x1 x2 graph2d attachfile2 n0 P0 n1 P1 markers1
+@c LocalWords: interpolate1 markers2 inlinemovie3 media9 U3D T2A 5E
+@c LocalWords: embeddedu3d curvedlabel3 value2 tickvalue inner'' 2N
+@c LocalWords: lineargraph0 scalings log2 log2graph 5cm BWRainbow2
+@c LocalWords: guide3 path3 unitcircle3 2E 2n noV 100d PostScript3D
+@c LocalWords: size3 fit3 theta1 phi1 theta2 phi2 v1 v2 unitsquare3
+@c LocalWords: t1 t2 5z 5y transform3 identity4 xscale3 yscale3
+@c LocalWords: zscale3 scale3 join3 BeginBar3 EndBar3 Bar3 Bars3
+@c LocalWords: BeginArrow3 MidArrow3 EndArrow3 Arrow3 Arrows3 axes3
+@c LocalWords: BeginArcArrow3 MidArcArrow3 EndArcArrow3 ArcArrow3
+@c LocalWords: ArcArrows3 DefaultHead3 HookHead3 TeXHead3 HookHead2
+@c LocalWords: DefaultHead2 TeXHead2 arrows3 NoMargin3 BeginMargin3
+@c LocalWords: EndMargin3 Margin3 Margins3 BeginPenMargin2 xaxis3
+@c LocalWords: EndPenMargin2 PenMargin2 PenMargins2 BeginPenMargin3
+@c LocalWords: EndPenMargin3 PenMargin3 PenMargins3 BeginDotMargin3
+@c LocalWords: EndDotMargin3 DotMargin3 DotMargins3 TrueMargin3
+@c LocalWords: yaxis3 zaxis3 ticks3 NoTicks3 arrowbar3 type2 axis3
+@c LocalWords: generalaxis3 vectorfield3 margin3 grid3xyz 5unit
+@c LocalWords: slopefield1 144x144