-----------------------------------------------------------------------------
             COMPRESSED MESH MACRO FILE - QUICK OPTIONS REFERENCE
-----------------------------------------------------------------------------
                        for Persistence of Vision 3.1

-----------------------------------------------------------------------------
BASIC USAGE:
 object { read_mesh ( [Mesh FileName] )
    [object modifiers]
    }

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 file            false

-----------------------------------------------------------------------------
MESH TEXTURING OPTIONS:
 mesh_texture         Global texture, or declared for each mesh in file   -
 mesh_textures        Global texture array for mutliple meshes in a
                      single file                                         -

 apply_mesh_textures  If false, overrides all mesh texturing            true

-----------------------------------------------------------------------------
BICUBIC PATCH OVERRIDE OPTIONS:
 pcm_patch_type       0,1 - overrides type in compressed file             -
 pcm_patch_flatness   overrides flatness in compressed file               -
 pcm_patch_u_steps    overrides u_steps in compressed file                -
 pcm_patch_v_steps    overrides v_steps in compressed file                -

-----------------------------------------------------------------------------
MESH DEFORMATION AND CREATION MACROS:
 deform_mesh ()     Macro must be defined without parameters
 create_mesh ()     Macro must be defined without parameters

-----------------------------------------------------------------------------
PREDEFINED MESH DEFORMATION MACROS:
Note: These macros should be placed inside the deform_mesh () {...}
      definition, before calling read_mesh ().

 wave_mesh ( [WaveScale], [Frequency], [Phase] )
        Applies sine wave along y axis

 ripple_mesh ( [RippleAxis], [RippleAmount], [Frequency], [Phase] )
        Applies sine ripple along RippleAxis direction

 jitter_mesh ( [JitterScale], [JitterSeed] )
        Applies random disturbance to each mesh vertex

 twist_mesh ( [TwistAngle], [TwistCentre] )
        Twists mesh by selected angle (eg. x*180) around TwistCentre

 bend_mesh ( [EndPoint1], [EndPoint2], [BendDirection], [BendAngle] )
        Bends the mesh surface along EndPoint1 (fixed) to EndPoint2, by
        BendAngle degrees in specified direction

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

 object_mesh ( [SingleObject] )
        Places SingleObject at centre of each triangle in mesh surface

 wire_mesh ( [Thickness] )
        Places cylinders of selected radius from the centre of each
        triangles to its vertices

 blob_mesh ( [BlobSize], [Threshold], [Sturm] )
        Uses blob spheres in place of each triangle, scaled by BlobSize

 spike_mesh ( [Length], [Thickness] )
        Creates mesh with cones protruding from centre of each triangle,
        Length and Thickness scaled according to each triangle's size

 cylinder_mesh ( [Thickness], [Edge1], [Edge2], [Edge3] )
        Places cylinders of selected radius along selected edges of each
        triangle, where Edge1, Edge2, and Edge3 are true/false

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