llSetRenderMaterial

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/fr Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ja Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

SetRenderMaterial

llSetRenderMaterial

Summary

Function: llSetRenderMaterial( string material, integer face );

0.2	Forced Delay
10.0	Energy

Sets the material of this prim's face. This function will clear most PRIM_GLTF_* properties on the face, with the exceptions of repeats, offsets, and rotation_in_radians.

• string	material	–	a material in the inventory of the prim this script is in or a UUID of a material
• integer	face	–	face number or ALL_SIDES

If face is ALL_SIDES then the function works on all sides.

Caveats

• This function causes the script to sleep for 0.2 seconds.
• The function silently fails if its face value indicates a face that does not exist.
• If material is missing from the prim's inventory and it is not a UUID or it is not a material then an error is shouted on DEBUG_CHANNEL.
• If material is a UUID then there are no new asset permissions consequences for the object.
  • The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.
• If material is provided as NULL_KEY, the glTF Material is removed from face, reverting back to any underlying Blinn-Phong materials.

Examples

default
{
    state_entry()
    {
        // the first material alphabetically inside the same prim's inventory
        string material = llGetInventoryName(INVENTORY_MATERIAL, 0);

        // set it on all sides of the prim containing the script
        llSetRenderMaterial(material, ALL_SIDES);
    }
}

See Also

Functions

•	llSetLinkRenderMaterial	–	PRIM_RENDER_MATERIAL
•	llGetRenderMaterial
•	llSetPrimitiveParams
•	llSetLinkPrimitiveParams

Deep Notes

Signature
function void llSetRenderMaterial( string material, integer face );