@zephyr3d/scene 0.9.26 → 0.10.0

package/dist/scene/scene.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene.js","sources":["../../src/scene/scene.ts"],"sourcesContent":["import type { Matrix4x4, Nullable } from '@zephyr3d/base';\r\nimport { Vector3, Vector4, Ray, DRef, DWeakRef, makeObservable, Disposable } from '@zephyr3d/base';\r\nimport { SceneNode } from './scene_node';\r\nimport { Octree } from './octree';\r\nimport { RaycastVisitor } from './raycast_visitor';\r\nimport { Environment } from './environment';\r\nimport type { GraphNode } from './graph_node';\r\nimport type { Camera } from '../camera/camera';\r\nimport type { Drawable } from '../render';\r\nimport { SceneRenderer } from '../render';\r\nimport type { Compositor } from '../posteffect';\r\nimport type { Metadata } from 'draco3d';\r\nimport { getDevice } from '../app/api';\r\nimport type { IRenderable } from '../app';\r\nimport {\r\n  normalizeScriptAttachmentConfig,\r\n  normalizeScriptAttachments,\r\n  ScriptAttachment\r\n} from './script_attachment';\r\nimport type { LightingMode } from '../utility/physical';\r\n\r\n/**\r\n * Represents a renderable world that manages scene graph, spatial indexing, and environment.\r\n *\r\n * Core responsibilities:\r\n * - Owns the root {@link SceneNode} and maintains a spatial {@link Octree} for culling/raycasting.\r\n * - Manages environment/lighting via {@link Environment}.\r\n * - Provides per-frame update queues (global and per-camera) for scene nodes.\r\n * - Offers utilities like ray construction and raycasting.\r\n * - Emits observable events: `update`, `startrender`, `endrender`.\r\n *\r\n * Performance notes:\r\n * - Octree placement is lazily synchronized on demand before reads (e.g., `octree`, `boundingBox`)\r\n *   and during per-frame updates.\r\n * - Update queues use weak references to avoid retaining disposed nodes.\r\n *\r\n * @public\r\n */\r\nexport class Scene\r\n  extends makeObservable(Disposable)<{\r\n    /** Dispatched once per frame before render-related work. */\r\n    update: [Scene];\r\n    /** Dispatched immediately before rendering begins for a camera. */\r\n    startrender: [Scene, Camera, Compositor];\r\n    /** Dispatched immediately after rendering finishes for a camera. */\r\n    endrender: [Scene, Camera, Compositor];\r\n  }>()\r\n  implements IRenderable\r\n{\r\n  /** @internal */\r\n  private static _nextId = 0;\r\n  /** @internal Scene name. */\r\n  protected _name: string;\r\n  /** @internal Root node reference. */\r\n  protected _rootNode: DRef<SceneNode>;\r\n  /** @internal Spatial index for placement/culling. */\r\n  protected _octree: Octree;\r\n  /**\r\n   * @internal Pending nodes whose placement in the octree must be updated.\r\n   * Populated by {@link Scene.invalidateNodePlacement} and drained by {@link Scene.updateNodePlacement}.\r\n   */\r\n  protected _nodePlaceList: Set<GraphNode>;\r\n  /** @internal Environment data (sky/light/IBL). */\r\n  protected _env: Environment;\r\n  /** @internal Frame counter that last updated this scene. */\r\n  protected _updateFrame: number;\r\n  /** @internal Unique scene ID. */\r\n  protected _id: number;\r\n  /** @internal One-shot per-frame update queue (runs before render). */\r\n  protected _nodeUpdateQueue: DWeakRef<SceneNode>[];\r\n  /** @internal */\r\n  protected _drawableUpdateQueue: Drawable[];\r\n  /** @internal One-shot per-frame-per-camera update queue. */\r\n  protected _perCameraUpdateQueue: DWeakRef<SceneNode>[];\r\n  /** @internal Main camera reference. */\r\n  protected _mainCamera: DRef<Camera>;\r\n  /** @internal Arbitrary metadata loaded with the scene (optional). */\r\n  protected _metaData: Nullable<Metadata>;\r\n  /** @internal Lighting unit model used by this scene. */\r\n  protected _lightingMode: LightingMode;\r\n  /** @internal Number of physical meters represented by one scene unit. */\r\n  protected _metersPerUnit: number;\r\n  /** @internal User-attached script entries (engine-defined). */\r\n  private _scripts: ScriptAttachment[];\r\n  /**\r\n   * Creates an instance of Scene.\r\n   *\r\n   * Initializes:\r\n   * - Unique ID\r\n   * - Empty environment\r\n   * - Octree with default depth/leaf capacities\r\n   * - Root scene node named \"Root\"\r\n   *\r\n   * @param name - Optional scene name for diagnostics/UI.\r\n   */\r\n  constructor(name?: string) {\r\n    super();\r\n    this._id = ++Scene._nextId;\r\n    this._name = name ?? '';\r\n    this._octree = new Octree(this, 8, 8);\r\n    this._nodePlaceList = new Set();\r\n    this._nodeUpdateQueue = [];\r\n    this._drawableUpdateQueue = [];\r\n    this._perCameraUpdateQueue = [];\r\n    this._env = new Environment();\r\n    this._updateFrame = -1;\r\n    this._rootNode = new DRef();\r\n    this._rootNode.set(new SceneNode(this));\r\n    this._rootNode.get()!.name = 'Root';\r\n    this._metaData = null;\r\n    this._lightingMode = 'legacy';\r\n    this._metersPerUnit = 1;\r\n    this._scripts = [];\r\n    this._mainCamera = new DRef();\r\n  }\r\n  /**\r\n   * Gets the unique identifier of the scene.\r\n   */\r\n  get id() {\r\n    return this._id;\r\n  }\r\n  /**\r\n   * Name of the scene\r\n   */\r\n  get name() {\r\n    return this._name;\r\n  }\r\n  set name(val: string) {\r\n    this._name = val ?? '';\r\n  }\r\n  /**\r\n   * Main camera used to render the scene by default.\r\n   */\r\n  get mainCamera() {\r\n    return this._mainCamera.get();\r\n  }\r\n  set mainCamera(camera) {\r\n    this._mainCamera.set(camera);\r\n  }\r\n  /**\r\n   * Gets the root scene node of the scene\r\n   */\r\n  get rootNode() {\r\n    return this._rootNode.get()!;\r\n  }\r\n  /**\r\n   * Gets the octree used for spatial organization and queries.\r\n   *\r\n   * Ensures pending node placements are synchronized before returning.\r\n   */\r\n  get octree() {\r\n    // Make sure the octree state is up to date\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    return this._octree;\r\n  }\r\n  /**\r\n   * Gets the world-axis-aligned bounding box of the scene.\r\n   *\r\n   * Ensures pending node placements are synchronized before computing.\r\n   */\r\n  get boundingBox() {\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    // this._syncBVChangedList();\r\n    return this._octree.getRootNode().getBoxLoosed();\r\n  }\r\n  /**\r\n   * The environment (sky, lights, IBL) of the scene.\r\n   */\r\n  get env() {\r\n    return this._env;\r\n  }\r\n  /** Lighting unit model. Legacy remains the default for backward compatibility. */\r\n  get lightingMode() {\r\n    return this._lightingMode;\r\n  }\r\n  set lightingMode(val: LightingMode) {\r\n    const mode: LightingMode = val === 'physical' ? 'physical' : 'legacy';\r\n    if (mode !== this._lightingMode) {\r\n      this._lightingMode = mode;\r\n      this.invalidateLightUniforms();\r\n    }\r\n  }\r\n  /** Number of physical meters represented by one scene-space unit. */\r\n  get metersPerUnit() {\r\n    return this._metersPerUnit;\r\n  }\r\n  set metersPerUnit(val: number) {\r\n    const scale = Number.isFinite(val) ? Math.max(val, 0.000001) : 1;\r\n    if (scale !== this._metersPerUnit) {\r\n      this._metersPerUnit = scale;\r\n      this.invalidateLightUniforms();\r\n    }\r\n  }\r\n  /** @internal */\r\n  private invalidateLightUniforms() {\r\n    this._rootNode.get()?.iterate((node) => {\r\n      if (node.isLight()) {\r\n        node.invalidateUniforms();\r\n      }\r\n    });\r\n  }\r\n  /**\r\n   * Arbitrary metadata associated with the scene (e.g., imported asset info).\r\n   */\r\n  get metaData() {\r\n    return this._metaData;\r\n  }\r\n  set metaData(val) {\r\n    this._metaData = val;\r\n  }\r\n  /**\r\n   * Attached script filename or identifier (engine-specific).\r\n   *\r\n   * @remarks\r\n   * Integrates with the engine’s scripting system if available.\r\n   */\r\n  get script() {\r\n    return this._scripts[0]?.script ?? '';\r\n  }\r\n  set script(fileName: string) {\r\n    const script = fileName ?? '';\r\n    if (!script) {\r\n      this._scripts.splice(0, 1);\r\n    } else if (this._scripts[0]) {\r\n      this._scripts[0].script = script;\r\n    } else {\r\n      this._scripts.unshift(new ScriptAttachment(script));\r\n    }\r\n  }\r\n  /**\r\n   * Script component configuration payload used by editor/runtime script components.\r\n   */\r\n  get scriptConfig() {\r\n    return this._scripts[0]?.config ?? null;\r\n  }\r\n  set scriptConfig(value: Nullable<object | unknown[]>) {\r\n    const normalized = normalizeScriptAttachmentConfig(value);\r\n    if (this._scripts[0]) {\r\n      this._scripts[0].config = normalized;\r\n    } else if (normalized != null) {\r\n      this._scripts.unshift(new ScriptAttachment('', normalized));\r\n    }\r\n    if (this._scripts[0] && !this._scripts[0].script && this._scripts[0].config == null) {\r\n      this._scripts.splice(0, 1);\r\n    }\r\n  }\r\n  /**\r\n   * All script attachments on this scene.\r\n   */\r\n  get scripts() {\r\n    return this._scripts;\r\n  }\r\n  set scripts(value: ScriptAttachment[]) {\r\n    this._scripts = normalizeScriptAttachments(value);\r\n  }\r\n  /**\r\n   * Script configs for all script attachments.\r\n   */\r\n  get scriptConfigs() {\r\n    return this._scripts.map((item) => item.config);\r\n  }\r\n  set scriptConfigs(value: unknown[]) {\r\n    const next = Array.isArray(value) ? value : [];\r\n    for (let i = 0; i < Math.max(this._scripts.length, next.length); i++) {\r\n      const config = normalizeScriptAttachmentConfig(next[i]);\r\n      if (this._scripts[i]) {\r\n        this._scripts[i].config = config;\r\n      } else if (config != null) {\r\n        this._scripts.push(new ScriptAttachment('', config));\r\n      }\r\n    }\r\n    this._scripts = this._scripts.filter((item) => item.script || item.config != null);\r\n  }\r\n  /**\r\n   * Finds a scene node by its persistent ID.\r\n   *\r\n   * @typeParam T - Expected node type.\r\n   * @param id - Persistent identifier to match against `SceneNode.persistentId`.\r\n   * @returns The first matching node, or `null` if not found.\r\n   */\r\n  findNodeById<T extends SceneNode>(id: string) {\r\n    return this._rootNode.get()!.findNodeById<T>(id);\r\n  }\r\n  /**\r\n   * Finds a scene node by name.\r\n   *\r\n   * If multiple nodes share the same name, returns the first match encountered\r\n   * during traversal.\r\n   *\r\n   * @typeParam T - Expected node type.\r\n   * @param name - Node name to match.\r\n   * @returns The first matching node, or `null` if not found.\r\n   *\r\n   * @remarks\r\n   * Names are not guaranteed unique. Prefer IDs for stable references.\r\n   */\r\n  findNodeByName<T extends SceneNode>(name: string) {\r\n    return this._rootNode.get()!.findNodeByName<T>(name);\r\n  }\r\n  /**\r\n   * Casts a ray into the scene and returns the closest intersection, if any.\r\n   *\r\n   * @param ray - The ray in world space.\r\n   * @param length - Maximum ray length. Defaults to `Infinity`.\r\n   * @returns Intersection info `{ target, dist, point }`, or `null` if no hit.\r\n   *\r\n   */\r\n  raycast(ray: Ray, length = Infinity) {\r\n    const raycastVisitor = new RaycastVisitor(ray, length);\r\n    this.octree.getRootNode().traverse(raycastVisitor);\r\n    return raycastVisitor.intersected\r\n      ? {\r\n          target: raycastVisitor.intersected,\r\n          dist: raycastVisitor.intersectedDist,\r\n          point: raycastVisitor.intersectedPoint\r\n        }\r\n      : null;\r\n  }\r\n  /**\r\n   * Constructs a world-space ray from a camera and a screen position.\r\n   *\r\n   * @param camera - Camera whose projection/view defines the ray.\r\n   * @param viewportWidth - Current viewport width in pixels.\r\n   * @param viewportHeight - Current viewport height in pixels.\r\n   * @param screenX - Screen-space x (pixels).\r\n   * @param screenY - Screen-space y (pixels).\r\n   * @param invModelMatrix - Optional inverse model matrix to transform the ray into local space.\r\n   * @returns The constructed Ray.\r\n   *\r\n   * @remarks\r\n   * Computes NDC from screen coordinates, unprojects using `invViewProjectionMatrix`,\r\n   * then forms a ray from the camera world position to the unprojected point.\r\n   * If `invModelMatrix` is provided, both origin and direction are transformed.\r\n   */\r\n  constructRay(\r\n    camera: Camera,\r\n    viewportWidth: number,\r\n    viewportHeight: number,\r\n    screenX: number,\r\n    screenY: number,\r\n    invModelMatrix?: Matrix4x4\r\n  ) {\r\n    const vClip = new Vector4((2 * screenX) / viewportWidth - 1, 1 - (2 * screenY) / viewportHeight, 1, 1);\r\n    const vWorld = camera.invViewProjectionMatrix.transform(vClip);\r\n    vWorld.scaleBy(1 / vWorld.w);\r\n    let vEye = camera.getWorldPosition();\r\n    let vDir = Vector3.sub(vWorld.xyz(), vEye).inplaceNormalize();\r\n    if (invModelMatrix) {\r\n      vEye = invModelMatrix.transformPointAffine(vEye);\r\n      vDir = invModelMatrix.transformVectorAffine(vDir);\r\n    }\r\n    return new Ray(vEye, vDir);\r\n  }\r\n  /**\r\n   * Queues a node for a one-shot update before the next render.\r\n   *\r\n   * The node's `update(frame, elapsedSeconds, deltaSeconds)` will be called\r\n   * during Scene.frameUpdate and then the node is removed from the queue.\r\n   *\r\n   * @param node - Node to schedule.\r\n   *\r\n   * @remarks\r\n   * - To update continuously each frame, call `queueUpdateNode(this)` from within the node's `update` method.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queueUpdateNode(node: SceneNode) {\r\n    if (node && this._nodeUpdateQueue.findIndex((val) => val.get() === node) < 0) {\r\n      this._nodeUpdateQueue.push(new DWeakRef(node));\r\n    }\r\n  }\r\n  /**\r\n   * Queues a drawable for a one-shot state update before the next render.\r\n   *\r\n   * The drawable's `updateState()` will be called during Scene.frameUpdate and then the drawable is removed from the queue.\r\n   * @param drawable - Drawable to schedule.\r\n   *\r\n   * @remarks\r\n   * - To update continuously each frame, call `queueUpdateDrawable(this)` from within the drawable's `updateState` method.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queueUpdateDrawable(drawable: Drawable) {\r\n    if (drawable && this._drawableUpdateQueue.indexOf(drawable) < 0) {\r\n      this._drawableUpdateQueue.push(drawable);\r\n    }\r\n  }\r\n  /**\r\n   * Queues a node for a one-shot per-camera update before render.\r\n   *\r\n   * The node's `updatePerCamera(camera, elapsedSeconds, deltaSeconds)` will be\r\n   * called once for each camera during {@link Scene.frameUpdatePerCamera}, then removed.\r\n   *\r\n   * @param node - Node to schedule.\r\n   *\r\n   * @remarks\r\n   * - To run per-camera work continuously, re-queue from `updatePerCamera`.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queuePerCameraUpdateNode(node: SceneNode) {\r\n    if (node && this._perCameraUpdateQueue.findIndex((val) => val.get() === node) < 0) {\r\n      this._perCameraUpdateQueue.push(new DWeakRef(node));\r\n    }\r\n  }\r\n  /**\r\n   * Renders this scene using the `mainCamera`, if present.\r\n   *\r\n   * Equivalent to `mainCamera.render(this)` when `mainCamera` is set.\r\n   */\r\n  render() {\r\n    if (this.mainCamera) {\r\n      this.mainCamera.render(this);\r\n    }\r\n  }\r\n  /**\r\n   * Marks a graph node as needing placement update in the octree.\r\n   *\r\n   * Called by nodes when their transform/visibility/attachment changes in a way\r\n   * that affects spatial placement.\r\n   *\r\n   * @internal\r\n   */\r\n  invalidateNodePlacement(node: GraphNode) {\r\n    this._nodePlaceList.add(node);\r\n  }\r\n  /**\r\n   * Synchronizes environment light maps (IBL, SH/FB) with the sky as needed.\r\n   *\r\n   * Uses device capabilities to decide between Spherical Harmonics floating-point blending (SHFB)\r\n   * and classic SH textures, and lazily fills missing environment fields from the sky.\r\n   *\r\n   * @internal\r\n   */\r\n  private updateEnvLight() {\r\n    if (this.env.light.type === 'ibl') {\r\n      this.env.light.radianceMap = this.env.sky.radianceMap;\r\n      this.env.light.sheenRadianceMap = this.env.sky.sheenRadianceMap;\r\n      this.env.light.irradianceWindow = this.env.sky.shWindowWeights;\r\n      this.env.light.irradianceSHFB = this.env.sky.irradianceSHFB;\r\n      this.env.light.irradianceSH = null;\r\n    }\r\n  }\r\n  /**\r\n   * Returns the renderer class used to render the scene.\r\n   *\r\n   * Override in subclasses to supply a custom renderer.\r\n   *\r\n   * @internal\r\n   */\r\n  getRenderer() {\r\n    return SceneRenderer;\r\n  }\r\n  /**\r\n   * Performs per-frame scene updates, once per device frame.\r\n   *\r\n   * Steps:\r\n   * - Ensure this runs only once per frame (via `frameInfo.frameCounter`).\r\n   * - Update environment light synchronization.\r\n   * - Dispatch `update` event.\r\n   * - Drain the one-shot node update queue and call `node.update(...)`.\r\n   * - Apply pending octree placement updates.\r\n   *\r\n   */\r\n  frameUpdate() {\r\n    const frameInfo = getDevice().frameInfo;\r\n    if (frameInfo.frameCounter !== this._updateFrame) {\r\n      this._updateFrame = frameInfo.frameCounter;\r\n      this.updateEnvLight();\r\n      this.dispatchEvent('update', this);\r\n      this.mainCamera?.updateController();\r\n      if (this._nodeUpdateQueue.length > 0) {\r\n        const elapsedInSeconds = frameInfo.elapsedOverall * 0.001;\r\n        const deltaInSeconds = frameInfo.elapsedFrame * 0.001;\r\n        const queue = this._nodeUpdateQueue;\r\n        this._nodeUpdateQueue = [];\r\n        while (queue.length > 0) {\r\n          const ref = queue.shift()!;\r\n          const node = ref.get();\r\n          if (node?.attached) {\r\n            node.update(frameInfo.frameCounter, elapsedInSeconds, deltaInSeconds);\r\n          }\r\n          ref.dispose();\r\n        }\r\n      }\r\n      if (this._drawableUpdateQueue.length > 0) {\r\n        for (const drawable of this._drawableUpdateQueue) {\r\n          drawable.updateState();\r\n        }\r\n        this._drawableUpdateQueue = [];\r\n      }\r\n      this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    }\r\n  }\r\n  /**\r\n   * Performs per-camera scene updates for the current frame.\r\n   *\r\n   * Steps:\r\n   * - Drain the per-camera update queue and call `node.updatePerCamera(camera, ...)`.\r\n   * - Apply pending octree placement updates.\r\n   *\r\n   * @param camera - The camera being updated for.\r\n   */\r\n  frameUpdatePerCamera(camera: Camera) {\r\n    if (this._perCameraUpdateQueue.length > 0) {\r\n      const frameInfo = getDevice().frameInfo;\r\n      const elapsedInSeconds = frameInfo.elapsedOverall * 0.001;\r\n      const deltaInSeconds = frameInfo.elapsedFrame * 0.001;\r\n      const queue = this._perCameraUpdateQueue;\r\n      this._perCameraUpdateQueue = [];\r\n      while (queue.length > 0) {\r\n        const ref = queue.shift()!;\r\n        ref.get()?.updatePerCamera(camera, elapsedInSeconds, deltaInSeconds);\r\n        ref.dispose();\r\n      }\r\n    }\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n  }\r\n  /**\r\n   * Applies placement changes for nodes in `list` to the given `octree`.\r\n   *\r\n   * Rules:\r\n   * - If node is not disposed, attached, not hidden, and `placeToOctree` is true,\r\n   *   it is placed; otherwise removed.\r\n   * - Drains `list` until empty.\r\n   *\r\n   * @param octree - Target spatial index.\r\n   * @param list - Set of nodes awaiting placement evaluation.\r\n   */\r\n  updateNodePlacement(octree: Octree, list: Set<GraphNode>) {\r\n    function placeNode(node: GraphNode) {\r\n      if (!node.disposed && node.attached && !node.hidden && node.placeToOctree) {\r\n        octree.placeNode(node);\r\n      } else {\r\n        octree.removeNode(node);\r\n      }\r\n      list.delete(node);\r\n    }\r\n    if (list.size > 0) {\r\n      while (list.size > 0) {\r\n        const node = list.keys().next().value!;\r\n        if (octree) {\r\n          placeNode(node);\r\n        } else {\r\n          list.delete(node);\r\n        }\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Disposes the scene and its owned resources.\r\n   *\r\n   * Disposes:\r\n   * - Environment\r\n   * - Root node (and, by extension, its hierarchy)\r\n   * - Main camera reference wrapper\r\n   *\r\n   */\r\n  protected onDispose() {\r\n    this._env.dispose();\r\n    this._rootNode.dispose();\r\n    this._mainCamera.dispose();\r\n  }\r\n}\r\n"],"names":["Scene","makeObservable","Disposable","_nextId","name","_id","_name","_octree","Octree","_nodePlaceList","Set","_nodeUpdateQueue","_drawableUpdateQueue","_perCameraUpdateQueue","_env","Environment","_updateFrame","_rootNode","DRef","set","SceneNode","get","_metaData","_lightingMode","_metersPerUnit","_scripts","_mainCamera","id","val","mainCamera","camera","rootNode","octree","updateNodePlacement","boundingBox","getRootNode","getBoxLoosed","env","lightingMode","mode","invalidateLightUniforms","metersPerUnit","scale","Number","isFinite","Math","max","iterate","node","isLight","invalidateUniforms","metaData","script","fileName","splice","unshift","ScriptAttachment","scriptConfig","config","value","normalized","normalizeScriptAttachmentConfig","scripts","normalizeScriptAttachments","scriptConfigs","map","item","next","Array","isArray","i","length","push","filter","findNodeById","findNodeByName","raycast","ray","Infinity","raycastVisitor","RaycastVisitor","traverse","intersected","target","dist","intersectedDist","point","intersectedPoint","constructRay","viewportWidth","viewportHeight","screenX","screenY","invModelMatrix","vClip","Vector4","vWorld","invViewProjectionMatrix","transform","scaleBy","w","vEye","getWorldPosition","vDir","Vector3","sub","xyz","inplaceNormalize","transformPointAffine","transformVectorAffine","Ray","queueUpdateNode","findIndex","DWeakRef","queueUpdateDrawable","drawable","indexOf","queuePerCameraUpdateNode","render","invalidateNodePlacement","add","light","type","radianceMap","sky","sheenRadianceMap","irradianceWindow","shWindowWeights","irradianceSHFB","irradianceSH","getRenderer","SceneRenderer","frameUpdate","frameInfo","getDevice","frameCounter","updateEnvLight","dispatchEvent","updateController","elapsedInSeconds","elapsedOverall","deltaInSeconds","elapsedFrame","queue","ref","shift","attached","update","dispose","updateState","frameUpdatePerCamera","updatePerCamera","list","placeNode","disposed","hidden","placeToOctree","removeNode","delete","size","keys"],"mappings":"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"}
+{"version":3,"file":"scene.js","sources":["../../src/scene/scene.ts"],"sourcesContent":["import type { Matrix4x4, Nullable } from '@zephyr3d/base';\r\nimport { Vector3, Vector4, Ray, DRef, makeObservable, Disposable } from '@zephyr3d/base';\r\nimport { SceneNode } from './scene_node';\r\nimport { Octree } from './octree';\r\nimport { RaycastVisitor } from './raycast_visitor';\r\nimport { Environment } from './environment';\r\nimport type { GraphNode } from './graph_node';\r\nimport type { Camera } from '../camera/camera';\r\nimport type { Drawable } from '../render';\r\nimport { SceneRenderer } from '../render';\r\nimport type { Compositor } from '../posteffect';\r\nimport type { Metadata } from 'draco3d';\r\nimport { getDevice, tryGetApp } from '../app/api';\r\nimport { SkinPaletteAtlas } from '../animation/skin_palette_atlas';\r\nimport { UpdateQueue } from './update_queue';\r\nimport { AnimationBankTrack } from '../animation/animation_bank';\r\nimport type { IRenderable } from '../app';\r\nimport {\r\n  normalizeScriptAttachmentConfig,\r\n  normalizeScriptAttachments,\r\n  ScriptAttachment\r\n} from './script_attachment';\r\nimport type { LightingMode } from '../utility/physical';\r\nimport type { ScenePhysicsSettings } from './physics_settings';\r\nimport type { PhysicsWorld } from '../physics/world';\r\nimport { getPhysicsWorldFactory } from '../physics/world';\r\nimport type { VirtualTextureClient } from '../render/virtualtexture/virtual_texture_client';\r\nimport { SceneSDF } from '../render/sdf/scene_sdf';\r\nimport { SceneGI } from '../render/gi/scene_gi';\r\nimport { RenderGraphExecutor } from '../render/rendergraph/executor';\r\n\r\n/**\r\n * Represents a renderable world that manages scene graph, spatial indexing, and environment.\r\n *\r\n * Core responsibilities:\r\n * - Owns the root {@link SceneNode} and maintains a spatial {@link Octree} for culling/raycasting.\r\n * - Manages environment/lighting via {@link Environment}.\r\n * - Provides per-frame update queues (global and per-camera) for scene nodes.\r\n * - Offers utilities like ray construction and raycasting.\r\n * - Emits observable events: `update`, `startrender`, `endrender`.\r\n *\r\n * Performance notes:\r\n * - Octree placement is lazily synchronized on demand before reads (e.g., `octree`, `boundingBox`)\r\n *   and during per-frame updates.\r\n * - Update queues use weak references to avoid retaining disposed nodes.\r\n *\r\n * @public\r\n */\r\nexport class Scene\r\n  extends makeObservable(Disposable)<{\r\n    /** Dispatched once per frame before render-related work. */\r\n    update: [Scene];\r\n    /**\r\n     * Dispatched once per frame after queued nodes have updated - animation, IK,\r\n     * joint dynamics and skinning included - and before nodes are placed in the\r\n     * octree. Node transforms set here are rendered this frame; a physics world\r\n     * steps here so that kinematic bodies follow this frame's animated pose.\r\n     */\r\n    afterupdate: [Scene];\r\n    /**\r\n     * Dispatched once per frame after `afterupdate` - so after a physics world\r\n     * has stepped and written back - and after scripts' `onLateUpdate` and a\r\n     * `'late'` camera controller have run. The main camera's pose is final here:\r\n     * the place for anything that tracks the camera, such as an audio listener.\r\n     */\r\n    lateupdate: [Scene];\r\n    /** Dispatched immediately before rendering begins for a camera. */\r\n    startrender: [Scene, Camera, Compositor];\r\n    /** Dispatched immediately after rendering finishes for a camera. */\r\n    endrender: [Scene, Camera, Compositor];\r\n  }>()\r\n  implements IRenderable\r\n{\r\n  /** @internal */\r\n  private static _nextId = 0;\r\n  /** @internal Scene name. */\r\n  protected _name: string;\r\n  /** @internal Root node reference. */\r\n  protected _rootNode: DRef<SceneNode>;\r\n  /** @internal Spatial index for placement/culling. */\r\n  protected _octree: Octree;\r\n  /**\r\n   * @internal Pending nodes whose placement in the octree must be updated.\r\n   * Populated by {@link Scene.invalidateNodePlacement} and drained by {@link Scene.updateNodePlacement}.\r\n   */\r\n  protected _nodePlaceList: Set<GraphNode>;\r\n  /** @internal Environment data (sky/light/IBL). */\r\n  protected _env: Environment;\r\n  /** @internal */\r\n  protected _sdf: Nullable<SceneSDF>;\r\n  /** @internal */\r\n  protected _gi: Nullable<SceneGI>;\r\n  /** @internal Frame counter that last updated this scene. */\r\n  protected _updateFrame: number;\r\n  /** @internal Unique scene ID. */\r\n  protected _id: number;\r\n  /**\r\n   * @internal One-shot per-frame update queue (runs before render). Thousands of nodes may\r\n   * re-queue themselves every frame, so duplicates are told by a stamp on the node\r\n   */\r\n  protected _nodeUpdateQueue: UpdateQueue<SceneNode>;\r\n  /** @internal */\r\n  protected _drawableUpdateQueue: UpdateQueue<Drawable>;\r\n  /** @internal One-shot per-frame-per-camera update queue. */\r\n  protected _perCameraUpdateQueue: UpdateQueue<SceneNode>;\r\n  /** @internal Main camera reference. */\r\n  protected _mainCamera: DRef<Camera>;\r\n  /** @internal Arbitrary metadata loaded with the scene (optional). */\r\n  protected _metaData: Nullable<Metadata>;\r\n  /** @internal Physics settings saved with the scene (optional). */\r\n  protected _physicsSettings: Nullable<ScenePhysicsSettings>;\r\n  protected _physicsWorld: Nullable<PhysicsWorld>;\r\n  /** @internal Lighting unit model used by this scene. */\r\n  protected _lightingMode: LightingMode;\r\n  /** @internal Number of physical meters represented by one scene unit. */\r\n  protected _metersPerUnit: number;\r\n  /** @internal User-attached script entries (engine-defined). */\r\n  private _scripts: ScriptAttachment[];\r\n  /** @internal Virtual texture users updated by every camera rendering this scene. */\r\n  private _virtualTextureClients: VirtualTextureClient[];\r\n  /**\r\n   * Creates an instance of Scene.\r\n   *\r\n   * Initializes:\r\n   * - Unique ID\r\n   * - Empty environment\r\n   * - Octree with default depth/leaf capacities\r\n   * - Root scene node named \"Root\"\r\n   *\r\n   * @param name - Optional scene name for diagnostics/UI.\r\n   */\r\n  constructor(name?: string) {\r\n    super();\r\n    this._id = ++Scene._nextId;\r\n    this._name = name ?? '';\r\n    this._octree = new Octree(this, 8, 8);\r\n    this._nodePlaceList = new Set();\r\n    this._nodeUpdateQueue = new UpdateQueue(\r\n      (node) => node._updateQueueStamp,\r\n      (node, stamp) => (node._updateQueueStamp = stamp)\r\n    );\r\n    // Drawables made without mixinDrawable get the field on first use\r\n    this._drawableUpdateQueue = new UpdateQueue(\r\n      (drawable) => (drawable as { _drawableQueueStamp?: number })._drawableQueueStamp,\r\n      (drawable, stamp) => ((drawable as { _drawableQueueStamp?: number })._drawableQueueStamp = stamp)\r\n    );\r\n    this._perCameraUpdateQueue = new UpdateQueue(\r\n      (node) => node._perCameraQueueStamp,\r\n      (node, stamp) => (node._perCameraQueueStamp = stamp)\r\n    );\r\n    this._env = new Environment();\r\n    this._sdf = null;\r\n    this._gi = null;\r\n    this._updateFrame = -1;\r\n    this._rootNode = new DRef();\r\n    this._rootNode.set(new SceneNode(this));\r\n    this._rootNode.get()!.name = 'Root';\r\n    this._metaData = null;\r\n    this._physicsSettings = null;\r\n    this._physicsWorld = null;\r\n    this._lightingMode = 'legacy';\r\n    this._metersPerUnit = 1;\r\n    this._scripts = [];\r\n    this._virtualTextureClients = [];\r\n    this._mainCamera = new DRef();\r\n  }\r\n  /** Virtual texture users updated by every camera rendering this scene. */\r\n  get virtualTextureClients(): readonly VirtualTextureClient[] {\r\n    return this._virtualTextureClients;\r\n  }\r\n  /**\r\n   * Registers a virtual texture user. Every camera rendering the scene then updates and fills\r\n   * its pages between the depth prepass and the light pass. WebGPU only.\r\n   */\r\n  addVirtualTextureClient(client: VirtualTextureClient) {\r\n    if (!this._virtualTextureClients.includes(client)) {\r\n      this._virtualTextureClients.push(client);\r\n    }\r\n  }\r\n  /** Unregisters a virtual texture user. The client keeps ownership of its texture. */\r\n  removeVirtualTextureClient(client: VirtualTextureClient) {\r\n    const index = this._virtualTextureClients.indexOf(client);\r\n    if (index >= 0) {\r\n      this._virtualTextureClients.splice(index, 1);\r\n    }\r\n  }\r\n  /**\r\n   * Gets the unique identifier of the scene.\r\n   */\r\n  get id() {\r\n    return this._id;\r\n  }\r\n  /**\r\n   * Name of the scene\r\n   */\r\n  get name() {\r\n    return this._name;\r\n  }\r\n  set name(val: string) {\r\n    this._name = val ?? '';\r\n  }\r\n  /**\r\n   * Main camera used to render the scene by default.\r\n   */\r\n  get mainCamera() {\r\n    return this._mainCamera.get();\r\n  }\r\n  set mainCamera(camera) {\r\n    this._mainCamera.set(camera);\r\n  }\r\n  /**\r\n   * Gets the root scene node of the scene\r\n   */\r\n  get rootNode() {\r\n    return this._rootNode.get()!;\r\n  }\r\n  /**\r\n   * Gets the octree used for spatial organization and queries.\r\n   *\r\n   * Ensures pending node placements are synchronized before returning.\r\n   */\r\n  get octree() {\r\n    // Make sure the octree state is up to date\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    return this._octree;\r\n  }\r\n  /**\r\n   * Gets the world-axis-aligned bounding box of the scene.\r\n   *\r\n   * Ensures pending node placements are synchronized before computing.\r\n   */\r\n  get boundingBox() {\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    // this._syncBVChangedList();\r\n    return this._octree.getRootNode().getBoxLoosed();\r\n  }\r\n  /**\r\n   * The environment (sky, lights, IBL) of the scene.\r\n   */\r\n  get env() {\r\n    return this._env;\r\n  }\r\n  /** Signed distance field data of the scene, off until enabled. */\r\n  get sdf() {\r\n    if (!this._sdf) {\r\n      this._sdf = new SceneSDF(this);\r\n    }\r\n    return this._sdf;\r\n  }\r\n  /** Global illumination of the scene, off until enabled. */\r\n  get gi() {\r\n    if (!this._gi) {\r\n      this._gi = new SceneGI(this);\r\n    }\r\n    return this._gi;\r\n  }\r\n  /** Lighting unit model. Legacy remains the default for backward compatibility. */\r\n  get lightingMode() {\r\n    return this._lightingMode;\r\n  }\r\n  set lightingMode(val: LightingMode) {\r\n    const mode: LightingMode = val === 'physical' ? 'physical' : 'legacy';\r\n    if (mode !== this._lightingMode) {\r\n      this._lightingMode = mode;\r\n      this.invalidateLightUniforms();\r\n    }\r\n  }\r\n  /** Number of physical meters represented by one scene-space unit. */\r\n  get metersPerUnit() {\r\n    return this._metersPerUnit;\r\n  }\r\n  set metersPerUnit(val: number) {\r\n    const scale = Number.isFinite(val) ? Math.max(val, 0.000001) : 1;\r\n    if (scale !== this._metersPerUnit) {\r\n      this._metersPerUnit = scale;\r\n      this.invalidateLightUniforms();\r\n    }\r\n  }\r\n  /** @internal */\r\n  private invalidateLightUniforms() {\r\n    this._rootNode.get()?.iterate((node) => {\r\n      if (node.isLight()) {\r\n        node.invalidateUniforms();\r\n      }\r\n    });\r\n  }\r\n  /**\r\n   * Arbitrary metadata associated with the scene (e.g., imported asset info).\r\n   */\r\n  get metaData() {\r\n    return this._metaData;\r\n  }\r\n  set metaData(val) {\r\n    this._metaData = val;\r\n  }\r\n  /**\r\n   * Physics settings of the scene, or null to use the physics package's\r\n   * defaults. Only scenes simulated with a physics package need them.\r\n   */\r\n  get physicsSettings() {\r\n    return this._physicsSettings;\r\n  }\r\n  set physicsSettings(val: Nullable<ScenePhysicsSettings>) {\r\n    this._physicsSettings = val ?? null;\r\n  }\r\n  /**\r\n   * The physics simulation of this scene, or null when no physics\r\n   * implementation is loaded.\r\n   *\r\n   * @remarks\r\n   * Created the first time it is needed - when a node with physics data\r\n   * ({@link SceneNode.physics}) enters the scene, or when this is read - by the\r\n   * implementation loaded with `initPhysics`. See {@link Scene.setPhysicsWorld}\r\n   * to give the scene one directly.\r\n   */\r\n  get physicsWorld(): Nullable<PhysicsWorld> {\r\n    if (!this._physicsWorld && !this.disposed) {\r\n      const factory = getPhysicsWorldFactory();\r\n      if (factory) {\r\n        this._physicsWorld = factory(this);\r\n      }\r\n    }\r\n    return this._physicsWorld;\r\n  }\r\n  /**\r\n   * Gives the scene a physics world, replacing and disposing the current one;\r\n   * null removes it until it is next needed.\r\n   *\r\n   * @remarks\r\n   * The physics data of the scene's nodes moves to the new world.\r\n   */\r\n  setPhysicsWorld(world: Nullable<PhysicsWorld>) {\r\n    const current = this._physicsWorld;\r\n    if (current === (world ?? null)) {\r\n      return;\r\n    }\r\n    if (world && world.scene !== this) {\r\n      throw new Error('The physics world belongs to another scene.');\r\n    }\r\n    this.rootNode.iterate((node) => {\r\n      node.physics?._hostDetached();\r\n    });\r\n    this._physicsWorld = world ?? null;\r\n    current?.dispose();\r\n    if (world) {\r\n      this.rootNode.iterate((node) => {\r\n        node.physics?._hostAttached();\r\n      });\r\n    }\r\n  }\r\n  /**\r\n   * Attached script filename or identifier (engine-specific).\r\n   *\r\n   * @remarks\r\n   * Integrates with the engine’s scripting system if available.\r\n   */\r\n  get script() {\r\n    return this._scripts[0]?.script ?? '';\r\n  }\r\n  set script(fileName: string) {\r\n    const script = fileName ?? '';\r\n    if (!script) {\r\n      this._scripts.splice(0, 1);\r\n    } else if (this._scripts[0]) {\r\n      this._scripts[0].script = script;\r\n    } else {\r\n      this._scripts.unshift(new ScriptAttachment(script));\r\n    }\r\n  }\r\n  /**\r\n   * Script component configuration payload used by editor/runtime script components.\r\n   */\r\n  get scriptConfig() {\r\n    return this._scripts[0]?.config ?? null;\r\n  }\r\n  set scriptConfig(value: Nullable<object | unknown[]>) {\r\n    const normalized = normalizeScriptAttachmentConfig(value);\r\n    if (this._scripts[0]) {\r\n      this._scripts[0].config = normalized;\r\n    } else if (normalized != null) {\r\n      this._scripts.unshift(new ScriptAttachment('', normalized));\r\n    }\r\n    if (this._scripts[0] && !this._scripts[0].script && this._scripts[0].config == null) {\r\n      this._scripts.splice(0, 1);\r\n    }\r\n  }\r\n  /**\r\n   * All script attachments on this scene.\r\n   */\r\n  get scripts() {\r\n    return this._scripts;\r\n  }\r\n  set scripts(value: ScriptAttachment[]) {\r\n    this._scripts = normalizeScriptAttachments(value);\r\n  }\r\n  /**\r\n   * Script configs for all script attachments.\r\n   */\r\n  get scriptConfigs() {\r\n    return this._scripts.map((item) => item.config);\r\n  }\r\n  set scriptConfigs(value: unknown[]) {\r\n    const next = Array.isArray(value) ? value : [];\r\n    for (let i = 0; i < Math.max(this._scripts.length, next.length); i++) {\r\n      const config = normalizeScriptAttachmentConfig(next[i]);\r\n      if (this._scripts[i]) {\r\n        this._scripts[i].config = config;\r\n      } else if (config != null) {\r\n        this._scripts.push(new ScriptAttachment('', config));\r\n      }\r\n    }\r\n    this._scripts = this._scripts.filter((item) => item.script || item.config != null);\r\n  }\r\n  /**\r\n   * Finds a scene node by its persistent ID.\r\n   *\r\n   * @typeParam T - Expected node type.\r\n   * @param id - Persistent identifier to match against `SceneNode.persistentId`.\r\n   * @returns The first matching node, or `null` if not found.\r\n   */\r\n  findNodeById<T extends SceneNode>(id: string) {\r\n    return this._rootNode.get()!.findNodeById<T>(id);\r\n  }\r\n  /**\r\n   * Finds a scene node by name.\r\n   *\r\n   * If multiple nodes share the same name, returns the first match encountered\r\n   * during traversal.\r\n   *\r\n   * @typeParam T - Expected node type.\r\n   * @param name - Node name to match.\r\n   * @returns The first matching node, or `null` if not found.\r\n   *\r\n   * @remarks\r\n   * Names are not guaranteed unique. Prefer IDs for stable references.\r\n   */\r\n  findNodeByName<T extends SceneNode>(name: string) {\r\n    return this._rootNode.get()!.findNodeByName<T>(name);\r\n  }\r\n  /**\r\n   * Casts a ray into the scene and returns the closest intersection, if any.\r\n   *\r\n   * @param ray - The ray in world space.\r\n   * @param length - Maximum ray length. Defaults to `Infinity`.\r\n   * @returns Intersection info `{ target, dist, point }`, or `null` if no hit.\r\n   *\r\n   */\r\n  raycast(ray: Ray, length = Infinity) {\r\n    const raycastVisitor = new RaycastVisitor(ray, length);\r\n    this.octree.getRootNode().traverse(raycastVisitor);\r\n    return raycastVisitor.intersected\r\n      ? {\r\n          target: raycastVisitor.intersected,\r\n          dist: raycastVisitor.intersectedDist,\r\n          point: raycastVisitor.intersectedPoint\r\n        }\r\n      : null;\r\n  }\r\n  /**\r\n   * Constructs a world-space ray from a camera and a screen position.\r\n   *\r\n   * @param camera - Camera whose projection/view defines the ray.\r\n   * @param viewportWidth - Current viewport width in pixels.\r\n   * @param viewportHeight - Current viewport height in pixels.\r\n   * @param screenX - Screen-space x (pixels).\r\n   * @param screenY - Screen-space y (pixels).\r\n   * @param invModelMatrix - Optional inverse model matrix to transform the ray into local space.\r\n   * @returns The constructed Ray.\r\n   *\r\n   * @remarks\r\n   * Computes NDC from screen coordinates, unprojects using `invViewProjectionMatrix`,\r\n   * then forms a ray from the camera world position to the unprojected point.\r\n   * If `invModelMatrix` is provided, both origin and direction are transformed.\r\n   */\r\n  constructRay(\r\n    camera: Camera,\r\n    viewportWidth: number,\r\n    viewportHeight: number,\r\n    screenX: number,\r\n    screenY: number,\r\n    invModelMatrix?: Matrix4x4\r\n  ) {\r\n    const vClip = new Vector4((2 * screenX) / viewportWidth - 1, 1 - (2 * screenY) / viewportHeight, 1, 1);\r\n    const vWorld = camera.invViewProjectionMatrix.transform(vClip);\r\n    vWorld.scaleBy(1 / vWorld.w);\r\n    let vEye = camera.getWorldPosition();\r\n    let vDir = Vector3.sub(vWorld.xyz(), vEye).inplaceNormalize();\r\n    if (invModelMatrix) {\r\n      vEye = invModelMatrix.transformPointAffine(vEye);\r\n      vDir = invModelMatrix.transformVectorAffine(vDir);\r\n    }\r\n    return new Ray(vEye, vDir);\r\n  }\r\n  /**\r\n   * Queues a node for a one-shot update before the next render.\r\n   *\r\n   * The node's `update(frame, elapsedSeconds, deltaSeconds)` will be called\r\n   * during Scene.frameUpdate and then the node is removed from the queue.\r\n   *\r\n   * @param node - Node to schedule.\r\n   *\r\n   * @remarks\r\n   * - To update continuously each frame, call `queueUpdateNode(this)` from within the node's `update` method.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queueUpdateNode(node: SceneNode) {\r\n    // Only nodes of this scene, so a node waits in one update queue at most, as its stamp assumes\r\n    if (node && node.scene === this) {\r\n      this._nodeUpdateQueue.add(node);\r\n    }\r\n  }\r\n  /**\r\n   * Queues a drawable for a one-shot state update before the next render.\r\n   *\r\n   * The drawable's `updateState()` will be called during Scene.frameUpdate and then the drawable is removed from the queue.\r\n   * @param drawable - Drawable to schedule.\r\n   *\r\n   * @remarks\r\n   * - To update continuously each frame, call `queueUpdateDrawable(this)` from within the drawable's `updateState` method.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queueUpdateDrawable(drawable: Drawable) {\r\n    if (drawable && drawable.getNode()?.scene === this) {\r\n      this._drawableUpdateQueue.add(drawable);\r\n    }\r\n  }\r\n  /**\r\n   * Queues a node for a one-shot per-camera update before render.\r\n   *\r\n   * The node's `updatePerCamera(camera, elapsedSeconds, deltaSeconds)` will be\r\n   * called once for each camera during {@link Scene.frameUpdatePerCamera}, then removed.\r\n   *\r\n   * @param node - Node to schedule.\r\n   *\r\n   * @remarks\r\n   * - To run per-camera work continuously, re-queue from `updatePerCamera`.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queuePerCameraUpdateNode(node: SceneNode) {\r\n    if (node && node.scene === this) {\r\n      this._perCameraUpdateQueue.add(node);\r\n    }\r\n  }\r\n  /**\r\n   * Renders this scene using the `mainCamera`, if present.\r\n   *\r\n   * Equivalent to `mainCamera.render(this)` when `mainCamera` is set.\r\n   */\r\n  render() {\r\n    if (this.mainCamera) {\r\n      this.mainCamera.render(this);\r\n    }\r\n  }\r\n  /**\r\n   * Marks a graph node as needing placement update in the octree.\r\n   *\r\n   * Called by nodes when their transform/visibility/attachment changes in a way\r\n   * that affects spatial placement.\r\n   *\r\n   * @internal\r\n   */\r\n  invalidateNodePlacement(node: GraphNode) {\r\n    this._nodePlaceList.add(node);\r\n  }\r\n  /**\r\n   * Synchronizes environment light maps (IBL, SH/FB) with the sky as needed.\r\n   *\r\n   * Uses device capabilities to decide between Spherical Harmonics floating-point blending (SHFB)\r\n   * and classic SH textures, and lazily fills missing environment fields from the sky.\r\n   *\r\n   * @internal\r\n   */\r\n  private updateEnvLight() {\r\n    if (this.env.light.type === 'ibl') {\r\n      this.env.light.radianceMap = this.env.sky.radianceMap;\r\n      this.env.light.sheenRadianceMap = this.env.sky.sheenRadianceMap;\r\n      this.env.light.irradianceWindow = this.env.sky.shWindowWeights;\r\n      this.env.light.irradianceSHFB = this.env.sky.irradianceSHFB;\r\n      this.env.light.irradianceSH = null;\r\n    }\r\n  }\r\n  /**\r\n   * Returns the renderer class used to render the scene.\r\n   *\r\n   * Override in subclasses to supply a custom renderer.\r\n   *\r\n   * @internal\r\n   */\r\n  getRenderer() {\r\n    return SceneRenderer;\r\n  }\r\n  /**\r\n   * Performs per-frame scene updates, once per device frame.\r\n   *\r\n   * Steps:\r\n   * - Ensure this runs only once per frame (via `frameInfo.frameCounter`).\r\n   * - Update environment light synchronization.\r\n   * - Dispatch `update` event.\r\n   * - Update the main camera's controller if its `updatePhase` is `'early'`.\r\n   * - Drain the one-shot node update queue and call `node.update(...)`.\r\n   * - Dispatch `afterupdate` event; a physics world steps here.\r\n   * - Call scripts' `onLateUpdate`, then update the main camera's controller if its\r\n   *   `updatePhase` is `'late'`, then dispatch `lateupdate` event.\r\n   * - Apply pending octree placement updates.\r\n   *\r\n   */\r\n  frameUpdate() {\r\n    const frameInfo = getDevice().frameInfo;\r\n    if (frameInfo.frameCounter !== this._updateFrame) {\r\n      this._updateFrame = frameInfo.frameCounter;\r\n      this._env.wind.update(frameInfo.elapsedFrame * 0.001);\r\n      this.updateEnvLight();\r\n      const deltaInSeconds = frameInfo.elapsedFrame * 0.001;\r\n      this.dispatchEvent('update', this);\r\n      this.mainCamera?.updateController(deltaInSeconds, 'early');\r\n      if (this._nodeUpdateQueue.size > 0 || this._drawableUpdateQueue.size > 0) {\r\n        RenderGraphExecutor.profileScope('SceneUpdate', () => {\r\n          if (this._nodeUpdateQueue.size > 0) {\r\n            const elapsedInSeconds = frameInfo.elapsedOverall * 0.001;\r\n            // Nodes queued while draining are updated next frame\r\n            for (const node of this._nodeUpdateQueue.take()) {\r\n              if (!node.disposed && node.attached) {\r\n                node.update(frameInfo.frameCounter, elapsedInSeconds, deltaInSeconds);\r\n              }\r\n            }\r\n          }\r\n          if (this._drawableUpdateQueue.size > 0) {\r\n            for (const drawable of this._drawableUpdateQueue.take()) {\r\n              drawable.updateState();\r\n            }\r\n          }\r\n        });\r\n      }\r\n      this.dispatchEvent('afterupdate', this);\r\n      tryGetApp()?.engine?.lateUpdate(\r\n        deltaInSeconds,\r\n        (host) => host === this || (host instanceof SceneNode && host.scene === this)\r\n      );\r\n      this.mainCamera?.updateController(deltaInSeconds, 'late');\r\n      this.dispatchEvent('lateupdate', this);\r\n      this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n      const camera = this.mainCamera;\r\n      if (camera && (this._gi?.enabled || this._sdf?.enabled)) {\r\n        const cameraPos = camera.getWorldPosition();\r\n        // The voxel scene feeds the field's compositing, so it goes first\r\n        if (this._gi?.enabled) {\r\n          RenderGraphExecutor.profileScope('GIVoxelize', () => this._gi!.update(cameraPos, deltaInSeconds));\r\n        }\r\n        if (this._sdf?.enabled) {\r\n          RenderGraphExecutor.profileScope('SceneSDF', () => this._sdf!.update(cameraPos, deltaInSeconds));\r\n        }\r\n        // Lighting reads what the field just composited\r\n        if (this._gi?.enabled) {\r\n          RenderGraphExecutor.profileScope('GILighting', () => this._gi!.updateLighting(camera));\r\n        }\r\n      }\r\n    }\r\n    // Palettes written by animation updates are uploaded once all nodes and bank tracks are updated\r\n    RenderGraphExecutor.profileScope('Animation', () => {\r\n      AnimationBankTrack.updateAll(getDevice().frameInfo.elapsedFrame * 0.001);\r\n      SkinPaletteAtlas.flushPending();\r\n    });\r\n  }\r\n  /**\r\n   * Performs per-camera scene updates for the current frame.\r\n   *\r\n   * Steps:\r\n   * - Drain the per-camera update queue and call `node.updatePerCamera(camera, ...)`.\r\n   * - Apply pending octree placement updates.\r\n   *\r\n   * @param camera - The camera being updated for.\r\n   */\r\n  frameUpdatePerCamera(camera: Camera) {\r\n    if (this._perCameraUpdateQueue.size > 0) {\r\n      RenderGraphExecutor.profileScope('SceneUpdatePerCamera', () => {\r\n        const frameInfo = getDevice().frameInfo;\r\n        const elapsedInSeconds = frameInfo.elapsedOverall * 0.001;\r\n        const deltaInSeconds = frameInfo.elapsedFrame * 0.001;\r\n        for (const node of this._perCameraUpdateQueue.take()) {\r\n          if (!node.disposed) {\r\n            node.updatePerCamera(camera, elapsedInSeconds, deltaInSeconds);\r\n          }\r\n        }\r\n      });\r\n    }\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    SkinPaletteAtlas.flushPending();\r\n  }\r\n  /**\r\n   * Applies placement changes for nodes in `list` to the given `octree`.\r\n   *\r\n   * Rules:\r\n   * - If node is not disposed, attached, not hidden, and `placeToOctree` is true,\r\n   *   it is placed; otherwise removed.\r\n   * - Drains `list` until empty.\r\n   *\r\n   * @param octree - Target spatial index.\r\n   * @param list - Set of nodes awaiting placement evaluation.\r\n   */\r\n  updateNodePlacement(octree: Octree, list: Set<GraphNode>) {\r\n    function placeNode(node: GraphNode) {\r\n      if (!node.disposed && node.attached && !node.hidden && node.placeToOctree) {\r\n        octree.placeNode(node);\r\n      } else {\r\n        octree.removeNode(node);\r\n      }\r\n      list.delete(node);\r\n    }\r\n    if (list.size > 0) {\r\n      while (list.size > 0) {\r\n        const node = list.keys().next().value!;\r\n        if (octree) {\r\n          placeNode(node);\r\n        } else {\r\n          list.delete(node);\r\n        }\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Disposes the scene and its owned resources.\r\n   *\r\n   * Disposes:\r\n   * - Environment\r\n   * - Root node (and, by extension, its hierarchy)\r\n   * - Main camera reference wrapper\r\n   *\r\n   */\r\n  protected onDispose() {\r\n    this._nodeUpdateQueue.clear();\r\n    this._drawableUpdateQueue.clear();\r\n    this._perCameraUpdateQueue.clear();\r\n    this._env.dispose();\r\n    this._gi?.dispose();\r\n    this._gi = null;\r\n    this._sdf?.dispose();\r\n    this._sdf = null;\r\n    this._rootNode.dispose();\r\n    this._mainCamera.dispose();\r\n    this._physicsWorld?.dispose();\r\n    this._physicsWorld = null;\r\n  }\r\n}\r\n"],"names":["Scene","makeObservable","Disposable","_nextId","_physicsWorld","name","_id","_name","_octree","Octree","_nodePlaceList","Set","_nodeUpdateQueue","UpdateQueue","node","_updateQueueStamp","stamp","_drawableUpdateQueue","drawable","_drawableQueueStamp","_perCameraUpdateQueue","_perCameraQueueStamp","_env","Environment","_sdf","_gi","_updateFrame","_rootNode","DRef","set","SceneNode","get","_metaData","_physicsSettings","_lightingMode","_metersPerUnit","_scripts","_virtualTextureClients","_mainCamera","virtualTextureClients","addVirtualTextureClient","client","includes","push","removeVirtualTextureClient","index","indexOf","splice","id","val","mainCamera","camera","rootNode","octree","updateNodePlacement","boundingBox","getRootNode","getBoxLoosed","env","sdf","SceneSDF","gi","SceneGI","lightingMode","mode","invalidateLightUniforms","metersPerUnit","scale","Number","isFinite","Math","max","iterate","isLight","invalidateUniforms","metaData","physicsSettings","physicsWorld","disposed","factory","getPhysicsWorldFactory","setPhysicsWorld","world","current","scene","Error","physics","_hostDetached","dispose","_hostAttached","script","fileName","unshift","ScriptAttachment","scriptConfig","config","value","normalized","normalizeScriptAttachmentConfig","scripts","normalizeScriptAttachments","scriptConfigs","map","item","next","Array","isArray","i","length","filter","findNodeById","findNodeByName","raycast","ray","Infinity","raycastVisitor","RaycastVisitor","traverse","intersected","target","dist","intersectedDist","point","intersectedPoint","constructRay","viewportWidth","viewportHeight","screenX","screenY","invModelMatrix","vClip","Vector4","vWorld","invViewProjectionMatrix","transform","scaleBy","w","vEye","getWorldPosition","vDir","Vector3","sub","xyz","inplaceNormalize","transformPointAffine","transformVectorAffine","Ray","queueUpdateNode","add","queueUpdateDrawable","getNode","queuePerCameraUpdateNode","render","invalidateNodePlacement","light","type","radianceMap","sky","sheenRadianceMap","irradianceWindow","shWindowWeights","irradianceSHFB","irradianceSH","getRenderer","SceneRenderer","frameUpdate","frameInfo","getDevice","frameCounter","wind","update","elapsedFrame","updateEnvLight","deltaInSeconds","dispatchEvent","updateController","size","RenderGraphExecutor","profileScope","elapsedInSeconds","elapsedOverall","take","attached","updateState","tryGetApp","engine","lateUpdate","host","enabled","cameraPos","updateLighting","AnimationBankTrack","updateAll","SkinPaletteAtlas","flushPending","frameUpdatePerCamera","updatePerCamera","list","placeNode","hidden","placeToOctree","removeNode","delete","keys","clear"],"mappings":"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"}

package/dist/scene/scene_node.js

@@ -1,8 +1,9 @@
-import { makeObservable, Disposable, randomUUID, DRef, ObservableVector3, ObservableQuaternion, Matrix4x4, Vector3, Vector4 } from '@zephyr3d/base';
+import { Quaternion, makeObservable, Disposable, randomUUID, DRef, ObservableVector3, ObservableQuaternion, Matrix4x4, Vector3, Vector4 } from '@zephyr3d/base';
 import { AnimationSet } from '../animation/animationset.js';
 import { getEngine } from '../app/api.js';
 import { ScriptAttachment, normalizeScriptAttachmentConfig, normalizeScriptAttachments } from './script_attachment.js';
 
+/** Scratch for {@link SceneNode.setWorldPose}. */ const tmpQuat = new Quaternion();
 const sceneMeshAssetBindings = new WeakMap();
 /** @internal */ function setSceneMeshAssetBinding(mesh, binding) {
     sceneMeshAssetBindings.set(mesh, binding);
@@ -74,10 +75,15 @@ const sceneMeshAssetBindings = new WeakMap();
     /** @internal Scratch local matrix to avoid allocations. */ _tmpLocalMatrix;
     /** @internal Scratch world matrix to avoid allocations. */ _tmpWorldMatrix;
     /** @internal Monotonically increasing tag for transform changes. */ _transformTag;
+    /** @internal Increased each time the local transform changes */ _localTransformTag;
+    /** @internal Stamp of the scene update queue this node is waiting in, see UpdateQueue */ _updateQueueStamp;
+    /** @internal Stamp of the scene per-camera update queue this node is waiting in */ _perCameraQueueStamp;
     /** @internal Shared callback used by observables on transform mutation. */ _transformChangeCallback;
     /** @internal Arbitrary metadata payload for this node. */ _metaData;
     /** @internal If greater than zero, suppress transform-change callbacks (during bulk updates). */ _disableCallback;
     /** @internal User-attached script entries (engine-defined). */ _scripts;
+    /** @internal Serialized GPU cloth components owned by this node. */ _gpuClothComponents;
+    /** @internal Physics data of this node. */ _physics;
     /**
    * Construct a scene node.
    *
@@ -119,10 +125,15 @@ const sceneMeshAssetBindings = new WeakMap();
         this._invWorldMatrix = null;
         this._localMatrix = null;
         this._transformTag = 0;
+        this._localTransformTag = 0;
+        this._updateQueueStamp = 0;
+        this._perCameraQueueStamp = 0;
         this._disableCallback = 0;
         this._tmpLocalMatrix = Matrix4x4.identity();
         this._tmpWorldMatrix = Matrix4x4.identity();
         this._scripts = [];
+        this._gpuClothComponents = [];
+        this._physics = null;
         this._metaData = null;
         this._parent = null;
         this.reparent(scene?.rootNode ?? null);
@@ -279,6 +290,71 @@ const sceneMeshAssetBindings = new WeakMap();
         }
         this._scripts = this._scripts.filter((item)=>item.script || item.config != null);
     }
+    /** GPU cloth simulations owned by this node. */ get gpuClothComponents() {
+        return this._gpuClothComponents;
+    }
+    set gpuClothComponents(value) {
+        const next = [
+            ...new Set((value ?? []).filter((component)=>!!component && !component.disposed))
+        ];
+        for (const component of next){
+            if (component.host && component.host !== this) {
+                throw new Error('GPU cloth component belongs to another scene node.');
+            }
+        }
+        for (const component of this._gpuClothComponents){
+            if (!next.includes(component)) {
+                component.detach(this);
+                component.dispose();
+            }
+        }
+        this._gpuClothComponents = next;
+        for (const component of next){
+            if (!component.host) {
+                component.attach(this);
+            }
+        }
+    }
+    /**
+   * Physics data of this node - rigid body, colliders, joint, vehicle, wheel -
+   * or null.
+   *
+   * @remarks
+   * Simulated by the scene's physics world ({@link Scene.physicsWorld}) while
+   * the node is in a scene that has one; otherwise it is only kept, saved and
+   * loaded. Replacing it disposes the previous data.
+   */ get physics() {
+        return this._physics;
+    }
+    set physics(value) {
+        const current = this._physics;
+        if (current === (value ?? null)) {
+            return;
+        }
+        if (value?.node && value.node !== this) {
+            throw new Error('Physics data already belongs to another scene node.');
+        }
+        this._physics = value ?? null;
+        if (current) {
+            current._setNode(null);
+            current.dispose();
+        }
+        value?._setNode(this);
+    }
+    /** Adds a GPU cloth component to this node. */ addGPUClothComponent(component) {
+        this.gpuClothComponents = [
+            ...this._gpuClothComponents,
+            component
+        ];
+        return component;
+    }
+    /** Removes and disposes a GPU cloth component from this node. */ removeGPUClothComponent(component) {
+        if (!this._gpuClothComponents.includes(component)) {
+            return false;
+        }
+        this.gpuClothComponents = this._gpuClothComponents.filter((item)=>item !== component);
+        return true;
+    }
     /**
    * Display name of the node (for UI/debugging).
    */ get name() {
@@ -855,6 +931,11 @@ const sceneMeshAssetBindings = new WeakMap();
     /** Get called when the node was just created by cloning from other node */ onPostClone() {}
     /** Disposes the node */ onDispose() {
         super.onDispose();
+        for (const component of this._gpuClothComponents.splice(0)){
+            component.detach(this);
+            component.dispose();
+        }
+        this.physics = null;
         this.remove();
         this.removeChildren();
         this._animationSet.dispose();
@@ -896,21 +977,29 @@ const sceneMeshAssetBindings = new WeakMap();
         }
     }
     /** @internal */ _onTransformChanged(invalidateLocal) {
+        if (invalidateLocal) {
+            this._localTransformTag++;
+        }
         if (this._disableCallback > 0) {
             return;
         }
         if (invalidateLocal) {
             this._localMatrix = null;
         }
-        // A synchronized subtree is invalidated recursively below, so each node can
-        // update its own placement once instead of rescanning all descendants here.
-        this.invalidateWorldBoundingVolume(!this._worldMatrix);
-        this.dispatchEvent('transformchanged', this);
-        if (this._worldMatrix) {
+        // Drop the cached world matrices before any listener runs, so one reading the
+        // world matrix or bounding volume from an event sees the new transform
+        const hadWorldMatrix = !!this._worldMatrix;
+        if (hadWorldMatrix) {
             this._transformTag++;
             this._worldMatrix = null;
             this._invWorldMatrix = null;
             this._worldMatrixDet = null;
+        }
+        // A synchronized subtree is invalidated recursively below, so each node can
+        // update its own placement once instead of rescanning all descendants here.
+        this.invalidateWorldBoundingVolume(!hadWorldMatrix);
+        this.dispatchEvent('transformchanged', this);
+        if (hadWorldMatrix) {
             for (const child of this._children){
                 child.get()._onTransformChanged(false);
             }
@@ -926,10 +1015,18 @@ const sceneMeshAssetBindings = new WeakMap();
         this.iterate((child)=>{
             this.scene.queueUpdateNode(child);
             child._onAttached();
+            for (const component of child._gpuClothComponents){
+                component.hostAttached();
+            }
+            child._physics?._hostAttached();
         });
     }
     /** @internal */ _detached() {
         this.iterate((child)=>{
+            for (const component of child._gpuClothComponents){
+                component.hostDetached();
+            }
+            child._physics?._hostDetached();
             child._onDetached();
         });
     }
@@ -1038,6 +1135,42 @@ const sceneMeshAssetBindings = new WeakMap();
         this._onTransformChanged(true);
         return this;
     }
+    /**
+   * Sets the node's local transform so that its world position and rotation
+   * become the given ones.
+   *
+   * @remarks
+   * Used to write back poses computed in world space, by a physics engine for
+   * instance. Either argument may be omitted to keep that part. Local scale is
+   * kept. The rotation is exact only when no ancestor has a non-uniform scale,
+   * which would make the world rotation a shear. The transform-changed
+   * notification fires once.
+   *
+   * @param position - World position, or null to keep the current one.
+   * @param rotation - World rotation, or null to keep the current one.
+   * @returns self
+   */ setWorldPose(position, rotation) {
+        const parent = this._parent;
+        this._disableCallback++;
+        if (position) {
+            if (parent) {
+                parent.invWorldMatrix.transformPointAffine(position, this._position);
+            } else {
+                this._position.set(position);
+            }
+        }
+        if (rotation) {
+            if (parent) {
+                parent.worldMatrix.decompose(null, tmpQuat, null);
+                Quaternion.multiply(Quaternion.inverse(tmpQuat, tmpQuat), rotation, this._rotation);
+            } else {
+                this._rotation.set(rotation);
+            }
+        }
+        this._disableCallback--;
+        this._onTransformChanged(true);
+        return this;
+    }
     /** Local transformation matrix of the xform */ get localMatrix() {
         if (!this._localMatrix) {
             this.calculateLocalTransform(this._tmpLocalMatrix);
@@ -1122,6 +1255,14 @@ const sceneMeshAssetBindings = new WeakMap();
     /** @internal */ get transformTag() {
         return this._transformTag;
     }
+    /**
+   * Increased each time the local transform changes, unlike {@link transformTag} which also
+   * follows the ancestors
+   *
+   * @internal
+   */ get localTransformTag() {
+        return this._localTransformTag;
+    }
     /** @internal */ syncTransform() {
         if (!this._worldMatrix) {
             this._worldMatrix = this._tmpWorldMatrix;