@zephyr3d/scene 0.9.5 → 0.9.7

package/dist/material/shader/helper.js

@@ -1,5 +1,5 @@
 import { Vector3, Vector4, Vector2 } from '@zephyr3d/base';
-import { RENDER_PASS_TYPE_DEPTH, RENDER_PASS_TYPE_SHADOWMAP, RENDER_PASS_TYPE_OBJECT_COLOR, RENDER_PASS_TYPE_LIGHT, MaterialVaryingFlags, MORPH_WEIGHTS_VECTOR_COUNT, MORPH_TARGET_POSITION, MORPH_TARGET_NORMAL, MORPH_TARGET_TANGENT, MORPH_ATTRIBUTE_VECTOR_COUNT } from '../../values.js';
+import { RENDER_PASS_TYPE_DEPTH, RENDER_PASS_TYPE_SHADOWMAP, RENDER_PASS_TYPE_OBJECT_COLOR, RENDER_PASS_TYPE_LIGHT, MaterialVaryingFlags, MAX_CLUSTERED_LIGHTS, MORPH_WEIGHTS_VECTOR_COUNT, MORPH_TARGET_POSITION, MORPH_TARGET_NORMAL, MORPH_TARGET_TANGENT, MORPH_ATTRIBUTE_VECTOR_COUNT } from '../../values.js';
 import { ProgramBuilder } from '@zephyr3d/device';
 import { decodeNormalizedFloatFromRGBA, linearToGamma } from '../../shaders/misc.js';
 import { fetchSampler } from '../../utility/misc.js';
@@ -31,9 +31,9 @@ const UNIFORM_NAME_BONE_TEXTURE_SIZE = 'Z_UniformBoneTexSize';
 const UNIFORM_NAME_BONE_INV_BIND_MATRIX = 'Z_UniformBoneInvBindMatrix';
 const UNIFORM_NAME_MORPH_DATA = 'Z_UniformMorphData';
 const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
-/**
- * Helper shader functions for the builtin material system
- * @public
+/**
+ * Helper shader functions for the builtin material system
+ * @public
  */ class ShaderHelper {
     static BILLBOARD_SPHERICAL = 1;
     static BILLBOARD_SYLINDRAL = 2;
@@ -45,7 +45,6 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
     /** @internal */ static _drawableBindGroupLayouts = {};
     /** @internal */ static _lightUniformShadow = {
         sunDir: new Vector3(),
-        envLightStrength: 1,
         shadowCascades: 1,
         positionAndRange: new Vector4(),
         directionAndCutoff: new Vector4(),
@@ -55,7 +54,10 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
         depthBiasValues: new Vector4(),
         shadowCameraParams: new Vector4(),
         depthBiasScales: new Vector4(),
-        shadowMatrices: new Float32Array(16 * 4)
+        shadowMatrices: new Float32Array(16 * 4),
+        shadowStrength: 1,
+        envLightStrength: 1,
+        envLightSpecularStrength: 1
     };
     /** @internal */ static _fogUniforms = {
         withAerialPerspective: 0,
@@ -122,25 +124,25 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
         }
         return bindGroupLayout;
     }
-    /**
-   * Prepares the fragment shader which is going to be used in our material system
-   *
-   * @remarks
-   * This function will setup all nessesary uniforms acoording to the drawing context
-   *
-   * @param pb - The program builder
-   * @param ctx - The drawing context
+    /**
+   * Prepares the fragment shader which is going to be used in our material system
+   *
+   * @remarks
+   * This function will setup all nessesary uniforms acoording to the drawing context
+   *
+   * @param pb - The program builder
+   * @param ctx - The drawing context
    */ static prepareFragmentShader(pb, ctx) {
         this.setupGlobalUniforms(pb, ctx);
     }
-    /**
-   * Prepares the vertex shader which is going to be used in our material system
-   *
-   * @remarks
-   * This function will setup all nessesary uniforms according to the drawing context
-   *
-   * @param pb - The program builder
-   * @param ctx - The drawing context
+    /**
+   * Prepares the vertex shader which is going to be used in our material system
+   *
+   * @remarks
+   * This function will setup all nessesary uniforms according to the drawing context
+   *
+   * @param pb - The program builder
+   * @param ctx - The drawing context
    */ static prepareVertexShader(pb, ctx) {
         this.setupGlobalUniforms(pb, ctx);
         this.prepareVertexShaderCommon(pb, ctx);
@@ -164,6 +166,7 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             pb.vec2('renderSize'),
             pb.vec2('jitterValue'),
             pb.float('roughnessFactor'),
+            pb.float('shadowDebugCascades'),
             pb.float('frameDeltaTime'),
             pb.float('elapsedTime'),
             pb.int('framestamp')
@@ -207,10 +210,13 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
                 pb.vec4('shadowCameraParams'),
                 pb.vec4('depthBiasScales'),
                 pb.vec4[16]('shadowMatrices'),
-                pb.float('envLightStrength')
+                pb.float('shadowStrength'),
+                pb.float('envLightStrength'),
+                pb.float('envLightSpecularStrength')
             ]) : pb.defineStruct([
                 pb.vec3('sunDir'),
                 pb.float('envLightStrength'),
+                pb.float('envLightSpecularStrength'),
                 pb.vec4('clusterParams'),
                 pb.ivec4('countParams'),
                 pb.ivec2('lightIndexTexSize')
@@ -218,7 +224,7 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             scope.camera = cameraStruct().uniform(0);
             scope.light = lightStruct().uniform(0);
             if (useClusteredLighting) {
-                scope[UNIFORM_NAME_LIGHT_BUFFER] = pb.vec4[(this.getMaxClusteredLightCount() + 1) * 4]().uniformBuffer(0);
+                scope[UNIFORM_NAME_LIGHT_BUFFER] = pb.vec4[(MAX_CLUSTERED_LIGHTS + 1) * 4]().uniformBuffer(0);
                 scope[UNIFORM_NAME_LIGHT_INDEX_TEXTURE] = (pb.getDevice().type === 'webgl' ? pb.tex2D() : pb.utex2D()).uniform(0);
             }
             scope[UNIFORM_NAME_BAKED_SKY_MAP] = pb.texCube().uniform(0);
@@ -248,30 +254,30 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             }
         }
     }
-    /**
-   * This function checks if the shader needs to process skeletal animation.
-   *
-   * @param scope - Current shader scope
-   *
-   * @returns true if the shader needs to process skeletal animation, otherwise false.
+    /**
+   * This function checks if the shader needs to process skeletal animation.
+   *
+   * @param scope - Current shader scope
+   *
+   * @returns true if the shader needs to process skeletal animation, otherwise false.
    */ static hasSkinning(scope) {
         return !!scope[UNIFORM_NAME_BONE_MATRICES];
     }
-    /**
-   * This function checks if the shader needs to process morph target animation.
-   *
-   * @param scope - Current shader scope
-   *
-   * @returns true if the shader needs to process morph target animation, otherwise false.
+    /**
+   * This function checks if the shader needs to process morph target animation.
+   *
+   * @param scope - Current shader scope
+   *
+   * @returns true if the shader needs to process morph target animation, otherwise false.
    */ static hasMorphing(scope) {
         return !!scope[UNIFORM_NAME_MORPH_DATA];
     }
-    /**
-   * Calculate skinning matrix for current vertex
-   *
-   * @param scope - Current shader scope
-   *
-   * @returns Skinning matrix for current vertex, or null if there is not skeletal animation
+    /**
+   * Calculate skinning matrix for current vertex
+   *
+   * @param scope - Current shader scope
+   *
+   * @returns Skinning matrix for current vertex, or null if there is not skeletal animation
    */ static calculateSkinMatrix(scope) {
         if (!this.hasSkinning(scope)) {
             return null;
@@ -426,12 +432,12 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             scope.$l[that.SKIN_PREV_MATRIX_NAME] = scope[funcNameGetSkinningMatrix](scope[that.SKIN_BONE_OFFSET].y);
         }
     }
-    /**
-   * Calculates the vertex position of type vec3 in object space
-   *
-   * @param scope - Current shader scope
-   * @param skinMatrix - The skinning matrix if there is skeletal animation, otherwise null
-   * @returns The calculated vertex position in object space, or null if pos is null
+    /**
+   * Calculates the vertex position of type vec3 in object space
+   *
+   * @param scope - Current shader scope
+   * @param skinMatrix - The skinning matrix if there is skeletal animation, otherwise null
+   * @returns The calculated vertex position in object space, or null if pos is null
    */ static resolveVertexPosition(scope) {
         const pb = scope.$builder;
         if (pb.shaderKind !== 'vertex') {
@@ -473,12 +479,12 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
         });
         return scope[that.SKIN_MATRIX_NAME] && scope[that.SKIN_PREV_MATRIX_NAME] ? scope.Z_resolveVertexPosition(scope[that.SKIN_MATRIX_NAME], scope[that.SKIN_PREV_MATRIX_NAME]) : scope[that.SKIN_MATRIX_NAME] ? scope.Z_resolveVertexPosition(scope[that.SKIN_MATRIX_NAME]) : scope.Z_resolveVertexPosition();
     }
-    /**
-   * Resolve motion vector
-   *
-   * @param scope - Current shader scope
-   * @param worldPos - Current object position in world space
-   * @param prevWorldPos - Previous object position in world space
+    /**
+   * Resolve motion vector
+   *
+   * @param scope - Current shader scope
+   * @param worldPos - Current object position in world space
+   * @param prevWorldPos - Previous object position in world space
    */ static resolveMotionVector(scope, worldPos, prevWorldPos) {
         const that = this;
         const pb = scope.$builder;
@@ -489,13 +495,13 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             scope.$outputs.zMotionVectorPosPrev = pb.mul(prevUnjitteredVPMatrix, pb.vec4(prevWorldPos.xyz, 1));
         }
     }
-    /**
-   * Calculates the normal vector of type vec3 in object space
-   *
-   * @param scope - Current shader scope
-   * @param normal - Vertex normal input, must be type of vec3, null if no vertex normal input
-   * @param skinMatrix - The skinning matrix if there is skeletal animation, otherwise null
-   * @returns The calculated normal vector in object space, or null if normal is null
+    /**
+   * Calculates the normal vector of type vec3 in object space
+   *
+   * @param scope - Current shader scope
+   * @param normal - Vertex normal input, must be type of vec3, null if no vertex normal input
+   * @param skinMatrix - The skinning matrix if there is skeletal animation, otherwise null
+   * @returns The calculated normal vector in object space, or null if normal is null
    */ static resolveVertexNormal(scope, normal) {
         const pb = scope.$builder;
         if (pb.shaderKind !== 'vertex') {
@@ -520,13 +526,13 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             return normal;
         }
     }
-    /**
-   * Calculates the tangent vector of type vec3 in object space
-   *
-   * @param scope - Current shader scope
-   * @param tangent - Vertex tangent input, must be type of vec4, null if no vertex tangent input
-   * @param skinMatrix - The skinning matrix if there is skeletal animation, otherwise null
-   * @returns The calculated tangent vector of type vec4 in object space, or null if tangent is null
+    /**
+   * Calculates the tangent vector of type vec3 in object space
+   *
+   * @param scope - Current shader scope
+   * @param tangent - Vertex tangent input, must be type of vec4, null if no vertex tangent input
+   * @param skinMatrix - The skinning matrix if there is skeletal animation, otherwise null
+   * @returns The calculated tangent vector of type vec4 in object space, or null if tangent is null
    */ static resolveVertexTangent(scope, tangent) {
         const pb = scope.$builder;
         if (pb.shaderKind !== 'vertex') {
@@ -551,18 +557,18 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             return tangent;
         }
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the world matrix of current object to be drawn
-   * @param scope - Current shader scope
-   * @returns The world matrix of current object to be drawn
+    /**
+   * Gets the uniform variable of type mat4 which holds the world matrix of current object to be drawn
+   * @param scope - Current shader scope
+   * @returns The world matrix of current object to be drawn
    */ static getWorldMatrix(scope) {
         const pb = scope.$builder;
         return scope[UNIFORM_NAME_WORLD_MATRIX] ?? pb.mat4(this.getInstancedUniform(scope, 0), this.getInstancedUniform(scope, 1), this.getInstancedUniform(scope, 2), this.getInstancedUniform(scope, 3));
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the world matrix at previous frame of current object to be drawn
-   * @param scope - Current shader scope
-   * @returns The world matrix at previous frame of current object to be drawn
+    /**
+   * Gets the uniform variable of type mat4 which holds the world matrix at previous frame of current object to be drawn
+   * @param scope - Current shader scope
+   * @returns The world matrix at previous frame of current object to be drawn
    */ static getPrevWorldMatrix(scope) {
         const pb = scope.$builder;
         const that = this;
@@ -593,28 +599,28 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             return scope.Z_getPrevWorldMatrix(framestamp);
         }
     }
-    /**
-   * Gets the instance uniform value of type vec4 by uniform index
-   * @param scope - Current shader scope
-   * @returns instance uniform value
+    /**
+   * Gets the instance uniform value of type vec4 by uniform index
+   * @param scope - Current shader scope
+   * @returns instance uniform value
    */ static getInstancedUniform(scope, uniformIndex) {
         const pb = scope.$builder;
         return scope[UNIFORM_NAME_INSTANCE_DATA].at(pb.add(pb.mul(scope[UNIFORM_NAME_INSTANCE_DATA_STRIDE], pb.uint(scope.$builtins.instanceIndex)), scope[UNIFORM_NAME_INSTANCE_DATA_OFFSET], pb.uint(uniformIndex)));
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the normal matrix of current object to be drawn
-   *
-   * @param scope - Current shader scope
-   * @returns The normal matrix of current object to be drawn
+    /**
+   * Gets the uniform variable of type mat4 which holds the normal matrix of current object to be drawn
+   *
+   * @param scope - Current shader scope
+   * @returns The normal matrix of current object to be drawn
    */ static getNormalMatrix(scope) {
         return this.getWorldMatrix(scope);
     }
-    /**
-   * Vertex shader drawable stuff
-   *
-   * @param scope - Current shader scope
-   * @param skinning - true if skinning is used, otherwise false.
-   * @param instanced - true if instancing is used, otherwise false.
+    /**
+   * Vertex shader drawable stuff
+   *
+   * @param scope - Current shader scope
+   * @param skinning - true if skinning is used, otherwise false.
+   * @param instanced - true if instancing is used, otherwise false.
    */ static vertexShaderDrawableStuff(scope, skinning, morphing, instanced) {
         const pb = scope.$builder;
         if (instanced) {
@@ -657,6 +663,7 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             worldMatrix: camera.worldMatrix,
             params: new Vector4(camera.getNearPlane(), camera.getFarPlane(), ctx.flip ? -1 : 1, linear ? 0 : 1),
             roughnessFactor: camera.SSR ? camera.ssrRoughnessFactor : 1,
+            shadowDebugCascades: camera.shadowDebugCascades ? 1 : 0,
             frameDeltaTime: ctx.device.frameInfo.elapsedFrame * 0.001,
             elapsedTime: ctx.device.frameInfo.elapsedOverall * 0.001,
             framestamp: ctx.device.frameInfo.frameCounter
@@ -708,6 +715,7 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             clusterParams: clusterParams,
             countParams: countParams,
             envLightStrength: ctx.env.light.strength ?? 0,
+            envLightSpecularStrength: ctx.env.light.specularStrength ?? 1,
             lightIndexTexSize: new Int32Array([
                 lightIndexTexture.width,
                 lightIndexTexture.height
@@ -723,7 +731,6 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
     /** @internal */ static setLightUniformsShadow(bindGroup, ctx, light) {
         const shadowMapParams = ctx.shadowMapInfo.get(light);
         this._lightUniformShadow.sunDir = ctx.sunLight ? ctx.sunLight.directionAndCutoff.xyz().scaleBy(-1) : this.defaultSunDir;
-        this._lightUniformShadow.envLightStrength = ctx.env?.light.strength ?? 0;
         this._lightUniformShadow.shadowCascades = shadowMapParams.numShadowCascades;
         this._lightUniformShadow.positionAndRange.set(light.positionAndRange);
         this._lightUniformShadow.directionAndCutoff.set(light.directionAndCutoff);
@@ -734,6 +741,9 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
         this._lightUniformShadow.shadowCameraParams.set(shadowMapParams.cameraParams);
         this._lightUniformShadow.depthBiasScales.set(shadowMapParams.depthBiasScales);
         this._lightUniformShadow.shadowMatrices.set(shadowMapParams.shadowMatrices);
+        this._lightUniformShadow.shadowStrength = light.shadow.shadowStrength;
+        this._lightUniformShadow.envLightStrength = ctx.env?.light.strength ?? 0;
+        this._lightUniformShadow.envLightSpecularStrength = ctx.env?.light.specularStrength ?? 1;
         bindGroup.setValue('light', this._lightUniformShadow);
         bindGroup.setTexture(UNIFORM_NAME_SHADOW_MAP, shadowMapParams.shadowMap, shadowMapParams.shadowMapSampler);
         bindGroup.setTexture(UNIFORM_NAME_BAKED_SKY_MAP, ctx.scene.env.sky.getBakedSkyTexture(ctx));
@@ -741,133 +751,144 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             ctx.env.light.envLight.updateBindGroup(bindGroup);
         }
     }
-    /**
-   * Gets the uniform variable of type float which holds the strength of the environment light
-   *
-   * @remarks
-   * This function can only be used in the fragment shader
-   *
-   * @param scope - Current shader scope
-   * @returns The uniform variable of which presents the strength of the environment light
+    /**
+   * Gets the uniform variable of type float which holds the strength of the environment light
+   *
+   * @remarks
+   * This function can only be used in the fragment shader
+   *
+   * @param scope - Current shader scope
+   * @returns The uniform variable of which presents the strength of the environment light
    */ static getEnvLightStrength(scope) {
         return scope.light.envLightStrength;
     }
-    /**
-   * Gets current scene color texture
-   * @param scope - Current shader scope
-   * @returns current scene color texture
+    /**
+   * Gets the uniform variable of type float which holds the specular strength of the environment light
+   *
+   * @remarks
+   * This function can only be used in the fragment shader
+   *
+   * @param scope - Current shader scope
+   * @returns The uniform variable which presents the specular strength of the environment light
+   */ static getEnvLightSpecularStrength(scope) {
+        return scope.light.envLightSpecularStrength ?? scope.$builder.float(1);
+    }
+    /**
+   * Gets current scene color texture
+   * @param scope - Current shader scope
+   * @returns current scene color texture
    */ static getSceneColorTexture(scope) {
         return scope[UNIFORM_NAME_SCENE_COLOR_MAP];
     }
-    /**
-   * Gets the size of current scene color texture
-   * @param scope - Current shader scope
-   * @returns The size of current scene color texture
+    /**
+   * Gets the size of current scene color texture
+   * @param scope - Current shader scope
+   * @returns The size of current scene color texture
    */ static getSceneColorTextureSize(scope) {
         return scope[UNIFORM_NAME_SCENE_COLOR_MAP_SIZE];
     }
-    /**
-   * Gets current linear depth texture
-   * @param scope - Current shader scope
-   * @returns current linear depth texture
+    /**
+   * Gets current linear depth texture
+   * @param scope - Current shader scope
+   * @returns current linear depth texture
    */ static getLinearDepthTexture(scope) {
         return scope[UNIFORM_NAME_LINEAR_DEPTH_MAP];
     }
-    /**
-   * Gets the size of current linear depth texture
-   * @param scope - Current shader scope
-   * @returns The size of current linear depth texture
+    /**
+   * Gets the size of current linear depth texture
+   * @param scope - Current shader scope
+   * @returns The size of current linear depth texture
    */ static getLinearDepthTextureSize(scope) {
         return scope[UNIFORM_NAME_LINEAR_DEPTH_MAP_SIZE];
     }
-    /**
-   * Gets current HiZ depth texture
-   * @param scope - Current shader scope
-   * @returns current HiZ depth texture
+    /**
+   * Gets current HiZ depth texture
+   * @param scope - Current shader scope
+   * @returns current HiZ depth texture
    */ static getHiZDepthTexture(scope) {
         return scope[UNIFORM_NAME_HIZ_DEPTH_MAP];
     }
-    /**
-   * Gets the size of current HiZ depth texture
-   * @param scope - Current shader scope
-   * @returns The size of current HiZ depth texture
+    /**
+   * Gets the size of current HiZ depth texture
+   * @param scope - Current shader scope
+   * @returns The size of current HiZ depth texture
    */ static getHiZDepthTextureSize(scope) {
         return scope[UNIFORM_NAME_HIZ_DEPTH_MAP_INFO].xy;
     }
-    /**
-   * Gets the mipmap levels count of current HiZ depth texture
-   * @param scope - Current shader scope
-   * @returns The mipmap levels count of current HiZ depth texture
+    /**
+   * Gets the mipmap levels count of current HiZ depth texture
+   * @param scope - Current shader scope
+   * @returns The mipmap levels count of current HiZ depth texture
    */ static getHiZDepthTextureMipLevelCount(scope) {
         return scope[UNIFORM_NAME_HIZ_DEPTH_MAP_INFO].z;
     }
-    /**
-   * Gets current baked skybox texture
-   * @param scope - Current shader scope
-   * @returns current baked skybox texture
+    /**
+   * Gets current baked skybox texture
+   * @param scope - Current shader scope
+   * @returns current baked skybox texture
    */ static getBakedSkyTexture(scope) {
         return scope[UNIFORM_NAME_BAKED_SKY_MAP];
     }
-    /**
-   * Gets the elapsed time in seconds
-   * @param scope - Current shader scope
-   * @returns The elapsed time in seconds
+    /**
+   * Gets the elapsed time in seconds
+   * @param scope - Current shader scope
+   * @returns The elapsed time in seconds
    */ static getElapsedTime(scope) {
         return scope.camera.elapsedTime;
     }
-    /**
-   * Gets the elapsed time since last frame in seconds
-   * @param scope - Current shader scope
-   * @returns The elapsed time since last frame in seconds
+    /**
+   * Gets the elapsed time since last frame in seconds
+   * @param scope - Current shader scope
+   * @returns The elapsed time since last frame in seconds
    */ static getElapsedTimeFrame(scope) {
         return scope.camera.frameDeltaTime;
     }
-    /**
-   * Gets the uniform variable of type vec3 which holds the camera position
-   * @param scope - Current shader scope
-   * @returns The camera position
+    /**
+   * Gets the uniform variable of type vec3 which holds the camera position
+   * @param scope - Current shader scope
+   * @returns The camera position
    */ static getCameraPosition(scope) {
         return scope.camera.position.xyz;
     }
-    /**
-   * Gets the uniform variable of type float which holds the roughness factor
-   * @param scope - Current shader scope
-   * @returns The roughness factor
+    /**
+   * Gets the uniform variable of type float which holds the roughness factor
+   * @param scope - Current shader scope
+   * @returns The roughness factor
    */ static getCameraRoughnessFactor(scope) {
         return scope.camera.roughnessFactor;
     }
-    /**
-   * Gets framebuffer size for rendering
-   * @param scope - Current shader scope
-   * @returns The roughness factor
+    /**
+   * Gets framebuffer size for rendering
+   * @param scope - Current shader scope
+   * @returns The roughness factor
    */ static getRenderSize(scope) {
         return scope.camera.renderSize;
     }
-    /**
-   * Gets the uniform variable of type uint which holds the framestamp
-   * @param scope - Current shader scope
-   * @returns The framestamp
+    /**
+   * Gets the uniform variable of type uint which holds the framestamp
+   * @param scope - Current shader scope
+   * @returns The framestamp
    */ static getFramestamp(scope) {
         return scope.camera.framestamp;
     }
-    /**
-   * Gets the clip plane flag
-   * @param scope - Current shader scope
-   * @returns A float value of 1 indices the clip plane presents, otherwise 0
+    /**
+   * Gets the clip plane flag
+   * @param scope - Current shader scope
+   * @returns A float value of 1 indices the clip plane presents, otherwise 0
    */ static getCameraClipPlaneFlag(scope) {
         return scope.camera.position.w;
     }
-    /**
-   * Gets the clip plane
-   * @param scope - Current shader scope
-   * @returns A vec4 presents the clip plane
+    /**
+   * Gets the clip plane
+   * @param scope - Current shader scope
+   * @returns A vec4 presents the clip plane
    */ static getCameraClipPlane(scope) {
         return scope.camera.clipPlane;
     }
-    /**
-   * Gets the uniform variable of type vec4 which holds the camera parameters
-   * @param scope - Current shader scope
-   * @returns The camera parameters
+    /**
+   * Gets the uniform variable of type vec4 which holds the camera parameters
+   * @param scope - Current shader scope
+   * @returns The camera parameters
    */ static getCameraParams(scope) {
         return scope.camera.params;
     }
@@ -880,87 +901,87 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
     /** @internal */ static getClusteredLightIndexTexture(scope) {
         return scope[UNIFORM_NAME_LIGHT_INDEX_TEXTURE];
     }
-    /**
-   * Gets the uniform variable that contains atmosphere parameters
-   * @param scope - Current shader scope
-   * @returns The atmosphere parameters
+    /**
+   * Gets the uniform variable that contains atmosphere parameters
+   * @param scope - Current shader scope
+   * @returns The atmosphere parameters
    */ static getAtmosphereParams(scope) {
         return scope.fog.atmosphereParams;
     }
-    /**
-   * Gets the aerial perspective LUT
-   * @param scope - Current shader scope
-   * @returns The aerial perspective LUT texture
+    /**
+   * Gets the aerial perspective LUT
+   * @param scope - Current shader scope
+   * @returns The aerial perspective LUT texture
    */ static getAerialPerspectiveLUT(scope) {
         return scope[UNIFORM_NAME_AERIALPERSPECTIVE_LUT];
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the view projection matrix of current camera
-   * @param scope - Current shader scope
-   * @returns The view projection matrix of current camera
+    /**
+   * Gets the uniform variable of type mat4 which holds the view projection matrix of current camera
+   * @param scope - Current shader scope
+   * @returns The view projection matrix of current camera
    */ static getViewProjectionMatrix(scope) {
         return scope.camera.viewProjectionMatrix;
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the inversed view projection matrix of current camera
-   * @param scope - Current shader scope
-   * @returns The inversed view projection matrix of current camera
+    /**
+   * Gets the uniform variable of type mat4 which holds the inversed view projection matrix of current camera
+   * @param scope - Current shader scope
+   * @returns The inversed view projection matrix of current camera
    */ static getInvViewProjectionMatrix(scope) {
         return scope.camera.invViewProjectionMatrix;
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the projection matrix of current camera
-   * @param scope - Current shader scope
-   * @returns The projection matrix of current camera
+    /**
+   * Gets the uniform variable of type mat4 which holds the projection matrix of current camera
+   * @param scope - Current shader scope
+   * @returns The projection matrix of current camera
    */ static getProjectionMatrix(scope) {
         return scope.camera.projectionMatrix;
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the inversed projection matrix of current camera
-   * @param scope - Current shader scope
-   * @returns The inversed projection matrix of current camera
+    /**
+   * Gets the uniform variable of type mat4 which holds the inversed projection matrix of current camera
+   * @param scope - Current shader scope
+   * @returns The inversed projection matrix of current camera
    */ static getInvProjectionMatrix(scope) {
         return scope.camera.invProjectionMatrix;
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the unjittered view projection matrix of current camera
-   * @param scope - Current shader scope
-   * @returns The unjittered view projection matrix of current camera
+    /**
+   * Gets the uniform variable of type mat4 which holds the unjittered view projection matrix of current camera
+   * @param scope - Current shader scope
+   * @returns The unjittered view projection matrix of current camera
    */ static getUnjitteredViewProjectionMatrix(scope) {
         return scope.camera.unjitteredVPMatrix;
     }
-    /**
-   * Gets the uniform variable of type vec2 which holds the jitter value of the projection matrix of current camera
-   * @param scope - Current shader scope
-   * @returns The jitter value of projection matrix of current camera
+    /**
+   * Gets the uniform variable of type vec2 which holds the jitter value of the projection matrix of current camera
+   * @param scope - Current shader scope
+   * @returns The jitter value of projection matrix of current camera
    */ static getProjectionMatrixJitterValue(scope) {
         return scope.camera.jitterValue;
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the jittered inversed view-projection matrix
-   * @param scope - Current shader scope
-   * @returns The jittered inversed view-projection matrix
+    /**
+   * Gets the uniform variable of type mat4 which holds the jittered inversed view-projection matrix
+   * @param scope - Current shader scope
+   * @returns The jittered inversed view-projection matrix
    */ static getJitteredInvVPMatrix(scope) {
         return scope.camera.jitteredInvVPMatrix;
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the unjittered view projection at previous frame matrix of current camera
-   * @param scope - Current shader scope
-   * @returns The unjittered view projection matrix at previous frame of current camera
+    /**
+   * Gets the uniform variable of type mat4 which holds the unjittered view projection at previous frame matrix of current camera
+   * @param scope - Current shader scope
+   * @returns The unjittered view projection matrix at previous frame of current camera
    */ static getPrevUnjitteredViewProjectionMatrix(scope) {
         return scope.camera.prevUnjitteredVPMatrix;
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the view matrix of current camera (world space to camera space)
-   * @param scope - Current shader scope
-   * @returns The view matrix of current camera
+    /**
+   * Gets the uniform variable of type mat4 which holds the view matrix of current camera (world space to camera space)
+   * @param scope - Current shader scope
+   * @returns The view matrix of current camera
    */ static getViewMatrix(scope) {
         return scope.camera.viewMatrix;
     }
-    /**
-   * Gets the uniform variable of type mat4 which holds the inv-view matrix of current camera (camera space to world space)
-   * @param scope - Current shader scope
-   * @returns The inv-view matrix of current camera
+    /**
+   * Gets the uniform variable of type mat4 which holds the inv-view matrix of current camera (camera space to world space)
+   * @param scope - Current shader scope
+   * @returns The inv-view matrix of current camera
    */ static getInvViewMatrix(scope) {
         return scope.camera.worldMatrix;
     }
@@ -1011,20 +1032,20 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
     /** @internal */ static getLightExtra(scope, lightIndex) {
         return scope[UNIFORM_NAME_LIGHT_BUFFER].at(scope.$builder.add(scope.$builder.mul(lightIndex, 4), 3));
     }
-    /**
-   * Sets the clip space position in vertex shader
-   *
-   * @remarks
-   * Use this function instead of using
-   * <pre>
-   * // Do not use this
-   * this.$builtins.position = some_value;
-   * // Use this
-   * ShaderFramework.setClipSpacePosition(some_value);
-   * </pre>,
-   *
-   * @param scope - Current shader scope
-   * @param pos - The clip space position to be set
+    /**
+   * Sets the clip space position in vertex shader
+   *
+   * @remarks
+   * Use this function instead of using
+   * <pre>
+   * // Do not use this
+   * this.$builtins.position = some_value;
+   * // Use this
+   * ShaderFramework.setClipSpacePosition(some_value);
+   * </pre>,
+   *
+   * @param scope - Current shader scope
+   * @param pos - The clip space position to be set
    */ static setClipSpacePosition(scope, pos) {
         const pb = scope.$builder;
         const cameraParams = this.getCameraParams(scope);
@@ -1034,20 +1055,20 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
             scope.$builtins.position = pos;
         }
     }
-    /**
-   * Get shadow map uniform value
-   *
-   * @param scope - Shader scope
-   * @returns The shadow map texture uniform
+    /**
+   * Get shadow map uniform value
+   *
+   * @param scope - Shader scope
+   * @returns The shadow map texture uniform
    */ static getShadowMap(scope) {
         return scope[UNIFORM_NAME_SHADOW_MAP];
     }
-    /**
-   * Calculates shadow of current fragment
-   *
-   * @param scope - Shader scope
-   * @param NoL - NdotL vector
-   * @returns Shadow of current fragment, 1 means no shadow and 0 means full shadowed.
+    /**
+   * Calculates shadow of current fragment
+   *
+   * @param scope - Shader scope
+   * @param NoL - NdotL vector
+   * @returns Shadow of current fragment, 1 means no shadow and 0 means full shadowed.
    */ static calculateShadow(scope, worldPos, NoL, ctx) {
         const pb = scope.$builder;
         const that = this;
@@ -1078,15 +1099,24 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
                 }
                 const shadowMapParams = ctx.shadowMapInfo.get(ctx.currentShadowLight);
                 this.$l.shadow = shadowMapParams.impl.computeShadowCSM(shadowMapParams, this, this.shadowVertex, this.NoL, this.split);
+                this.shadow = pb.clamp(this.shadow, 0, 1);
                 this.$l.shadowDistance = that.getShadowCameraParams(scope).w;
                 this.shadow = pb.mix(this.shadow, 1, pb.smoothStep(pb.mul(this.shadowDistance, 0.8), this.shadowDistance, pb.distance(that.getCameraPosition(this), this.worldPos)));
+                this.shadow = pb.mix(1, this.shadow, this.light.shadowStrength);
+                this.shadow = pb.clamp(this.shadow, 0, 1);
+                this.$if(pb.greaterThan(this.camera.shadowDebugCascades, 0.5), function() {
+                    this.shadow = pb.add(pb.mul(pb.float(this.split), 0.2), 0.2);
+                });
                 this.$return(this.shadow);
             } else {
                 this.$l.shadowVertex = that.calculateShadowSpaceVertex(this, pb.vec4(this.worldPos, 1));
                 const shadowMapParams = ctx.shadowMapInfo.get(ctx.currentShadowLight);
                 this.$l.shadow = shadowMapParams.impl.computeShadow(shadowMapParams, this, this.shadowVertex, this.NoL);
+                this.shadow = pb.clamp(this.shadow, 0, 1);
                 this.$l.shadowDistance = that.getShadowCameraParams(scope).w;
                 this.shadow = pb.mix(this.shadow, 1, pb.smoothStep(pb.mul(this.shadowDistance, 0.8), this.shadowDistance, pb.distance(that.getCameraPosition(this), this.worldPos)));
+                this.shadow = pb.mix(1, this.shadow, this.light.shadowStrength);
+                this.shadow = pb.clamp(this.shadow, 0, 1);
                 this.$return(this.shadow);
             }
         });
@@ -1101,59 +1131,62 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
                 pb.vec3('worldPos'),
                 pb.vec4('color').inout()
             ], function() {
+                this.$if(pb.notEqual(this.fog.additive, 0), function() {
+                    this.$return();
+                });
                 this.$l.uv = pb.div(pb.vec2(this.$builtins.fragCoord.xy), that.getRenderSize(this));
                 this.$l.fogging = calculateFog(this, this.fog.withAerialPerspective, this.fog.fogType, this.fog.atmosphereParams, this.fog.heightFogParams, this.uv, false, that.getCameraPosition(this).xyz, this.worldPos, this.fog.additive, this[UNIFORM_NAME_AERIALPERSPECTIVE_LUT], this[UNIFORM_NAME_SKYDISTANTLIGHT_LUT]);
-                this.color = pb.vec4(pb.add(pb.mul(this.color.rgb, this.fogging.a), pb.mul(this.fogging.rgb, this.color.a)), this.color.a);
+                this.$l.foggingAlpha = pb.sub(1, pb.mul(pb.sub(1, this.fogging.a), this.color.a));
+                this.$l.foggingRGB = pb.mul(this.fogging.rgb, this.color.a);
+                this.color = pb.vec4(pb.add(pb.mul(this.color.rgb, this.foggingAlpha), this.foggingRGB), this.color.a);
             //this.color = pb.vec4(pb.vec3(pb.mix(this.u0, this.u1, this.factor)), this.color.a);
             });
             scope[funcName](worldPos, color);
         }
     }
-    /**
-   * Calculates the non-linear depth from linear depth
-   *
-   * @param scope - Current shader scope
-   * @param depth - The linear depth
-   * @param nearFar - A vector that contains the near clip plane in x component and the far clip plane in y component
-   * @returns The calculated non-linear depth
+    /**
+   * Calculates the non-linear depth from linear depth
+   *
+   * @param scope - Current shader scope
+   * @param depth - The linear depth
+   * @param nearFar - A vector that contains the near clip plane in x component and the far clip plane in y component
+   * @returns The calculated non-linear depth
    */ static linearDepthToNonLinear(scope, depth, nearFar) {
         const pb = scope.$builder;
         nearFar = nearFar ?? this.getCameraParams(scope);
-        return pb.add(pb.mul(pb.div(pb.sub(pb.add(nearFar.x, nearFar.y), pb.div(pb.mul(nearFar.x, nearFar.y, 2), depth)), pb.sub(nearFar.y, nearFar.x)), 0.5), 0.5);
-    }
-    /**
-   * Calculates the linear depth from non-linear depth
-   *
-   * @param scope - Current shader scope
-   * @param depth - The non-linear depth
-   * @param nearFar - A vector that contains the near clip plane in x component and the far clip plane in y component
-   * @returns The calculated linear depth
+        return pb.div(pb.sub(nearFar.y, pb.div(pb.mul(nearFar.x, nearFar.y), depth)), pb.sub(nearFar.y, nearFar.x));
+    }
+    /**
+   * Calculates the linear depth from non-linear depth
+   *
+   * @param scope - Current shader scope
+   * @param depth - The non-linear depth
+   * @param nearFar - A vector that contains the near clip plane in x component and the far clip plane in y component
+   * @returns The calculated linear depth
    */ static nonLinearDepthToLinear(scope, depth, nearFar) {
         const pb = scope.$builder;
         nearFar = nearFar ?? this.getCameraParams(scope);
-        return pb.div(pb.mul(nearFar.x, nearFar.y, 2), pb.add(nearFar.x, nearFar.y, pb.mul(pb.sub(nearFar.x, nearFar.y), pb.sub(pb.mul(depth, 2), 1))));
-    //return pb.div(pb.mul(nearFar.x, nearFar.y), pb.mix(nearFar.y, nearFar.x, depth));
-    }
-    /**
-   * Calculates the normalized linear depth from non-linear depth
-   *
-   * @param scope - Current shader scope
-   * @param depth - The non-linear depth
-   * @param nearFar - A vector that contains the near clip plane in x component and the far clip plane in y component
-   * @returns The calculated normalized linear depth
+        return pb.div(pb.mul(nearFar.x, nearFar.y), pb.mix(nearFar.y, nearFar.x, depth));
+    }
+    /**
+   * Calculates the normalized linear depth from non-linear depth
+   *
+   * @param scope - Current shader scope
+   * @param depth - The non-linear depth
+   * @param nearFar - A vector that contains the near clip plane in x component and the far clip plane in y component
+   * @returns The calculated normalized linear depth
    */ static nonLinearDepthToLinearNormalized(scope, depth, nearFar) {
         const pb = scope.$builder;
         nearFar = nearFar ?? this.getCameraParams(scope);
-        //return pb.div(nearFar.x, pb.mix(nearFar.y, nearFar.x, depth));
-        return pb.div(pb.sub(this.nonLinearDepthToLinear(scope, depth, nearFar), nearFar.x), pb.sub(nearFar.y, nearFar.x));
-    }
-    /**
-   * Sample linear depth from linear depth texture
-   * @param scope - Current shader scope
-   * @param tex - The linear depth texture
-   * @param uv - The uv coordinates
-   * @param level - The mipmap level to sample
-   * @returns Linear depth value
+        return pb.div(nearFar.x, pb.mix(nearFar.y, nearFar.x, depth));
+    }
+    /**
+   * Sample linear depth from linear depth texture
+   * @param scope - Current shader scope
+   * @param tex - The linear depth texture
+   * @param uv - The uv coordinates
+   * @param level - The mipmap level to sample
+   * @returns Linear depth value
    */ static sampleLinearDepth(scope, tex, uv, level) {
         const pb = scope.$builder;
         const depth = pb.textureSampleLevel(tex, uv, level);
@@ -1175,23 +1208,23 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
         });
         return scope.zSamplePositionFromDepth(uv, cameraNearFar, mat);
     }
-    /**
-   * Sample linear depth from linear depth texture with backface
-   * @param scope - Current shader scope
-   * @param tex - The linear depth texture
-   * @param uv - The uv coordinates
-   * @param level - The mipmap level to sample
-   * @returns Linear depth value
+    /**
+   * Sample linear depth from linear depth texture with backface
+   * @param scope - Current shader scope
+   * @param tex - The linear depth texture
+   * @param uv - The uv coordinates
+   * @param level - The mipmap level to sample
+   * @returns Linear depth value
    */ static sampleLinearDepthWithBackface(scope, tex, uv, level) {
         const pb = scope.$builder;
         return pb.textureSampleLevel(tex, uv, level).rg;
     }
-    /**
-   * Transform color to sRGB color space if nessesary
-   *
-   * @param scope - Current shader scope
-   * @param outputColor - The color to be transformed
-   * @returns The transformed color
+    /**
+   * Transform color to sRGB color space if nessesary
+   *
+   * @param scope - Current shader scope
+   * @param outputColor - The color to be transformed
+   * @returns The transformed color
    */ static encodeColorOutput(scope, outputColor) {
         const pb = scope.$builder;
         const that = this;
@@ -1208,9 +1241,6 @@ const UNIFORM_NAME_MORPH_INFO = 'Z_UniformMorphInfo';
         });
         return pb.getGlobalScope()[funcName](outputColor);
     }
-    static getMaxClusteredLightCount() {
-        return getDevice().type === 'webgl' ? 127 : 255;
-    }
 }
 
 export { ShaderHelper };