Difference between revisions of "LlGetColor"

From Second Life Wiki
Jump to navigation Jump to search
m (Replaced <source> with <syntaxhighlight>)
(Add Blinn-Phong terminology to page following PBR release.)
 
Line 6: Line 6:
|p1_type=integer|p1_name=face
|p1_type=integer|p1_name=face
|return_type=vector
|return_type=vector
|return_text=that is the color on {{LSLP|face}}.
|return_text=that is the [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] color on {{LSLP|face}}.
|spec
|spec
|caveats
|caveats

Latest revision as of 12:27, 1 December 2023

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 );