README FILE FOR epflbody.x:

epflbody.x generates VRML 1.0 file for each frame in the input BAP file.

Example usage:

        epflbody.x curious.int.bap /tmp/out.wrl

In any case, it expects a bap file as 1st arg. and a "template name" that is
used as a base name + extension for the vrml files to be generated as a 2nd arg.
For example, the above command will generate, in /tmp directory:

       out_0000.wrl
       out_0001.wrl
       out_0002.wrl
       out_0003.wrl
       out_0004.wrl
       out_0005.wrl
       ...

TEMPLATE FILES
--------------
IMPORTANT: The current directory where epflbody.x is executed should contain
the body.dat and hand.dat files. These are used as templates for the body
scaling.

If you do not want to use them in the current directory, set the
following environment variable to point to the directory containing them:

% setenv BDYDATAPATH /usr/people/epfl/body_files


VIEWPOINTS
----------

There's also a -v option to make the prog. read a "ViewPoint.dat" file where
there are several possibilities of camera positioning and orientation that
can be activated by uncommenting them. Normally, this file is not included
in the generated vrml files. Including -v in the compilation makes the
opposite happen.

For example, to create viewpoints with front and top views, create a 
ViewPoint.dat file, with the following contents:

      ###### Frontal view ######
            DEF Cameras Switch {
              DEF FrontalView PerspectiveCamera {
                  position    0.0 0.5 -2.00
                  orientation 0 1 0 3.14
              }
            }

      ###### Top view ######
            DEF Cameras Switch {
              DEF TopView PerspectiveCamera {
                  position    0.0 3.5 -0.00
                  orientation 1 0 0 -1.57
              }
            }

and run epflbody.x as follows:

        epflbody.x curious.int.bap /tmp/out.wrl -v 

ENVIRONMENT VARIABLES FOR GEOMETRY
----------------------------------
The *.wrl.gz files and auxiliary *.rgb files containing the vrml 
surfaces and textures can be put elsewhere. One can define the environmental 
var. BUFFPATH pointing to the directory where those files are put and the 
correct path is added when generating the frame-by-frame vrml files.

For example, if your body surfaces are in directory /usr/people/epfl/body_surfaces
directory, set the environment variable as:

% setenv BUFFPATH /usr/people/epfl/body_surfaces

Then, epflbody.x will add this path to the generated wrl files as inline
surfaces.

Please contact Joaquim Esmerado (jle@lig.di.epfl.ch) and Tolga K. Capin
(capin@lig.di.epfl.ch) for further questions.

