AVS Modules                                                         tree(6)


NAME
     tree - generate a 2D tree-like geometry recursively


SUMMARY
     Name          tree

     Type          Input

     Inputs        NONE

     Outputs
     tree -        geom

     Parameters
     Name          Type            Default        Choices
     recursion     idial           3              1              11
     reseed        oneshot         
     branch angle  dial            20.00           0.00          90.00
     branch dev    dial             0.00           0.00          45.00
     seg length    dial             1.00           0.10          10.00
     seg dev       dial             0.00           0.00           1.00
     seg mod       dial             0.50           0.00           1.00
     add leaves    toggle          0              0              1


DESCRIPTION
     TREE generates a 2D binary tree-like geometry using recursive 
techniques. You can control things like the level of recursion, the
average angle between the branches, the average branch length, and
random Gaussian deviations from the average. You can also tell the
module to generate green "leaves" on the leaf nodes.

     There are several interesting areas in which this module should
be modified: it should be made three-dimensional, the branches should be
turned into cylinders, you might want to set the UV's so that you can
texture-map bark and leaf-veins on, etc.

PARAMETERS
     recursion (idial)
This is the level of recursions to generate. This number can be
thought of as the power to which 2 is raised to get the number of
leaves. In other words, a recursion level of 3 yeilds 2**3 leaves. 

     reseed (oneshot)
When you hit this, it reseeds the random number generator. This has no
effect if the "dev" dials are set to 0.0

     branch angle (dial)
This is the average angle (in degrees) between branches.

     branch dev (dial)
This is the standard deviation for the Gaussian random number
generator for the angles between the branches. This is how you add
"controlled randomness to the branch angles.

     seg length (dial)
This is the length of the initial segement.

     seg dev (dial)
This is the standard deviation for the Gaussian random number
generator for the variation of the branch lengths. This is how you add
"controlled randomness to the lengths of the branches.

     seg mod (dial)
This is the amount of segment length reduction carried from one level
of recursion to the next. If this number is 1.0 and "SEG DEV" is 0.0,
all the branches will be same length (that of "SEG LENGTH").

     add leaves (toggle)
If you turn this on, you will get 4-vertex "leaves" generated at the
tip of each leaf node in the binary tree. At high levels of recursion,
this can generate many, many polygons.

OUTPUTS
     tree - geom



SEE ALSO

      

------- End of Forwarded Message


Solution: