From 42f3026da4fb6ba350f688a92a783b868725c780 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 2 Oct 2009 20:54:28 +0000 Subject: asy 1.88 git-svn-id: svn://tug.org/texlive/trunk@15588 c570f23f-e606-0410-a88d-b1316a301751 --- .../source/utils/asymptote/doc/png/asymptote.info | 441 +++++++++++---------- 1 file changed, 232 insertions(+), 209 deletions(-) (limited to 'Build/source/utils/asymptote/doc/png/asymptote.info') diff --git a/Build/source/utils/asymptote/doc/png/asymptote.info b/Build/source/utils/asymptote/doc/png/asymptote.info index ba90056f71c..108efc52ce3 100644 --- a/Build/source/utils/asymptote/doc/png/asymptote.info +++ b/Build/source/utils/asymptote/doc/png/asymptote.info @@ -1,7 +1,7 @@ This is asymptote.info, produced by makeinfo version 4.13 from ../asymptote.texi. -This file documents `Asymptote', version 1.87. +This file documents `Asymptote', version 1.88. `http://asymptote.sourceforge.net' @@ -23,7 +23,7 @@ File: asymptote.info, Node: Top, Next: Description, Up: (dir) Asymptote ********* -This file documents `Asymptote', version 1.87. +This file documents `Asymptote', version 1.88. `http://asymptote.sourceforge.net' @@ -196,8 +196,8 @@ weaker syntax and capabilities) called `MetaPost'. * `LaTeX' typesetting of labels, for overall document consistency; - * the ability to generate and embed 3D vector PRC graphics into PDF - files; + * the ability to generate and embed 3D vector PRC graphics within + PDF files; * a natural coordinate-based framework for technical drawings, inspired by `MetaPost', with a much cleaner, powerful C++-like @@ -641,6 +641,9 @@ File: asymptote.info, Node: Tutorial, Next: Drawing commands, Prev: Installat 3 Tutorial ********** +3.1 Drawing in batch mode +========================= + To draw a line from coordinate (0,0) to coordinate (100,100), create a text file `test.asy' containing @@ -648,7 +651,7 @@ draw((0,0)--(100,100)); Then execute the command asy -V test Alternatively, `MSDOS' users can drag and drop `test.asy' onto the -Desktop `asy' icon (or make `Asymptote' the default application the +Desktop `asy' icon (or make `Asymptote' the default application for the extension `asy'). This method, known as _batch mode_, outputs a `PostScript' file @@ -657,9 +660,12 @@ you can immediately view the result: The `--' connector joins the two points `(0,0)' and `(100,100)' with a -linear segment. +line segment. + +3.2 Drawing in interactive mode +=============================== - Another method is _interactive mode_, where `Asymptote' reads +Another method is _interactive mode_, where `Asymptote' reads individual commands as they are entered by the user. To try this out, enter `Asymptote''s interactive mode by clicking on the `Asymptote' icon or typing the command `asy'. Then type @@ -675,44 +681,56 @@ automatically complete unambiguous words; otherwise, hitting tab again will show the possible choices. Further commands specific to interactive mode are described in *note Interactive mode::. - One can draw a line with more than two points and create a cyclic -path like this square: +3.3 Figure size +=============== -draw((0,0)--(100,0)--(100,100)--(0,100)--cycle); +In `Asymptote', coordinates like `(0,0)' and `(100,100)', called +_pairs_, are expressed in `PostScript' "big points" (1 `bp' = 1/72 +`inch') and the default line width is `0.5bp'. However, it is often +inconvenient to work directly in `PostScript' coordinates. The next +example produces identical output to the previous example, by scaling +the line `(0,0)--(1,1)' to fit a rectangle of width `100.5 bp' and +height `100.5 bp' (the extra `0.5bp' accounts for the line width): +size(100.5,100.5); +draw((0,0)--(1,1)); -In `Asymptote' coordinates like (0,0) and (100,100) are called _pairs_. -The pairs in the previous examples are expressed in `PostScript' "big -points" (1 `bp' = 1/72 `inch'). However, it is often inconvenient to -work directly in `PostScript' coordinates. The next example draws a -unit square scaled to width 101 `bp' and height 101 `bp'. The output is -identical to that of the previous example. -size(101,101); -draw((0,0)--(1,0)--(1,1)--(0,1)--cycle); +One can also specify the size in `pt' (1 `pt' = 1/72.27 `inch'), `cm', +`mm', or `inches'. Two nonzero size arguments (or a single size +argument) restrict the size in both directions, preserving the aspect +ratio. If 0 is given as a size argument, no restriction is made in +that direction; the overall scaling will be determined by the other +direction (*note size::): + +size(0,100.5); +draw((0,0)--(2,1),Arrow); + - For convenience, the path `(0,0)--(1,0)--(1,1)--(0,1)--cycle' may be -replaced with the predefined variable `unitsquare', or equivalently, -`box((0,0),(1,1))'. One can also specify the size in `pt' (1 `pt' = -1/72.27 `inch'), `cm', `mm', or `inches'. Two nonzero size arguments -(or a single size argument) restrict the size in both directions, -preserving the aspect ratio. If 0 is given as a size argument, no -restriction is made in that direction; the overall scaling will be -determined by the other direction (*note size::): - -size(3cm,3cm); -draw(unitsquare); +To connect several points and create a cyclic path, use the `cycle' +keyword: + +size(100,100); +draw((0,0)--(1,0)--(1,1)--(0,1)--cycle); -To make the user coordinates represent multiples of exactly `1cm': +For convenience, the path `(0,0)--(1,0)--(1,1)--(0,1)--cycle' may be +replaced with the predefined variable `unitsquare', or equivalently, +`box((0,0),(1,1))'. + + To make the user coordinates represent multiples of exactly `1cm': unitsize(1cm); draw(unitsquare); - Adding labels is easy in `Asymptote'; one specifies the label as a + +3.4 Labels +========== + +Adding labels is easy in `Asymptote'; one specifies the label as a double-quoted `LaTeX' string, a coordinate, and an optional alignment direction: -size(0,3cm); +size(3cm); draw(unitsquare); label("$A$",(0,0),SW); label("$B$",(1,0),SE); @@ -728,20 +746,25 @@ the `Asymptote' base module `plain' (a user who has a local variable named `E' may access the compass direction `E' by prefixing it with the name of the module where it is defined: `plain.E'). - This example draws a path that approximates a quarter circle, +3.5 Paths +========= + +This example draws a path that approximates a quarter circle, terminated with an arrowhead: size(100,0); draw((1,0){up}..{left}(0,1),Arrow); +Here the directions `up' and `left' in braces specify the incoming and +outgoing directions at the points `(1,0)' and `(0,1)', respectively. -In general, a path is specified as a list of pairs (or other paths) + In general, a path is specified as a list of points (or other paths) interconnected with `--', which denotes a straight line segment, or `..', which denotes a cubic spline (*note Bezier curves::). Specifying -a final node `cycle' creates a cyclic path that connects smoothly back -to the initial node, as in this approximation (accurate to within -0.06%) of a unit circle: +a final `..cycle' creates a cyclic path that connects smoothly back to +the initial node, as in this approximation (accurate to within 0.06%) +of a unit circle: path unitcircle=E..N..W..S..cycle; An `Asymptote' path, being connected, is equivalent to a `Postscript @@ -790,10 +813,10 @@ label("(0,0,1)",(0,0,1),Z); See section *note graph:: (or the online `Asymptote' gallery and external links posted at `http://asymptote.sourceforge.net') for -further examples, including two and interactive three-dimensional -scientific graphs. Additional examples have been posted by Philippe -Ivaldi at `http://www.piprime.fr/asymptote/'. A user-written -`Asymptote' tutorial is available at +further examples, including two-dimensional and interactive +three-dimensional scientific graphs. Additional examples have been +posted by Philippe Ivaldi at `http://www.piprime.fr/asymptote'. A +user-written `Asymptote' tutorial is available at http://www.artofproblemsolving.com/Wiki/index.php/Asymptote:_Basics  @@ -7693,13 +7716,13 @@ Options (negate by replacing - with -no): -antialias n Antialiasing width for rasterized output [2] -arcballradius pixels Arcball radius [750] -auto3D Automatically activate 3D scene [true] +-autobillboard 3D labels always face viewer by default [true] -autoimport string Module to automatically import -autoplain Enable automatic importing of plain [true] -autoplay Autoplay 3D animations [false] -autorotate Enable automatic PDF page rotation [false] -batchMask Mask fpu exceptions in batch mode [false] -batchView View output in batch mode [false] --billboard Force unnamed labels to always face viewer [false] -bw Convert all colors to black and white [false] -cd directory Set current directory; command-line only -cmyk Convert rgb colors to cmyk [false] @@ -8215,16 +8238,16 @@ Index (line 14) * -- <1>: Self & prefix operators. (line 6) -* --: Tutorial. (line 102) +* --: Tutorial. (line 125) * ---: Bezier curves. (line 83) * -=: Self & prefix operators. (line 6) * -c: Options. (line 167) * -l: Options. (line 186) * -u: Options. (line 177) -* -V <1>: Tutorial. (line 16) +* -V <1>: Tutorial. (line 19) * -V: Configuring. (line 6) -* ..: Tutorial. (line 102) +* ..: Tutorial. (line 125) * .asy: Search paths. (line 13) * /: Arithmetic & logical. (line 20) @@ -8256,7 +8279,7 @@ Index (line 28) * ^=: Self & prefix operators. (line 6) -* ^^: Tutorial. (line 109) +* ^^: Tutorial. (line 132) * a4: Configuring. (line 61) * abort: Data types. (line 321) * abs <1>: Mathematical functions. @@ -8321,7 +8344,7 @@ Index * arrow: label. (line 72) * Arrow: draw. (line 26) * arrow: Drawing commands. (line 31) -* arrow keys: Tutorial. (line 29) +* arrow keys: Tutorial. (line 35) * Arrow3: three. (line 505) * Arrows: draw. (line 26) * arrows: draw. (line 26) @@ -8425,7 +8448,7 @@ Index * boutput: Files. (line 71) * box <1>: three. (line 293) * box: Frames and pictures. (line 22) -* bp: Tutorial. (line 21) +* bp: Tutorial. (line 24) * break: Programming. (line 29) * breakpoints: Debugger. (line 21) * brick: Pens. (line 248) @@ -8462,7 +8485,7 @@ Index * clear <1>: Debugger. (line 23) * clear: Files. (line 89) * clip: fill. (line 110) -* cm: Tutorial. (line 58) +* cm: Tutorial. (line 61) * cmd: Configuring. (line 34) * cmyk: Pens. (line 34) * colatitude: Data types. (line 129) @@ -8477,7 +8500,7 @@ Index * command-line options <1>: Options. (line 6) * command-line options: Configuring. (line 83) * comment character: Files. (line 15) -* compass directions: Tutorial. (line 86) +* compass directions: Tutorial. (line 104) * Compiling from UNIX source: Compiling from UNIX source. (line 6) * complement: Arrays. (line 150) @@ -8532,7 +8555,7 @@ Index * custom tick locations: graph. (line 241) * cut: Paths and guides. (line 232) * cycle <1>: three. (line 6) -* cycle: Tutorial. (line 40) +* cycle: Tutorial. (line 73) * cyclic <1>: three. (line 462) * cyclic <2>: Arrays. (line 39) * cyclic: Paths and guides. (line 74) @@ -8594,7 +8617,7 @@ Index * dvisvg: Configuring. (line 67) * E <1>: Mathematical functions. (line 48) -* E: Tutorial. (line 86) +* E: Tutorial. (line 104) * Editing modes: Editing modes. (line 6) * Ei: Mathematical functions. (line 48) @@ -8630,7 +8653,7 @@ Index * EPS: label. (line 80) * erase <1>: Frames and pictures. (line 7) * erase <2>: Data types. (line 239) -* erase: Tutorial. (line 29) +* erase: Tutorial. (line 35) * erf: Mathematical functions. (line 6) * erfc: Mathematical functions. @@ -8640,7 +8663,7 @@ Index * errorbars: graph. (line 474) * eval: Import. (line 101) * evenodd <1>: Pens. (line 149) -* evenodd: Tutorial. (line 123) +* evenodd: Tutorial. (line 146) * exit <1>: Debugger. (line 57) * exit <2>: Interactive mode. (line 40) * exit: Data types. (line 326) @@ -8793,7 +8816,7 @@ Index * implicit linear solver: MetaPost. (line 10) * implicit scaling: Implicit scaling. (line 6) * import: Import. (line 48) -* inches: Tutorial. (line 58) +* inches: Tutorial. (line 61) * including images: label. (line 80) * inheritance: Structures. (line 189) * initialized: Arrays. (line 39) @@ -8959,7 +8982,7 @@ Index * mintimes: Paths and guides. (line 209) * miterjoin: Pens. (line 135) * miterlimit: Pens. (line 144) -* mm: Tutorial. (line 58) +* mm: Tutorial. (line 61) * mode: Files. (line 85) * mouse: GUI. (line 6) * mouse bindings: three. (line 132) @@ -8968,7 +8991,7 @@ Index * multisample: three. (line 122) * multisampling: Compiling from UNIX source. (line 16) -* N: Tutorial. (line 86) +* N: Tutorial. (line 104) * name: Files. (line 85) * named arguments: Named arguments. (line 6) * new <1>: Arrays. (line 109) @@ -9035,7 +9058,7 @@ Index * pack: label. (line 102) * packing: Rest arguments. (line 30) * pair <1>: Data types. (line 41) -* pair: Tutorial. (line 21) +* pair: Tutorial. (line 49) * pairs: Arrays. (line 245) * paperheight: Configuring. (line 61) * papertype: Configuring. (line 61) @@ -9048,7 +9071,7 @@ Index * path: Paths and guides. (line 7) * path markers: graph. (line 474) * path3: three. (line 6) -* path[]: Tutorial. (line 109) +* path[]: Tutorial. (line 132) * patterns <1>: patterns. (line 6) * patterns: Pens. (line 235) * pdflatex: Options. (line 140) @@ -9085,7 +9108,7 @@ Index (line 19) * postscript: Frames and pictures. (line 267) * PostScript fonts: Pens. (line 207) -* PostScript subpath: Tutorial. (line 109) +* PostScript subpath: Tutorial. (line 132) * pow10: Mathematical functions. (line 6) * prc: three. (line 223) @@ -9101,7 +9124,7 @@ Index * psview: Microsoft Windows. (line 16) * psviewer: Configuring. (line 6) * psviewerOptions: Options. (line 128) -* pt: Tutorial. (line 58) +* pt: Tutorial. (line 61) * public: Structures. (line 6) * push: Arrays. (line 39) * Python usage: Interactive mode. (line 61) @@ -9109,7 +9132,7 @@ Index * quarticroots: math. (line 22) * quit <1>: Debugger. (line 54) * quit <2>: Interactive mode. (line 40) -* quit: Tutorial. (line 29) +* quit: Tutorial. (line 35) * quote: Import. (line 119) * quotient: Arithmetic & logical. (line 6) @@ -9176,7 +9199,7 @@ Index (line 6) * runtime imports: Import. (line 101) * Russian: unicode. (line 7) -* S: Tutorial. (line 86) +* S: Tutorial. (line 104) * safe: Options. (line 156) * save: Frames and pictures. (line 258) * saveline: Files. (line 131) @@ -9279,7 +9302,7 @@ Index * substr: Data types. (line 244) * Subversion: Subversion. (line 6) * sum: Arrays. (line 216) -* superpath: Tutorial. (line 109) +* superpath: Tutorial. (line 132) * Suppress: Pens. (line 328) * SuppressQuiet: Pens. (line 332) * surface <1>: graph3. (line 100) @@ -9289,7 +9312,7 @@ Index * system: Files. (line 156) * syzygy: syzygy. (line 6) * tab: Files. (line 59) -* tab completion: Tutorial. (line 29) +* tab completion: Tutorial. (line 35) * Tan: Mathematical functions. (line 20) * tan: Mathematical functions. @@ -9362,13 +9385,13 @@ Index * Uninstall: Uninstall. (line 6) * unit: Data types. (line 78) * unitbox <1>: three. (line 295) -* unitbox: Tutorial. (line 130) +* unitbox: Tutorial. (line 153) * unitcircle <1>: three. (line 262) -* unitcircle: Tutorial. (line 103) +* unitcircle: Tutorial. (line 126) * unitrand: Mathematical functions. (line 39) * unitsize <1>: Frames and pictures. (line 64) -* unitsize: Tutorial. (line 70) +* unitsize: Tutorial. (line 84) * UNIX binary distributions: UNIX binary distributions. (line 6) * unpacking: Rest arguments. (line 39) @@ -9377,7 +9400,7 @@ Index * update: Files. (line 36) * UpsideDown: Frames and pictures. (line 95) * usepackage: Frames and pictures. (line 287) -* user coordinates: Tutorial. (line 70) +* user coordinates: Tutorial. (line 84) * user-defined operators: User-defined operators. (line 6) * usleep: Data types. (line 332) @@ -9397,7 +9420,7 @@ Index * vim: Editing modes. (line 33) * virtual functions: Structures. (line 189) * void: Data types. (line 10) -* W: Tutorial. (line 86) +* W: Tutorial. (line 104) * whatever: Paths and guides. (line 227) * Wheel: palette. (line 22) * wheel mouse: GUI. (line 6) @@ -9470,144 +9493,144 @@ Index Tag Table: Node: Top574 Node: Description6833 -Node: Installation10332 -Node: UNIX binary distributions11385 -Node: MacOS X binary distributions12491 -Node: Microsoft Windows13375 -Ref: psview14085 -Node: Configuring15006 -Node: Search paths19226 -Node: Compiling from UNIX source20023 -Ref: multisampling20612 -Node: Editing modes23030 -Node: Subversion25462 -Node: Uninstall25925 -Node: Tutorial26275 -Ref: unitcircle30105 -Node: Drawing commands32078 -Node: draw33789 -Ref: arrows34937 -Node: fill40180 -Ref: gradient shading41224 -Node: clip45417 -Node: label46009 -Ref: Label46708 -Node: Bezier curves52433 -Node: Programming56010 -Ref: array iteration56824 -Node: Data types57906 -Ref: format66807 -Node: Paths and guides70271 -Ref: circle70525 -Ref: arctime75882 -Ref: extension79747 -Node: Pens86430 -Ref: fillrule93674 -Ref: basealign94571 -Ref: transparency97396 -Ref: makepen100839 -Ref: overwrite101677 -Node: Transforms102887 -Node: Frames and pictures104678 -Ref: envelope105819 -Ref: size106902 -Ref: unitsize107889 -Ref: shipout108949 -Ref: filltype111282 -Ref: add114251 -Ref: add about115197 -Ref: tex118142 -Node: Files119016 -Ref: cd119981 -Ref: scroll124450 -Node: Variable initializers127523 -Node: Structures129818 -Node: Operators137270 -Node: Arithmetic & logical137584 -Node: Self & prefix operators139481 -Node: User-defined operators140269 -Node: Implicit scaling141180 -Node: Functions141743 -Ref: stack overflow144496 -Node: Default arguments145060 -Node: Named arguments145799 -Node: Rest arguments147961 -Node: Mathematical functions150771 -Node: Arrays155376 -Ref: sort162436 -Ref: tridiagonal164727 -Ref: solve165955 -Node: Slices170152 -Node: Casts174045 -Node: Import176011 -Node: Static181241 -Node: LaTeX usage184137 -Node: Base modules189582 -Node: plain192082 -Node: simplex192734 -Node: math193007 -Node: interpolate194106 -Node: geometry194385 -Node: trembling194979 -Node: stats195330 -Node: patterns195590 -Node: markers195826 -Node: tree197609 -Node: binarytree197797 -Node: drawtree198386 -Node: syzygy198590 -Node: feynman198864 -Node: roundedpath199139 -Node: animation199422 -Ref: animate199839 -Node: embed200978 -Node: slide202767 -Node: MetaPost203107 -Node: unicode203823 -Node: latin1204711 -Node: babel205079 -Node: labelpath205308 -Node: labelpath3206128 -Node: annotate206439 -Node: CAD206910 -Node: graph207220 -Ref: ticks214044 -Ref: pathmarkers227152 -Ref: marker227617 -Ref: markuniform227968 -Ref: errorbars229759 -Ref: automatic scaling233815 -Node: palette244461 -Ref: images244579 -Ref: image248750 -Ref: logimage249228 -Ref: penimage250034 -Node: three250478 -Ref: PostScript3D273050 -Node: obj274742 -Node: graph3274994 -Ref: GaussianSurface280119 -Node: grid3281204 -Node: solids281944 -Node: tube282892 -Node: flowchart285127 -Node: contour289626 -Node: contour3294657 -Node: slopefield294964 -Node: ode296401 -Node: Options296661 -Ref: configuration file302478 -Ref: settings302478 -Ref: convert303573 -Node: Interactive mode306362 -Ref: history308027 -Node: GUI309332 -Node: GUI installation309835 -Node: GUI usage310973 -Node: PostScript to Asymptote311876 -Node: Help312632 -Node: Debugger314368 -Node: Credits316153 -Node: Index317066 +Node: Installation10334 +Node: UNIX binary distributions11387 +Node: MacOS X binary distributions12493 +Node: Microsoft Windows13377 +Ref: psview14087 +Node: Configuring15008 +Node: Search paths19228 +Node: Compiling from UNIX source20025 +Ref: multisampling20614 +Node: Editing modes23032 +Node: Subversion25464 +Node: Uninstall25927 +Node: Tutorial26277 +Ref: unitcircle30503 +Node: Drawing commands32484 +Node: draw34195 +Ref: arrows35343 +Node: fill40586 +Ref: gradient shading41630 +Node: clip45823 +Node: label46415 +Ref: Label47114 +Node: Bezier curves52839 +Node: Programming56416 +Ref: array iteration57230 +Node: Data types58312 +Ref: format67213 +Node: Paths and guides70677 +Ref: circle70931 +Ref: arctime76288 +Ref: extension80153 +Node: Pens86836 +Ref: fillrule94080 +Ref: basealign94977 +Ref: transparency97802 +Ref: makepen101245 +Ref: overwrite102083 +Node: Transforms103293 +Node: Frames and pictures105084 +Ref: envelope106225 +Ref: size107308 +Ref: unitsize108295 +Ref: shipout109355 +Ref: filltype111688 +Ref: add114657 +Ref: add about115603 +Ref: tex118548 +Node: Files119422 +Ref: cd120387 +Ref: scroll124856 +Node: Variable initializers127929 +Node: Structures130224 +Node: Operators137676 +Node: Arithmetic & logical137990 +Node: Self & prefix operators139887 +Node: User-defined operators140675 +Node: Implicit scaling141586 +Node: Functions142149 +Ref: stack overflow144902 +Node: Default arguments145466 +Node: Named arguments146205 +Node: Rest arguments148367 +Node: Mathematical functions151177 +Node: Arrays155782 +Ref: sort162842 +Ref: tridiagonal165133 +Ref: solve166361 +Node: Slices170558 +Node: Casts174451 +Node: Import176417 +Node: Static181647 +Node: LaTeX usage184543 +Node: Base modules189988 +Node: plain192488 +Node: simplex193140 +Node: math193413 +Node: interpolate194512 +Node: geometry194791 +Node: trembling195385 +Node: stats195736 +Node: patterns195996 +Node: markers196232 +Node: tree198015 +Node: binarytree198203 +Node: drawtree198792 +Node: syzygy198996 +Node: feynman199270 +Node: roundedpath199545 +Node: animation199828 +Ref: animate200245 +Node: embed201384 +Node: slide203173 +Node: MetaPost203513 +Node: unicode204229 +Node: latin1205117 +Node: babel205485 +Node: labelpath205714 +Node: labelpath3206534 +Node: annotate206845 +Node: CAD207316 +Node: graph207626 +Ref: ticks214450 +Ref: pathmarkers227558 +Ref: marker228023 +Ref: markuniform228374 +Ref: errorbars230165 +Ref: automatic scaling234221 +Node: palette244867 +Ref: images244985 +Ref: image249156 +Ref: logimage249634 +Ref: penimage250440 +Node: three250884 +Ref: PostScript3D273456 +Node: obj275148 +Node: graph3275400 +Ref: GaussianSurface280525 +Node: grid3281610 +Node: solids282350 +Node: tube283298 +Node: flowchart285533 +Node: contour290032 +Node: contour3295063 +Node: slopefield295370 +Node: ode296807 +Node: Options297067 +Ref: configuration file302880 +Ref: settings302880 +Ref: convert303975 +Node: Interactive mode306764 +Ref: history308429 +Node: GUI309734 +Node: GUI installation310237 +Node: GUI usage311375 +Node: PostScript to Asymptote312278 +Node: Help313034 +Node: Debugger314770 +Node: Credits316555 +Node: Index317468  End Tag Table -- cgit v1.2.3