Version: 2021.2
SpeedTree Import Settings window
Materials tab

Model tab

SpeedTree Importer Model tab
SpeedTree Importer Model tab

The Model tab of the SpeedTree Import Settings window contains these sections:

(A) The Meshes section allows you to set the Scale Factor value to apply a global scale on the imported SpeedTree Model. By default, Unity sets this value to 0.3048 (the conversion ratio for feet to meters) because SpeedTree Models generally use 1 foot per unit, and Unity uses 1 meter per unit.

(B) The Materials section allows you to set the Main Color value, which modulates the diffuse lighting component, and the Hue Color, which Unity uses when the Hue Variation effect is enabled. If your SpeedTree Model contains BillboardA textured 2D object that rotates so that it always faces the Camera. More info
See in Glossary
Assets, the Alpha Cutoff property also appears. Unity uses the alpha cutoff (or reference value) to compute the values it needs to preserve alpha MIP map coverage on Textures.

(C) The LODs section contains a specialized variation of the LOD GroupA component to manage level of detail (LOD) for GameObjects. More info
See in Glossary
component for importing SpeedTree Models. You can set smooth transitions between LOD levels, adjust thresholds for each LOD level, and use the LOD Options to turn off resource-heavy effects on each LOD level.

(D) The Revert and Apply buttons always appear, but you can only select them after you make changes to the settings on the Model tab. If you change settings on both the Material mapping and the Model tab, the Apply & Generate Materials button appears. If you only change settings on the Material mapping, the Regenerate Materials button appears.

(E) The properties for the GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary
(read-only) appear at the bottom of the InspectorA Unity window that displays information about the currently selected GameObject, asset or project settings, allowing you to inspect and edit the values. More info
See in Glossary
view, including a preview of the SpeedTree Model with its Material applied.

LODs and their options

Note: This section assumes you have already read the documentation on the LOD Group component. Please read it if you haven’t already; especially the section on Working with SpeedTree Models. It explains key concepts and workflow information that are crucial for understanding how to import SpeedTree Models.

The LODsThe Level Of Detail (LOD) technique is an optimization that reduces the number of triangles that Unity has to render for a GameObject when its distance from the Camera increases. More info
See in Glossary
and LOD Options sections manage level of details (LOD) for importing Model filesA file containing a 3D data, which may include definitions for meshes, bones, animation, materials and textures. More info
See in Glossary
created in SpeedTree. When the importer detects a SpeedTree Asset, it automatically sets the LOD Fade Mode to Speed Tree.

The LOD Group component for the SpeedTree Model Importer is different from the generic LOD Group component that appears on a SpeedTree instance in Unity:

  • The Fade Mode drop-down menu is not available, because the Fade Mode is already set to Speed Tree.
  • The playhead for the preview is missing, because you cannot preview the LOD transitions in the SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
    See in Glossary
    view before importing.
  • There are four options which control whether and how cross-fading happens: Smooth LOD, Animate Cross-fading, Crossfade Width, and Fade Out Width. Only Smooth LOD is always available.
  • Each LOD level has its own set of options that allow you to enable or disable resource-heavy effects, such as shadow casting or receiving, and wind quality.
LODs with LOD Group selection bar and LOD Options section
LODs with LOD Group selection bar and LOD Options section

The LODs group, the LOD Group selection bar, and the LOD Options group are tightly integrated and inter-dependent:

(A) To set smooth transitions between LOD levels, enable the Smooth LOD option. When you enable Smooth LOD, another setting appears underneath it, called Animate Cross-fading. For more information about this property, see Customizing the transition zone. This is enabled by default.

Use Animate Cross-fading
Use Animate Cross-fading

If you disable Animate Cross-fading, two more settings appear: Crossfade Width and Fade Out Width. For more information on what these settings do, see Setting smooth transitions.

Use Crossfade Width and Fade Out Width
Use Crossfade Width and Fade Out Width

These are global settings for the entire GameObject, meaning they don’t change as you move between different LOD levels.

(B) Use the LOD Group selection bar to select a specific LOD level and access its LOD Options. You can also adjust the LOD level boundaries; to do this, drag the left border of a LOD level box’s boundary.

(C) Use the LOD Options section to enable or disable level-specific effects to optimize performance.

Setting smooth transitions

Smooth transitions require a blend between levels, so that as the current LOD fades out, the next LOD fades in.

You don’t need to set up blending between two MeshThe main graphics primitive of Unity. Meshes make up a large part of your 3D worlds. Unity supports triangulated or Quadrangulated polygon meshes. Nurbs, Nurms, Subdiv surfaces must be converted to polygons. More info
See in Glossary
LOD levels, because SpeedTree Models always use the Speed Tree mode. However, even SpeedTree Models use cross-fading for the last Mesh LOD level (with the lowest resolution) and the Billboard level. For these levels, you can choose to animate cross-fading by time or position.

To use smooth transitions, follow these instructions:

  1. Enable the Smooth LOD option. The Animate Cross-fading option appears below it, enabled by default.
  2. If you want to animate the cross-fading by time, enable the Animate Cross-fading option. If you want to specify a position-based transition zone, disable the Animate Cross-fading option and define the following:
    • Set the Crossfade Width property to specify what proportion of the last LOD level to use as the transition zone. For example, if you want to delay the cross-fading until halfway through the level, set this property to 0.5.
    • Set how long it takes the final level to fade out by setting a proportion with the Fade Out Width property.
  3. If you want to optimize performance, use the LOD Group selection bar to disable selected features on each LOD level.

Using the LOD Group selection bar

The LOD Group selection bar represents the different LOD levels as colored boxes. When a level box is selected, a blue outline appears around it:

The LOD Group selection bar
The LOD Group selection bar

The percentage that appears in each LOD level box represents the threshold at which that level becomes active, based on the ratio of the GameObject’s screen space height to the total screen height.

To select a level, click on the level box. To change the percentage value for a level, drag the boundary to the left of the level container. You can also customize which LOD Options are enabled or disabled on each level, as an optimization strategy.

LOD Options

For each LOD level defined on your SpeedTree Asset (tree), you can customize a variety of properties.

Many of these settings come with an increased performance overhead. To improve performance, you can enable the more costly effects only on the Trees that are nearest to the CameraA component which creates an image of a particular viewpoint in your scene. The output is either drawn to the screen or captured as a texture. More info
See in Glossary
, and disable them on some of the less detailed LOD levels. For example, if your Tree has three LOD levels, you could enable shadow casting and receiving, subsurface scattering, normal mapping, and wind quality on the first two LOD levels, but disable it on the third. This way, the costly effects are disabled where the Models are far enough away from the Camera that the absence of this effect is not noticeable.

To set LOD Options on a specific LOD level, click the LOD level box on the LOD Group selection bar. The following options appear for that LOD level:

Property: Description:
Cast Shadows Enable this option if you want the Tree to cast shadows.
Receive Shadows Enable this option if you want the Tree to receive shadows from other GameObjects in your Scene.
Use Light Probes Enable this option if you want the Tree to use Light ProbesLight probes store information about how light passes through space in your scene. A collection of light probes arranged within a given space can improve lighting on moving objects and static LOD scenery within that space. More info
See in Glossary
rendering
.
Normal MapA type of Bump Map texture that allows you to add surface detail such as bumps, grooves, and scratches to a model which catch the light as if they are represented by real geometry.
See in Glossary
Enable this option if you want to use a Bump mapAn image texture used to represent geometric detail across the surface of a mesh, for example bumps and grooves. Can be represented as a heightmap or a normal map. More info
See in Glossary
on the Tree.
Enable Hue Variation Enable this option to adjust the color between the Main Color and Hue Color values.
The color of each Tree is randomly varied (based on the world space position) towards this Hue Variation color, to break up a large forest of Trees and make it look more natural.
Enable Subsurface Enable this option to use subsurface scattering effects. This setting controls the light scattered out the back side of leaves and other two-sided SpeedTree materials.
Wind Quality Choose the level of wind quality to use for this Asset.
None Off (no control).
Fastest Lowest quality.
Faster Lower quality.
Better Better quality.
Best Best quality.
Palm Only available on palm-like Trees.
SpeedTree Import Settings window
Materials tab