Skip to content
Aaron edited this page Jun 10, 2018 · 16 revisions
Welcome to the improved-sapling-tree-generator wiki!
This page will be documentation of all the settings
For information on using the settings go to Tips
Shapes:

Conical
Inverse Conical
Spherical
Hemispherical
Cylindrical
Tapered Cylindrical
Inverse Tapered Cylindrical
Flame
Tend Flame
Custom Shape

Geometry Settings:


Bevel
Whether the curve is beveled

Bevel Resolution
The bevel resolution of the curves

Curve Resolution
The resolution along the curves

Handle Type
The type of bézier curve handles used in the spline. Vector or Auto

Shape
The overall shape of the tree. Choice of Shapes

Custom Shape
custom shape branch length at (Base, Middle, Middle Position, Top)

Secondary Branches Shape
The shape of secondary splits. Choice of Shapes

Branch Distribution
Adjust branch spacing to put more branches at the top or bottom of the tree

Branch Rings
grow branches in rings

Random Seed
The seed of the random number generator

Scale
The tree scale

Scale Variation
The variation in the tree scale

Branch Radius Settings:


Bevel
Whether the curve is beveled

Bevel Resolution
The bevel resolution of the curves

Ratio
Base radius size

Radius Scale
The scale of the trunk radius

Radius Scale Variation
Variation in the radius scale

Branch Radius Ratio
Power which defines the radius of a branch compared to the radius of the branch it grew from

Split Radius Ratio
Reduce diameter of stems after splits by this factor

Minimum Radius
Minimum branch Radius, to prevent needle-thin branches

Close Tip
Set radius at branch tips to zero

Root Flare
Multiplier for radius to make trunk flare out at its base

Auto Taper
Calculate taper automatically based on branch lengths

Taper
The fraction of tapering on each branch
set per branching level

Tweak Radius
multiply radius by this factor
set per branching level

Branch Splitting Settings:


Levels
Number of recursive levels of branching

Base Splits
Number of splits at the base of the trunk

Trunk Height
Fraction of tree height with no branches

Secondary Base Size
Factor to decrease base size for each level

Split Height
Fraction of tree height with no splits

Split Bias
Put more splits at the top or bottom of the tree

Split relative to length
Make splitting amount proportional to branch length

Branches
The max number of branches grown at each level
set per branching level

Segment Splits
Number of splits per segment
set per branching level

Split Angle
Angle of branch splitting
set per branching level

Split Angle Variation
Variation in the split angle
set per branching level

Rotate Angle
The angle of a new branch around the one it grew from (negative values make branches rotate opposite from the previous one)
For the first level (trunk), controls the rotation angle of a branch split relative to the previous split.
set per branching level

Rotate Angle Variation
Variation in the rotate angle
set per branching level

Outward Attraction
Branch outward attraction
set per branching level

Branching Mode
Method to use for positioning and rotating branches around trunk. for second level only

  • Original: rotate around each branch
  • Rotate: evenly distribute branches to point outward from center of tree
  • Distance: remove overlapping branches

Curve Resolution
The number of segments on each branch
set per branching level

Branch Growth Settings:


Taper Crown
Shorten trunk splits toward outside of tree

Length
The relative lengths of each branch level
set per branching level

Length Variation
The relative length variations of each level
set per branching level

Down Angle
The angle between a new branch and the one it grew from
set per branching level

Down Angle Variation
Angle to decrease Down Angle by towards end of parent branch (negative values add random variation)
set per branching level

Curvature
The angle of the end of the branch
set per branching level

Curvature Variation
Variation of the curvature
set per branching level

Back Curvature
Curvature for the second half of a branch
set per branching level

Vertical Attraction
Branch upward attraction
set per branching level

Use old down angle variation
Use old method of down angle variation. useful for converting old presets

Use parent angle
(first level) Rotate branch to match parent branch

Pruning Settings:


Prune
Whether the tree is pruned

Prune Ratio
Proportion of pruned length

Prune Width
The width of the envelope

Prune Base Height
The height of the base of the envelope, bound by trunk height

Prune Width Peak
Fraction of envelope height where the maximum width occurs

Prune Power High
Power which determines the shape of the upper portion of the envelope

Prune Power Low
Power which determines the shape of the lower portion of the envelope

Leaves Settings:


Show Leaves
Whether the leaves are shown

Leaf Shape
The shape of the leaves
Choice of Hexagonal, Rectangular, DupliFaces, and DupliVerts

Leaf Object
Object to use for leaf instancing if Leaf Shape is DupliFaces or DupliVerts

Leaf Object Axes

  • Leaf Tip Axis Set this to the axis the leaf tip is pointing along.
  • Leaf Top Axis Set this to the axis the leaf top is facing toward.

Leaves
Maximum number of leaves per branch

Leaf Base Size
Fraction of branch length with no leaves

Leaf Distribution
The way leaves are distributed on branches. Choice of Shapes

Leaf Type
The arrangement of leaves on the stem. Choice of:

  • Rotated Alternate: leaves rotate around the stem and face upwards
  • Rotated Opposite: pairs of leaves rotate around the stem and face upwards
  • Alternate: leaves sprout alternately from each side of the stem, uses rotate angle
  • Opposite: pairs of leaves sprout from opposite sides of stem, uses rotate angle
  • Palmately Compound: multiple leaves radiating from stem tip, uses rotate angle for spread angle
  • Radial: leaves rotate around the stem

Leaf Down Angle
The angle between a new leaf and the branch it grew from

Leaf Down Angle Variation
Angle to decrease Down Angle by towards end of parent branch

Leaf Rotate Angle
The angle of leaves for alternate and opposite leaves, The spread angle for palmately compound leaves

Rotation Variation
Add randomness to leaf orientation

Leaf Scale
The scaling applied to the whole leaf

Leaf Scale X
The scaling applied to the x direction of the leaf

Leaf Scale Taper
scale leaves toward the tip or base of the patent branch

Leaf Scale Variation
randomize leaf scale

Horizontal leaves
Leaves face upwards

Leaf Angle
Leaf vertical attraction

Armature and Animation Settings:


Use Armature
Whether the armature is generated

Armature Animation
Whether animation is added to the armature

Leaf Animation
Whether animation is added to the leaves

Fast Preview
Disable armature modifier, hide tree, and set bone display to wire, for fast playback
If MakeMesh: Disable skin modifier and hide armature

Animation Speed
Adjust speed of animation, relative to scene frame rate

Loop Frames
Number of frames to make the animation loop for, zero is disabled

Wind Settings:

Overall Wind Strength
The intensity of the wind to apply to the armature

Wind Gust Strength
The amount of directional movement, (from the positive Y direction)

Wind Gust Frequency
The Frequency of directional movement

Leaf Wind Settings:

Amplitude
Multiplier for noise amplitude

Frequency
Multiplier for noise frequency

Randomness
Random offset in noise

Mesh Generation and Armature Simplification:

Make Mesh
Convert curves to mesh, uses skin modifier, enables armature simplification

Armature Levels
Number of branching levels to make bones for, 0 is all levels

Bone Length
Number of stem segments per bone
set per branching level