Skip to content
lsl.devlsl.devLSL Dev

Faces

Operate on one or more face numbers at a time.

All constant groups

At a glance, from the LSL definitions
integer ALL_SIDES = -1;  // Selects all sides of an object in an applicable function.

Constants

ConstantTypeValueDescription
ALL_SIDESinteger-1Selects all sides of an object in an applicable function.

Used by

  • llClearLinkMediafunctionDeletes 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.
  • llClearPrimMediafunctionDeletes the media and clears all parameters from the specified face. Returns an integer STATUS_* flag detailing the success or failure of the operation.
  • llGetAlphafunctionReturns a float representing the Blinn-Phong alpha (transparency) of face. If face is ALL_SIDES, returns the mean average of all faces.
  • llGetColorfunctionReturns 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.
  • llGetLinkMediafunctionReturns a list containing the media parameters of the specified face on the linked prim link, retrieved in the order requested by params.
  • llGetPrimMediaParamsfunctionReturns 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.
  • llGetRenderMaterialfunctionReturns 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).
  • llGetTexturefunctionReturns 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).
  • llGetTextureOffsetfunctionReturns a vector containing the texture offsets of face in the X (horizontal U) and Y (vertical V) components (Z is unused).
  • llGetTextureRotfunctionReturns a float representing the texture rotation angle (in radians) on face.
  • llGetTextureScalefunctionReturns a vector containing the texture scales of face in the X and Y components (Z is unused).
  • llIsLinkGLTFMaterialfunctionChecks 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.
  • llOffsetTexturefunctionSets the texture horizontal (u) and vertical (v) offsets for the chosen face. If face is ALL_SIDES, offsets all faces.
  • llRotateTexturefunctionSets the texture rotation of face to the specified angle (in radians). If face is ALL_SIDES, rotates the texture on all faces.
  • llScaleTexturefunctionSets 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.
  • llSetAlphafunctionSets 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).
  • llSetColorfunctionSets the Blinn-Phong diffuse RGB color of face. If face is ALL_SIDES, applies the color to all faces.
  • llSetLinkAlphafunctionSets the Blinn-Phong alpha (transparency) of face on the linked prim link.
  • llSetLinkColorfunctionSets the Blinn-Phong diffuse RGB color of face on the linked prim link.
  • llSetLinkGLTFOverridesfunctionSets or removes individual GLTF override parameters specified by params on face of the linked prim link.
  • llSetLinkMediafunctionSets 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.
  • llSetLinkRenderMaterialfunctionApplies 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.
  • llSetLinkTexturefunctionApplies texture (UUID or inventory name) to face of the linked prim link.
  • llSetLinkTextureAnimfunctionAnimates 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.
  • llSetPrimMediaParamsfunctionSets the media parameters specified by params on the designated face of the prim. Returns an integer STATUS_* flag detailing success or failure.
  • llSetRenderMaterialfunctionApplies 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.
  • llSetTexturefunctionApplies the Blinn-Phong diffuse texture to face of the prim.
  • llSetTextureAnimfunctionAnimates 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.