Modeler Lscript for Lightwave 3D


Page 1

TreeCage version 1.0

"Arboriculturism"
Lscript RT Modeler (5.6 & 6.5B versions)

 


TreeCage Manual

 

MAIN PANEL
--------- Growth --------- Branching ---------Tree Iteration---------Build Options

FILTER PANEL
--------- Branchiness Level Filter

TRUNK PANEL
--------- Trunk--------- Roots--------- Pruning off

MORPH PANEL
--------- Growth Morph Target

FOLIAGE PANEL
--------- Foliage Type---------Foliage Distribution---------Foliage Data

HAZARD PANEL
--------- Hazard

FILE PANEL
--------- File

6.5B FEATURES
--------- Vertex Mapping

 

Legal Stuff

SUBSIDIARY

 

 


MAIN PANEL


Top

Growth

1 Octave 90 Side

Options for general polygon extrusion,
Available for "Trunk Section" and branch "Octave"

+/- :
Max random value added or substracted to parameter's initial value.

 

2 Segments

Segments :
Segment quantity per extrusion.

Start radius m :
Approximate ( Metaformed / Subpatched ) radius for first polygon based on ground to begin.

Top

Min radius m :
This a way to limit branch division, there is no Branch Division if end polygon's radius is smaller than this minimum value.

 

Length m :
Length of polygon extrusion.

Scale % :
Radius scale of extruded polygon (X , Y, Z normal axes).

Bend ° :
Cycling lateral bending, rotation ( Y global ) axe is rotated ( 90, 120 or 180°), before bending for each octave.

Twist :
Torsion effect ( Y normal axe ).

 

No Trop, Heliotrope 1, Gravity 1

Gravity :
Ground (Earth) attraction.

Heliotrope :
Zenith (Sun) attraction.

 

 

 

Trunk Scale % :
This is for reducing radius of trunk only (X and Z normal axes), in relation with common "Scale".

 Waving 75%

 

Waving % :
This is for waving branches, if "Gravity", "Heliotrope" or both are actived.
Waving alternate attraction angle direction, without changing above "tropic" values.
Value is the "Octave" purcentage ( from begin ) where Waving is applied.

Note : Waving is much expressive with more than one segment.


Top

Branching

1 octave 90 side.

Options applied for each "Octave" branch division.

+/- :
Max random value added or substracted to parameter's initial value.

90 and 120

180 and 180+

 

 

Step Angle :
Angle ( Y normal axe ) between each successive branch division.
This
induce also the side number for first polygon and all segments of the tree, and so how many branches, which can be added per branch division.

 

90 : 4-sides polygon, 90° cycle
120 : 3-sides polygon, 120° cycle

180 : 4-sides polygon, 180° cycle result is a plane Tree.
180+ :
Idem 180 + 90° rotation for last branches.

 

Note : 3-sides polygon will make "egg-shaped" cylinder with metaform, but general tree look is currently acceptable.

 

Effect :
Options to create specific or more branches, available for any Branchiness Level.

 

Side :
Basic one-branch division.

Side and Fork

Top

Fork :
One-Forked branch division,.

 

Sym Effect

Sym :
Two symmetric and opposite branch divisions.
"180+ Step Angle"+ "Sym Effect" = Pinetree ?

Full Effect

Top

Full :
All branch divisions (4 or 5 branches see "Step Angle").

 

90-Side Trunk Multiply 2

Trunk Multiply :
Multiply branch division for Trunk Branches only in relation with "Step Angle" and "Effect".

Not available with "Fork-Effect" or "Full-Effect".

Break Middle

Top

Break Middle :
Only available with "Full-Effect" option, it breaks middle branch, so you can build "ternary trees"...

 

Radius % :
Radius scale of begin polygon for new branch,
in relation with previous radius branch.

Angle ° :
Angle between new branch and previous branch.


Top

Tree Iteration

Trunk Section :
Level of beginning trunk section to build, without branch division.

Octave :
Level of branch division, each octave will divide "existent" branches and grove them.


Top

Build Options

Build will launch TreeCage process.
Options will open this 6 next panels :

Filter
Trunk
Morph
Foliage
Hazard
File

Infos : An Options state summary .


FILTER PANEL

Top

Branchiness Level Filter

Filter purcentage applied for each Main Panel parameter,
in relation with Branchiness Level, see graphic.

Initial value and random value are reminded for each Filter channels .
Growth : "Length", "Scale", "Bend", "Twist", "Trope".
Branching : "Scale", "Angle".

 

Trunk : The Ground polygon and trunk section through octave continuity.

First : This is major branches divided from trunk.

Last : All other minor branches.


6.5B FEATURES

Top

Vertex Mapping
Warning :
If you want to use Vertex Mapping, you will need first to
create a default Weight Map or Texture Map in the Modeler, before launching TreeCage.
Except for "Custom Foliage" with their own Vmap.

 

Texture UV Map

If Vmap exist, "Bark", "Leaves" and "Needles" will be mapped ( same Vmap, but different surface name ).

Y planar for "Leaves".
Normal Y cylindar for tiled "Bark" ( 2 surfaces names with "Bole" ).
Y planar for "Needles" and randomized V value to shift tiled texture,
this can be normalized after TreeCge process with some other plugins.

Note : There is some little arrangement for joining UV Map with "120-Step Angle" and "Break Middle".

 

Weight Map
If Vmap exist, all TreeCage will be mapped with value relative to trunk or branch radius, from 0 ( larger polygon ) to higher value ( smallest end polygon ).

This is for further development, but can be used to create manually some wind morph target in Modeler with weight falloff actived.


SUBSIDIARY

-If you like TreeCage Tool , and if you create a natural look tree-specie, want to share it, send it by E-mail :

Object : TreeCage Virtual Nursery

Your name and your country.

A short comment about the tree.

Join your TreeCage File ( without "Random Sequence" ) with an explicite (English or Latin) filename.

-I hope to collect some various specimen in the "TreeCage Virtual Nursery" library.


Legal Stuff :

TreeCage is a freeware,
Please do not distribute or re-post this
Lscript without author's permission.
TreeCage is provided "as is" without warranty of any kind,
either express or implied,
no liability for consequential damages.

 


End Page 1

Next Page


Copyright © 2001 Denis Pontonnier. Denis.Pontonnier@wanadoo.fr