-----------------------------------------------------------------------------
           CITY GENERATOR INCLUDE FILE - QUICK OPTIONS REFERENCE
-----------------------------------------------------------------------------
                        for Persistence of Vision 3.1

Option Name                     Type/Description                      Default
-----------------------------------------------------------------------------
GENERAL OPTIONS:
 debug_progress   Prints progress info. to debug stream                 false
 city_macro_file  Name of macro file to use when creating city     "CITY.MCR"

-----------------------------------------------------------------------------
CITY SIZE OPTIONS:
 city_block_count     Vector or float; blocks along x and z         <2, 0, 2>
 buildings_per_block  Vector or float; buildings along x and z      <3, 0, 2>
 street_width         Total width of streets (POV units)                   10
 pavement_width       Width of pavement around edges of blocks              4
 building_width       Width of each edge of buildings                      25
 building_gap         Gap between each building                             2
 city_tileable        If true, +x and +z edges not created              false
 city_transform       transform {} option for entire city                   -
 city_corners         Not declarable; returns x-z bounding values           -

-----------------------------------------------------------------------------
CITY MACRO FILE OPTIONS:
 city_seed                Seed for all random aspects of city               0
 min_building_height      Minimum height of buildings (POV units)        12.5
 max_building_height      Maximum height of buildings (POV units)          50
 building_height_falloff  Falloff rate from city centre to edges            2
 building_height_turb     Randomness of building heights                  0.5
 pavement_height          Height of pavement from street (POV units)     0.15
 traffic_spacing          Minimum distance between vehicles (POV units)    10
 traffic_lanes            Traffic Lanes in each direction                   1
 traffic_width            Width of each lane of traffic (POV units)         3

-----------------------------------------------------------------------------
CITY OBJECT FILE OPTIONS:
 city_night             If true creates lit windows and light cones     false
 windows_lit            Proportion of windows lit                        0.33
 windows_blend          Blend from lit windows to unlit windows          0.25
 city_right_hand_drive  True/false                                      false
 max_building_types     Increase if using many different object files     100

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