| 1 |
|
| 2 |
The xpicture package, version 1.2a |
| 3 |
(Several extensions of the "picture" standard environment, |
| 4 |
including graphs of functions and parametric curves) |
| 5 |
Robert Fuster, 2012/12/17 |
| 6 |
|
| 7 |
|
| 8 |
1. Licence |
| 9 |
---------- |
| 10 |
This material is subject to the LaTeX Project Public License. |
| 11 |
|
| 12 |
See http://www.ctan.org/tex-archive/help/Catalogue/licenses.lppl.html |
| 13 |
for the details of that license. |
| 14 |
|
| 15 |
|
| 16 |
2. About this package |
| 17 |
--------------------- |
| 18 |
|
| 19 |
The xpicture package introduces several new graphical instructions, |
| 20 |
and some enriched versions of standard instructions used inside the picture |
| 21 |
environment that, among other utilities, will provide the possibility of |
| 22 |
using different reference systems and a fine control the precise position |
| 23 |
where the objects are placed in your drawing. |
| 24 |
|
| 25 |
But the most interesting feature of this package is the ability to draw high |
| 26 |
quality curves such that conic sections, graphs of elementary functions and |
| 27 |
parametric curves, from LaTeX and using the typical LaTeX syntax. |
| 28 |
|
| 29 |
The new instructions defined by this package can be classified as follows: |
| 30 |
|
| 31 |
-- Reference systems and coordinates: |
| 32 |
|
| 33 |
- Declaration and use of different reference systems, |
| 34 |
with Cartesian or polar coordinates. |
| 35 |
- Instructions to show Cartesian or polar reference systems. |
| 36 |
|
| 37 |
-- An alternative to the picture environment, compatible with |
| 38 |
the new reference systems. |
| 39 |
|
| 40 |
-- Alternative instructions or extensions of the standard picture |
| 41 |
commands and those defined by the packages pict2e and curve2e: |
| 42 |
|
| 43 |
- Enriched versions of marks \put and \multiput, providing an |
| 44 |
adequate control of the precise position in which objects |
| 45 |
are composed. |
| 46 |
- Instructions for drawing straight segments, vectors |
| 47 |
(in any direction and using any reference system), polygonal |
| 48 |
lines, and regular and arbitrary polygons. |
| 49 |
|
| 50 |
-- Regular curves: |
| 51 |
|
| 52 |
- Instructions for drawing conic sections (circles, ellipses, |
| 53 |
hyperbolas and parabolas) and arcs of these curves. |
| 54 |
- Instructions to graph functions and parametrically defined |
| 55 |
curves. |
| 56 |
|
| 57 |
|
| 58 |
This package requires the "calculator" and "calculus" packages. You can |
| 59 |
download these packages from CTAN: |
| 60 |
|
| 61 |
/macros/latex/contrib/calculator |
| 62 |
|
| 63 |
Packages "pict2e", "curve2e" and "xcolor" are also needed. These packages are |
| 64 |
included in major TeX distributions. |
| 65 |
|
| 66 |
|
| 67 |
3. Installation and documentation |
| 68 |
--------------------------------- |
| 69 |
|
| 70 |
After uncompressing "xpicture.zip" you will have the following files: |
| 71 |
|
| 72 |
-- "README". This file. |
| 73 |
-- "xpicture.dtx". The source file. |
| 74 |
-- "xpicture-doc.pdf". The compiled "xpicture" user manual. |
| 75 |
-- "xpicture-doc.tex". The user manual source file. |
| 76 |
-- "xpicture.tds.zip". Ready to use tds-structures zip file. |
| 77 |
|
| 78 |
Then, you can install the package in two ways: |
| 79 |
|
| 80 |
a) Unpacking the zip file xpicture.tds.zip into your local texmf tree |
| 81 |
and updating the file database, or |
| 82 |
|
| 83 |
b) By compiling the source file "xpicture.dtx" in the following sequence |
| 84 |
|
| 85 |
>> pdflatex xpicture.dtx |
| 86 |
>> pdflatex xpicture.dtx |
| 87 |
>> makeindex -s gind.ist -o xpicture.ind xpicture.idx |
| 88 |
>> pdflatex xpicture.dtx |
| 89 |
|
| 90 |
Then, several files will be generated: |
| 91 |
|
| 92 |
"xpicture.sty" (the package). |
| 93 |
Move this file where LaTeX search for (typically, in a local |
| 94 |
texmf tree, at tex/latex/xpicture/) and refresh the file database. |
| 95 |
|
| 96 |
"xpicture.pdf" (documented source and reference manual). |
| 97 |
|
| 98 |
"xpicture.cfgxmpl" (costumizable local configuration file). |
| 99 |
|
| 100 |
Recall that the user manual is not "xpicture.pdf", but |
| 101 |
"xpicture-doc.pdf". If you re-compile this file, |
| 102 |
many small files, named "xpictureNN.tex" are generated. |
| 103 |
These files contain the source code of all examples included |
| 104 |
in the manual. |
| 105 |
You can store or discard this files. |
| 106 |
|
| 107 |
Please, visit the "xpicture" homepage at |
| 108 |
|
| 109 |
http://www.upv.es/~rfuster/xpicture |
| 110 |
|
| 111 |
--------------------------------------------------- |
| 112 |
Robert Fuster |
| 113 |
[email protected] |
| 114 |
|
| 115 |
Universitat Polit\`ecnica de Val\`encia, 2012/12/17 |
| 116 |
--------------------------------------------------- |
| 117 |
|