NAME

     Formats use by the vol library.

DESCRIPTION

     Two formats are available directly with the libvol library :

     - .raw files : all data is written in binary :
         | 3D raw data [...] |
         The 3D raw data is just the dump of the matrix of voxel.
         In fact, raw data format depends of the machine where it is generated. So it's not very portable.

          The raw data does not contain the size of the volume anymore.

     - .vol files : they consist of the concation of a header and a raw file.

         o A header is made of fields

         o A field looks like :
         Type: Value0tice the blank after the colon)
         It's really similar to news or mail header in fact.

         Here is an example of a .vol file :
         X: 100
         Y: 100
         Z: 10
         Voxel-Size: 1
         Author: Dave Null
         foo: bar
         .                       <-- (a dot followed by a new line indicateis the end of the header)
         [ raw data ]

         Currently, there's a limitation of 64 lines in header, and each line is
         limited to 127 characters, including '\n'.

         A few fields are required in vol files :
             - X, Y, Z (the dimensions of the picture)
             - Alpha-Color : the color of an "empty" voxel
             - Voxel-Size (size in bytes of a voxel - usually 1 byte)

NOTES

     vol tools and libairies are free software, covered with  the
     GPL licence.

AUTHORS

     Alexis Guillaume - "Laboratoire LIRIS", Universite Lyon  II,
     aguillau@liris.univ-lyon2.fr

     David Coeurjolly - "Laboratoire LIRIS", Universite Lyon  II,
     dcoeurjo@liris.cnrs.fr