Difference between revisions of "LlGetColor"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Search JIRA for related Issues
m (ALL_SIDES return the average of all side colors.) |
(Add Blinn-Phong terminology to page following PBR release.) |
||
| (7 intermediate revisions by 4 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | {{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_id=52|func_sleep=0.0|func_energy=10.0 | ||
|func=llGetColor|sort=GetColor | |func=llGetColor|sort=GetColor | ||
| 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 | |return_text=that is the [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] color on {{LSLP|face}}. | ||
|spec | |spec | ||
|caveats | |caveats | ||
|examples= | |examples= | ||
< | <syntaxhighlight lang="lsl2">// Tells the owner the color on all sides | ||
default | default | ||
{ | { | ||
| Line 19: | Line 19: | ||
while(i < max) | while(i < max) | ||
{ | { | ||
llOwnerSay("Face " + (string) i + " color is " + (string) llGetColor(i)); | |||
++i; | ++i; | ||
} | } | ||
} | } | ||
}</ | }</syntaxhighlight> | ||
|helpers | |helpers | ||
|also_header | |also_header | ||
Latest revision as of 13:27, 1 December 2023
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: vector llGetColor( integer face );| 52 | Function ID |
| 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
- ^ Since sRGB is nonlinear this color may not in fact be of the greatest use.
Signature |
|---|
function vector llGetColor( integer face ); |