NAME

     volcompose - build discrete geometric figures.

SYNOPSIS

     volcompose [-i inputfile] [-v voloutputfile] [-s  sigoutput-
     file]

     volcompose -h

DESCRIPTION

     volcompose reads the description of 3D figures and then draw
     them in a .vol file.

OPTIONS

     -i inputfile : reads inputfile instead stdin.

     -v vol outputfile : writes vol  into  outpufile  instead  of
          /dev/null. Use '-' for stdout.

     -s sig outputfile : write sig  into  outputfile  instead  of
          /dev/null. Use '-' for stdout.

     -h : show help.

RETURN VALUE

     0 : No error

     1 : Bad command line

     2 : Couldn't read input file

     3 : Couldn't write output file

     4 : Bad parameters

     5 : Fatal parse error

SYNTAX

     Type name {
          rotation-X = number;               (optionnal)
          rotation-Y = number;               (optionnal)
          rotation-Z = number;               (optionnal)
          params {
               param1 = number;
               param2 = number;
               ...
          }
          : option1, option2, ...            (optionnal)
     };
     `rotation-T' sets the rotation angle around the axis  T.   A
     number  is  a floating point number, like `12345.678e-5'. If
     it ends with the letter `d', it  will  be  considered  as  a
     degree angle and converted in radian. (This has of course no
     sense with a non-angle number).

     Parameters depend of the type.

EXAMPLES

     RoundedCube my_cube {
          rotation-Z = 45d;
          rotation-Y = 0.5;
          params {
               len = 60;
          }
     } : axis;

     Sphere my_sphere { params { r = 60; } } : parametric, axis;

TYPES

     Ellipsoid
     Parameters :
          a, b and c which are the lengths of the semi-axes.
     Output
          The following global values are computed :
               - the area using Garry Tee's algorithm (see http://www.citr.auckland.ac.nz/dgt/Source_Code.php?id=2)
          The following local value are computed on a few points at the surface :
               - the gaussian curve

     Sphere
     Parameters
               r : the radius of the sphere
     Output
          Same as ellipsoid

     Cube
     Parameters
          len : the length of the cube.
     Output
          no output yet ...


     RoundedCube
          Same as Cube

     Catenoid
     Parameters
          c : ?
     Output
          no output yet

     Torus
     Parameters
          Let the radius from the center of the hole to the center of the torus tube be c,
          and the radius of the tube be a.
     Output
          Global : area and volume
          Local : gaussian and mean curvature

OPTIONS

     axis : draw axis

     parametric : draw with parametric equations (if available)

     cartesian : draw with cartesian equation (if available)

     verbose : output a  verbose  signature  (for  each  discrete
     point,  output a list of true points with their characteris-
     tics)

NOTES

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

SEE ALSO

     vol(7), vol2geom(1), volboundary(1), volarith(1)

COPYRIGHT

     Copyright 2002/2003 "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.

     The syntax may change a  bit  in  the  near  future  (it  is
     planned  to  allow  the user to tell how the volumes will be
     assembled (or, and, ...))

AUTHORS

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

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