Difference between revisions of "Category:LSL Alpha"

From Second Life Wiki
Jump to navigation Jump to search
m (same.. terminology)
(because of the width of the examples, it doesn't fit well on small screens. Better to combine the description and example columns)
Line 10: Line 10:
{|cellspacing="0" cellpadding="6" border="1" style="border: 1px solid #aaaaaa; margin: 1em 1em 1em 0pt; background-color: #F8F8FF; border-collapse: collapse"
{|cellspacing="0" cellpadding="6" border="1" style="border: 1px solid #aaaaaa; margin: 1em 1em 1em 0pt; background-color: #F8F8FF; border-collapse: collapse"
!style="background-color: #D2D3FF" | Function
!style="background-color: #D2D3FF" | Function
!style="background-color: #D2D3FF" | LSL Example
!style="background-color: #D2D3FF" | LSL Example & Description
!style="background-color: #D2D3FF" | Description
|-
|-
| [[llSetAlpha]]
| [[llSetAlpha]]
| <lsl>llSetAlpha(1.0, ALL_SIDES);</lsl>
| <lsl>llSetAlpha(1.0, ALL_SIDES);</lsl> This will set the object's sides' alpha to opaque, or '''0%'''.
| This will set the object's sides' alpha to opaque, or '''0%'''.
|-
|-
| [[llSetLinkAlpha]]
| [[llSetLinkAlpha]]
| <lsl>llSetLinkAlpha(LINK_SET, 0.0, ALL_SIDES);</lsl>
| <lsl>llSetLinkAlpha(LINK_SET, 0.0, ALL_SIDES);</lsl>
| This will set link-set's alpha to transparent, or '''100%'''. ('''Note''': The Viewers released by Linden Labs are unable to set the alpha of an object to fully transparent without a script; the limit is caped at '''90%''')
This will set link-set's alpha to transparent, or '''100%'''. ('''Note''': The Viewers released by Linden Labs are unable to set the alpha of an object to fully transparent without a script; the limit is caped at '''90%''')
|-
|-
| [[llSetPrimitiveParams]]
| [[llSetPrimitiveParams]]
| <lsl>llSetPrimitiveParams([PRIM_COLOR, ALL_SIDES, llGetColor(ALL_SIDES), 0.5]);</lsl>
| <lsl>llSetPrimitiveParams([PRIM_COLOR, ALL_SIDES, llGetColor(ALL_SIDES), 0.5]);
| This will set the object's alpha to translucent, or '''50%'''.
// Using llGetColor this way may not give the desired result (it returns the average color)</lsl>
This will set the object's alpha to translucent, or '''50%'''.
|-
|-
| [[llSetLinkPrimitiveParams]]
| [[llSetLinkPrimitiveParams]]
| <lsl>llSetLinkPrimitiveParams(LINK_SET, [PRIM_COLOR, ALL_SIDES, llGetColor(ALL_SIDES), 0.5]);</lsl>
| <lsl>llSetLinkPrimitiveParams(LINK_SET, [PRIM_COLOR, ALL_SIDES, llGetColor(ALL_SIDES), 0.5]);
| This will set the link-set's alpha to translucent, or '''50%'''.
// Using llGetColor this way may not give the desired result (it returns the average color).</lsl>
This will set the link-set's alpha to translucent, or '''50%'''.
|-
|-
|}
|}


{{LSLC|}}{{LSLC|Face|*Alpha}}
{{LSLC|}}{{LSLC|Face|*Alpha}}

Revision as of 10:52, 30 October 2010

The term "Alpha" refers to how translucent an object (or, in this case, a prim) is. In Second Life, the alpha property is set by the scripting functions llSetAlpha, llSetLinkAlpha, llSetPrimitiveParams, and llSetLinkPrimitiveParams. These functions use a float value. When set to 0.0, the object/prim is fully invisible. When set to 1.0, the object is opaque. Sometimes, Residents refer to a transparent texture as alpha texture. This is a texture with an alpha map, not to be confused with this prim property. See llSetTexture and TEXTURE_TRANSPARENT instead.

Build Mode

In Build Mode, the alpha is represented by a percentage, ranging from 0% to 90%. (Note: The 90% cap is for viewers that have been officially released by Linden Labs)

Examples

Below are examples on how one may set the alpha of an object.

Function LSL Example & Description
llSetAlpha <lsl>llSetAlpha(1.0, ALL_SIDES);</lsl> This will set the object's sides' alpha to opaque, or 0%.
llSetLinkAlpha <lsl>llSetLinkAlpha(LINK_SET, 0.0, ALL_SIDES);</lsl>

This will set link-set's alpha to transparent, or 100%. (Note: The Viewers released by Linden Labs are unable to set the alpha of an object to fully transparent without a script; the limit is caped at 90%)

llSetPrimitiveParams <lsl>llSetPrimitiveParams([PRIM_COLOR, ALL_SIDES, llGetColor(ALL_SIDES), 0.5]);

// Using llGetColor this way may not give the desired result (it returns the average color)</lsl> This will set the object's alpha to translucent, or 50%.

llSetLinkPrimitiveParams <lsl>llSetLinkPrimitiveParams(LINK_SET, [PRIM_COLOR, ALL_SIDES, llGetColor(ALL_SIDES), 0.5]);

// Using llGetColor this way may not give the desired result (it returns the average color).</lsl> This will set the link-set's alpha to translucent, or 50%.