PRIM ALPHA MODE/ja
< PRIM ALPHA MODE
Jump to navigation
Jump to search
Revision as of 01:11, 8 October 2023 by Misaki Vanilla (talk | contribs) (Created page with "<onlyinclude>{{#if: {{Issues/BUG-7306}} {{#vardefine:alpha_mode_const|{{LSL Const/ja|PRIM_ALPHA_MODE|integer|38|c=Used to {{GetSet|{{{1|}}}|get|set|/}} diffuse texture alpha...")
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Description
Constant: integer PRIM_ALPHA_MODE = 38;
The integer constant PRIM_ALPHA_MODE has the value 38
Used to specify how the alpha channel of the diffuse texture should affect rendering of a prim’s face.
llSetPrimitiveParams
[ PRIM_ALPHA_MODE, integer face, integer alpha_mode, integer mask_cutoff ]| • integer | face | – | a face/ja number or ALL_SIDES/ja | |
| • integer | alpha_mode | – | PRIM_ALPHA_MODE_* flag | |
| • integer | mask_cutoff | – | when the alpha rendering mode is PRIM_ALPHA_MODE_MASK, sets the alpha value above which a pixel renders as fully opaque, in the range 0 to 255 |
When used with llSetPrimitiveParams/ja & llSetLinkPrimitiveParams/ja
llGetPrimitiveParams
llGetPrimitiveParams([ PRIM_ALPHA_MODE, integer face ]);Returns the list [ integer alpha_mode, integer mask_cutoff ]
| • integer | face | – | a face/ja number or ALL_SIDES/ja | ||
| • integer | alpha_mode | – | PRIM_ALPHA_MODE_* flag | ||
| • integer | mask_cutoff | – | when the alpha rendering mode is PRIM_ALPHA_MODE_MASK, sets the alpha value above which a pixel renders as fully opaque, in the range 0 to 255 | ||
| alpha_mode Flags | V | Description | Notes | ||||
|---|---|---|---|---|---|---|---|
| PRIM_ALPHA_MODE_NONE | 0 | Render the diffuse texture as though the alpha channel were nonexistent | The viewer’s build tool sets this by default when a face has a material and no alpha channel is present in the diffuse texture. | ||||
| PRIM_ALPHA_MODE_BLEND | 1 | Render the diffuse texture with alpha-blending. | This value is also used as the default to clear the materials settings from a prim face. | ||||
| PRIM_ALPHA_MODE_MASK | 2 | Render the prim face in alpha-masked mode. | Diffuse texture pixels which are more opaque than mask_cutoff will be rendered as fully opaque, while the other pixels will be fully transparent. | ||||
| PRIM_ALPHA_MODE_EMISSIVE | 3 | Render the prim face in emissivity mode. | Diffuse texture pixels opacity maps to their emissivity when rendered. Fully opaque pixels will effectively be rendered as ‘full bright’. | ||||
Caveats
Related Articles
Examples
llSetPrimitiveParams([ PRIM_ALPHA_MODE, ALL_SIDES, PRIM_ALPHA_MODE_NONE, 0 ]);
llSetPrimitiveParams([ PRIM_ALPHA_MODE, ALL_SIDES, PRIM_ALPHA_MODE_MASK, 130 ]);
Notes
- Note that as with PRIM_NORMAL/ja and PRIM_SPECULAR/ja, setting a custom (i.e. not PRIM_ALPHA_MODE_BLEND/ja) alpha mode on a prim faces causes the linkset to use the new prim accounting system.
- mask_cutoff is not used or stored unless the mode is set to PRIM_ALPHA_MODE_MASK/ja.
- To delete the material from face, set the alpha_mode to PRIM_ALPHA_MODE_BLEND/ja, in addition to clearing PRIM_NORMAL/ja and PRIM_SPECULAR/ja
- If face indicates a face that exists but does not contain a material, the PRIM_ALPHA_MODE/ja return is '[ PRIM_ALPHA_MODE_BLEND/ja, 0 ]'
Deep Notes
All Issues
~ Search JIRA for related Issues
|
|
BUG-7306 | A | We need PRIM_ALPHA_MODE_DEFAULT to revert alpha to old "if the texture has an alpha mask, use alpha. If not, don't" behavior. |
Signature |
|---|
integer PRIM_ALPHA_MODE = 38; |