Difference between revisions of "LlSetColor"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
m (<lsl> example) |
(Add Blinn-Phong terminology to page following PBR release.) |
||
(10 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{LSL Function/color|color}}{{LSL_Function/face|face|}} | |||
|func_id=49|func_sleep=0.0|func_energy=10.0 | |func_id=49|func_sleep=0.0|func_energy=10.0 | ||
|func=llSetColor | |func=llSetColor | ||
|p1_type=vector|p1_name=color|p2_type=integer|p2_name=face | |p1_type=vector|p1_name=color|p2_type=integer|p2_name=face | ||
|func_footnote | |func_footnote | ||
|func_desc=Sets the | |func_desc=Sets the [[PBR_Materials#Nomenclature_changes|Blinn-Phong]] {{LSLP|color}} on {{LSLP|face}} of the prim. | ||
|return_text | |return_text | ||
|spec | |spec | ||
|caveats | |caveats | ||
|constants | |constants | ||
|examples=< | |examples=<source lang="lsl2"> | ||
integer face = -1; | integer face = -1; | ||
vector color = <1.0, 1.0, 1.0>; | vector color = <1.0, 1.0, 1.0>; | ||
Line 18: | Line 18: | ||
touch_start(integer num) | touch_start(integer num) | ||
{ | { | ||
if(~face)//quick & dirty | if(~face) //quick & dirty but efficient way of testing if face is not equal to -1 | ||
llSetColor(color, face); //restore the color | llSetColor(color, face); //restore the color | ||
face = (face + 1) % llGetNumberOfSides(); //increment and keep the face number in range | face = (face + 1) % llGetNumberOfSides(); //increment and keep the face number in range | ||
color = llGetColor(face); //save the face's color | color = llGetColor(face); //save the face's color | ||
llSetColor(<0.5, 0.0, 0.0>, face );//change the face's color | llSetColor(<0.5, 0.0, 0.0>, face ); //change the face's color | ||
} | } | ||
} | } | ||
</ | </source> | ||
|helpers | |helpers= | ||
{{{!}} class="sortable" {{Prettytable}} | |||
{{!}}- {{Hl2}} | |||
! Color | |||
! Hexadecimal code | |||
! LSL color representations | |||
{{!}}- | |||
{{!}} style="color: white; background: #001f3f" {{!}}NAVY | |||
{{!}} #001f3f | |||
{{!}}<code><0.000, 0.122, 0.247></code> | |||
{{!}}- | |||
{{!}} style="background: #0074d9" {{!}}BLUE | |||
{{!}} #0074d9 | |||
{{!}}<code><0.000, 0.455, 0.851></code> | |||
{{!}}- | |||
{{!}} style="background: #7fdbff" {{!}}AQUA | |||
{{!}} #7fdbff | |||
{{!}}<code><0.498, 0.859, 1.000></code> | |||
{{!}}- | |||
{{!}} style="background: #39cccc" {{!}}TEAL | |||
{{!}} #39cccc | |||
{{!}}<code><0.224, 0.800, 0.800></code> | |||
{{!}}- | |||
{{!}} style="background: #3d9970" {{!}}OLIVE | |||
{{!}} #3d9970 | |||
{{!}}<code><0.239, 0.600, 0.439></code> | |||
{{!}}- | |||
{{!}} style="background: #2ecc40" {{!}}GREEN | |||
{{!}} #2ecc40 | |||
{{!}}<code><0.180, 0.800, 0.251></code> | |||
{{!}}- | |||
{{!}} style="background: #01ff70" {{!}}LIME | |||
{{!}} #01ff70 | |||
{{!}}<code><0.004, 1.000, 0.439></code> | |||
{{!}}- | |||
{{!}} style="background: #ffdc00" {{!}}YELLOW | |||
{{!}} #ffdc00 | |||
{{!}}<code><1.000, 0.863, 0.000></code> | |||
{{!}}- | |||
{{!}} style="background: #ff851b" {{!}}ORANGE | |||
{{!}} #ff851b | |||
{{!}}<code><1.000, 0.522, 0.106></code> | |||
{{!}}- | |||
{{!}} style="background: #ff4136" {{!}}RED | |||
{{!}} #ff4136 | |||
{{!}}<code><1.000, 0.255, 0.212></code> | |||
{{!}}- | |||
{{!}} style="color: white; background: #85144b" {{!}}MAROON | |||
{{!}} #85144b | |||
{{!}}<code><0.522, 0.078, 0.294></code> | |||
{{!}}- | |||
{{!}} style="background: #f012be" {{!}}FUCHSIA | |||
{{!}} #f012be | |||
{{!}}<code><0.941, 0.071, 0.745></code> | |||
{{!}}- | |||
{{!}} style="color: white; background: #b10dc9" {{!}}PURPLE | |||
{{!}} #b10dc9 | |||
{{!}}<code><0.694, 0.051, 0.788></code> | |||
{{!}}- | |||
{{!}} style="background: #ffffff" {{!}}WHITE | |||
{{!}} #ffffff | |||
{{!}}<code><1.000, 1.000, 1.000></code> | |||
{{!}}- | |||
{{!}} style="background: #dddddd" {{!}}SILVER | |||
{{!}} #dddddd | |||
{{!}}<code><0.867, 0.867, 0.867></code> | |||
{{!}}- | |||
{{!}} style="background: #aaaaaa" {{!}}GRAY | |||
{{!}} #aaaaaa | |||
{{!}}<code><0.667, 0.667, 0.667></code> | |||
{{!}}- | |||
{{!}} style="color: white; background: #111111" {{!}}BLACK | |||
{{!}} #111111 | |||
{{!}}<code><0.067, 0.067, 0.067></code> | |||
{{!}}} | |||
|also_functions= | |also_functions= | ||
{{LSL DefineRow||[[llGetAlpha]]|Gets the prim's alpha}} | {{LSL DefineRow||[[llGetAlpha]]|Gets the prim's alpha}} | ||
Line 36: | Line 110: | ||
|also_events= | |also_events= | ||
{{LSL DefineRow||[[changed]]|[[CHANGED_COLOR]]}} | {{LSL DefineRow||[[changed]]|[[CHANGED_COLOR]]}} | ||
|also_articles | |also_articles= | ||
{{LSL DefineRow||[[Color and Scripting]]}} | |||
|notes | |notes | ||
|deprecated | |deprecated |
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: llSetColor( vector color, integer face );49 | Function ID |
0.0 | Forced Delay |
10.0 | Energy |
Sets the Blinn-Phong color on face of the prim.
• vector | color | – | color in RGB <R, G, B> (<0.0, 0.0, 0.0> = black, <1.0, 1.0, 1.0> = white) | |
• integer | face | – | face number or ALL_SIDES |
If face is ALL_SIDES then the function works on all sides.
Newbie Notes
llSetColor changes the color of a prim, either on a specific side (face) or the entire prim.
Example:llSetColor(<r, g, b>, ALL_SIDES);
r, g, b: values for red, green, blue ranging from <0.0, 0.0, 0.0> (black) to <1.0, 1.0, 1.0> (white)
To continue reading see: Newbie Notes
Caveats
- The function silently fails if its face value indicates a face that does not exist.
Examples
integer face = -1;
vector color = <1.0, 1.0, 1.0>;
default
{
touch_start(integer num)
{
if(~face) //quick & dirty but efficient way of testing if face is not equal to -1
llSetColor(color, face); //restore the color
face = (face + 1) % llGetNumberOfSides(); //increment and keep the face number in range
color = llGetColor(face); //save the face's color
llSetColor(<0.5, 0.0, 0.0>, face ); //change the face's color
}
}
Useful Snippets
Color | Hexadecimal code | LSL color representations |
---|---|---|
NAVY | #001f3f | <0.000, 0.122, 0.247>
|
BLUE | #0074d9 | <0.000, 0.455, 0.851>
|
AQUA | #7fdbff | <0.498, 0.859, 1.000>
|
TEAL | #39cccc | <0.224, 0.800, 0.800>
|
OLIVE | #3d9970 | <0.239, 0.600, 0.439>
|
GREEN | #2ecc40 | <0.180, 0.800, 0.251>
|
LIME | #01ff70 | <0.004, 1.000, 0.439>
|
YELLOW | #ffdc00 | <1.000, 0.863, 0.000>
|
ORANGE | #ff851b | <1.000, 0.522, 0.106>
|
RED | #ff4136 | <1.000, 0.255, 0.212>
|
MAROON | #85144b | <0.522, 0.078, 0.294>
|
FUCHSIA | #f012be | <0.941, 0.071, 0.745>
|
PURPLE | #b10dc9 | <0.694, 0.051, 0.788>
|
WHITE | #ffffff | <1.000, 1.000, 1.000>
|
SILVER | #dddddd | <0.867, 0.867, 0.867>
|
GRAY | #aaaaaa | <0.667, 0.667, 0.667>
|
BLACK | #111111 | <0.067, 0.067, 0.067>
|
See Also
Events
• | changed | – | CHANGED_COLOR |
Functions
• | llGetAlpha | – | Gets the prim's alpha | |
• | llSetAlpha | – | Sets the prim's alpha | |
• | llGetColor | – | Gets the prim's color | |
• | llSetLinkColor | – | Sets link's color | |
• | llSetLinkAlpha | – | Sets link's alpha |
Articles
• | Color in LSL | |||
• | Color and Scripting |