@zephyr3d/scene 0.9.6 → 0.9.7

package/dist/shadow/shader.js

@@ -3,37 +3,88 @@ import '../material/lambert.js';
 import '../material/blinn.js';
 import '../material/unlit.js';
 import '../material/particle.js';
+import '../material/subsurfaceprofile.js';
 import '@zephyr3d/device';
-import '../values.js';
+import { LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_SPOT, LIGHT_TYPE_POINT } from '../values.js';
 import '@zephyr3d/base';
 import '../material/meshmaterial.js';
 import '../material/grassmaterial.js';
 import '../material/terrain-cm.js';
 import '../material/pbrmr.js';
 import '../material/pbrsg.js';
+import '../material/mtoon.js';
 import '../material/pbrblueprint.js';
 import '../material/sprite.js';
 import '../material/sprite_std.js';
-import '../material/msdf_text.js';
 import '../utility/blueprint/material/texture.js';
 
+function getShadowReceiverBiasFactors(scope) {
+    const pb = scope.$builder;
+    const alphaCutoff = scope.zAlphaCutoff;
+    if (alphaCutoff) {
+        // Thin masked geometry such as layered hair cards needs a tighter receiver bias,
+        // otherwise nearby layers lose self-shadow before the shadow map is even sampled.
+        const cutoff = pb.clamp(alphaCutoff, 0, 1);
+        return pb.vec2(pb.mix(0.22, 0.4, cutoff), pb.mix(0.05, 0.16, cutoff));
+    }
+    return pb.vec2(1, 1);
+}
+function isMaskedPerspectiveShadowLight(scope, lightType) {
+    const alphaCutoff = scope.zAlphaCutoff;
+    return !!alphaCutoff && (lightType === LIGHT_TYPE_SPOT || lightType === LIGHT_TYPE_POINT);
+}
+function getShadowReceiverNoL(scope, NdotL, lightType) {
+    const pb = scope.$builder;
+    const alphaCutoff = scope.zAlphaCutoff;
+    if (alphaCutoff) {
+        // Layered masked cards should not explode slope bias at grazing angles.
+        // This is especially visible for back / rim spot lights on hair cards.
+        const cutoff = pb.clamp(alphaCutoff, 0, 1);
+        if (lightType != null && isMaskedPerspectiveShadowLight(scope, lightType)) {
+            return pb.max(NdotL, pb.mix(0.85, 0.95, cutoff));
+        }
+        return pb.max(NdotL, pb.mix(0.45, 0.65, cutoff));
+    }
+    return NdotL;
+}
+function getShadowReceiverPerspectiveBiasScale(scope, lightType, linearDepth, farNearRatio) {
+    const pb = scope.$builder;
+    const alphaCutoff = scope.zAlphaCutoff;
+    if (alphaCutoff && isMaskedPerspectiveShadowLight(scope, lightType)) {
+        const cutoff = pb.clamp(alphaCutoff, 0, 1);
+        // Perspective shadow cameras (spot / point) can over-amplify receiver bias at depth.
+        // Keep masked layered geometry in a much tighter range so hair cards can still self-occlude.
+        const cappedFarNearRatio = pb.min(farNearRatio, pb.mix(1.15, 1.6, cutoff));
+        return pb.mix(1, cappedFarNearRatio, linearDepth);
+    }
+    return pb.mix(1, farNearRatio, linearDepth);
+}
 function computeShadowBiasCSM(scope, NdotL, split) {
     const pb = scope.$builder;
     const depthBiasParam = ShaderHelper.getDepthBiasValues(scope);
     const splitFlags = pb.vec4(pb.float(pb.equal(split, 0)), pb.float(pb.equal(split, 1)), pb.float(pb.equal(split, 2)), pb.float(pb.equal(split, 3)));
     const depthBiasScale = pb.dot(ShaderHelper.getDepthBiasScales(scope), splitFlags);
-    return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL)), depthBiasScale), pb.vec2(1, 1));
+    const receiverBiasFactors = getShadowReceiverBiasFactors(scope);
+    const receiverNoL = getShadowReceiverNoL(scope, NdotL);
+    return pb.dot(pb.mul(depthBiasParam.xy, receiverBiasFactors, pb.vec2(1, pb.sub(1, receiverNoL)), depthBiasScale), pb.vec2(1, 1));
 }
 function computeShadowBias(lightType, scope, z, NdotL, linear) {
     const pb = scope.$builder;
     const depthBiasParam = ShaderHelper.getDepthBiasValues(scope);
-    if (lightType) {
-        return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL))), pb.vec2(1, 1));
+    const receiverBiasFactors = getShadowReceiverBiasFactors(scope);
+    const receiverNoL = getShadowReceiverNoL(scope, NdotL, lightType);
+    if (lightType === LIGHT_TYPE_DIRECTIONAL) {
+        return pb.dot(pb.mul(depthBiasParam.xy, receiverBiasFactors, pb.vec2(1, pb.sub(1, receiverNoL))), pb.vec2(1, 1));
     } else {
         const nearFar = ShaderHelper.getShadowCameraParams(scope).xy;
         const linearDepth = linear ? z : ShaderHelper.nonLinearDepthToLinearNormalized(scope, z, nearFar);
-        const biasScaleFactor = pb.mix(1, depthBiasParam.w, linearDepth);
-        return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL)), biasScaleFactor), pb.vec2(1, 1));
+        const biasScaleFactor = getShadowReceiverPerspectiveBiasScale(scope, lightType, linearDepth, depthBiasParam.w);
+        let bias = pb.dot(pb.mul(depthBiasParam.xy, receiverBiasFactors, pb.vec2(1, pb.sub(1, receiverNoL)), biasScaleFactor), pb.vec2(1, 1));
+        if (isMaskedPerspectiveShadowLight(scope, lightType)) {
+            const alphaCutoff = scope.zAlphaCutoff;
+            bias = pb.mul(bias, pb.mix(0.12, 0.22, pb.clamp(alphaCutoff, 0, 1)));
+        }
+        return bias;
     }
 }
 

package/dist/shadow/shader.js.map

@@ -1 +1 @@
-{"version":3,"file":"shader.js","sources":["../../src/shadow/shader.ts"],"sourcesContent":["import type { PBInsideFunctionScope, PBShaderExp } from '@zephyr3d/device';\r\nimport { ShaderHelper } from '../material';\r\n\r\nexport function computeShadowBiasCSM(scope: PBInsideFunctionScope, NdotL: PBShaderExp, split: PBShaderExp) {\r\n  const pb = scope.$builder;\r\n  const depthBiasParam = ShaderHelper.getDepthBiasValues(scope);\r\n  const splitFlags = pb.vec4(\r\n    pb.float(pb.equal(split, 0)),\r\n    pb.float(pb.equal(split, 1)),\r\n    pb.float(pb.equal(split, 2)),\r\n    pb.float(pb.equal(split, 3))\r\n  );\r\n  const depthBiasScale = pb.dot(ShaderHelper.getDepthBiasScales(scope), splitFlags);\r\n  return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL)), depthBiasScale), pb.vec2(1, 1));\r\n}\r\n\r\nexport function computeShadowBias(\r\n  lightType: number,\r\n  scope: PBInsideFunctionScope,\r\n  z: PBShaderExp,\r\n  NdotL: PBShaderExp,\r\n  linear: boolean\r\n) {\r\n  const pb = scope.$builder;\r\n  const depthBiasParam = ShaderHelper.getDepthBiasValues(scope);\r\n  if (lightType) {\r\n    return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL))), pb.vec2(1, 1));\r\n  } else {\r\n    const nearFar = ShaderHelper.getShadowCameraParams(scope).xy;\r\n    const linearDepth = linear ? z : ShaderHelper.nonLinearDepthToLinearNormalized(scope, z, nearFar);\r\n    const biasScaleFactor = pb.mix(1, depthBiasParam.w, linearDepth);\r\n    return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL)), biasScaleFactor), pb.vec2(1, 1));\r\n  }\r\n}\r\n"],"names":["computeShadowBiasCSM","scope","NdotL","split","pb","$builder","depthBiasParam","ShaderHelper","getDepthBiasValues","splitFlags","vec4","float","equal","depthBiasScale","dot","getDepthBiasScales","mul","xy","vec2","sub","computeShadowBias","lightType","z","linear","nearFar","getShadowCameraParams","linearDepth","nonLinearDepthToLinearNormalized","biasScaleFactor","mix","w"],"mappings":";;;;;;;;;;;;;;;;;;;AAGO,SAASA,oBAAqBC,CAAAA,KAA4B,EAAEC,KAAkB,EAAEC,KAAkB,EAAA;IACvG,MAAMC,EAAAA,GAAKH,MAAMI,QAAQ;IACzB,MAAMC,cAAAA,GAAiBC,YAAaC,CAAAA,kBAAkB,CAACP,KAAAA,CAAAA;AACvD,IAAA,MAAMQ,UAAaL,GAAAA,EAAAA,CAAGM,IAAI,CACxBN,GAAGO,KAAK,CAACP,EAAGQ,CAAAA,KAAK,CAACT,KAAO,EAAA,CAAA,CAAA,CAAA,EACzBC,EAAGO,CAAAA,KAAK,CAACP,EAAGQ,CAAAA,KAAK,CAACT,KAAAA,EAAO,CACzBC,CAAAA,CAAAA,EAAAA,EAAAA,CAAGO,KAAK,CAACP,GAAGQ,KAAK,CAACT,KAAO,EAAA,CAAA,CAAA,CAAA,EACzBC,GAAGO,KAAK,CAACP,EAAGQ,CAAAA,KAAK,CAACT,KAAO,EAAA,CAAA,CAAA,CAAA,CAAA;AAE3B,IAAA,MAAMU,iBAAiBT,EAAGU,CAAAA,GAAG,CAACP,YAAaQ,CAAAA,kBAAkB,CAACd,KAAQQ,CAAAA,EAAAA,UAAAA,CAAAA;IACtE,OAAOL,EAAAA,CAAGU,GAAG,CAACV,EAAAA,CAAGY,GAAG,CAACV,cAAAA,CAAeW,EAAE,EAAEb,EAAGc,CAAAA,IAAI,CAAC,CAAGd,EAAAA,EAAAA,CAAGe,GAAG,CAAC,CAAA,EAAGjB,SAASW,cAAiBT,CAAAA,EAAAA,EAAAA,CAAGc,IAAI,CAAC,CAAG,EAAA,CAAA,CAAA,CAAA;AACpG;AAEO,SAASE,iBACdC,CAAAA,SAAiB,EACjBpB,KAA4B,EAC5BqB,CAAc,EACdpB,KAAkB,EAClBqB,MAAe,EAAA;IAEf,MAAMnB,EAAAA,GAAKH,MAAMI,QAAQ;IACzB,MAAMC,cAAAA,GAAiBC,YAAaC,CAAAA,kBAAkB,CAACP,KAAAA,CAAAA;AACvD,IAAA,IAAIoB,SAAW,EAAA;QACb,OAAOjB,EAAAA,CAAGU,GAAG,CAACV,EAAAA,CAAGY,GAAG,CAACV,cAAAA,CAAeW,EAAE,EAAEb,EAAAA,CAAGc,IAAI,CAAC,CAAA,EAAGd,GAAGe,GAAG,CAAC,GAAGjB,KAAUE,CAAAA,CAAAA,CAAAA,EAAAA,EAAAA,CAAGc,IAAI,CAAC,CAAG,EAAA,CAAA,CAAA,CAAA;KAC7E,MAAA;AACL,QAAA,MAAMM,OAAUjB,GAAAA,YAAAA,CAAakB,qBAAqB,CAACxB,OAAOgB,EAAE;AAC5D,QAAA,MAAMS,cAAcH,MAASD,GAAAA,CAAAA,GAAIf,aAAaoB,gCAAgC,CAAC1B,OAAOqB,CAAGE,EAAAA,OAAAA,CAAAA;AACzF,QAAA,MAAMI,kBAAkBxB,EAAGyB,CAAAA,GAAG,CAAC,CAAGvB,EAAAA,cAAAA,CAAewB,CAAC,EAAEJ,WAAAA,CAAAA;QACpD,OAAOtB,EAAAA,CAAGU,GAAG,CAACV,EAAAA,CAAGY,GAAG,CAACV,cAAAA,CAAeW,EAAE,EAAEb,EAAGc,CAAAA,IAAI,CAAC,CAAGd,EAAAA,EAAAA,CAAGe,GAAG,CAAC,CAAA,EAAGjB,SAAS0B,eAAkBxB,CAAAA,EAAAA,EAAAA,CAAGc,IAAI,CAAC,CAAG,EAAA,CAAA,CAAA,CAAA;AACrG;AACF;;;;"}
+{"version":3,"file":"shader.js","sources":["../../src/shadow/shader.ts"],"sourcesContent":["import type { PBInsideFunctionScope, PBShaderExp } from '@zephyr3d/device';\r\nimport { ShaderHelper } from '../material';\r\nimport { LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_POINT, LIGHT_TYPE_SPOT } from '../values';\r\n\r\nfunction getShadowReceiverBiasFactors(scope: PBInsideFunctionScope) {\r\n  const pb = scope.$builder;\r\n  const alphaCutoff = (scope as PBInsideFunctionScope & { zAlphaCutoff?: PBShaderExp }).zAlphaCutoff;\r\n  if (alphaCutoff) {\r\n    // Thin masked geometry such as layered hair cards needs a tighter receiver bias,\r\n    // otherwise nearby layers lose self-shadow before the shadow map is even sampled.\r\n    const cutoff = pb.clamp(alphaCutoff, 0, 1);\r\n    return pb.vec2(pb.mix(0.22, 0.4, cutoff), pb.mix(0.05, 0.16, cutoff)) as PBShaderExp;\r\n  }\r\n  return pb.vec2(1, 1) as PBShaderExp;\r\n}\r\n\r\nfunction isMaskedPerspectiveShadowLight(scope: PBInsideFunctionScope, lightType: number) {\r\n  const alphaCutoff = (scope as PBInsideFunctionScope & { zAlphaCutoff?: PBShaderExp }).zAlphaCutoff;\r\n  return !!alphaCutoff && (lightType === LIGHT_TYPE_SPOT || lightType === LIGHT_TYPE_POINT);\r\n}\r\n\r\nfunction getShadowReceiverNoL(scope: PBInsideFunctionScope, NdotL: PBShaderExp, lightType?: number) {\r\n  const pb = scope.$builder;\r\n  const alphaCutoff = (scope as PBInsideFunctionScope & { zAlphaCutoff?: PBShaderExp }).zAlphaCutoff;\r\n  if (alphaCutoff) {\r\n    // Layered masked cards should not explode slope bias at grazing angles.\r\n    // This is especially visible for back / rim spot lights on hair cards.\r\n    const cutoff = pb.clamp(alphaCutoff, 0, 1);\r\n    if (lightType != null && isMaskedPerspectiveShadowLight(scope, lightType)) {\r\n      return pb.max(NdotL, pb.mix(0.85, 0.95, cutoff)) as PBShaderExp;\r\n    }\r\n    return pb.max(NdotL, pb.mix(0.45, 0.65, cutoff)) as PBShaderExp;\r\n  }\r\n  return NdotL as PBShaderExp;\r\n}\r\n\r\nfunction getShadowReceiverPerspectiveBiasScale(\r\n  scope: PBInsideFunctionScope,\r\n  lightType: number,\r\n  linearDepth: PBShaderExp,\r\n  farNearRatio: PBShaderExp\r\n) {\r\n  const pb = scope.$builder;\r\n  const alphaCutoff = (scope as PBInsideFunctionScope & { zAlphaCutoff?: PBShaderExp }).zAlphaCutoff;\r\n  if (alphaCutoff && isMaskedPerspectiveShadowLight(scope, lightType)) {\r\n    const cutoff = pb.clamp(alphaCutoff, 0, 1);\r\n    // Perspective shadow cameras (spot / point) can over-amplify receiver bias at depth.\r\n    // Keep masked layered geometry in a much tighter range so hair cards can still self-occlude.\r\n    const cappedFarNearRatio = pb.min(farNearRatio, pb.mix(1.15, 1.6, cutoff));\r\n    return pb.mix(1, cappedFarNearRatio, linearDepth) as PBShaderExp;\r\n  }\r\n  return pb.mix(1, farNearRatio, linearDepth) as PBShaderExp;\r\n}\r\n\r\nexport function computeShadowBiasCSM(scope: PBInsideFunctionScope, NdotL: PBShaderExp, split: PBShaderExp) {\r\n  const pb = scope.$builder;\r\n  const depthBiasParam = ShaderHelper.getDepthBiasValues(scope);\r\n  const splitFlags = pb.vec4(\r\n    pb.float(pb.equal(split, 0)),\r\n    pb.float(pb.equal(split, 1)),\r\n    pb.float(pb.equal(split, 2)),\r\n    pb.float(pb.equal(split, 3))\r\n  );\r\n  const depthBiasScale = pb.dot(ShaderHelper.getDepthBiasScales(scope), splitFlags);\r\n  const receiverBiasFactors = getShadowReceiverBiasFactors(scope);\r\n  const receiverNoL = getShadowReceiverNoL(scope, NdotL);\r\n  return pb.dot(\r\n    pb.mul(depthBiasParam.xy, receiverBiasFactors, pb.vec2(1, pb.sub(1, receiverNoL)), depthBiasScale),\r\n    pb.vec2(1, 1)\r\n  );\r\n}\r\n\r\nexport function computeShadowBias(\r\n  lightType: number,\r\n  scope: PBInsideFunctionScope,\r\n  z: PBShaderExp,\r\n  NdotL: PBShaderExp,\r\n  linear: boolean\r\n) {\r\n  const pb = scope.$builder;\r\n  const depthBiasParam = ShaderHelper.getDepthBiasValues(scope);\r\n  const receiverBiasFactors = getShadowReceiverBiasFactors(scope);\r\n  const receiverNoL = getShadowReceiverNoL(scope, NdotL, lightType);\r\n  if (lightType === LIGHT_TYPE_DIRECTIONAL) {\r\n    return pb.dot(\r\n      pb.mul(depthBiasParam.xy, receiverBiasFactors, pb.vec2(1, pb.sub(1, receiverNoL))),\r\n      pb.vec2(1, 1)\r\n    );\r\n  } else {\r\n    const nearFar = ShaderHelper.getShadowCameraParams(scope).xy;\r\n    const linearDepth = linear ? z : ShaderHelper.nonLinearDepthToLinearNormalized(scope, z, nearFar);\r\n    const biasScaleFactor = getShadowReceiverPerspectiveBiasScale(\r\n      scope,\r\n      lightType,\r\n      linearDepth,\r\n      depthBiasParam.w\r\n    );\r\n    let bias = pb.dot(\r\n      pb.mul(depthBiasParam.xy, receiverBiasFactors, pb.vec2(1, pb.sub(1, receiverNoL)), biasScaleFactor),\r\n      pb.vec2(1, 1)\r\n    );\r\n    if (isMaskedPerspectiveShadowLight(scope, lightType)) {\r\n      const alphaCutoff = (scope as PBInsideFunctionScope & { zAlphaCutoff?: PBShaderExp }).zAlphaCutoff!;\r\n      bias = pb.mul(bias, pb.mix(0.12, 0.22, pb.clamp(alphaCutoff, 0, 1))) as PBShaderExp;\r\n    }\r\n    return bias;\r\n  }\r\n}\r\n"],"names":["getShadowReceiverBiasFactors","scope","pb","$builder","alphaCutoff","zAlphaCutoff","cutoff","clamp","vec2","mix","isMaskedPerspectiveShadowLight","lightType","LIGHT_TYPE_SPOT","LIGHT_TYPE_POINT","getShadowReceiverNoL","NdotL","max","getShadowReceiverPerspectiveBiasScale","linearDepth","farNearRatio","cappedFarNearRatio","min","computeShadowBiasCSM","split","depthBiasParam","ShaderHelper","getDepthBiasValues","splitFlags","vec4","float","equal","depthBiasScale","dot","getDepthBiasScales","receiverBiasFactors","receiverNoL","mul","xy","sub","computeShadowBias","z","linear","LIGHT_TYPE_DIRECTIONAL","nearFar","getShadowCameraParams","nonLinearDepthToLinearNormalized","biasScaleFactor","w","bias"],"mappings":"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"}

package/dist/shadow/shadow_impl.js

@@ -1,3 +1,5 @@
+import { Vector4 } from '@zephyr3d/base';
+
 /** @internal */ class ShadowImpl {
     _resourceDirty;
     constructor(){
@@ -9,6 +11,10 @@
     updateResources(shadowMapParams) {
         this.doUpdateResources(shadowMapParams);
     }
+    getShadowMapClearColor(shadowMapParams) {
+        const colorAttachment = shadowMapParams.shadowMapFramebuffer?.getColorAttachments()[0];
+        return colorAttachment ? colorAttachment.isFloatFormat() ? new Vector4(1, 1, 1, 1) : new Vector4(0, 0, 0, 1) : null;
+    }
 }
 
 export { ShadowImpl };

package/dist/shadow/shadow_impl.js.map

@@ -1 +1 @@
-{"version":3,"file":"shadow_impl.js","sources":["../../src/shadow/shadow_impl.ts"],"sourcesContent":["import type { PBInsideFunctionScope, PBShaderExp, TextureFormat } from '@zephyr3d/device';\r\nimport type { ShadowMapParams, ShadowMapType, ShadowMode } from './shadowmapper';\r\nimport type { Nullable } from '@zephyr3d/base';\r\n\r\n/** @internal */\r\nexport abstract class ShadowImpl {\r\n  protected _resourceDirty: boolean;\r\n  constructor() {\r\n    this._resourceDirty = true;\r\n  }\r\n  invalidateResource() {\r\n    this._resourceDirty = true;\r\n  }\r\n  updateResources(shadowMapParams: ShadowMapParams) {\r\n    this.doUpdateResources(shadowMapParams);\r\n  }\r\n  abstract getType(): ShadowMode;\r\n  abstract getShadowMapBorder(shadowMapParams: ShadowMapParams): number;\r\n  abstract getShadowMap(shadowMapParams: ShadowMapParams): ShadowMapType;\r\n  abstract postRenderShadowMap(shadowMapParams: ShadowMapParams): void;\r\n  abstract getDepthScale(): number;\r\n  abstract setDepthScale(val: number): void;\r\n  abstract resourceDirty(): boolean;\r\n  abstract doUpdateResources(shadowMapParams: ShadowMapParams): void;\r\n  abstract getShaderHash(): string;\r\n  abstract computeShadowMapDepth(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    worldPos: PBShaderExp\r\n  ): PBShaderExp;\r\n  abstract computeShadow(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp\r\n  ): PBShaderExp;\r\n  abstract computeShadowCSM(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp,\r\n    split: PBShaderExp\r\n  ): PBShaderExp;\r\n  abstract getShadowMapColorFormat(shadowMapParams: ShadowMapParams): Nullable<TextureFormat>;\r\n  abstract getShadowMapDepthFormat(shadowMapParams: ShadowMapParams): TextureFormat;\r\n  abstract useNativeShadowMap(shadowMapParams: ShadowMapParams): boolean;\r\n}\r\n"],"names":["ShadowImpl","_resourceDirty","invalidateResource","updateResources","shadowMapParams","doUpdateResources"],"mappings":"AAIA,iBACO,MAAeA,UAAAA,CAAAA;IACVC,cAAwB;IAClC,WAAc,EAAA;QACZ,IAAI,CAACA,cAAc,GAAG,IAAA;AACxB;IACAC,kBAAqB,GAAA;QACnB,IAAI,CAACD,cAAc,GAAG,IAAA;AACxB;AACAE,IAAAA,eAAAA,CAAgBC,eAAgC,EAAE;QAChD,IAAI,CAACC,iBAAiB,CAACD,eAAAA,CAAAA;AACzB;AA+BF;;;;"}
+{"version":3,"file":"shadow_impl.js","sources":["../../src/shadow/shadow_impl.ts"],"sourcesContent":["import type { PBInsideFunctionScope, PBShaderExp, TextureFormat } from '@zephyr3d/device';\r\nimport type { ShadowMapParams, ShadowMapType, ShadowMode } from './shadowmapper';\r\nimport { Vector4, type Nullable } from '@zephyr3d/base';\r\n\r\n/** @internal */\r\nexport abstract class ShadowImpl {\r\n  protected _resourceDirty: boolean;\r\n  constructor() {\r\n    this._resourceDirty = true;\r\n  }\r\n  invalidateResource() {\r\n    this._resourceDirty = true;\r\n  }\r\n  updateResources(shadowMapParams: ShadowMapParams) {\r\n    this.doUpdateResources(shadowMapParams);\r\n  }\r\n  abstract getType(): ShadowMode;\r\n  abstract getShadowMapBorder(shadowMapParams: ShadowMapParams): number;\r\n  getShadowMapClearColor(shadowMapParams: ShadowMapParams) {\r\n    const colorAttachment = shadowMapParams.shadowMapFramebuffer?.getColorAttachments()[0];\r\n    return colorAttachment\r\n      ? colorAttachment.isFloatFormat()\r\n        ? new Vector4(1, 1, 1, 1)\r\n        : new Vector4(0, 0, 0, 1)\r\n      : null;\r\n  }\r\n  abstract getShadowMap(shadowMapParams: ShadowMapParams): ShadowMapType;\r\n  abstract postRenderShadowMap(shadowMapParams: ShadowMapParams): void;\r\n  abstract getDepthScale(): number;\r\n  abstract setDepthScale(val: number): void;\r\n  abstract resourceDirty(): boolean;\r\n  abstract doUpdateResources(shadowMapParams: ShadowMapParams): void;\r\n  abstract getShaderHash(): string;\r\n  abstract computeShadowMapDepth(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    worldPos: PBShaderExp\r\n  ): PBShaderExp;\r\n  abstract computeShadow(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp\r\n  ): PBShaderExp;\r\n  abstract computeShadowCSM(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp,\r\n    split: PBShaderExp\r\n  ): PBShaderExp;\r\n  abstract getShadowMapColorFormat(shadowMapParams: ShadowMapParams): Nullable<TextureFormat>;\r\n  abstract getShadowMapDepthFormat(shadowMapParams: ShadowMapParams): TextureFormat;\r\n  abstract useNativeShadowMap(shadowMapParams: ShadowMapParams): boolean;\r\n}\r\n"],"names":["ShadowImpl","_resourceDirty","invalidateResource","updateResources","shadowMapParams","doUpdateResources","getShadowMapClearColor","colorAttachment","shadowMapFramebuffer","getColorAttachments","isFloatFormat","Vector4"],"mappings":";;AAIA,iBACO,MAAeA,UAAAA,CAAAA;IACVC,cAAwB;IAClC,WAAc,EAAA;QACZ,IAAI,CAACA,cAAc,GAAG,IAAA;AACxB;IACAC,kBAAqB,GAAA;QACnB,IAAI,CAACD,cAAc,GAAG,IAAA;AACxB;AACAE,IAAAA,eAAAA,CAAgBC,eAAgC,EAAE;QAChD,IAAI,CAACC,iBAAiB,CAACD,eAAAA,CAAAA;AACzB;AAGAE,IAAAA,sBAAAA,CAAuBF,eAAgC,EAAE;AACvD,QAAA,MAAMG,kBAAkBH,eAAgBI,CAAAA,oBAAoB,EAAEC,mBAAAA,EAAqB,CAAC,CAAE,CAAA;AACtF,QAAA,OAAOF,eACHA,GAAAA,eAAAA,CAAgBG,aAAa,EAAA,GAC3B,IAAIC,OAAQ,CAAA,CAAA,EAAG,CAAG,EAAA,CAAA,EAAG,KACrB,IAAIA,OAAAA,CAAQ,CAAG,EAAA,CAAA,EAAG,GAAG,CACvB,CAAA,GAAA,IAAA;AACN;AA6BF;;;;"}

package/dist/shadow/shadow_region.js

@@ -0,0 +1,229 @@
+import { Disposable, AABB, DWeakRef } from '@zephyr3d/base';
+
+/**
+ * Maintains the world-space region used by directional light shadow maps.
+ *
+ * @public
+ */ class ShadowRegion extends Disposable {
+    /** @internal */ _manualRegion;
+    /** @internal */ _staticRegion;
+    /** @internal */ _dynamicRegion;
+    /** @internal */ _region;
+    /** @internal */ _staticCasters;
+    /** @internal */ _dynamicCasters;
+    /**
+   * Creates a shadow region.
+   *
+   * @param region - Optional manual world-space AABB used to initialize the region.
+   */ constructor(region){
+        super();
+        this._manualRegion = region ? new AABB(region) : null;
+        this._staticRegion = new AABB().beginExtend();
+        this._dynamicRegion = new AABB().beginExtend();
+        this._region = new AABB().beginExtend();
+        this._staticCasters = [];
+        this._dynamicCasters = [];
+        this.updateRegion();
+    }
+    /**
+   * Final world-space shadow region.
+   *
+   * @returns The union of the manual, static caster, and dynamic caster regions, or `null` if no valid region exists.
+   */ get region() {
+        return this._region.isValid() ? this._region : null;
+    }
+    /**
+   * Region contributed by manually assigned AABB.
+   *
+   * @returns The manually assigned region, or `null` if no manual region is set.
+   */ get manualRegion() {
+        return this._manualRegion;
+    }
+    /**
+   * Region contributed by static shadow casters.
+   *
+   * @returns The combined static caster region, or `null` if no valid static caster region exists.
+   */ get staticRegion() {
+        return this._staticRegion.isValid() ? this._staticRegion : null;
+    }
+    /**
+   * Region contributed by dynamic shadow casters.
+   *
+   * @returns The combined dynamic caster region, or `null` if no valid dynamic caster region exists.
+   */ get dynamicRegion() {
+        return this._dynamicRegion.isValid() ? this._dynamicRegion : null;
+    }
+    /**
+   * Assigns a manual world-space AABB to the region.
+   *
+   * @param region - The manual world-space AABB to use, or `null` to clear the manual region.
+   */ setRegion(region) {
+        this._manualRegion = region ? new AABB(region) : null;
+        this.updateRegion();
+    }
+    /**
+   * Adds a static shadow caster using a snapshot of its current world-space AABB.
+   *
+   * @param caster - The mesh or clipmap terrain node to include as a static caster.
+   * @returns `this` for chaining.
+   */ addStaticCaster(caster) {
+        if (!this.isShadowCaster(caster) || this.hasCaster(caster)) {
+            return this;
+        }
+        const aabb = this.getCasterAABB(caster);
+        if (!aabb) {
+            return this;
+        }
+        this._staticCasters.push({
+            ref: new DWeakRef(caster),
+            aabb
+        });
+        this.extendRegion(this._staticRegion, aabb);
+        this.updateRegion();
+        return this;
+    }
+    /**
+   * Adds a dynamic shadow caster and tracks its bounding volume changes.
+   *
+   * @param caster - The mesh or clipmap terrain node to include as a dynamic caster.
+   * @returns `this` for chaining.
+   */ addDynamicCaster(caster) {
+        if (!this.isShadowCaster(caster) || this.hasCaster(caster)) {
+            return this;
+        }
+        const callback = ()=>{
+            this.rebuildDynamicRegion();
+        };
+        caster.on('bvchanged', callback);
+        this._dynamicCasters.push({
+            ref: new DWeakRef(caster),
+            callback
+        });
+        const aabb = this.getCasterAABB(caster);
+        if (aabb) {
+            this.extendRegion(this._dynamicRegion, aabb);
+            this.updateRegion();
+        }
+        return this;
+    }
+    /**
+   * Removes a previously added shadow caster.
+   *
+   * @param caster - The caster node to remove from the static or dynamic caster list.
+   * @returns `this` for chaining.
+   */ removeCaster(caster) {
+        let changed = false;
+        for(let i = this._staticCasters.length - 1; i >= 0; i--){
+            const entry = this._staticCasters[i];
+            const node = entry.ref.get();
+            if (!node || node === caster) {
+                entry.ref.dispose();
+                this._staticCasters.splice(i, 1);
+                changed = true;
+            }
+        }
+        for(let i = this._dynamicCasters.length - 1; i >= 0; i--){
+            const entry = this._dynamicCasters[i];
+            const node = entry.ref.get();
+            if (!node || node === caster) {
+                (node ?? caster).off('bvchanged', entry.callback);
+                entry.ref.dispose();
+                this._dynamicCasters.splice(i, 1);
+                changed = true;
+            }
+        }
+        if (changed) {
+            this.rebuildStaticRegion();
+            this.rebuildDynamicRegion();
+        }
+        return this;
+    }
+    /**
+   * Removes all shadow casters while keeping the manual region.
+   */ clearCasters() {
+        for (const entry of this._dynamicCasters){
+            entry.ref.get()?.off('bvchanged', entry.callback);
+            entry.ref.dispose();
+        }
+        for (const entry of this._staticCasters){
+            entry.ref.dispose();
+        }
+        this._staticCasters.length = 0;
+        this._dynamicCasters.length = 0;
+        this._staticRegion.beginExtend();
+        this._dynamicRegion.beginExtend();
+        this.updateRegion();
+    }
+    /**
+   * Clears the manual region and all shadow casters.
+   *
+   * @returns `this` for chaining.
+   */ clear() {
+        this._manualRegion = null;
+        this.clearCasters();
+        return this;
+    }
+    /** {@inheritDoc Disposable.onDispose} */ onDispose() {
+        this.clear();
+    }
+    /** @internal */ hasCaster(caster) {
+        return this._staticCasters.some((entry)=>entry.ref.get() === caster) || this._dynamicCasters.some((entry)=>entry.ref.get() === caster);
+    }
+    /** @internal */ isShadowCaster(caster) {
+        return !caster.disposed && (caster.isMesh() || caster.isClipmapTerrain());
+    }
+    /** @internal */ getCasterAABB(caster) {
+        const bbox = caster.getWorldBoundingVolume()?.toAABB();
+        return bbox?.isValid() ? new AABB(bbox) : null;
+    }
+    /** @internal */ rebuildStaticRegion() {
+        this._staticRegion.beginExtend();
+        for(let i = this._staticCasters.length - 1; i >= 0; i--){
+            const entry = this._staticCasters[i];
+            if (!entry.ref.get()) {
+                entry.ref.dispose();
+                this._staticCasters.splice(i, 1);
+            } else {
+                this.extendRegion(this._staticRegion, entry.aabb);
+            }
+        }
+        this.updateRegion();
+    }
+    /** @internal */ rebuildDynamicRegion() {
+        this._dynamicRegion.beginExtend();
+        for(let i = this._dynamicCasters.length - 1; i >= 0; i--){
+            const entry = this._dynamicCasters[i];
+            const caster = entry.ref.get();
+            if (!caster || !this.isShadowCaster(caster)) {
+                caster?.off('bvchanged', entry.callback);
+                entry.ref.dispose();
+                this._dynamicCasters.splice(i, 1);
+                continue;
+            }
+            const aabb = this.getCasterAABB(caster);
+            if (aabb) {
+                this.extendRegion(this._dynamicRegion, aabb);
+            }
+        }
+        this.updateRegion();
+    }
+    /** @internal */ updateRegion() {
+        this._region.beginExtend();
+        if (this._manualRegion?.isValid()) {
+            this.extendRegion(this._region, this._manualRegion);
+        }
+        if (this._staticRegion.isValid()) {
+            this.extendRegion(this._region, this._staticRegion);
+        }
+        if (this._dynamicRegion.isValid()) {
+            this.extendRegion(this._region, this._dynamicRegion);
+        }
+    }
+    /** @internal */ extendRegion(region, aabb) {
+        region.extend(aabb.minPoint);
+        region.extend(aabb.maxPoint);
+    }
+}
+
+export { ShadowRegion };
+//# sourceMappingURL=shadow_region.js.map

package/dist/shadow/shadow_region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadow_region.js","sources":["../../src/shadow/shadow_region.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\r\nimport { AABB, Disposable, DWeakRef } from '@zephyr3d/base';\r\nimport type { SceneNode } from '../scene/scene_node';\r\n\r\ntype StaticShadowCasterEntry = {\r\n  ref: DWeakRef<SceneNode>;\r\n  aabb: AABB;\r\n};\r\n\r\ntype DynamicShadowCasterEntry = {\r\n  ref: DWeakRef<SceneNode>;\r\n  callback: (node: SceneNode) => void;\r\n};\r\n\r\n/**\r\n * Maintains the world-space region used by directional light shadow maps.\r\n *\r\n * @public\r\n */\r\nexport class ShadowRegion extends Disposable {\r\n  /** @internal */\r\n  private _manualRegion: Nullable<AABB>;\r\n  /** @internal */\r\n  private readonly _staticRegion: AABB;\r\n  /** @internal */\r\n  private readonly _dynamicRegion: AABB;\r\n  /** @internal */\r\n  private readonly _region: AABB;\r\n  /** @internal */\r\n  private readonly _staticCasters: StaticShadowCasterEntry[];\r\n  /** @internal */\r\n  private readonly _dynamicCasters: DynamicShadowCasterEntry[];\r\n\r\n  /**\n   * Creates a shadow region.\n   *\n   * @param region - Optional manual world-space AABB used to initialize the region.\n   */\n  constructor(region?: Nullable<AABB>) {\n    super();\r\n    this._manualRegion = region ? new AABB(region) : null;\r\n    this._staticRegion = new AABB().beginExtend();\r\n    this._dynamicRegion = new AABB().beginExtend();\r\n    this._region = new AABB().beginExtend();\r\n    this._staticCasters = [];\r\n    this._dynamicCasters = [];\r\n    this.updateRegion();\r\n  }\r\n\r\n  /**\n   * Final world-space shadow region.\n   *\n   * @returns The union of the manual, static caster, and dynamic caster regions, or `null` if no valid region exists.\n   */\n  get region(): Nullable<AABB> {\n    return this._region.isValid() ? this._region : null;\r\n  }\r\n\r\n  /**\n   * Region contributed by manually assigned AABB.\n   *\n   * @returns The manually assigned region, or `null` if no manual region is set.\n   */\n  get manualRegion(): Nullable<AABB> {\n    return this._manualRegion;\r\n  }\r\n\r\n  /**\n   * Region contributed by static shadow casters.\n   *\n   * @returns The combined static caster region, or `null` if no valid static caster region exists.\n   */\n  get staticRegion(): Nullable<AABB> {\n    return this._staticRegion.isValid() ? this._staticRegion : null;\r\n  }\r\n\r\n  /**\n   * Region contributed by dynamic shadow casters.\n   *\n   * @returns The combined dynamic caster region, or `null` if no valid dynamic caster region exists.\n   */\n  get dynamicRegion(): Nullable<AABB> {\n    return this._dynamicRegion.isValid() ? this._dynamicRegion : null;\r\n  }\r\n\r\n  /**\n   * Assigns a manual world-space AABB to the region.\n   *\n   * @param region - The manual world-space AABB to use, or `null` to clear the manual region.\n   */\n  setRegion(region: Nullable<AABB>) {\n    this._manualRegion = region ? new AABB(region) : null;\r\n    this.updateRegion();\r\n  }\r\n\r\n  /**\n   * Adds a static shadow caster using a snapshot of its current world-space AABB.\n   *\n   * @param caster - The mesh or clipmap terrain node to include as a static caster.\n   * @returns `this` for chaining.\n   */\n  addStaticCaster(caster: SceneNode): this {\n    if (!this.isShadowCaster(caster) || this.hasCaster(caster)) {\r\n      return this;\r\n    }\r\n    const aabb = this.getCasterAABB(caster);\r\n    if (!aabb) {\r\n      return this;\r\n    }\r\n    this._staticCasters.push({\r\n      ref: new DWeakRef(caster),\r\n      aabb\r\n    });\r\n    this.extendRegion(this._staticRegion, aabb);\r\n    this.updateRegion();\r\n    return this;\r\n  }\r\n\r\n  /**\n   * Adds a dynamic shadow caster and tracks its bounding volume changes.\n   *\n   * @param caster - The mesh or clipmap terrain node to include as a dynamic caster.\n   * @returns `this` for chaining.\n   */\n  addDynamicCaster(caster: SceneNode): this {\n    if (!this.isShadowCaster(caster) || this.hasCaster(caster)) {\r\n      return this;\r\n    }\r\n    const callback = () => {\r\n      this.rebuildDynamicRegion();\r\n    };\r\n    caster.on('bvchanged', callback);\r\n    this._dynamicCasters.push({\r\n      ref: new DWeakRef(caster),\r\n      callback\r\n    });\r\n    const aabb = this.getCasterAABB(caster);\r\n    if (aabb) {\r\n      this.extendRegion(this._dynamicRegion, aabb);\r\n      this.updateRegion();\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\n   * Removes a previously added shadow caster.\n   *\n   * @param caster - The caster node to remove from the static or dynamic caster list.\n   * @returns `this` for chaining.\n   */\n  removeCaster(caster: SceneNode): this {\n    let removed = false;\r\n    let changed = false;\r\n    for (let i = this._staticCasters.length - 1; i >= 0; i--) {\r\n      const entry = this._staticCasters[i];\r\n      const node = entry.ref.get();\r\n      if (!node || node === caster) {\r\n        entry.ref.dispose();\r\n        this._staticCasters.splice(i, 1);\r\n        changed = true;\r\n        removed ||= node === caster;\r\n      }\r\n    }\r\n    for (let i = this._dynamicCasters.length - 1; i >= 0; i--) {\r\n      const entry = this._dynamicCasters[i];\r\n      const node = entry.ref.get();\r\n      if (!node || node === caster) {\r\n        (node ?? caster).off('bvchanged', entry.callback);\r\n        entry.ref.dispose();\r\n        this._dynamicCasters.splice(i, 1);\r\n        changed = true;\r\n        removed ||= node === caster;\r\n      }\r\n    }\r\n    if (changed) {\r\n      this.rebuildStaticRegion();\r\n      this.rebuildDynamicRegion();\r\n    }\r\n    return this;\r\n  }\r\n\r\n  /**\n   * Removes all shadow casters while keeping the manual region.\n   */\n  clearCasters() {\n    for (const entry of this._dynamicCasters) {\r\n      entry.ref.get()?.off('bvchanged', entry.callback);\r\n      entry.ref.dispose();\r\n    }\r\n    for (const entry of this._staticCasters) {\r\n      entry.ref.dispose();\r\n    }\r\n    this._staticCasters.length = 0;\r\n    this._dynamicCasters.length = 0;\r\n    this._staticRegion.beginExtend();\r\n    this._dynamicRegion.beginExtend();\r\n    this.updateRegion();\r\n  }\r\n\r\n  /**\n   * Clears the manual region and all shadow casters.\n   *\n   * @returns `this` for chaining.\n   */\n  clear(): this {\n    this._manualRegion = null;\r\n    this.clearCasters();\r\n    return this;\r\n  }\r\n\r\n  /** {@inheritDoc Disposable.onDispose} */\r\n  protected onDispose(): void {\r\n    this.clear();\r\n  }\r\n\r\n  /** @internal */\r\n  private hasCaster(caster: SceneNode): boolean {\r\n    return (\r\n      this._staticCasters.some((entry) => entry.ref.get() === caster) ||\r\n      this._dynamicCasters.some((entry) => entry.ref.get() === caster)\r\n    );\r\n  }\r\n\r\n  /** @internal */\r\n  private isShadowCaster(caster: SceneNode): boolean {\r\n    return !caster.disposed && (caster.isMesh() || caster.isClipmapTerrain());\r\n  }\r\n\r\n  /** @internal */\r\n  private getCasterAABB(caster: SceneNode): Nullable<AABB> {\r\n    const bbox = caster.getWorldBoundingVolume()?.toAABB();\r\n    return bbox?.isValid() ? new AABB(bbox) : null;\r\n  }\r\n\r\n  /** @internal */\r\n  private rebuildStaticRegion() {\r\n    this._staticRegion.beginExtend();\r\n    for (let i = this._staticCasters.length - 1; i >= 0; i--) {\r\n      const entry = this._staticCasters[i];\r\n      if (!entry.ref.get()) {\r\n        entry.ref.dispose();\r\n        this._staticCasters.splice(i, 1);\r\n      } else {\r\n        this.extendRegion(this._staticRegion, entry.aabb);\r\n      }\r\n    }\r\n    this.updateRegion();\r\n  }\r\n\r\n  /** @internal */\r\n  private rebuildDynamicRegion() {\r\n    this._dynamicRegion.beginExtend();\r\n    for (let i = this._dynamicCasters.length - 1; i >= 0; i--) {\r\n      const entry = this._dynamicCasters[i];\r\n      const caster = entry.ref.get();\r\n      if (!caster || !this.isShadowCaster(caster)) {\r\n        caster?.off('bvchanged', entry.callback);\r\n        entry.ref.dispose();\r\n        this._dynamicCasters.splice(i, 1);\r\n        continue;\r\n      }\r\n      const aabb = this.getCasterAABB(caster);\r\n      if (aabb) {\r\n        this.extendRegion(this._dynamicRegion, aabb);\r\n      }\r\n    }\r\n    this.updateRegion();\r\n  }\r\n\r\n  /** @internal */\r\n  private updateRegion() {\r\n    this._region.beginExtend();\r\n    if (this._manualRegion?.isValid()) {\r\n      this.extendRegion(this._region, this._manualRegion);\r\n    }\r\n    if (this._staticRegion.isValid()) {\r\n      this.extendRegion(this._region, this._staticRegion);\r\n    }\r\n    if (this._dynamicRegion.isValid()) {\r\n      this.extendRegion(this._region, this._dynamicRegion);\r\n    }\r\n  }\r\n\r\n  /** @internal */\r\n  private extendRegion(region: AABB, aabb: AABB) {\r\n    region.extend(aabb.minPoint);\r\n    region.extend(aabb.maxPoint);\r\n  }\r\n}\r\n"],"names":["ShadowRegion","Disposable","region","_manualRegion","AABB","_staticRegion","beginExtend","_dynamicRegion","_region","_staticCasters","_dynamicCasters","updateRegion","isValid","manualRegion","staticRegion","dynamicRegion","setRegion","addStaticCaster","caster","isShadowCaster","hasCaster","aabb","getCasterAABB","push","ref","DWeakRef","extendRegion","addDynamicCaster","callback","rebuildDynamicRegion","on","removeCaster","changed","i","length","entry","node","get","dispose","splice","off","rebuildStaticRegion","clearCasters","clear","some","disposed","isMesh","isClipmapTerrain","bbox","getWorldBoundingVolume","toAABB","extend","minPoint","maxPoint"],"mappings":"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"}