From 255717d812107ea618ce7379a961aa43c03824f1 Mon Sep 17 00:00:00 2001
From: Stuart Buchanan <stuart_d_buchanan@yahoo.co.uk>
Date: Tue, 17 Nov 2020 21:19:15 +0000
Subject: [PATCH] TREE_LIST STG Verb

---
 Docs/README.scenery | 34 +++++++++++++++++++++++++++++++++-
 1 file changed, 33 insertions(+), 1 deletion(-)

diff --git a/Docs/README.scenery b/Docs/README.scenery
index 63c50153c..7035990bd 100644
--- a/Docs/README.scenery
+++ b/Docs/README.scenery
@@ -416,7 +416,7 @@ Syntax
   BUILDING_LIST <filename> <material name> <lon> <lat> <elev>
 
 Where:
-- <filename> is the name of a file containing building positions
+- <filename> is the name of a file containing building positions.  May be a .gz file
 - <material name> is the name of the material that will be referenced to find
   random building parameters.
 - <lat>, <lon>, <elev> defines the center of the set of buildings, and also
@@ -463,6 +463,38 @@ For example, the following entries generates 3 small, 2 medium and 2 large build
 0 400 0 0 1
 0 500 0 0 2
 
+3.9  TREE_LIST
+------------------
+
+Defines a file containing tree coordinates that should be rendered using
+the tree shader (aka Random vegetation).
+
+Example:
+
+  TREE_LIST trees.txt.gz DeciduousBroadCover -3.36074090 55.95297494 30.3822
+
+Syntax
+
+  TREE_LIST <filename> <material name> <lon> <lat> <elev>
+
+Where:
+- <filename> is the name of a file containing tree positions, may be a .gz file
+- <material name> is the name of the material that will be referenced to find
+  random vegetation parameters such as size, texture.
+- <lat>, <lon>, <elev> defines the center of the set of trees, and also
+  the point at which the material definition will be evaluated (for regional
+  materials).
+
+See README.materials for details on configuring the random building parameters.
+
+The referenced <filename> (in the example trees.txt.gz) contains lines of the form
+
+X Y Z A B C
+
+Where:
+- X,Y,Z are the cartesian coordinates of the tree. +X is East, +Y is North
+- A,B,C is optional and represents the normal of the underlying terrain.  Used for shadows.  Defaults to (0,0,1)
+
 4 model manager ("/models/model") --------------------------------------------