@zephyr3d/scene 0.9.26 → 0.10.0

package/dist/shadow/shadow_region.js.map

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

package/dist/shadow/shadowmapper.js

@@ -9,6 +9,7 @@ import { DOM } from './dom.js';
 import { LIGHT_TYPE_NONE, LIGHT_TYPE_POINT, LIGHT_TYPE_DIRECTIONAL } from '../values.js';
 import { getDevice } from '../app/api.js';
 import { ShadowRegion } from './shadow_region.js';
+import { warnUnsupported } from '../utility/unsupported.js';
 
 const tmpMatrix = new Matrix4x4();
 const tmpFrustum = new Frustum(Matrix4x4.identity());
@@ -22,6 +23,9 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
     /** @internal */ static _frustumMin = new Vector3();
     /** @internal */ static _frustumMax = new Vector3();
     /** @internal */ static _frustumCenter = new Vector3();
+    /** @internal */ static _clipMin = new Vector3();
+    /** @internal */ static _clipMax = new Vector3();
+    /** @internal */ static _cameraPos = new Vector3();
     /** @internal */ static _lightCameras = new WeakMap();
     /** @internal */ static _shadowMapParams = [];
     /** @internal */ _light;
@@ -63,7 +67,7 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
             splitLambda: 0.5,
             depthBias: 0.003,
             normalBias: 1.5,
-            nearClip: 1
+            nearClip: ShadowMapper.getDefaultNearClip(light)
         };
         this._resourceDirty = true;
         this._shadowMode = 'pcf';
@@ -235,7 +239,9 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
             this.splitLambda = 0.75;
             this.depthBias = 0.005;
             this.normalBias = 2;
-            this.nearClip = 0.2;
+            // Tighter than the default for spot lights; point and rect lights are
+            // already at their close-range default.
+            this.nearClip = Math.min(0.2, ShadowMapper.getDefaultNearClip(this._light));
             this.pcfKernelSize = 5;
             this.numShadowCascades = this._light.isDirectionLight() ? 3 : 1;
             return;
@@ -246,7 +252,7 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
         this.splitLambda = 0.6;
         this.depthBias = 0.0035;
         this.normalBias = 1.5;
-        this.nearClip = 1;
+        this.nearClip = ShadowMapper.getDefaultNearClip(this._light);
         this.pcfKernelSize = 3;
         this.numShadowCascades = this._light.isDirectionLight() ? 4 : 1;
     }
@@ -289,7 +295,13 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
             }
         }
     }
-    /** Light radius for PCSS shadow, measured in shadow-map texels */ get pcssLightRadius() {
+    /**
+   * Light radius for PCSS shadow, measured in shadow-map texels.
+   *
+   * @remarks
+   * Ignored for rect lights, whose penumbra is derived from their actual size
+   * and the receiver's distance instead.
+   */ get pcssLightRadius() {
         return this._pcssLightRadius;
     }
     set pcssLightRadius(val) {
@@ -559,7 +571,7 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
     }
     /** @internal */ static fetchTemporalFramebuffer(autoRelease, lightType, numCascades, width, height, colorFormat, depthFormat, mipmapping) {
         const device = getDevice();
-        const useTextureArray = numCascades > 1 && device.type !== 'webgl';
+        const useTextureArray = numCascades > 1;
         const colorAttachments = colorFormat ? useTextureArray ? [
             device.pool.fetchTemporalTexture2DArray(false, colorFormat, width, height, numCascades, mipmapping)
         ] : lightType === LIGHT_TYPE_POINT ? [
@@ -567,7 +579,7 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
         ] : [
             device.pool.fetchTemporalTexture2D(false, colorFormat, width, height, mipmapping)
         ] : null;
-        const depthAttachment = depthFormat ? useTextureArray ? device.pool.fetchTemporalTexture2DArray(false, depthFormat, width, height, numCascades, false) : device.type !== 'webgl' && lightType === LIGHT_TYPE_POINT ? device.pool.fetchTemporalTextureCube(false, depthFormat, width, false) : device.pool.fetchTemporalTexture2D(false, depthFormat, width, height, false) : null;
+        const depthAttachment = depthFormat ? useTextureArray ? device.pool.fetchTemporalTexture2DArray(false, depthFormat, width, height, numCascades, false) : lightType === LIGHT_TYPE_POINT ? device.pool.fetchTemporalTextureCube(false, depthFormat, width, false) : device.pool.fetchTemporalTexture2D(false, depthFormat, width, height, false) : null;
         const fb = device.pool.createTemporalFramebuffer(autoRelease, colorAttachments, depthAttachment);
         if (colorAttachments) {
             device.pool.releaseTexture(colorAttachments[0]);
@@ -578,39 +590,29 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
         return fb;
     }
     /** @internal */ updateResources(shadowMapParams) {
-        const device = getDevice();
         const colorFormat = shadowMapParams.impl.getShadowMapColorFormat(shadowMapParams);
         const depthFormat = shadowMapParams.impl.getShadowMapDepthFormat(shadowMapParams);
         const numCascades = shadowMapParams.numShadowCascades;
-        const useTextureArray = numCascades > 1 && device.type !== 'webgl';
-        const shadowMapWidth = numCascades > 1 && !useTextureArray ? 2 * this._config.shadowMapSize : this._config.shadowMapSize;
-        const shadowMapHeight = numCascades > 2 && !useTextureArray ? 2 * this._config.shadowMapSize : this._config.shadowMapSize;
-        /*
-    const colorAttachments = colorFormat
-      ? useTextureArray
-        ? [device.pool.fetchTemporalTexture2DArray(false, colorFormat, shadowMapWidth, shadowMapHeight, numCascades, false)]
-        : this._light.isPointLight()
-          ? [device.pool.fetchTemporalTextureCube(false, colorFormat, shadowMapWidth, false)]
-          : [device.pool.fetchTemporalTexture2D(false, colorFormat, shadowMapWidth, shadowMapHeight, false)]
-      : null;
-    const depthAttachment = depthFormat
-      ? useTextureArray
-        ? device.pool.fetchTemporalTexture2DArray(false, depthFormat, shadowMapWidth, shadowMapHeight, numCascades, false)
-        : device.type !== 'webgl' && this._light.isPointLight()
-          ? device.pool.fetchTemporalTextureCube(false, depthFormat, shadowMapWidth, false)
-          : device.pool.fetchTemporalTexture2D(false, depthFormat, shadowMapWidth, shadowMapHeight, false)
-      : null;
-    shadowMapParams.shadowMapFramebuffer = device.pool.createTemporalFramebuffer(false, colorAttachments, depthAttachment);
-    if (colorAttachments) {
-      device.pool.releaseTexture(colorAttachments[0]);
-    }
-    if (depthAttachment) {
-      device.pool.releaseTexture(depthAttachment);
-    }
-    */ shadowMapParams.shadowMapFramebuffer = ShadowMapper.fetchTemporalFramebuffer(true, this._light.lightType, numCascades, shadowMapWidth, shadowMapHeight, colorFormat, depthFormat);
+        const shadowMapWidth = this._config.shadowMapSize;
+        const shadowMapHeight = this._config.shadowMapSize;
+        shadowMapParams.shadowMapFramebuffer = ShadowMapper.fetchTemporalFramebuffer(true, shadowMapParams.lightType, numCascades, shadowMapWidth, shadowMapHeight, colorFormat, depthFormat);
         shadowMapParams.impl = this._impl;
         this._impl.updateResources(shadowMapParams);
     }
+    /**
+   * Default shadow camera near plane for a light, in world units.
+   *
+   * @internal
+   */ static getDefaultNearClip(light) {
+        return light.isPointLight() || light.isRectLight() ? 0.1 : 1;
+    }
+    /**
+   * The projection a light's shadow map is rendered with, which is not always the light's own type.
+   *
+   * @internal
+   */ static getShadowProjectionType(light) {
+        return light.isRectLight() ? LIGHT_TYPE_POINT : light.lightType;
+    }
     /** @internal */ createLightCameraPoint(lightCamera) {
         //lightCamera.reparent(this._light);
         lightCamera.parent = lightCamera.scene.rootNode;
@@ -630,16 +632,6 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
         const fov = spot.scene?.lightingMode === 'physical' ? 2 * spot.outerConeAngle : 2 * Math.acos(spot.cutoff);
         lightCamera.setPerspective(fov, 1, this._config.nearClip, Math.min(this._shadowDistance, spot.positionAndRange.w));
     }
-    /** @internal */ createLightCameraRect(lightCamera) {
-        const rect = this._light;
-        this._light.worldMatrix.decompose(null, lightCamera.rotation, lightCamera.position);
-        lightCamera.parent = this._light.scene?.rootNode ?? null;
-        lightCamera.scale.setXYZ(1, 1, 1);
-        const halfW = rect.width * 0.5;
-        const halfH = rect.height * 0.5;
-        const far = Math.min(this._shadowDistance, rect.range);
-        lightCamera.setOrtho(-halfW, halfW, -halfH, halfH, this._config.nearClip, Math.max(this._config.nearClip + 0.001, far));
-    }
     /** @internal */ createLightCameraDirectional(sceneAABB, sceneCamera, lightCamera, cropMatrix, border) {
         let frustum = sceneCamera.frustumViewSpace;
         if (this._shadowDistance < sceneCamera.getFarPlane()) {
@@ -667,11 +659,35 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
         });
         let radius = Vector3.distance(frustumMin, frustumMax) * 0.5 * paddingScale;
         const center = sceneCamera.thisToWorld(Vector3.add(frustumMin, frustumMax, frustumCenter).scaleBy(0.5), frustumCenter);
-        // Clamp to the scene bounds first, then apply the filter border.
-        const sceneRadius = sceneAABB.diagonalLength * 0.5 * paddingScale;
-        if (sceneRadius < radius) {
-            radius = sceneRadius;
-            Vector3.add(sceneAABB.minPoint, sceneAABB.maxPoint, center).scaleBy(0.5);
+        // Clamp to the scene bounds, but only to the part of them that is within
+        // the shadow distance of the camera. Clipping first is what makes the two
+        // settings compose. The clamp replaces the centre as well as the radius, so
+        // without the clip a region is taken whole or not at all: one caster
+        // wandering off drags the region - and with it the shadow map - after it,
+        // however short the shadow distance is, until the region finally outgrows
+        // the frustum and the clamp stops applying altogether. Clipped, a caster
+        // beyond the shadow distance simply stops counting, which is what the
+        // shadow distance means.
+        //
+        // The clip volume is a box about the camera's position, not about the
+        // frustum, so the clipped extents - and the radius taken from them - do not
+        // depend on where the camera is looking. That is deliberate: a radius that
+        // changed with the view direction would make the shadow edges crawl as the
+        // camera turned.
+        const clipDistance = Math.min(this._shadowDistance, sceneCamera.getFarPlane());
+        const cameraPos = sceneCamera.getWorldPosition(ShadowMapper._cameraPos);
+        const clipMin = ShadowMapper._clipMin;
+        const clipMax = ShadowMapper._clipMax;
+        clipMin.setXYZ(Math.max(sceneAABB.minPoint.x, cameraPos.x - clipDistance), Math.max(sceneAABB.minPoint.y, cameraPos.y - clipDistance), Math.max(sceneAABB.minPoint.z, cameraPos.z - clipDistance));
+        clipMax.setXYZ(Math.min(sceneAABB.maxPoint.x, cameraPos.x + clipDistance), Math.min(sceneAABB.maxPoint.y, cameraPos.y + clipDistance), Math.min(sceneAABB.maxPoint.z, cameraPos.z + clipDistance));
+        // An empty intersection means nothing within the shadow distance casts a
+        // shadow. There is no tighter volume to move to, so the frustum stands.
+        if (clipMax.x >= clipMin.x && clipMax.y >= clipMin.y && clipMax.z >= clipMin.z) {
+            const sceneRadius = Vector3.distance(clipMin, clipMax) * 0.5 * paddingScale;
+            if (sceneRadius < radius) {
+                radius = sceneRadius;
+                Vector3.add(clipMin, clipMax, center).scaleBy(0.5);
+            }
         }
         target.setXYZ(center.x + this._light.directionAndCutoff.x, center.y + this._light.directionAndCutoff.y, center.z + this._light.directionAndCutoff.z);
         up.setXYZ(0, 1, 0);
@@ -760,6 +776,8 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
             // Pooled objects retain last frame's ordinal; clear it so it is only set
             // again by ShadowMaskRenderer for lights actually written to the mask.
             params.maskOrdinal = undefined;
+            params.cubeFace = undefined;
+            params.depthRange = undefined;
             return params;
         } else {
             return {
@@ -810,6 +828,20 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
         camera.remove();
         cameras.push(camera);
     }
+    /**
+   * View distances bounding the cascades a directional light's shadow map will be rendered with
+   * for a camera, the same ones render() computes: cascade i covers [result[i], result[i + 1]].
+   * A shadow map without cascades has one, up to the shadow distance.
+   * @internal
+   */ getCascadeDistances(camera) {
+        const numCascades = this._light.isDirectionLight() && this._impl.supportsCascades() ? this._config.numCascades ?? 1 : 1;
+        const near = camera.getNearPlane();
+        const far = Math.min(this._shadowDistance, camera.getFarPlane());
+        return numCascades > 1 ? this.calcSplitDistances(near, far, numCascades).slice(0, numCascades + 1) : [
+            near,
+            far
+        ];
+    }
     /** @internal */ calcSplitDistances(nearPlane, farPlane, numCascades) {
         const result = [
             0,
@@ -848,8 +880,15 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
         }
         const shadowMapParams = ShadowMapper.fetchShadowMapParams();
         shadowMapParams.impl = this._impl;
-        shadowMapParams.lightType = this.light.lightType;
+        shadowMapParams.lightType = ShadowMapper.getShadowProjectionType(this.light);
+        if (this._impl instanceof PCSS) {
+            // A rect light's penumbra follows its size: the radius of the disc of
+            // equal area, in world units. Refreshed every frame so resizing the
+            // light is picked up without touching the shadow settings.
+            this._impl.physicalLightRadius = this._light.isRectLight() ? Math.sqrt(this._light.width * this._light.height / Math.PI) : 0;
+        }
         shadowMapParams.numShadowCascades = shadowMapParams.lightType === LIGHT_TYPE_DIRECTIONAL && this._impl.supportsCascades() ? this._config.numCascades ?? 1 : 1;
+        shadowMapParams.cascadeIndex = 0;
         ctx.shadowMapInfo.set(this.light, shadowMapParams);
         const scene = ctx.scene;
         const camera = ctx.camera;
@@ -889,13 +928,14 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
         };
         const directionalShadowRegion = this._shadowRegion.region;
         const shadowRegion = this._light.isDirectionLight() && directionalShadowRegion?.isValid() ? directionalShadowRegion : scene.boundingBox;
-        if (this._light.isPointLight()) {
+        if (shadowMapParams.lightType === LIGHT_TYPE_POINT) {
             const shadowMapRenderCamera = ShadowMapper.fetchCameraForScene(scene);
             this.createLightCameraPoint(shadowMapRenderCamera);
             this.calcDepthBiasParams(shadowMapRenderCamera, this._config.shadowMapSize, this._config.depthBias, this._config.normalBias, depthScale, shadowMapParams.depthBiasValues[0]);
             shadowMapParams.cameraParams.setXYZW(shadowMapRenderCamera.getNearPlane(), shadowMapRenderCamera.getFarPlane(), this._config.shadowMapSize, this._shadowDistance);
             device.setFramebuffer(fb);
             shadowMapParams.shadowMatrices.set(Matrix4x4.transpose(shadowMapRenderCamera.viewMatrix));
+            shadowMapParams.depthRange = this._light.positionAndRange.w;
             for (const face of [
                 CubeFace.PX,
                 CubeFace.NX,
@@ -907,6 +947,7 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
                 shadowMapRenderCamera.lookAtCubeFace(face);
                 fb.setColorAttachmentCubeFace(0, face);
                 fb.setDepthAttachmentCubeFace(face);
+                shadowMapParams.cubeFace = face;
                 renderGeometry(shadowMapRenderCamera);
             }
             shadowMapParams.shadowMatrices.set(Matrix4x4.identity());
@@ -967,6 +1008,7 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
                     }
                     device.setFramebuffer(fb);
                     device.setScissor(scissor);
+                    shadowMapParams.cascadeIndex = split;
                     renderGeometry(shadowMapRenderCamera, shadowMapCullCamera);
                     shadowMapParams.shadowMatrices.set(Matrix4x4.transpose(shadowMapRenderCamera.viewProjectionMatrix), split * 16);
                     shadowMapParams.cascadeDistances[split] = distances[split + 1];
@@ -981,8 +1023,6 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
                 shadowMapRenderCamera.clipMask = AABB.ClipLeft | AABB.ClipRight | AABB.ClipBottom | AABB.ClipTop;
                 if (this._light.isDirectionLight()) {
                     this.createLightCameraDirectional(shadowRegion, camera, shadowMapRenderCamera, snapMatrix, shadowMapParams.impl.getShadowMapBorder(shadowMapParams));
-                } else if (this._light.isRectLight()) {
-                    this.createLightCameraRect(shadowMapRenderCamera);
                 } else {
                     this.createLightCameraSpot(shadowMapRenderCamera);
                 }
@@ -1006,7 +1046,7 @@ const tmpFrustum = new Frustum(Matrix4x4.identity());
             // The strand geometry this mode exists to shadow is WebGPU only, so the
             // WebGL paths were never built. Falling back keeps a scene authored with it
             // renderable rather than failing to produce a shadow map at all.
-            console.warn(`ShadowMapper.setShadowMode(): 'dom' requires WebGPU, falling back to 'pcf'`);
+            warnUnsupported("Deep opacity map shadows (shadow mode 'dom')", 'WebGPU', "falling back to 'pcf'");
             this.applyMode('pcf');
             return;
         }