Textures & Materials

Each face of a prim has its own surface. The original (Blinn-Phong) system combines a diffuse texture, color, alpha, normal and specular maps. PBR materials, based on glTF, use base color, normal, metallic-roughness and emissive maps, and can be overridden per face.

The two systems are set separately. Blinn-Phong texture repeats, offsets and rotation are set with PRIM_TEXTURE, PRIM_NORMAL and PRIM_SPECULAR; PBR transforms are set with the PRIM_GLTF_* rules or glTF overrides.

Shape, light, glow and other prim properties live under Prims; texture animation under Effects.

Concepts

Textures: set one by inventory name or key, on any prim, and read it back
- Adjust repeats, offset and rotation; the mapping mode sets how repeats are measured
Colors are vectors from 0.0 to 1.0, set per face
- Alpha runs from 0.0 (invisible) to 1.0
- The alpha mode sets how transparent textures are drawn
Blinn-Phong materials: normal and specular maps, shininess and bump presets add surface detail to the legacy system
- Full bright and glow change how a face is lit
PBR materials: apply a material asset to faces, or override parts of it (base color, alpha, metallic, roughness, emissive) without replacing it
- Check whether a face uses PBR
Reflection probes control what PBR surfaces reflect nearby
Frame animation and scrolling are covered under Effects
A face can show a web page; media settings control the URL, size, controls and who may interact
The changed event reports color, material and media changes

Functions and events

`void`	`llSetTexture(string texture, integer face)`
`void`	`llSetLinkTexture(integer link, string texture, integer face)`
`void`	`llSetColor(vector color, integer face)`
`void`	`llSetAlpha(float alpha, integer face)`
`void`	`llSetRenderMaterial(string material, integer face)`
`void`	`llSetLinkGLTFOverrides(integer link, integer face, list params)`
`void`	`llSetLinkPrimitiveParamsFast(integer link, list rules)`
`integer`	`llSetPrimMediaParams(integer face, list params)`
`event`	`changed(integer changes)`

PBR materials

Setting a render material clears most PRIM_GLTF_* properties on the face, except repeats, offsets and rotation.

Media on a prim

Media functions return a STATUS_* code (PrimMediaError) detailing success or failure.

Scripting Details

`void`	`llSetTexture(string texture, integer face)` Applies the Blinn-Phong diffuse texture to face of the prim.
`void`	`llSetLinkTexture(integer link, string texture, integer face)` Applies texture (UUID or inventory name) to face of the linked prim link.
`string`	`llGetTexture(integer face)` Returns a string representing the Blinn-Phong diffuse texture on face (returns the inventory name if it is a texture in the prim's inventory, or its key UUID otherwise).
`void`	`llScaleTexture(float u, float v, integer face)` Sets the diffuse texture horizontal u and vertical v scales (repeats) on the specified face of the prim. Setting face to ALL_SIDES updates all sides. Negative scale values flip the texture.
`void`	`llOffsetTexture(float u, float v, integer face)` Sets the texture horizontal (u) and vertical (v) offsets for the chosen face. If face is ALL_SIDES, offsets all faces.
`void`	`llRotateTexture(float angle, integer face)` Sets the texture rotation of face to the specified angle (in radians). If face is ALL_SIDES, rotates the texture on all faces.
`vector`	`llGetTextureScale(integer face)` Returns a vector containing the texture scales of face in the X and Y components (Z is unused).
`vector`	`llGetTextureOffset(integer face)` Returns a vector containing the texture offsets of face in the X (horizontal U) and Y (vertical V) components (Z is unused).
`float`	`llGetTextureRot(integer face)` Returns a float representing the texture rotation angle (in radians) on face.
`void`	`llSetColor(vector color, integer face)` Sets the Blinn-Phong diffuse RGB color of face. If face is ALL_SIDES, applies the color to all faces.
`vector`	`llGetColor(integer face)` Returns the Blinn-Phong RGB color vector of face (values between 0.0 and 1.0). If face is ALL_SIDES, returns the mean average of all faces.
`void`	`llSetLinkColor(integer link, vector color, integer face)` Sets the Blinn-Phong diffuse RGB color of face on the linked prim link.
`void`	`llSetAlpha(float alpha, integer face)` Sets the diffuse texture alpha (opacity) of face. If face is ALL_SIDES, applies to all faces. Values are clamped between 0.1 and 1.0 (where 1.0 is fully opaque).
`float`	`llGetAlpha(integer face)` Returns a float representing the Blinn-Phong alpha (transparency) of face. If face is ALL_SIDES, returns the mean average of all faces.
`void`	`llSetLinkAlpha(integer link, float alpha, integer face)` Sets the Blinn-Phong alpha (transparency) of face on the linked prim link.
`void`	`llSetRenderMaterial(string material, integer face)` Applies material (UUID or inventory name) to face of the prim. Note: This clears most PRIM_GLTF_* properties on the face except for repeats, offsets, and rotation.
`void`	`llSetLinkRenderMaterial(integer link, string material, integer face)` Applies material (UUID or inventory name) to face of the linked prim link. Note: This clears most PRIM_GLTF_* properties on the face except for repeats, offsets, and rotation.
`string`	`llGetRenderMaterial(integer face)` Returns a string representing the render material on face (returns the inventory name if it is in the prim's inventory, or its key UUID otherwise).
`integer`	`llIsLinkGLTFMaterial(integer link, integer face)` Checks the specified face on the linked prim link. Returns TRUE if the face material is a PBR render material, or FALSE if it uses Blinn-Phong diffuse textures.
`void`	`llSetLinkGLTFOverrides(integer link, integer face, list params)` Sets or removes individual GLTF override parameters specified by params on face of the linked prim link.
`void`	`llSetTextureAnim(integer mode, integer face, integer sizex, integer sizey, float start, float length, float rate)` Animates the texture on face of the prim by setting its scale and offset. mode defines options, sizex/sizey define frames, start defines the start frame/angle, length defines duration, and rate defines playback speed.
`void`	`llSetLinkTextureAnim(integer link, integer mode, integer face, integer sizex, integer sizey, float start, float length, float rate)` Animates the texture on face of the linked prim link by setting the scale and offset according to mode. Parameters sizex/sizey define frames, start defines the start frame/angle, length defines duration, and rate defines playback speed.
`integer`	`llSetPrimMediaParams(integer face, list params)` Sets the media parameters specified by params on the designated face of the prim. Returns an integer STATUS_* flag detailing success or failure.
`list`	`llGetPrimMediaParams(integer face, list params)` Returns a list containing the media parameters of the specified face, retrieved in the order requested by params. Returns an empty list if no media exists on the face.
`integer`	`llClearPrimMedia(integer face)` Deletes the media and clears all parameters from the specified face. Returns an integer STATUS_* flag detailing the success or failure of the operation.
`integer`	`llSetLinkMedia(integer link, integer face, list params)` Sets the media parameters specified by params on face of the linked prim link without a script delay. Returns an integer STATUS_* flag detailing success or failure.
`list`	`llGetLinkMedia(integer link, integer face, list params)` Returns a list containing the media parameters of the specified face on the linked prim link, retrieved in the order requested by params.
`integer`	`llClearLinkMedia(integer link, integer face)` Deletes the media and clears all parameters from the given face on the linked prim. Returns an integer STATUS_* flag detailing the success or failure of the operation.

Additional

llSetLinkPrimitiveParamsFast — Blinn-Phong face rules
- PRIM_TEXTURE — Diffuse texture, repeats, offsets and rotation
- PRIM_TEXGEN — Mapping mode (PrimTexgen): default or planar
- PRIM_COLOR — Color and alpha, from 0.0 (clear) to 1.0 (solid)
- PRIM_ALPHA_MODE — Blend, none, mask with a cutoff, or emissive (AlphaMode)
- PRIM_NORMAL — Normal map with its own repeats, offsets and rotation
- PRIM_SPECULAR — Specular map plus color, glossiness and environment
- PRIM_BUMP_SHINY — Shininess (PrimShiny) and bump preset (PrimBump)
- PRIM_FULLBRIGHT, PRIM_GLOW — Full-bright rendering and glow intensity
llSetLinkPrimitiveParamsFast — PBR face rules
- PRIM_RENDER_MATERIAL — The material asset on a face
- PRIM_GLTF_BASE_COLOR — Base color, alpha mode (GLTFAlphaMode), alpha cutoff and double-sided; colors in linear space
- PRIM_GLTF_NORMAL — Normal map
- PRIM_GLTF_METALLIC_ROUGHNESS — Occlusion, metallic and roughness
- PRIM_GLTF_EMISSIVE — Emission tint in linear space
- PRIM_REFLECTION_PROBE — Make the object a reflection probe (ReflectionProbeType): box, dynamic or mirror
llSetLinkGLTFOverrides — individual overrides (GLTFOverride), such as OVERRIDE_GLTF_BASE_COLOR_FACTOR, OVERRIDE_GLTF_METALLIC_FACTOR, OVERRIDE_GLTF_ROUGHNESS_FACTOR and OVERRIDE_GLTF_EMISSIVE_FACTOR
llSetPrimMediaParams and llSetLinkMedia — media settings (PrimMediaParam)
- PRIM_MEDIA_CURRENT_URL, PRIM_MEDIA_HOME_URL — Current and home URL
- PRIM_MEDIA_AUTO_PLAY — Play when a resident can view it
- PRIM_MEDIA_PERMS_INTERACT — Who may interact (PrimMediaPerm)
- Navigation controls: standard or mini (PrimMediaControl)
changed — CHANGED_COLOR, CHANGED_TEXTURE, CHANGED_RENDER_MATERIAL, CHANGED_MEDIA

Constant groups

Constant groups PrimTexgen 2 AlphaMode 4 PrimBump 18 PrimShiny 4 GLTFOverride 8 GLTFAlphaMode 3 ReflectionProbeType 3 PrimMediaParam 15 PrimMediaControl 2 PrimMediaPerm 4 PrimMediaError 8

See also SL Wiki LSL Texture SL Wiki LSL Color SL Wiki LSL Alpha SL Wiki GlTF Feature Effects Category Prim Media Category Media SL Wiki LSL Prim Media Page Guide: texture coordinates from pixelsPlanned Guide: Blinn-Phong and PBR offsets, repeats and rotationPlanned Guide: PBR materials and glTF overrides