Modeler Lscript for Lightwave 3D

---

	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 .

	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.

	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.

-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.