LlGetColor: Difference between revisions

From Second Life Wiki
Jump to navigation Jump to search
Strife Onizuka (talk | contribs)
No edit summary
 
Jenna Huntsman (talk | contribs)
Add Blinn-Phong terminology to page following PBR release.
 
(26 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{LSLFunctionAll|func_id=52|func_sleep=0.0|func_energy=10.0|func=llGetColor|return_type=vector|p1_type=integer|p1_name=face|func_footnote=gets the color|return_text|spec|caveats|examples|helpers|related|also|notes}}[[Category:LSL_Functions]][[Category:LSL_Stub]]
{{LSL_Function
|inject-2={{LSL_Function/face|face|return={{LSL VR|0.0|0.0|0.0}}|get=returns the average color of all the faces on the prim.{{Footnote|Since sRGB is nonlinear this color may not in fact be of the greatest use.}}}}{{LSL Function/color|none}}
|func_id=52|func_sleep=0.0|func_energy=10.0
|func=llGetColor|sort=GetColor
|func_footnote
|p1_type=integer|p1_name=face
|return_type=vector
|return_text=that is the [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] color on {{LSLP|face}}.
|spec
|caveats
|examples=
<syntaxhighlight lang="lsl2">// 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;
        }
    }
}</syntaxhighlight>
|helpers
|also_header
|also_tests
|also_articles
|also_footer
|also_functions=
{{LSL DefineRow||[[llGetAlpha]]|Gets the prim's alpha}}
{{LSL DefineRow||[[llSetAlpha]]|Sets the prim's alpha}}
{{LSL DefineRow||[[llSetColor]]|Sets the prim's color}}
{{LSL DefineRow||[[llSetLinkColor]]|Sets link's color}}
{{LSL DefineRow||[[llSetLinkAlpha]]|Sets link's alpha}}
{{LSL DefineRow||[[llGetNumberOfSides]]|Gets the number of faces on the prim}}
|also_events
|also_articles
|notes
|cat1
|cat2
|cat3
|cat4
}}

Latest revision as of 13: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

<syntaxhighlight lang="lsl2">// 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;
       }
   }
}</syntaxhighlight>

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