-----------------------------------------------------------------------------
            TILE GENERATOR MACRO FILE - QUICK OPTIONS REFERENCE
-----------------------------------------------------------------------------
                        for Persistence of Vision 3.1

-----------------------------------------------------------------------------
BASIC USAGE:
 After including "TILEGEN.MCR", declare the desired general tiling options
 (if any) and then call one or more tiling macros.  No camera definition is
 necessary, and no lights are necessary for pigment_tile ().

Option Name                     Type/Description                      Default
-----------------------------------------------------------------------------
GENERAL OPTIONS:
 tile_size      <Width, Height> in POV units (origin at lower-left)    <1, 1>
 tile_direction <Horizontal (true/false), Vertical (true/false)>       <1, 1>

-----------------------------------------------------------------------------
TILING MACROS:
 pigment_tile (Pigment, Seam)   and   texture_tile (Texture, Seam)
      Seam sets the texture blending between 0 (none) and 1 (full).
      For layered textures/pigments, call the desired macro multiple times
      starting with base (opaque) layer followed by semi-transparent layers.

 object_tile (Object)
      Object may be a single object or union of multiple objects.

 random_object_tile (Object, Count, RotationTurb, ScaleTurb, DepthTurb)
      Count sets the number of object copies (duplicated to create tiling).
      Turbulence values range from 0 (none) to 1 or higher.

 blob_tile (Texture, Count, Size, DepthTurb)
      Count sets the number of blob components (duplicated to create tiling).
      Size is the average size of each component.
      To set sturm value or interior, call the set_camera_tile () macro
      first, then enclose blob_tile () macro in an object {} wrapper with
      desired keywords added.

 tile_lights  (Count, Seed, MaxRotation)
      Good values for Count range between 1 and 5: the first light is always
      white, subsequent lights are dimmer and coloured.
      Larger MaxRotation values cause the lights to be more angled, which
      gives more shadows to blobs and textures with normal patterns.

 random_tile (Seed)
      Uses a combination of the tiling macros above to create tiled
      images (using the tile_size and tile_direction).

NB: For best results with the object and blob tiling macros, the sizes of
the objects/components should fit within the tile_size.

-----------------------------------------------------------------------------
OTHER TILE OPTIONS:
 tile_seed            Used for random_object_tile () and blob_tile ()     0
 set_tile_camera ()   Use to create camera before tiles (see above)
 blob_tile_threshold                                                      0.5

-----------------------------------------------------------------------------
RANDOM TEXTURE MACROS:
 random_pigment (Seed)  Random pattern, color_map, turbulence, and transforms
 random_texture (Seed)  Pigment as above, with random normal and finish
 random_wood (Seed)     Uses wood pigment and normal with suitable colouring

NB: The above macros can be used either as part of the tiling macros, or
separately to apply random textures to any object.

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