Instructions for use of these these vegetation objects in a route of your choice:

Several objects are available in this distribution, they are identified as:

1 firf.s		Tall evergreen with branches mainly at the top
2 pvbrush1.s            Generic bush
3 pvbrush1clump.s       Clump 30 meters long of several pvbrush1 bushes
4 pvclump1.s            Clump of  8 evergreens surrounding a row of brush (fira,firb)
5 pvclump2.s            Clump of 10 evergreens surrounding a row of brush (firb,firc,firf)
 
6 pvclump1offset.s      pvclump1, offset from center, suitable for automated placement
7 pvclump2offset.s      pvclump2, offset from center, suitable for automated placement

Additional files provided:

* Textures for the trees and brush, must be placed in your route's textures folder:

      fira.ace, firb.ace, firc.ace, firf.ace, pvbrush1.ace
      
By popular demand, snow textures are included.  These are modified versions of the summer
vegetation, with "snow" added using digital photo editing software.  There they are, even
if they are not entirely photorealistic. The "snow" textures should be copied into the SNOW
subfolder contained with in your routes Texture folder.

* File "pvclump".ref contains the information used by the route editor, for any of the
first five shapes to be placed individually in your route.  Use a text editor to enter the
following information (or the pvclump.ref file) into your route's .REF file.  You only need
to copy the block of information for shapes that you intend to use.  It is not necessary to
copy the entire file, but make sure you include the closing parenthesis for each group, and
save you route's .REF file in UNICODE format.
   
   Static (
       Class       ( "Vegetation" )
       Description ( "PVBrush1" )
       FileName    ( "pvbrush1.s" )
   )
   Static (
       Class       ( "Vegetation" )
       Description ( "PVbrush1 clump " )
       FileName    ( "pvbrush1clump.s" )
   )
   Static (
       Class       ( "Vegetation" )
       Description ( "Pine Tree Clump 1" )
       FileName    ( "pvclump1.s" )
   )
   Static (
       Class       ( "Vegetation" )
       Description ( "Pine Tree Clump 2" )
       FileName    ( "pvclump2.s" )
   )
   Static (
       Class 	   ( "Vegetation" )
       FileName    ( firf.s )
       Shadow 	   ( ROUND )
       Description ( "Fir_f" )
   )

* File "gantry.dat" contains the information needed to automatically place either of the
pine tree clumps offset from the center of the track.  The placement works within the 
current blue bordered world tile.  In areas where there are switches and diverging track,
the process is apt to become slightly confused, but any placements that look odd can
be removed or repaired by placing a Pine Tree Clump vegetation object.

Note that the height of the clump is related to the height of the track itself, and so
when the track goes through cuts or embankments, the clumps may need to have their 
height adjusted (select the objects with F3 and use the arrow keys to move the object
up or down as necesary).

The "gantry.dat" file information could also be added to any other gantry.dat file you
use in your route, or used in place of existing gantry.dat files. This file will place
clumps for single, double, or triple tracks only.

   SIMISA@@@@@@@@@@JINX0g0t______

   Tr_GantryFile (
     GantrySets ( 2
       GantrySet(
	 Name ( "PV Clump 1" )
	 Style ( 00000001 )
	 Separation ( 85 )
	 GantryTable ( 3
	   GantryTableEntry (
	     Filename ( "pvclump1offset.s" )
	     Distance ( 5)
	     )
	   GantryTableEntry (
	     Filename ( "pvclump1offset.s" )
	     Distance ( 11.373 )
	     )
	   GantryTableEntry (
	     Filename ( "pvclump1offset.s" )
	     Distance ( 17.0 )
	     )
	   )
	 )
       GantrySet(
	 Name ( "PV Clump 2" )
	 Style ( 00000001 )
	 Separation ( 85 )
	 GantryTable ( 3
	   GantryTableEntry (
	     Filename ( "pvclump2offset.s" )
	     Distance ( 5)
	     )
	   GantryTableEntry (
	     Filename ( "pvclump2offset.s" )
	     Distance ( 11.373 )
	     )
	   GantryTableEntry (
	     Filename ( "pvclump2offset.s" )
	     Distance ( 17.0 )
	     )
	   )
	 )
       )
     )


* If you would like to use the tree or brush as forest objects, after backing up your
"forest.dat" file, cut and paste the following into its forest.dat file (Note that here
there are 2 lines, one for each object. If you include both then increase the count of
entries (lines) in your forest.dat file by 2. Make sure you use an editor, such as Wordpad,
which properly handles a Unicode text file):
 
	Forest ( "Firf" "Firf.ace" 16.0f 22.0f 0.8f 1.1.f)
	Forest ( "PVBrush1" "PVbrush1.ace" 5.0f 5.0f 0.8f 1.2f)


----

The textures (.ACE) files and models were created by myself (Phil Voxland). They are
offered for use in the public domain. I would enjoy hearing from anyone who eventually
finds them useful in their own route creation, whether for private, non-commercial, or
eventual commercial use.

If you use any of these objects in a route, or in a collection of route building files
which you redistribute freely or sell to others, acknowledgement of the authorship of these
components is requested.

3DCanvas Pro was used for the 3d model building.

For information and comments please contact: voxland@umn.edu 



