summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/metapost/mp3d/README
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/metapost/mp3d/README')
-rw-r--r--Master/texmf-dist/doc/metapost/mp3d/README84
1 files changed, 84 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/metapost/mp3d/README b/Master/texmf-dist/doc/metapost/mp3d/README
new file mode 100644
index 00000000000..499a872c0b1
--- /dev/null
+++ b/Master/texmf-dist/doc/metapost/mp3d/README
@@ -0,0 +1,84 @@
+ 3d/3dgeom version 1.34
+ ======================
+
+This release is a intermediary release of the 3d metapost package.
+It updates the 3d package (CTAN:graphics/metapost/macros/3d)
+and adds features facilitating the creation of space geometry drawings.
+
+There have been a number of changes, and as a consequence we had
+to slightly update the description published in TUGboat in 1998.
+See the doc directory. The doc directory contains both
+the old 1998 article, a corrected version, the 2001 GUTenberg
+article on geometry in space and its translation which appeared in 2003
+(TUGboat 2001).
+
+The 1998 package is completely contained in this release in the directory
+v1.0, except that some files have been renamed in order to prevent
+a conflict. For istance, 3d.mp has been renamed into 3d-1.0.mp
+when necessary. Also, the doc directory from the 1.0 version has been
+transferred to the current doc directory.
+
+The 1.0 version should still be of interest for the documentation
+of its file, which used mft (see for instance v1.0/doc/3d-1.0.ps).
+
+As version 1.34 is an intermediate release, it may lack some
+uniformity which might be added later. Also, the sources do contain
+preliminary and documented material.
+
+This release contains three directories:
+
+ doc : documentation
+ examples : all the examples from the Space Geometry article
+ inputs : the files needed for metapost
+
+
+HOW TO CREATE AN ANIMATION
+--------------------------
+
+Details are given to produce the standard animation
+under UNIX, with the binaries listed below.
+For other architectures, you may have to adapt the
+write_script macro in the 3d.mp file.
+
+ 1) create a directory and copy the .mp files from the
+ inputs directory to it.
+ 2) apply metapost to animpoly.mp ; this will create 100 files
+ named animpoly.101, animpoly.102, ..., animpoly.200.
+ It will also have created a script file named
+ create_animation.sh
+ 3) copy the gifmerge utility (as well as programs such as pnmcut,...)
+ in this directory or let it be reachable through PATH.
+ 4) apply sh to create_animation.sh; this will create the animation;
+ first the metapost outputs are converted to gif, then
+ they are collated with gifmerge.
+ 5) the result is animpoly.gif which is a GIF89A animation file;
+ it can be viewed under netscape or simply with a program like xanim.
+
+ Binaries required by the 3D package
+ -----------------------------------
+
+As it is, the generation of animated gifs requires the following
+programs:
+
+ awk
+ gs (ghostscript)
+ pnmcut
+ ppmquant
+ ppmtogif
+ gifmerge
+
+These executables are not part of that distribution.
+
+The first two are widely available on UNIX.
+The three p* programs are part of the NETPBM toolkit.
+You can find this toolkit on the web through any search tool.
+And gifmerge can be found at http://www.iis.ee.ethz.ch/~kiwi/GIFMerge.
+
+I have no idea how to port all this on other architectures,
+but I assume there are similar tools for PCs or Macs.
+I'd be interested to get feedback and details so that i can
+include instructions in future releases of my package.
+
+========================================================================
+Denis Roegel, 17 August 2003
+roegel@loria.fr