llSetGroundTexture

From Second Life Wiki
Jump to navigation Jump to search

Summary

Function: llSetGroundTexture( list changes );
0.0 Forced Delay
10.0 Energy

Changes the textures used to paint the terrain of a region. The owner of the script must be able to manage the estate.

• list changes List of changes to apply to ground textures on the region.

Constant Format Description
TERRAIN_DETAIL_1 0 [ TERRAIN_DETAIL_#, texture_id ]

Sets the texture to use for the current terrain detail layer. texture_id must be the UUID of a texture or material, or the name of a texture or material in the object's inventory.

Passing NULL_KEY or an empty string will set the terrain texture to the default.

TERRAIN_DETAIL_2 1
TERRAIN_DETAIL_3 2
TERRAIN_DETAIL_4 3
TERRAIN_HEIGHT_RANGE_SW 4 [ TERRAIN_HEIGHT_RANGE_XX, float low, float high ]

Sets the height range for terrain for texture blending in the region. low is the maximum height for texture 1 and high is the minimum height for texture 4, textures 2 and 3 will mix in between these values.

TERRAIN_HEIGHT_RANGE_SE 5
TERRAIN_HEIGHT_RANGE_NW 6
TERRAIN_HEIGHT_RANGE_NE 7
TERRAIN_PBR_SCALE_1 8 [ TERRAIN_PBR_SCALE_#, vector uv_scale ]

Sets the UV scale used for each layer's terrain texture in repeats per meter.

  • The Z value of the vector is ignored.
  • Only works for PBR textures.
TERRAIN_PBR_SCALE_2 9
TERRAIN_PBR_SCALE_3 10
TERRAIN_PBR_SCALE_4 11
TERRAIN_PBR_ROTATION_1 12 [ TERRAIN_PBR_ROTATION_#, float rotation ]

Rotates the PBR texture for each layer.

  • Only works for PBR textures.
TERRAIN_PBR_ROTATION_2 13
TERRAIN_PBR_ROTATION_3 14
TERRAIN_PBR_ROTATION_4 15
TERRAIN_PBR_OFFSET_1 16 [ TERRAIN_PBR_OFFSET_#, vector uv_offset ]

Sets the UV offset for drawing each terrain layer.

  • The Z value of the vector is ignored.
  • Only works for PBR textures.
TERRAIN_PBR_OFFSET_2 17
TERRAIN_PBR_OFFSET_3 18
TERRAIN_PBR_OFFSET_4 19

Caveats

  • This function must be executed from a script in an object owned by the region owner or an estate manager.
  • This function is throttled at 4 calls every 2 minutes.
  • PBR terrain is all or nothing. Mixing normal terrain textures with PBR textures will cause the PBR textures to appear gray.

Examples

See Also

Functions

•  llModifyLand Modifies terrain contours.

Deep Notes

Signature

function void llSetGroundTexture( list changes );