llGetRenderMaterial

From Second Life Wiki
Jump to navigation Jump to search
Emblem-important-red.png Warning! Future feature

This function will be supported in the upcoming GLTF Materials project.
Currently it will only work in supported testing areas with a supported test viewer.

Summary

Function: string llGetRenderMaterial( integer face );

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.
All Issues ~ Search JIRA for related Bugs

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

Search JIRA for related Issues

Signature

function string llGetRenderMaterial( integer face );