Difference between revisions of "LlGetAlpha"
Jump to navigation
Jump to search
All Issues ~ Search JIRA for related Bugs
Search JIRA for related Issues
m |
m |
||
| Line 1: | Line 1: | ||
{{LSL_Function/face|face|return=0.0|get=returns the sum of alpha of all the faces on the prim, range {{Interval|gte=0|lte=[[llGetNumberOfSides|sides]]|lteh=sides|center=return}}{{Interval/Footnote}}.}}{{LSL_Function/alpha|alpha}} | {{LSL_Function | ||
|inject-2={{LSL_Function/face|face|return=0.0|get=returns the sum of alpha of all the faces on the prim, range {{Interval|gte=0|lte=[[llGetNumberOfSides|sides]]|lteh=sides|center=return}}{{Interval/Footnote}}.}} | |||
{{LSL_Function/alpha|alpha}} | |||
|func_id=50|func_sleep=0.0|func_energy=10.0 | |func_id=50|func_sleep=0.0|func_energy=10.0 | ||
|func=llGetAlpha|return_type=float | |func=llGetAlpha|return_type=float | ||
| Line 6: | Line 8: | ||
Otherwise the return is in the range {{Interval|gte=0|lte=1|center=return}}. | Otherwise the return is in the range {{Interval|gte=0|lte=1|center=return}}. | ||
|func_desc | |func_desc | ||
|return_text=that is the alpha of | |return_text=that is the alpha of {{LSLP|face}}. | ||
|spec | |spec | ||
|caveats | |caveats | ||
Revision as of 09:23, 13 June 2012
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: float llGetAlpha( integer face );| 50 | Function ID |
| 0.0 | Forced Delay |
| 10.0 | Energy |
Returns a float that is the alpha of face.
| • integer | face | – | face number or ALL_SIDES |
If face is ALL_SIDES then the function returns the sum of alpha of all the faces on the prim, range [0, sides][1]. Otherwise the return is in the range [0, 1].
Caveats
- If face indicates a face that does not exist the return is 0.0
Examples
<lsl>//Tells the owner the alpha on all sides default {
state_entry()
{
integer i = 0;
integer max = llGetNumberOfSides();
while(i < max)
{
llSay(0,"Face "+(string)i+" alpha is " + (string)llGetAlpha(i));
++i;
}
}
}</lsl>
Useful Snippets
<lsl>float AveragePrimAlpha() {//Since this is so simple you may just want to inline it instead of including the function.
return (llGetAlpha(ALL_SIDES) / llGetNumberOfSides());
}</lsl>
See Also
Functions
| • | llSetAlpha | – | Sets the prim's alpha | |
| • | llGetColor | – | Gets the prim's color | |
| • | 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
| • | Translucent Color |
Deep Notes
Rounding
Alpha is stored in a single 8-bit byte, meaning there are 256 values that are possible. Consequently the values returned by this function are all multiples of 1/255. When the alpha value is initially stored the float value is rounded to the nearest multiple, turning 0.5 into 128/255 for example.
Footnotes
- ^ The ranges in this article are written in Interval Notation.
Signature |
|---|
function float llGetAlpha( integer face ); |