@zephyr3d/scene 0.9.26 → 0.10.0

package/dist/scene/hair.js.map

@@ -1 +1 @@
-{"version":3,"file":"hair.js","sources":["../../src/scene/hair.ts"],"sourcesContent":["/**\r\n * A groom in the scene graph.\r\n *\r\n * @remarks\r\n * Strand hair is drawn from control points held in storage buffers and expanded\r\n * into camera-facing ribbons in the vertex shader, which needs a handful of\r\n * pieces wired together that nothing else in the engine needs: a primitive that\r\n * carries no attributes but still establishes a vertex layout, a draw range\r\n * derived from the material rather than from an index buffer, and a bounding box\r\n * computed on the CPU because the geometry does not exist until the vertex stage\r\n * has run. This node owns that assembly so a groom can be placed, transformed,\r\n * serialised and simulated like anything else.\r\n *\r\n * The material is deliberately not exposed. Strand geometry only exists inside\r\n * {@link HairStrandMaterial} - it reads control points from storage buffers that\r\n * no other material knows about - so letting one be swapped in would produce a\r\n * node that cannot draw. The shading controls are surfaced as properties of the\r\n * node instead, and they are what gets serialised.\r\n *\r\n * The geometry itself lives in a `.zhair` asset, referenced by path. That file\r\n * holds nothing but strands: the node's own settings, shading included, belong\r\n * to the scene rather than to the asset, so one groom can be shared by several\r\n * characters that each style it differently.\r\n *\r\n * WebGPU only, because the expansion reads storage buffers from the vertex\r\n * stage. On other backends the node exists and keeps its data but draws nothing.\r\n */\r\nimport type { Immutable, Nullable, Vector4 } from '@zephyr3d/base';\r\nimport { applyMixins, DRef, Vector3 } from '@zephyr3d/base';\r\nimport type { Scene } from './scene';\r\nimport { GraphNode } from './graph_node';\r\nimport { mixinDrawable } from '../render/drawable_mixin';\r\nimport type { Drawable, DrawContext, PickTarget, RenderQueue } from '../render';\r\nimport { Primitive } from '../render';\r\nimport { HairStrandMaterial } from '../material/hairstrand';\r\nimport type { HairShadingModel } from '../material/hair';\r\nimport { HairStrandData, type HairStrandSource } from '../material/hairstrand_data';\r\nimport {\r\n  GPUHairSimulation,\r\n  isHairSimulationSupported,\r\n  type GPUHairSimulationOptions\r\n} from '../animation/hair/gpu_hair_simulation';\r\nimport type { ParsedZHair } from '../asset/loaders/zhair/zhair_format';\r\nimport { parseZHair } from '../asset/loaders/zhair/zhair_format';\r\nimport { loadZHairStrandSources, mergeHairStrandSources } from '../asset/loaders/zhair/zhair_loader';\r\nimport { BoundingBox } from '../utility/bounding_volume';\r\nimport { QUEUE_OPAQUE } from '../values';\r\nimport { getEngine } from '../app/api';\r\nimport type { BlendMode } from '../material/meshmaterial';\r\n\r\n/**\r\n * Hair scene node.\r\n *\r\n * @remarks\r\n * Point it at a `.zhair` asset with {@link HairNode.setHairAsset}, or hand it\r\n * control points directly with {@link HairNode.setStrands}. Everything the draw\r\n * call needs is derived from them.\r\n *\r\n * @public\r\n */\r\nexport class HairNode extends applyMixins(GraphNode, mixinDrawable) implements Drawable {\r\n  /** @internal */\r\n  private readonly _pickTarget: PickTarget;\r\n  /** @internal */\r\n  private readonly _material: DRef<HairStrandMaterial>;\r\n  /** @internal */\r\n  private readonly _primitive: DRef<Primitive>;\r\n  /** @internal */\r\n  private readonly _strands: DRef<HairStrandData>;\r\n  /** @internal Local-space bounds of the control points, width included. */\r\n  private _bounds: Nullable<BoundingBox>;\r\n  /** @internal Length of the longest strand, for padding the bounds while simulating. */\r\n  private _maxStrandLength: number;\r\n  /** @internal */\r\n  private _castShadow: boolean;\r\n  /** @internal Kept so the simulation can be rebuilt from the authored pose. */\r\n  private _source: Nullable<HairStrandSource>;\r\n  /** @internal Path of the `.zhair` asset, empty when strands were set directly. */\r\n  private _hairAsset: string;\r\n  /**\r\n   * @internal The opened asset, kept so decimation can be changed without\r\n   * reading the file again.\r\n   */\r\n  private _parsedAsset: Nullable<ParsedZHair>;\r\n  /** @internal */\r\n  private _strandStride: number;\r\n  /** @internal */\r\n  private _maxStrands: number;\r\n  /** @internal */\r\n  private _simulation: Nullable<GPUHairSimulation>;\r\n  /** @internal */\r\n  private _simulationEnabled: boolean;\r\n  /**\r\n   * @internal Simulation tuning, owned by the node.\r\n   *\r\n   * Held here rather than on the simulation because the node outlives it: the\r\n   * dials survive the simulation being switched off and on, and can be set\r\n   * before any strands have loaded.\r\n   */\r\n  private readonly _simulationOptions: GPUHairSimulationOptions;\r\n  /**\r\n   * Creates an empty hair node.\r\n   *\r\n   * @param scene - Scene the node belongs to.\r\n   */\r\n  constructor(scene: Scene) {\r\n    super(scene);\r\n    this._pickTarget = { node: this };\r\n    this._material = new DRef(new HairStrandMaterial());\r\n    this._primitive = new DRef();\r\n    this._strands = new DRef();\r\n    this._bounds = null;\r\n    this._maxStrandLength = 0;\r\n    this._castShadow = true;\r\n    this._source = null;\r\n    this._hairAsset = '';\r\n    this._parsedAsset = null;\r\n    this._strandStride = 1;\r\n    this._maxStrands = 0;\r\n    this._simulation = null;\r\n    this._simulationEnabled = false;\r\n    this._simulationOptions = {\r\n      gravity: new Vector3(0, -9.8, 0),\r\n      damping: 0.08,\r\n      globalStiffness: 0,\r\n      globalRange: 0,\r\n      localStiffness: 0.9,\r\n      localIterations: 2,\r\n      ftlDamping: 0.7,\r\n      vspCoeff: 0.8,\r\n      vspAccelThreshold: 50,\r\n      substeps: 1,\r\n      friction: 0.2,\r\n      maxSpeedFactor: 4\r\n    };\r\n  }\r\n\r\n  //\r\n  // Geometry\r\n  //\r\n\r\n  /** Path of the `.zhair` asset this node draws, or an empty string. */\r\n  get hairAsset() {\r\n    return this._hairAsset;\r\n  }\r\n  /**\r\n   * Loads a `.zhair` asset.\r\n   *\r\n   * @remarks\r\n   * The opened file is kept, so changing {@link HairNode.strandStride} or\r\n   * {@link HairNode.maxStrands} afterwards re-decimates what is already in\r\n   * memory instead of reading it again - and never touches the source archive\r\n   * the asset was converted from.\r\n   *\r\n   * @param path - Asset path, or an empty string to clear the node.\r\n   */\r\n  async setHairAsset(path: string) {\r\n    const assetId = path?.trim() ?? '';\r\n    if (assetId === this._hairAsset) {\r\n      return;\r\n    }\r\n    this._hairAsset = assetId;\r\n    this._parsedAsset = null;\r\n    if (!assetId) {\r\n      this.setStrands(null);\r\n      return;\r\n    }\r\n    let parsed: ParsedZHair;\r\n    try {\r\n      const data = (await getEngine().resourceManager.assetManager.fetchBinaryData(assetId)) as ArrayBuffer;\r\n      parsed = parseZHair(data);\r\n    } catch (err) {\r\n      console.error(`Load hair asset failed: ${assetId}: ${err}`);\r\n      this.setStrands(null);\r\n      return;\r\n    }\r\n    // A load that was superseded while it was in flight must not overwrite the\r\n    // asset that replaced it.\r\n    if (this._hairAsset !== assetId) {\r\n      return;\r\n    }\r\n    this._parsedAsset = parsed;\r\n    this._applyAssetDecimation();\r\n  }\r\n  /**\r\n   * Draw one strand in every `strandStride`.\r\n   *\r\n   * @remarks\r\n   * A stride rather than a leading slice, so the kept strands stay spread over\r\n   * the whole scalp instead of leaving a bald patch. Only meaningful when the\r\n   * strands came from an asset; strands set directly are used as given.\r\n   */\r\n  get strandStride() {\r\n    return this._strandStride;\r\n  }\r\n  set strandStride(val: number) {\r\n    const v = val < 1 ? 1 : val | 0;\r\n    if (v !== this._strandStride) {\r\n      this._strandStride = v;\r\n      this._applyAssetDecimation();\r\n    }\r\n  }\r\n  /**\r\n   * Upper bound on the number of strands drawn, or 0 for no bound.\r\n   *\r\n   * @remarks\r\n   * Applied on top of {@link HairNode.strandStride} by widening the stride\r\n   * further, so the result stays evenly spread.\r\n   */\r\n  get maxStrands() {\r\n    return this._maxStrands;\r\n  }\r\n  set maxStrands(val: number) {\r\n    const v = val < 0 ? 0 : val | 0;\r\n    if (v !== this._maxStrands) {\r\n      this._maxStrands = v;\r\n      this._applyAssetDecimation();\r\n    }\r\n  }\r\n  /** GPU-resident strand geometry, or null when none has been assigned. */\r\n  get strands(): Nullable<HairStrandData> {\r\n    return this._strands.get();\r\n  }\r\n  /** Number of strands currently drawn. */\r\n  get strandCount() {\r\n    return this._strands.get()?.strandCount ?? 0;\r\n  }\r\n  /**\r\n   * Replaces the strands this node draws.\r\n   *\r\n   * @remarks\r\n   * The direct route, for strands built in code rather than loaded from an\r\n   * asset. Uploads the control points, sizes the draw call and recomputes the\r\n   * bounding box; the previous strand data is released and any running\r\n   * simulation is rebuilt, since its rest pose comes from the strands.\r\n   *\r\n   * @param source - Control points and topology, or null to clear the node.\r\n   */\r\n  setStrands(source: Nullable<HairStrandSource>) {\r\n    this._disposeSimulation();\r\n    this._strands.dispose();\r\n    this._bounds = null;\r\n    this._maxStrandLength = 0;\r\n    this._source = null;\r\n    if (!source) {\r\n      this.material.strands = null;\r\n      this._primitive.dispose();\r\n      this.invalidateBoundingVolume();\r\n      return;\r\n    }\r\n    const data = new HairStrandData(source);\r\n    this._strands.set(data);\r\n    this._source = source;\r\n    this.material.strands = data;\r\n    const extents = computeStrandExtents(source);\r\n    this._bounds = extents.bounds;\r\n    this._maxStrandLength = extents.maxStrandLength;\r\n    this._ensurePrimitive();\r\n    this._syncDrawRange();\r\n    this.invalidateBoundingVolume();\r\n    if (this._simulationEnabled) {\r\n      this._createSimulation();\r\n    }\r\n  }\r\n\r\n  //\r\n  // Shading\r\n  //\r\n  // The material is an implementation detail of this node - see the class\r\n  // remarks - so its controls are surfaced here. Only the ones that do something\r\n  // on the strand path are: the vertex shader emits no texture coordinates, so\r\n  // the material's albedo, shift and occlusion maps have nothing to sample and\r\n  // are deliberately left unreachable.\r\n  //\r\n\r\n  /** Base colour of the strands. */\r\n  get albedoColor(): Immutable<Vector4> {\r\n    return this.material.albedoColor;\r\n  }\r\n  set albedoColor(value: Vector4) {\r\n    this.material.albedoColor = value;\r\n  }\r\n  /**\r\n   * Which scattering model shades the hair.\r\n   *\r\n   * @remarks\r\n   * `kajiya-kay` is the art-directed double lobe; `marschner` derives the lobes\r\n   * from the fibre and is the one that renders back-lighting.\r\n   */\r\n  get shadingModel(): HairShadingModel {\r\n    return this.material.shadingModel;\r\n  }\r\n  set shadingModel(value: HairShadingModel) {\r\n    this.material.shadingModel = value;\r\n  }\r\n  /** Colour of the primary, near-white specular lobe. */\r\n  get specular1Color(): Immutable<Vector3> {\r\n    return this.material.specular1Color;\r\n  }\r\n  set specular1Color(value: Vector3) {\r\n    this.material.specular1Color = value;\r\n  }\r\n  /** Exponent of the primary specular lobe. */\r\n  get specular1Power() {\r\n    return this.material.specular1Power;\r\n  }\r\n  set specular1Power(value: number) {\r\n    this.material.specular1Power = value;\r\n  }\r\n  /** Shift of the primary specular lobe along the strand. */\r\n  get specular1Shift() {\r\n    return this.material.specular1Shift;\r\n  }\r\n  set specular1Shift(value: number) {\r\n    this.material.specular1Shift = value;\r\n  }\r\n  /** Colour of the secondary, tinted specular lobe. */\r\n  get specular2Color(): Immutable<Vector3> {\r\n    return this.material.specular2Color;\r\n  }\r\n  set specular2Color(value: Vector3) {\r\n    this.material.specular2Color = value;\r\n  }\r\n  /** Exponent of the secondary specular lobe. */\r\n  get specular2Power() {\r\n    return this.material.specular2Power;\r\n  }\r\n  set specular2Power(value: number) {\r\n    this.material.specular2Power = value;\r\n  }\r\n  /** Shift of the secondary specular lobe along the strand. */\r\n  get specular2Shift() {\r\n    return this.material.specular2Shift;\r\n  }\r\n  set specular2Shift(value: number) {\r\n    this.material.specular2Shift = value;\r\n  }\r\n  /** How far diffuse lighting wraps around the fibre. */\r\n  get diffuseWrap() {\r\n    return this.material.diffuseWrap;\r\n  }\r\n  set diffuseWrap(value: number) {\r\n    this.material.diffuseWrap = value;\r\n  }\r\n  /** Colour of light transmitted through the fibre. */\r\n  get transmissionColor(): Immutable<Vector3> {\r\n    return this.material.transmissionColor;\r\n  }\r\n  set transmissionColor(value: Vector3) {\r\n    this.material.transmissionColor = value;\r\n  }\r\n  /** Strength of back-lit transmission. */\r\n  get transmissionIntensity() {\r\n    return this.material.transmissionIntensity;\r\n  }\r\n  set transmissionIntensity(value: number) {\r\n    this.material.transmissionIntensity = value;\r\n  }\r\n  /** Falloff exponent of back-lit transmission. */\r\n  get transmissionPower() {\r\n    return this.material.transmissionPower;\r\n  }\r\n  set transmissionPower(value: number) {\r\n    this.material.transmissionPower = value;\r\n  }\r\n  /** Colour of multiple scattering within the groom. */\r\n  get scatterColor(): Immutable<Vector3> {\r\n    return this.material.scatterColor;\r\n  }\r\n  set scatterColor(value: Vector3) {\r\n    this.material.scatterColor = value;\r\n  }\r\n  /** Strength of multiple scattering. */\r\n  get scatterIntensity() {\r\n    return this.material.scatterIntensity;\r\n  }\r\n  set scatterIntensity(value: number) {\r\n    this.material.scatterIntensity = value;\r\n  }\r\n  /** Share of scattering taken as local rather than global. */\r\n  get scatterLocal() {\r\n    return this.material.scatterLocal;\r\n  }\r\n  set scatterLocal(value: number) {\r\n    this.material.scatterLocal = value;\r\n  }\r\n  /** How far scattered light wraps around the fibre. */\r\n  get scatterWrap() {\r\n    return this.material.scatterWrap;\r\n  }\r\n  set scatterWrap(value: number) {\r\n    this.material.scatterWrap = value;\r\n  }\r\n  /** Longitudinal shift of the Marschner lobes. */\r\n  get marschnerShift() {\r\n    return this.material.marschnerShift;\r\n  }\r\n  set marschnerShift(value: number) {\r\n    this.material.marschnerShift = value;\r\n  }\r\n  /** Longitudinal roughness of the Marschner lobes. */\r\n  get marschnerRoughness() {\r\n    return this.material.marschnerRoughness;\r\n  }\r\n  set marschnerRoughness(value: number) {\r\n    this.material.marschnerRoughness = value;\r\n  }\r\n  /** Index of refraction of the fibre. */\r\n  get marschnerIOR() {\r\n    return this.material.marschnerIOR;\r\n  }\r\n  set marschnerIOR(value: number) {\r\n    this.material.marschnerIOR = value;\r\n  }\r\n  /**\r\n   * How strongly pigmented the fibre is.\r\n   *\r\n   * @remarks\r\n   * A multiplier on the distance transmitted light travels before leaving, so\r\n   * raising it deepens the colour of the TT and TRT paths without touching the\r\n   * white surface reflection.\r\n   */\r\n  get marschnerAbsorption() {\r\n    return this.material.marschnerAbsorption;\r\n  }\r\n  set marschnerAbsorption(value: number) {\r\n    this.material.marschnerAbsorption = value;\r\n  }\r\n  /** Relative weight of the R, TT and TRT lobes. */\r\n  get marschnerLobes(): Immutable<Vector3> {\r\n    return this.material.marschnerLobes;\r\n  }\r\n  set marschnerLobes(value: Immutable<Vector3>) {\r\n    this.material.marschnerLobes = value;\r\n  }\r\n\r\n  //\r\n  // Strand expansion\r\n  //\r\n\r\n  /**\r\n   * Ribbon segments generated per strand.\r\n   *\r\n   * @remarks\r\n   * The main quality dial, and independent of how many control points a strand\r\n   * has: the shader resamples the curve, so the same 30-point strand can be\r\n   * drawn with 12 segments close up and 3 far away.\r\n   */\r\n  get segmentsPerStrand() {\r\n    return this.material.segmentsPerStrand;\r\n  }\r\n  set segmentsPerStrand(val: number) {\r\n    if (val !== this.material.segmentsPerStrand) {\r\n      this.material.segmentsPerStrand = val;\r\n      this._syncDrawRange();\r\n    }\r\n  }\r\n  /** Multiplier on the width stored in the strand data. */\r\n  get strandWidthScale() {\r\n    return this.material.strandWidthScale;\r\n  }\r\n  set strandWidthScale(value: number) {\r\n    this.material.strandWidthScale = value;\r\n  }\r\n  /** Lower bound on ribbon width, in world units. */\r\n  get minStrandWidth() {\r\n    return this.material.minStrandWidth;\r\n  }\r\n  set minStrandWidth(value: number) {\r\n    this.material.minStrandWidth = value;\r\n  }\r\n  /**\r\n   * Lower bound on ribbon width, in pixels.\r\n   *\r\n   * @remarks\r\n   * Real hair is thinner than a pixel and rasterises to a flickering dotted\r\n   * line. Widening it to about a pixel and paying the extra coverage back in\r\n   * alpha keeps distant hair fading rather than breaking up.\r\n   */\r\n  get minPixelWidth() {\r\n    return this.material.minPixelWidth;\r\n  }\r\n  set minPixelWidth(value: number) {\r\n    this.material.minPixelWidth = value;\r\n  }\r\n  /**\r\n   * How far the shading normal bends across the ribbon, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * At 0 a strand shades as a flat tape, at 1 as a cylinder.\r\n   */\r\n  get strandRoundness() {\r\n    return this.material.strandRoundness;\r\n  }\r\n  set strandRoundness(value: number) {\r\n    this.material.strandRoundness = value;\r\n  }\r\n  /**\r\n   * Strength of the root-depth ambient occlusion, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * Environment irradiance is not attenuated by anything - a shadow map answers\r\n   * for one light, not for the sky - so without this every strand of a groom\r\n   * receives the full sky and a dense hairstyle is lit as brightly in its\r\n   * interior as on its surface, which reads as a flat silhouette with no volume.\r\n   * Most obvious on pale hair, where there is little pigment to darken the\r\n   * interior instead. Set to 0 to disable.\r\n   *\r\n   * Ambient light only: direct light is already attenuated by the shadow map,\r\n   * and under DOM by a graded transmittance, so it is left alone.\r\n   */\r\n  get rootOcclusion() {\r\n    return this.material.rootOcclusion;\r\n  }\r\n  set rootOcclusion(value: number) {\r\n    this.material.rootOcclusion = value;\r\n  }\r\n  /**\r\n   * How far along a strand the root occlusion reaches, in (0, 1].\r\n   *\r\n   * @remarks\r\n   * Short for a groom whose strands leave the scalp quickly, longer for one\r\n   * where they lie against each other most of their length.\r\n   */\r\n  get rootOcclusionRange() {\r\n    return this.material.rootOcclusionRange;\r\n  }\r\n  set rootOcclusionRange(value: number) {\r\n    this.material.rootOcclusionRange = value;\r\n  }\r\n  /** Drop strands with distance, redistributing their coverage to the survivors. */\r\n  get strandLOD() {\r\n    return this.material.strandLOD;\r\n  }\r\n  set strandLOD(value: boolean) {\r\n    this.material.strandLOD = value;\r\n  }\r\n  /** Floor on the fraction of strands distance decimation keeps. */\r\n  get minStrandLODRatio() {\r\n    return this.material.minStrandLODRatio;\r\n  }\r\n  set minStrandLODRatio(value: number) {\r\n    this.material.minStrandLODRatio = value;\r\n  }\r\n\r\n  //\r\n  // Transparency and shadows\r\n  //\r\n\r\n  /**\r\n   * How the strands blend with what is behind them.\r\n   *\r\n   * @remarks\r\n   * The pixel-width floor pays its widening back in alpha, which only means\r\n   * anything once blending is on; left at `none` every strand covers its pixel\r\n   * fully and a dense groom reads as a solid shell.\r\n   */\r\n  get blendMode(): BlendMode {\r\n    return this.material.blendMode;\r\n  }\r\n  set blendMode(value: BlendMode) {\r\n    this.material.blendMode = value;\r\n  }\r\n  /** Alpha below which a fragment is discarded. */\r\n  get alphaCutoff() {\r\n    return this.material.alphaCutoff;\r\n  }\r\n  set alphaCutoff(value: number) {\r\n    this.material.alphaCutoff = value;\r\n  }\r\n  /** Dither the alpha test, so a temporal filter resolves the soft edge. */\r\n  get alphaDither() {\r\n    return this.material.alphaDither;\r\n  }\r\n  set alphaDither(value: boolean) {\r\n    this.material.alphaDither = value;\r\n  }\r\n  /**\r\n   * Whether a blended groom contributes motion vectors.\r\n   *\r\n   * @remarks\r\n   * Only meaningful with {@link HairNode.blendMode} set to something other than\r\n   * `none`. Blended geometry is otherwise absent from the prepass, so a groom\r\n   * carries the velocity of whatever is behind it and a temporal filter smears\r\n   * it as it swings - the same ghosting the dithered path avoids by being\r\n   * opaque. On by default, because a groom is dense enough to own its pixels\r\n   * and there is no reason to want the ghosting.\r\n   */\r\n  get transparentMotionVector() {\r\n    return this.material.transparentMotionVector;\r\n  }\r\n  set transparentMotionVector(value: boolean) {\r\n    this.material.transparentMotionVector = value;\r\n  }\r\n  /** Whether the groom is drawn into shadow maps. */\r\n  get castShadow() {\r\n    return this._castShadow;\r\n  }\r\n  set castShadow(val: boolean) {\r\n    this._castShadow = !!val;\r\n  }\r\n  /** Let the shadow caster pass respect strand alpha, for softer self-shadowing. */\r\n  get transparentShadowCaster() {\r\n    return this.material.transparentShadowCaster;\r\n  }\r\n  set transparentShadowCaster(value: boolean) {\r\n    this.material.transparentShadowCaster = value;\r\n  }\r\n  /** Alpha below which a fragment casts no shadow. */\r\n  get shadowAlphaCutoff() {\r\n    return this.material.shadowAlphaCutoff;\r\n  }\r\n  set shadowAlphaCutoff(value: number) {\r\n    this.material.shadowAlphaCutoff = value;\r\n  }\r\n\r\n  //\r\n  // Simulation\r\n  //\r\n\r\n  /**\r\n   * Whether strand dynamics run on this groom.\r\n   *\r\n   * @remarks\r\n   * WebGPU only. Switching it on with no strands loaded is allowed - the\r\n   * simulation is built when the strands arrive.\r\n   */\r\n  get simulationEnabled() {\r\n    return this._simulationEnabled;\r\n  }\r\n  set simulationEnabled(val: boolean) {\r\n    const enabled = !!val;\r\n    if (enabled === this._simulationEnabled) {\r\n      return;\r\n    }\r\n    this._simulationEnabled = enabled;\r\n    if (enabled) {\r\n      this._createSimulation();\r\n    } else {\r\n      this._disposeSimulation();\r\n      // Without this the groom keeps whatever pose it was last simulated into,\r\n      // which reads as a bug rather than as hair that stopped moving.\r\n      if (this._source) {\r\n        this._strands.get()?.dispose();\r\n        this._strands.set(new HairStrandData(this._source));\r\n        this.material.strands = this._strands.get();\r\n      }\r\n      // Back to the tight rest bounds.\r\n      this.invalidateBoundingVolume();\r\n    }\r\n  }\r\n  /**\r\n   * The running strand dynamics, or null when they are off or unsupported.\r\n   *\r\n   * @remarks\r\n   * Exposed so a caller can reach past the node's own dials - to set colliders,\r\n   * for one, which have no serialised form here.\r\n   */\r\n  get simulation(): Nullable<GPUHairSimulation> {\r\n    return this._simulation;\r\n  }\r\n  /** World-space gravity acting on the strands. */\r\n  get gravity(): Immutable<Vector3> {\r\n    return this._simulationOptions.gravity!;\r\n  }\r\n  set gravity(value: Vector3) {\r\n    this._simulationOptions.gravity = new Vector3(value);\r\n    if (this._simulation) {\r\n      this._simulation.gravity = this._simulationOptions.gravity;\r\n    }\r\n  }\r\n  /**\r\n   * How strongly strands keep the shape they were authored with, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * The dial to reach for first. It holds the angle each segment makes with the\r\n   * one before it, measured against that segment's current direction rather\r\n   * than a fixed pose, so a groom keeps its curl while remaining free to hang\r\n   * and swing. It is also what damps a groom: without bending resistance a\r\n   * strand carries a disturbance up and down its length for seconds.\r\n   */\r\n  get localStiffness() {\r\n    return this._simulationOptions.localStiffness!;\r\n  }\r\n  set localStiffness(value: number) {\r\n    this._simulationOptions.localStiffness = value;\r\n    if (this._simulation) {\r\n      this._simulation.localStiffness = value;\r\n    }\r\n  }\r\n  /** Local shape constraint passes per substep. */\r\n  get localIterations() {\r\n    return this._simulationOptions.localIterations!;\r\n  }\r\n  set localIterations(value: number) {\r\n    this._simulationOptions.localIterations = value;\r\n    if (this._simulation) {\r\n      this._simulation.localIterations = value;\r\n    }\r\n  }\r\n  /**\r\n   * How strongly strands are pulled back to their authored pose, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * Off by default. It anchors a point to a fixed place rather than to its\r\n   * neighbours, which is a spring, and a groom held by springs reads as one.\r\n   * {@link HairNode.localStiffness} is what holds styling without that; this is\r\n   * for grooms that genuinely should not move far from how they were authored,\r\n   * and wants {@link HairNode.globalRange} set as well.\r\n   */\r\n  get globalStiffness() {\r\n    return this._simulationOptions.globalStiffness!;\r\n  }\r\n  set globalStiffness(value: number) {\r\n    this._simulationOptions.globalStiffness = value;\r\n    if (this._simulation) {\r\n      this._simulation.globalStiffness = value;\r\n    }\r\n  }\r\n  /** Fraction of a strand, from the root, the pose pull acts on, in [0, 1]. */\r\n  get globalRange() {\r\n    return this._simulationOptions.globalRange!;\r\n  }\r\n  set globalRange(value: number) {\r\n    this._simulationOptions.globalRange = value;\r\n    if (this._simulation) {\r\n      this._simulation.globalRange = value;\r\n    }\r\n  }\r\n  /**\r\n   * Share of a point's length correction fed back into its parent, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * What keeps the solver from gaining energy as the node moves. Lowering it\r\n   * makes a groom livelier and, past a point, makes it whip; 0 removes the\r\n   * feedback entirely.\r\n   */\r\n  get ftlDamping() {\r\n    return this._simulationOptions.ftlDamping!;\r\n  }\r\n  set ftlDamping(value: number) {\r\n    this._simulationOptions.ftlDamping = value;\r\n    if (this._simulation) {\r\n      this._simulation.ftlDamping = value;\r\n    }\r\n  }\r\n  /** Velocity lost each step, in [0, 1]. */\r\n  get damping() {\r\n    return this._simulationOptions.damping!;\r\n  }\r\n  set damping(value: number) {\r\n    this._simulationOptions.damping = value;\r\n    if (this._simulation) {\r\n      this._simulation.damping = value;\r\n    }\r\n  }\r\n  /** Tangential motion removed at a contact, in [0, 1]. */\r\n  get friction() {\r\n    return this._simulationOptions.friction!;\r\n  }\r\n  set friction(value: number) {\r\n    this._simulationOptions.friction = value;\r\n    if (this._simulation) {\r\n      this._simulation.friction = value;\r\n    }\r\n  }\r\n  /**\r\n   * How much of the node's motion strands are carried along by, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * 0 leaves a groom exactly where it was in the world and lets the pinned\r\n   * roots drag it along, which is what produces lag; 1 carries it rigidly with\r\n   * the node, so it never lags. Lower values give a livelier, floppier groom.\r\n   */\r\n  get vspCoeff() {\r\n    return this._simulationOptions.vspCoeff!;\r\n  }\r\n  set vspCoeff(value: number) {\r\n    this._simulationOptions.vspCoeff = value;\r\n    if (this._simulation) {\r\n      this._simulation.vspCoeff = value;\r\n    }\r\n  }\r\n  /** Node acceleration above which strands are carried rigidly, in units/s². */\r\n  get vspAccelThreshold() {\r\n    return this._simulationOptions.vspAccelThreshold!;\r\n  }\r\n  set vspAccelThreshold(value: number) {\r\n    this._simulationOptions.vspAccelThreshold = value;\r\n    if (this._simulation) {\r\n      this._simulation.vspAccelThreshold = value;\r\n    }\r\n  }\r\n  /**\r\n   * Per-substep ceiling on how far a point may travel, in segment lengths.\r\n   *\r\n   * @remarks\r\n   * A backstop against a single bad substep, not a dial to shape motion with:\r\n   * at the default it never engages during ordinary movement.\r\n   */\r\n  get maxSpeedFactor() {\r\n    return this._simulationOptions.maxSpeedFactor!;\r\n  }\r\n  set maxSpeedFactor(value: number) {\r\n    this._simulationOptions.maxSpeedFactor = value;\r\n    if (this._simulation) {\r\n      this._simulation.maxSpeedFactor = value;\r\n    }\r\n  }\r\n  /** Integration substeps per fixed step. */\r\n  get substeps() {\r\n    return this._simulationOptions.substeps!;\r\n  }\r\n  set substeps(value: number) {\r\n    this._simulationOptions.substeps = value;\r\n    if (this._simulation) {\r\n      this._simulation.substeps = value;\r\n    }\r\n  }\r\n\r\n  //\r\n  // Scene node and drawable\r\n  //\r\n\r\n  /**\r\n   * {@inheritDoc SceneNode.update}\r\n   *\r\n   * @remarks\r\n   * Drives the strand solver. The node re-queues itself every frame, because a\r\n   * simulation only stands still when it is switched off.\r\n   */\r\n  update(frameId: number, elapsedInSeconds: number, deltaInSeconds: number) {\r\n    super.update(frameId, elapsedInSeconds, deltaInSeconds);\r\n    const simulation = this._simulation;\r\n    if (simulation?.enabled) {\r\n      simulation.update(deltaInSeconds, this.worldMatrix);\r\n      this.scene?.queueUpdateNode(this);\r\n    }\r\n  }\r\n  /**\r\n   * {@inheritDoc SceneNode.computeBoundingVolume}\r\n   *\r\n   * @remarks\r\n   * Derived on the CPU from the control points, because the ribbons are built in\r\n   * the vertex shader and the engine never sees them. The box is in local space;\r\n   * the base class applies the world matrix.\r\n   *\r\n   * While a simulation runs, the strands swing out of their authored pose, so\r\n   * the rest bounds are padded by the longest strand: the solver keeps every\r\n   * point within its strand's length of the pinned root, which bounds any pose\r\n   * it can produce.\r\n   */\r\n  computeBoundingVolume(): Nullable<BoundingBox> {\r\n    if (!this._bounds) {\r\n      return null;\r\n    }\r\n    const box = new BoundingBox(this._bounds);\r\n    if (this._simulation) {\r\n      const pad = this._maxStrandLength;\r\n      box.minPoint.setXYZ(box.minPoint.x - pad, box.minPoint.y - pad, box.minPoint.z - pad);\r\n      box.maxPoint.setXYZ(box.maxPoint.x + pad, box.maxPoint.y + pad, box.maxPoint.z + pad);\r\n    }\r\n    return box;\r\n  }\r\n  /** {@inheritDoc SceneNode.isHair} */\r\n  isHair(): this is HairNode {\r\n    return true;\r\n  }\r\n  /** {@inheritDoc Drawable.getPickTarget} */\r\n  getPickTarget() {\r\n    return this._pickTarget;\r\n  }\r\n  /** {@inheritDoc Drawable.getMaterial} */\r\n  getMaterial() {\r\n    return this._material.get();\r\n  }\r\n  /** {@inheritDoc Drawable.getPrimitive} */\r\n  getPrimitive() {\r\n    return this._primitive.get();\r\n  }\r\n  /** {@inheritDoc Drawable.getMorphData} */\r\n  getMorphData() {\r\n    return null;\r\n  }\r\n  /** {@inheritDoc Drawable.getMorphInfo} */\r\n  getMorphInfo() {\r\n    return null;\r\n  }\r\n  /** {@inheritDoc Drawable.getSkinInfluenceData} */\r\n  getSkinInfluenceData() {\r\n    return null;\r\n  }\r\n  /** {@inheritDoc Drawable.getQueueType} */\r\n  getQueueType() {\r\n    return this._material.get()?.getQueueType() ?? QUEUE_OPAQUE;\r\n  }\r\n  /** {@inheritDoc Drawable.isUnlit} */\r\n  isUnlit() {\r\n    return !this._material.get()?.supportLighting();\r\n  }\r\n  /** {@inheritDoc Drawable.needSceneColor} */\r\n  needSceneColor() {\r\n    return this._material.get()?.needSceneColor() ?? false;\r\n  }\r\n  /** {@inheritDoc Drawable.needSceneDepth} */\r\n  needSceneDepth() {\r\n    return this._material.get()?.needSceneDepth() ?? false;\r\n  }\r\n  /** {@inheritDoc Drawable.draw} */\r\n  draw(ctx: DrawContext, renderQueue: Nullable<RenderQueue>) {\r\n    const material = this._material.get();\r\n    const primitive = this._primitive.get();\r\n    // An empty groom is a legitimate state - a node exists before its asset has\r\n    // finished loading - and the draw range is zero until strands arrive.\r\n    if (material && primitive && material.vertexCount > 0) {\r\n      this.bind(ctx, renderQueue);\r\n      material.draw(primitive, ctx);\r\n    }\r\n  }\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this._disposeSimulation();\r\n    this._primitive.dispose();\r\n    this._strands.dispose();\r\n    this._material.dispose();\r\n    this._parsedAsset = null;\r\n    this._source = null;\r\n    this._bounds = null;\r\n  }\r\n\r\n  //\r\n  // Internals\r\n  //\r\n\r\n  /**\r\n   * The material, which is an implementation detail of this node.\r\n   * @internal\r\n   */\r\n  private get material() {\r\n    return this._material.get()!;\r\n  }\r\n  /**\r\n   * Re-decimates the opened asset into the strands actually drawn.\r\n   * @internal\r\n   */\r\n  private _applyAssetDecimation() {\r\n    const parsed = this._parsedAsset;\r\n    if (!parsed) {\r\n      return;\r\n    }\r\n    // A `.zhair` holds one set per source curve object, and an XGen export\r\n    // routinely carries several spline descriptions for a single hairstyle;\r\n    // merging lets the whole head draw in one call.\r\n    this.setStrands(\r\n      mergeHairStrandSources(\r\n        loadZHairStrandSources(parsed, {\r\n          strandStride: this._strandStride,\r\n          maxStrands: this._maxStrands\r\n        })\r\n      )\r\n    );\r\n  }\r\n  /**\r\n   * Starts strand dynamics over the current strands.\r\n   * @internal\r\n   */\r\n  private _createSimulation() {\r\n    this._disposeSimulation();\r\n    const data = this._strands.get();\r\n    if (!data || !this._source || !isHairSimulationSupported()) {\r\n      return;\r\n    }\r\n    const simulation = new GPUHairSimulation(data, this._source, this._simulationOptions);\r\n    if (simulation.enabled) {\r\n      this._simulation = simulation;\r\n      // Motion vectors have to follow the control points once something is\r\n      // moving them, or a groom swinging under a still head reports no motion\r\n      // and a temporal filter smears it.\r\n      this.material.prevPoints = simulation.framePointBuffer;\r\n      // The bounds widen while a simulation runs - see computeBoundingVolume.\r\n      this.invalidateBoundingVolume();\r\n      this.scene?.queueUpdateNode(this);\r\n    } else {\r\n      console.warn(simulation.disabledReason ?? 'GPU hair simulation could not start');\r\n      simulation.dispose();\r\n    }\r\n  }\r\n  /** @internal */\r\n  private _disposeSimulation() {\r\n    this.material.prevPoints = null;\r\n    this._simulation?.dispose();\r\n    this._simulation = null;\r\n  }\r\n  /**\r\n   * Builds the primitive the draw call is issued against.\r\n   *\r\n   * @remarks\r\n   * No vertex attribute is ever read - the vertex shader derives everything from\r\n   * the vertex index and the storage buffers - but a draw still needs a vertex\r\n   * layout to exist, and one float is the smallest buffer that establishes one.\r\n   * @internal\r\n   */\r\n  private _ensurePrimitive() {\r\n    if (this._primitive.get()) {\r\n      return;\r\n    }\r\n    const primitive = new Primitive();\r\n    primitive.createAndSetVertexBuffer('position_f32x3', new Float32Array(3));\r\n    primitive.primitiveType = 'triangle-list';\r\n    this._primitive.set(primitive);\r\n  }\r\n  /**\r\n   * Points the draw range at however many vertices the material now needs.\r\n   *\r\n   * @remarks\r\n   * Drawing is non-indexed, six vertices per ribbon segment, so the count moves\r\n   * with both the strand count and {@link HairNode.segmentsPerStrand}.\r\n   * @internal\r\n   */\r\n  private _syncDrawRange() {\r\n    const primitive = this._primitive.get();\r\n    if (primitive) {\r\n      primitive.indexCount = this.material.vertexCount;\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Local-space bounds of a strand source, padded by the widest strand, along\r\n * with the length of the longest strand.\r\n *\r\n * @remarks\r\n * The ribbon is built around the control point, so half a width would suffice;\r\n * a full width is used because {@link HairNode.minPixelWidth} widens sub-pixel\r\n * strands beyond their authored size and the box has to survive that.\r\n *\r\n * The strand length is measured here because the same pass already touches\r\n * every point; it pads the bounds while a simulation runs.\r\n * @internal\r\n */\r\nfunction computeStrandExtents(source: HairStrandSource): {\r\n  bounds: BoundingBox;\r\n  maxStrandLength: number;\r\n} {\r\n  const scale = source.scale ?? 1;\r\n  const positions = source.positions;\r\n  const box = new BoundingBox();\r\n  box.beginExtend();\r\n  let maxStrandLength = 0;\r\n  let first = 0;\r\n  for (let s = 0; s < source.pointCounts.length; s++) {\r\n    const count = source.pointCounts[s];\r\n    let length = 0;\r\n    for (let i = 0; i < count; i++) {\r\n      const p = (first + i) * 3;\r\n      const x = positions[p] * scale;\r\n      const y = positions[p + 1] * scale;\r\n      const z = positions[p + 2] * scale;\r\n      box.extend3(x, y, z);\r\n      if (i > 0) {\r\n        length += Math.hypot(\r\n          x - positions[p - 3] * scale,\r\n          y - positions[p - 2] * scale,\r\n          z - positions[p - 1] * scale\r\n        );\r\n      }\r\n    }\r\n    if (length > maxStrandLength) {\r\n      maxStrandLength = length;\r\n    }\r\n    first += count;\r\n  }\r\n  let widest = source.defaultWidth ?? 0.0001;\r\n  if (source.widths) {\r\n    for (let i = 0; i < source.widths.length; i++) {\r\n      if (source.widths[i] > widest) {\r\n        widest = source.widths[i];\r\n      }\r\n    }\r\n  }\r\n  const pad = widest * scale * (source.widthScale ?? 1);\r\n  box.minPoint.setXYZ(box.minPoint.x - pad, box.minPoint.y - pad, box.minPoint.z - pad);\r\n  box.maxPoint.setXYZ(box.maxPoint.x + pad, box.maxPoint.y + pad, box.maxPoint.z + pad);\r\n  return { bounds: box, maxStrandLength };\r\n}\r\n"],"names":["HairNode","applyMixins","GraphNode","mixinDrawable","scene","_pickTarget","node","_material","DRef","HairStrandMaterial","_primitive","_strands","_bounds","_maxStrandLength","_castShadow","_source","_hairAsset","_parsedAsset","_strandStride","_maxStrands","_simulation","_simulationEnabled","_simulationOptions","gravity","Vector3","damping","globalStiffness","globalRange","localStiffness","localIterations","ftlDamping","vspCoeff","vspAccelThreshold","substeps","friction","maxSpeedFactor","hairAsset","setHairAsset","path","assetId","trim","setStrands","parsed","data","getEngine","resourceManager","assetManager","fetchBinaryData","parseZHair","err","console","error","_applyAssetDecimation","strandStride","val","v","maxStrands","strands","get","strandCount","source","_disposeSimulation","dispose","material","invalidateBoundingVolume","HairStrandData","set","extents","computeStrandExtents","bounds","maxStrandLength","_ensurePrimitive","_syncDrawRange","_createSimulation","albedoColor","value","shadingModel","specular1Color","specular1Power","specular1Shift","specular2Color","specular2Power","specular2Shift","diffuseWrap","transmissionColor","transmissionIntensity","transmissionPower","scatterColor","scatterIntensity","scatterLocal","scatterWrap","marschnerShift","marschnerRoughness","marschnerIOR","marschnerAbsorption","marschnerLobes","segmentsPerStrand","strandWidthScale","minStrandWidth","minPixelWidth","strandRoundness","rootOcclusion","rootOcclusionRange","strandLOD","minStrandLODRatio","blendMode","alphaCutoff","alphaDither","transparentMotionVector","castShadow","transparentShadowCaster","shadowAlphaCutoff","simulationEnabled","enabled","simulation","update","frameId","elapsedInSeconds","deltaInSeconds","worldMatrix","queueUpdateNode","computeBoundingVolume","box","BoundingBox","pad","minPoint","setXYZ","x","y","z","maxPoint","isHair","getPickTarget","getMaterial","getPrimitive","getMorphData","getMorphInfo","getSkinInfluenceData","getQueueType","QUEUE_OPAQUE","isUnlit","supportLighting","needSceneColor","needSceneDepth","draw","ctx","renderQueue","primitive","vertexCount","bind","onDispose","mergeHairStrandSources","loadZHairStrandSources","isHairSimulationSupported","GPUHairSimulation","prevPoints","framePointBuffer","warn","disabledReason","Primitive","createAndSetVertexBuffer","Float32Array","primitiveType","indexCount","scale","positions","beginExtend","first","s","pointCounts","length","count","i","p","extend3","Math","hypot","widest","defaultWidth","widths","widthScale"],"mappings":"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"}
+{"version":3,"file":"hair.js","sources":["../../src/scene/hair.ts"],"sourcesContent":["/**\r\n * A groom in the scene graph.\r\n *\r\n * @remarks\r\n * Strand hair is drawn from control points held in storage buffers and expanded\r\n * into camera-facing ribbons in the vertex shader, which needs a handful of\r\n * pieces wired together that nothing else in the engine needs: a primitive that\r\n * carries no attributes but still establishes a vertex layout, a draw range\r\n * derived from the material rather than from an index buffer, and a bounding box\r\n * computed on the CPU because the geometry does not exist until the vertex stage\r\n * has run. This node owns that assembly so a groom can be placed, transformed,\r\n * serialised and simulated like anything else.\r\n *\r\n * The material is deliberately not exposed. Strand geometry only exists inside\r\n * {@link HairStrandMaterial} - it reads control points from storage buffers that\r\n * no other material knows about - so letting one be swapped in would produce a\r\n * node that cannot draw. The shading controls are surfaced as properties of the\r\n * node instead, and they are what gets serialised.\r\n *\r\n * The geometry itself lives in a `.zhair` asset, referenced by path. That file\r\n * holds nothing but strands: the node's own settings, shading included, belong\r\n * to the scene rather than to the asset, so one groom can be shared by several\r\n * characters that each style it differently.\r\n *\r\n * WebGPU only, because the expansion reads storage buffers from the vertex\r\n * stage. On other backends the node exists and keeps its data but draws nothing.\r\n */\r\nimport type { Immutable, Nullable, Vector4 } from '@zephyr3d/base';\r\nimport { applyMixins, DRef, Vector3 } from '@zephyr3d/base';\r\nimport type { Scene } from './scene';\r\nimport { GraphNode } from './graph_node';\r\nimport { mixinDrawable } from '../render/drawable_mixin';\r\nimport type { Drawable, DrawContext, PickTarget, RenderQueue } from '../render';\r\nimport { Primitive } from '../render';\r\nimport { HairStrandMaterial } from '../material/hairstrand';\r\nimport type { HairShadingModel } from '../material/hair';\r\nimport { HairStrandData, type HairStrandSource } from '../material/hairstrand_data';\r\nimport {\r\n  GPUHairSimulation,\r\n  isHairSimulationSupported,\r\n  type GPUHairSimulationOptions\r\n} from '../animation/hair/gpu_hair_simulation';\r\nimport type { ParsedZHair } from '../asset/loaders/zhair/zhair_format';\r\nimport { parseZHair } from '../asset/loaders/zhair/zhair_format';\r\nimport { loadZHairStrandSources, mergeHairStrandSources } from '../asset/loaders/zhair/zhair_loader';\r\nimport { BoundingBox } from '../utility/bounding_volume';\r\nimport { QUEUE_OPAQUE } from '../values';\r\nimport { getEngine } from '../app/api';\r\nimport type { BlendMode } from '../material/meshmaterial';\r\nimport { warnUnsupported } from '../utility/unsupported';\r\n\r\n/**\r\n * Hair scene node.\r\n *\r\n * @remarks\r\n * Point it at a `.zhair` asset with {@link HairNode.setHairAsset}, or hand it\r\n * control points directly with {@link HairNode.setStrands}. Everything the draw\r\n * call needs is derived from them.\r\n *\r\n * @public\r\n */\r\nexport class HairNode extends applyMixins(GraphNode, mixinDrawable) implements Drawable {\r\n  /** @internal */\r\n  private readonly _pickTarget: PickTarget;\r\n  /** @internal */\r\n  private readonly _material: DRef<HairStrandMaterial>;\r\n  /** @internal */\r\n  private readonly _primitive: DRef<Primitive>;\r\n  /** @internal */\r\n  private readonly _strands: DRef<HairStrandData>;\r\n  /** @internal Local-space bounds of the control points, width included. */\r\n  private _bounds: Nullable<BoundingBox>;\r\n  /** @internal Length of the longest strand, for padding the bounds while simulating. */\r\n  private _maxStrandLength: number;\r\n  /** @internal */\r\n  private _castShadow: boolean;\r\n  /** @internal Kept so the simulation can be rebuilt from the authored pose. */\r\n  private _source: Nullable<HairStrandSource>;\r\n  /** @internal Path of the `.zhair` asset, empty when strands were set directly. */\r\n  private _hairAsset: string;\r\n  /**\r\n   * @internal The opened asset, kept so decimation can be changed without\r\n   * reading the file again.\r\n   */\r\n  private _parsedAsset: Nullable<ParsedZHair>;\r\n  /** @internal */\r\n  private _strandStride: number;\r\n  /** @internal */\r\n  private _maxStrands: number;\r\n  /** @internal */\r\n  private _simulation: Nullable<GPUHairSimulation>;\r\n  /** @internal */\r\n  private _simulationEnabled: boolean;\r\n  /**\r\n   * @internal Simulation tuning, owned by the node.\r\n   *\r\n   * Held here rather than on the simulation because the node outlives it: the\r\n   * dials survive the simulation being switched off and on, and can be set\r\n   * before any strands have loaded.\r\n   */\r\n  private readonly _simulationOptions: GPUHairSimulationOptions;\r\n  /**\r\n   * Creates an empty hair node.\r\n   *\r\n   * @param scene - Scene the node belongs to.\r\n   */\r\n  constructor(scene: Scene) {\r\n    super(scene);\r\n    this._pickTarget = { node: this };\r\n    this._material = new DRef(new HairStrandMaterial());\r\n    this._primitive = new DRef();\r\n    this._strands = new DRef();\r\n    this._bounds = null;\r\n    this._maxStrandLength = 0;\r\n    this._castShadow = true;\r\n    this._source = null;\r\n    this._hairAsset = '';\r\n    this._parsedAsset = null;\r\n    this._strandStride = 1;\r\n    this._maxStrands = 0;\r\n    this._simulation = null;\r\n    this._simulationEnabled = false;\r\n    this._simulationOptions = {\r\n      gravity: new Vector3(0, -9.8, 0),\r\n      damping: 0.08,\r\n      globalStiffness: 0,\r\n      globalRange: 0,\r\n      localStiffness: 0.9,\r\n      localIterations: 2,\r\n      ftlDamping: 0.7,\r\n      vspCoeff: 0.8,\r\n      vspAccelThreshold: 50,\r\n      substeps: 1,\r\n      friction: 0.2,\r\n      maxSpeedFactor: 4\r\n    };\r\n  }\r\n\r\n  //\r\n  // Geometry\r\n  //\r\n\r\n  /** Path of the `.zhair` asset this node draws, or an empty string. */\r\n  get hairAsset() {\r\n    return this._hairAsset;\r\n  }\r\n  /**\r\n   * Loads a `.zhair` asset.\r\n   *\r\n   * @remarks\r\n   * The opened file is kept, so changing {@link HairNode.strandStride} or\r\n   * {@link HairNode.maxStrands} afterwards re-decimates what is already in\r\n   * memory instead of reading it again - and never touches the source archive\r\n   * the asset was converted from.\r\n   *\r\n   * @param path - Asset path, or an empty string to clear the node.\r\n   */\r\n  async setHairAsset(path: string) {\r\n    const assetId = path?.trim() ?? '';\r\n    if (assetId === this._hairAsset) {\r\n      return;\r\n    }\r\n    this._hairAsset = assetId;\r\n    this._parsedAsset = null;\r\n    if (!assetId) {\r\n      this.setStrands(null);\r\n      return;\r\n    }\r\n    let parsed: ParsedZHair;\r\n    try {\r\n      const data = (await getEngine().resourceManager.assetManager.fetchBinaryData(assetId)) as ArrayBuffer;\r\n      parsed = parseZHair(data);\r\n    } catch (err) {\r\n      console.error(`Load hair asset failed: ${assetId}: ${err}`);\r\n      this.setStrands(null);\r\n      return;\r\n    }\r\n    // A load that was superseded while it was in flight must not overwrite the\r\n    // asset that replaced it.\r\n    if (this._hairAsset !== assetId) {\r\n      return;\r\n    }\r\n    this._parsedAsset = parsed;\r\n    this._applyAssetDecimation();\r\n  }\r\n  /**\r\n   * Draw one strand in every `strandStride`.\r\n   *\r\n   * @remarks\r\n   * A stride rather than a leading slice, so the kept strands stay spread over\r\n   * the whole scalp instead of leaving a bald patch. Only meaningful when the\r\n   * strands came from an asset; strands set directly are used as given.\r\n   */\r\n  get strandStride() {\r\n    return this._strandStride;\r\n  }\r\n  set strandStride(val: number) {\r\n    const v = val < 1 ? 1 : val | 0;\r\n    if (v !== this._strandStride) {\r\n      this._strandStride = v;\r\n      this._applyAssetDecimation();\r\n    }\r\n  }\r\n  /**\r\n   * Upper bound on the number of strands drawn, or 0 for no bound.\r\n   *\r\n   * @remarks\r\n   * Applied on top of {@link HairNode.strandStride} by widening the stride\r\n   * further, so the result stays evenly spread.\r\n   */\r\n  get maxStrands() {\r\n    return this._maxStrands;\r\n  }\r\n  set maxStrands(val: number) {\r\n    const v = val < 0 ? 0 : val | 0;\r\n    if (v !== this._maxStrands) {\r\n      this._maxStrands = v;\r\n      this._applyAssetDecimation();\r\n    }\r\n  }\r\n  /** GPU-resident strand geometry, or null when none has been assigned. */\r\n  get strands(): Nullable<HairStrandData> {\r\n    return this._strands.get();\r\n  }\r\n  /** Number of strands currently drawn. */\r\n  get strandCount() {\r\n    return this._strands.get()?.strandCount ?? 0;\r\n  }\r\n  /**\r\n   * Replaces the strands this node draws.\r\n   *\r\n   * @remarks\r\n   * The direct route, for strands built in code rather than loaded from an\r\n   * asset. Uploads the control points, sizes the draw call and recomputes the\r\n   * bounding box; the previous strand data is released and any running\r\n   * simulation is rebuilt, since its rest pose comes from the strands.\r\n   *\r\n   * @param source - Control points and topology, or null to clear the node.\r\n   */\r\n  setStrands(source: Nullable<HairStrandSource>) {\r\n    this._disposeSimulation();\r\n    this._strands.dispose();\r\n    this._bounds = null;\r\n    this._maxStrandLength = 0;\r\n    this._source = null;\r\n    if (!source) {\r\n      this.material.strands = null;\r\n      this._primitive.dispose();\r\n      this.invalidateBoundingVolume();\r\n      return;\r\n    }\r\n    const data = new HairStrandData(source);\r\n    this._strands.set(data);\r\n    this._source = source;\r\n    this.material.strands = data;\r\n    const extents = computeStrandExtents(source);\r\n    this._bounds = extents.bounds;\r\n    this._maxStrandLength = extents.maxStrandLength;\r\n    this._ensurePrimitive();\r\n    this._syncDrawRange();\r\n    this.invalidateBoundingVolume();\r\n    if (this._simulationEnabled) {\r\n      this._createSimulation();\r\n    }\r\n  }\r\n\r\n  //\r\n  // Shading\r\n  //\r\n  // The material is an implementation detail of this node - see the class\r\n  // remarks - so its controls are surfaced here. Only the ones that do something\r\n  // on the strand path are: the vertex shader emits no texture coordinates, so\r\n  // the material's albedo, shift and occlusion maps have nothing to sample and\r\n  // are deliberately left unreachable.\r\n  //\r\n\r\n  /** Base colour of the strands. */\r\n  get albedoColor(): Immutable<Vector4> {\r\n    return this.material.albedoColor;\r\n  }\r\n  set albedoColor(value: Vector4) {\r\n    this.material.albedoColor = value;\r\n  }\r\n  /**\r\n   * Which scattering model shades the hair.\r\n   *\r\n   * @remarks\r\n   * `kajiya-kay` is the art-directed double lobe; `marschner` derives the lobes\r\n   * from the fibre and is the one that renders back-lighting.\r\n   */\r\n  get shadingModel(): HairShadingModel {\r\n    return this.material.shadingModel;\r\n  }\r\n  set shadingModel(value: HairShadingModel) {\r\n    this.material.shadingModel = value;\r\n  }\r\n  /** Colour of the primary, near-white specular lobe. */\r\n  get specular1Color(): Immutable<Vector3> {\r\n    return this.material.specular1Color;\r\n  }\r\n  set specular1Color(value: Vector3) {\r\n    this.material.specular1Color = value;\r\n  }\r\n  /** Exponent of the primary specular lobe. */\r\n  get specular1Power() {\r\n    return this.material.specular1Power;\r\n  }\r\n  set specular1Power(value: number) {\r\n    this.material.specular1Power = value;\r\n  }\r\n  /** Shift of the primary specular lobe along the strand. */\r\n  get specular1Shift() {\r\n    return this.material.specular1Shift;\r\n  }\r\n  set specular1Shift(value: number) {\r\n    this.material.specular1Shift = value;\r\n  }\r\n  /** Colour of the secondary, tinted specular lobe. */\r\n  get specular2Color(): Immutable<Vector3> {\r\n    return this.material.specular2Color;\r\n  }\r\n  set specular2Color(value: Vector3) {\r\n    this.material.specular2Color = value;\r\n  }\r\n  /** Exponent of the secondary specular lobe. */\r\n  get specular2Power() {\r\n    return this.material.specular2Power;\r\n  }\r\n  set specular2Power(value: number) {\r\n    this.material.specular2Power = value;\r\n  }\r\n  /** Shift of the secondary specular lobe along the strand. */\r\n  get specular2Shift() {\r\n    return this.material.specular2Shift;\r\n  }\r\n  set specular2Shift(value: number) {\r\n    this.material.specular2Shift = value;\r\n  }\r\n  /** How far diffuse lighting wraps around the fibre. */\r\n  get diffuseWrap() {\r\n    return this.material.diffuseWrap;\r\n  }\r\n  set diffuseWrap(value: number) {\r\n    this.material.diffuseWrap = value;\r\n  }\r\n  /** Colour of light transmitted through the fibre. */\r\n  get transmissionColor(): Immutable<Vector3> {\r\n    return this.material.transmissionColor;\r\n  }\r\n  set transmissionColor(value: Vector3) {\r\n    this.material.transmissionColor = value;\r\n  }\r\n  /** Strength of back-lit transmission. */\r\n  get transmissionIntensity() {\r\n    return this.material.transmissionIntensity;\r\n  }\r\n  set transmissionIntensity(value: number) {\r\n    this.material.transmissionIntensity = value;\r\n  }\r\n  /** Falloff exponent of back-lit transmission. */\r\n  get transmissionPower() {\r\n    return this.material.transmissionPower;\r\n  }\r\n  set transmissionPower(value: number) {\r\n    this.material.transmissionPower = value;\r\n  }\r\n  /** Colour of multiple scattering within the groom. */\r\n  get scatterColor(): Immutable<Vector3> {\r\n    return this.material.scatterColor;\r\n  }\r\n  set scatterColor(value: Vector3) {\r\n    this.material.scatterColor = value;\r\n  }\r\n  /** Strength of multiple scattering. */\r\n  get scatterIntensity() {\r\n    return this.material.scatterIntensity;\r\n  }\r\n  set scatterIntensity(value: number) {\r\n    this.material.scatterIntensity = value;\r\n  }\r\n  /** Share of scattering taken as local rather than global. */\r\n  get scatterLocal() {\r\n    return this.material.scatterLocal;\r\n  }\r\n  set scatterLocal(value: number) {\r\n    this.material.scatterLocal = value;\r\n  }\r\n  /** How far scattered light wraps around the fibre. */\r\n  get scatterWrap() {\r\n    return this.material.scatterWrap;\r\n  }\r\n  set scatterWrap(value: number) {\r\n    this.material.scatterWrap = value;\r\n  }\r\n  /** Longitudinal shift of the Marschner lobes. */\r\n  get marschnerShift() {\r\n    return this.material.marschnerShift;\r\n  }\r\n  set marschnerShift(value: number) {\r\n    this.material.marschnerShift = value;\r\n  }\r\n  /** Longitudinal roughness of the Marschner lobes. */\r\n  get marschnerRoughness() {\r\n    return this.material.marschnerRoughness;\r\n  }\r\n  set marschnerRoughness(value: number) {\r\n    this.material.marschnerRoughness = value;\r\n  }\r\n  /** Index of refraction of the fibre. */\r\n  get marschnerIOR() {\r\n    return this.material.marschnerIOR;\r\n  }\r\n  set marschnerIOR(value: number) {\r\n    this.material.marschnerIOR = value;\r\n  }\r\n  /**\r\n   * How strongly pigmented the fibre is.\r\n   *\r\n   * @remarks\r\n   * A multiplier on the distance transmitted light travels before leaving, so\r\n   * raising it deepens the colour of the TT and TRT paths without touching the\r\n   * white surface reflection.\r\n   */\r\n  get marschnerAbsorption() {\r\n    return this.material.marschnerAbsorption;\r\n  }\r\n  set marschnerAbsorption(value: number) {\r\n    this.material.marschnerAbsorption = value;\r\n  }\r\n  /** Relative weight of the R, TT and TRT lobes. */\r\n  get marschnerLobes(): Immutable<Vector3> {\r\n    return this.material.marschnerLobes;\r\n  }\r\n  set marschnerLobes(value: Immutable<Vector3>) {\r\n    this.material.marschnerLobes = value;\r\n  }\r\n\r\n  //\r\n  // Strand expansion\r\n  //\r\n\r\n  /**\r\n   * Ribbon segments generated per strand.\r\n   *\r\n   * @remarks\r\n   * The main quality dial, and independent of how many control points a strand\r\n   * has: the shader resamples the curve, so the same 30-point strand can be\r\n   * drawn with 12 segments close up and 3 far away.\r\n   */\r\n  get segmentsPerStrand() {\r\n    return this.material.segmentsPerStrand;\r\n  }\r\n  set segmentsPerStrand(val: number) {\r\n    if (val !== this.material.segmentsPerStrand) {\r\n      this.material.segmentsPerStrand = val;\r\n      this._syncDrawRange();\r\n    }\r\n  }\r\n  /** Multiplier on the width stored in the strand data. */\r\n  get strandWidthScale() {\r\n    return this.material.strandWidthScale;\r\n  }\r\n  set strandWidthScale(value: number) {\r\n    this.material.strandWidthScale = value;\r\n  }\r\n  /** Lower bound on ribbon width, in world units. */\r\n  get minStrandWidth() {\r\n    return this.material.minStrandWidth;\r\n  }\r\n  set minStrandWidth(value: number) {\r\n    this.material.minStrandWidth = value;\r\n  }\r\n  /**\r\n   * Lower bound on ribbon width, in pixels.\r\n   *\r\n   * @remarks\r\n   * Real hair is thinner than a pixel and rasterises to a flickering dotted\r\n   * line. Widening it to about a pixel and paying the extra coverage back in\r\n   * alpha keeps distant hair fading rather than breaking up.\r\n   */\r\n  get minPixelWidth() {\r\n    return this.material.minPixelWidth;\r\n  }\r\n  set minPixelWidth(value: number) {\r\n    this.material.minPixelWidth = value;\r\n  }\r\n  /**\r\n   * How far the shading normal bends across the ribbon, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * At 0 a strand shades as a flat tape, at 1 as a cylinder.\r\n   */\r\n  get strandRoundness() {\r\n    return this.material.strandRoundness;\r\n  }\r\n  set strandRoundness(value: number) {\r\n    this.material.strandRoundness = value;\r\n  }\r\n  /**\r\n   * Strength of the root-depth ambient occlusion, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * Environment irradiance is not attenuated by anything - a shadow map answers\r\n   * for one light, not for the sky - so without this every strand of a groom\r\n   * receives the full sky and a dense hairstyle is lit as brightly in its\r\n   * interior as on its surface, which reads as a flat silhouette with no volume.\r\n   * Most obvious on pale hair, where there is little pigment to darken the\r\n   * interior instead. Set to 0 to disable.\r\n   *\r\n   * Ambient light only: direct light is already attenuated by the shadow map,\r\n   * and under DOM by a graded transmittance, so it is left alone.\r\n   */\r\n  get rootOcclusion() {\r\n    return this.material.rootOcclusion;\r\n  }\r\n  set rootOcclusion(value: number) {\r\n    this.material.rootOcclusion = value;\r\n  }\r\n  /**\r\n   * How far along a strand the root occlusion reaches, in (0, 1].\r\n   *\r\n   * @remarks\r\n   * Short for a groom whose strands leave the scalp quickly, longer for one\r\n   * where they lie against each other most of their length.\r\n   */\r\n  get rootOcclusionRange() {\r\n    return this.material.rootOcclusionRange;\r\n  }\r\n  set rootOcclusionRange(value: number) {\r\n    this.material.rootOcclusionRange = value;\r\n  }\r\n  /** Drop strands with distance, redistributing their coverage to the survivors. */\r\n  get strandLOD() {\r\n    return this.material.strandLOD;\r\n  }\r\n  set strandLOD(value: boolean) {\r\n    this.material.strandLOD = value;\r\n  }\r\n  /** Floor on the fraction of strands distance decimation keeps. */\r\n  get minStrandLODRatio() {\r\n    return this.material.minStrandLODRatio;\r\n  }\r\n  set minStrandLODRatio(value: number) {\r\n    this.material.minStrandLODRatio = value;\r\n  }\r\n\r\n  //\r\n  // Transparency and shadows\r\n  //\r\n\r\n  /**\r\n   * How the strands blend with what is behind them.\r\n   *\r\n   * @remarks\r\n   * The pixel-width floor pays its widening back in alpha, which only means\r\n   * anything once blending is on; left at `none` every strand covers its pixel\r\n   * fully and a dense groom reads as a solid shell.\r\n   */\r\n  get blendMode(): BlendMode {\r\n    return this.material.blendMode;\r\n  }\r\n  set blendMode(value: BlendMode) {\r\n    this.material.blendMode = value;\r\n  }\r\n  /** Alpha below which a fragment is discarded. */\r\n  get alphaCutoff() {\r\n    return this.material.alphaCutoff;\r\n  }\r\n  set alphaCutoff(value: number) {\r\n    this.material.alphaCutoff = value;\r\n  }\r\n  /** Dither the alpha test, so a temporal filter resolves the soft edge. */\r\n  get alphaDither() {\r\n    return this.material.alphaDither;\r\n  }\r\n  set alphaDither(value: boolean) {\r\n    this.material.alphaDither = value;\r\n  }\r\n  /**\r\n   * Whether a blended groom contributes motion vectors.\r\n   *\r\n   * @remarks\r\n   * Only meaningful with {@link HairNode.blendMode} set to something other than\r\n   * `none`. Blended geometry is otherwise absent from the prepass, so a groom\r\n   * carries the velocity of whatever is behind it and a temporal filter smears\r\n   * it as it swings - the same ghosting the dithered path avoids by being\r\n   * opaque. On by default, because a groom is dense enough to own its pixels\r\n   * and there is no reason to want the ghosting.\r\n   */\r\n  get transparentMotionVector() {\r\n    return this.material.transparentMotionVector;\r\n  }\r\n  set transparentMotionVector(value: boolean) {\r\n    this.material.transparentMotionVector = value;\r\n  }\r\n  /** Whether the groom is drawn into shadow maps. */\r\n  get castShadow() {\r\n    return this._castShadow;\r\n  }\r\n  set castShadow(val: boolean) {\r\n    this._castShadow = !!val;\r\n  }\r\n  /** Let the shadow caster pass respect strand alpha, for softer self-shadowing. */\r\n  get transparentShadowCaster() {\r\n    return this.material.transparentShadowCaster;\r\n  }\r\n  set transparentShadowCaster(value: boolean) {\r\n    this.material.transparentShadowCaster = value;\r\n  }\r\n  /** Alpha below which a fragment casts no shadow. */\r\n  get shadowAlphaCutoff() {\r\n    return this.material.shadowAlphaCutoff;\r\n  }\r\n  set shadowAlphaCutoff(value: number) {\r\n    this.material.shadowAlphaCutoff = value;\r\n  }\r\n\r\n  //\r\n  // Simulation\r\n  //\r\n\r\n  /**\r\n   * Whether strand dynamics run on this groom.\r\n   *\r\n   * @remarks\r\n   * WebGPU only. Switching it on with no strands loaded is allowed - the\r\n   * simulation is built when the strands arrive.\r\n   */\r\n  get simulationEnabled() {\r\n    return this._simulationEnabled;\r\n  }\r\n  set simulationEnabled(val: boolean) {\r\n    const enabled = !!val;\r\n    if (enabled === this._simulationEnabled) {\r\n      return;\r\n    }\r\n    this._simulationEnabled = enabled;\r\n    if (enabled) {\r\n      this._createSimulation();\r\n    } else {\r\n      this._disposeSimulation();\r\n      // Without this the groom keeps whatever pose it was last simulated into,\r\n      // which reads as a bug rather than as hair that stopped moving.\r\n      if (this._source) {\r\n        this._strands.get()?.dispose();\r\n        this._strands.set(new HairStrandData(this._source));\r\n        this.material.strands = this._strands.get();\r\n      }\r\n      // Back to the tight rest bounds.\r\n      this.invalidateBoundingVolume();\r\n    }\r\n  }\r\n  /**\r\n   * The running strand dynamics, or null when they are off or unsupported.\r\n   *\r\n   * @remarks\r\n   * Exposed so a caller can reach past the node's own dials - to set colliders,\r\n   * for one, which have no serialised form here.\r\n   */\r\n  get simulation(): Nullable<GPUHairSimulation> {\r\n    return this._simulation;\r\n  }\r\n  /** World-space gravity acting on the strands. */\r\n  get gravity(): Immutable<Vector3> {\r\n    return this._simulationOptions.gravity!;\r\n  }\r\n  set gravity(value: Vector3) {\r\n    this._simulationOptions.gravity = new Vector3(value);\r\n    if (this._simulation) {\r\n      this._simulation.gravity = this._simulationOptions.gravity;\r\n    }\r\n  }\r\n  /**\r\n   * How strongly strands keep the shape they were authored with, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * The dial to reach for first. It holds the angle each segment makes with the\r\n   * one before it, measured against that segment's current direction rather\r\n   * than a fixed pose, so a groom keeps its curl while remaining free to hang\r\n   * and swing. It is also what damps a groom: without bending resistance a\r\n   * strand carries a disturbance up and down its length for seconds.\r\n   */\r\n  get localStiffness() {\r\n    return this._simulationOptions.localStiffness!;\r\n  }\r\n  set localStiffness(value: number) {\r\n    this._simulationOptions.localStiffness = value;\r\n    if (this._simulation) {\r\n      this._simulation.localStiffness = value;\r\n    }\r\n  }\r\n  /** Local shape constraint passes per substep. */\r\n  get localIterations() {\r\n    return this._simulationOptions.localIterations!;\r\n  }\r\n  set localIterations(value: number) {\r\n    this._simulationOptions.localIterations = value;\r\n    if (this._simulation) {\r\n      this._simulation.localIterations = value;\r\n    }\r\n  }\r\n  /**\r\n   * How strongly strands are pulled back to their authored pose, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * Off by default. It anchors a point to a fixed place rather than to its\r\n   * neighbours, which is a spring, and a groom held by springs reads as one.\r\n   * {@link HairNode.localStiffness} is what holds styling without that; this is\r\n   * for grooms that genuinely should not move far from how they were authored,\r\n   * and wants {@link HairNode.globalRange} set as well.\r\n   */\r\n  get globalStiffness() {\r\n    return this._simulationOptions.globalStiffness!;\r\n  }\r\n  set globalStiffness(value: number) {\r\n    this._simulationOptions.globalStiffness = value;\r\n    if (this._simulation) {\r\n      this._simulation.globalStiffness = value;\r\n    }\r\n  }\r\n  /** Fraction of a strand, from the root, the pose pull acts on, in [0, 1]. */\r\n  get globalRange() {\r\n    return this._simulationOptions.globalRange!;\r\n  }\r\n  set globalRange(value: number) {\r\n    this._simulationOptions.globalRange = value;\r\n    if (this._simulation) {\r\n      this._simulation.globalRange = value;\r\n    }\r\n  }\r\n  /**\r\n   * Share of a point's length correction fed back into its parent, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * What keeps the solver from gaining energy as the node moves. Lowering it\r\n   * makes a groom livelier and, past a point, makes it whip; 0 removes the\r\n   * feedback entirely.\r\n   */\r\n  get ftlDamping() {\r\n    return this._simulationOptions.ftlDamping!;\r\n  }\r\n  set ftlDamping(value: number) {\r\n    this._simulationOptions.ftlDamping = value;\r\n    if (this._simulation) {\r\n      this._simulation.ftlDamping = value;\r\n    }\r\n  }\r\n  /** Velocity lost each step, in [0, 1]. */\r\n  get damping() {\r\n    return this._simulationOptions.damping!;\r\n  }\r\n  set damping(value: number) {\r\n    this._simulationOptions.damping = value;\r\n    if (this._simulation) {\r\n      this._simulation.damping = value;\r\n    }\r\n  }\r\n  /** Tangential motion removed at a contact, in [0, 1]. */\r\n  get friction() {\r\n    return this._simulationOptions.friction!;\r\n  }\r\n  set friction(value: number) {\r\n    this._simulationOptions.friction = value;\r\n    if (this._simulation) {\r\n      this._simulation.friction = value;\r\n    }\r\n  }\r\n  /**\r\n   * How much of the node's motion strands are carried along by, in [0, 1].\r\n   *\r\n   * @remarks\r\n   * 0 leaves a groom exactly where it was in the world and lets the pinned\r\n   * roots drag it along, which is what produces lag; 1 carries it rigidly with\r\n   * the node, so it never lags. Lower values give a livelier, floppier groom.\r\n   */\r\n  get vspCoeff() {\r\n    return this._simulationOptions.vspCoeff!;\r\n  }\r\n  set vspCoeff(value: number) {\r\n    this._simulationOptions.vspCoeff = value;\r\n    if (this._simulation) {\r\n      this._simulation.vspCoeff = value;\r\n    }\r\n  }\r\n  /** Node acceleration above which strands are carried rigidly, in units/s². */\r\n  get vspAccelThreshold() {\r\n    return this._simulationOptions.vspAccelThreshold!;\r\n  }\r\n  set vspAccelThreshold(value: number) {\r\n    this._simulationOptions.vspAccelThreshold = value;\r\n    if (this._simulation) {\r\n      this._simulation.vspAccelThreshold = value;\r\n    }\r\n  }\r\n  /**\r\n   * Per-substep ceiling on how far a point may travel, in segment lengths.\r\n   *\r\n   * @remarks\r\n   * A backstop against a single bad substep, not a dial to shape motion with:\r\n   * at the default it never engages during ordinary movement.\r\n   */\r\n  get maxSpeedFactor() {\r\n    return this._simulationOptions.maxSpeedFactor!;\r\n  }\r\n  set maxSpeedFactor(value: number) {\r\n    this._simulationOptions.maxSpeedFactor = value;\r\n    if (this._simulation) {\r\n      this._simulation.maxSpeedFactor = value;\r\n    }\r\n  }\r\n  /** Integration substeps per fixed step. */\r\n  get substeps() {\r\n    return this._simulationOptions.substeps!;\r\n  }\r\n  set substeps(value: number) {\r\n    this._simulationOptions.substeps = value;\r\n    if (this._simulation) {\r\n      this._simulation.substeps = value;\r\n    }\r\n  }\r\n\r\n  //\r\n  // Scene node and drawable\r\n  //\r\n\r\n  /**\r\n   * {@inheritDoc SceneNode.update}\r\n   *\r\n   * @remarks\r\n   * Drives the strand solver. The node re-queues itself every frame, because a\r\n   * simulation only stands still when it is switched off.\r\n   */\r\n  update(frameId: number, elapsedInSeconds: number, deltaInSeconds: number) {\r\n    super.update(frameId, elapsedInSeconds, deltaInSeconds);\r\n    const simulation = this._simulation;\r\n    if (simulation?.enabled) {\r\n      simulation.update(deltaInSeconds, this.worldMatrix);\r\n      this.scene?.queueUpdateNode(this);\r\n    }\r\n  }\r\n  /**\r\n   * {@inheritDoc SceneNode.computeBoundingVolume}\r\n   *\r\n   * @remarks\r\n   * Derived on the CPU from the control points, because the ribbons are built in\r\n   * the vertex shader and the engine never sees them. The box is in local space;\r\n   * the base class applies the world matrix.\r\n   *\r\n   * While a simulation runs, the strands swing out of their authored pose, so\r\n   * the rest bounds are padded by the longest strand: the solver keeps every\r\n   * point within its strand's length of the pinned root, which bounds any pose\r\n   * it can produce.\r\n   */\r\n  computeBoundingVolume(): Nullable<BoundingBox> {\r\n    if (!this._bounds) {\r\n      return null;\r\n    }\r\n    const box = new BoundingBox(this._bounds);\r\n    if (this._simulation) {\r\n      const pad = this._maxStrandLength;\r\n      box.minPoint.setXYZ(box.minPoint.x - pad, box.minPoint.y - pad, box.minPoint.z - pad);\r\n      box.maxPoint.setXYZ(box.maxPoint.x + pad, box.maxPoint.y + pad, box.maxPoint.z + pad);\r\n    }\r\n    return box;\r\n  }\r\n  /** {@inheritDoc SceneNode.isHair} */\r\n  isHair(): this is HairNode {\r\n    return true;\r\n  }\r\n  /** {@inheritDoc Drawable.getPickTarget} */\r\n  getPickTarget() {\r\n    return this._pickTarget;\r\n  }\r\n  /** {@inheritDoc Drawable.getMaterial} */\r\n  getMaterial() {\r\n    return this._material.get();\r\n  }\r\n  /** {@inheritDoc Drawable.getPrimitive} */\r\n  getPrimitive() {\r\n    return this._primitive.get();\r\n  }\r\n  /** {@inheritDoc Drawable.getMorphData} */\r\n  getMorphData() {\r\n    return null;\r\n  }\r\n  /** {@inheritDoc Drawable.getMorphInfo} */\r\n  getMorphInfo() {\r\n    return null;\r\n  }\r\n  /** {@inheritDoc Drawable.getSkinInfluenceData} */\r\n  getSkinInfluenceData() {\r\n    return null;\r\n  }\r\n  /** {@inheritDoc Drawable.getQueueType} */\r\n  getQueueType() {\r\n    return this._material.get()?.getQueueType() ?? QUEUE_OPAQUE;\r\n  }\r\n  /** {@inheritDoc Drawable.isUnlit} */\r\n  isUnlit() {\r\n    return !this._material.get()?.supportLighting();\r\n  }\r\n  /** {@inheritDoc Drawable.needSceneColor} */\r\n  needSceneColor() {\r\n    return this._material.get()?.needSceneColor() ?? false;\r\n  }\r\n  /** {@inheritDoc Drawable.needSceneDepth} */\r\n  needSceneDepth() {\r\n    return this._material.get()?.needSceneDepth() ?? false;\r\n  }\r\n  /** {@inheritDoc Drawable.draw} */\r\n  draw(ctx: DrawContext, renderQueue: Nullable<RenderQueue>) {\r\n    const material = this._material.get();\r\n    const primitive = this._primitive.get();\r\n    // An empty groom is a legitimate state - a node exists before its asset has\r\n    // finished loading - and the draw range is zero until strands arrive.\r\n    if (material && primitive && material.vertexCount > 0) {\r\n      this.bind(ctx, renderQueue);\r\n      material.draw(primitive, ctx);\r\n    }\r\n  }\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this._disposeSimulation();\r\n    this._primitive.dispose();\r\n    this._strands.dispose();\r\n    this._material.dispose();\r\n    this._parsedAsset = null;\r\n    this._source = null;\r\n    this._bounds = null;\r\n  }\r\n\r\n  //\r\n  // Internals\r\n  //\r\n\r\n  /**\r\n   * The material, which is an implementation detail of this node.\r\n   * @internal\r\n   */\r\n  private get material() {\r\n    return this._material.get()!;\r\n  }\r\n  /**\r\n   * Re-decimates the opened asset into the strands actually drawn.\r\n   * @internal\r\n   */\r\n  private _applyAssetDecimation() {\r\n    const parsed = this._parsedAsset;\r\n    if (!parsed) {\r\n      return;\r\n    }\r\n    // A `.zhair` holds one set per source curve object, and an XGen export\r\n    // routinely carries several spline descriptions for a single hairstyle;\r\n    // merging lets the whole head draw in one call.\r\n    this.setStrands(\r\n      mergeHairStrandSources(\r\n        loadZHairStrandSources(parsed, {\r\n          strandStride: this._strandStride,\r\n          maxStrands: this._maxStrands\r\n        })\r\n      )\r\n    );\r\n  }\r\n  /**\r\n   * Starts strand dynamics over the current strands.\r\n   * @internal\r\n   */\r\n  private _createSimulation() {\r\n    this._disposeSimulation();\r\n    const data = this._strands.get();\r\n    if (!data || !this._source) {\r\n      return;\r\n    }\r\n    if (!isHairSimulationSupported()) {\r\n      warnUnsupported(\r\n        'Hair strand dynamics (Hair.simulationEnabled)',\r\n        'WebGPU',\r\n        'strands stay in their rest pose'\r\n      );\r\n      return;\r\n    }\r\n    const simulation = new GPUHairSimulation(data, this._source, this._simulationOptions);\r\n    if (simulation.enabled) {\r\n      this._simulation = simulation;\r\n      // Motion vectors have to follow the control points once something is\r\n      // moving them, or a groom swinging under a still head reports no motion\r\n      // and a temporal filter smears it.\r\n      this.material.prevPoints = simulation.framePointBuffer;\r\n      // The bounds widen while a simulation runs - see computeBoundingVolume.\r\n      this.invalidateBoundingVolume();\r\n      this.scene?.queueUpdateNode(this);\r\n    } else {\r\n      console.warn(simulation.disabledReason ?? 'GPU hair simulation could not start');\r\n      simulation.dispose();\r\n    }\r\n  }\r\n  /** @internal */\r\n  private _disposeSimulation() {\r\n    this.material.prevPoints = null;\r\n    this._simulation?.dispose();\r\n    this._simulation = null;\r\n  }\r\n  /**\r\n   * Builds the primitive the draw call is issued against.\r\n   *\r\n   * @remarks\r\n   * No vertex attribute is ever read - the vertex shader derives everything from\r\n   * the vertex index and the storage buffers - but a draw still needs a vertex\r\n   * layout to exist, and one float is the smallest buffer that establishes one.\r\n   * @internal\r\n   */\r\n  private _ensurePrimitive() {\r\n    if (this._primitive.get()) {\r\n      return;\r\n    }\r\n    const primitive = new Primitive();\r\n    primitive.createAndSetVertexBuffer('position_f32x3', new Float32Array(3));\r\n    primitive.primitiveType = 'triangle-list';\r\n    this._primitive.set(primitive);\r\n  }\r\n  /**\r\n   * Points the draw range at however many vertices the material now needs.\r\n   *\r\n   * @remarks\r\n   * Drawing is non-indexed, six vertices per ribbon segment, so the count moves\r\n   * with both the strand count and {@link HairNode.segmentsPerStrand}.\r\n   * @internal\r\n   */\r\n  private _syncDrawRange() {\r\n    const primitive = this._primitive.get();\r\n    if (primitive) {\r\n      primitive.indexCount = this.material.vertexCount;\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Local-space bounds of a strand source, padded by the widest strand, along\r\n * with the length of the longest strand.\r\n *\r\n * @remarks\r\n * The ribbon is built around the control point, so half a width would suffice;\r\n * a full width is used because {@link HairNode.minPixelWidth} widens sub-pixel\r\n * strands beyond their authored size and the box has to survive that.\r\n *\r\n * The strand length is measured here because the same pass already touches\r\n * every point; it pads the bounds while a simulation runs.\r\n * @internal\r\n */\r\nfunction computeStrandExtents(source: HairStrandSource): {\r\n  bounds: BoundingBox;\r\n  maxStrandLength: number;\r\n} {\r\n  const scale = source.scale ?? 1;\r\n  const positions = source.positions;\r\n  const box = new BoundingBox();\r\n  box.beginExtend();\r\n  let maxStrandLength = 0;\r\n  let first = 0;\r\n  for (let s = 0; s < source.pointCounts.length; s++) {\r\n    const count = source.pointCounts[s];\r\n    let length = 0;\r\n    for (let i = 0; i < count; i++) {\r\n      const p = (first + i) * 3;\r\n      const x = positions[p] * scale;\r\n      const y = positions[p + 1] * scale;\r\n      const z = positions[p + 2] * scale;\r\n      box.extend3(x, y, z);\r\n      if (i > 0) {\r\n        length += Math.hypot(\r\n          x - positions[p - 3] * scale,\r\n          y - positions[p - 2] * scale,\r\n          z - positions[p - 1] * scale\r\n        );\r\n      }\r\n    }\r\n    if (length > maxStrandLength) {\r\n      maxStrandLength = length;\r\n    }\r\n    first += count;\r\n  }\r\n  let widest = source.defaultWidth ?? 0.0001;\r\n  if (source.widths) {\r\n    for (let i = 0; i < source.widths.length; i++) {\r\n      if (source.widths[i] > widest) {\r\n        widest = source.widths[i];\r\n      }\r\n    }\r\n  }\r\n  const pad = widest * scale * (source.widthScale ?? 1);\r\n  box.minPoint.setXYZ(box.minPoint.x - pad, box.minPoint.y - pad, box.minPoint.z - pad);\r\n  box.maxPoint.setXYZ(box.maxPoint.x + pad, box.maxPoint.y + pad, box.maxPoint.z + pad);\r\n  return { bounds: box, maxStrandLength };\r\n}\r\n"],"names":["HairNode","applyMixins","GraphNode","mixinDrawable","scene","_pickTarget","node","_material","DRef","HairStrandMaterial","_primitive","_strands","_bounds","_maxStrandLength","_castShadow","_source","_hairAsset","_parsedAsset","_strandStride","_maxStrands","_simulation","_simulationEnabled","_simulationOptions","gravity","Vector3","damping","globalStiffness","globalRange","localStiffness","localIterations","ftlDamping","vspCoeff","vspAccelThreshold","substeps","friction","maxSpeedFactor","hairAsset","setHairAsset","path","assetId","trim","setStrands","parsed","data","getEngine","resourceManager","assetManager","fetchBinaryData","parseZHair","err","console","error","_applyAssetDecimation","strandStride","val","v","maxStrands","strands","get","strandCount","source","_disposeSimulation","dispose","material","invalidateBoundingVolume","HairStrandData","set","extents","computeStrandExtents","bounds","maxStrandLength","_ensurePrimitive","_syncDrawRange","_createSimulation","albedoColor","value","shadingModel","specular1Color","specular1Power","specular1Shift","specular2Color","specular2Power","specular2Shift","diffuseWrap","transmissionColor","transmissionIntensity","transmissionPower","scatterColor","scatterIntensity","scatterLocal","scatterWrap","marschnerShift","marschnerRoughness","marschnerIOR","marschnerAbsorption","marschnerLobes","segmentsPerStrand","strandWidthScale","minStrandWidth","minPixelWidth","strandRoundness","rootOcclusion","rootOcclusionRange","strandLOD","minStrandLODRatio","blendMode","alphaCutoff","alphaDither","transparentMotionVector","castShadow","transparentShadowCaster","shadowAlphaCutoff","simulationEnabled","enabled","simulation","update","frameId","elapsedInSeconds","deltaInSeconds","worldMatrix","queueUpdateNode","computeBoundingVolume","box","BoundingBox","pad","minPoint","setXYZ","x","y","z","maxPoint","isHair","getPickTarget","getMaterial","getPrimitive","getMorphData","getMorphInfo","getSkinInfluenceData","getQueueType","QUEUE_OPAQUE","isUnlit","supportLighting","needSceneColor","needSceneDepth","draw","ctx","renderQueue","primitive","vertexCount","bind","onDispose","mergeHairStrandSources","loadZHairStrandSources","isHairSimulationSupported","warnUnsupported","GPUHairSimulation","prevPoints","framePointBuffer","warn","disabledReason","Primitive","createAndSetVertexBuffer","Float32Array","primitiveType","indexCount","scale","positions","beginExtend","first","s","pointCounts","length","count","i","p","extend3","Math","hypot","widest","defaultWidth","widths","widthScale"],"mappings":"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"}

package/dist/scene/light.js

@@ -1,4 +1,4 @@
-import { Vector4, DWeakRef, Vector3 } from '@zephyr3d/base';
+import { Matrix4x4, Vector4, DWeakRef, Vector3 } from '@zephyr3d/base';
 import { GraphNode } from './graph_node.js';
 import { BoundingBox } from '../utility/bounding_volume.js';
 import { ShadowMapper } from '../shadow/shadowmapper.js';
@@ -157,6 +157,10 @@ export abstract class AmbientLight extends BaseLight {
  */ class PunctualLight extends BaseLight {
     /** @internal */ _color;
     /** @internal */ _castShadow;
+    /** @internal */ _transmission;
+    /** @internal */ _contactShadowLength;
+    /** @internal */ _contactShadowLengthInWS;
+    /** @internal */ _contactShadowCastingIntensity;
     /** @internal */ _shadowMapper;
     /**
    * Creates an instance of punctual light
@@ -166,6 +170,25 @@ export abstract class AmbientLight extends BaseLight {
         super(scene, type);
         this.ensurePunctualState();
     }
+    /**
+   * {@inheritDoc SceneNode.computeWorldBoundingVolume}
+   *
+   * @remarks
+   * The local bounds are built from the range in world units, the same value
+   * the shader uses, so they are placed with the world rotation and position
+   * only. Scaling a light changes neither its reach nor its cone.
+   *
+   * @override
+   */ computeWorldBoundingVolume(localBV) {
+        if (!localBV) {
+            return null;
+        }
+        const m = new Matrix4x4(this.worldMatrix);
+        for(let i = 0; i < 3; i++){
+            m.setRow(i, m.getRow(i).inplaceNormalize());
+        }
+        return localBV.transform(m);
+    }
     /** @internal */ ensurePunctualState() {
         if (!this._color) {
             this._color = Vector4.one();
@@ -173,6 +196,18 @@ export abstract class AmbientLight extends BaseLight {
         if (this._castShadow == null) {
             this._castShadow = false;
         }
+        if (this._transmission == null) {
+            this._transmission = false;
+        }
+        if (this._contactShadowLength == null) {
+            this._contactShadowLength = 0;
+        }
+        if (this._contactShadowLengthInWS == null) {
+            this._contactShadowLengthInWS = false;
+        }
+        if (this._contactShadowCastingIntensity == null) {
+            this._contactShadowCastingIntensity = 1;
+        }
         if (!this._shadowMapper) {
             this._shadowMapper = new ShadowMapper(this);
         }
@@ -220,6 +255,64 @@ export abstract class AmbientLight extends BaseLight {
         return this._shadowMapper;
     }
     /**
+   * Whether this light contributes back-lit subsurface transmission. Off by default.
+   *
+   * @public
+   */ get transmission() {
+        this.ensurePunctualState();
+        return this._transmission;
+    }
+    set transmission(b) {
+        this.setTransmission(b);
+    }
+    /**
+   * Sets whether this light contributes back-lit subsurface transmission.
+   * @param b - true to enable transmission for this light
+   * @returns self
+   */ setTransmission(b) {
+        this.ensurePunctualState();
+        this._transmission = !!b;
+        return this;
+    }
+    /**
+   * Length of the screen-space ray traced towards the light for sharp contact
+   * shadows. Zero disables them.
+   *
+   * @public
+   */ get contactShadowLength() {
+        this.ensurePunctualState();
+        return this._contactShadowLength;
+    }
+    set contactShadowLength(val) {
+        this.ensurePunctualState();
+        this._contactShadowLength = Math.max(0, Number(val) || 0);
+    }
+    /**
+   * Whether {@link PunctualLight.contactShadowLength} is in world units rather
+   * than a fraction of the screen height.
+   *
+   * @public
+   */ get contactShadowLengthInWS() {
+        this.ensurePunctualState();
+        return this._contactShadowLengthInWS;
+    }
+    set contactShadowLengthInWS(val) {
+        this.ensurePunctualState();
+        this._contactShadowLengthInWS = !!val;
+    }
+    /**
+   * Darkness of contact shadows, 0 = none, 1 = fully shadowed.
+   *
+   * @public
+   */ get contactShadowCastingIntensity() {
+        this.ensurePunctualState();
+        return this._contactShadowCastingIntensity;
+    }
+    set contactShadowCastingIntensity(val) {
+        this.ensurePunctualState();
+        this._contactShadowCastingIntensity = Math.min(1, Math.max(0, Number(val) || 0));
+    }
+    /**
    * {@inheritDoc BaseLight.isPunctualLight}
    * @override
    */ isPunctualLight() {
@@ -363,9 +456,8 @@ export abstract class AmbientLight extends BaseLight {
         if (intensity !== this._luminousIntensity) {
             this._luminousIntensity = intensity;
             this.invalidateUniforms();
-            if (this._range <= 0) {
-                this.invalidateBoundingVolume();
-            }
+            // computeUniforms caps a set range by the derived one too, so the bounds follow either way.
+            this.invalidateBoundingVolume();
         }
     }
     /**
@@ -393,6 +485,18 @@ export abstract class AmbientLight extends BaseLight {
         return this;
     }
     /**
+   * {@inheritDoc BaseLight.setIntensity}
+   * @override
+   */ setIntensity(val) {
+        const changed = val !== this._intensity;
+        super.setIntensity(val);
+        // The range is capped by the one the intensity gives, and with it the culling bounds.
+        if (changed) {
+            this.invalidateBoundingVolume();
+        }
+        return this;
+    }
+    /**
    * Sets the diffuse scale of the light
    * @param val - The value to set
    * @returns self
@@ -401,6 +505,7 @@ export abstract class AmbientLight extends BaseLight {
         if (this._diffuseScale !== val) {
             this._diffuseScale = val;
             this.invalidateUniforms();
+            this.invalidateBoundingVolume();
         }
         return this;
     }
@@ -413,6 +518,7 @@ export abstract class AmbientLight extends BaseLight {
         if (this._specularScale !== val) {
             this._specularScale = val;
             this.invalidateUniforms();
+            this.invalidateBoundingVolume();
         }
         return this;
     }
@@ -449,7 +555,8 @@ export abstract class AmbientLight extends BaseLight {
         // diffuse/specular scales still multiply the shaded result, so the auto-derived influence
         // radius has to account for them. SpotLight has no equivalent scales, hence no such factor.
         const physicalScale = Math.max(this._diffuseScale, this._specularScale);
-        const range = this.range <= 0 ? physical ? Math.sqrt(Math.max(0, this.luminousIntensity * physicalScale) / PHYSICAL_LIGHT_CUTOFF_LUX) / metersPerUnit : 32 * Math.sqrt(Math.max(0.0001, this.intensity * physicalScale)) : this.range;
+        const calculatedRange = physical ? Math.sqrt(Math.max(0, this.luminousIntensity * physicalScale) / PHYSICAL_LIGHT_CUTOFF_LUX) / metersPerUnit : 32 * Math.sqrt(Math.max(0.0001, this.intensity * physicalScale));
+        const range = this.range <= 0 ? calculatedRange : Math.min(this.range, calculatedRange);
         const resolvedIntensity = physical ? this.luminousIntensity / (metersPerUnit * metersPerUnit) : this.intensity;
         this._positionRange = new Vector4(a.x, a.y, a.z, range);
         this._directionCutoff = new Vector4(b.x, b.y, b.z, -1);
@@ -498,6 +605,18 @@ export abstract class AmbientLight extends BaseLight {
         }
         return this;
     }
+    /**
+   * {@inheritDoc BaseLight.setIntensity}
+   * @override
+   */ setIntensity(val) {
+        const changed = val !== this._intensity;
+        super.setIntensity(val);
+        // The automatic range follows the intensity, and with it the culling bounds.
+        if (changed && this._range <= 0) {
+            this.invalidateBoundingVolume();
+        }
+        return this;
+    }
     /** The cutoff of the light */ get cutoff() {
         return this._cutoff;
     }
@@ -595,12 +714,14 @@ export abstract class AmbientLight extends BaseLight {
         // In legacy mode `_cutoff` already stores the cosine of the cone half-angle (see the
         // constructor default and computeUniforms), so it must be used as-is. Physical mode keeps the
         // half-angle in radians instead, hence the conversion there.
-        // The lower clamp keeps the radius finite for half-angles at or beyond 90 degrees.
-        const cosCutoff = Math.min(1, Math.max(0.0001, this.scene?.lightingMode === 'physical' ? Math.cos(this._outerConeAngle) : this._cutoff));
+        // Both setters keep the half-angle within 90 degrees, so the cosine is never negative.
+        const cosCutoff = Math.min(1, Math.max(0, this.scene?.lightingMode === 'physical' ? Math.cos(this._outerConeAngle) : this._cutoff));
         const range = this.positionAndRange.w;
-        const r = range / cosCutoff * Math.sqrt(1 - cosCutoff * cosCutoff);
-        bbox.minPoint = new Vector3(-r, -r, 0);
-        bbox.maxPoint = new Vector3(r, r, range);
+        // The lit region is the cone intersected with the range sphere. The light shines down its
+        // local -Z (computeUniforms negates the Z row), so that is the side the bounds extend into.
+        const r = range * Math.sqrt(1 - cosCutoff * cosCutoff);
+        bbox.minPoint = new Vector3(-r, -r, -range);
+        bbox.maxPoint = new Vector3(r, r, 0);
         return bbox;
     }
     /** @internal */ computeUniforms() {
@@ -622,6 +743,13 @@ export abstract class AmbientLight extends BaseLight {
 }
 /**
  * Rectangular area light
+ *
+ * @remarks
+ * Shadows render a cube map from the light's centre. Only the `pcss` shadow
+ * mode softens them by the light's size - the penumbra follows the panel's
+ * area and the blocker and receiver distances, hardening towards contact. The
+ * other modes filter with a fixed kernel that ignores the light's size.
+ *
  * @public
  */ class RectLight extends PunctualLight {
     /** @internal */ _range;
@@ -639,7 +767,15 @@ export abstract class AmbientLight extends BaseLight {
         this._luminance = 100;
         this.invalidateBoundingVolume();
     }
-    /** The range of the light */ get range() {
+    /**
+   * The range of the light, in world units.
+   *
+   * @remarks
+   * 0 derives it from the light's output, as for point lights: the distance at
+   * which the rect, seen as a point of intensity `luminance * area`, falls to
+   * the same illuminance cutoff. It is never shorter than the rect's diagonal,
+   * so a large dim panel still lights its own surroundings.
+   */ get range() {
         return this._range;
     }
     set range(val) {
@@ -691,6 +827,9 @@ export abstract class AmbientLight extends BaseLight {
         if (luminance !== this._luminance) {
             this._luminance = luminance;
             this.invalidateUniforms();
+            if (this._range <= 0) {
+                this.invalidateBoundingVolume();
+            }
         }
     }
     /**
@@ -723,16 +862,43 @@ export abstract class AmbientLight extends BaseLight {
         return this;
     }
     /**
+   * {@inheritDoc BaseLight.setIntensity}
+   * @override
+   */ setIntensity(val) {
+        const changed = val !== this._intensity;
+        super.setIntensity(val);
+        // The automatic range follows the intensity, and with it the culling bounds.
+        if (changed && this._range <= 0) {
+            this.invalidateBoundingVolume();
+        }
+        return this;
+    }
+    /**
    * {@inheritDoc BaseLight.isRectLight}
    * @override
    */ isRectLight() {
         return true;
     }
     /**
+   * The range actually applied: {@link range}, or the automatic one when that
+   * is 0.
+   * @internal
+   */ resolveRange() {
+        if (this._range > 0) {
+            return this._range;
+        }
+        const physical = this.scene?.lightingMode === 'physical';
+        const metersPerUnit = this.scene?.metersPerUnit ?? 1;
+        // Far from the rect its irradiance is luminance * area / d^2 - an isotropic
+        // point of intensity luminance * area - so the point light's cutoff applies.
+        const range = physical ? Math.sqrt(Math.max(0, this._luminance * this._width * this._height * metersPerUnit * metersPerUnit) / PHYSICAL_LIGHT_CUTOFF_LUX) / metersPerUnit : 32 * Math.sqrt(Math.max(0.0001, this.intensity * this._width * this._height));
+        return Math.max(range, Math.hypot(this._width, this._height));
+    }
+    /**
    * Rect light supports shadow in current pipeline
    */ /** @internal */ computeBoundingVolume() {
         const bbox = new BoundingBox();
-        const r = this._range;
+        const r = this.positionAndRange.w;
         bbox.minPoint = new Vector3(-r, -r, -r);
         bbox.maxPoint = new Vector3(r, r, r);
         return bbox;
@@ -741,7 +907,7 @@ export abstract class AmbientLight extends BaseLight {
         const pos = this.worldMatrix.getRow(3);
         const axisX = this.worldMatrix.getRow(0).inplaceNormalize().scaleBy(this._width * 0.5);
         const axisY = this.worldMatrix.getRow(1).inplaceNormalize().scaleBy(this._height * 0.5);
-        this._positionRange = new Vector4(pos.x, pos.y, pos.z, this.range);
+        this._positionRange = new Vector4(pos.x, pos.y, pos.z, this.resolveRange());
         this._directionCutoff = new Vector4(axisX.x, axisX.y, axisX.z, 0);
         const physical = this.scene?.lightingMode === 'physical';
         this._diffuseIntensity = makeColorIntensity(this.color, physical ? this.luminance : this.intensity);