@triforge/shader-core 0.2.1 → 0.4.0

package/dist/core/ShaderNode.js

@@ -60,6 +60,13 @@ export class ShaderNode {
     vertexInjections() {
         return [];
     }
+    /**
+     * Whether this node's contribution to the compiled material requires
+     * `transparent: true` on the resulting THREE.ShaderMaterial (e.g. a
+     * `shader`-socket alpha channel that can read below 1.0).
+     * Override in nodes that carry alpha semantics — see PrincipledBSDF.
+     */
+    wantsTransparency() { return false; }
     /**
      * Returns the named output socket.
      * Throws ShaderNodeError if the socket does not exist.
@@ -144,6 +151,22 @@ export class ShaderNode {
                         enumerable: true,
                         configurable: true,
                     });
+                    // Per-component aliases (e.g. parameters['location.x']) for any vector-typed
+                    // uniform parameter, so a KeyframeTrack can animate a single axis. Reads/writes
+                    // go through the same uniforms[uniformName].value array as the whole-vector
+                    // getter/setter above, so both access styles stay in sync automatically.
+                    const AXES = ['x', 'y', 'z'];
+                    AXES.forEach((axis, idx) => {
+                        Object.defineProperty(this.parameters, `${paramName}.${axis}`, {
+                            get: () => uniforms[uniformName].value[idx],
+                            set: (v) => {
+                                const arr = uniforms[uniformName].value;
+                                arr[idx] = finiteOr(v, 0);
+                            },
+                            enumerable: true,
+                            configurable: true,
+                        });
+                    });
                 }
                 else {
                     Object.defineProperty(this.parameters, paramName, {

package/dist/core/SocketType.d.ts

@@ -1,7 +1,7 @@
 /**
  * Socket types mirror Blender's socket colours.
  *
- * shader  — yellow  — BSDF / material output
+ * shader  — yellow  — BSDF / material output — vec4 RGB + alpha
  * color   — yellow-green — vec3 RGB
  * vector  — purple  — vec2 / vec3 spatial
  * float   — grey    — single scalar

package/dist/core/SocketType.js

@@ -1,6 +1,6 @@
 /** Maps SocketType to its GLSL primitive. */
 export const SOCKET_GLSL_TYPE = {
-    shader: 'vec3',
+    shader: 'vec4',
     color: 'vec3',
     vector: 'vec2',
     float: 'float',

package/dist/index.d.ts

@@ -83,6 +83,7 @@ export { SubsurfaceScattering } from './nodes/process/SubsurfaceScattering.js';
 export { ToonBSDF } from './nodes/process/ToonBSDF.js';
 export { SpecularBSDF } from './nodes/process/SpecularBSDF.js';
 export { TranslucentBSDF } from './nodes/process/TranslucentBSDF.js';
+export { TransparentBSDF } from './nodes/process/TransparentBSDF.js';
 export { PrincipledHair } from './nodes/process/PrincipledHair.js';
 export { Math as ShaderMath } from './nodes/process/Math.js';
 export { Clamp } from './nodes/process/Clamp.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -88,6 +88,7 @@ export { SubsurfaceScattering } from './nodes/process/SubsurfaceScattering.js';
 export { ToonBSDF } from './nodes/process/ToonBSDF.js';
 export { SpecularBSDF } from './nodes/process/SpecularBSDF.js';
 export { TranslucentBSDF } from './nodes/process/TranslucentBSDF.js';
+export { TransparentBSDF } from './nodes/process/TransparentBSDF.js';
 export { PrincipledHair } from './nodes/process/PrincipledHair.js';
 // ── Process nodes — Converter ─────────────────────────────────────────────────
 export { Math as ShaderMath } from './nodes/process/Math.js';

package/dist/nodes/output/MaterialOutput.js

@@ -112,7 +112,7 @@ export class MaterialOutput extends OutputNode {
     compileCall(ctx) {
         const sv = this._inputs.surface.isConnected()
             ? ctx.outputVar(this._inputs.surface.connection.node, this._inputs.surface.connection.name)
-            : 'vec3(0.8)';
-        return `gl_FragColor = vec4(${sv}, 1.0);`;
+            : 'vec4(0.8, 0.8, 0.8, 1.0)';
+        return `gl_FragColor = ${sv};`;
     }
 }

package/dist/nodes/process/AddShader.js

@@ -26,11 +26,11 @@ export class AddShader extends ProcessNode {
     compileCall(ctx) {
         const s1 = ctx.resolveInput(this._inputs.shader1);
         const s2 = ctx.resolveInput(this._inputs.shader2);
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_addShader(${s1}, ${s2});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = _st_addShader(${s1}, ${s2});`;
     }
 }
 AddShader.instanceSpecificDef = false;
-AddShader.glslFunction = `
-vec3 _st_addShader(vec3 a, vec3 b) {
-  return a + b;
+AddShader.glslFunction = `
+vec4 _st_addShader(vec4 a, vec4 b) {
+  return vec4(a.rgb + b.rgb, max(a.a, b.a));
 }`;

package/dist/nodes/process/Bump.d.ts

@@ -7,19 +7,42 @@ export interface BumpInputs {
     distance?: OutputSocket | number;
     height?: OutputSocket;
     normal?: OutputSocket;
+    /**
+     * 'derivative' (default) — height gradient via dFdx/dFdy of the `height` input.
+     * Screen-space, camera/rasterization-dependent: stable for procedural/vertex-fed
+     * height but can speckle or seam-flicker across a wide camera-distance range when
+     * `height` comes from a sampled texture.
+     *
+     * 'uv-offset' — explicit texelSize-offset samples of a height texture at a fixed
+     * LOD, independent of screen-space derivatives. Stable under camera motion for
+     * texture-driven relief (e.g. planetary crater/regolith maps). Requires `uniformName`.
+     */
+    method?: 'derivative' | 'uv-offset';
+    /** Required when method:'uv-offset'. Name of the sampler2D height-map uniform. */
+    uniformName?: string;
+    /** UV to sample at, when method:'uv-offset'. Defaults to the surface UV (vUv). */
+    vector?: OutputSocket;
+    /** Texel size (1 / texture resolution) for the uv-offset samples. Default 1/512. */
+    texelSize?: OutputSocket | number;
+    /** Explicit mip/LOD level for the uv-offset samples. Default 0. */
+    lod?: OutputSocket | number;
 }
 /**
  * Bump — Blender "Bump" node equivalent.
- * Converts a height map into a perturbed surface normal using screen-space derivatives.
+ * Converts a height map into a perturbed surface normal.
  *
  * Inputs:  strength [0-1], distance, height (float), normal (optional override)
+ *          method ('derivative' | 'uv-offset'), uniformName/vector/texelSize/lod
+ *          (uv-offset mode only)
  * Outputs: Normal (color/vec3)
  */
 export declare class Bump extends ProcessNode {
     get nodeType(): string;
     static instanceSpecificDef: boolean;
     get metadata(): NodeMetadata;
-    static glslFunction: string;
+    static derivativeGlslFunction: string;
+    private readonly _method;
+    private readonly _uniformName;
     private readonly _inputs;
     private readonly _outputs;
     constructor(inputs?: BumpInputs);

package/dist/nodes/process/Bump.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Bump.d.ts","sourceRoot":"","sources":["../../../src/nodes/process/Bump.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IAChC,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IAChC,MAAM,CAAC,EAAI,YAAY,CAAA;IACvB,MAAM,CAAC,EAAI,YAAY,CAAA;CACxB;AAED;;;;;;GAMG;AACH,qBAAa,IAAK,SAAQ,WAAW;IACnC,IAAI,QAAQ,WAAoB;IAChC,MAAM,CAAC,mBAAmB,UAAQ;IAElC,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,MAAM,CAAC,YAAY,SA2BnB;IAEA,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;IACnG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmE;gBAEhF,MAAM,GAAE,UAAe;IAWnC,eAAe;IACf,gBAAgB;IAChB,WAAW;IAEX,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CASzC"}
+{"version":3,"file":"Bump.d.ts","sourceRoot":"","sources":["../../../src/nodes/process/Bump.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAIvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IAChC,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IAChC,MAAM,CAAC,EAAI,YAAY,CAAA;IACvB,MAAM,CAAC,EAAI,YAAY,CAAA;IACvB;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAO,YAAY,GAAG,WAAW,CAAA;IACxC,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,kFAAkF;IAClF,MAAM,CAAC,EAAO,YAAY,CAAA;IAC1B,oFAAoF;IACpF,SAAS,CAAC,EAAI,YAAY,GAAG,MAAM,CAAA;IACnC,mEAAmE;IACnE,GAAG,CAAC,EAAU,YAAY,GAAG,MAAM,CAAA;CACpC;AAED;;;;;;;;GAQG;AACH,qBAAa,IAAK,SAAQ,WAAW;IACnC,IAAI,QAAQ,WAAoB;IAKhC,MAAM,CAAC,mBAAmB,UAAO;IAEjC,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,MAAM,CAAC,sBAAsB,SA8BxB;IAEL,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;IACnG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmE;gBAEhF,MAAM,GAAE,UAAe;IA+BnC,eAAe;IACf,gBAAgB;IAEhB,WAAW,IAAI,MAAM;IAarB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CAkDzC"}

package/dist/nodes/process/Bump.js

@@ -1,9 +1,14 @@
 import { ProcessNode } from '../../core/ProcessNode.js';
+import { ShaderNodeError } from '../../core/ShaderNodeError.js';
+import { ShaderConfig } from '../../core/ShaderConfig.js';
+import { assertGlslIdentifier } from '../../core/glslIdentifier.js';
 /**
  * Bump — Blender "Bump" node equivalent.
- * Converts a height map into a perturbed surface normal using screen-space derivatives.
+ * Converts a height map into a perturbed surface normal.
  *
  * Inputs:  strength [0-1], distance, height (float), normal (optional override)
+ *          method ('derivative' | 'uv-offset'), uniformName/vector/texelSize/lod
+ *          (uv-offset mode only)
  * Outputs: Normal (color/vec3)
  */
 export class Bump extends ProcessNode {
@@ -13,53 +18,129 @@ export class Bump extends ProcessNode {
     }
     constructor(inputs = {}) {
         super('Bump');
+        this._method = inputs.method ?? 'derivative';
+        if (this._method === 'uv-offset') {
+            if (ShaderConfig.errorLevel !== 'off' && !inputs.uniformName) {
+                ShaderNodeError.throw({
+                    nodeType: 'Bump',
+                    nodeId: this.id,
+                    problem: 'uniformName is required when method:"uv-offset".',
+                    fix: 'new Bump({ method: "uv-offset", uniformName: "uHeightTex" })\n  After compile(): mat.material.uniforms.uHeightTex = { value: texture }',
+                });
+            }
+            if (inputs.uniformName)
+                assertGlslIdentifier(inputs.uniformName, 'Bump uniformName');
+            this._uniformName = inputs.uniformName ?? null;
+        }
+        else {
+            this._uniformName = null;
+        }
         this._inputs = this.createInputs(inputs, {
             strength: ['float', inputs.strength ?? 1.0],
             distance: ['float', inputs.distance ?? 1.0],
             height: ['float', 0.5],
             normal: ['color', null],
+            vector: ['vector', null],
+            texelSize: ['float', inputs.texelSize ?? 1 / 512],
+            lod: ['float', inputs.lod ?? 0.0],
         });
         this._outputs = this.createOutputs({ Normal: 'color' });
     }
     getInputSockets() { return this._inputs; }
     getOutputSockets() { return this._outputs; }
-    compileDefs() { return Bump.glslFunction; }
+    compileDefs() {
+        if (this._method === 'uv-offset') {
+            return [
+                '#ifndef _ST_BUMP_TEXLOD_EXT',
+                '#define _ST_BUMP_TEXLOD_EXT',
+                '#extension GL_EXT_shader_texture_lod : enable',
+                '#endif',
+                `uniform sampler2D ${this._uniformName};`,
+            ].join('\n');
+        }
+        return Bump.derivativeGlslFunction;
+    }
     compileCall(ctx) {
-        const height = ctx.resolveInput(this._inputs.height);
         const strength = ctx.resolveInput(this._inputs.strength);
         const distance = ctx.resolveInput(this._inputs.distance);
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
+        if (this._method === 'uv-offset') {
+            const uv = this._inputs.vector.isConnected() ? ctx.resolveInput(this._inputs.vector) : 'vUv';
+            const texelSize = ctx.resolveInput(this._inputs.texelSize);
+            const lod = ctx.resolveInput(this._inputs.lod);
+            const id = this.id;
+            const hL = `_bmp_${id}_hL`, hR = `_bmp_${id}_hR`;
+            const hD = `_bmp_${id}_hD`, hU = `_bmp_${id}_hU`;
+            const dPdx = `_bmp_${id}_dPdx`, dPdy = `_bmp_${id}_dPdy`;
+            const dUdx = `_bmp_${id}_dUdx`, dUdy = `_bmp_${id}_dUdy`;
+            const det = `_bmp_${id}_det`, sgn = `_bmp_${id}_sgn`, invDet = `_bmp_${id}_invDet`;
+            const T = `_bmp_${id}_T`, B = `_bmp_${id}_B`;
+            const dhdu = `_bmp_${id}_dhdu`, dhdv = `_bmp_${id}_dhdv`;
+            const scale = `_bmp_${id}_scale`;
+            const ts = `_bmp_${id}_ts`;
+            return [
+                `float ${ts}  = ${texelSize};`,
+                `float ${hL}  = texture2DLodEXT(${this._uniformName}, ${uv} - vec2(${ts}, 0.0), ${lod}).r;`,
+                `float ${hR}  = texture2DLodEXT(${this._uniformName}, ${uv} + vec2(${ts}, 0.0), ${lod}).r;`,
+                `float ${hD}  = texture2DLodEXT(${this._uniformName}, ${uv} - vec2(0.0, ${ts}), ${lod}).r;`,
+                `float ${hU}  = texture2DLodEXT(${this._uniformName}, ${uv} + vec2(0.0, ${ts}), ${lod}).r;`,
+                // Cotangent frame from screen-space derivatives — this builds the tangent
+                // basis (surface-fixed), not the height sample, so it doesn't carry the
+                // camera-distance instability the uv-offset method exists to avoid.
+                `vec3  ${dPdx} = dFdx(vPosition);`,
+                `vec3  ${dPdy} = dFdy(vPosition);`,
+                `vec2  ${dUdx} = dFdx(vUv);`,
+                `vec2  ${dUdy} = dFdy(vUv);`,
+                `float ${det}    = ${dUdx}.x * ${dUdy}.y - ${dUdx}.y * ${dUdy}.x;`,
+                `float ${sgn}    = sign(${det});`,
+                `float ${invDet} = ${sgn} / max(abs(${det}), 1e-6);`,
+                `vec3  ${T} = normalize((${dUdy}.y * ${dPdx} - ${dUdx}.y * ${dPdy}) * ${invDet});`,
+                `vec3  ${B} = normalize(cross(${normal}, ${T})) * ${sgn};`,
+                `float ${dhdu} = (${hR} - ${hL}) / max(2.0 * ${ts}, 1e-6);`,
+                `float ${dhdv} = (${hU} - ${hD}) / max(2.0 * ${ts}, 1e-6);`,
+                `float ${scale} = ${strength} * ${distance} * 50.0;`,
+                `vec3 ${ctx.outputVar(this, 'Normal')} = normalize(${normal} - ${T} * ${dhdu} * ${scale} - ${B} * ${dhdv} * ${scale});`,
+            ].join('\n  ');
+        }
+        const height = ctx.resolveInput(this._inputs.height);
         return `vec3 ${ctx.outputVar(this, 'Normal')} = _st_bump(${height}, ${strength}, ${distance}, ${normal});`;
     }
 }
-Bump.instanceSpecificDef = false;
-Bump.glslFunction = `
-vec3 _st_bump(float height, float strength, float distance, vec3 N) {
-  // Cotangent frame bump — camera-independent.
-  // We derive world-space surface tangent T and bitangent B from the UV
-  // parameterisation (cotangent frame). This gives vectors that are fixed
-  // to the surface regardless of camera orientation.
-  // Then we express the height gradient in UV space (dh/du, dh/dv) which
-  // is also surface-fixed, eliminating the screen-space dependency.
-  vec3 dPdx = dFdx(vPosition);
-  vec3 dPdy = dFdy(vPosition);
-  vec2 dUdx = dFdx(vUv);
-  vec2 dUdy = dFdy(vUv);
-
-  float det    = dUdx.x * dUdy.y - dUdx.y * dUdy.x;
-  float sgn    = sign(det);
-  float invDet = sgn / max(abs(det), 1e-6);
-
-  // World-space tangent and bitangent from UV Jacobian (camera-independent)
-  vec3 T = normalize((dUdy.y * dPdx - dUdx.y * dPdy) * invDet);
-  vec3 B = normalize(cross(N, T)) * sgn;
-
-  // Height gradient in UV space (camera-independent)
-  float dhdu = (dUdy.y * dFdx(height) - dUdx.y * dFdy(height)) * invDet;
-  float dhdv = (dUdx.x * dFdy(height) - dUdy.x * dFdx(height)) * invDet;
-
-  float scale = strength * distance * 50.0;
-  return normalize(N - T * dhdu * scale - B * dhdv * scale);
-}`;
+// Both modes emit their own per-instance defs (a #ifndef-guarded shared function
+// for 'derivative', a per-instance uniform declaration for 'uv-offset' — see
+// compileDefs). instanceSpecificDef:true is required so multiple 'uv-offset'
+// instances each get their own uniform decl instead of being deduped by nodeType.
+Bump.instanceSpecificDef = true;
+Bump.derivativeGlslFunction = `
+#ifndef _ST_BUMP_FN
+#define _ST_BUMP_FN
+vec3 _st_bump(float height, float strength, float distance, vec3 N) {
+  // Cotangent frame bump — camera-independent.
+  // We derive world-space surface tangent T and bitangent B from the UV
+  // parameterisation (cotangent frame). This gives vectors that are fixed
+  // to the surface regardless of camera orientation.
+  // Then we express the height gradient in UV space (dh/du, dh/dv) which
+  // is also surface-fixed, eliminating the screen-space dependency.
+  vec3 dPdx = dFdx(vPosition);
+  vec3 dPdy = dFdy(vPosition);
+  vec2 dUdx = dFdx(vUv);
+  vec2 dUdy = dFdy(vUv);
+
+  float det    = dUdx.x * dUdy.y - dUdx.y * dUdy.x;
+  float sgn    = sign(det);
+  float invDet = sgn / max(abs(det), 1e-6);
+
+  // World-space tangent and bitangent from UV Jacobian (camera-independent)
+  vec3 T = normalize((dUdy.y * dPdx - dUdx.y * dPdy) * invDet);
+  vec3 B = normalize(cross(N, T)) * sgn;
+
+  // Height gradient in UV space (camera-independent)
+  float dhdu = (dUdy.y * dFdx(height) - dUdx.y * dFdy(height)) * invDet;
+  float dhdv = (dUdx.x * dFdy(height) - dUdy.x * dFdx(height)) * invDet;
+
+  float scale = strength * distance * 50.0;
+  return normalize(N - T * dhdu * scale - B * dhdv * scale);
+}
+#endif`;

package/dist/nodes/process/DiffuseBSDF.js

@@ -29,15 +29,15 @@ export class DiffuseBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_diffuseBSDF(${color}, ${roughness}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_diffuseBSDF(${color}, ${roughness}, ${normal}), 1.0);`;
     }
 }
 DiffuseBSDF.instanceSpecificDef = false;
-DiffuseBSDF.glslFunction = `
-vec3 _st_diffuseBSDF(vec3 color, float roughness, vec3 N) {
-  vec3  L       = normalize(vec3(1.0, 2.0, 1.0));
-  float NdotL   = max(dot(N, L), 0.0);
-  float diffuse = NdotL / 3.14159265;
-  vec3  ambient = color * 0.15;
-  return ambient + color * (diffuse * (1.0 - roughness * 0.5));
+DiffuseBSDF.glslFunction = `
+vec3 _st_diffuseBSDF(vec3 color, float roughness, vec3 N) {
+  vec3  L       = normalize(vec3(1.0, 2.0, 1.0));
+  float NdotL   = max(dot(N, L), 0.0);
+  float diffuse = NdotL / 3.14159265;
+  vec3  ambient = color * 0.15;
+  return ambient + color * (diffuse * (1.0 - roughness * 0.5));
 }`;

package/dist/nodes/process/Emission.js

@@ -26,11 +26,11 @@ export class Emission extends ProcessNode {
     compileCall(ctx) {
         const color = ctx.resolveInput(this._inputs.color);
         const strength = ctx.resolveInput(this._inputs.strength);
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_emission(${color}, ${strength});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_emission(${color}, ${strength}), 1.0);`;
     }
 }
 Emission.instanceSpecificDef = false;
-Emission.glslFunction = `
-vec3 _st_emission(vec3 color, float strength) {
-  return color * strength;
+Emission.glslFunction = `
+vec3 _st_emission(vec3 color, float strength) {
+  return color * strength;
 }`;

package/dist/nodes/process/GlassBSDF.js

@@ -31,21 +31,21 @@ export class GlassBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_glassBSDF(${color}, ${roughness}, ${ior}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_glassBSDF(${color}, ${roughness}, ${ior}, ${normal}), 1.0);`;
     }
 }
 GlassBSDF.instanceSpecificDef = false;
-GlassBSDF.glslFunction = `
-vec3 _st_glassBSDF(vec3 color, float roughness, float ior, vec3 N) {
-  vec3  V       = normalize(cameraPosition - vPosition);
-  vec3  L       = normalize(vec3(1.0, 2.0, 1.0));
-  vec3  H       = normalize(L + V);
-  float F0      = pow((1.0 - ior) / (1.0 + ior), 2.0);
-  float fresnel = F0 + (1.0 - F0) * pow(1.0 - max(dot(V, N), 0.0), 5.0);
-  float NdotH   = max(dot(N, H), 0.0);
-  float a2      = roughness * roughness * roughness * roughness;
-  float D       = a2 / max(3.14159 * pow(NdotH * NdotH * (a2 - 1.0) + 1.0, 2.0), 0.0001);
-  vec3  spec    = vec3(1.0) * D * fresnel;
-  vec3  refr    = color * (1.0 - fresnel) * (1.0 - roughness * 0.3);
-  return spec + refr;
+GlassBSDF.glslFunction = `
+vec3 _st_glassBSDF(vec3 color, float roughness, float ior, vec3 N) {
+  vec3  V       = normalize(cameraPosition - vPosition);
+  vec3  L       = normalize(vec3(1.0, 2.0, 1.0));
+  vec3  H       = normalize(L + V);
+  float F0      = pow((1.0 - ior) / (1.0 + ior), 2.0);
+  float fresnel = F0 + (1.0 - F0) * pow(1.0 - max(dot(V, N), 0.0), 5.0);
+  float NdotH   = max(dot(N, H), 0.0);
+  float a2      = roughness * roughness * roughness * roughness;
+  float D       = a2 / max(3.14159 * pow(NdotH * NdotH * (a2 - 1.0) + 1.0, 2.0), 0.0001);
+  vec3  spec    = vec3(1.0) * D * fresnel;
+  vec3  refr    = color * (1.0 - fresnel) * (1.0 - roughness * 0.3);
+  return spec + refr;
 }`;

package/dist/nodes/process/GlossyBSDF.js

@@ -29,22 +29,22 @@ export class GlossyBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_glossyBSDF(${color}, ${roughness}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_glossyBSDF(${color}, ${roughness}, ${normal}), 1.0);`;
     }
 }
 GlossyBSDF.instanceSpecificDef = false;
-GlossyBSDF.glslFunction = `
-vec3 _st_glossyBSDF(vec3 color, float roughness, vec3 N) {
-  vec3  L     = normalize(vec3(1.0, 2.0, 1.0));
-  vec3  V     = normalize(cameraPosition - vPosition);
-  vec3  H     = normalize(L + V);
-  float a     = roughness * roughness;
-  float a2    = a * a;
-  float NdotH = max(dot(N, H), 0.0);
-  float D     = a2 / max(3.14159265 * pow(NdotH * NdotH * (a2 - 1.0) + 1.0, 2.0), 0.0001);
-  float NdotL = max(dot(N, L), 0.0);
-  float NdotV = max(dot(N, V), 0.0001);
-  float k     = (roughness + 1.0) * (roughness + 1.0) / 8.0;
-  float G     = (NdotL / (NdotL * (1.0 - k) + k)) * (NdotV / (NdotV * (1.0 - k) + k));
-  return color * D * G / max(4.0 * NdotL * NdotV, 0.0001) * NdotL;
+GlossyBSDF.glslFunction = `
+vec3 _st_glossyBSDF(vec3 color, float roughness, vec3 N) {
+  vec3  L     = normalize(vec3(1.0, 2.0, 1.0));
+  vec3  V     = normalize(cameraPosition - vPosition);
+  vec3  H     = normalize(L + V);
+  float a     = roughness * roughness;
+  float a2    = a * a;
+  float NdotH = max(dot(N, H), 0.0);
+  float D     = a2 / max(3.14159265 * pow(NdotH * NdotH * (a2 - 1.0) + 1.0, 2.0), 0.0001);
+  float NdotL = max(dot(N, L), 0.0);
+  float NdotV = max(dot(N, V), 0.0001);
+  float k     = (roughness + 1.0) * (roughness + 1.0) / 8.0;
+  float G     = (NdotL / (NdotL * (1.0 - k) + k)) * (NdotV / (NdotV * (1.0 - k) + k));
+  return color * D * G / max(4.0 * NdotL * NdotV, 0.0001) * NdotL;
 }`;

package/dist/nodes/process/MixShader.js

@@ -37,11 +37,11 @@ export class MixShader extends ProcessNode {
         const fac = ctx.resolveInput(this._inputs.fac);
         const shader1 = ctx.resolveInput(this._inputs.shader1);
         const shader2 = ctx.resolveInput(this._inputs.shader2);
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_mixShader(${fac}, ${shader1}, ${shader2});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = _st_mixShader(${fac}, ${shader1}, ${shader2});`;
     }
 }
 MixShader.instanceSpecificDef = false;
-MixShader.glslFunction = `
-vec3 _st_mixShader(float fac, vec3 a, vec3 b) {
-  return mix(a, b, clamp(fac, 0.0, 1.0));
+MixShader.glslFunction = `
+vec4 _st_mixShader(float fac, vec4 a, vec4 b) {
+  return mix(a, b, clamp(fac, 0.0, 1.0));
 }`;

package/dist/nodes/process/PrincipledBSDF.d.ts

@@ -27,6 +27,13 @@ export declare class PrincipledBSDF extends ProcessNode {
     getInputSockets(): Record<string, import("../../index.js").InputSocket<unknown>>;
     getOutputSockets(): Record<string, OutputSocket>;
     compileDefs(): string;
+    /**
+     * Alpha has no channel of its own in the underlying vec3 lighting function —
+     * it's applied as the vec4 alpha component at the call site instead (see
+     * compileCall). transparent:true is needed whenever alpha can read below 1.0:
+     * a non-default literal, or any live/connected value (conservatively true).
+     */
+    wantsTransparency(): boolean;
     compileCall(ctx: CompileContext): string;
 }
 //# sourceMappingURL=PrincipledBSDF.d.ts.map

package/dist/nodes/process/PrincipledBSDF.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PrincipledBSDF.d.ts","sourceRoot":"","sources":["../../../src/nodes/process/PrincipledBSDF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,EAAG,YAAY,GAAG,MAAM,CAAA;IACjC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACjC,GAAG,CAAC,EAAQ,YAAY,GAAG,MAAM,CAAA;IACjC,KAAK,CAAC,EAAM,YAAY,GAAG,MAAM,CAAA;IACjC,MAAM,CAAC,EAAK,YAAY,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,QAAQ,WAA8B;IAC1C,MAAM,CAAC,mBAAmB,UAAQ;IAElC,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,MAAM,CAAC,YAAY,SAuCnB;IAEA,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;IACnG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmE;gBAEhF,MAAM,GAAE,oBAAyB;IAa7C,eAAe;IACf,gBAAgB;IAChB,WAAW;IAEX,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CAMzC"}
+{"version":3,"file":"PrincipledBSDF.d.ts","sourceRoot":"","sources":["../../../src/nodes/process/PrincipledBSDF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,EAAG,YAAY,GAAG,MAAM,CAAA;IACjC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACjC,GAAG,CAAC,EAAQ,YAAY,GAAG,MAAM,CAAA;IACjC,KAAK,CAAC,EAAM,YAAY,GAAG,MAAM,CAAA;IACjC,MAAM,CAAC,EAAK,YAAY,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,QAAQ,WAA8B;IAC1C,MAAM,CAAC,mBAAmB,UAAQ;IAElC,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,MAAM,CAAC,YAAY,SAuCnB;IAEA,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;IACnG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmE;gBAEhF,MAAM,GAAE,oBAAyB;IAa7C,eAAe;IACf,gBAAgB;IAChB,WAAW;IAEX;;;;;OAKG;IACH,iBAAiB,IAAI,OAAO;IAO5B,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CAQzC"}