Skip to content
lsl.devlsl.devLSL Dev

LlSetLinkGLTFOverrides

Looking for the current API? Open the llSetLinkGLTFOverrides reference →

Wiki description

Sets or removes individual overrides applied to a PBR texture on a face

Specification

Parameters

parametervaluetypedescription
OVERRIDE_GLTF_BASE_COLOR_FACTOR 1 vector Set the tinting color used for the base color. Color is specified in linear RGB. Use llsRGB2Linear to convert colors from Blinn-Phong to PBR.
OVERRIDE_GLTF_BASE_ALPHA 2 float Sets the alpha for the face(s). Only impacts the rendering when the alpha mode is set to PRIM_GLTF_ALPHA_MODE_BLEND.
OVERRIDE_GLTF_BASE_ALPHA_MODE 3 integer Set the alpha mode on the face(s). Must be one of the valid blend modes
GLTF Alpha Modevaluedescription
PRIM_GLTF_ALPHA_MODE_OPAQUE 0 Ignore the alpha value and render the material as opaque.
PRIM_GLTF_ALPHA_MODE_BLEND 1 Render the material with transparency determined by the alpha value. Blending is done in linear color space. As is the case for Blinn-Phong as well, this mode suffers from depth sorting and performance issues. Use alpha mask instead when possible.
PRIM_GLTF_ALPHA_MODE_MASK 2 Render the material as fully opaque where the alpha value is greater than the alpha cutoff, and otherwise render the material as fully transparent.
OVERRIDE_GLTF_BASE_ALPHA_MASK 4 float Sets the alpha cutoff level on the face(s) when alpha mode is set to mask.
OVERRIDE_GLTF_BASE_DOUBLE_SIDED 5 integer If set to TRUE then the texture on the face(s) will be rendered as double sided.
OVERRIDE_GLTF_METALLIC_FACTOR 6 float Adjusts the metallic factor on the specified face(s). Value should be between 0 and 1.
OVERRIDE_GLTF_ROUGHNESS_FACTOR 7 float Adjust the roughness factor on the specified face(s). Value should be between 0 and 1.
OVERRIDE_GLTF_EMISSIVE_FACTOR 8 vector Set the tint used for the emissive texture on the face(s). Note that this is specified in linear RGB.
Passing an empty string ("") as the override value will clear that override.

Caveats

  • OVERRIDE_GLTF_BASE_COLOR_FACTOR and OVERRIDE_GLTF_BASE_ALPHA parameters are coupled. If an override is set for one parameter, then the other is automatically given an override. The default OVERRIDE_GLTF_BASE_COLOR_FACTOR is <1,1,1>, and the default OVERRIDE_GLTF_BASE_ALPHA is 1.0.

Examples

Toggle alpha on\off
integer toggle;
default
{
    touch_start(integer num_detected)
    {
        toggle=!toggle;
        llSetLinkGLTFOverrides( LINK_THIS, 0, [
            OVERRIDE_GLTF_BASE_ALPHA_MODE, PRIM_GLTF_ALPHA_MODE_BLEND,
            OVERRIDE_GLTF_BASE_ALPHA, toggle]);
    }
}

See also: functions

LlSetPrimitiveParams — Sets the parameters for a prim
LlGetPrimitiveParams — Gets the parameters set on a prim

Shared wiki helpers

The original page also injects shared parameter notes, caveats or issue information through these helpers. Their conditional MediaWiki logic is not reproduced here; inspect the preserved helper source for additional material.

Template:LSL Function/color

Original shared helper source (conditional wiki logic is not evaluated)
{{LSL Injection Test}}{{#if:

{{#vardefine:p_{{{1|none}}}_desc|{{LSLGC|Color|color}} in RGB {{LSL_VR|1={{HoverText|R|Red}}, {{HoverText|G|Green}}, {{HoverText|B|Blue}}}} ({{LSL_VR|0.0, 0.0, 0.0}} &#61; black, {{LSL_VR|1.0, 1.0, 1.0}} &#61; white)}}

{{#vardefine:p_{{{1|none}}}_hover|color in RGB {{LSL_VR|R, G, B}} ({{LSL_VR|0.0, 0.0, 0.0}} &#61; black, {{LSL_VR|1.0, 1.0, 1.0}} &#61; white)}}

{{#vardefine:also_articles|{{#var:also_articles}}
{{LSL DefineRow||{{LSLGC|Color|Color in LSL}} {{#switch:{{#if:{{{nc|}}}|Template|{{NAMESPACE}}}}|Template=|User=|{{LSLC|Color}}}} }}}}

}}<noinclude>
{| {{Prettytable}}
|-{{Hl2}}
! #var
! value
|-
{{VarPair|p_{{{1|none}}}_desc}}
|-
{{VarPair|p_{{{1|none}}}_hover}}
|-
{{VarPairTable|also_articles}}
|}
</noinclude>

Template:LSL Function/link-face

Original shared helper source (conditional wiki logic is not evaluated)
{{LSL Injection Test}}{{#if:{{{1|}}}|{{LSL Function/link|{{{1}}}|nogroup={{{nogroup|}}}}}}}{{#if:{{{2|}}}|{{LSL_Function/face|{{{2}}}}}}}{{#if:

{{#vardefine:also_functions|{{#var:also_functions}}
{{LSL DefineRow||[[llGetLinkNumberOfSides]]|Returns the number of faces of the linked prim.}}}}

}}
Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.