@zephyr3d/scene 0.9.26 → 0.10.0

package/dist/shadow/pcf_pd.js.map

@@ -1 +1 @@
-{"version":3,"file":"pcf_pd.js","sources":["../../src/shadow/pcf_pd.ts"],"sourcesContent":["import type { PBInsideFunctionScope, PBShaderExp, TextureSampler } from '@zephyr3d/device';\r\nimport { ShadowImpl } from './shadow_impl';\r\nimport {\r\n  applyShadowDepthBias,\r\n  computeShadowMapDepth,\r\n  filterShadowPCF,\r\n  ndcToShadowCoord,\r\n  shadowCoordDepthInRange\r\n} from '../shaders/shadow';\r\nimport type { ShadowMapParams, ShadowMapType } from './shadowmapper';\r\nimport { decodeNormalizedFloatFromRGBA } from '../shaders/misc';\r\nimport { LIGHT_TYPE_POINT } from '../values';\r\nimport { ShaderHelper } from '../material/shader/helper';\r\nimport { computeShadowBias, computeShadowBiasCSM } from './shader';\r\nimport { getDevice } from '../app/api';\r\nimport type { Nullable } from '@zephyr3d/base';\r\nimport { REVERSE_Z, Vector4 } from '@zephyr3d/base';\r\n\r\n/** @internal */\r\nexport class PCFPD extends ShadowImpl {\r\n  private static readonly SHADER_VERSION = 3;\r\n  protected _tapCount: number;\r\n  protected _sampleRadius: number;\r\n  protected _shadowSampler: Nullable<TextureSampler>;\r\n  constructor(tapCount?: number, sampleRadius?: number) {\r\n    super();\r\n    this._tapCount = tapCount ?? 3;\r\n    this._sampleRadius = sampleRadius ?? 1;\r\n    this._shadowSampler = null;\r\n  }\r\n  get tapCount() {\r\n    return this._tapCount;\r\n  }\r\n  set tapCount(val) {\r\n    this._tapCount = val;\r\n  }\r\n  getType() {\r\n    return 'pcf-pd' as const;\r\n  }\r\n  dispose() {\r\n    this._shadowSampler = null;\r\n  }\r\n  resourceDirty() {\r\n    return false;\r\n  }\r\n  private getPCFKernelSize() {\r\n    if (this._sampleRadius >= 4 || this._tapCount >= 32) {\r\n      return 7;\r\n    }\r\n    if (this._sampleRadius >= 2 || this._tapCount >= 12) {\r\n      return 5;\r\n    }\r\n    return 3;\r\n  }\r\n  getParams(out?: Vector4) {\r\n    return out ?? Vector4.zero();\r\n  }\r\n  getShadowMapBorder(_shadowMapParams: ShadowMapParams) {\r\n    return Math.max(this._sampleRadius + 1, this.getPCFKernelSize());\r\n  }\r\n  getShadowMap(shadowMapParams: ShadowMapParams) {\r\n    return (\r\n      this.useNativeShadowMap(shadowMapParams)\r\n        ? shadowMapParams.shadowMapFramebuffer!.getDepthAttachment()\r\n        : shadowMapParams.shadowMapFramebuffer!.getColorAttachments()[0]\r\n    ) as ShadowMapType;\r\n  }\r\n  doUpdateResources(shadowMapParams: ShadowMapParams) {\r\n    shadowMapParams.shadowMap = this.getShadowMap(shadowMapParams);\r\n    shadowMapParams.shadowMapSampler =\r\n      shadowMapParams.shadowMap?.getDefaultSampler(this.useNativeShadowMap(shadowMapParams)) || null;\r\n  }\r\n  postRenderShadowMap() {}\r\n  getDepthScale() {\r\n    return this._sampleRadius;\r\n  }\r\n  setDepthScale(val: number) {\r\n    this._sampleRadius = val;\r\n  }\r\n  getShaderHash() {\r\n    return `${PCFPD.SHADER_VERSION}-${this._tapCount}-${this._sampleRadius}`;\r\n  }\r\n  getShadowMapColorFormat(shadowMapParams: ShadowMapParams) {\r\n    if (this.useNativeShadowMap(shadowMapParams)) {\r\n      return null;\r\n    } else {\r\n      const device = getDevice();\r\n      return device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer\r\n        ? device.type === 'webgl'\r\n          ? 'rgba16f'\r\n          : 'r16f'\r\n        : device.getDeviceCaps().textureCaps.supportFloatColorBuffer\r\n          ? device.type === 'webgl'\r\n            ? 'rgba32f'\r\n            : 'r32f'\r\n          : 'rgba8unorm';\r\n    }\r\n  }\r\n  getShadowMapDepthFormat(_shadowMapParams: ShadowMapParams) {\r\n    return this.preferredShadowMapDepthFormat();\r\n  }\r\n  computeShadowMapDepth(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    worldPos: PBShaderExp\r\n  ) {\r\n    return computeShadowMapDepth(scope, worldPos, shadowMapParams.shadowMap!.format);\r\n  }\r\n  computeShadowCSM(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp,\r\n    split: PBShaderExp\r\n  ) {\r\n    const funcNameComputeShadowCSM = 'lib_computeShadowCSM';\r\n    const pb = scope.$builder;\r\n    const kernelSize = this.getPCFKernelSize();\r\n    pb.func(\r\n      funcNameComputeShadowCSM,\r\n      [pb.vec4('shadowVertex'), pb.float('NdotL'), pb.int('split')],\r\n      function () {\r\n        this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);\r\n        this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);\r\n        this.$l.inShadow = pb.all(\r\n          pb.bvec2(\r\n            pb.all(\r\n              pb.bvec4(\r\n                pb.greaterThanEqual(this.shadowCoord.x, 0),\r\n                pb.lessThanEqual(this.shadowCoord.x, 1),\r\n                pb.greaterThanEqual(this.shadowCoord.y, 0),\r\n                pb.lessThanEqual(this.shadowCoord.y, 1)\r\n              )\r\n            ),\r\n            shadowCoordDepthInRange(this, this.shadowCoord.z)\r\n          )\r\n        );\r\n        this.$l.shadow = pb.float(1);\r\n        this.$if(this.inShadow, function () {\r\n          this.$l.shadowBias = computeShadowBiasCSM(this, this.NdotL, this.split);\r\n          this.shadowCoord.z = applyShadowDepthBias(this, this.shadowCoord.z, this.shadowBias, true);\r\n          this.shadow = filterShadowPCF(\r\n            this,\r\n            shadowMapParams.lightType,\r\n            shadowMapParams.shadowMap!.format,\r\n            kernelSize,\r\n            this.shadowCoord,\r\n            this.split\r\n          );\r\n        });\r\n        this.$return(this.shadow);\r\n      }\r\n    );\r\n    return pb.getGlobalScope()[funcNameComputeShadowCSM](shadowVertex, NdotL, split) as PBShaderExp;\r\n  }\r\n  computeShadow(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp\r\n  ) {\r\n    const funcNameComputeShadow = 'lib_computeShadow';\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    const kernelSize = this.getPCFKernelSize();\r\n    pb.func(funcNameComputeShadow, [pb.vec4('shadowVertex'), pb.float('NdotL')], function () {\r\n      if (shadowMapParams.lightType === LIGHT_TYPE_POINT) {\r\n        this.$l.dir = pb.sub(this.shadowVertex.xyz, ShaderHelper.getLightPositionAndRangeForShadow(this).xyz);\r\n        if (that.useNativeShadowMap(shadowMapParams)) {\r\n          this.$l.nearFar = ShaderHelper.getShadowCameraParams(this).xy;\r\n          this.$l.maxZ = pb.max(pb.max(pb.abs(this.dir.x), pb.abs(this.dir.y)), pb.abs(this.dir.z));\r\n          this.$l.distance = ShaderHelper.linearDepthToNonLinear(this, this.maxZ, this.nearFar);\r\n          this.$l.shadowBias = computeShadowBias(\r\n            shadowMapParams.lightType,\r\n            this,\r\n            pb.div(this.maxZ, ShaderHelper.getLightPositionAndRangeForShadow(this).w),\r\n            this.NdotL,\r\n            true\r\n          );\r\n          this.$return(that.sampleShadowMap(shadowMapParams, this, this.dir, this.distance, this.shadowBias));\r\n        } else {\r\n          this.$l.distance = pb.div(\r\n            pb.length(this.dir),\r\n            ShaderHelper.getLightPositionAndRangeForShadow(this).w\r\n          );\r\n          this.$l.shadowBias = computeShadowBias(\r\n            shadowMapParams.lightType,\r\n            this,\r\n            this.distance,\r\n            this.NdotL,\r\n            true\r\n          );\r\n          this.$return(that.sampleShadowMap(shadowMapParams, this, this.dir, this.distance, this.shadowBias));\r\n        }\r\n      } else {\r\n        this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);\r\n        this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);\r\n        this.$l.inShadow = pb.all(\r\n          pb.bvec2(\r\n            pb.all(\r\n              pb.bvec4(\r\n                pb.greaterThanEqual(this.shadowCoord.x, 0),\r\n                pb.lessThanEqual(this.shadowCoord.x, 1),\r\n                pb.greaterThanEqual(this.shadowCoord.y, 0),\r\n                pb.lessThanEqual(this.shadowCoord.y, 1)\r\n              )\r\n            ),\r\n            shadowCoordDepthInRange(this, this.shadowCoord.z)\r\n          )\r\n        );\r\n        this.$l.shadow = pb.float(1);\r\n        this.$if(this.inShadow, function () {\r\n          this.$l.shadowBias = computeShadowBias(\r\n            shadowMapParams.lightType,\r\n            this,\r\n            this.shadowCoord.z,\r\n            this.NdotL,\r\n            false\r\n          );\r\n          this.shadowCoord.z = applyShadowDepthBias(this, this.shadowCoord.z, this.shadowBias, true);\r\n          this.shadow = filterShadowPCF(\r\n            this,\r\n            shadowMapParams.lightType,\r\n            shadowMapParams.shadowMap!.format,\r\n            kernelSize,\r\n            this.shadowCoord\r\n          );\r\n        });\r\n        this.$return(this.shadow);\r\n      }\r\n    });\r\n    return pb.getGlobalScope()[funcNameComputeShadow](shadowVertex, NdotL) as PBShaderExp;\r\n  }\r\n  useNativeShadowMap(_shadowMapParams: ShadowMapParams) {\r\n    return getDevice().type !== 'webgl';\r\n  }\r\n  /** @internal */\r\n  sampleShadowMap(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    coords: PBShaderExp,\r\n    z: PBShaderExp,\r\n    bias: PBShaderExp\r\n  ) {\r\n    const funcNameSampleShadowMap = 'lib_sampleShadowMapPD';\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    pb.func(funcNameSampleShadowMap, [pb.vec3('coords'), pb.float('z'), pb.float('bias')], function () {\r\n      const floatDepthTexture = shadowMapParams.shadowMap!.format !== 'rgba8unorm';\r\n      if (that.useNativeShadowMap(shadowMapParams)) {\r\n        this.$return(\r\n          pb.clamp(\r\n            pb.textureSampleCompareLevel(\r\n              ShaderHelper.getShadowMap(this),\r\n              this.coords,\r\n              applyShadowDepthBias(this, this.z, this.bias, true)\r\n            ),\r\n            0,\r\n            1\r\n          )\r\n        );\r\n      } else {\r\n        this.$l.shadowTex = pb.textureSampleLevel(ShaderHelper.getShadowMap(this), this.coords, 0);\r\n        if (!floatDepthTexture) {\r\n          this.shadowTex.x = decodeNormalizedFloatFromRGBA(this, this.shadowTex);\r\n        }\r\n        this.$l.distance = pb.sub(this.z, this.bias);\r\n        this.$return(pb.step(this.distance, this.shadowTex.x));\r\n      }\r\n    });\r\n    return pb.getGlobalScope()[funcNameSampleShadowMap](coords, z, bias) as PBShaderExp;\r\n  }\r\n  /** @internal */\r\n  sampleShadowMapCSM(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    coords: PBShaderExp,\r\n    split: PBShaderExp,\r\n    z: PBShaderExp,\r\n    bias: PBShaderExp\r\n  ) {\r\n    const funcNameSampleShadowMapCSM = 'lib_sampleShadowMapCSMPD';\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    pb.func(\r\n      funcNameSampleShadowMapCSM,\r\n      [pb.vec4('coords'), pb.int('split'), pb.float('z'), pb.float('bias')],\r\n      function () {\r\n        const floatDepthTexture = shadowMapParams.shadowMap!.format !== 'rgba8unorm';\r\n        this.$l.distance = applyShadowDepthBias(this, this.z, this.bias, true);\r\n        if (that.useNativeShadowMap(shadowMapParams)) {\r\n          if (shadowMapParams.shadowMap!.isTexture2DArray()) {\r\n            this.$return(\r\n              pb.clamp(\r\n                pb.textureArraySampleCompareLevel(\r\n                  ShaderHelper.getShadowMap(this),\r\n                  this.coords.xy,\r\n                  this.split,\r\n                  this.distance\r\n                ),\r\n                0,\r\n                1\r\n              )\r\n            );\r\n          } else {\r\n            this.$return(\r\n              pb.clamp(\r\n                pb.textureSampleCompareLevel(ShaderHelper.getShadowMap(this), this.coords.xy, this.distance),\r\n                0,\r\n                1\r\n              )\r\n            );\r\n          }\r\n        } else {\r\n          if (shadowMapParams.shadowMap!.isTexture2DArray()) {\r\n            this.$l.shadowTex = pb.textureArraySampleLevel(\r\n              ShaderHelper.getShadowMap(this),\r\n              this.coords.xy,\r\n              this.split,\r\n              0\r\n            );\r\n          } else {\r\n            this.$l.shadowTex = pb.textureSampleLevel(ShaderHelper.getShadowMap(this), this.coords.xy, 0);\r\n          }\r\n          if (!floatDepthTexture) {\r\n            this.shadowTex.x = decodeNormalizedFloatFromRGBA(this, this.shadowTex);\r\n          }\r\n          this.$return(\r\n            REVERSE_Z ? pb.step(this.shadowTex.x, this.distance) : pb.step(this.distance, this.shadowTex.x)\r\n          );\r\n        }\r\n      }\r\n    );\r\n    return pb.getGlobalScope()[funcNameSampleShadowMapCSM](coords, split, z, bias) as PBShaderExp;\r\n  }\r\n}\r\n"],"names":["PCFPD","ShadowImpl","SHADER_VERSION","_tapCount","_sampleRadius","_shadowSampler","tapCount","sampleRadius","val","getType","dispose","resourceDirty","getPCFKernelSize","getParams","out","Vector4","zero","getShadowMapBorder","_shadowMapParams","Math","max","getShadowMap","shadowMapParams","useNativeShadowMap","shadowMapFramebuffer","getDepthAttachment","getColorAttachments","doUpdateResources","shadowMap","shadowMapSampler","getDefaultSampler","postRenderShadowMap","getDepthScale","setDepthScale","getShaderHash","getShadowMapColorFormat","device","getDevice","getDeviceCaps","textureCaps","supportHalfFloatColorBuffer","type","supportFloatColorBuffer","getShadowMapDepthFormat","preferredShadowMapDepthFormat","computeShadowMapDepth","scope","worldPos","format","computeShadowCSM","shadowVertex","NdotL","split","funcNameComputeShadowCSM","pb","$builder","kernelSize","func","vec4","float","int","$l","shadowCoord","div","w","ndcToShadowCoord","inShadow","all","bvec2","bvec4","greaterThanEqual","x","lessThanEqual","y","shadowCoordDepthInRange","z","shadow","$if","shadowBias","computeShadowBiasCSM","applyShadowDepthBias","filterShadowPCF","lightType","$return","getGlobalScope","computeShadow","funcNameComputeShadow","that","LIGHT_TYPE_POINT","dir","sub","xyz","ShaderHelper","getLightPositionAndRangeForShadow","nearFar","getShadowCameraParams","xy","maxZ","abs","distance","linearDepthToNonLinear","computeShadowBias","sampleShadowMap","length","coords","bias","funcNameSampleShadowMap","vec3","floatDepthTexture","clamp","textureSampleCompareLevel","shadowTex","textureSampleLevel","decodeNormalizedFloatFromRGBA","step","sampleShadowMapCSM","funcNameSampleShadowMapCSM","isTexture2DArray","textureArraySampleCompareLevel","textureArraySampleLevel","REVERSE_Z"],"mappings":"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"}
+{"version":3,"file":"pcf_pd.js","sources":["../../src/shadow/pcf_pd.ts"],"sourcesContent":["import type { PBInsideFunctionScope, PBShaderExp, TextureSampler } from '@zephyr3d/device';\r\nimport { ShadowImpl } from './shadow_impl';\r\nimport {\r\n  applyShadowDepthBias,\r\n  computeShadowMapDepth,\r\n  filterShadowPCF,\r\n  ndcToShadowCoord,\r\n  shadowCoordDepthInRange\r\n} from '../shaders/shadow';\r\nimport type { ShadowMapParams, ShadowMapType } from './shadowmapper';\r\nimport { LIGHT_TYPE_POINT } from '../values';\r\nimport { ShaderHelper } from '../material/shader/helper';\r\nimport { computeShadowBias, computeShadowBiasCSM } from './shader';\r\nimport type { Nullable } from '@zephyr3d/base';\r\nimport { Vector4 } from '@zephyr3d/base';\r\n\r\n/** @internal */\r\nexport class PCFPD extends ShadowImpl {\r\n  private static readonly SHADER_VERSION = 3;\r\n  protected _tapCount: number;\r\n  protected _sampleRadius: number;\r\n  protected _shadowSampler: Nullable<TextureSampler>;\r\n  constructor(tapCount?: number, sampleRadius?: number) {\r\n    super();\r\n    this._tapCount = tapCount ?? 3;\r\n    this._sampleRadius = sampleRadius ?? 1;\r\n    this._shadowSampler = null;\r\n  }\r\n  get tapCount() {\r\n    return this._tapCount;\r\n  }\r\n  set tapCount(val) {\r\n    this._tapCount = val;\r\n  }\r\n  getType() {\r\n    return 'pcf-pd' as const;\r\n  }\r\n  dispose() {\r\n    this._shadowSampler = null;\r\n  }\r\n  resourceDirty() {\r\n    return false;\r\n  }\r\n  private getPCFKernelSize() {\r\n    if (this._sampleRadius >= 4 || this._tapCount >= 32) {\r\n      return 7;\r\n    }\r\n    if (this._sampleRadius >= 2 || this._tapCount >= 12) {\r\n      return 5;\r\n    }\r\n    return 3;\r\n  }\r\n  getParams(out?: Vector4) {\r\n    return out ?? Vector4.zero();\r\n  }\r\n  getShadowMapBorder(_shadowMapParams: ShadowMapParams) {\r\n    return Math.max(this._sampleRadius + 1, this.getPCFKernelSize());\r\n  }\r\n  getShadowMap(shadowMapParams: ShadowMapParams) {\r\n    return shadowMapParams.shadowMapFramebuffer!.getDepthAttachment() as ShadowMapType;\r\n  }\r\n  doUpdateResources(shadowMapParams: ShadowMapParams) {\r\n    shadowMapParams.shadowMap = this.getShadowMap(shadowMapParams);\r\n    shadowMapParams.shadowMapSampler = shadowMapParams.shadowMap?.getDefaultSampler(true) || null;\r\n  }\r\n  postRenderShadowMap() {}\r\n  getDepthScale() {\r\n    return this._sampleRadius;\r\n  }\r\n  setDepthScale(val: number) {\r\n    this._sampleRadius = val;\r\n  }\r\n  getShaderHash() {\r\n    return `${PCFPD.SHADER_VERSION}-${this._tapCount}-${this._sampleRadius}`;\r\n  }\r\n  getShadowMapColorFormat(_shadowMapParams: ShadowMapParams) {\r\n    return null;\r\n  }\r\n  getShadowMapDepthFormat(_shadowMapParams: ShadowMapParams) {\r\n    return this.preferredShadowMapDepthFormat();\r\n  }\r\n  computeShadowMapDepth(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    worldPos: PBShaderExp\r\n  ) {\r\n    return computeShadowMapDepth(scope, worldPos, shadowMapParams.shadowMap!.format);\r\n  }\r\n  computeShadowCSM(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp,\r\n    split: PBShaderExp\r\n  ) {\r\n    const funcNameComputeShadowCSM = 'lib_computeShadowCSM';\r\n    const pb = scope.$builder;\r\n    const kernelSize = this.getPCFKernelSize();\r\n    pb.func(\r\n      funcNameComputeShadowCSM,\r\n      [pb.vec4('shadowVertex'), pb.float('NdotL'), pb.int('split')],\r\n      function () {\r\n        this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);\r\n        this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);\r\n        this.$l.inShadow = pb.all(\r\n          pb.bvec2(\r\n            pb.all(\r\n              pb.bvec4(\r\n                pb.greaterThanEqual(this.shadowCoord.x, 0),\r\n                pb.lessThanEqual(this.shadowCoord.x, 1),\r\n                pb.greaterThanEqual(this.shadowCoord.y, 0),\r\n                pb.lessThanEqual(this.shadowCoord.y, 1)\r\n              )\r\n            ),\r\n            shadowCoordDepthInRange(this, this.shadowCoord.z)\r\n          )\r\n        );\r\n        this.$l.shadow = pb.float(1);\r\n        this.$if(this.inShadow, function () {\r\n          this.$l.shadowBias = computeShadowBiasCSM(this, this.NdotL, this.split);\r\n          this.shadowCoord.z = applyShadowDepthBias(this, this.shadowCoord.z, this.shadowBias, true);\r\n          this.shadow = filterShadowPCF(\r\n            this,\r\n            shadowMapParams.lightType,\r\n            shadowMapParams.shadowMap!.format,\r\n            kernelSize,\r\n            this.shadowCoord,\r\n            this.split\r\n          );\r\n        });\r\n        this.$return(this.shadow);\r\n      }\r\n    );\r\n    return pb.getGlobalScope()[funcNameComputeShadowCSM](shadowVertex, NdotL, split) as PBShaderExp;\r\n  }\r\n  computeShadow(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp\r\n  ) {\r\n    const funcNameComputeShadow = 'lib_computeShadow';\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    const kernelSize = this.getPCFKernelSize();\r\n    pb.func(funcNameComputeShadow, [pb.vec4('shadowVertex'), pb.float('NdotL')], function () {\r\n      if (shadowMapParams.lightType === LIGHT_TYPE_POINT) {\r\n        this.$l.dir = pb.sub(this.shadowVertex.xyz, ShaderHelper.getLightPositionAndRangeForShadow(this).xyz);\r\n        this.$l.nearFar = ShaderHelper.getShadowCameraParams(this).xy;\r\n        this.$l.maxZ = pb.max(pb.max(pb.abs(this.dir.x), pb.abs(this.dir.y)), pb.abs(this.dir.z));\r\n        this.$l.distance = ShaderHelper.linearDepthToNonLinear(this, this.maxZ, this.nearFar);\r\n        this.$l.shadowBias = computeShadowBias(\r\n          shadowMapParams.lightType,\r\n          this,\r\n          pb.div(this.maxZ, ShaderHelper.getLightPositionAndRangeForShadow(this).w),\r\n          this.NdotL,\r\n          true\r\n        );\r\n        this.$return(that.sampleShadowMap(shadowMapParams, this, this.dir, this.distance, this.shadowBias));\r\n      } else {\r\n        this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);\r\n        this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);\r\n        this.$l.inShadow = pb.all(\r\n          pb.bvec2(\r\n            pb.all(\r\n              pb.bvec4(\r\n                pb.greaterThanEqual(this.shadowCoord.x, 0),\r\n                pb.lessThanEqual(this.shadowCoord.x, 1),\r\n                pb.greaterThanEqual(this.shadowCoord.y, 0),\r\n                pb.lessThanEqual(this.shadowCoord.y, 1)\r\n              )\r\n            ),\r\n            shadowCoordDepthInRange(this, this.shadowCoord.z)\r\n          )\r\n        );\r\n        this.$l.shadow = pb.float(1);\r\n        this.$if(this.inShadow, function () {\r\n          this.$l.shadowBias = computeShadowBias(\r\n            shadowMapParams.lightType,\r\n            this,\r\n            this.shadowCoord.z,\r\n            this.NdotL,\r\n            false\r\n          );\r\n          this.shadowCoord.z = applyShadowDepthBias(this, this.shadowCoord.z, this.shadowBias, true);\r\n          this.shadow = filterShadowPCF(\r\n            this,\r\n            shadowMapParams.lightType,\r\n            shadowMapParams.shadowMap!.format,\r\n            kernelSize,\r\n            this.shadowCoord\r\n          );\r\n        });\r\n        this.$return(this.shadow);\r\n      }\r\n    });\r\n    return pb.getGlobalScope()[funcNameComputeShadow](shadowVertex, NdotL) as PBShaderExp;\r\n  }\r\n  useNativeShadowMap(_shadowMapParams: ShadowMapParams) {\r\n    return true;\r\n  }\r\n  /** @internal */\r\n  sampleShadowMap(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    coords: PBShaderExp,\r\n    z: PBShaderExp,\r\n    bias: PBShaderExp\r\n  ) {\r\n    const funcNameSampleShadowMap = 'lib_sampleShadowMapPD';\r\n    const pb = scope.$builder;\r\n    pb.func(funcNameSampleShadowMap, [pb.vec3('coords'), pb.float('z'), pb.float('bias')], function () {\r\n      this.$return(\r\n        pb.clamp(\r\n          pb.textureSampleCompareLevel(\r\n            ShaderHelper.getShadowMap(this),\r\n            this.coords,\r\n            applyShadowDepthBias(this, this.z, this.bias, true)\r\n          ),\r\n          0,\r\n          1\r\n        )\r\n      );\r\n    });\r\n    return pb.getGlobalScope()[funcNameSampleShadowMap](coords, z, bias) as PBShaderExp;\r\n  }\r\n  /** @internal */\r\n  sampleShadowMapCSM(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    coords: PBShaderExp,\r\n    split: PBShaderExp,\r\n    z: PBShaderExp,\r\n    bias: PBShaderExp\r\n  ) {\r\n    const funcNameSampleShadowMapCSM = 'lib_sampleShadowMapCSMPD';\r\n    const pb = scope.$builder;\r\n    pb.func(\r\n      funcNameSampleShadowMapCSM,\r\n      [pb.vec4('coords'), pb.int('split'), pb.float('z'), pb.float('bias')],\r\n      function () {\r\n        this.$l.distance = applyShadowDepthBias(this, this.z, this.bias, true);\r\n        if (shadowMapParams.shadowMap!.isTexture2DArray()) {\r\n          this.$return(\r\n            pb.clamp(\r\n              pb.textureArraySampleCompareLevel(\r\n                ShaderHelper.getShadowMap(this),\r\n                this.coords.xy,\r\n                this.split,\r\n                this.distance\r\n              ),\r\n              0,\r\n              1\r\n            )\r\n          );\r\n        } else {\r\n          this.$return(\r\n            pb.clamp(\r\n              pb.textureSampleCompareLevel(ShaderHelper.getShadowMap(this), this.coords.xy, this.distance),\r\n              0,\r\n              1\r\n            )\r\n          );\r\n        }\r\n      }\r\n    );\r\n    return pb.getGlobalScope()[funcNameSampleShadowMapCSM](coords, split, z, bias) as PBShaderExp;\r\n  }\r\n}\r\n"],"names":["PCFPD","ShadowImpl","SHADER_VERSION","_tapCount","_sampleRadius","_shadowSampler","tapCount","sampleRadius","val","getType","dispose","resourceDirty","getPCFKernelSize","getParams","out","Vector4","zero","getShadowMapBorder","_shadowMapParams","Math","max","getShadowMap","shadowMapParams","shadowMapFramebuffer","getDepthAttachment","doUpdateResources","shadowMap","shadowMapSampler","getDefaultSampler","postRenderShadowMap","getDepthScale","setDepthScale","getShaderHash","getShadowMapColorFormat","getShadowMapDepthFormat","preferredShadowMapDepthFormat","computeShadowMapDepth","scope","worldPos","format","computeShadowCSM","shadowVertex","NdotL","split","funcNameComputeShadowCSM","pb","$builder","kernelSize","func","vec4","float","int","$l","shadowCoord","div","w","ndcToShadowCoord","inShadow","all","bvec2","bvec4","greaterThanEqual","x","lessThanEqual","y","shadowCoordDepthInRange","z","shadow","$if","shadowBias","computeShadowBiasCSM","applyShadowDepthBias","filterShadowPCF","lightType","$return","getGlobalScope","computeShadow","funcNameComputeShadow","that","LIGHT_TYPE_POINT","dir","sub","xyz","ShaderHelper","getLightPositionAndRangeForShadow","nearFar","getShadowCameraParams","xy","maxZ","abs","distance","linearDepthToNonLinear","computeShadowBias","sampleShadowMap","useNativeShadowMap","coords","bias","funcNameSampleShadowMap","vec3","clamp","textureSampleCompareLevel","sampleShadowMapCSM","funcNameSampleShadowMapCSM","isTexture2DArray","textureArraySampleCompareLevel"],"mappings":"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"}

package/dist/shadow/pcss.js

@@ -13,6 +13,7 @@ import { getDevice } from '../app/api.js';
     _filterSampleCount;
     _maxFilterRadius;
     _temporalJitter;
+    _physicalLightRadius;
     constructor(lightRadius, blockerSampleCount, filterSampleCount, maxFilterRadius, temporalJitter){
         super();
         this._lightRadius = lightRadius ?? 8;
@@ -20,6 +21,22 @@ import { getDevice } from '../app/api.js';
         this._filterSampleCount = filterSampleCount ?? 32;
         this._maxFilterRadius = maxFilterRadius ?? 32;
         this._temporalJitter = temporalJitter ?? true;
+        this._physicalLightRadius = 0;
+    }
+    /**
+   * Source radius in world units, overriding {@link lightRadius} when positive.
+   *
+   * @remarks
+   * {@link lightRadius} is a fixed size in shadow map texels, so the penumbra it
+   * produces does not follow the light's actual size or the receiver's distance
+   * from it. A physical radius is converted per pixel instead (cube maps only,
+   * i.e. point and rect lights); the shadow mapper sets it from a rect light's
+   * size. It travels to the shader as a negative `lightRadius`.
+   */ get physicalLightRadius() {
+        return this._physicalLightRadius;
+    }
+    set physicalLightRadius(val) {
+        this._physicalLightRadius = Math.max(0, Number(val) || 0);
     }
     get lightRadius() {
         return this._lightRadius;
@@ -86,14 +103,11 @@ import { getDevice } from '../app/api.js';
     }
     getShadowMapColorFormat(_shadowMapParams) {
         const device = getDevice();
-        if (device.type === 'webgl') {
-            return device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer ? 'rgba16f' : device.getDeviceCaps().textureCaps.supportFloatColorBuffer ? 'rgba32f' : 'rgba8unorm';
-        }
         return device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer ? 'r16f' : device.getDeviceCaps().textureCaps.supportFloatColorBuffer ? 'r32f' : 'rgba8unorm';
     }
     getParams(out) {
         out = out ?? new Vector4();
-        out.setXYZW(this._lightRadius, this._blockerSampleCount, this._filterSampleCount, this._maxFilterRadius);
+        out.setXYZW(this._physicalLightRadius > 0 ? -this._physicalLightRadius : this._lightRadius, this._blockerSampleCount, this._filterSampleCount, this._maxFilterRadius);
         return out;
     }
     getShadowMapDepthFormat(_shadowMapParams) {
@@ -125,20 +139,29 @@ import { getDevice } from '../app/api.js';
         });
         return pb.getGlobalScope()[funcNameComputeShadowCSM](shadowVertex, NdotL, split);
     }
-    computeShadow(shadowMapParams, scope, shadowVertex, NdotL) {
-        const funcNameComputeShadow = 'lib_computeShadow';
+    computeShadow(shadowMapParams, scope, shadowVertex, NdotL, worldNormal) {
+        // Only the cube branch reads the normal, so only it gets the extra parameter.
+        const withNormal = !!worldNormal && shadowMapParams.lightType === LIGHT_TYPE_POINT;
+        const funcNameComputeShadow = withNormal ? 'lib_computeShadow_N' : 'lib_computeShadow';
         const pb = scope.$builder;
         const that = this;
         pb.func(funcNameComputeShadow, [
             pb.vec4('shadowVertex'),
-            pb.float('NdotL')
+            pb.float('NdotL'),
+            ...withNormal ? [
+                pb.vec3('worldNormal')
+            ] : []
         ], function() {
             if (shadowMapParams.lightType === LIGHT_TYPE_POINT) {
                 this.$l.dir = pb.sub(this.shadowVertex.xyz, ShaderHelper.getLightPositionAndRangeForShadow(this).xyz);
                 this.$l.distance = pb.div(pb.length(this.dir), ShaderHelper.getLightPositionAndRangeForShadow(this).w);
                 this.$l.shadowBias = computeShadowBias(shadowMapParams.lightType, this, this.distance, this.NdotL, true);
                 this.$l.shadowCoord = pb.vec4(this.dir, pb.sub(this.distance, this.shadowBias));
-                this.$return(filterShadowPCSS(this, shadowMapParams.lightType, shadowMapParams.shadowMap.format, this.shadowCoord, undefined, undefined, that._temporalJitter));
+                this.$return(filterShadowPCSS(this, shadowMapParams.lightType, shadowMapParams.shadowMap.format, this.shadowCoord, // The receiver's plane, so wide kernels compare each tap against the
+                // receiver's own depth there - see pointReceiverPlaneDepth. The
+                // geometric normal rather than screen derivatives: no uniform control
+                // flow requirement, and no mixing across silhouettes.
+                withNormal ? this.worldNormal : undefined, undefined, that._temporalJitter));
             }
             this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);
             this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);
@@ -160,7 +183,9 @@ import { getDevice } from '../app/api.js';
             });
             this.$return(this.shadow);
         });
-        return pb.getGlobalScope()[funcNameComputeShadow](shadowVertex, NdotL);
+        return pb.getGlobalScope()[funcNameComputeShadow](shadowVertex, NdotL, ...withNormal ? [
+            worldNormal
+        ] : []);
     }
     useNativeShadowMap(_shadowMapParams) {
         return false;

package/dist/shadow/pcss.js.map

@@ -1 +1 @@
-{"version":3,"file":"pcss.js","sources":["../../src/shadow/pcss.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\r\nimport { Vector4 } from '@zephyr3d/base';\r\nimport type { PBInsideFunctionScope, PBShaderExp, TextureFormat } from '@zephyr3d/device';\r\nimport { getPackedShadowMapClearColor, getShadowMapFarthestDepth, ShadowImpl } from './shadow_impl';\r\nimport type { ShadowMapParams, ShadowMapType } from './shadowmapper';\r\nimport {\r\n  applyShadowDepthBias,\r\n  computeReceiverPlaneDepthBias,\r\n  computeShadowMapDepth,\r\n  filterShadowPCSS,\r\n  ndcToShadowCoord,\r\n  shadowCoordDepthInRange\r\n} from '../shaders/shadow';\r\nimport { decodeNormalizedFloatFromRGBA } from '../shaders/misc';\r\nimport { LIGHT_TYPE_POINT, LIGHT_TYPE_SPOT } from '../values';\r\nimport { ShaderHelper } from '../material/shader/helper';\r\nimport { computeShadowBias, computeShadowBiasCSM } from './shader';\r\nimport { getDevice } from '../app/api';\r\n\r\n/** @internal */\r\nexport class PCSS extends ShadowImpl {\r\n  protected _lightRadius: number;\r\n  protected _blockerSampleCount: number;\r\n  protected _filterSampleCount: number;\r\n  protected _maxFilterRadius: number;\r\n  protected _temporalJitter: boolean;\r\n  constructor(\r\n    lightRadius?: number,\r\n    blockerSampleCount?: number,\r\n    filterSampleCount?: number,\r\n    maxFilterRadius?: number,\r\n    temporalJitter?: boolean\r\n  ) {\r\n    super();\r\n    this._lightRadius = lightRadius ?? 8;\r\n    this._blockerSampleCount = blockerSampleCount ?? 24;\r\n    this._filterSampleCount = filterSampleCount ?? 32;\r\n    this._maxFilterRadius = maxFilterRadius ?? 32;\r\n    this._temporalJitter = temporalJitter ?? true;\r\n  }\r\n  get lightRadius() {\r\n    return this._lightRadius;\r\n  }\r\n  set lightRadius(val) {\r\n    this._lightRadius = Math.max(0, Number(val) || 0);\r\n  }\r\n  get blockerSampleCount() {\r\n    return this._blockerSampleCount;\r\n  }\r\n  set blockerSampleCount(val) {\r\n    this._blockerSampleCount = Math.min(Math.max(1, Number(val) >> 0), 64);\r\n  }\r\n  get filterSampleCount() {\r\n    return this._filterSampleCount;\r\n  }\r\n  set filterSampleCount(val) {\r\n    this._filterSampleCount = Math.min(Math.max(1, Number(val) >> 0), 64);\r\n  }\r\n  get maxFilterRadius() {\r\n    return this._maxFilterRadius;\r\n  }\r\n  set maxFilterRadius(val) {\r\n    this._maxFilterRadius = Math.max(1, Number(val) || 1);\r\n  }\r\n  get temporalJitter() {\r\n    return this._temporalJitter;\r\n  }\r\n  set temporalJitter(val) {\r\n    this._temporalJitter = !!val;\r\n  }\r\n  getType() {\r\n    return 'pcss' as const;\r\n  }\r\n  dispose() {}\r\n  resourceDirty() {\r\n    return false;\r\n  }\r\n  getShadowMapBorder(_shadowMapParams: ShadowMapParams) {\r\n    return this._lightRadius > 0 ? Math.ceil(Math.max(this._lightRadius, this._maxFilterRadius) + 2) : 0;\r\n  }\r\n  getShadowMapClearColor(shadowMapParams: ShadowMapParams) {\r\n    const colorAttachment = shadowMapParams.shadowMapFramebuffer?.getColorAttachments()[0];\r\n    // Empty texels must read as \"farthest\" (no blocker): under reverse-Z\r\n    // that is 0 for the device-encoded directional/rect maps, while the\r\n    // linear point/spot encodings keep 1 = far.\r\n    const farthest = getShadowMapFarthestDepth(shadowMapParams.lightType);\r\n    return colorAttachment\r\n      ? colorAttachment.format === 'rgba8unorm'\r\n        ? getPackedShadowMapClearColor(shadowMapParams.lightType)\r\n        : new Vector4(farthest, farthest, farthest, 1)\r\n      : null;\r\n  }\r\n  getShadowMap(shadowMapParams: ShadowMapParams) {\r\n    return shadowMapParams.shadowMapFramebuffer!.getColorAttachments()[0] as ShadowMapType;\r\n  }\r\n  doUpdateResources(shadowMapParams: ShadowMapParams) {\r\n    shadowMapParams.shadowMap = this.getShadowMap(shadowMapParams);\r\n    shadowMapParams.shadowMapSampler = shadowMapParams.shadowMap?.getDefaultSampler(false) ?? null;\r\n  }\r\n  postRenderShadowMap() {}\r\n  getDepthScale() {\r\n    return 1;\r\n  }\r\n  setDepthScale(_val: number) {}\r\n  getShaderHash() {\r\n    return `${Number(this._temporalJitter)}`;\r\n  }\r\n  getShadowMapColorFormat(_shadowMapParams: ShadowMapParams): Nullable<TextureFormat> {\r\n    const device = getDevice();\r\n    if (device.type === 'webgl') {\r\n      return device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer\r\n        ? 'rgba16f'\r\n        : device.getDeviceCaps().textureCaps.supportFloatColorBuffer\r\n          ? 'rgba32f'\r\n          : 'rgba8unorm';\r\n    }\r\n    return device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer\r\n      ? 'r16f'\r\n      : device.getDeviceCaps().textureCaps.supportFloatColorBuffer\r\n        ? 'r32f'\r\n        : 'rgba8unorm';\r\n  }\r\n  getParams(out: Vector4) {\r\n    out = out ?? new Vector4();\r\n    out.setXYZW(this._lightRadius, this._blockerSampleCount, this._filterSampleCount, this._maxFilterRadius);\r\n    return out;\r\n  }\r\n  getShadowMapDepthFormat(_shadowMapParams: ShadowMapParams): TextureFormat {\r\n    return this.preferredShadowMapDepthFormat();\r\n  }\r\n  computeShadowMapDepth(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    worldPos: PBShaderExp\r\n  ) {\r\n    return computeShadowMapDepth(scope, worldPos, shadowMapParams.shadowMap!.format);\r\n  }\r\n  computeShadowCSM(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp,\r\n    split: PBShaderExp\r\n  ) {\r\n    const funcNameComputeShadowCSM = 'lib_computeShadowCSM';\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    pb.func(\r\n      funcNameComputeShadowCSM,\r\n      [pb.vec4('shadowVertex'), pb.float('NdotL'), pb.int('split')],\r\n      function () {\r\n        this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);\r\n        this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);\r\n        this.$l.inShadow = pb.all(\r\n          pb.bvec2(\r\n            pb.all(\r\n              pb.bvec4(\r\n                pb.greaterThanEqual(this.shadowCoord.x, 0),\r\n                pb.lessThanEqual(this.shadowCoord.x, 1),\r\n                pb.greaterThanEqual(this.shadowCoord.y, 0),\r\n                pb.lessThanEqual(this.shadowCoord.y, 1)\r\n              )\r\n            ),\r\n            shadowCoordDepthInRange(this, this.shadowCoord.z)\r\n          )\r\n        );\r\n        this.$l.shadow = pb.float(1);\r\n        this.$l.receiverPlaneDepthBias = computeReceiverPlaneDepthBias(this, this.shadowCoord);\r\n        this.$if(this.inShadow, function () {\r\n          this.$l.shadowBias = computeShadowBiasCSM(this, this.NdotL, this.split);\r\n          this.shadowCoord.z = applyShadowDepthBias(this, this.shadowCoord.z, this.shadowBias, true);\r\n          this.shadow = filterShadowPCSS(\r\n            this,\r\n            shadowMapParams.lightType,\r\n            shadowMapParams.shadowMap!.format,\r\n            this.shadowCoord,\r\n            this.receiverPlaneDepthBias,\r\n            this.split,\r\n            that._temporalJitter,\r\n            shadowMapParams.numShadowCascades\r\n          );\r\n        });\r\n        this.$return(this.shadow);\r\n      }\r\n    );\r\n    return pb.getGlobalScope()[funcNameComputeShadowCSM](shadowVertex, NdotL, split) as PBShaderExp;\r\n  }\r\n  computeShadow(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp\r\n  ) {\r\n    const funcNameComputeShadow = 'lib_computeShadow';\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    pb.func(funcNameComputeShadow, [pb.vec4('shadowVertex'), pb.float('NdotL')], function () {\r\n      if (shadowMapParams.lightType === LIGHT_TYPE_POINT) {\r\n        this.$l.dir = pb.sub(this.shadowVertex.xyz, ShaderHelper.getLightPositionAndRangeForShadow(this).xyz);\r\n        this.$l.distance = pb.div(\r\n          pb.length(this.dir),\r\n          ShaderHelper.getLightPositionAndRangeForShadow(this).w\r\n        );\r\n        this.$l.shadowBias = computeShadowBias(\r\n          shadowMapParams.lightType,\r\n          this,\r\n          this.distance,\r\n          this.NdotL,\r\n          true\r\n        );\r\n        this.$l.shadowCoord = pb.vec4(this.dir, pb.sub(this.distance, this.shadowBias));\r\n        this.$return(\r\n          filterShadowPCSS(\r\n            this,\r\n            shadowMapParams.lightType,\r\n            shadowMapParams.shadowMap!.format,\r\n            this.shadowCoord,\r\n            undefined,\r\n            undefined,\r\n            that._temporalJitter\r\n          )\r\n        );\r\n      }\r\n      this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);\r\n      this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);\r\n      this.$l.inShadow = pb.all(\r\n        pb.bvec2(\r\n          pb.all(\r\n            pb.bvec4(\r\n              pb.greaterThanEqual(this.shadowCoord.x, 0),\r\n              pb.lessThanEqual(this.shadowCoord.x, 1),\r\n              pb.greaterThanEqual(this.shadowCoord.y, 0),\r\n              pb.lessThanEqual(this.shadowCoord.y, 1)\r\n            )\r\n          ),\r\n          shadowCoordDepthInRange(this, this.shadowCoord.z)\r\n        )\r\n      );\r\n      this.$l.shadow = pb.float(1);\r\n      if (shadowMapParams.lightType === LIGHT_TYPE_SPOT) {\r\n        this.$l.nearFar = ShaderHelper.getShadowCameraParams(this).xy;\r\n        this.shadowCoord.z = ShaderHelper.nonLinearDepthToLinearNormalized(\r\n          this,\r\n          this.shadowCoord.z,\r\n          this.nearFar\r\n        );\r\n      }\r\n      this.$l.receiverPlaneDepthBias = computeReceiverPlaneDepthBias(this, this.shadowCoord);\r\n      this.$if(this.inShadow, function () {\r\n        if (shadowMapParams.lightType === LIGHT_TYPE_SPOT) {\r\n          this.$l.shadowBias = computeShadowBias(\r\n            shadowMapParams.lightType,\r\n            this,\r\n            this.shadowCoord.z,\r\n            this.NdotL,\r\n            true\r\n          );\r\n        } else {\r\n          this.$l.shadowBias = computeShadowBias(\r\n            shadowMapParams.lightType,\r\n            this,\r\n            this.shadowCoord.z,\r\n            this.NdotL,\r\n            false\r\n          );\r\n        }\r\n        this.shadowCoord.z = applyShadowDepthBias(\r\n          this,\r\n          this.shadowCoord.z,\r\n          this.shadowBias,\r\n          shadowMapParams.lightType !== LIGHT_TYPE_SPOT\r\n        );\r\n        this.shadow = filterShadowPCSS(\r\n          this,\r\n          shadowMapParams.lightType,\r\n          shadowMapParams.shadowMap!.format,\r\n          this.shadowCoord,\r\n          this.receiverPlaneDepthBias,\r\n          undefined,\r\n          that._temporalJitter\r\n        );\r\n      });\r\n      this.$return(this.shadow);\r\n    });\r\n    return pb.getGlobalScope()[funcNameComputeShadow](shadowVertex, NdotL) as PBShaderExp;\r\n  }\r\n  useNativeShadowMap(_shadowMapParams: ShadowMapParams) {\r\n    return false;\r\n  }\r\n  /** @internal */\r\n  samplePointShadowMap(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    coords: PBShaderExp,\r\n    z: PBShaderExp,\r\n    bias: PBShaderExp\r\n  ) {\r\n    const funcNameSampleShadowMap = 'lib_samplePointShadowMapPCSS';\r\n    const pb = scope.$builder;\r\n    pb.func(funcNameSampleShadowMap, [pb.vec3('coords'), pb.float('z'), pb.float('bias')], function () {\r\n      const floatDepthTexture = shadowMapParams.shadowMap!.format !== 'rgba8unorm';\r\n      this.$l.shadowTex = pb.textureSampleLevel(ShaderHelper.getShadowMap(this), this.coords, 0);\r\n      if (!floatDepthTexture) {\r\n        this.shadowTex.x = decodeNormalizedFloatFromRGBA(this, this.shadowTex);\r\n      }\r\n      this.$l.distance = pb.sub(this.z, this.bias);\r\n      this.$return(pb.step(this.distance, this.shadowTex.x));\r\n    });\r\n    return pb.getGlobalScope()[funcNameSampleShadowMap](coords, z, bias) as PBShaderExp;\r\n  }\r\n}\r\n"],"names":["PCSS","ShadowImpl","_lightRadius","_blockerSampleCount","_filterSampleCount","_maxFilterRadius","_temporalJitter","lightRadius","blockerSampleCount","filterSampleCount","maxFilterRadius","temporalJitter","val","Math","max","Number","min","getType","dispose","resourceDirty","getShadowMapBorder","_shadowMapParams","ceil","getShadowMapClearColor","shadowMapParams","colorAttachment","shadowMapFramebuffer","getColorAttachments","farthest","getShadowMapFarthestDepth","lightType","format","getPackedShadowMapClearColor","Vector4","getShadowMap","doUpdateResources","shadowMap","shadowMapSampler","getDefaultSampler","postRenderShadowMap","getDepthScale","setDepthScale","_val","getShaderHash","getShadowMapColorFormat","device","getDevice","type","getDeviceCaps","textureCaps","supportHalfFloatColorBuffer","supportFloatColorBuffer","getParams","out","setXYZW","getShadowMapDepthFormat","preferredShadowMapDepthFormat","computeShadowMapDepth","scope","worldPos","computeShadowCSM","shadowVertex","NdotL","split","funcNameComputeShadowCSM","pb","$builder","that","func","vec4","float","int","$l","shadowCoord","div","w","ndcToShadowCoord","inShadow","all","bvec2","bvec4","greaterThanEqual","x","lessThanEqual","y","shadowCoordDepthInRange","z","shadow","receiverPlaneDepthBias","computeReceiverPlaneDepthBias","$if","shadowBias","computeShadowBiasCSM","applyShadowDepthBias","filterShadowPCSS","numShadowCascades","$return","getGlobalScope","computeShadow","funcNameComputeShadow","LIGHT_TYPE_POINT","dir","sub","xyz","ShaderHelper","getLightPositionAndRangeForShadow","distance","length","computeShadowBias","undefined","LIGHT_TYPE_SPOT","nearFar","getShadowCameraParams","xy","nonLinearDepthToLinearNormalized","useNativeShadowMap","samplePointShadowMap","coords","bias","funcNameSampleShadowMap","vec3","floatDepthTexture","shadowTex","textureSampleLevel","decodeNormalizedFloatFromRGBA","step"],"mappings":"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"}
+{"version":3,"file":"pcss.js","sources":["../../src/shadow/pcss.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\r\nimport { Vector4 } from '@zephyr3d/base';\r\nimport type { PBInsideFunctionScope, PBShaderExp, TextureFormat } from '@zephyr3d/device';\r\nimport { getPackedShadowMapClearColor, getShadowMapFarthestDepth, ShadowImpl } from './shadow_impl';\r\nimport type { ShadowMapParams, ShadowMapType } from './shadowmapper';\r\nimport {\r\n  applyShadowDepthBias,\r\n  computeReceiverPlaneDepthBias,\r\n  computeShadowMapDepth,\r\n  filterShadowPCSS,\r\n  ndcToShadowCoord,\r\n  shadowCoordDepthInRange\r\n} from '../shaders/shadow';\r\nimport { decodeNormalizedFloatFromRGBA } from '../shaders/misc';\r\nimport { LIGHT_TYPE_POINT, LIGHT_TYPE_SPOT } from '../values';\r\nimport { ShaderHelper } from '../material/shader/helper';\r\nimport { computeShadowBias, computeShadowBiasCSM } from './shader';\r\nimport { getDevice } from '../app/api';\r\n\r\n/** @internal */\r\nexport class PCSS extends ShadowImpl {\r\n  protected _lightRadius: number;\r\n  protected _blockerSampleCount: number;\r\n  protected _filterSampleCount: number;\r\n  protected _maxFilterRadius: number;\r\n  protected _temporalJitter: boolean;\r\n  protected _physicalLightRadius: number;\r\n  constructor(\r\n    lightRadius?: number,\r\n    blockerSampleCount?: number,\r\n    filterSampleCount?: number,\r\n    maxFilterRadius?: number,\r\n    temporalJitter?: boolean\r\n  ) {\r\n    super();\r\n    this._lightRadius = lightRadius ?? 8;\r\n    this._blockerSampleCount = blockerSampleCount ?? 24;\r\n    this._filterSampleCount = filterSampleCount ?? 32;\r\n    this._maxFilterRadius = maxFilterRadius ?? 32;\r\n    this._temporalJitter = temporalJitter ?? true;\r\n    this._physicalLightRadius = 0;\r\n  }\r\n  /**\r\n   * Source radius in world units, overriding {@link lightRadius} when positive.\r\n   *\r\n   * @remarks\r\n   * {@link lightRadius} is a fixed size in shadow map texels, so the penumbra it\r\n   * produces does not follow the light's actual size or the receiver's distance\r\n   * from it. A physical radius is converted per pixel instead (cube maps only,\r\n   * i.e. point and rect lights); the shadow mapper sets it from a rect light's\r\n   * size. It travels to the shader as a negative `lightRadius`.\r\n   */\r\n  get physicalLightRadius() {\r\n    return this._physicalLightRadius;\r\n  }\r\n  set physicalLightRadius(val) {\r\n    this._physicalLightRadius = Math.max(0, Number(val) || 0);\r\n  }\r\n  get lightRadius() {\r\n    return this._lightRadius;\r\n  }\r\n  set lightRadius(val) {\r\n    this._lightRadius = Math.max(0, Number(val) || 0);\r\n  }\r\n  get blockerSampleCount() {\r\n    return this._blockerSampleCount;\r\n  }\r\n  set blockerSampleCount(val) {\r\n    this._blockerSampleCount = Math.min(Math.max(1, Number(val) >> 0), 64);\r\n  }\r\n  get filterSampleCount() {\r\n    return this._filterSampleCount;\r\n  }\r\n  set filterSampleCount(val) {\r\n    this._filterSampleCount = Math.min(Math.max(1, Number(val) >> 0), 64);\r\n  }\r\n  get maxFilterRadius() {\r\n    return this._maxFilterRadius;\r\n  }\r\n  set maxFilterRadius(val) {\r\n    this._maxFilterRadius = Math.max(1, Number(val) || 1);\r\n  }\r\n  get temporalJitter() {\r\n    return this._temporalJitter;\r\n  }\r\n  set temporalJitter(val) {\r\n    this._temporalJitter = !!val;\r\n  }\r\n  getType() {\r\n    return 'pcss' as const;\r\n  }\r\n  dispose() {}\r\n  resourceDirty() {\r\n    return false;\r\n  }\r\n  getShadowMapBorder(_shadowMapParams: ShadowMapParams) {\r\n    return this._lightRadius > 0 ? Math.ceil(Math.max(this._lightRadius, this._maxFilterRadius) + 2) : 0;\r\n  }\r\n  getShadowMapClearColor(shadowMapParams: ShadowMapParams) {\r\n    const colorAttachment = shadowMapParams.shadowMapFramebuffer?.getColorAttachments()[0];\r\n    // Empty texels must read as \"farthest\" (no blocker): under reverse-Z\r\n    // that is 0 for the device-encoded directional/rect maps, while the\r\n    // linear point/spot encodings keep 1 = far.\r\n    const farthest = getShadowMapFarthestDepth(shadowMapParams.lightType);\r\n    return colorAttachment\r\n      ? colorAttachment.format === 'rgba8unorm'\r\n        ? getPackedShadowMapClearColor(shadowMapParams.lightType)\r\n        : new Vector4(farthest, farthest, farthest, 1)\r\n      : null;\r\n  }\r\n  getShadowMap(shadowMapParams: ShadowMapParams) {\r\n    return shadowMapParams.shadowMapFramebuffer!.getColorAttachments()[0] as ShadowMapType;\r\n  }\r\n  doUpdateResources(shadowMapParams: ShadowMapParams) {\r\n    shadowMapParams.shadowMap = this.getShadowMap(shadowMapParams);\r\n    shadowMapParams.shadowMapSampler = shadowMapParams.shadowMap?.getDefaultSampler(false) ?? null;\r\n  }\r\n  postRenderShadowMap() {}\r\n  getDepthScale() {\r\n    return 1;\r\n  }\r\n  setDepthScale(_val: number) {}\r\n  getShaderHash() {\r\n    return `${Number(this._temporalJitter)}`;\r\n  }\r\n  getShadowMapColorFormat(_shadowMapParams: ShadowMapParams): Nullable<TextureFormat> {\r\n    const device = getDevice();\r\n    return device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer\r\n      ? 'r16f'\r\n      : device.getDeviceCaps().textureCaps.supportFloatColorBuffer\r\n        ? 'r32f'\r\n        : 'rgba8unorm';\r\n  }\r\n  getParams(out: Vector4) {\r\n    out = out ?? new Vector4();\r\n    out.setXYZW(\r\n      this._physicalLightRadius > 0 ? -this._physicalLightRadius : this._lightRadius,\r\n      this._blockerSampleCount,\r\n      this._filterSampleCount,\r\n      this._maxFilterRadius\r\n    );\r\n    return out;\r\n  }\r\n  getShadowMapDepthFormat(_shadowMapParams: ShadowMapParams): TextureFormat {\r\n    return this.preferredShadowMapDepthFormat();\r\n  }\r\n  computeShadowMapDepth(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    worldPos: PBShaderExp\r\n  ) {\r\n    return computeShadowMapDepth(scope, worldPos, shadowMapParams.shadowMap!.format);\r\n  }\r\n  computeShadowCSM(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp,\r\n    split: PBShaderExp\r\n  ) {\r\n    const funcNameComputeShadowCSM = 'lib_computeShadowCSM';\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    pb.func(\r\n      funcNameComputeShadowCSM,\r\n      [pb.vec4('shadowVertex'), pb.float('NdotL'), pb.int('split')],\r\n      function () {\r\n        this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);\r\n        this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);\r\n        this.$l.inShadow = pb.all(\r\n          pb.bvec2(\r\n            pb.all(\r\n              pb.bvec4(\r\n                pb.greaterThanEqual(this.shadowCoord.x, 0),\r\n                pb.lessThanEqual(this.shadowCoord.x, 1),\r\n                pb.greaterThanEqual(this.shadowCoord.y, 0),\r\n                pb.lessThanEqual(this.shadowCoord.y, 1)\r\n              )\r\n            ),\r\n            shadowCoordDepthInRange(this, this.shadowCoord.z)\r\n          )\r\n        );\r\n        this.$l.shadow = pb.float(1);\r\n        this.$l.receiverPlaneDepthBias = computeReceiverPlaneDepthBias(this, this.shadowCoord);\r\n        this.$if(this.inShadow, function () {\r\n          this.$l.shadowBias = computeShadowBiasCSM(this, this.NdotL, this.split);\r\n          this.shadowCoord.z = applyShadowDepthBias(this, this.shadowCoord.z, this.shadowBias, true);\r\n          this.shadow = filterShadowPCSS(\r\n            this,\r\n            shadowMapParams.lightType,\r\n            shadowMapParams.shadowMap!.format,\r\n            this.shadowCoord,\r\n            this.receiverPlaneDepthBias,\r\n            this.split,\r\n            that._temporalJitter,\r\n            shadowMapParams.numShadowCascades\r\n          );\r\n        });\r\n        this.$return(this.shadow);\r\n      }\r\n    );\r\n    return pb.getGlobalScope()[funcNameComputeShadowCSM](shadowVertex, NdotL, split) as PBShaderExp;\r\n  }\r\n  computeShadow(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp,\r\n    worldNormal?: PBShaderExp\r\n  ) {\r\n    // Only the cube branch reads the normal, so only it gets the extra parameter.\r\n    const withNormal = !!worldNormal && shadowMapParams.lightType === LIGHT_TYPE_POINT;\r\n    const funcNameComputeShadow = withNormal ? 'lib_computeShadow_N' : 'lib_computeShadow';\r\n    const pb = scope.$builder;\r\n    const that = this;\r\n    pb.func(\r\n      funcNameComputeShadow,\r\n      [pb.vec4('shadowVertex'), pb.float('NdotL'), ...(withNormal ? [pb.vec3('worldNormal')] : [])],\r\n      function () {\r\n        if (shadowMapParams.lightType === LIGHT_TYPE_POINT) {\r\n          this.$l.dir = pb.sub(\r\n            this.shadowVertex.xyz,\r\n            ShaderHelper.getLightPositionAndRangeForShadow(this).xyz\r\n          );\r\n          this.$l.distance = pb.div(\r\n            pb.length(this.dir),\r\n            ShaderHelper.getLightPositionAndRangeForShadow(this).w\r\n          );\r\n          this.$l.shadowBias = computeShadowBias(\r\n            shadowMapParams.lightType,\r\n            this,\r\n            this.distance,\r\n            this.NdotL,\r\n            true\r\n          );\r\n          this.$l.shadowCoord = pb.vec4(this.dir, pb.sub(this.distance, this.shadowBias));\r\n          this.$return(\r\n            filterShadowPCSS(\r\n              this,\r\n              shadowMapParams.lightType,\r\n              shadowMapParams.shadowMap!.format,\r\n              this.shadowCoord,\r\n              // The receiver's plane, so wide kernels compare each tap against the\r\n              // receiver's own depth there - see pointReceiverPlaneDepth. The\r\n              // geometric normal rather than screen derivatives: no uniform control\r\n              // flow requirement, and no mixing across silhouettes.\r\n              withNormal ? this.worldNormal : undefined,\r\n              undefined,\r\n              that._temporalJitter\r\n            )\r\n          );\r\n        }\r\n        this.$l.shadowCoord = pb.div(this.shadowVertex, this.shadowVertex.w);\r\n        this.$l.shadowCoord = ndcToShadowCoord(this, this.shadowCoord);\r\n        this.$l.inShadow = pb.all(\r\n          pb.bvec2(\r\n            pb.all(\r\n              pb.bvec4(\r\n                pb.greaterThanEqual(this.shadowCoord.x, 0),\r\n                pb.lessThanEqual(this.shadowCoord.x, 1),\r\n                pb.greaterThanEqual(this.shadowCoord.y, 0),\r\n                pb.lessThanEqual(this.shadowCoord.y, 1)\r\n              )\r\n            ),\r\n            shadowCoordDepthInRange(this, this.shadowCoord.z)\r\n          )\r\n        );\r\n        this.$l.shadow = pb.float(1);\r\n        if (shadowMapParams.lightType === LIGHT_TYPE_SPOT) {\r\n          this.$l.nearFar = ShaderHelper.getShadowCameraParams(this).xy;\r\n          this.shadowCoord.z = ShaderHelper.nonLinearDepthToLinearNormalized(\r\n            this,\r\n            this.shadowCoord.z,\r\n            this.nearFar\r\n          );\r\n        }\r\n        this.$l.receiverPlaneDepthBias = computeReceiverPlaneDepthBias(this, this.shadowCoord);\r\n        this.$if(this.inShadow, function () {\r\n          if (shadowMapParams.lightType === LIGHT_TYPE_SPOT) {\r\n            this.$l.shadowBias = computeShadowBias(\r\n              shadowMapParams.lightType,\r\n              this,\r\n              this.shadowCoord.z,\r\n              this.NdotL,\r\n              true\r\n            );\r\n          } else {\r\n            this.$l.shadowBias = computeShadowBias(\r\n              shadowMapParams.lightType,\r\n              this,\r\n              this.shadowCoord.z,\r\n              this.NdotL,\r\n              false\r\n            );\r\n          }\r\n          this.shadowCoord.z = applyShadowDepthBias(\r\n            this,\r\n            this.shadowCoord.z,\r\n            this.shadowBias,\r\n            shadowMapParams.lightType !== LIGHT_TYPE_SPOT\r\n          );\r\n          this.shadow = filterShadowPCSS(\r\n            this,\r\n            shadowMapParams.lightType,\r\n            shadowMapParams.shadowMap!.format,\r\n            this.shadowCoord,\r\n            this.receiverPlaneDepthBias,\r\n            undefined,\r\n            that._temporalJitter\r\n          );\r\n        });\r\n        this.$return(this.shadow);\r\n      }\r\n    );\r\n    return pb\r\n      .getGlobalScope()\r\n      [funcNameComputeShadow](shadowVertex, NdotL, ...(withNormal ? [worldNormal!] : [])) as PBShaderExp;\r\n  }\r\n  useNativeShadowMap(_shadowMapParams: ShadowMapParams) {\r\n    return false;\r\n  }\r\n  /** @internal */\r\n  samplePointShadowMap(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    coords: PBShaderExp,\r\n    z: PBShaderExp,\r\n    bias: PBShaderExp\r\n  ) {\r\n    const funcNameSampleShadowMap = 'lib_samplePointShadowMapPCSS';\r\n    const pb = scope.$builder;\r\n    pb.func(funcNameSampleShadowMap, [pb.vec3('coords'), pb.float('z'), pb.float('bias')], function () {\r\n      const floatDepthTexture = shadowMapParams.shadowMap!.format !== 'rgba8unorm';\r\n      this.$l.shadowTex = pb.textureSampleLevel(ShaderHelper.getShadowMap(this), this.coords, 0);\r\n      if (!floatDepthTexture) {\r\n        this.shadowTex.x = decodeNormalizedFloatFromRGBA(this, this.shadowTex);\r\n      }\r\n      this.$l.distance = pb.sub(this.z, this.bias);\r\n      this.$return(pb.step(this.distance, this.shadowTex.x));\r\n    });\r\n    return pb.getGlobalScope()[funcNameSampleShadowMap](coords, z, bias) as PBShaderExp;\r\n  }\r\n}\r\n"],"names":["PCSS","ShadowImpl","_lightRadius","_blockerSampleCount","_filterSampleCount","_maxFilterRadius","_temporalJitter","_physicalLightRadius","lightRadius","blockerSampleCount","filterSampleCount","maxFilterRadius","temporalJitter","physicalLightRadius","val","Math","max","Number","min","getType","dispose","resourceDirty","getShadowMapBorder","_shadowMapParams","ceil","getShadowMapClearColor","shadowMapParams","colorAttachment","shadowMapFramebuffer","getColorAttachments","farthest","getShadowMapFarthestDepth","lightType","format","getPackedShadowMapClearColor","Vector4","getShadowMap","doUpdateResources","shadowMap","shadowMapSampler","getDefaultSampler","postRenderShadowMap","getDepthScale","setDepthScale","_val","getShaderHash","getShadowMapColorFormat","device","getDevice","getDeviceCaps","textureCaps","supportHalfFloatColorBuffer","supportFloatColorBuffer","getParams","out","setXYZW","getShadowMapDepthFormat","preferredShadowMapDepthFormat","computeShadowMapDepth","scope","worldPos","computeShadowCSM","shadowVertex","NdotL","split","funcNameComputeShadowCSM","pb","$builder","that","func","vec4","float","int","$l","shadowCoord","div","w","ndcToShadowCoord","inShadow","all","bvec2","bvec4","greaterThanEqual","x","lessThanEqual","y","shadowCoordDepthInRange","z","shadow","receiverPlaneDepthBias","computeReceiverPlaneDepthBias","$if","shadowBias","computeShadowBiasCSM","applyShadowDepthBias","filterShadowPCSS","numShadowCascades","$return","getGlobalScope","computeShadow","worldNormal","withNormal","LIGHT_TYPE_POINT","funcNameComputeShadow","vec3","dir","sub","xyz","ShaderHelper","getLightPositionAndRangeForShadow","distance","length","computeShadowBias","undefined","LIGHT_TYPE_SPOT","nearFar","getShadowCameraParams","xy","nonLinearDepthToLinearNormalized","useNativeShadowMap","samplePointShadowMap","coords","bias","funcNameSampleShadowMap","floatDepthTexture","shadowTex","textureSampleLevel","decodeNormalizedFloatFromRGBA","step"],"mappings":"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"}

package/dist/shadow/shadow_impl.js

@@ -1,6 +1,5 @@
 import { Vector4, REVERSE_Z } from '@zephyr3d/base';
 import { isDeviceDepthShadow } from '../shaders/shadow.js';
-import { getDevice } from '../app/api.js';
 
 /** @internal */ function getShadowMapFarthestDepth(lightType) {
     return REVERSE_Z && isDeviceDepthShadow(lightType) ? 0 : 1;
@@ -31,15 +30,11 @@ import { getDevice } from '../app/api.js';
     /**
    * Depth format for shadow maps rendered into a native depth attachment.
    *
-   * Float depth everywhere except WebGL, where d24s8 is kept under
-   * standard-Z (WebGL1 compatibility, no precision benefit anyway). Under
-   * reverse-Z the WebGL2 float depth format is used so shadow maps share
-   * the near-uniform precision distribution (full benefit with
-   * EXT_clip_control active).
+   * Float depth on every backend, so shadow maps share the near-uniform
+   * precision distribution of reverse-Z.
    * @internal
    */ preferredShadowMapDepthFormat() {
-        const device = getDevice();
-        return device.type !== 'webgl' || REVERSE_Z && device.getDeviceCaps().framebufferCaps.supportDepth32float ? 'd32f' : 'd24s8';
+        return 'd32f';
     }
     /**
    * Number of geometry passes this implementation needs over the shadow casters.

package/dist/shadow/shadow_impl.js.map

@@ -1 +1 @@
-{"version":3,"file":"shadow_impl.js","sources":["../../src/shadow/shadow_impl.ts"],"sourcesContent":["import type {\r\n  BindGroup,\r\n  PBGlobalScope,\r\n  PBInsideFunctionScope,\r\n  PBShaderExp,\r\n  RenderStateSet,\r\n  TextureFormat\r\n} from '@zephyr3d/device';\r\nimport type { ShadowMapParams, ShadowMapType, ShadowMode } from './shadowmapper';\r\nimport { REVERSE_Z, Vector4, type Nullable } from '@zephyr3d/base';\r\nimport { isDeviceDepthShadow } from '../shaders/shadow';\r\nimport { getDevice } from '../app/api';\r\n\r\n/** @internal */\r\nexport function getShadowMapFarthestDepth(lightType: number) {\r\n  return REVERSE_Z && isDeviceDepthShadow(lightType) ? 0 : 1;\r\n}\r\n\r\n/** @internal */\r\nexport function getPackedShadowMapClearColor(lightType: number) {\r\n  // The RGBA8 decoder assigns the alpha channel a weight of 1, so the\r\n  // normalized depth endpoints are represented by transparent/opaque black.\r\n  return new Vector4(0, 0, 0, getShadowMapFarthestDepth(lightType));\r\n}\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    // Empty texels must read as \"farthest\": under reverse-Z that is 0 for\r\n    // device-encoded directional/rect maps, 1 for linear point/spot maps.\r\n    const farthest = getShadowMapFarthestDepth(shadowMapParams.lightType);\r\n    return colorAttachment\r\n      ? colorAttachment.isFloatFormat()\r\n        ? new Vector4(farthest, farthest, farthest, 1)\r\n        : getPackedShadowMapClearColor(shadowMapParams.lightType)\r\n      : null;\r\n  }\r\n  /**\r\n   * Depth format for shadow maps rendered into a native depth attachment.\r\n   *\r\n   * Float depth everywhere except WebGL, where d24s8 is kept under\r\n   * standard-Z (WebGL1 compatibility, no precision benefit anyway). Under\r\n   * reverse-Z the WebGL2 float depth format is used so shadow maps share\r\n   * the near-uniform precision distribution (full benefit with\r\n   * EXT_clip_control active).\r\n   * @internal\r\n   */\r\n  protected preferredShadowMapDepthFormat(): TextureFormat {\r\n    const device = getDevice();\r\n    return device.type !== 'webgl' ||\r\n      (REVERSE_Z && device.getDeviceCaps().framebufferCaps.supportDepth32float)\r\n      ? 'd32f'\r\n      : 'd24s8';\r\n  }\r\n  abstract getParams(out?: Vector4): Vector4;\r\n  /**\r\n   * Number of geometry passes this implementation needs over the shadow casters.\r\n   *\r\n   * Almost every technique rasterises the casters once and post-processes the\r\n   * result, which is what {@link postRenderShadowMap} is for - it runs after the\r\n   * geometry is on the map and receives no scene state, so a blur or resolve\r\n   * fits there but a second draw of the casters does not.\r\n   *\r\n   * Deep opacity maps do need that second draw: the first pass establishes the\r\n   * frontmost depth per texel and the second accumulates transmittance in layers\r\n   * measured from it, so the casters must be rasterised again with the first\r\n   * pass's output already available. Returning a count above one makes\r\n   * `ShadowMapper.render` repeat the draw, calling {@link beginGeometryPass}\r\n   * before each one.\r\n   *\r\n   * @returns The number of passes; one unless overridden.\r\n   */\r\n  getGeometryPassCount(_shadowMapParams: ShadowMapParams): number {\r\n    return 1;\r\n  }\r\n  /**\r\n   * Whether this implementation can split a directional light into cascades.\r\n   *\r\n   * Cascades need one shadow map per split, which every depth-based technique\r\n   * gets by rendering into array layers. A technique whose storage is already\r\n   * spoken for - a deep opacity map packs layer depth and coverage into the one\r\n   * texture the receiver is allowed to bind - has nowhere to put them, and asks\r\n   * to be driven with a single split instead.\r\n   *\r\n   * @returns True unless overridden.\r\n   */\r\n  supportsCascades(): boolean {\r\n    return true;\r\n  }\r\n  /**\r\n   * Prepares state for the given geometry pass.\r\n   *\r\n   * Only called when {@link getGeometryPassCount} returns more than one. The\r\n   * index is zero-based. Implementations that vary the emitted shader between\r\n   * passes must fold the index into {@link getShaderHash} as well, since the\r\n   * shadow pass keys its programs on that hash.\r\n   *\r\n   * @param shadowMapParams - Current shadow map state.\r\n   * @param pass - Zero-based index of the geometry pass about to run.\r\n   */\r\n  beginGeometryPass(_shadowMapParams: ShadowMapParams, _pass: number): void {}\r\n  /**\r\n   * Last say on the render states a shadow caster is drawn with.\r\n   *\r\n   * Runs after the material has set up its own states, in the same spirit as the\r\n   * OIT hook on the transparent pass. Techniques that rasterise the casters once\r\n   * want the defaults - depth test and write on, no blending - and leave this\r\n   * alone. An accumulating pass wants the opposite and overrides it here rather\r\n   * than teaching the material about shadow implementations.\r\n   *\r\n   * @param shadowMapParams - Current shadow map state.\r\n   * @param stateSet - The state set about to be applied, already populated.\r\n   */\r\n  setCasterRenderStates(_shadowMapParams: ShadowMapParams, _stateSet: RenderStateSet): void {}\r\n  /**\r\n   * Declares any extra resources the caster shader needs, in bind group 0.\r\n   *\r\n   * The shadow map pass otherwise gives a caster only the camera and the light,\r\n   * which is all a technique needs when it just records depth. One that reads\r\n   * back its own earlier output - a deep opacity map measuring layers from the\r\n   * frontmost strand - declares that input here instead of the pass hard-coding\r\n   * knowledge of the implementation.\r\n   *\r\n   * @param scope - Global shader scope of the caster program.\r\n   * @param shadowMapParams - Current shadow map state.\r\n   */\r\n  declareCasterUniforms(_scope: PBGlobalScope, _shadowMapParams: ShadowMapParams): void {}\r\n  /**\r\n   * Binds whatever {@link declareCasterUniforms} declared.\r\n   *\r\n   * @param bindGroup - Bind group 0 of the caster program.\r\n   * @param shadowMapParams - Current shadow map state.\r\n   */\r\n  applyCasterUniforms(_bindGroup: BindGroup, _shadowMapParams: ShadowMapParams): void {}\r\n  /**\r\n   * Whether casters should still be alpha-clipped before their shadow output.\r\n   *\r\n   * A depth-recording technique wants the clip: a fragment that fails it is not\r\n   * there, and letting it write depth would block light with geometry the eye\r\n   * never sees. A technique that records coverage instead wants the raw alpha,\r\n   * because the clip destroys exactly the quantity it is accumulating - a\r\n   * dithered caster survives with probability alpha and then contributes alpha,\r\n   * which accumulates alpha squared, and a cutoff drops the thin strands that\r\n   * carry most of a groom's transmittance.\r\n   *\r\n   * @param shadowMapParams - Current shadow map state.\r\n   * @returns True unless overridden.\r\n   */\r\n  clipsCasterAlpha(_shadowMapParams: ShadowMapParams): boolean {\r\n    return true;\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  /**\r\n   * Fragment output for a shadow caster.\r\n   *\r\n   * @param shadowMapParams - Current shadow map state.\r\n   * @param scope - Caster fragment scope.\r\n   * @param worldPos - World position of the fragment.\r\n   * @param alpha - The material's own alpha, or null when it computes no fragment\r\n   * colour and the fragment is therefore fully opaque. Depth-recording techniques\r\n   * ignore it - by the time this runs the fragment has already survived whatever\r\n   * alpha test applies - but one that records absorption needs the value itself.\r\n   * It must be passed rather than read out of `scope`, because the caller's\r\n   * `outColor` is local to the material's own shader function and defaults to a\r\n   * zero vector when no colour was computed, which is indistinguishable from a\r\n   * genuinely transparent fragment.\r\n   */\r\n  abstract computeShadowMapDepth(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    worldPos: PBShaderExp,\r\n    alpha: Nullable<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":["getShadowMapFarthestDepth","lightType","REVERSE_Z","isDeviceDepthShadow","getPackedShadowMapClearColor","Vector4","ShadowImpl","_resourceDirty","invalidateResource","updateResources","shadowMapParams","doUpdateResources","getShadowMapClearColor","colorAttachment","shadowMapFramebuffer","getColorAttachments","farthest","isFloatFormat","device","getDevice","type","getDeviceCaps","framebufferCaps","supportDepth32float","getGeometryPassCount","_shadowMapParams","supportsCascades","beginGeometryPass","_pass","setCasterRenderStates","_stateSet","declareCasterUniforms","_scope","applyCasterUniforms","_bindGroup","clipsCasterAlpha"],"mappings":";;;;AAaA,iBACO,SAASA,yBAAAA,CAA0BC,SAAiB,EAAA;IACzD,OAAOC,SAAAA,IAAaC,mBAAoBF,CAAAA,SAAAA,CAAAA,GAAa,CAAI,GAAA,CAAA;AAC3D;AAEA,iBACO,SAASG,4BAAAA,CAA6BH,SAAiB,EAAA;;;AAG5D,IAAA,OAAO,IAAII,OAAAA,CAAQ,CAAG,EAAA,CAAA,EAAG,GAAGL,yBAA0BC,CAAAA,SAAAA,CAAAA,CAAAA;AACxD;AAEA,iBACO,MAAeK,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;;;QAGtF,MAAMC,QAAAA,GAAWhB,yBAA0BU,CAAAA,eAAAA,CAAgBT,SAAS,CAAA;AACpE,QAAA,OAAOY,eACHA,GAAAA,eAAAA,CAAgBI,aAAa,EAAA,GAC3B,IAAIZ,OAAAA,CAAQW,QAAUA,EAAAA,QAAAA,EAAUA,QAAU,EAAA,CAAA,CAAA,GAC1CZ,4BAA6BM,CAAAA,eAAAA,CAAgBT,SAAS,CACxD,GAAA,IAAA;AACN;AACA;;;;;;;;;AASC,MACD,6BAAyD,GAAA;AACvD,QAAA,MAAMiB,MAASC,GAAAA,SAAAA,EAAAA;AACf,QAAA,OAAOD,MAAOE,CAAAA,IAAI,KAAK,OAAA,IACpBlB,SAAagB,IAAAA,MAAAA,CAAOG,aAAa,EAAA,CAAGC,eAAe,CAACC,mBAAmB,GACtE,MACA,GAAA,OAAA;AACN;AAEA;;;;;;;;;;;;;;;;MAiBAC,oBAAAA,CAAqBC,gBAAiC,EAAU;QAC9D,OAAO,CAAA;AACT;AACA;;;;;;;;;;AAUC,MACDC,gBAA4B,GAAA;QAC1B,OAAO,IAAA;AACT;AACA;;;;;;;;;;AAUC,MACDC,iBAAkBF,CAAAA,gBAAiC,EAAEG,KAAa,EAAQ;AAC1E;;;;;;;;;;;AAWC,MACDC,qBAAsBJ,CAAAA,gBAAiC,EAAEK,SAAyB,EAAQ;AAC1F;;;;;;;;;;;AAWC,MACDC,qBAAsBC,CAAAA,MAAqB,EAAEP,gBAAiC,EAAQ;AACtF;;;;;AAKC,MACDQ,mBAAoBC,CAAAA,UAAqB,EAAET,gBAAiC,EAAQ;AACpF;;;;;;;;;;;;;MAcAU,gBAAAA,CAAiBV,gBAAiC,EAAW;QAC3D,OAAO,IAAA;AACT;AA6CF;;;;"}
+{"version":3,"file":"shadow_impl.js","sources":["../../src/shadow/shadow_impl.ts"],"sourcesContent":["import type {\r\n  BindGroup,\r\n  PBGlobalScope,\r\n  PBInsideFunctionScope,\r\n  PBShaderExp,\r\n  RenderStateSet,\r\n  TextureFormat\r\n} from '@zephyr3d/device';\r\nimport type { ShadowMapParams, ShadowMapType, ShadowMode } from './shadowmapper';\r\nimport { REVERSE_Z, Vector4, type Nullable } from '@zephyr3d/base';\r\nimport { isDeviceDepthShadow } from '../shaders/shadow';\r\n\r\n/** @internal */\r\nexport function getShadowMapFarthestDepth(lightType: number) {\r\n  return REVERSE_Z && isDeviceDepthShadow(lightType) ? 0 : 1;\r\n}\r\n\r\n/** @internal */\r\nexport function getPackedShadowMapClearColor(lightType: number) {\r\n  // The RGBA8 decoder assigns the alpha channel a weight of 1, so the\r\n  // normalized depth endpoints are represented by transparent/opaque black.\r\n  return new Vector4(0, 0, 0, getShadowMapFarthestDepth(lightType));\r\n}\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    // Empty texels must read as \"farthest\": under reverse-Z that is 0 for\r\n    // device-encoded directional/rect maps, 1 for linear point/spot maps.\r\n    const farthest = getShadowMapFarthestDepth(shadowMapParams.lightType);\r\n    return colorAttachment\r\n      ? colorAttachment.isFloatFormat()\r\n        ? new Vector4(farthest, farthest, farthest, 1)\r\n        : getPackedShadowMapClearColor(shadowMapParams.lightType)\r\n      : null;\r\n  }\r\n  /**\r\n   * Depth format for shadow maps rendered into a native depth attachment.\r\n   *\r\n   * Float depth on every backend, so shadow maps share the near-uniform\r\n   * precision distribution of reverse-Z.\r\n   * @internal\r\n   */\r\n  protected preferredShadowMapDepthFormat(): TextureFormat {\r\n    return 'd32f';\r\n  }\r\n  abstract getParams(out?: Vector4): Vector4;\r\n  /**\r\n   * Number of geometry passes this implementation needs over the shadow casters.\r\n   *\r\n   * Almost every technique rasterises the casters once and post-processes the\r\n   * result, which is what {@link postRenderShadowMap} is for - it runs after the\r\n   * geometry is on the map and receives no scene state, so a blur or resolve\r\n   * fits there but a second draw of the casters does not.\r\n   *\r\n   * Deep opacity maps do need that second draw: the first pass establishes the\r\n   * frontmost depth per texel and the second accumulates transmittance in layers\r\n   * measured from it, so the casters must be rasterised again with the first\r\n   * pass's output already available. Returning a count above one makes\r\n   * `ShadowMapper.render` repeat the draw, calling {@link beginGeometryPass}\r\n   * before each one.\r\n   *\r\n   * @returns The number of passes; one unless overridden.\r\n   */\r\n  getGeometryPassCount(_shadowMapParams: ShadowMapParams): number {\r\n    return 1;\r\n  }\r\n  /**\r\n   * Whether this implementation can split a directional light into cascades.\r\n   *\r\n   * Cascades need one shadow map per split, which every depth-based technique\r\n   * gets by rendering into array layers. A technique whose storage is already\r\n   * spoken for - a deep opacity map packs layer depth and coverage into the one\r\n   * texture the receiver is allowed to bind - has nowhere to put them, and asks\r\n   * to be driven with a single split instead.\r\n   *\r\n   * @returns True unless overridden.\r\n   */\r\n  supportsCascades(): boolean {\r\n    return true;\r\n  }\r\n  /**\r\n   * Prepares state for the given geometry pass.\r\n   *\r\n   * Only called when {@link getGeometryPassCount} returns more than one. The\r\n   * index is zero-based. Implementations that vary the emitted shader between\r\n   * passes must fold the index into {@link getShaderHash} as well, since the\r\n   * shadow pass keys its programs on that hash.\r\n   *\r\n   * @param shadowMapParams - Current shadow map state.\r\n   * @param pass - Zero-based index of the geometry pass about to run.\r\n   */\r\n  beginGeometryPass(_shadowMapParams: ShadowMapParams, _pass: number): void {}\r\n  /**\r\n   * Last say on the render states a shadow caster is drawn with.\r\n   *\r\n   * Runs after the material has set up its own states, in the same spirit as the\r\n   * OIT hook on the transparent pass. Techniques that rasterise the casters once\r\n   * want the defaults - depth test and write on, no blending - and leave this\r\n   * alone. An accumulating pass wants the opposite and overrides it here rather\r\n   * than teaching the material about shadow implementations.\r\n   *\r\n   * @param shadowMapParams - Current shadow map state.\r\n   * @param stateSet - The state set about to be applied, already populated.\r\n   */\r\n  setCasterRenderStates(_shadowMapParams: ShadowMapParams, _stateSet: RenderStateSet): void {}\r\n  /**\r\n   * Declares any extra resources the caster shader needs, in bind group 0.\r\n   *\r\n   * The shadow map pass otherwise gives a caster only the camera and the light,\r\n   * which is all a technique needs when it just records depth. One that reads\r\n   * back its own earlier output - a deep opacity map measuring layers from the\r\n   * frontmost strand - declares that input here instead of the pass hard-coding\r\n   * knowledge of the implementation.\r\n   *\r\n   * @param scope - Global shader scope of the caster program.\r\n   * @param shadowMapParams - Current shadow map state.\r\n   */\r\n  declareCasterUniforms(_scope: PBGlobalScope, _shadowMapParams: ShadowMapParams): void {}\r\n  /**\r\n   * Binds whatever {@link declareCasterUniforms} declared.\r\n   *\r\n   * @param bindGroup - Bind group 0 of the caster program.\r\n   * @param shadowMapParams - Current shadow map state.\r\n   */\r\n  applyCasterUniforms(_bindGroup: BindGroup, _shadowMapParams: ShadowMapParams): void {}\r\n  /**\r\n   * Whether casters should still be alpha-clipped before their shadow output.\r\n   *\r\n   * A depth-recording technique wants the clip: a fragment that fails it is not\r\n   * there, and letting it write depth would block light with geometry the eye\r\n   * never sees. A technique that records coverage instead wants the raw alpha,\r\n   * because the clip destroys exactly the quantity it is accumulating - a\r\n   * dithered caster survives with probability alpha and then contributes alpha,\r\n   * which accumulates alpha squared, and a cutoff drops the thin strands that\r\n   * carry most of a groom's transmittance.\r\n   *\r\n   * @param shadowMapParams - Current shadow map state.\r\n   * @returns True unless overridden.\r\n   */\r\n  clipsCasterAlpha(_shadowMapParams: ShadowMapParams): boolean {\r\n    return true;\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  /**\r\n   * Fragment output for a shadow caster.\r\n   *\r\n   * @param shadowMapParams - Current shadow map state.\r\n   * @param scope - Caster fragment scope.\r\n   * @param worldPos - World position of the fragment.\r\n   * @param alpha - The material's own alpha, or null when it computes no fragment\r\n   * colour and the fragment is therefore fully opaque. Depth-recording techniques\r\n   * ignore it - by the time this runs the fragment has already survived whatever\r\n   * alpha test applies - but one that records absorption needs the value itself.\r\n   * It must be passed rather than read out of `scope`, because the caller's\r\n   * `outColor` is local to the material's own shader function and defaults to a\r\n   * zero vector when no colour was computed, which is indistinguishable from a\r\n   * genuinely transparent fragment.\r\n   */\r\n  abstract computeShadowMapDepth(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    worldPos: PBShaderExp,\r\n    alpha: Nullable<PBShaderExp>\r\n  ): PBShaderExp;\r\n  /**\r\n   * Shadow factor for a receiver, 1 meaning fully lit.\r\n   *\r\n   * @param worldNormal - The receiver's geometric normal, when the caller has\r\n   *   one. Implementations filtering a wide kernel over a cube map use it to\r\n   *   compare each tap against the receiver's own plane.\r\n   */\r\n  abstract computeShadow(\r\n    shadowMapParams: ShadowMapParams,\r\n    scope: PBInsideFunctionScope,\r\n    shadowVertex: PBShaderExp,\r\n    NdotL: PBShaderExp,\r\n    worldNormal?: 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":["getShadowMapFarthestDepth","lightType","REVERSE_Z","isDeviceDepthShadow","getPackedShadowMapClearColor","Vector4","ShadowImpl","_resourceDirty","invalidateResource","updateResources","shadowMapParams","doUpdateResources","getShadowMapClearColor","colorAttachment","shadowMapFramebuffer","getColorAttachments","farthest","isFloatFormat","getGeometryPassCount","_shadowMapParams","supportsCascades","beginGeometryPass","_pass","setCasterRenderStates","_stateSet","declareCasterUniforms","_scope","applyCasterUniforms","_bindGroup","clipsCasterAlpha"],"mappings":";;;AAYA,iBACO,SAASA,yBAAAA,CAA0BC,SAAiB,EAAA;IACzD,OAAOC,SAAAA,IAAaC,mBAAoBF,CAAAA,SAAAA,CAAAA,GAAa,CAAI,GAAA,CAAA;AAC3D;AAEA,iBACO,SAASG,4BAAAA,CAA6BH,SAAiB,EAAA;;;AAG5D,IAAA,OAAO,IAAII,OAAAA,CAAQ,CAAG,EAAA,CAAA,EAAG,GAAGL,yBAA0BC,CAAAA,SAAAA,CAAAA,CAAAA;AACxD;AAEA,iBACO,MAAeK,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;;;QAGtF,MAAMC,QAAAA,GAAWhB,yBAA0BU,CAAAA,eAAAA,CAAgBT,SAAS,CAAA;AACpE,QAAA,OAAOY,eACHA,GAAAA,eAAAA,CAAgBI,aAAa,EAAA,GAC3B,IAAIZ,OAAAA,CAAQW,QAAUA,EAAAA,QAAAA,EAAUA,QAAU,EAAA,CAAA,CAAA,GAC1CZ,4BAA6BM,CAAAA,eAAAA,CAAgBT,SAAS,CACxD,GAAA,IAAA;AACN;AACA;;;;;;AAMC,MACD,6BAAyD,GAAA;QACvD,OAAO,MAAA;AACT;AAEA;;;;;;;;;;;;;;;;MAiBAiB,oBAAAA,CAAqBC,gBAAiC,EAAU;QAC9D,OAAO,CAAA;AACT;AACA;;;;;;;;;;AAUC,MACDC,gBAA4B,GAAA;QAC1B,OAAO,IAAA;AACT;AACA;;;;;;;;;;AAUC,MACDC,iBAAkBF,CAAAA,gBAAiC,EAAEG,KAAa,EAAQ;AAC1E;;;;;;;;;;;AAWC,MACDC,qBAAsBJ,CAAAA,gBAAiC,EAAEK,SAAyB,EAAQ;AAC1F;;;;;;;;;;;AAWC,MACDC,qBAAsBC,CAAAA,MAAqB,EAAEP,gBAAiC,EAAQ;AACtF;;;;;AAKC,MACDQ,mBAAoBC,CAAAA,UAAqB,EAAET,gBAAiC,EAAQ;AACpF;;;;;;;;;;;;;MAcAU,gBAAAA,CAAiBV,gBAAiC,EAAW;QAC3D,OAAO,IAAA;AACT;AAqDF;;;;"}

package/dist/shadow/shadow_region.js

@@ -1,23 +1,31 @@
 import { Disposable, AABB, DWeakRef } from '@zephyr3d/base';
 
-/**
- * Maintains the world-space region used by directional light shadow maps.
- *
- * @public
+/**
+ * Maintains the world-space region used by directional light shadow maps.
+ *
+ * @remarks
+ * The region is the union of a manual AABB and the bounds of the static and dynamic
+ * casters, clipped to the optional limit set with {@link ShadowRegion.setLimit}.
+ * The limit keeps tracked casters that leave the play area, such as a falling
+ * physics body, from stretching the shadow map over empty space.
+ *
+ * @public
  */ class ShadowRegion extends Disposable {
     /** @internal */ _manualRegion;
+    /** @internal */ _limit;
     /** @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.
+    /**
+   * 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._limit = null;
         this._staticRegion = new AABB().beginExtend();
         this._dynamicRegion = new AABB().beginExtend();
         this._region = new AABB().beginExtend();
@@ -25,47 +33,66 @@ import { Disposable, AABB, DWeakRef } from '@zephyr3d/base';
         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.
+    /**
+   * Final world-space shadow region.
+   *
+   * @returns The union of the manual, static caster, and dynamic caster regions clipped to
+   *   {@link ShadowRegion.limit}, or `null` if no valid region exists or the union lies
+   *   entirely outside the limit.
    */ 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.
+    /**
+   * 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.
+    /**
+   * World-space AABB the final region is clipped to.
+   *
+   * @returns The limit, or `null` if the region is not limited.
+   */ get limit() {
+        return this._limit;
+    }
+    /**
+   * Limits the final region to a world-space AABB.
+   *
+   * @param limit - The AABB to clip the region to, or `null` to remove the limit.
+   * @returns `this` for chaining.
+   */ setLimit(limit) {
+        this._limit = limit?.isValid() ? new AABB(limit) : null;
+        this.updateRegion();
+        return this;
+    }
+    /**
+   * 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.
+    /**
+   * 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.
+    /**
+   * 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.
+    /**
+   * 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;
@@ -82,11 +109,11 @@ import { Disposable, AABB, DWeakRef } from '@zephyr3d/base';
         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.
+    /**
+   * 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;
@@ -106,11 +133,11 @@ import { Disposable, AABB, DWeakRef } from '@zephyr3d/base';
         }
         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.
+    /**
+   * 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--){
@@ -138,8 +165,8 @@ import { Disposable, AABB, DWeakRef } from '@zephyr3d/base';
         }
         return this;
     }
-    /**
-   * Removes all shadow casters while keeping the manual region.
+    /**
+   * Removes all shadow casters while keeping the manual region.
    */ clearCasters() {
         for (const entry of this._dynamicCasters){
             entry.ref.get()?.off('bvchanged', entry.callback);
@@ -154,10 +181,10 @@ import { Disposable, AABB, DWeakRef } from '@zephyr3d/base';
         this._dynamicRegion.beginExtend();
         this.updateRegion();
     }
-    /**
-   * Clears the manual region and all shadow casters.
-   *
-   * @returns `this` for chaining.
+    /**
+   * Clears the manual region and all shadow casters. The limit is kept.
+   *
+   * @returns `this` for chaining.
    */ clear() {
         this._manualRegion = null;
         this.clearCasters();
@@ -218,6 +245,17 @@ import { Disposable, AABB, DWeakRef } from '@zephyr3d/base';
         if (this._dynamicRegion.isValid()) {
             this.extendRegion(this._region, this._dynamicRegion);
         }
+        if (this._limit && this._region.isValid()) {
+            const min = this._region.minPoint;
+            const max = this._region.maxPoint;
+            const lmin = this._limit.minPoint;
+            const lmax = this._limit.maxPoint;
+            min.setXYZ(Math.max(min.x, lmin.x), Math.max(min.y, lmin.y), Math.max(min.z, lmin.z));
+            max.setXYZ(Math.min(max.x, lmax.x), Math.min(max.y, lmax.y), Math.min(max.z, lmax.z));
+            if (min.x > max.x || min.y > max.y || min.z > max.z) {
+                this._region.beginExtend();
+            }
+        }
     }
     /** @internal */ extendRegion(region, aabb) {
         region.extend(aabb.minPoint);