Introduction
Basics

Tutorials
Planting a tree
Making a shader
Adding wind
Adding presets

Reference
Tree
Environment
TDD file format


TDD file format
 

Here is the internal data format used by Tree Druid. It is subject to change, and not all parameters are implemented or documented. This information is provided for experimental use only. Use at your own risk, because editing TDD files by hand can cause your Tree Druid extension to crash!

Angles are, in general, expressed in radians. Most distance/length parameters are expressed in inches. Note that trees are scaled down in Carrara (otherwise, they would dwarf the default working box, and everybody would wonder why). Booleans are 0 or 1.

Comments are delimited with the "#" character. Whitespace is generally ignored.

Note Sorry, no support can be provided for problems with hand-edited TDD files.

Mainstem Parameters  Description  Range/type 
1  Shape  enum 
2  Branch type  enum 
3  Include Tip  boolean (0=false, 1=true) 
4  Tilt  angle in radians 
5  Width Factor   
6  Shape Base Displacement Factor   
7  Taper Angle  angle in radians 
8  Number of Offshoots   
9  Start offshoot branch angle  angle in radians 
10  End offshoot branch angle  angle in radians 
11  Initial Spacing   
12  Spacing reduction   
13  Internode twist   
14  Aligned with ground  boolean (0=false, 1=true) 

Bough Parameters  Description  Range/type 
15  Shape  enum 
16  Branch Type  enum 
17  Include Tip   
18  Tilt  angle in radians 
19  Width Factor   
20  Shape Base Displacement factor   
22  Taper Angle  angle in radians 
23  Number of Offshoots   
24  Start Offshoot branch angle  angle in radians 
25  End offshoot branch angle  angle in radians 
26  Initial Spacing   
27  Spacing reduction   
28  Internode twist   
29  Aligned with ground  boolean (0=false, 1=true) 

Global Parameters  Description  Range/type 
30  Max recursion  dangerous! 
31  Min length   
32  Min width   
33  Tree height  in inches 
34  Erraticness  0.0 - 1.0 
86  Gnarledness  0.0 - 1.0 

Mesh Parameters  Description  Range/type 
35  Kill ray bug  obsolete, use 0. 
36  Modeling quality   
37  Min branch sides   
38  Max branch sides   
39  Min branch segments   
40  Max branch segments   
41  Hidden branches  boolean (0=false, 1=true) 
42  Fidelity   
43  Trunk extra detail   
44  Trunk segments   
85  Allow junk  obsolete, use 0. 
NoteSome mesh parameters are overridden by Carrara sliders (e.g. the Fidelity slider), and so changing them in the TDD file may have no effect.

Trunk Parameters  Description  Range/type 
45  Include roots  boolean (0=false, 1=true) 
46  Trunk Taper  angle in radians 
47  Trunk Tilt  angle in radians 
48  Base Extension   
49  Trunk height  in inches 
50  NumRoots  integer 
51  Root Pronouncement   
52  Crown Base Factor   
87  Mainstem base radius  in inches 

Gravity Parameters  Description  Range/type 
58  Applies  boolean (0=false, 1=true) 
53  Strength  0.0 - 1.0 
54  Mainstem suppleness  0.0 - 1.0 
55  Bough suppleness  0.0 - 1.0 
56  Limb suppleness  0.0 - 1.0 
57  Leaf suppleness  0.0 - 1.0 

Wind Parameters  Description  Range/type 
71  Applies  boolean (0=false, 1=true) 
65  Strength  0.0 - 1.0 
70  Direction  angle in radians 
66  Mainstem suppleness  0.0 - 1.0 
67  Bough suppleness  0.0 - 1.0 
68  Limb suppleness  0.0 - 1.0 
69  Leaf suppleness  0.0 - 1.0 

Sunlight Parameters  Description  Range/type 
64  Applies  boolean (0=false, 1=true) 
59  Strength  0.0 - 1.0 
60  Mainstem suppleness  0.0 - 1.0 
61  Bough suppleness  0.0 - 1.0 
62  Limb suppleness  0.0 - 1.0 
63  Leaf suppleness  0.0 - 1.0 

Leaf Parameters  Description  Range/type 
72  Include leaves  boolean (0=false, 1=true) 
73  Leaf shape  enum (0=tip_first, 1=base_first, 2=diamond, 3=rectangle, 4=spray, 5=clump, 6=fin) 
75  Leaf length  in inches 
76  Leaf width  in inches 
77  Leaf density  0.0 - 1.0 
74  Amount covered  0.0 - 1.0 
78  Kink  angle in radians 
79  Deflection  angle in radians 
80  Twist  angle in radians 
81  Whorl Size  integer 
82  Branch Distance  in inches 
83  Leaf on Tip  boolean (0=false, 1=true) 
84  Align with Branch  boolean (0=false, 1=true)