Tree Creator Structure
Manual     Reference     Scripting   
Reference Manual > Tree Creator Guide > Tree Creator Structure

Tree Creator Structure

Desktop

The Tree Creator's inspector is split into three different panes: Hierarchy, Editing Tools and Properties.

Hierarchy

The hierarchy view is where you start building your tree. It shows a schematic representation of the tree, where each box is a group of nodes. By selecting one of the groups in the hierarchy you can modify its properties. You may also add or remove groups by clicking one of the buttons in the toolbar below the hierarchy.

This hierarchy represents a tree with one trunk, 25 child branches. Child branches have in total 70 fronds attached, 280 leaves and 25 fronds with branches. Node representing the last group is selected. Also the trunk has 25 leaves of one type and 15 of another type, the last group is hidden.

Tree StatsStatus information about your tree, tells you how many vertices, triangles and materials the tree has.
Delete NodeDeletes the currently selected group in the Hierarchy or a node or a spline point in the Scene View.
Copy NodeCopies the currently selected group.
Add BranchAdds a branch group node to the currently selected group node.
Add LeafAdds a leaf group node to the currently selected group node.
External ReloadRecomputes the whole tree, should be used when the source materials have changed or when a mesh used in Mesh Geometry Mode on leaves has changed.

Nodes in the tree hierarchy represent groups of elements in the tree itself, i.e. branches, leaves or fronds. There are 5 types of nodes:

Root Node:

This is the starting point of a tree. It determines the global parameters for a tree, such as: quality, seed to diversify the trees, ambient occlusion and some material properties.

Branch Nodes


First branch group node attached to the root node creates trunk(s). The following branch nodes will create child branches. Various shape, growth and breaking parameters can be set on this type of node.

Leaf Node


Leaves can be attached to a root node (e.g. for small bushes) or to branch nodes. Leaves are final nodes, meaning no other nodes can be attached to them. Various geometry and distribution parameters can be set on this type of a node.

Frond Node


It has a similar behavior as the branch node, with some of the shape properties disabled and frond specific ones added.

Branch + Frond Node


This kind of node is a mixture of a branch and a frond, with properties of both types being accessible.

Node Parameters

  • Number at the top right of each node represents the number of elements this node created in the tree. The value is related to the frequency parameter from the Distribution tab.
  • A node can be visible () or invisible ().
  • If a node was edited manually (branch splines or leaves were manipulated in the Scene View) a warning sign will appear over the node (). In such a case some procedural properties will be disabled.

Editing Tools



While the Tree Creator works with procedural elements, you can decide at any time to modify them by hand to achieve the exact positioning and shape of elements you want.

Once you have edited a group by hand, certain procedural properties will no longer be available. You can, however, always revert it to a procedural group by clicking the button displayed in the Branch/Leaf Group Properties.

MoveSelect a node or a spline point in the Scene View. Dragging the node allows you to move it along and around its parent. Spline points can be moved using the normal move handles.
RotateSelect a node or a spline point in the Scene View. Both will show the normal rotation handles.
Free Hand DrawingClick on a spline point and drag the mouse to draw a new shape. Release the mouse to complete the drawing. Drawing always happens on a plane perpendicular to the viewing direction.

Global Tree Properties

Every tree has a root node which contains the global properties. This is the least complex group type, but it contains some important properties that control the rendering and generation of the entire tree.

Distribution

Allows for diversifying trees by changing the Tree Seed and making groups of trees by adjusting the Area Spread when the frequency on the branch node connected to the root node is higher than 1.

Tree SeedThe global seed that affects the entire tree. Use it to randomize your tree, while keeping the general structure of it.
Area SpreadAdjusts the spread of trunk nodes. Has an effect only if you have more than one trunk.
Ground OffsetAdjusts the offset of trunk nodes on Y axis.

Geometry

Allows to set the overall quality of the tree geometry and to control ambient occlusion.

LOD QualityDefines the level-of-detail for the entire tree. A low value will make the tree less complex, a high value will make the tree more complex. Check the statistics in the hierarchy view to see the current complexity of the mesh. Depending on the type of the tree and your target platform, you may need to adjust this property to make the tree fit within your polygon budget. With careful creation of art assets you can produce good looking trees with relatively few polygons.
Ambient OcclusionToggles ambient occlusion on or off. While modifying tree properties ambient occlusion is always hidden and won't be recomputed until you finish your changes, e.g. let go a slider. Ambient occlusion can greatly improve the visual quality of your tree, but its computation takes time, so you may want to disable it until you are happy with the shape of your tree.
AO DensityAdjusts the density of ambient occlusion. The higher the value the darker the effect.

Material

Controls the global material properties of the tree.

Translucency is one of the effects you can control in the Material properties. That property has an effect on leaves, which are translucent meaning that they permit the light to pass through them, but they diffuse it on the way.

Translucency ColorThe color that will be multiplied in when the leaves are backlit.
Translucency View DependencyFully view dependent translucency is relative to the angle between the view direction and the light direction. View independent is relative to the angle between the leaf's normal vector and the light direction.
Alpha CutoffAlpha values from the base texture smaller than the alpha cutoff are clipped creating a cutout.
Shadow StrengthMakes the shadows on the leaves less harsh. Note: Since it scales all the shadowing that the leaves receive, it should be used with care for trees that are e.g. in a shadow of a mountain.
Shadow OffsetScales the values from the Shadow Offset texture set in the source material. It is used to offset the position of the leaves when collecting the shadows, so that the leaves appear as if they were not placed on one quad. It's especially important for billboarded leaves and they should have brighter values in the center of the texture and darker ones at the border. Start out with a black texture and add different shades of gray per leaf.
Shadow Caster ResolutionDefines the resolution of the texture atlas containing alpha values from source diffuse textures. The atlas is used when the leaves are rendered as shadow casters. Using lower resolution might increase performance.

Branches

This section focuses on explaining the specific Branch Group Properties.

Leaves

This section focuses on explaining the specific Leaf Group Properties.

Page last updated: 2010-09-16