llGetRenderMaterial

From Second Life Wiki
Revision as of 12:45, 1 July 2024 by Frionil Fang (talk | contribs) (this function is live)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search


Summary

Function: string llGetRenderMaterial( integer face );
0.0 Forced Delay
10.0 Energy

Returns a string that is the Material on face

• integer face face number or ALL_SIDES

If face is ALL_SIDES then the function returns the value for face zero. If the Material is in the prim's inventory, the return value is the inventory name, otherwise the returned value is the Material UUID.

Caveats

  • If face indicates a face that does not exist the return is NULL_KEY
  • NULL_KEY is returned when the owner does not have full permissions to the object and the Material is not in the prim's inventory.

Examples

//Tells (on chat) the Material keys / Material names on 6 sides
default
{
    state_entry()
    {
        integer i = 0;
        integer max = llGetNumberOfSides();
        while(i < max)
        {
            llSay(0,"Side " + (string)i + " Material is: " + (string)llGetRenderMaterial(i));
            ++i;
        }
    }
}

See Also

Functions

•  PrimitiveParams PRIM_RENDER_MATERIAL
•  llSetRenderMaterial
•  llSetLinkRenderMaterial Sets link's Material
•  llGetNumberOfSides Gets the number of faces on the prim

Deep Notes

Signature

function string llGetRenderMaterial( integer face );