NAME

     volgen - build discrete geometric figures.

SYNOPSIS

     volgen figure params [ -v vol output file ] [ -s sig  output
     file ] [-axis]

OPTIONS

     Figures and parameters

         +------------------+----------------------------+
         | Figure           | Parameters                 |
         +------------------+----------------------------+
         | ellipsoid        | -a float -b float -c float |
         | sphere           | -r float                   |
         | cube             | -len integer               |
         | rounded-cube     | -len integer               |
         | catenoid         | -c float                   |
         | torus            | -a float -c float          |
         | klette-ellipsoid | -a float -b float -c float |
         +------------------+----------------------------+
          Additionnal parameters :
          -rx float -ry float -rz float
          (rotation in radion around axis X, Y and Z).

          -v output vol file : default /dev/null. "-" means stdout.
          -s output sig file : default /dev/null. "-" means stdout.

          -axis       : draw axis in the volume.
          -parametric : use parametric equations if available
          -cartesian  : use cartesian equation if available
          -verbose  : output verbose signature (list "true" points for each discrete points)

RETURN VALUE

     0 : No error

     1 : Bad command line

     3 : Couldn't write output file

     4 : Bad parameters

EXAMPLES

          volgen cube -len 10
          volgen ellipsoid -a 5 -b 10 -c 15 -axis -v foo.vol -s -
          volgen rounded-cube -len 3 -axis -parametric -rx 45d -ry 0.5

          The d suffix tells the program that the angle is in degree instead of radian.

NOTES

     volgen generates .vol files. Currently there is no  tool  to
     visualize these files. You'll have to convert them for exam-
     ple into geomview files. See vol2geom(1).

     volgen generates volumes full of  voxels.  Il  you  want  to
     visualize  a  big  volume  with  geomview, it will be really
     slow. It is recommanded to lightweight a  volume  before  by
     using  volboundary(1).  The  appearance  will be the same in
     geomview, but the of the initial  volume  just  the  surface
     will remain.

SEE ALSO

     vol(7), vol2geom(1),  volboundary(1),  volarith(1),  volcom-
     pose(1)

COPYRIGHT

     Copyright 2002/2003, Alexis Guillaume and  David  Coeurjolly
     for  "Laboratoire LIRIS", Universite Lyon II.

     This is free software; see the  source  for  copying  condi-
     tions. There is NO warranty; not even for MERCHANTABILITY or
     FITNESS FOR A PARTICULAR PURPOSE.

VERSION

     This is version 0.1.1.

BUGS

     No bugs known yet. If you think you have found  one,  please
     send an email at the adress below.

AUTHORS

     Alexis Guillaume <aguillau@liris.univ-lyon2.fr>

     David Coeurjolly <dcoeurjo@liris.univ-lyon2.fr>