-----------------------------------------------------------------------------
              MESH MORPHING MACRO FILE - QUICK OPTIONS REFERENCE
-----------------------------------------------------------------------------
        for use with the Compressed Mesh Macro File for POV-Ray 3.1

-----------------------------------------------------------------------------
BASIC USAGE:
 object {
    morph_meshes ( [Mesh FileName List Array], [Current Morph Position] )
    [object modifiers]
    }

Note: Each mesh file must have the same number of meshes, with matching
 numbers of triangles and smooth triangles.  Morph Position equates to
 array index, ie. 0 = first mesh in list, 1.5 = halfway between second and
 third meshes in list, etc.

Option Name                     Type/Description                      Default
-----------------------------------------------------------------------------
GENERAL OPTIONS:
 debug_progress    Prints progress info. to debug stream                false
 declare_only      Declares Mesh[0], Mesh[1], etc. from files           false
 morph_smoothing   Smooths clock transitions, > 1 = more smoothing        -

-----------------------------------------------------------------------------
MESH TEXTURING OPTIONS:
 mesh_texture         Global texture, or declared in each mesh file       -
 mesh_textures        Global texture array for mutliple meshes in a
                      single file, or declared in each mesh file          -
 morph_mesh_textures  Two dimensional texture array, first dimension is
                      number of mesh files, second dimension is number
                      of meshes in each file                              -

 apply_mesh_textures  If false, overrides all mesh texturing            true

-----------------------------------------------------------------------------
MORPH MESH DEFORMATION AND CREATION MACROS:
 deform_morph_meshes ()     Macro must be defined without parameters
 create_morph_meshes ()     Macro must be defined without parameters

-----------------------------------------------------------------------------
PREDEFINED MORPH MESH CREATION MACROS:
Note: These macros should be placed inside the create_morph_meshes () {...}
      definition, before calling morph_meshes ().

 object_morph_meshes ([SingleObject])
        Places SingleObject at centre of each triangle in morphed surface

-----------------------------------------------------------------------------
                                                Copyright 1999, Chris Colefax
