
![Generated Tree ](/img/features/extensions/trees/quick1.png)

The function QuickTreeGenerator uses a sphere with randomized vertices to generate a tree. 

A demo can be found at: <Playground id="#LG3GS#107" title="Quick Tree Generator Example" description="Simple example of the quick tree generator."/>

## How to use it.

Clone or copy the file https://github.com/BabylonJS/features/extensions/tree/master/TreeGenerators/QuickTreeGenerator

Before using check your version of BABYLONJS versions 2.2 and earlier require line 8 to be active, comment line 9 instead
BABYLON 2.3 or later leave as is.

call the function

```
var tree = QuickTreeGenerator(sizeBranch, sizeTrunk, radius, trunkMaterial, leafMaterial, scene);
```

## Parameters

sizeBranch - sphere radius used for branches and leaves 15 to 20.

sizeTrunk - height of trunk 10 to 15.

radius - radius of trunk 1 to 5.

trunkMaterial - material used for trunk.

leafMaterial - material for canopies.
 
scene - BABYLON scene. 



# Make the Best use of The Forum

The [Babylon.js forum](https://forum.babylonjs.com) is a fantastic place to get help or help others.
This short page is intended to help you get the best answer as quickly as possible.

## What to do if you have a question for the forum

The best way to get an answer quickly is to follow this 3 easy steps:
- Search about your issue on the [documentation](https://doc.babylonjs.com/search). Maybe the problem you have is just a matter of understanding how the API works?
- Search about your issue on the [forum](https://forum.babylonjs.com/search). Maybe someone else already had the same problem?
- Provide a reproduction of your issue within the [playground](https://playground.babylonjs.com). Questions with a playground are likely to get a answer within the next two hours. It is really hard for the community to help without a repro because of the inner rich nature of JavaScript, WebGL and Babylon.js. Consider this step **mandatory**.


![Generated Tree ](/img/features/extensions/trees/genTree.png)

The function createTree uses the solid particle system to generate a tree. 
A base tree is created consisting of a trunk which forks into branches, which then themselves may fork or not.
This base tree is used in two different ways. 
    1. as the trunk and parent branches for the whole tree.
    2. with leaves added as a mini-tree that is added a number of times to the base trunk and parent branches to form the whole tree.
    
  ![Base Tree to Full Tree Sequence ](/img/features/extensions/trees/baseToFull.png)  
  
  A demo can be found at: <Playground id="#1LXNS9#4" title="SPS Tree Generator Example" description="Simple example of the sps tree generator."/>

## How to use it.

Clone or copy the file https://github.com/BabylonJS/features/extensions/blob/master/TreeGenerators/SPSTreeGenerator/TreeGenerator.js

call the function

```
var tree = createTree(trunkHeight, trunkTaper, trunkSlices, trunkMaterial, boughs, forks, forkAngle, forkRatio, branches, branchAngle, bowFreq, bowHeight, leavesOnBranch, leafWHRatio, leafMaterial, scene);
```

## Parameters

trunkHeight - height of trunk of tree. The initial trunk radius is 1 unit.  
trunkTaper -  fraction of starting radius for the end radius of a branch between 0 and 1.   
trunkSlices - the number of points on the paths used for the ribbon mesh that forms the branch.  
trunk material - the material used on all branches.  
boughs - the number of times the tree will split into forked branches, 1 trunk splits into branches, 2 these branches also spilt into branches.  
forks -  the number of branches a branch can split into, 5 or more really slows the generation.  
forkAngle - the angle a forked branch makes with its parent branch measured from the direction of the branch.  
forkRatio - the ratio of the length of a branch to its parent's length, between 0 and 1.  
branches - the number of mini-trees that are randomally added to the tree.  
branchAngle - the angle the mini-tree makes with its parent branch from the direction of the branch.  
bowFreq - the number of bows (bends) in a branch. A trunk is set to have only one bow.  
bowHeight - the height of a bow from the line of direction of the branch.  
leavesOnBranch - the number of leaves to be added to one side of a branch.  
leafWHRatio - width to height ratio for a leaf between 0 and 1, closer to 0 longer leaf, closer to 1 more circular.  
leafMaterial - material used for all leaves.  
scene - BABYLON scene.  

## Examples of Results for some Parameters

![Forks and Boughs ](/img/features/extensions/trees/forks.png)

![Fork Angles ](/img/features/extensions/trees/forkAngle.png)

![Bows and Slices ](/img/features/extensions/trees/bows.png)

![Leaf Ratio ](/img/features/extensions/trees/leafRatio.png)

Quick Tree - Extension

How to use it.

Parameters