Modeler Lscript for Lightwave 3D

Previous Page

Page 2

TreeCage Manual 2




 Trunk miscelaneous and Prunning Off options.


Bole none, +1 and +2

Allow Building big trunk with smaller branches by multiplying side number of first polygon and segments.

x2 : Insert one side per side, 3 -> 6 and 4 -> 8 sides.
x3 : Insert two sides per side, 3 -> 9 and 4 -> 12 sides.

Cage and Meta Bulge

Bulge :
Create a bulge, only fo "Bole x3".

Start Reduce From :
This is "Trunk Section" or "Octave" step quantity to reduce one "Bole" added sides.

9 -> 6 -> 3 sides or 12 -> 8 -> 4 sides.

Higher number = no reducing action.




Decal Branching :
Branch Division will be one side decaled at each octave.
This will not work with "Bole Reduction".



When enabled, build a prior segment largest than trunk radius.
This is more expressive with "Bole" actived.


Height % : Relative to "Length".

Length % : Relative to "Start radius".


Pruning off

Break Division & Length

Breaking branches is a way to build irregular trees by substracting Branch Division or Growth actions in the process.

-This simulate environment and events incidences on the tree growth.
-Result are more various typical tree-specie with more chaotic Branch Distribution (i.e. "Full" and "Break division").




Break Division :
Alternate a sequence of successive breaking action and a sequence of regular Branch Division.
In this case all the branch will disapear( not build!).


Quantity :
This the maximum quantity of breaking action for a tree.

Break Area :
Which part of tree are affected by breaking action :
Trunk ,Branch or Both .



Max Group :
This is a maximum for random group of successive breaking action.

Max Interval :
This is a maximum for random interval with no breaking action.

Break Length :
Same options as Above, "Break Division"
In this case the Branch Division is build but there is no Growth and no further Branch Division.

Break Division, Quantity, Break Interval, Break Area, Max Interval and Max Group ( see above "Break Division" ).


Trunk :
This will enable breaking trunk action.

Max Octave :
Last octave before breaking it, must be smaller than "Octave" in Main panel to be effective .



Growth Morph Target

Growing trees...?!

After building process, TreeCage will begin a "back-growing process" for each segment from top to ground; TreeCage will save a morph target lwo file for each step, numbered from ground to tree top.


Base Name :
Choose directory and generic name for lwo files, TreeCage will add digits and "lwo" extension.

Growth Scale :
Radius scale of first polygon for Tree000.lwo ( Anchor Object ) in relation with base trunk radius at the end of growth process.
This scale factor is progressive and simulate each step of growth, for each Morph Target.

Note :
-Growth Morph Targets are only first material to build growing animation.

-Any "Morph/Gizmo/MorphMixer" keys must be set in "linear" mode.

-High "Octave" and more "Segments" will produce more Target Files, and because of "Growth Scale", remember that each Target contain same number of points. So it is preferable to metaform or to subpatch after morphing.



Foliage Type

Disabled/Enabled : Don't forget checking the box !

Foliage Type
Build-in simple Mesh-Object or Custom Mesh Object, will be scaled, rotated and moved to branch position reference.


Build-in Leaves

Individual leaf model to be cloned on the tree.

Tri : Basic cheap one triangle polygon
Quad : Basic cheap one rectangle polygon
Hexa : Basic Hexagon shape with 6 polygons
*.lwo : Custom Object file.

Custom leaf model must be aligned along the Z+ axe,
origin is the beginning of the leaf's stem
( stem can be also included or mapped in the mesh ).


Mesh-Primitives for simulating group of leaves with clip map texture.


Needles : Special Mesh-Object to simulate needles row around each branches, with clip map texture as underwater procedural or any else Texture you want.

Cluster and Clip map

Clusters : Special Mesh-Object to simulate approximate foliage with clip map texture as vein procedural.

Points : Simple Point polygon.

Object File :
Choose Directory and lwo Object file name to load as leaf or cluster.


Last Octave
Level :
"Octave" and "trunk "section covered with foliage, from top to ground.

Max Radius
Radius m :
Maximum branch or trunk radius to cover with foliage.



Foliage Distribution


- Perpendicular/Alternate
- Lateral/Alternate
- Lateral/Symmetric

- x2 Alternate
- x4 Symmetric
- x4 Aternate

Perpendicular :
Leaves are perpendicular to branches.

Lateral :
Leaves are aligned along branches.


Alternate :
Alternate Leaves position and Leaves group rotation.

Symmetric :
Same Leaves position and Leaves group rotation.


Length m : Length of "Leaves" or global dimension for "Clusters".

Width m : Width of "Leaves", "Width" option will be ignored for lwo object file, to avoid shape alteration.



Radius m : Radius of "Cluster" pseudo-sphere or "Custom Cluster".

Merge m : Distance to merge point position before Foliage process to build low-res foliage.


Common to "Leaves" and "Others" :

Angle °(+/-) : Add random angle to Mesh-Object.

Scale °(+/-) : Add random scale factor to initial Mesh-Object size.

Interval m : Distance between each "Leaves" / "Needles" group.

Multiply : "Leaves" / "Needles" quantity per group.

Exclude % : Beginning branch part which is not covered with foliage.

Leaves Tropism


Tropism %
Constant value.

Positive value : This will add gravity to "Leaves" / "Needles".
Negative value :
This will add heliotropisme to "Leaves" / "Needles".

Needles Length m : "Needles" length emerged from bark, but this is the polygon width.

- Needles
- 4x Rescale Level & Tropism

Without Rescale, "Needles Length" will be constant for all branches.

Level : Rescale "Needles Length" in relation with (Octave) "Level",lower "Needles Length" at the end.
Radius : Rescale "Needles Length" in relation with branch or trunk radius, lower "Needles Length" at the end.


Foliage Data

TreeCage can build foliage in a post-process with position referenced in a "Foliage Data" library.

Branch position data and several necessary informations are saved and loaded to/from "Ascii" TreeCage Foliage file.
TreeCage process
must be achieved to generate Foliage File.

By using this reference, Foliage are build without repeating trunk and branches building process. This is useful to experiment different Foliage parameters set for the same tree.


Load :
This will load a pre-saved Foliage file.

To Save :
This command TreeCage to save Foliage Data in a file when main tree process will be achieved .

To Keep : This command Treecage to keep actual loaded Foliage Data as reference.
So Main Panel is reduced to its "light" version.
"TreeCage Will Only Build Foliage From Loaded Data !"

Foliage File : Choose directory and Foliage file name.





All "+/-" parameters and "breaking" actions will add or substract random value to initial value, so with same parameters result trees belong to the same family-specie but are not identical.
You can inhibit randomizing with a "0" value for some "+/-" options, but parameter will be constant and produce too regular or less expressive trees.

TreeCage introduce Random Sequence system to freeze parameters.



True Random : A new one random number is generated just before each action, this is the default process for building not replicable tree.

Repeat Sequence : TreeCage Picks one pre-generated random number in a Looping Random Sequence library.
Preserve random variability during Growth/Division process; result trees with
same parameters and same Random Sequence will be identical.

see File Panel for saving/loading to/from TreeCage file.



Keep Previous : If Random Sequence exist, use it in process.
New Sequence : This is for generate a new Random Sequence.


Random Sequence Size :
The random value quantity to generate in the new Random Sequence or the random value quantity of the actual Random Sequence.




All parameters data can be saved and loaded to/from "Ascii" TreeCage file, with or without Random Sequence.

Load :
Choose directory and TreeCage file name to load,
Actual Parameters will be lost and replaced by TreeCage File data.

Load Random Sequence :
Allow to retrieve pre-saved Random Sequence ( if exist ! ) in TreeCage file.

Save :
Choose directory and TreeCage file name to load.

Save Random Sequence :
Allow to save Random Sequence, you need first to generate it before.
Hazard Panel.


After each ( computed ) TreeCage session, a temporary file
is saved in your default Lightwave directory.

If temporary file is detected, TreeCage will ask you for reloading
your previous parameters or for reseting all values to default.

TreeCage temporary file is usefull in testing mode, however "Morph Panel" must be re-actived and Foliage File re-loaded after each TreeCage session.
Custom files name are stored in memory (Except: "Morph Target name").

 End Manual

Copyright © 2001 Denis Pontonnier.