Difference between revisions of "LlSetColor"

From Second Life Wiki
Jump to navigation Jump to search
m
Line 1: Line 1:
{{LSL Function/color|color}}{{LSL_Function/face|face|}}
{{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 '''color''' on '''face''' of the prim.
|func_desc=Sets the {{LSLP|color}} on {{LSLP|face}} of the prim.
|return_text
|return_text
|spec
|spec

Revision as of 10:28, 19 June 2012

Summary

Function: llSetColor( vector color, integer face );

Sets the 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.
All Issues ~ Search JIRA for related Bugs

Examples

<lsl> integer face = -1; vector color = <1.0, 1.0, 1.0>;

default {

   touch_start(integer num)
   {
       if(~face)//quick & dirty check for -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
   }

}

</lsl>

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

Deep Notes

Search JIRA for related Issues

Signature

function void llSetColor( vector color, integer face );