| 1 |
3d/3dgeom version 1.34 |
| 2 |
====================== |
| 3 |
|
| 4 |
This entire package is released under the LPPL, version 1 or (at your |
| 5 |
option) any later version. |
| 6 |
|
| 7 |
This release is a intermediary release of the 3d metapost package. |
| 8 |
It updates the 3d package (CTAN:graphics/metapost/macros/3d) |
| 9 |
and adds features facilitating the creation of space geometry drawings. |
| 10 |
|
| 11 |
There have been a number of changes, and as a consequence we had |
| 12 |
to slightly update the description published in TUGboat in 1998. |
| 13 |
See the doc directory. The doc directory contains both |
| 14 |
the old 1998 article, a corrected version, the 2001 GUTenberg |
| 15 |
article on geometry in space and its translation which appeared in 2003 |
| 16 |
(TUGboat 2001). |
| 17 |
|
| 18 |
The 1998 package is completely contained in this release in the directory |
| 19 |
v1.0, except that some files have been renamed in order to prevent |
| 20 |
a conflict. For istance, 3d.mp has been renamed into 3d-1.0.mp |
| 21 |
when necessary. Also, the doc directory from the 1.0 version has been |
| 22 |
transferred to the current doc directory. |
| 23 |
|
| 24 |
The 1.0 version should still be of interest for the documentation |
| 25 |
of its file, which used mft (see for instance v1.0/doc/3d-1.0.ps). |
| 26 |
|
| 27 |
As version 1.34 is an intermediate release, it may lack some |
| 28 |
uniformity which might be added later. Also, the sources do contain |
| 29 |
preliminary and documented material. |
| 30 |
|
| 31 |
This release contains three directories: |
| 32 |
|
| 33 |
doc : documentation |
| 34 |
examples : all the examples from the Space Geometry article |
| 35 |
inputs : the files needed for metapost |
| 36 |
|
| 37 |
|
| 38 |
HOW TO CREATE AN ANIMATION |
| 39 |
-------------------------- |
| 40 |
|
| 41 |
Details are given to produce the standard animation |
| 42 |
under UNIX, with the binaries listed below. |
| 43 |
For other architectures, you may have to adapt the |
| 44 |
write_script macro in the 3d.mp file. |
| 45 |
|
| 46 |
1) create a directory and copy the .mp files from the |
| 47 |
inputs directory to it. |
| 48 |
2) apply metapost to animpoly.mp ; this will create 100 files |
| 49 |
named animpoly.101, animpoly.102, ..., animpoly.200. |
| 50 |
It will also have created a script file named |
| 51 |
create_animation.sh |
| 52 |
3) copy the gifmerge utility (as well as programs such as pnmcut,...) |
| 53 |
in this directory or let it be reachable through PATH. |
| 54 |
4) apply sh to create_animation.sh; this will create the animation; |
| 55 |
first the metapost outputs are converted to gif, then |
| 56 |
they are collated with gifmerge. |
| 57 |
5) the result is animpoly.gif which is a GIF89A animation file; |
| 58 |
it can be viewed under netscape or simply with a program like xanim. |
| 59 |
|
| 60 |
Binaries required by the 3D package |
| 61 |
----------------------------------- |
| 62 |
|
| 63 |
As it is, the generation of animated gifs requires the following |
| 64 |
programs: |
| 65 |
|
| 66 |
awk |
| 67 |
gs (ghostscript) |
| 68 |
pnmcut |
| 69 |
ppmquant |
| 70 |
ppmtogif |
| 71 |
gifmerge |
| 72 |
|
| 73 |
These executables are not part of that distribution. |
| 74 |
|
| 75 |
The first two are widely available on UNIX. |
| 76 |
The three p* programs are part of the NETPBM toolkit. |
| 77 |
You can find this toolkit on the web through any search tool. |
| 78 |
And gifmerge can be found at http://www.iis.ee.ethz.ch/~kiwi/GIFMerge. |
| 79 |
|
| 80 |
I have no idea how to port all this on other architectures, |
| 81 |
but I assume there are similar tools for PCs or Macs. |
| 82 |
I'd be interested to get feedback and details so that i can |
| 83 |
include instructions in future releases of my package. |
| 84 |
|
| 85 |
======================================================================== |
| 86 |
Denis Roegel, 17 August 2003 |
| 87 |
[email protected] |