@zephyr3d/scene 0.9.19 → 0.9.21

package/dist/render/rendergraph/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../src/render/rendergraph/types.ts"],"sourcesContent":["import type { AbstractDevice, TextureFormat, TimestampQueryStatus } from '@zephyr3d/device';\r\n\r\n// ─── Resource Descriptors ───────────────────────────────────────────────\r\n\r\n/**\r\n * Sizing mode for render graph textures.\r\n *\r\n * - 'absolute': fixed pixel dimensions\r\n * - 'backbuffer-relative': scaled relative to the backbuffer size\r\n *\r\n * @public\r\n */\r\nexport type RGSizeMode = 'absolute' | 'backbuffer-relative';\r\n\r\n/**\r\n * Descriptor for a transient texture resource within the render graph.\r\n *\r\n * Transient textures are allocated and released automatically by the graph compiler.\r\n *\r\n * @public\r\n */\r\nexport interface RGTextureDesc {\r\n  /** Debug label for this resource. */\r\n  label?: string;\r\n  /** Texture format (e.g. 'rgba8unorm', 'r32f', 'rgba16f'). */\r\n  format: TextureFormat;\r\n  /** Sizing mode. Default 'backbuffer-relative'. */\r\n  sizeMode?: RGSizeMode;\r\n  /** Width in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  width?: number;\r\n  /** Height in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  height?: number;\r\n  /** Number of mip levels. Default 1. */\r\n  mipLevels?: number;\r\n}\r\n\r\n// ─── Handles ────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Opaque handle referencing a resource within the render graph.\r\n *\r\n * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RGPassBuilder.createFramebuffer},\r\n * {@link RenderGraph.importTexture}, or {@link RGPassBuilder.write}. They are lightweight identifiers\r\n * used to declare dependencies between passes.\r\n *\r\n * @public\r\n */\r\nexport class RGHandle {\r\n  /** @internal */\r\n  readonly _id: number;\r\n  /** @internal */\r\n  readonly _name: string;\r\n\r\n  /** @internal */\r\n  constructor(id: number, name: string) {\r\n    this._id = id;\r\n    this._name = name;\r\n  }\r\n\r\n  /** Debug-friendly name of the referenced resource. */\r\n  get name(): string {\r\n    return this._name;\r\n  }\r\n}\r\n\r\n// ─── Internal Resource Tracking ─────────────────────────────────────────\r\n\r\n/** @public */\r\nexport type RGResourceKind = 'transient' | 'imported' | 'token' | 'framebuffer';\r\n\r\n/**\r\n * Internal bookkeeping for a resource within the render graph.\r\n * @public\r\n */\r\nexport class RGResource {\r\n  readonly id: number;\r\n  readonly name: string;\r\n  readonly kind: RGResourceKind;\r\n  readonly desc: RGTextureDesc | RGFramebufferDesc | null;\r\n  /** Resource ID of the physical backing resource used by imported versions. */\r\n  readonly physicalId: number;\r\n  /** The pass that creates / writes this resource (null for imported until written). */\r\n  producer: RGPass | null = null;\r\n  /** Passes that read this resource. */\r\n  readonly consumers: RGPass[] = [];\r\n\r\n  constructor(\r\n    id: number,\r\n    name: string,\r\n    kind: RGResourceKind,\r\n    desc: RGTextureDesc | RGFramebufferDesc | null,\r\n    physicalId = id\r\n  ) {\r\n    this.id = id;\r\n    this.name = name;\r\n    this.kind = kind;\r\n    this.desc = desc;\r\n    this.physicalId = physicalId;\r\n  }\r\n}\r\n\r\n// ─── Internal Pass Tracking ─────────────────────────────────────────────\r\n\r\n// ─── Execution Context ──────────────────────────────────────────────\r\n\r\n/**\r\n * Context passed to pass execute callbacks during graph execution.\r\n *\r\n * Provides access to resolved GPU resources by their handles.\r\n *\r\n * @public\r\n */\r\nexport interface RGExecuteContext {\r\n  /**\r\n   * Resolve a handle to the actual GPU texture object.\r\n   *\r\n   * For transient resources, this returns the texture allocated by the executor.\r\n   * For imported resources, this returns the texture registered via\r\n   * {@link RenderGraphExecutor.setImportedTexture}. The handle must be declared\r\n   * by the current pass with {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.\r\n   *\r\n   * @param handle - Handle of the resource to resolve.\r\n   * @returns The resolved texture object (type depends on the allocator).\r\n   */\r\n  getTexture<TTexture = unknown>(handle: RGHandle): TTexture;\r\n\r\n  /**\r\n   * Resolve a framebuffer handle to the actual backend framebuffer object.\r\n   *\r\n   * The handle must be declared by the current pass with {@link RGPassBuilder.read}\r\n   * or created by the same pass with {@link RGPassBuilder.createFramebuffer}.\r\n   *\r\n   * @param handle - Handle returned from {@link RGPassBuilder.createFramebuffer}.\r\n   * @returns The resolved framebuffer object (type depends on the allocator).\r\n   */\r\n  getFramebuffer<TFramebuffer = unknown>(handle: RGHandle): TFramebuffer;\r\n\r\n  /**\r\n   * Create a temporary framebuffer managed by the graph executor.\r\n   *\r\n   * The framebuffer is released automatically when graph execution finishes or\r\n   * aborts. Attachments may be actual backend resources or texture formats,\r\n   * depending on the allocator implementation. If an attachment is an\r\n   * {@link RGHandle}, the current pass must declare it with\r\n   * {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns The allocated framebuffer object (type depends on the allocator).\r\n   */\r\n  createFramebuffer<TFramebuffer = unknown>(desc: RGFramebufferDesc): TFramebuffer;\r\n\r\n  /**\r\n   * Register a cleanup callback to run when graph execution finishes or aborts.\r\n   *\r\n   * Callbacks run in reverse registration order. Use this for temporary objects\r\n   * created inside pass execution that are not graph resources, such as pooled\r\n   * framebuffers wrapping graph-managed textures. If pass execution throws, the\r\n   * executor still runs cleanup callbacks and preserves the original pass error\r\n   * ahead of cleanup errors.\r\n   *\r\n   * @param callback - Cleanup function to invoke after execution.\r\n   */\r\n  deferCleanup(callback: () => void): void;\r\n}\r\n\r\n/**\r\n * Execute callback signature.\r\n *\r\n * The callback receives a context for resolving handles to GPU resources,\r\n * plus the user data returned from the setup function.\r\n *\r\n * @public\r\n */\r\nexport type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;\r\n\r\n/**\r\n * Ordered execution step inside a render graph pass.\r\n *\r\n * Subpasses share the parent pass's resource declarations, lifetime, culling,\r\n * and access validation. They are intended to make multi-step pass bodies\r\n * explicit without splitting graph-level resource dependencies.\r\n *\r\n * @public\r\n */\r\nexport class RGSubpass<T = unknown> {\r\n  readonly name: string;\r\n  readonly executeFn: RGExecuteFn<T>;\r\n\r\n  constructor(name: string, executeFn: RGExecuteFn<T>) {\r\n    this.name = name;\r\n    this.executeFn = executeFn;\r\n  }\r\n}\r\n\r\n/**\r\n * Internal bookkeeping for a pass within the render graph.\r\n * @public\r\n */\r\nexport class RGPass<T = unknown> {\r\n  readonly index: number;\r\n  readonly name: string;\r\n  /** Resources this pass reads (dependencies). */\r\n  readonly reads: RGResource[] = [];\r\n  /** Resources this pass creates or writes. */\r\n  readonly writes: RGResource[] = [];\r\n  /** Passes that must complete before this pass due to non-resource hazards. */\r\n  readonly dependencies: RGPass[] = [];\r\n  /** Whether this pass has side effects and must not be culled. */\r\n  hasSideEffect = false;\r\n  /** User data returned from the setup function. */\r\n  data: T | null = null;\r\n  /** Execute callback. */\r\n  executeFn: RGExecuteFn<T> | null = null;\r\n  /** Ordered subpasses for passes with multiple logical execution steps. */\r\n  readonly subpasses: RGSubpass<T>[] = [];\r\n  /** Set during compilation: true if this pass is needed. */\r\n  alive = true;\r\n\r\n  constructor(index: number, name: string) {\r\n    this.index = index;\r\n    this.name = name;\r\n  }\r\n}\r\n\r\n// ─── Pass Builder ───────────────────────────────────────────────────────\r\n\r\n/**\r\n * Builder interface used within the setup callback of {@link RenderGraph.addPass}\r\n * to declare a pass's resource requirements.\r\n *\r\n * @public\r\n */\r\nexport interface RGPassBuilder {\r\n  /**\r\n   * Declare a read dependency on an existing resource.\r\n   *\r\n   * The resource must have been created by a prior pass or imported into the graph.\r\n   *\r\n   * @param handle - Handle of the resource to read.\r\n   */\r\n  read(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Declare that this pass writes a new version of an existing resource.\r\n   *\r\n   * The returned handle represents the post-write version. Use it for subsequent\r\n   * reads and as the graph output passed to {@link RenderGraph.compile}. Passing\r\n   * an older version of the same resource to `compile()` is rejected because it\r\n   * usually means the caller ignored the handle returned by `write()`. If the pass\r\n   * needs the previous contents, call {@link RGPassBuilder.read} on the input handle explicitly\r\n   * before writing.\r\n   *\r\n   * @param handle - Handle of the resource to write to.\r\n   * @returns A handle referencing the newly written version.\r\n   */\r\n  write(handle: RGHandle): RGHandle;\r\n\r\n  /**\r\n   * Create a new transient texture resource that this pass will produce.\r\n   *\r\n   * @param desc - Texture descriptor.\r\n   * @returns A handle referencing the newly created resource.\r\n   */\r\n  createTexture(desc: RGTextureDesc): RGHandle;\r\n\r\n  /**\r\n   * Create a logical dependency token produced by this pass.\r\n   *\r\n   * Tokens do not resolve to GPU resources and are not allocated by the executor.\r\n   * They are useful for ordering passes whose dependencies are side effects rather\r\n   * than texture reads/writes.\r\n   *\r\n   * @param name - Debug label for this token.\r\n   * @returns A handle referencing the newly created token.\r\n   */\r\n  createToken(name?: string): RGHandle;\r\n\r\n  /**\r\n   * Create a graph-managed framebuffer view.\r\n   *\r\n   * The graph compiler infers dependencies from any attachment handles in the\r\n   * descriptor. The executor creates and releases the framebuffer automatically.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns A handle referencing the framebuffer view.\r\n   */\r\n  createFramebuffer(desc: RGFramebufferDesc): RGHandle;\r\n\r\n  /**\r\n   * Mark this pass as having side effects.\r\n   *\r\n   * Side-effect passes are never culled by the graph compiler, regardless of\r\n   * whether their outputs are consumed. Use this for GPU readback, picking,\r\n   * debug overlays, etc.\r\n   */\r\n  sideEffect(): void;\r\n\r\n  /**\r\n   * Add an ordered logical subpass to this pass.\r\n   *\r\n   * Subpasses execute in registration order and share the parent pass's declared\r\n   * reads, writes, framebuffer views, and user data. A pass may use either\r\n   * subpasses or {@link RGPassBuilder.setExecute}, but not both.\r\n   *\r\n   * @param name - Debug label for the subpass.\r\n   * @param fn - Callback invoked when this subpass executes.\r\n   */\r\n  addSubpass<D>(name: string, fn: RGExecuteFn<D>): void;\r\n\r\n  /**\r\n   * Set the execution callback for this pass.\r\n   *\r\n   * A pass may use either this method or {@link RGPassBuilder.addSubpass}, but not both.\r\n   *\r\n   * @param fn - Callback invoked during graph execution.\r\n   */\r\n  setExecute<D>(fn: RGExecuteFn<D>): void;\r\n}\r\n\r\n// ─── Compiled Graph ─────────────────────────────────────────────────────\r\n\r\n/**\r\n * Lifetime information for a resource within the compiled graph.\r\n *\r\n * @public\r\n */\r\nexport interface RGResourceLifetime {\r\n  /** The resource. */\r\n  readonly resource: RGResource;\r\n  /** Index of the first pass that uses (produces or reads) this resource. */\r\n  readonly firstUse: number;\r\n  /** Index of the last pass that uses this resource. */\r\n  readonly lastUse: number;\r\n}\r\n\r\n/**\r\n * Result of compiling a render graph.\r\n *\r\n * Contains the ordered list of passes to execute and lifetime information\r\n * for automatic resource management.\r\n *\r\n * @public\r\n */\r\nexport interface CompiledRenderGraph {\r\n  /** Topologically sorted passes (only non-culled passes). */\r\n  readonly orderedPasses: ReadonlyArray<RGPass>;\r\n  /** Resource lifetime information keyed by resource ID. */\r\n  readonly lifetimes: ReadonlyMap<number, RGResourceLifetime>;\r\n}\r\n\r\n/**\r\n * Profiling scope type in a render graph timing tree.\r\n * @public\r\n */\r\nexport type RGProfileScopeType = 'graph' | 'pass' | 'subpass';\r\n\r\n/**\r\n * Render graph GPU timestamp profiling options.\r\n * @public\r\n */\r\nexport interface RGProfilingOptions {\r\n  /** Enable render graph timestamp profiling. Default true when an options object is provided. */\r\n  enabled?: boolean;\r\n  /** Measure the whole graph execution. Default true. */\r\n  graph?: boolean;\r\n  /** Measure every render graph pass. Default true. */\r\n  pass?: boolean;\r\n  /** Measure every subpass and expose it as a child scope. Default true. */\r\n  subpass?: boolean;\r\n  /** Include pending upload/copy commands at timestamp boundaries. Default true. */\r\n  includePendingUploads?: boolean;\r\n  /** Allow graph profile scopes to remain open across frame boundaries. Default false. */\r\n  allowCrossFrame?: boolean;\r\n  /** Maximum unresolved profile frames kept by the executor. Default 3. */\r\n  maxPendingFrames?: number;\r\n  /** Root graph profile label. Default 'RenderGraph'. */\r\n  label?: string;\r\n  /** Device used for timestamp queries. If omitted, the scene global getDevice() is used. */\r\n  device?: AbstractDevice;\r\n}\r\n\r\n/**\r\n * Render graph executor construction options.\r\n * @public\r\n */\r\nexport interface RenderGraphExecutorOptions {\r\n  /** Device used for timestamp queries. If omitted, the scene global getDevice() is used. */\r\n  device?: AbstractDevice;\r\n  /** Render graph timestamp profiling options. Default false. */\r\n  profiling?: boolean | RGProfilingOptions;\r\n}\r\n\r\n/**\r\n * Resolved GPU timing for one graph/pass/subpass scope.\r\n * @public\r\n */\r\nexport interface RGProfileScopeResult {\r\n  /** Scope label. */\r\n  name: string;\r\n  /** Scope type. */\r\n  type: RGProfileScopeType;\r\n  /** Timestamp query id used by the device, or 0 for synthetic/unsupported scopes. */\r\n  queryId: number;\r\n  /** GPU duration in milliseconds. */\r\n  durationMs: number;\r\n  /** Timestamp result status. */\r\n  status: TimestampQueryStatus;\r\n  /** Child scopes. */\r\n  children: RGProfileScopeResult[];\r\n  /** Optional diagnostic message. */\r\n  message?: string;\r\n}\r\n\r\n/**\r\n * Resolved GPU timing tree for one render graph execution.\r\n * @public\r\n */\r\nexport interface RGProfileResult {\r\n  /** Render frame id when profiling began. */\r\n  frameId: number;\r\n  /** Aggregate profile status. */\r\n  status: TimestampQueryStatus;\r\n  /** Root graph scope. */\r\n  graph: RGProfileScopeResult;\r\n  /** Top-level pass scopes. Same objects as graph.children. */\r\n  passes: RGProfileScopeResult[];\r\n}\r\n\r\n// ─── Texture Allocator ──────────────────────────────────────────────\r\n\r\n/**\r\n * Resolved dimensions for a texture allocation.\r\n * @public\r\n */\r\nexport interface RGResolvedSize {\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\n/**\r\n * Descriptor for a framebuffer view managed by the graph or created temporarily during pass execution.\r\n *\r\n * This is intentionally backend-agnostic: graph-managed descriptors may use\r\n * {@link RGHandle} attachments, and executor-created descriptors use resolved\r\n * resources or texture formats understood by the allocator.\r\n *\r\n * @public\r\n */\r\nexport interface RGFramebufferDesc {\r\n  /** Debug label for this framebuffer. */\r\n  label?: string;\r\n  /** Framebuffer width. Required when attachments are formats. */\r\n  width?: number;\r\n  /** Framebuffer height. Required when attachments are formats. */\r\n  height?: number;\r\n  /** Color attachments or formats. */\r\n  colorAttachments: unknown | unknown[] | null;\r\n  /** Depth/stencil attachment or format. */\r\n  depthAttachment?: unknown | null;\r\n  /** Whether color attachments created from formats should support mipmapping. */\r\n  mipmapping?: boolean;\r\n  /** Framebuffer sample count. */\r\n  sampleCount?: number;\r\n  /** Whether to ignore depth/stencil during MSAA resolve. */\r\n  ignoreDepthStencil?: boolean;\r\n  /** Attachment mip level. */\r\n  attachmentMipLevel?: number;\r\n  /** Attachment cubemap face. */\r\n  attachmentCubeface?: number;\r\n  /** Attachment array layer. */\r\n  attachmentLayer?: number;\r\n}\r\n\r\n/**\r\n * Interface for allocating and releasing transient textures.\r\n *\r\n * Implement this to bridge the render graph with your GPU device's resource pool.\r\n * The executor calls `allocate()` before a resource's first use and\r\n * `release()` after its last use.\r\n *\r\n * Lifetime contract: the graph compiler extends a texture's lifetime to cover\r\n * every graph-managed framebuffer it is attached to, and the executor releases\r\n * framebuffers before textures at the same pass boundary. Allocators may\r\n * therefore assume `releaseFramebuffer()` is called before `release()` of its\r\n * attachments, and must keep a released framebuffer's attachments intact until\r\n * their own `release()` call.\r\n *\r\n * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).\r\n * @public\r\n */\r\nexport interface RGTextureAllocator<TTexture = unknown, TFramebuffer = unknown> {\r\n  /**\r\n   * Allocate a transient texture matching the given descriptor and resolved size.\r\n   *\r\n   * @param desc - The texture descriptor from the pass builder.\r\n   * @param size - The resolved pixel dimensions.\r\n   * @returns The allocated texture object.\r\n   */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize): TTexture;\r\n\r\n  /**\r\n   * Release a previously allocated transient texture back to the pool.\r\n   *\r\n   * @param texture - The texture to release.\r\n   */\r\n  release(texture: TTexture): void;\r\n\r\n  /**\r\n   * Retain a texture allocated by this allocator so it can outlive the graph pass\r\n   * that produced it.\r\n   *\r\n   * This is used when a graph-produced transient texture must be handed off to\r\n   * an external owner, such as a cross-frame history resource. Executors still\r\n   * release the graph's own reference at the resource's last use; the external\r\n   * owner must later call {@link RGTextureAllocator.release} for the retained\r\n   * reference.\r\n   *\r\n   * Allocators that cannot retain transient textures should leave this undefined.\r\n   */\r\n  retain?(texture: TTexture): void;\r\n\r\n  /**\r\n   * Allocate a temporary framebuffer matching the given descriptor.\r\n   *\r\n   * Implementations should not auto-release this framebuffer; the graph executor\r\n   * calls {@link RGTextureAllocator.releaseFramebuffer} when execution completes or aborts.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns The allocated framebuffer object.\r\n   */\r\n  allocateFramebuffer?(desc: RGFramebufferDesc): TFramebuffer;\r\n\r\n  /**\r\n   * Release a previously allocated temporary framebuffer.\r\n   *\r\n   * @param framebuffer - The framebuffer to release.\r\n   */\r\n  releaseFramebuffer?(framebuffer: TFramebuffer): void;\r\n}\r\n"],"names":["RGHandle","id","name","_id","_name","RGResource","kind","desc","producer","consumers","physicalId","RGSubpass","executeFn","RGPass","index","reads","writes","dependencies","hasSideEffect","data","subpasses","alive"],"mappings":"AAoCA;AAEA;;;;;;;;AAQC,IACM,MAAMA,QAAAA,CAAAA;qBAEX,GAAqB;qBAErB,KAAuB;AAEvB,qBACA,WAAA,CAAYC,EAAU,EAAEC,IAAY,CAAE;QACpC,IAAI,CAACC,GAAG,GAAGF,EAAAA;QACX,IAAI,CAACG,KAAK,GAAGF,IAAAA;AACf;2DAGA,IAAIA,IAAe,GAAA;QACjB,OAAO,IAAI,CAACE,KAAK;AACnB;AACF;AAOA;;;AAGC,IACM,MAAMC,UAAAA,CAAAA;IACFJ,EAAW;IACXC,IAAa;IACbI,IAAqB;IACrBC,IAA+C;mFAExD,UAA4B;2FAE5BC,WAA0B,IAAK;AAC/B,2CACSC,SAAsB,GAAA,EAAE;IAEjC,WACER,CAAAA,EAAU,EACVC,IAAY,EACZI,IAAoB,EACpBC,IAA8C,EAC9CG,UAAaT,GAAAA,EAAE,CACf;QACA,IAAI,CAACA,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACG,UAAU,GAAGA,UAAAA;AACpB;AACF;AA4EA;;;;;;;;AAQC,IACM,MAAMC,SAAAA,CAAAA;IACFT,IAAa;IACbU,SAA0B;IAEnC,WAAYV,CAAAA,IAAY,EAAEU,SAAyB,CAAE;QACnD,IAAI,CAACV,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACU,SAAS,GAAGA,SAAAA;AACnB;AACF;AAEA;;;AAGC,IACM,MAAMC,MAAAA,CAAAA;IACFC,KAAc;IACdZ,IAAa;AACtB,qDACSa,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;AAClC,mFACSC,YAAyB,GAAA,EAAE;sEAEpCC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBP,YAAmC,IAAK;AACxC,+EACSQ,SAA4B,GAAA,EAAE;gEAEvCC,QAAQ,IAAK;IAEb,WAAYP,CAAAA,KAAa,EAAEZ,IAAY,CAAE;QACvC,IAAI,CAACY,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACZ,IAAI,GAAGA,IAAAA;AACd;AACF;;;;"}
+{"version":3,"file":"types.js","sources":["../../../src/render/rendergraph/types.ts"],"sourcesContent":["import type { AbstractDevice, TextureFormat, TimestampQueryStatus } from '@zephyr3d/device';\r\n\r\n// ─── Resource Descriptors ───────────────────────────────────────────────\r\n\r\n/**\r\n * Sizing mode for render graph textures.\r\n *\r\n * - 'absolute': fixed pixel dimensions\r\n * - 'backbuffer-relative': scaled relative to the backbuffer size\r\n *\r\n * @public\r\n */\r\nexport type RGSizeMode = 'absolute' | 'backbuffer-relative';\r\n\r\n/**\r\n * Descriptor for a transient texture resource within the render graph.\r\n *\r\n * Transient textures are allocated and released automatically by the graph compiler.\r\n *\r\n * @public\r\n */\r\nexport interface RGTextureDesc {\r\n  /** Debug label for this resource. */\r\n  label?: string;\r\n  /** Texture format (e.g. 'rgba8unorm', 'r32f', 'rgba16f'). */\r\n  format: TextureFormat;\r\n  /** Sizing mode. Default 'backbuffer-relative'. */\r\n  sizeMode?: RGSizeMode;\r\n  /** Width in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  width?: number;\r\n  /** Height in pixels (absolute) or scale factor (backbuffer-relative, default 1.0). */\r\n  height?: number;\r\n  /** Number of mip levels. Default 1. */\r\n  mipLevels?: number;\r\n  /**\r\n   * Number of array layers. When omitted, a plain 2D texture is allocated. When\r\n   * defined (including 1), the allocator produces a 2D array texture — a\r\n   * single-layer array is a distinct texture type from a 2D texture and is not\r\n   * interchangeable when bound to a `tex2DArray` sampler. Individual layers can be\r\n   * targeted as framebuffer color attachments via {@link RGFramebufferDesc.attachmentLayer}.\r\n   */\r\n  arrayLayers?: number;\r\n}\r\n\r\n// ─── Handles ────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Opaque handle referencing a resource within the render graph.\r\n *\r\n * Handles are obtained from {@link RGPassBuilder.createTexture}, {@link RGPassBuilder.createFramebuffer},\r\n * {@link RenderGraph.importTexture}, or {@link RGPassBuilder.write}. They are lightweight identifiers\r\n * used to declare dependencies between passes.\r\n *\r\n * @public\r\n */\r\nexport class RGHandle {\r\n  /** @internal */\r\n  readonly _id: number;\r\n  /** @internal */\r\n  readonly _name: string;\r\n\r\n  /** @internal */\r\n  constructor(id: number, name: string) {\r\n    this._id = id;\r\n    this._name = name;\r\n  }\r\n\r\n  /** Debug-friendly name of the referenced resource. */\r\n  get name(): string {\r\n    return this._name;\r\n  }\r\n}\r\n\r\n// ─── Internal Resource Tracking ─────────────────────────────────────────\r\n\r\n/** @public */\r\nexport type RGResourceKind = 'transient' | 'imported' | 'token' | 'framebuffer';\r\n\r\n/**\r\n * Internal bookkeeping for a resource within the render graph.\r\n * @public\r\n */\r\nexport class RGResource {\r\n  readonly id: number;\r\n  readonly name: string;\r\n  readonly kind: RGResourceKind;\r\n  readonly desc: RGTextureDesc | RGFramebufferDesc | null;\r\n  /** Resource ID of the physical backing resource used by imported versions. */\r\n  readonly physicalId: number;\r\n  /** The pass that creates / writes this resource (null for imported until written). */\r\n  producer: RGPass | null = null;\r\n  /** Passes that read this resource. */\r\n  readonly consumers: RGPass[] = [];\r\n\r\n  constructor(\r\n    id: number,\r\n    name: string,\r\n    kind: RGResourceKind,\r\n    desc: RGTextureDesc | RGFramebufferDesc | null,\r\n    physicalId = id\r\n  ) {\r\n    this.id = id;\r\n    this.name = name;\r\n    this.kind = kind;\r\n    this.desc = desc;\r\n    this.physicalId = physicalId;\r\n  }\r\n}\r\n\r\n// ─── Internal Pass Tracking ─────────────────────────────────────────────\r\n\r\n// ─── Execution Context ──────────────────────────────────────────────\r\n\r\n/**\r\n * Context passed to pass execute callbacks during graph execution.\r\n *\r\n * Provides access to resolved GPU resources by their handles.\r\n *\r\n * @public\r\n */\r\nexport interface RGExecuteContext {\r\n  /**\r\n   * Resolve a handle to the actual GPU texture object.\r\n   *\r\n   * For transient resources, this returns the texture allocated by the executor.\r\n   * For imported resources, this returns the texture registered via\r\n   * {@link RenderGraphExecutor.setImportedTexture}. The handle must be declared\r\n   * by the current pass with {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.\r\n   *\r\n   * @param handle - Handle of the resource to resolve.\r\n   * @returns The resolved texture object (type depends on the allocator).\r\n   */\r\n  getTexture<TTexture = unknown>(handle: RGHandle): TTexture;\r\n\r\n  /**\r\n   * Resolve a framebuffer handle to the actual backend framebuffer object.\r\n   *\r\n   * The handle must be declared by the current pass with {@link RGPassBuilder.read}\r\n   * or created by the same pass with {@link RGPassBuilder.createFramebuffer}.\r\n   *\r\n   * @param handle - Handle returned from {@link RGPassBuilder.createFramebuffer}.\r\n   * @returns The resolved framebuffer object (type depends on the allocator).\r\n   */\r\n  getFramebuffer<TFramebuffer = unknown>(handle: RGHandle): TFramebuffer;\r\n\r\n  /**\r\n   * Create a temporary framebuffer managed by the graph executor.\r\n   *\r\n   * The framebuffer is released automatically when graph execution finishes or\r\n   * aborts. Attachments may be actual backend resources or texture formats,\r\n   * depending on the allocator implementation. If an attachment is an\r\n   * {@link RGHandle}, the current pass must declare it with\r\n   * {@link RGPassBuilder.read} or {@link RGPassBuilder.write}.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns The allocated framebuffer object (type depends on the allocator).\r\n   */\r\n  createFramebuffer<TFramebuffer = unknown>(desc: RGFramebufferDesc): TFramebuffer;\r\n\r\n  /**\r\n   * Register a cleanup callback to run when graph execution finishes or aborts.\r\n   *\r\n   * Callbacks run in reverse registration order. Use this for temporary objects\r\n   * created inside pass execution that are not graph resources, such as pooled\r\n   * framebuffers wrapping graph-managed textures. If pass execution throws, the\r\n   * executor still runs cleanup callbacks and preserves the original pass error\r\n   * ahead of cleanup errors.\r\n   *\r\n   * @param callback - Cleanup function to invoke after execution.\r\n   */\r\n  deferCleanup(callback: () => void): void;\r\n}\r\n\r\n/**\r\n * Execute callback signature.\r\n *\r\n * The callback receives a context for resolving handles to GPU resources,\r\n * plus the user data returned from the setup function.\r\n *\r\n * @public\r\n */\r\nexport type RGExecuteFn<T = void> = (ctx: RGExecuteContext, data: T) => void;\r\n\r\n/**\r\n * Ordered execution step inside a render graph pass.\r\n *\r\n * Subpasses share the parent pass's resource declarations, lifetime, culling,\r\n * and access validation. They are intended to make multi-step pass bodies\r\n * explicit without splitting graph-level resource dependencies.\r\n *\r\n * @public\r\n */\r\nexport class RGSubpass<T = unknown> {\r\n  readonly name: string;\r\n  readonly executeFn: RGExecuteFn<T>;\r\n\r\n  constructor(name: string, executeFn: RGExecuteFn<T>) {\r\n    this.name = name;\r\n    this.executeFn = executeFn;\r\n  }\r\n}\r\n\r\n/**\r\n * Internal bookkeeping for a pass within the render graph.\r\n * @public\r\n */\r\nexport class RGPass<T = unknown> {\r\n  readonly index: number;\r\n  readonly name: string;\r\n  /** Resources this pass reads (dependencies). */\r\n  readonly reads: RGResource[] = [];\r\n  /** Resources this pass creates or writes. */\r\n  readonly writes: RGResource[] = [];\r\n  /** Passes that must complete before this pass due to non-resource hazards. */\r\n  readonly dependencies: RGPass[] = [];\r\n  /** Whether this pass has side effects and must not be culled. */\r\n  hasSideEffect = false;\r\n  /** User data returned from the setup function. */\r\n  data: T | null = null;\r\n  /** Execute callback. */\r\n  executeFn: RGExecuteFn<T> | null = null;\r\n  /** Ordered subpasses for passes with multiple logical execution steps. */\r\n  readonly subpasses: RGSubpass<T>[] = [];\r\n  /** Set during compilation: true if this pass is needed. */\r\n  alive = true;\r\n\r\n  constructor(index: number, name: string) {\r\n    this.index = index;\r\n    this.name = name;\r\n  }\r\n}\r\n\r\n// ─── Pass Builder ───────────────────────────────────────────────────────\r\n\r\n/**\r\n * Builder interface used within the setup callback of {@link RenderGraph.addPass}\r\n * to declare a pass's resource requirements.\r\n *\r\n * @public\r\n */\r\nexport interface RGPassBuilder {\r\n  /**\r\n   * Declare a read dependency on an existing resource.\r\n   *\r\n   * The resource must have been created by a prior pass or imported into the graph.\r\n   *\r\n   * @param handle - Handle of the resource to read.\r\n   */\r\n  read(handle: RGHandle): void;\r\n\r\n  /**\r\n   * Declare that this pass writes a new version of an existing resource.\r\n   *\r\n   * The returned handle represents the post-write version. Use it for subsequent\r\n   * reads and as the graph output passed to {@link RenderGraph.compile}. Passing\r\n   * an older version of the same resource to `compile()` is rejected because it\r\n   * usually means the caller ignored the handle returned by `write()`. If the pass\r\n   * needs the previous contents, call {@link RGPassBuilder.read} on the input handle explicitly\r\n   * before writing.\r\n   *\r\n   * @param handle - Handle of the resource to write to.\r\n   * @returns A handle referencing the newly written version.\r\n   */\r\n  write(handle: RGHandle): RGHandle;\r\n\r\n  /**\r\n   * Create a new transient texture resource that this pass will produce.\r\n   *\r\n   * @param desc - Texture descriptor.\r\n   * @returns A handle referencing the newly created resource.\r\n   */\r\n  createTexture(desc: RGTextureDesc): RGHandle;\r\n\r\n  /**\r\n   * Create a logical dependency token produced by this pass.\r\n   *\r\n   * Tokens do not resolve to GPU resources and are not allocated by the executor.\r\n   * They are useful for ordering passes whose dependencies are side effects rather\r\n   * than texture reads/writes.\r\n   *\r\n   * @param name - Debug label for this token.\r\n   * @returns A handle referencing the newly created token.\r\n   */\r\n  createToken(name?: string): RGHandle;\r\n\r\n  /**\r\n   * Create a graph-managed framebuffer view.\r\n   *\r\n   * The graph compiler infers dependencies from any attachment handles in the\r\n   * descriptor. The executor creates and releases the framebuffer automatically.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns A handle referencing the framebuffer view.\r\n   */\r\n  createFramebuffer(desc: RGFramebufferDesc): RGHandle;\r\n\r\n  /**\r\n   * Mark this pass as having side effects.\r\n   *\r\n   * Side-effect passes are never culled by the graph compiler, regardless of\r\n   * whether their outputs are consumed. Use this for GPU readback, picking,\r\n   * debug overlays, etc.\r\n   */\r\n  sideEffect(): void;\r\n\r\n  /**\r\n   * Add an ordered logical subpass to this pass.\r\n   *\r\n   * Subpasses execute in registration order and share the parent pass's declared\r\n   * reads, writes, framebuffer views, and user data. A pass may use either\r\n   * subpasses or {@link RGPassBuilder.setExecute}, but not both.\r\n   *\r\n   * @param name - Debug label for the subpass.\r\n   * @param fn - Callback invoked when this subpass executes.\r\n   */\r\n  addSubpass<D>(name: string, fn: RGExecuteFn<D>): void;\r\n\r\n  /**\r\n   * Set the execution callback for this pass.\r\n   *\r\n   * A pass may use either this method or {@link RGPassBuilder.addSubpass}, but not both.\r\n   *\r\n   * @param fn - Callback invoked during graph execution.\r\n   */\r\n  setExecute<D>(fn: RGExecuteFn<D>): void;\r\n}\r\n\r\n// ─── Compiled Graph ─────────────────────────────────────────────────────\r\n\r\n/**\r\n * Lifetime information for a resource within the compiled graph.\r\n *\r\n * @public\r\n */\r\nexport interface RGResourceLifetime {\r\n  /** The resource. */\r\n  readonly resource: RGResource;\r\n  /** Index of the first pass that uses (produces or reads) this resource. */\r\n  readonly firstUse: number;\r\n  /** Index of the last pass that uses this resource. */\r\n  readonly lastUse: number;\r\n}\r\n\r\n/**\r\n * Result of compiling a render graph.\r\n *\r\n * Contains the ordered list of passes to execute and lifetime information\r\n * for automatic resource management.\r\n *\r\n * @public\r\n */\r\nexport interface CompiledRenderGraph {\r\n  /** Topologically sorted passes (only non-culled passes). */\r\n  readonly orderedPasses: ReadonlyArray<RGPass>;\r\n  /** Resource lifetime information keyed by resource ID. */\r\n  readonly lifetimes: ReadonlyMap<number, RGResourceLifetime>;\r\n}\r\n\r\n/**\r\n * Profiling scope type in a render graph timing tree.\r\n * @public\r\n */\r\nexport type RGProfileScopeType = 'graph' | 'pass' | 'subpass';\r\n\r\n/**\r\n * Render graph GPU timestamp profiling options.\r\n * @public\r\n */\r\nexport interface RGProfilingOptions {\r\n  /** Enable render graph timestamp profiling. Default true when an options object is provided. */\r\n  enabled?: boolean;\r\n  /** Measure the whole graph execution. Default true. */\r\n  graph?: boolean;\r\n  /** Measure every render graph pass. Default true. */\r\n  pass?: boolean;\r\n  /** Measure every subpass and expose it as a child scope. Default true. */\r\n  subpass?: boolean;\r\n  /** Include pending upload/copy commands at timestamp boundaries. Default true. */\r\n  includePendingUploads?: boolean;\r\n  /** Allow graph profile scopes to remain open across frame boundaries. Default false. */\r\n  allowCrossFrame?: boolean;\r\n  /** Maximum unresolved profile frames kept by the executor. Default 3. */\r\n  maxPendingFrames?: number;\r\n  /** Root graph profile label. Default 'RenderGraph'. */\r\n  label?: string;\r\n  /** Device used for timestamp queries. If omitted, the scene global getDevice() is used. */\r\n  device?: AbstractDevice;\r\n}\r\n\r\n/**\r\n * Render graph executor construction options.\r\n * @public\r\n */\r\nexport interface RenderGraphExecutorOptions {\r\n  /** Device used for timestamp queries. If omitted, the scene global getDevice() is used. */\r\n  device?: AbstractDevice;\r\n  /** Render graph timestamp profiling options. Default false. */\r\n  profiling?: boolean | RGProfilingOptions;\r\n}\r\n\r\n/**\r\n * Resolved GPU timing for one graph/pass/subpass scope.\r\n * @public\r\n */\r\nexport interface RGProfileScopeResult {\r\n  /** Scope label. */\r\n  name: string;\r\n  /** Scope type. */\r\n  type: RGProfileScopeType;\r\n  /** Timestamp query id used by the device, or 0 for synthetic/unsupported scopes. */\r\n  queryId: number;\r\n  /** GPU duration in milliseconds. */\r\n  durationMs: number;\r\n  /** Timestamp result status. */\r\n  status: TimestampQueryStatus;\r\n  /** Child scopes. */\r\n  children: RGProfileScopeResult[];\r\n  /** Optional diagnostic message. */\r\n  message?: string;\r\n}\r\n\r\n/**\r\n * Resolved GPU timing tree for one render graph execution.\r\n * @public\r\n */\r\nexport interface RGProfileResult {\r\n  /** Render frame id when profiling began. */\r\n  frameId: number;\r\n  /** Aggregate profile status. */\r\n  status: TimestampQueryStatus;\r\n  /** Root graph scope. */\r\n  graph: RGProfileScopeResult;\r\n  /** Top-level pass scopes. Same objects as graph.children. */\r\n  passes: RGProfileScopeResult[];\r\n}\r\n\r\n// ─── Texture Allocator ──────────────────────────────────────────────\r\n\r\n/**\r\n * Resolved dimensions for a texture allocation.\r\n * @public\r\n */\r\nexport interface RGResolvedSize {\r\n  width: number;\r\n  height: number;\r\n}\r\n\r\n/**\r\n * Descriptor for a framebuffer view managed by the graph or created temporarily during pass execution.\r\n *\r\n * This is intentionally backend-agnostic: graph-managed descriptors may use\r\n * {@link RGHandle} attachments, and executor-created descriptors use resolved\r\n * resources or texture formats understood by the allocator.\r\n *\r\n * @public\r\n */\r\nexport interface RGFramebufferDesc {\r\n  /** Debug label for this framebuffer. */\r\n  label?: string;\r\n  /** Framebuffer width. Required when attachments are formats. */\r\n  width?: number;\r\n  /** Framebuffer height. Required when attachments are formats. */\r\n  height?: number;\r\n  /** Color attachments or formats. */\r\n  colorAttachments: unknown | unknown[] | null;\r\n  /** Depth/stencil attachment or format. */\r\n  depthAttachment?: unknown | null;\r\n  /** Whether color attachments created from formats should support mipmapping. */\r\n  mipmapping?: boolean;\r\n  /** Framebuffer sample count. */\r\n  sampleCount?: number;\r\n  /** Whether to ignore depth/stencil during MSAA resolve. */\r\n  ignoreDepthStencil?: boolean;\r\n  /** Attachment mip level. */\r\n  attachmentMipLevel?: number;\r\n  /** Attachment cubemap face. */\r\n  attachmentCubeface?: number;\r\n  /** Attachment array layer. */\r\n  attachmentLayer?: number;\r\n}\r\n\r\n/**\r\n * Interface for allocating and releasing transient textures.\r\n *\r\n * Implement this to bridge the render graph with your GPU device's resource pool.\r\n * The executor calls `allocate()` before a resource's first use and\r\n * `release()` after its last use.\r\n *\r\n * Lifetime contract: the graph compiler extends a texture's lifetime to cover\r\n * every graph-managed framebuffer it is attached to, and the executor releases\r\n * framebuffers before textures at the same pass boundary. Allocators may\r\n * therefore assume `releaseFramebuffer()` is called before `release()` of its\r\n * attachments, and must keep a released framebuffer's attachments intact until\r\n * their own `release()` call.\r\n *\r\n * @typeParam TTexture - The concrete texture type (e.g. `Texture2D`).\r\n * @public\r\n */\r\nexport interface RGTextureAllocator<TTexture = unknown, TFramebuffer = unknown> {\r\n  /**\r\n   * Allocate a transient texture matching the given descriptor and resolved size.\r\n   *\r\n   * @param desc - The texture descriptor from the pass builder.\r\n   * @param size - The resolved pixel dimensions.\r\n   * @returns The allocated texture object.\r\n   */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize): TTexture;\r\n\r\n  /**\r\n   * Release a previously allocated transient texture back to the pool.\r\n   *\r\n   * @param texture - The texture to release.\r\n   */\r\n  release(texture: TTexture): void;\r\n\r\n  /**\r\n   * Retain a texture allocated by this allocator so it can outlive the graph pass\r\n   * that produced it.\r\n   *\r\n   * This is used when a graph-produced transient texture must be handed off to\r\n   * an external owner, such as a cross-frame history resource. Executors still\r\n   * release the graph's own reference at the resource's last use; the external\r\n   * owner must later call {@link RGTextureAllocator.release} for the retained\r\n   * reference.\r\n   *\r\n   * Allocators that cannot retain transient textures should leave this undefined.\r\n   */\r\n  retain?(texture: TTexture): void;\r\n\r\n  /**\r\n   * Allocate a temporary framebuffer matching the given descriptor.\r\n   *\r\n   * Implementations should not auto-release this framebuffer; the graph executor\r\n   * calls {@link RGTextureAllocator.releaseFramebuffer} when execution completes or aborts.\r\n   *\r\n   * @param desc - Framebuffer descriptor.\r\n   * @returns The allocated framebuffer object.\r\n   */\r\n  allocateFramebuffer?(desc: RGFramebufferDesc): TFramebuffer;\r\n\r\n  /**\r\n   * Release a previously allocated temporary framebuffer.\r\n   *\r\n   * @param framebuffer - The framebuffer to release.\r\n   */\r\n  releaseFramebuffer?(framebuffer: TFramebuffer): void;\r\n}\r\n"],"names":["RGHandle","id","name","_id","_name","RGResource","kind","desc","producer","consumers","physicalId","RGSubpass","executeFn","RGPass","index","reads","writes","dependencies","hasSideEffect","data","subpasses","alive"],"mappings":"AA4CA;AAEA;;;;;;;;AAQC,IACM,MAAMA,QAAAA,CAAAA;qBAEX,GAAqB;qBAErB,KAAuB;AAEvB,qBACA,WAAA,CAAYC,EAAU,EAAEC,IAAY,CAAE;QACpC,IAAI,CAACC,GAAG,GAAGF,EAAAA;QACX,IAAI,CAACG,KAAK,GAAGF,IAAAA;AACf;2DAGA,IAAIA,IAAe,GAAA;QACjB,OAAO,IAAI,CAACE,KAAK;AACnB;AACF;AAOA;;;AAGC,IACM,MAAMC,UAAAA,CAAAA;IACFJ,EAAW;IACXC,IAAa;IACbI,IAAqB;IACrBC,IAA+C;mFAExD,UAA4B;2FAE5BC,WAA0B,IAAK;AAC/B,2CACSC,SAAsB,GAAA,EAAE;IAEjC,WACER,CAAAA,EAAU,EACVC,IAAY,EACZI,IAAoB,EACpBC,IAA8C,EAC9CG,UAAaT,GAAAA,EAAE,CACf;QACA,IAAI,CAACA,EAAE,GAAGA,EAAAA;QACV,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACI,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACC,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACG,UAAU,GAAGA,UAAAA;AACpB;AACF;AA4EA;;;;;;;;AAQC,IACM,MAAMC,SAAAA,CAAAA;IACFT,IAAa;IACbU,SAA0B;IAEnC,WAAYV,CAAAA,IAAY,EAAEU,SAAyB,CAAE;QACnD,IAAI,CAACV,IAAI,GAAGA,IAAAA;QACZ,IAAI,CAACU,SAAS,GAAGA,SAAAA;AACnB;AACF;AAEA;;;AAGC,IACM,MAAMC,MAAAA,CAAAA;IACFC,KAAc;IACdZ,IAAa;AACtB,qDACSa,KAAsB,GAAA,EAAE;AACjC,kDACSC,MAAuB,GAAA,EAAE;AAClC,mFACSC,YAAyB,GAAA,EAAE;sEAEpCC,gBAAgB,KAAM;uDAEtBC,OAAiB,IAAK;6BAEtBP,YAAmC,IAAK;AACxC,+EACSQ,SAA4B,GAAA,EAAE;gEAEvCC,QAAQ,IAAK;IAEb,WAAYP,CAAAA,KAAa,EAAEZ,IAAY,CAAE;QACvC,IAAI,CAACY,KAAK,GAAGA,KAAAA;QACb,IAAI,CAACZ,IAAI,GAAGA,IAAAA;AACd;AACF;;;;"}

package/dist/render/renderpass.js

@@ -12,6 +12,7 @@ import { getDevice } from '../app/api.js';
     /** @internal */ _type;
     /** @internal */ _globalBindGroups;
     /** @internal */ _clearColor;
+    /** @internal */ _clearColors;
     /** @internal */ _clearDepth;
     /** @internal */ _clearStencil;
     /**
@@ -21,6 +22,7 @@ import { getDevice } from '../app/api.js';
         super();
         this._type = type;
         this._clearColor = new Vector4(0, 0, 0, 1);
+        this._clearColors = null;
         this._clearDepth = 1;
         this._clearStencil = 0;
         this._globalBindGroups = {};
@@ -30,6 +32,13 @@ import { getDevice } from '../app/api.js';
     }
     set clearColor(color) {
         this._clearColor = color;
+        this._clearColors = null;
+    }
+    /** Per-target color values that are used to clear the frame buffer */ get clearColors() {
+        return this._clearColors;
+    }
+    set clearColors(colors) {
+        this._clearColors = colors;
     }
     /** Depth value that is used to clear the frame buffer */ get clearDepth() {
         return this._clearDepth;
@@ -173,8 +182,9 @@ import { getDevice } from '../app/api.js';
         this._globalBindGroups = {};
     }
     /** @internal */ clearFramebuffer() {
-        if (this._clearColor || this._clearDepth || this._clearStencil) {
-            getDevice().clearFrameBuffer(this._clearColor, this._clearDepth, this._clearStencil);
+        const clearColor = this._clearColors ?? this._clearColor;
+        if (clearColor || this._clearDepth || this._clearStencil) {
+            getDevice().clearFrameBuffer(clearColor, this._clearDepth, this._clearStencil);
         }
     }
 }

package/dist/render/renderpass.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderpass.js","sources":["../../src/render/renderpass.ts"],"sourcesContent":["import type { Immutable, Nullable } from '@zephyr3d/base';\r\nimport { Disposable, Vector4 } from '@zephyr3d/base';\r\nimport { CullVisitor } from './cull_visitor';\r\nimport type { RenderItemListInfo, RenderQueueItem } from './render_queue';\r\nimport { RenderQueue } from './render_queue';\r\nimport type { Camera } from '../camera/camera';\r\nimport type { DrawContext } from './drawable';\r\nimport { RenderBundleWrapper } from './renderbundle_wrapper';\r\nimport { MaterialVaryingFlags, RENDER_PASS_TYPE_LIGHT } from '../values';\r\nimport type { BindGroup } from '@zephyr3d/device';\r\nimport { getDevice } from '../app/api';\r\n\r\n/**\r\n * Base class for any kind of render passes\r\n * @public\r\n */\r\nexport abstract class RenderPass extends Disposable {\r\n  /** @internal */\r\n  protected _type: number;\r\n  /** @internal */\r\n  protected _globalBindGroups: Record<string, BindGroup>;\r\n  /** @internal */\r\n  protected _clearColor: Nullable<Vector4>;\r\n  /** @internal */\r\n  protected _clearDepth: Nullable<number>;\r\n  /** @internal */\r\n  protected _clearStencil: Nullable<number>;\r\n  /**\r\n   * Creates an instanceof RenderPass\r\n   * @param type - Render pass type\r\n   */\r\n  constructor(type: number) {\r\n    super();\r\n    this._type = type;\r\n    this._clearColor = new Vector4(0, 0, 0, 1);\r\n    this._clearDepth = 1;\r\n    this._clearStencil = 0;\r\n    this._globalBindGroups = {};\r\n  }\r\n  /** Color value that is used to clear the frame buffer  */\r\n  get clearColor(): Nullable<Immutable<Vector4>> {\r\n    return this._clearColor;\r\n  }\r\n  set clearColor(color: Nullable<Immutable<Vector4>>) {\r\n    this._clearColor = color;\r\n  }\r\n  /** Depth value that is used to clear the frame buffer */\r\n  get clearDepth() {\r\n    return this._clearDepth;\r\n  }\r\n  set clearDepth(depth) {\r\n    this._clearDepth = depth;\r\n  }\r\n  /** Stencil value that is used to clear the frame buffer */\r\n  get clearStencil() {\r\n    return this._clearStencil;\r\n  }\r\n  set clearStencil(stencil) {\r\n    this._clearStencil = stencil;\r\n  }\r\n  /**\r\n   * The render pass type\r\n   */\r\n  get type() {\r\n    return this._type;\r\n  }\r\n  /** @internal */\r\n  isAutoFlip(ctx: DrawContext) {\r\n    return !!(ctx.device.getFramebuffer() && ctx.device.type === 'webgpu');\r\n  }\r\n  /**\r\n   * Renders a scene\r\n   * @param ctx - Drawing context\r\n   */\r\n  render(\r\n    ctx: DrawContext,\r\n    renderCamera?: Nullable<Camera>,\r\n    cullCamera?: Nullable<Camera>,\r\n    renderQueue?: RenderQueue\r\n  ) {\r\n    ctx.renderPass = this;\r\n    this.drawScene(ctx, renderCamera ?? ctx.camera, cullCamera ?? renderCamera ?? ctx.camera, renderQueue);\r\n  }\r\n  /** @internal */\r\n  getGlobalBindGroupHash(ctx: DrawContext, camera: Camera) {\r\n    return `${this.constructor.name}:${this._getGlobalBindGroupHash(ctx, camera)}`;\r\n  }\r\n  /** @internal */\r\n  protected abstract _getGlobalBindGroupHash(ctx: DrawContext, camera: Camera): string;\r\n  /** @internal */\r\n  protected abstract renderItems(ctx: DrawContext, renderCamera: Camera, renderQueue: RenderQueue): void;\r\n  /** @internal */\r\n  protected drawScene(ctx: DrawContext, renderCamera: Camera, cullCamera: Camera, renderQueue?: RenderQueue) {\r\n    const device = ctx.device;\r\n    this.clearFramebuffer();\r\n    const rq = renderQueue ?? this.cullScene(ctx, cullCamera);\r\n    if (rq) {\r\n      const windingReversed = device.isWindingOrderReversed();\r\n      device.reverseVertexWindingOrder(this.isAutoFlip(ctx) ? !windingReversed : windingReversed);\r\n      this.renderItems(ctx, renderCamera, rq);\r\n      device.reverseVertexWindingOrder(windingReversed);\r\n      if (rq !== renderQueue) {\r\n        rq.dispose();\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Culls a scene by a given camera\r\n   * @param ctx - The draw context\r\n   * @param cullCamera - The camera that will be used to cull the scene\r\n   * @returns The cull result\r\n   */\r\n  cullScene(ctx: DrawContext, cullCamera: Camera) {\r\n    const renderQueue = new RenderQueue(this);\r\n    const cullVisitor = new CullVisitor(this, cullCamera, renderQueue);\r\n    if (ctx.scene.octree) {\r\n      ctx.scene.octree.getRootNode().traverse(cullVisitor);\r\n    } else {\r\n      ctx.scene.rootNode.traverse(cullVisitor);\r\n    }\r\n    renderQueue.end(cullCamera);\r\n    ctx.sunLight = renderQueue.sunLight;\r\n    ctx.primaryDirectionalLight = renderQueue.primaryDirectionalLight;\r\n    ctx.primaryTransmissionLight = renderQueue.primaryTransmissionLight;\r\n    return renderQueue;\r\n  }\r\n  /** @internal */\r\n  private internalDrawItemList(\r\n    ctx: DrawContext,\r\n    items: RenderQueueItem[],\r\n    renderQueue: Nullable<RenderQueue>,\r\n    renderBundle: Nullable<RenderBundleWrapper>,\r\n    reverseWinding: boolean,\r\n    hash: string\r\n  ) {\r\n    let recording = false;\r\n    const disableRenderBundles = this.shouldDisableRenderBundles(ctx);\r\n    if (renderBundle && ctx.camera.commandBufferReuse && !disableRenderBundles) {\r\n      const bundle = renderBundle.getRenderBundle(hash);\r\n      if (bundle) {\r\n        ctx.device.executeRenderBundle(bundle);\r\n        return;\r\n      }\r\n      recording = true;\r\n      renderBundle.beginRenderBundle();\r\n    }\r\n    for (const item of items) {\r\n      ctx.instanceData = item.instanceData;\r\n      const reverse = reverseWinding !== item.drawable.getNode().worldMatrixDet < 0;\r\n      if (reverse) {\r\n        ctx.device.reverseVertexWindingOrder(!ctx.device.isWindingOrderReversed());\r\n      }\r\n      if (recording) {\r\n        RenderBundleWrapper.addDrawable(\r\n          item.drawable,\r\n          item.drawable.getMaterial()?.coreMaterial!,\r\n          item.drawable.getPrimitive()!,\r\n          renderBundle!,\r\n          hash\r\n        );\r\n      }\r\n      item.drawable.draw(ctx, renderQueue, recording || disableRenderBundles ? undefined : hash);\r\n      if (reverse) {\r\n        ctx.device.reverseVertexWindingOrder(!ctx.device.isWindingOrderReversed());\r\n      }\r\n    }\r\n    if (renderBundle && ctx.camera.commandBufferReuse && !disableRenderBundles) {\r\n      renderBundle.endRenderBundle(hash);\r\n    }\r\n  }\r\n  private shouldDisableRenderBundles(ctx: DrawContext) {\r\n    return (\r\n      (ctx.renderPass?.type === RENDER_PASS_TYPE_LIGHT &&\r\n        (!!ctx.SSS || !!ctx.currentShadowLight || !!ctx.lightBlending)) ||\r\n      false\r\n    );\r\n  }\r\n  /** @internal */\r\n  protected drawItemList(itemList: RenderItemListInfo, ctx: DrawContext, reverseWinding: boolean) {\r\n    ctx.instanceData = null;\r\n    const windingHash = reverseWinding ? '1' : '0';\r\n    const bindGroupHash = ctx.device.getBindGroup(0)[0].getGPUId();\r\n    const framebufferHash = ctx.device.getFramebuffer()?.getHash() ?? '';\r\n    const ctxHash = `${ctx.sceneColorTexture?.uid ?? 0}-${ctx.linearDepthTexture?.uid ?? 0}`;\r\n    const hash = `${windingHash}-${bindGroupHash}-${framebufferHash}-${ctxHash}-${ctx.renderPassHash}`;\r\n    if (itemList) {\r\n      if (itemList.itemList.length > 0) {\r\n        ctx.materialFlags &= ~(\r\n          MaterialVaryingFlags.SKIN_ANIMATION |\r\n          MaterialVaryingFlags.INSTANCING |\r\n          MaterialVaryingFlags.MORPH_ANIMATION\r\n        );\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.itemList,\r\n          itemList.renderQueue,\r\n          itemList.renderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n      if (itemList.skinItemList.length > 0) {\r\n        ctx.materialFlags |= MaterialVaryingFlags.SKIN_ANIMATION;\r\n        ctx.materialFlags &= ~(MaterialVaryingFlags.MORPH_ANIMATION | MaterialVaryingFlags.INSTANCING);\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.skinItemList,\r\n          itemList.renderQueue,\r\n          itemList.skinRenderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n      if (itemList.morphItemList.length > 0) {\r\n        ctx.materialFlags |= MaterialVaryingFlags.MORPH_ANIMATION;\r\n        ctx.materialFlags &= ~(MaterialVaryingFlags.SKIN_ANIMATION | MaterialVaryingFlags.INSTANCING);\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.morphItemList,\r\n          itemList.renderQueue,\r\n          itemList.morphRenderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n      if (itemList.skinAndMorphItemList.length > 0) {\r\n        ctx.materialFlags |= MaterialVaryingFlags.SKIN_ANIMATION | MaterialVaryingFlags.MORPH_ANIMATION;\r\n        ctx.materialFlags &= ~MaterialVaryingFlags.INSTANCING;\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.skinAndMorphItemList,\r\n          itemList.renderQueue,\r\n          itemList.skinAndMorphRenderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n      if (itemList.instanceItemList.length > 0) {\r\n        ctx.materialFlags |= MaterialVaryingFlags.INSTANCING;\r\n        ctx.materialFlags &= ~(MaterialVaryingFlags.SKIN_ANIMATION | MaterialVaryingFlags.MORPH_ANIMATION);\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.instanceItemList,\r\n          itemList.renderQueue,\r\n          itemList.instanceRenderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Disposes the render pass\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this._globalBindGroups = {};\r\n  }\r\n  /** @internal */\r\n  private clearFramebuffer() {\r\n    if (this._clearColor || this._clearDepth || this._clearStencil) {\r\n      getDevice().clearFrameBuffer(this._clearColor, this._clearDepth, this._clearStencil);\r\n    }\r\n  }\r\n}\r\n"],"names":["RenderPass","Disposable","type","_type","_clearColor","Vector4","_clearDepth","_clearStencil","_globalBindGroups","clearColor","color","clearDepth","depth","clearStencil","stencil","isAutoFlip","ctx","device","getFramebuffer","render","renderCamera","cullCamera","renderQueue","renderPass","drawScene","camera","getGlobalBindGroupHash","name","_getGlobalBindGroupHash","clearFramebuffer","rq","cullScene","windingReversed","isWindingOrderReversed","reverseVertexWindingOrder","renderItems","dispose","RenderQueue","cullVisitor","CullVisitor","scene","octree","getRootNode","traverse","rootNode","end","sunLight","primaryDirectionalLight","primaryTransmissionLight","internalDrawItemList","items","renderBundle","reverseWinding","hash","recording","disableRenderBundles","shouldDisableRenderBundles","commandBufferReuse","bundle","getRenderBundle","executeRenderBundle","beginRenderBundle","item","instanceData","reverse","drawable","getNode","worldMatrixDet","RenderBundleWrapper","addDrawable","getMaterial","coreMaterial","getPrimitive","draw","undefined","endRenderBundle","RENDER_PASS_TYPE_LIGHT","SSS","currentShadowLight","lightBlending","itemList","windingHash","bindGroupHash","getBindGroup","getGPUId","framebufferHash","getHash","ctxHash","sceneColorTexture","uid","linearDepthTexture","renderPassHash","length","materialFlags","MaterialVaryingFlags","SKIN_ANIMATION","INSTANCING","MORPH_ANIMATION","materialList","forEach","mat","apply","skinItemList","skinRenderBundle","morphItemList","morphRenderBundle","skinAndMorphItemList","skinAndMorphRenderBundle","instanceItemList","instanceRenderBundle","onDispose","getDevice","clearFrameBuffer"],"mappings":"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"}
+{"version":3,"file":"renderpass.js","sources":["../../src/render/renderpass.ts"],"sourcesContent":["import type { Immutable, Nullable } from '@zephyr3d/base';\r\nimport { Disposable, Vector4 } from '@zephyr3d/base';\r\nimport { CullVisitor } from './cull_visitor';\r\nimport type { RenderItemListInfo, RenderQueueItem } from './render_queue';\r\nimport { RenderQueue } from './render_queue';\r\nimport type { Camera } from '../camera/camera';\r\nimport type { DrawContext } from './drawable';\r\nimport { RenderBundleWrapper } from './renderbundle_wrapper';\r\nimport { MaterialVaryingFlags, RENDER_PASS_TYPE_LIGHT } from '../values';\r\nimport type { BindGroup, FrameBufferClearColors } from '@zephyr3d/device';\r\nimport { getDevice } from '../app/api';\r\n\r\n/**\r\n * Base class for any kind of render passes\r\n * @public\r\n */\r\nexport abstract class RenderPass extends Disposable {\r\n  /** @internal */\r\n  protected _type: number;\r\n  /** @internal */\r\n  protected _globalBindGroups: Record<string, BindGroup>;\r\n  /** @internal */\r\n  protected _clearColor: Nullable<Vector4>;\r\n  /** @internal */\r\n  protected _clearColors: Nullable<readonly Nullable<Vector4>[]>;\r\n  /** @internal */\r\n  protected _clearDepth: Nullable<number>;\r\n  /** @internal */\r\n  protected _clearStencil: Nullable<number>;\r\n  /**\r\n   * Creates an instanceof RenderPass\r\n   * @param type - Render pass type\r\n   */\r\n  constructor(type: number) {\r\n    super();\r\n    this._type = type;\r\n    this._clearColor = new Vector4(0, 0, 0, 1);\r\n    this._clearColors = null;\r\n    this._clearDepth = 1;\r\n    this._clearStencil = 0;\r\n    this._globalBindGroups = {};\r\n  }\r\n  /** Color value that is used to clear the frame buffer  */\r\n  get clearColor(): Nullable<Immutable<Vector4>> {\r\n    return this._clearColor;\r\n  }\r\n  set clearColor(color: Nullable<Immutable<Vector4>>) {\r\n    this._clearColor = color;\r\n    this._clearColors = null;\r\n  }\r\n  /** Per-target color values that are used to clear the frame buffer */\r\n  get clearColors(): Nullable<readonly Nullable<Immutable<Vector4>>[]> {\r\n    return this._clearColors;\r\n  }\r\n  set clearColors(colors: Nullable<readonly Nullable<Immutable<Vector4>>[]>) {\r\n    this._clearColors = colors as Nullable<readonly Nullable<Vector4>[]>;\r\n  }\r\n  /** Depth value that is used to clear the frame buffer */\r\n  get clearDepth() {\r\n    return this._clearDepth;\r\n  }\r\n  set clearDepth(depth) {\r\n    this._clearDepth = depth;\r\n  }\r\n  /** Stencil value that is used to clear the frame buffer */\r\n  get clearStencil() {\r\n    return this._clearStencil;\r\n  }\r\n  set clearStencil(stencil) {\r\n    this._clearStencil = stencil;\r\n  }\r\n  /**\r\n   * The render pass type\r\n   */\r\n  get type() {\r\n    return this._type;\r\n  }\r\n  /** @internal */\r\n  isAutoFlip(ctx: DrawContext) {\r\n    return !!(ctx.device.getFramebuffer() && ctx.device.type === 'webgpu');\r\n  }\r\n  /**\r\n   * Renders a scene\r\n   * @param ctx - Drawing context\r\n   */\r\n  render(\r\n    ctx: DrawContext,\r\n    renderCamera?: Nullable<Camera>,\r\n    cullCamera?: Nullable<Camera>,\r\n    renderQueue?: RenderQueue\r\n  ) {\r\n    ctx.renderPass = this;\r\n    this.drawScene(ctx, renderCamera ?? ctx.camera, cullCamera ?? renderCamera ?? ctx.camera, renderQueue);\r\n  }\r\n  /** @internal */\r\n  getGlobalBindGroupHash(ctx: DrawContext, camera: Camera) {\r\n    return `${this.constructor.name}:${this._getGlobalBindGroupHash(ctx, camera)}`;\r\n  }\r\n  /** @internal */\r\n  protected abstract _getGlobalBindGroupHash(ctx: DrawContext, camera: Camera): string;\r\n  /** @internal */\r\n  protected abstract renderItems(ctx: DrawContext, renderCamera: Camera, renderQueue: RenderQueue): void;\r\n  /** @internal */\r\n  protected drawScene(ctx: DrawContext, renderCamera: Camera, cullCamera: Camera, renderQueue?: RenderQueue) {\r\n    const device = ctx.device;\r\n    this.clearFramebuffer();\r\n    const rq = renderQueue ?? this.cullScene(ctx, cullCamera);\r\n    if (rq) {\r\n      const windingReversed = device.isWindingOrderReversed();\r\n      device.reverseVertexWindingOrder(this.isAutoFlip(ctx) ? !windingReversed : windingReversed);\r\n      this.renderItems(ctx, renderCamera, rq);\r\n      device.reverseVertexWindingOrder(windingReversed);\r\n      if (rq !== renderQueue) {\r\n        rq.dispose();\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Culls a scene by a given camera\r\n   * @param ctx - The draw context\r\n   * @param cullCamera - The camera that will be used to cull the scene\r\n   * @returns The cull result\r\n   */\r\n  cullScene(ctx: DrawContext, cullCamera: Camera) {\r\n    const renderQueue = new RenderQueue(this);\r\n    const cullVisitor = new CullVisitor(this, cullCamera, renderQueue);\r\n    if (ctx.scene.octree) {\r\n      ctx.scene.octree.getRootNode().traverse(cullVisitor);\r\n    } else {\r\n      ctx.scene.rootNode.traverse(cullVisitor);\r\n    }\r\n    renderQueue.end(cullCamera);\r\n    ctx.sunLight = renderQueue.sunLight;\r\n    ctx.primaryDirectionalLight = renderQueue.primaryDirectionalLight;\r\n    ctx.primaryTransmissionLight = renderQueue.primaryTransmissionLight;\r\n    return renderQueue;\r\n  }\r\n  /** @internal */\r\n  private internalDrawItemList(\r\n    ctx: DrawContext,\r\n    items: RenderQueueItem[],\r\n    renderQueue: Nullable<RenderQueue>,\r\n    renderBundle: Nullable<RenderBundleWrapper>,\r\n    reverseWinding: boolean,\r\n    hash: string\r\n  ) {\r\n    let recording = false;\r\n    const disableRenderBundles = this.shouldDisableRenderBundles(ctx);\r\n    if (renderBundle && ctx.camera.commandBufferReuse && !disableRenderBundles) {\r\n      const bundle = renderBundle.getRenderBundle(hash);\r\n      if (bundle) {\r\n        ctx.device.executeRenderBundle(bundle);\r\n        return;\r\n      }\r\n      recording = true;\r\n      renderBundle.beginRenderBundle();\r\n    }\r\n    for (const item of items) {\r\n      ctx.instanceData = item.instanceData;\r\n      const reverse = reverseWinding !== item.drawable.getNode().worldMatrixDet < 0;\r\n      if (reverse) {\r\n        ctx.device.reverseVertexWindingOrder(!ctx.device.isWindingOrderReversed());\r\n      }\r\n      if (recording) {\r\n        RenderBundleWrapper.addDrawable(\r\n          item.drawable,\r\n          item.drawable.getMaterial()?.coreMaterial!,\r\n          item.drawable.getPrimitive()!,\r\n          renderBundle!,\r\n          hash\r\n        );\r\n      }\r\n      item.drawable.draw(ctx, renderQueue, recording || disableRenderBundles ? undefined : hash);\r\n      if (reverse) {\r\n        ctx.device.reverseVertexWindingOrder(!ctx.device.isWindingOrderReversed());\r\n      }\r\n    }\r\n    if (renderBundle && ctx.camera.commandBufferReuse && !disableRenderBundles) {\r\n      renderBundle.endRenderBundle(hash);\r\n    }\r\n  }\r\n  private shouldDisableRenderBundles(ctx: DrawContext) {\r\n    return (\r\n      (ctx.renderPass?.type === RENDER_PASS_TYPE_LIGHT &&\r\n        (!!ctx.SSS || !!ctx.currentShadowLight || !!ctx.lightBlending)) ||\r\n      false\r\n    );\r\n  }\r\n  /** @internal */\r\n  protected drawItemList(itemList: RenderItemListInfo, ctx: DrawContext, reverseWinding: boolean) {\r\n    ctx.instanceData = null;\r\n    const windingHash = reverseWinding ? '1' : '0';\r\n    const bindGroupHash = ctx.device.getBindGroup(0)[0].getGPUId();\r\n    const framebufferHash = ctx.device.getFramebuffer()?.getHash() ?? '';\r\n    const ctxHash = `${ctx.sceneColorTexture?.uid ?? 0}-${ctx.linearDepthTexture?.uid ?? 0}`;\r\n    const hash = `${windingHash}-${bindGroupHash}-${framebufferHash}-${ctxHash}-${ctx.renderPassHash}`;\r\n    if (itemList) {\r\n      if (itemList.itemList.length > 0) {\r\n        ctx.materialFlags &= ~(\r\n          MaterialVaryingFlags.SKIN_ANIMATION |\r\n          MaterialVaryingFlags.INSTANCING |\r\n          MaterialVaryingFlags.MORPH_ANIMATION\r\n        );\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.itemList,\r\n          itemList.renderQueue,\r\n          itemList.renderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n      if (itemList.skinItemList.length > 0) {\r\n        ctx.materialFlags |= MaterialVaryingFlags.SKIN_ANIMATION;\r\n        ctx.materialFlags &= ~(MaterialVaryingFlags.MORPH_ANIMATION | MaterialVaryingFlags.INSTANCING);\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.skinItemList,\r\n          itemList.renderQueue,\r\n          itemList.skinRenderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n      if (itemList.morphItemList.length > 0) {\r\n        ctx.materialFlags |= MaterialVaryingFlags.MORPH_ANIMATION;\r\n        ctx.materialFlags &= ~(MaterialVaryingFlags.SKIN_ANIMATION | MaterialVaryingFlags.INSTANCING);\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.morphItemList,\r\n          itemList.renderQueue,\r\n          itemList.morphRenderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n      if (itemList.skinAndMorphItemList.length > 0) {\r\n        ctx.materialFlags |= MaterialVaryingFlags.SKIN_ANIMATION | MaterialVaryingFlags.MORPH_ANIMATION;\r\n        ctx.materialFlags &= ~MaterialVaryingFlags.INSTANCING;\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.skinAndMorphItemList,\r\n          itemList.renderQueue,\r\n          itemList.skinAndMorphRenderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n      if (itemList.instanceItemList.length > 0) {\r\n        ctx.materialFlags |= MaterialVaryingFlags.INSTANCING;\r\n        ctx.materialFlags &= ~(MaterialVaryingFlags.SKIN_ANIMATION | MaterialVaryingFlags.MORPH_ANIMATION);\r\n        itemList.materialList.forEach((mat) => mat.apply(ctx));\r\n        this.internalDrawItemList(\r\n          ctx,\r\n          itemList.instanceItemList,\r\n          itemList.renderQueue,\r\n          itemList.instanceRenderBundle ?? null,\r\n          reverseWinding,\r\n          hash\r\n        );\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Disposes the render pass\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this._globalBindGroups = {};\r\n  }\r\n  /** @internal */\r\n  private clearFramebuffer() {\r\n    const clearColor = (this._clearColors ?? this._clearColor) as FrameBufferClearColors;\r\n    if (clearColor || this._clearDepth || this._clearStencil) {\r\n      getDevice().clearFrameBuffer(clearColor, this._clearDepth, this._clearStencil);\r\n    }\r\n  }\r\n}\r\n"],"names":["RenderPass","Disposable","type","_type","_clearColor","Vector4","_clearColors","_clearDepth","_clearStencil","_globalBindGroups","clearColor","color","clearColors","colors","clearDepth","depth","clearStencil","stencil","isAutoFlip","ctx","device","getFramebuffer","render","renderCamera","cullCamera","renderQueue","renderPass","drawScene","camera","getGlobalBindGroupHash","name","_getGlobalBindGroupHash","clearFramebuffer","rq","cullScene","windingReversed","isWindingOrderReversed","reverseVertexWindingOrder","renderItems","dispose","RenderQueue","cullVisitor","CullVisitor","scene","octree","getRootNode","traverse","rootNode","end","sunLight","primaryDirectionalLight","primaryTransmissionLight","internalDrawItemList","items","renderBundle","reverseWinding","hash","recording","disableRenderBundles","shouldDisableRenderBundles","commandBufferReuse","bundle","getRenderBundle","executeRenderBundle","beginRenderBundle","item","instanceData","reverse","drawable","getNode","worldMatrixDet","RenderBundleWrapper","addDrawable","getMaterial","coreMaterial","getPrimitive","draw","undefined","endRenderBundle","RENDER_PASS_TYPE_LIGHT","SSS","currentShadowLight","lightBlending","itemList","windingHash","bindGroupHash","getBindGroup","getGPUId","framebufferHash","getHash","ctxHash","sceneColorTexture","uid","linearDepthTexture","renderPassHash","length","materialFlags","MaterialVaryingFlags","SKIN_ANIMATION","INSTANCING","MORPH_ANIMATION","materialList","forEach","mat","apply","skinItemList","skinRenderBundle","morphItemList","morphRenderBundle","skinAndMorphItemList","skinAndMorphRenderBundle","instanceItemList","instanceRenderBundle","onDispose","getDevice","clearFrameBuffer"],"mappings":"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"}

package/dist/render/shadow_mask_pass.js

@@ -0,0 +1,297 @@
+import { Vector2, Vector4 } from '@zephyr3d/base';
+import { ShaderHelper } from '../material/shader/helper.js';
+import { drawFullscreenQuad } from './fullscreenquad.js';
+import { MAX_SHADOW_MASK_LIGHTS } from '../values.js';
+
+const UNIFORM_NAME_SHADOW_MAP = 'Z_UniformShadowMap';
+/**
+ * Number of shadow-casting lights packed into a single RGBA8 mask array layer.
+ * One light per color channel.
+ */ const SHADOW_MASK_LIGHTS_PER_LAYER = 4;
+/**
+ * Maximum number of shadow mask array layers, derived from the per-light cap.
+ */ const MAX_SHADOW_MASK_LAYERS = MAX_SHADOW_MASK_LIGHTS / SHADOW_MASK_LIGHTS_PER_LAYER;
+/**
+ * Renders the screen-space shadow mask for the Forward+ pipeline.
+ *
+ * For each shadow-casting light, the light's visibility factor `[0,1]` (1 = lit,
+ * 0 = fully shadowed) is reconstructed from the linear depth prepass and written
+ * into one channel of one layer of an `rgba8unorm` texture array. Four lights are
+ * packed per layer (one per RGBA channel).
+ *
+ * The layer/channel assignment must stay in lockstep with
+ * {@link ClusteredLight.getVisibleLights}: shadow-casting lights occupy clustered
+ * buffer indices `1..N` in the order of `renderQueue.shadowedLights`. The zero-based
+ * light ordinal `s = index - 1` maps to `layer = s >> 2`, `channel = s & 3`. The
+ * clustered shading pass recovers the same mapping from a light's buffer index, so
+ * no per-light mask index is stored.
+ *
+ * @internal
+ */ class ShadowMaskRenderer {
+    /** Fullscreen mask programs keyed by a per-light shader signature. */ _programs;
+    /** Bind groups paired with each cached program. */ _bindGroups;
+    /** One render state per RGBA channel (color mask selects the target channel). */ _channelStates;
+    _nearFar;
+    _cameraPosition;
+    _cameraParams;
+    constructor(){
+        this._programs = new Map();
+        this._bindGroups = new Map();
+        this._channelStates = null;
+        this._nearFar = new Vector2();
+        this._cameraPosition = new Vector4();
+        this._cameraParams = new Vector4();
+    }
+    /**
+   * Number of array layers required to hold `numLights` shadow lights.
+   * @param numLights - Number of shadow-casting lights.
+   * @returns Layer count, clamped to {@link MAX_SHADOW_MASK_LAYERS}.
+   */ static getLayerCount(numLights) {
+        const n = Math.min(numLights, MAX_SHADOW_MASK_LIGHTS);
+        return Math.min(Math.ceil(n / SHADOW_MASK_LIGHTS_PER_LAYER), MAX_SHADOW_MASK_LAYERS);
+    }
+    /**
+   * Render the shadow mask for the given shadow-casting lights.
+   *
+   * @param ctx - Draw context (must carry shadowMapInfo for the lights).
+   * @param depthTexture - Linear depth texture from the depth prepass.
+   * @param lights - Shadow-casting lights, in clustered-buffer order (index 1..N).
+   * @param getLayerFramebuffer - Resolves the framebuffer bound to mask array layer `k`.
+   */ render(ctx, depthTexture, lights, getLayerFramebuffer) {
+        const device = ctx.device;
+        const numLights = Math.min(lights.length, MAX_SHADOW_MASK_LIGHTS);
+        if (numLights === 0 || !ctx.shadowMapInfo) {
+            return;
+        }
+        const numLayers = ShadowMaskRenderer.getLayerCount(numLights);
+        const channelStates = this.getChannelStates(device);
+        const savedShadowLight = ctx.currentShadowLight;
+        device.pushDeviceStates();
+        for(let layer = 0; layer < numLayers; layer++){
+            const framebuffer = getLayerFramebuffer(layer);
+            device.setFramebuffer(framebuffer);
+            // Clear to "fully lit" (1 = no shadow) so channels without an assigned
+            // light, and pixels outside any shadow, read as unshadowed. The mask array
+            // has no depth attachment, so depth/stencil clear args are null.
+            device.clearFrameBuffer(new Vector4(1, 1, 1, 1), null, null);
+            for(let channel = 0; channel < SHADOW_MASK_LIGHTS_PER_LAYER; channel++){
+                const ordinal = layer * SHADOW_MASK_LIGHTS_PER_LAYER + channel;
+                if (ordinal >= numLights) {
+                    break;
+                }
+                const light = lights[ordinal];
+                const shadowMapParams = ctx.shadowMapInfo.get(light);
+                if (!shadowMapParams || !shadowMapParams.shadowMap) {
+                    continue;
+                }
+                ctx.currentShadowLight = light;
+                this.renderLightChannel(ctx, depthTexture, light, shadowMapParams, channelStates[channel]);
+            }
+        }
+        device.popDeviceStates();
+        ctx.currentShadowLight = savedShadowLight;
+    }
+    /** Render one shadow light into one color channel of the current framebuffer. */ renderLightChannel(ctx, depthTexture, light, shadowMapParams, renderState) {
+        const device = ctx.device;
+        const key = this.getProgramKey(ctx, shadowMapParams);
+        let program = this._programs.get(key) ?? null;
+        let bindGroup = this._bindGroups.get(key) ?? null;
+        if (!program) {
+            program = this.createProgram(ctx, shadowMapParams);
+            bindGroup = device.createBindGroup(program.bindGroupLayouts[0]);
+            this._programs.set(key, program);
+            this._bindGroups.set(key, bindGroup);
+        }
+        bindGroup = this._bindGroups.get(key);
+        this.setUniforms(bindGroup, ctx, depthTexture, light, shadowMapParams);
+        device.setProgram(program);
+        device.setBindGroup(0, bindGroup);
+        drawFullscreenQuad(renderState);
+    }
+    /**
+   * The program signature: distinct shadow implementations, cascade counts and
+   * shadow map types must not share a compiled program.
+   */ getProgramKey(ctx, shadowMapParams) {
+        return `${ctx.device.type}|${shadowMapParams.shaderHash}`;
+    }
+    getChannelStates(device) {
+        if (!this._channelStates) {
+            this._channelStates = [];
+            for(let c = 0; c < SHADOW_MASK_LIGHTS_PER_LAYER; c++){
+                const rs = device.createRenderStateSet();
+                rs.useDepthState().enableTest(false).enableWrite(false);
+                rs.useRasterizerState().setCullMode('none');
+                rs.useColorState().setColorMask(c === 0, c === 1, c === 2, c === 3);
+                this._channelStates.push(rs);
+            }
+        }
+        return this._channelStates;
+    }
+    setUniforms(bindGroup, ctx, depthTexture, light, shadowMapParams) {
+        const camera = ctx.camera;
+        const near = camera.getNearPlane();
+        const far = camera.getFarPlane();
+        const cameraPos = camera.getWorldPosition();
+        this._cameraPosition.setXYZW(cameraPos.x, cameraPos.y, cameraPos.z, 0);
+        this._cameraParams.setXYZW(near, far, 1, 1);
+        this._nearFar.setXY(near, far);
+        bindGroup.setValue('camera', {
+            position: this._cameraPosition,
+            params: this._cameraParams,
+            shadowDebugCascades: camera.shadowDebugCascades ? 1 : 0,
+            framestamp: ctx.device.frameInfo.frameCounter
+        });
+        // Full shadow light struct (matches helper.ts currentShadowLight lightStruct,
+        // including implParams which PCSS/VSM impls read via getShadowImplParams).
+        const implParams = new Vector4();
+        shadowMapParams.impl.getParams(implParams);
+        bindGroup.setValue('light', {
+            sunDir: ctx.sunLight ? ctx.sunLight.directionAndCutoff.xyz().scaleBy(-1) : new Vector4(0, 1, 0, 0).xyz(),
+            shadowCascades: shadowMapParams.numShadowCascades,
+            positionAndRange: light.positionAndRange,
+            directionAndCutoff: light.directionAndCutoff,
+            diffuseAndIntensity: light.diffuseAndIntensity,
+            extraParams: light.extraParams,
+            cascadeDistances: shadowMapParams.cascadeDistances,
+            depthBiasValues: shadowMapParams.depthBiasValues[0],
+            shadowCameraParams: shadowMapParams.cameraParams,
+            depthBiasScales: shadowMapParams.depthBiasScales,
+            implParams: implParams,
+            shadowMatrices: new Float32Array(shadowMapParams.shadowMatrices),
+            shadowStrength: light.shadow.shadowStrength,
+            envLightStrength: ctx.env?.light.strength ?? 0,
+            envLightSpecularStrength: ctx.env?.light.specularStrength ?? 1
+        });
+        bindGroup.setValue('invViewProjMatrix', camera.invViewProjectionMatrix);
+        bindGroup.setValue('cameraNearFar', this._nearFar);
+        bindGroup.setValue('flip', this.needFlip(ctx.device) ? 1 : 0);
+        bindGroup.setTexture('depthTex', depthTexture);
+        bindGroup.setTexture(UNIFORM_NAME_SHADOW_MAP, shadowMapParams.shadowMap, shadowMapParams.shadowMapSampler);
+    }
+    /**
+   * Whether the fullscreen output needs a vertical flip. Mask array layers are
+   * offscreen render targets, so the convention matches other offscreen passes
+   * (no flip); WebGPU still flips clip-space Y in the vertex shader.
+   */ needFlip(_device) {
+        return false;
+    }
+    createProgram(ctx, shadowMapParams) {
+        const device = ctx.device;
+        const numCascades = shadowMapParams.numShadowCascades;
+        const shadowMap = shadowMapParams.shadowMap;
+        const program = device.buildRenderProgram({
+            label: 'ShadowMask',
+            vertex (pb) {
+                this.flip = pb.int().uniform(0);
+                this.$inputs.pos = pb.vec2().attrib('position');
+                this.$outputs.uv = pb.vec2();
+                pb.main(function() {
+                    this.$builtins.position = pb.vec4(this.$inputs.pos, 1, 1);
+                    this.$outputs.uv = pb.add(pb.mul(this.$inputs.pos.xy, 0.5), pb.vec2(0.5));
+                    this.$if(pb.notEqual(this.flip, 0), function() {
+                        this.$builtins.position.y = pb.neg(this.$builtins.position.y);
+                    });
+                    if (device.type === 'webgpu') {
+                        this.$builtins.position.y = pb.neg(this.$builtins.position.y);
+                    }
+                });
+            },
+            fragment (pb) {
+                const cameraStruct = pb.defineStruct([
+                    pb.vec4('position'),
+                    pb.vec4('params'),
+                    pb.float('shadowDebugCascades'),
+                    // Required by PCSS temporal jitter (ShaderHelper.getFramestamp).
+                    pb.int('framestamp')
+                ]);
+                // Must match helper.ts currentShadowLight lightStruct field-for-field.
+                const lightStruct = pb.defineStruct([
+                    pb.vec3('sunDir'),
+                    pb.int('shadowCascades'),
+                    pb.vec4('positionAndRange'),
+                    pb.vec4('directionAndCutoff'),
+                    pb.vec4('diffuseAndIntensity'),
+                    pb.vec4('extraParams'),
+                    pb.vec4('cascadeDistances'),
+                    pb.vec4('depthBiasValues'),
+                    pb.vec4('shadowCameraParams'),
+                    pb.vec4('depthBiasScales'),
+                    pb.vec4('implParams'),
+                    pb.vec4[16]('shadowMatrices'),
+                    pb.float('shadowStrength'),
+                    pb.float('envLightStrength'),
+                    pb.float('envLightSpecularStrength')
+                ]);
+                this.camera = cameraStruct().uniform(0);
+                this.light = lightStruct().uniform(0);
+                const shadowTex = shadowMap.isTextureCube() ? shadowMap.isDepth() ? pb.texCubeShadow() : pb.texCube() : shadowMap.isTexture2D() ? shadowMap.isDepth() ? pb.tex2DShadow() : pb.tex2D() : shadowMap.isDepth() ? pb.tex2DArrayShadow() : pb.tex2DArray();
+                if (!shadowMap.isDepth() && !device.getDeviceCaps().textureCaps.getTextureFormatInfo(shadowMap.format).filterable) {
+                    shadowTex.sampleType('unfilterable-float');
+                }
+                this[UNIFORM_NAME_SHADOW_MAP] = shadowTex.uniform(0);
+                this.depthTex = pb.tex2D().uniform(0);
+                this.invViewProjMatrix = pb.mat4().uniform(0);
+                this.cameraNearFar = pb.vec2().uniform(0);
+                this.$outputs.color = pb.vec4();
+                // Explicit-depth cascade selection (fragCoord.z is invalid in a fullscreen
+                // pass). Mirrors posteffect/sss.ts calculateTransmissionShadow.
+                pb.func('zShadowMaskFactor', [
+                    pb.vec3('worldPos'),
+                    pb.float('depth01'),
+                    pb.float('NoL')
+                ], function() {
+                    if (numCascades > 1) {
+                        this.$l.linearDepth = pb.mul(this.depth01, this.camera.params.y);
+                        this.$l.splitDistances = this.light.cascadeDistances;
+                        this.$l.comparison = pb.vec4(pb.greaterThan(pb.vec4(this.linearDepth), this.splitDistances));
+                        this.$l.cascadeFlags = pb.vec4(pb.float(pb.greaterThan(this.light.shadowCascades, 0)), pb.float(pb.greaterThan(this.light.shadowCascades, 1)), pb.float(pb.greaterThan(this.light.shadowCascades, 2)), pb.float(pb.greaterThan(this.light.shadowCascades, 3)));
+                        this.$l.split = pb.int(pb.dot(this.comparison, this.cascadeFlags));
+                        if (device.type === 'webgl') {
+                            this.$l.shadowVertex = pb.vec4();
+                            this.$for(pb.int('cascade'), 0, 4, function() {
+                                this.$if(pb.equal(this.cascade, this.split), function() {
+                                    this.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.worldPos, 1), this.cascade);
+                                    this.$break();
+                                });
+                            });
+                        } else {
+                            this.$l.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.worldPos, 1), this.split);
+                        }
+                        this.$l.shadow = shadowMapParams.impl.computeShadowCSM(shadowMapParams, this, this.shadowVertex, this.NoL, this.split);
+                        this.$l.shadowDistance = this.light.shadowCameraParams.w;
+                        this.shadow = pb.mix(this.shadow, 1, pb.smoothStep(pb.mul(this.shadowDistance, 0.8), this.shadowDistance, pb.distance(this.camera.position.xyz, this.worldPos)));
+                        this.shadow = pb.mix(1, this.shadow, this.light.shadowStrength);
+                        this.$return(pb.clamp(this.shadow, 0, 1));
+                    } else {
+                        this.$l.shadowVertex = ShaderHelper.calculateShadowSpaceVertex(this, pb.vec4(this.worldPos, 1));
+                        this.$l.shadow = shadowMapParams.impl.computeShadow(shadowMapParams, this, this.shadowVertex, this.NoL);
+                        this.$l.shadowDistance = this.light.shadowCameraParams.w;
+                        this.shadow = pb.mix(this.shadow, 1, pb.smoothStep(pb.mul(this.shadowDistance, 0.8), this.shadowDistance, pb.distance(this.camera.position.xyz, this.worldPos)));
+                        this.shadow = pb.mix(1, this.shadow, this.light.shadowStrength);
+                        this.$return(pb.clamp(this.shadow, 0, 1));
+                    }
+                });
+                pb.main(function() {
+                    this.$l.pos = ShaderHelper.samplePositionFromDepth(this, this.depthTex, this.$inputs.uv, this.invViewProjMatrix, this.cameraNearFar);
+                    // NoL is unavailable in a fullscreen pass (no geometric normal); it only
+                    // feeds normal-offset bias, so a conservative 1.0 is used.
+                    this.$l.factor = this.zShadowMaskFactor(this.pos.xyz, this.pos.w, pb.float(1));
+                    this.$outputs.color = pb.vec4(this.factor);
+                });
+            }
+        });
+        program.name = '@ShadowMask';
+        return program;
+    }
+    /** Release cached GPU resources. */ dispose() {
+        for (const program of this._programs.values()){
+            program.dispose();
+        }
+        this._programs.clear();
+        this._bindGroups.clear();
+        this._channelStates = null;
+    }
+}
+
+export { MAX_SHADOW_MASK_LAYERS, SHADOW_MASK_LIGHTS_PER_LAYER, ShadowMaskRenderer };
+//# sourceMappingURL=shadow_mask_pass.js.map