PBR Terrain

	Warning! Future feature
	This function will be supported in the upcoming Materials Featurette Project. Currently it will only work in supported testing areas with a supported test viewer.

What is it?

The PBR Terrain project brings PBR materials to the Terrain in Second Life.

This viewer is a prototype. Safety not guaranteed.

How to apply PBR Terrain

Before you can apply PBR terrain, you will need to acquire some PBR material items.

A PBR region is not required, but PBR terrain will only be visible to other users who also are using the PBR terrain viewer.

Method 1: Use the Region/Estate tool (requires region terrain edit permission)

1. Click World > Region/Estate > Terrain
2. Click on Terrain Textures and set the drop-down to Material Textures
3. Set PBR materials for all four material swatches
4. Click Apply
5. To go back to using terrain textures, remove all PBR materials, set the drop-down to Terrain Textures, and apply the desired textures

Method 2: Use the debug settings (not persistent, visible only to you, debug settings subject to removal)

1. Click Advanced > Show Debug Settings
2. Copy the material UUID you want from your inventory to your clipboard
3. Set LocalTerrainAsset1, LocalTerrainAsset2, etc to the material UUIDs you want to use
4. To go back to using the real terrain textures/materials, set LocalTerrainAsset1, LocalTerrainAsset2, etc all back to their defaults, or restart your viewer

Texture Transforms

	Warning! Future feature
	This function will be supported in the upcoming GLTF Development Project. Currently it will only work in supported testing areas with a supported test viewer.

Custom texture transforms can be applied to PBR terrain, allowing for custom scale, rotation, or offset. There is one texture transform per material swatch (4 total). Applying a texture transform to each individual texture info is not supported.

The transforms are thus compliant with a subset of the KHR_texture_transform specification. The UV origin is defined as the Southwest corner of the region, with positive U facing East and positive V facing South.

Method 1: Use the Region/Estate tool (requires region terrain edit permission)

1. Coming soon

Method 2: Use the debug settings (not persistent, visible only to you, debug settings subject to removal)

1. Click Advanced > Show Debug Settings
2. Important: Ensure LocalTerrainAsset1, LocalTerrainAsset2, etc are set to valid materials (Local terrain texture transforms will not affect the persistent region terrain, even if the region terrain uses PBR)
3. Look for debug settings prefixed with, "LocalTerrainTransform", and set their values as desired. For example, LocalTerrainTransform1Rotation sets the rotation for material 1.
4. To go back to using the respective default texture transforms, set the respective settings to their defaults

Graphics support

Emissive texture

When possible, PBR terrain respects all parameters of version 1.1 of the SL Material asset, with the exception of double-sided.

On graphics drivers that do not support binding more than 16 textures, the emissive textures will be dropped, in accordance with the GLTF specification.

Other textures

Further terrain textures may be dropped at low graphics settings to maintain performance.

Triplanar mapping

Triplanar mapping is enabled by default on PBR terrain when the graphics quality setting is set to "High" or higher.