Legacy Documentation: Version 5.0
Height Tools
Trees

Textures

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

You can add texture images to the surface of a terrain to create coloration and fine detail. Since terrains are such large objects, it is standard practice to use a texture that repeats seamlessly and tile it over the surface (the repeat generally isn’t noticeable from a character’s viewpoint close to the ground). One texture will serve as the “background” image over the landscape but you can also paint areas of different textures to simulate different ground surfaces such as grass, desert and snow. The painted textures can be applied with variable transparency so you can have a gradual transition between grassy countryside and a sandy beach, for example.

Sand dune terrain with sandy texture
Sand dune terrain with sandy texture

Enabling Textures

The paintbrush button on the toolbar enables texture painting.

Initially, the terrain will have no textures assigned for painting. If you click the Edit Textures button and select Add Texture from the menu, you will see a window where you can set a texture and its properties.

Depending on the material type you set in Terrain Settings, the color channels of the main texture map may have different uses.

Add Texture window (Standard)
Add Texture window (Standard)

Standard: RGB channels are the albedo color of the terrain surface, while alpha channel controls the smoothness. There is also a ‘Metallic’ slider which controls the overall metalness of the surface.

Add Texture window (Diffuse)
Add Texture window (Diffuse)

Diffuse: RGB channels are the diffuse color. Alpha channel is not used.

Add Texture window (Specular)
Add Texture window (Specular)

Specular: RGB channels are the diffuse color. Alpha channel is the gloss map.

Add Texture window (Custom)
Add Texture window (Custom)

Custom: How the splat map is used depends on your custom shader, but usually you want the RGB channels to be the base color.

Besides the main texture map, you can also specify a normal texture for all of the 3 built-in material types. The texture type of the normal texture used here must be ‘Normal Map’ (you can change the texture type of a texture asset in its import settings). Shader code that handles normal map will be turned on only when at least one normal texture is set for the terrain, so you don’t need to pay the performance cost of normal map if you don’t use them.

The Size property (just below the texture boxes) lets you set the width and height over which the image will stretch on the terrain’s surface. The Offset property determines how far from the terrain’s anchor point the tiling will start; you can set it to zero to start the tiling right in the corner. Once you have set the texture and properties to your liking, click the Add button to make the texture available to the terrain.

To make changes to an added terrain texture, select its thumbnail, click the ‘Edit Textures’ button and select ‘Edit Texture…’ from the menu. Or, you can simply double click on its thumbnail. To remove a terrain texture, select its thumbnail, click the ‘Edit Textures’ button and select ‘Remove Texture’ from the menu.

Texture painting

The first texture you add will be used as a “background” to cover the terrain. However, you can add as many textures as you like; the subsequent ones will be available for painting using the familiar brush tools. Below the textures in the Terrain inspector, you will see the usual Brush Size and Opacity options but also an additional option called Target Strength. This sets the maximum opacity value that the brush will build up even if it passes over the same point repeatedly. This can be a useful way to add subtle patches of color variation within a single terrain type to break the monotony of a large, flat area with the same texture tile repeating over and over.

Grass terrain with dirt texture painted on corners
Grass terrain with dirt texture painted on corners
Height Tools
Trees