llGetColor

From Second Life Wiki
Revision as of 12:27, 1 December 2023 by Jenna Huntsman (talk | contribs) (Add Blinn-Phong terminology to page following PBR release.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Summary

Function: vector llGetColor( integer face );
0.0 Forced Delay
10.0 Energy

Returns a vector that is the Blinn-Phong color on face.

• integer face face number or ALL_SIDES

If face is ALL_SIDES then the function returns the average color of all the faces on the prim.[1]

Caveats

  • If face indicates a face that does not exist the return is <0.0, 0.0, 0.0>

Examples

// Tells the owner the color on all sides
default
{
    state_entry()
    {
        integer i = 0;
        integer max = llGetNumberOfSides();
        while(i < max)
        {
            llOwnerSay("Face " + (string) i + " color is " + (string) llGetColor(i));
            ++i;
        }
    }
}

See Also

Functions

•  llGetAlpha Gets the prim's alpha
•  llSetAlpha Sets the prim's alpha
•  llSetColor Sets the prim's color
•  llSetLinkColor Sets link's color
•  llSetLinkAlpha Sets link's alpha
•  llGetNumberOfSides Gets the number of faces on the prim

Articles

•  Color in LSL

Deep Notes

Footnotes

  1. ^ Since sRGB is nonlinear this color may not in fact be of the greatest use.

Signature

function vector llGetColor( integer face );