---
title: Add feature vertices
product: SpeedTree Modeler
version: '10'
latest_version: '10'
status: This page documents version 10. The latest version is 10.
canonical: https://docs.unity.com/en-us/speedtree-modeler/10/add-feature-vertices
latest_url: https://docs.unity.com/en-us/speedtree-modeler/10/add-feature-vertices.md
last_updated: 2026-11-19
generated_at: 2026-11-19T15:06:08.677Z
locale: en-us
---

# Add feature vertices

> Paint feature vertices by hand or use the material to add them to the branch geometry.

[Feature vertices](./feature-vertices.md) emphasize fine surface details that regular branch geometry might miss, such as pockets in a displacement map. Add them by hand for precise control, or generate them automatically using a material for broader coverage.

## Paint feature vertices by hand

If you're focusing on only a few areas where you need to reveal the details of a displacement map (e.g., a low spot on the trunk), painting feature vertices by hand makes the most sense.

To paint feature vertices by hand, refer to [Vertex features](./vertex-features.md).

## Use the material to add feature vertices

If you need to add feature vertices in many places where the displacement exists, use the material asset to assign them. The following sections detail the steps in this process.

### Create and assign the heightmap

Make sure your branch map has the height map assigned. The heightmap should provide distinct pockets of high and low displacement: features that need to be emphasized with geometry.

> **Note:**
>
> The best heightmaps for this task are often blurred versions of scanned data, hand-painted displacements, or a combination of both.

### Add cutouts to the asset

For each feature in the heightmap, [add a cutout mesh](./create-a-mesh-cutout.md) to the material. Place vertices around the feature, making sure to identify the perimeter (usually low points around the feature) and the peaks (high points inside the feature). You can use the **Tessellation** option in the [Cutout Editor](./cutout-editor.md) to dynamically add and remove detail as necessary.

Each cutout mesh will be used on any branch that uses this material. Only the vertices will be used. The triangulation is redone by the branch as part of its computation process. The screenshots below show several feature vertex cutouts applied to an example heightmap.

![A heightmap with a cutout created on a feature.](/api/media?file=speedtree-modeler/10/media/images/feature-vertices-heightmap1.png)
![A heightmap with a cutout created on a feature.](/api/media?file=speedtree-modeler/10/media/images/feature-vertices-heightmap2.png)
![A heightmap with a cutout created on a feature.](/api/media?file=speedtree-modeler/10/media/images/feature-vertices-heightmap3.png)

### Enable feature vertices on the branches

For every Branch generator that uses the material, you need to enable feature vertices in order to see them. To do this, enable the property **Segments:Features:Mesh:Enabled** on the Branch generators where you wish to use feature vertices.

> **Note:**
>
> Only enable feature vertices on generators that you know will make a big difference. The polygon count will go up on these generators, sometimes significantly.

### Set the displacement

The final step is to make sure the feature vertices go where you expect them to. Make sure that the Branch generator's displacement source is the material, that it's using the UV coordinates to place it, and that the U and V scales are set to 1.0. The following screenshot shows the correct Branch generator settings.

![The Displacement drop down of the Branch generator.](/api/media?file=speedtree-modeler/10/media/images/feature_displacement_settings.png)

Adjust the **Radial amount** value until you achieve the desired look.

## Best practices

Keep the following in mind when using feature vertices:

* The displacement map used should be a little blurry since it will only be sampled at discrete points. Sharp edges can result in undesirable artifacts depending on where the normal vertices of the branch hit the map.
* The displacement map should have small, prominent features to be called out.
* Make sure you only enable feature vertices on branches that benefit substantially from them. Usually the trunk and first two levels at most.
* Hand painting works well for close up shots.
* Material-based features vertices work well for creating interesting branch silhouettes in midground applications.
