Home - abpy/improved-sapling-tree-generator GitHub Wiki
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