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

Option Name                     Type/Description                      Default
-----------------------------------------------------------------------------
GENERAL OPTIONS:
 debug_progress         Prints progress info. to debug stream           false
 hair_objects_only      If true, no mesh surface created                false
 hair_mesh_transform    transform {} value for entire mesh and hairs      -

-----------------------------------------------------------------------------
HAIR OBJECT OPTIONS AND HAIR OBJECT MACROS:
 hair_object                       Single object                          -
 hair_objects                      One dimensional array of objects       -

 smooth_triangle_hairs_object()    Macro to set hair_object option       Yes
 clipped_sphere_hair_object()      Macro as above                         -
 triangle_patch_hairs_object()     Macro as above                         -
 triangle_cluster_hairs_object()   Macro as above                         -

-----------------------------------------------------------------------------
HAIR OBJECT MACRO OPTIONS (not all options apply to all four macros):
 hair_radius                Radius of each hair's curve (POV units)      1
 hair_thickness             Max. Thickness of each hair (POV units)      0.02
 hair_thickness_curvature   0 = flat, 1 = highly curved                  0.5
 hair_rotation              Vector, <0,0,0> = perpendicular/sky dir.  <0,0,0>
 hair_triangle_smoothness   Number of triangles per each arc            30
 hairs_per_patch            Number of hairs in single hair object       10
 hair_patch_size            Diameter of patch base (POV units)           0.5
 hair_patch_turb            0 = no size/rotation randomness              0.1
 hair_arc                   Arc length, 1 = 180 degrees                  0.25
 hair_length                Direct length instead of arc (POV units)     0.2

-----------------------------------------------------------------------------
HAIR COVERAGE OPTIONS:
 hair_objects_per_triangle  Hair objects per individual triangle;         1
 hair_object_count          Or, total number of hairs objects created;    -
 hair_objects_per_unit      Or, hair objects per square unit of mesh      -

-----------------------------------------------------------------------------
HAIR ROTATION AND TURBULENCE OPTIONS:
 hair_rotate_to_surface     Choose false, true, -true, or vector        false
 hair_sky                   Rotates hair to direction given              +y
 hair_seed                  Seed for all random aspects of hair          0
 hair_size_turb             0 = no size randomness                       0.1
 hair_rotation_turb         0 = no rotation randomness                   0.1
 hair_wind_rotation         Sets max angle for hair bent by wind         0
 hair_wind_speed            Sets wind rotation cycles per clock unit     1

-----------------------------------------------------------------------------
HAIR TEXTURE AND MATERIAL OPTIONS:
 hair_texture           Applied to each hair object untransformed         -
 hair_pattern_pigment   Each hair uses single colour from pigment map     -
 hair_material          Applied instead of above two options              -

 apply_hair_materials_to_mesh                                           false

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