@zephyr3d/scene 0.9.22 → 0.9.24

package/dist/render/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","sources":["../../src/render/renderer.ts"],"sourcesContent":["import { CopyBlitter } from '../blitter';\r\nimport type { DrawContext } from './drawable';\r\nimport type { Scene } from '../scene';\r\nimport type { Camera } from '../camera';\r\nimport { GlobalBindGroupAllocator } from './globalbindgroup_allocator';\r\nimport { fetchSampler } from '../utility/misc';\r\nimport { getDevice } from '../app/api';\r\nimport { executeForwardPlusGraph } from './rendergraph/forward_plus_builder';\r\n\r\n/**\r\n * Forward render scheme\r\n * @internal\r\n */\r\nexport class SceneRenderer {\r\n  /**\r\n   * Renders a scene by given camera\r\n   * @param scene - The scene to render\r\n   * @param camera - The camera that will be used to render the scene\r\n   */\r\n  static renderScene(scene: Scene, camera: Camera): void {\r\n    const device = getDevice();\r\n    const halfFloatColorBuffer = device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer;\r\n    const colorFormat = camera.HDR && halfFloatColorBuffer ? 'rgba16f' : 'rgba8unorm';\r\n    const depthFormat = device.getDeviceCaps().framebufferCaps.supportDepth32floatStencil8\r\n      ? 'd32fs8'\r\n      : 'd24s8';\r\n    const globalBindGroupAllocator = GlobalBindGroupAllocator.get();\r\n    scene.frameUpdate();\r\n    scene.frameUpdatePerCamera(camera);\r\n    if (camera && !device.isContextLost()) {\r\n      const defaultViewport = (!camera.TAA || device.type === 'webgl') && !camera.viewport && !camera.scissor;\r\n      const renderX = camera.viewport ? device.screenXToDevice(camera.viewport[0]) : 0;\r\n      const renderY = camera.viewport ? device.screenYToDevice(camera.viewport[1]) : 0;\r\n      const renderWidth = camera.viewport\r\n        ? device.screenXToDevice(camera.viewport[2])\r\n        : device.getDrawingBufferWidth();\r\n      const renderHeight = camera.viewport\r\n        ? device.screenYToDevice(camera.viewport[3])\r\n        : device.getDrawingBufferHeight();\r\n      if (renderWidth > 0 && renderHeight > 0) {\r\n        const tmpFramebuffer = defaultViewport\r\n          ? null\r\n          : device.pool.fetchTemporalFramebuffer(false, renderWidth, renderHeight, colorFormat, depthFormat);\r\n        const originFramebuffer = device.getFramebuffer();\r\n        if (tmpFramebuffer) {\r\n          device.pushDeviceStates();\r\n          device.setFramebuffer(tmpFramebuffer);\r\n        }\r\n        device.clearFrameBuffer(camera.clearColor, camera.clearDepth, camera.clearStencil);\r\n        const SSR = camera.SSR && scene.env.light.envLight && scene.env.light.envLight.hasRadiance();\r\n        const SSS = camera.SSS;\r\n        const ctx: DrawContext = {\r\n          device,\r\n          scene,\r\n          renderWidth,\r\n          renderHeight,\r\n          oit: null,\r\n          motionVectors:\r\n            device.type !== 'webgl' && (camera.TAA || camera.motionBlur || (SSR && camera.ssrTemporal)),\r\n          HiZ: camera.HiZ && device.type !== 'webgl',\r\n          HiZTexture: null,\r\n          // WebGL1 has no 2D array textures; degrade gracefully to the legacy\r\n          // per-light additive shadow path (mirrors the HiZ gating above).\r\n          screenSpaceShadowMask: camera.screenSpaceShadowMask && device.type !== 'webgl',\r\n          globalBindGroupAllocator,\r\n          camera,\r\n          compositor: camera.compositor,\r\n          queue: 0,\r\n          lightBlending: false,\r\n          renderPass: null,\r\n          renderPassHash: null,\r\n          flip: false,\r\n          depthFormat,\r\n          colorFormat,\r\n          drawEnvLight: false,\r\n          env: null,\r\n          sunLight: null,\r\n          primaryDirectionalLight: null,\r\n          primaryTransmissionLight: null,\r\n          materialFlags: 0,\r\n          SSR,\r\n          SSS,\r\n          SSRCalcThickness: SSR && camera.ssrCalcThickness,\r\n          // SSR roughness/normal MRT textures are render graph resources\r\n          // created by the LightPass; resolved into these fields at execution.\r\n          SSRRoughnessTexture: null,\r\n          SSRNormalTexture: null,\r\n          SSSProfileTexture: null,\r\n          SSSParamTexture: null,\r\n          SSSDiffuseTexture: null,\r\n          SSSTransmissionTexture: null,\r\n          SkinSSSTexture: null,\r\n          ssrSDFBoxBuffer: null,\r\n          ssrSDFBoxCount: 0,\r\n          finalFramebuffer: device.getFramebuffer(),\r\n          intermediateFramebuffer: null\r\n        };\r\n        this._renderScene(ctx);\r\n        if (tmpFramebuffer) {\r\n          device.popDeviceStates();\r\n          const oversizedViewport =\r\n            renderX < 0 ||\r\n            renderY < 0 ||\r\n            renderX + renderWidth > device.getDrawingBufferWidth() ||\r\n            renderY + renderHeight > device.getDrawingBufferHeight();\r\n          const blitter = new CopyBlitter();\r\n          if (oversizedViewport) {\r\n            blitter.destRect = [renderX, renderY, renderWidth, renderHeight];\r\n          } else {\r\n            blitter.viewport = camera.viewport ? camera.viewport.slice() : null;\r\n          }\r\n          blitter.scissor = camera.scissor ? camera.scissor.slice() : null;\r\n          blitter.srgbOut = !originFramebuffer;\r\n          blitter.blit(\r\n            tmpFramebuffer.getColorAttachments()[0],\r\n            originFramebuffer ?? null,\r\n            fetchSampler('clamp_nearest_nomip')\r\n          );\r\n          device.pool.releaseFrameBuffer(tmpFramebuffer);\r\n        }\r\n      } else {\r\n        camera.getPickResultResolveFunc()?.(null);\r\n        return;\r\n      }\r\n    }\r\n    GlobalBindGroupAllocator.release(globalBindGroupAllocator);\r\n  }\r\n\r\n  /** @internal */\r\n  protected static _renderScene(ctx: DrawContext): void {\r\n    executeForwardPlusGraph(ctx);\r\n  }\r\n}\r\n"],"names":["SceneRenderer","renderScene","scene","camera","device","getDevice","halfFloatColorBuffer","getDeviceCaps","textureCaps","supportHalfFloatColorBuffer","colorFormat","HDR","depthFormat","framebufferCaps","supportDepth32floatStencil8","globalBindGroupAllocator","GlobalBindGroupAllocator","get","frameUpdate","frameUpdatePerCamera","isContextLost","defaultViewport","TAA","type","viewport","scissor","renderX","screenXToDevice","renderY","screenYToDevice","renderWidth","getDrawingBufferWidth","renderHeight","getDrawingBufferHeight","tmpFramebuffer","pool","fetchTemporalFramebuffer","originFramebuffer","getFramebuffer","pushDeviceStates","setFramebuffer","clearFrameBuffer","clearColor","clearDepth","clearStencil","SSR","env","light","envLight","hasRadiance","SSS","ctx","oit","motionVectors","motionBlur","ssrTemporal","HiZ","HiZTexture","screenSpaceShadowMask","compositor","queue","lightBlending","renderPass","renderPassHash","flip","drawEnvLight","sunLight","primaryDirectionalLight","primaryTransmissionLight","materialFlags","SSRCalcThickness","ssrCalcThickness","SSRRoughnessTexture","SSRNormalTexture","SSSProfileTexture","SSSParamTexture","SSSDiffuseTexture","SSSTransmissionTexture","SkinSSSTexture","ssrSDFBoxBuffer","ssrSDFBoxCount","finalFramebuffer","intermediateFramebuffer","_renderScene","popDeviceStates","oversizedViewport","blitter","CopyBlitter","destRect","slice","srgbOut","blit","getColorAttachments","fetchSampler","releaseFrameBuffer","getPickResultResolveFunc","release","executeForwardPlusGraph"],"mappings":"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"}
+{"version":3,"file":"renderer.js","sources":["../../src/render/renderer.ts"],"sourcesContent":["import { CopyBlitter } from '../blitter';\r\nimport type { DrawContext } from './drawable';\r\nimport type { Scene } from '../scene';\r\nimport type { Camera } from '../camera';\r\nimport { GlobalBindGroupAllocator } from './globalbindgroup_allocator';\r\nimport { fetchSampler } from '../utility/misc';\r\nimport { getDevice } from '../app/api';\r\nimport { executeForwardPlusGraph } from './rendergraph/forward_plus_builder';\r\n\r\n/**\r\n * Forward render scheme\r\n * @internal\r\n */\r\nexport class SceneRenderer {\r\n  /**\r\n   * Renders a scene by given camera\r\n   * @param scene - The scene to render\r\n   * @param camera - The camera that will be used to render the scene\r\n   */\r\n  static renderScene(scene: Scene, camera: Camera): void {\r\n    const device = getDevice();\r\n    const halfFloatColorBuffer = device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer;\r\n    const colorFormat = camera.HDR && halfFloatColorBuffer ? 'rgba16f' : 'rgba8unorm';\r\n    const depthFormat = device.getDeviceCaps().framebufferCaps.supportDepth32floatStencil8\r\n      ? 'd32fs8'\r\n      : 'd24s8';\r\n    const globalBindGroupAllocator = GlobalBindGroupAllocator.get();\r\n    scene.frameUpdate();\r\n    scene.frameUpdatePerCamera(camera);\r\n    if (camera && !device.isContextLost()) {\r\n      const defaultViewport = (!camera.TAA || device.type === 'webgl') && !camera.viewport && !camera.scissor;\r\n      const renderX = camera.viewport ? device.screenXToDevice(camera.viewport[0]) : 0;\r\n      const renderY = camera.viewport ? device.screenYToDevice(camera.viewport[1]) : 0;\r\n      const renderWidth = camera.viewport\r\n        ? device.screenXToDevice(camera.viewport[2])\r\n        : device.getDrawingBufferWidth();\r\n      const renderHeight = camera.viewport\r\n        ? device.screenYToDevice(camera.viewport[3])\r\n        : device.getDrawingBufferHeight();\r\n      if (renderWidth > 0 && renderHeight > 0) {\r\n        const tmpFramebuffer = defaultViewport\r\n          ? null\r\n          : device.pool.fetchTemporalFramebuffer(false, renderWidth, renderHeight, colorFormat, depthFormat);\r\n        const originFramebuffer = device.getFramebuffer();\r\n        if (tmpFramebuffer) {\r\n          device.pushDeviceStates();\r\n          device.setFramebuffer(tmpFramebuffer);\r\n        }\r\n        device.clearFrameBuffer(camera.clearColor, camera.clearDepth, camera.clearStencil);\r\n        const SSR = camera.SSR && scene.env.light.envLight && scene.env.light.envLight.hasRadiance();\r\n        const SSGI =\r\n          camera.SSGI &&\r\n          camera.HDR &&\r\n          camera.ssgiIntensity > 0 &&\r\n          scene.env.light.type === 'ibl' &&\r\n          !!scene.env.light.envLight?.hasRadiance() &&\r\n          !!scene.env.light.envLight?.hasIrradiance();\r\n        const SSS = camera.SSS;\r\n        const ctx: DrawContext = {\r\n          device,\r\n          scene,\r\n          renderWidth,\r\n          renderHeight,\r\n          oit: null,\r\n          motionVectors:\r\n            device.type !== 'webgl' && (camera.TAA || camera.motionBlur || (SSR && camera.ssrTemporal)),\r\n          HiZ: camera.HiZ && device.type !== 'webgl',\r\n          HiZTexture: null,\r\n          // WebGL1 has no 2D array textures; degrade gracefully to the legacy\r\n          // per-light additive shadow path (mirrors the HiZ gating above).\r\n          screenSpaceShadowMask: camera.screenSpaceShadowMask && device.type !== 'webgl',\r\n          globalBindGroupAllocator,\r\n          camera,\r\n          compositor: camera.compositor,\r\n          queue: 0,\r\n          lightBlending: false,\r\n          renderPass: null,\r\n          renderPassHash: null,\r\n          shaderVariantHash: null,\r\n          flip: false,\r\n          depthFormat,\r\n          colorFormat,\r\n          drawEnvLight: false,\r\n          env: null,\r\n          sunLight: null,\r\n          primaryDirectionalLight: null,\r\n          primaryTransmissionLight: null,\r\n          materialFlags: 0,\r\n          SSR,\r\n          SSGI,\r\n          SSGIIrradianceHistoryTexture: null,\r\n          SSGISurfaceHistoryTexture: null,\r\n          SSS,\r\n          SSRCalcThickness: SSR && camera.ssrCalcThickness,\r\n          // Surface roughness/normal MRT textures are render graph resources\r\n          // created by the LightPass; resolved into these fields at execution.\r\n          SceneRoughnessTexture: null,\r\n          SceneNormalTexture: null,\r\n          SSSProfileTexture: null,\r\n          SSSParamTexture: null,\r\n          SSSDiffuseTexture: null,\r\n          SSSTransmissionTexture: null,\r\n          SkinSSSTexture: null,\r\n          ssrSDFBoxBuffer: null,\r\n          ssrSDFBoxCount: 0,\r\n          finalFramebuffer: device.getFramebuffer(),\r\n          intermediateFramebuffer: null\r\n        };\r\n        this._renderScene(ctx);\r\n        if (tmpFramebuffer) {\r\n          device.popDeviceStates();\r\n          const oversizedViewport =\r\n            renderX < 0 ||\r\n            renderY < 0 ||\r\n            renderX + renderWidth > device.getDrawingBufferWidth() ||\r\n            renderY + renderHeight > device.getDrawingBufferHeight();\r\n          const blitter = new CopyBlitter();\r\n          if (oversizedViewport) {\r\n            blitter.destRect = [renderX, renderY, renderWidth, renderHeight];\r\n          } else {\r\n            blitter.viewport = camera.viewport ? camera.viewport.slice() : null;\r\n          }\r\n          blitter.scissor = camera.scissor ? camera.scissor.slice() : null;\r\n          blitter.srgbOut = !originFramebuffer;\r\n          blitter.blit(\r\n            tmpFramebuffer.getColorAttachments()[0],\r\n            originFramebuffer ?? null,\r\n            fetchSampler('clamp_nearest_nomip')\r\n          );\r\n          device.pool.releaseFrameBuffer(tmpFramebuffer);\r\n        }\r\n      } else {\r\n        camera.getPickResultResolveFunc()?.(null);\r\n        return;\r\n      }\r\n    }\r\n    GlobalBindGroupAllocator.release(globalBindGroupAllocator);\r\n  }\r\n\r\n  /** @internal */\r\n  protected static _renderScene(ctx: DrawContext): void {\r\n    executeForwardPlusGraph(ctx);\r\n  }\r\n}\r\n"],"names":["SceneRenderer","renderScene","scene","camera","device","getDevice","halfFloatColorBuffer","getDeviceCaps","textureCaps","supportHalfFloatColorBuffer","colorFormat","HDR","depthFormat","framebufferCaps","supportDepth32floatStencil8","globalBindGroupAllocator","GlobalBindGroupAllocator","get","frameUpdate","frameUpdatePerCamera","isContextLost","defaultViewport","TAA","type","viewport","scissor","renderX","screenXToDevice","renderY","screenYToDevice","renderWidth","getDrawingBufferWidth","renderHeight","getDrawingBufferHeight","tmpFramebuffer","pool","fetchTemporalFramebuffer","originFramebuffer","getFramebuffer","pushDeviceStates","setFramebuffer","clearFrameBuffer","clearColor","clearDepth","clearStencil","SSR","env","light","envLight","hasRadiance","SSGI","ssgiIntensity","hasIrradiance","SSS","ctx","oit","motionVectors","motionBlur","ssrTemporal","HiZ","HiZTexture","screenSpaceShadowMask","compositor","queue","lightBlending","renderPass","renderPassHash","shaderVariantHash","flip","drawEnvLight","sunLight","primaryDirectionalLight","primaryTransmissionLight","materialFlags","SSGIIrradianceHistoryTexture","SSGISurfaceHistoryTexture","SSRCalcThickness","ssrCalcThickness","SceneRoughnessTexture","SceneNormalTexture","SSSProfileTexture","SSSParamTexture","SSSDiffuseTexture","SSSTransmissionTexture","SkinSSSTexture","ssrSDFBoxBuffer","ssrSDFBoxCount","finalFramebuffer","intermediateFramebuffer","_renderScene","popDeviceStates","oversizedViewport","blitter","CopyBlitter","destRect","slice","srgbOut","blit","getColorAttachments","fetchSampler","releaseFrameBuffer","getPickResultResolveFunc","release","executeForwardPlusGraph"],"mappings":"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"}

package/dist/render/rendergraph/blackboard.js

@@ -1,76 +1,48 @@
-/**
- * Canonical names for well-known per-frame resources shared through {@link RGBlackboard}.
- *
- * Producer passes register their output handles under these names so that
- * consumers (e.g. post effects) can declare reads without hard-coupling to
- * the pass that produced them.
- *
- * @public
- */ const FrameResources = {
+/** Well-known frame resource names shared through {@link RGBlackboard}. @public */ const FrameResources = {
     SceneColor: 'sceneColor',
     SceneColorCopy: 'sceneColorCopy',
+    /**
+   * Opaque scene color with sky but before height fog is composited.
+   *
+   * Screen-space passes read this as the outgoing radiance of a traced hit. Fog
+   * along the camera-to-hit ray is unrelated to the shading-point-to-hit path
+   * those passes integrate, and sampling it would both tint hits with the fog
+   * color and feed back into the next frame. Only published when fog is present
+   * and a consumer needs it.
+   */ SceneColorNoFog: 'sceneColorNoFog',
     LinearDepth: 'linearDepth',
     SceneDepthAttachment: 'sceneDepthAttachment',
     MotionVector: 'motionVector',
     HiZ: 'hiZ',
-    SSRRoughness: 'ssrRoughness',
-    SSRNormal: 'ssrNormal',
+    SceneRoughness: 'sceneRoughness',
+    SceneNormal: 'sceneNormal',
     SSSProfile: 'sssProfile',
     SSSParam: 'sssParam',
     SSSDiffuse: 'sssDiffuse',
     SSSTransmission: 'sssTransmission',
     SkinSSS: 'skinSSS',
-    ShadowMask: 'shadowMask'
+    ShadowMask: 'shadowMask',
+    /** Final presented color. The last registration becomes the graph sink. */ PresentedColor: 'presentedColor'
 };
-/**
- * Named registry of render graph resource handles for the current frame.
- *
- * The blackboard decouples resource producers from consumers: passes that
- * create shared resources register the returned handles by name, and later
- * passes look them up to declare read dependencies. This replaces passing
- * textures through mutable `DrawContext` fields.
- *
- * A blackboard instance is valid for a single graph build; create a new one
- * (or clear it) every frame together with the graph.
- *
- * @public
- */ class RGBlackboard {
+/** Per-frame registry of named render graph resources. @public */ class RGBlackboard {
     /** @internal */ _handles = new Map();
-    /**
-   * Register a resource handle under a name, replacing any previous entry.
-   * @param name - Resource name, typically one of {@link FrameResources}.
-   * @param handle - The handle to register.
-   */ set(name, handle) {
+    /** Register or replace a resource handle. */ set(name, handle) {
         this._handles.set(name, handle);
     }
-    /**
-   * Look up a resource handle by name.
-   * @param name - Resource name, typically one of {@link FrameResources}.
-   * @returns The registered handle, or null if not present this frame.
-   */ get(name) {
+    /** Return a resource handle, or null when absent. */ get(name) {
         return this._handles.get(name) ?? null;
     }
-    /**
-   * Check whether a resource is registered.
-   * @param name - Resource name.
-   * @returns true if a handle is registered under the name.
-   */ has(name) {
+    /** Check whether a resource is registered. */ has(name) {
         return this._handles.has(name);
     }
-    /**
-   * Look up a resource handle that must exist.
-   * @param name - Resource name.
-   * @returns The registered handle.
-   */ expect(name) {
+    /** Return a required resource handle. */ expect(name) {
         const handle = this._handles.get(name);
         if (!handle) {
             throw new Error(`RGBlackboard: required frame resource "${name}" was not registered`);
         }
         return handle;
     }
-    /**
-   * Remove all registered handles.
-   */ clear() {
+    /** Remove all registered handles. */ clear() {
         this._handles.clear();
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"blackboard.js","sources":["../../../src/render/rendergraph/blackboard.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\r\nimport type { RGHandle } from './types';\r\n\r\n/**\r\n * Canonical names for well-known per-frame resources shared through {@link RGBlackboard}.\r\n *\r\n * Producer passes register their output handles under these names so that\r\n * consumers (e.g. post effects) can declare reads without hard-coupling to\r\n * the pass that produced them.\r\n *\r\n * @public\r\n */\r\nexport const FrameResources = {\r\n  SceneColor: 'sceneColor',\r\n  SceneColorCopy: 'sceneColorCopy',\r\n  LinearDepth: 'linearDepth',\r\n  SceneDepthAttachment: 'sceneDepthAttachment',\r\n  MotionVector: 'motionVector',\r\n  HiZ: 'hiZ',\r\n  SSRRoughness: 'ssrRoughness',\r\n  SSRNormal: 'ssrNormal',\r\n  SSSProfile: 'sssProfile',\r\n  SSSParam: 'sssParam',\r\n  SSSDiffuse: 'sssDiffuse',\r\n  SSSTransmission: 'sssTransmission',\r\n  SkinSSS: 'skinSSS',\r\n  ShadowMask: 'shadowMask'\r\n} as const;\r\n\r\n/**\r\n * Named registry of render graph resource handles for the current frame.\r\n *\r\n * The blackboard decouples resource producers from consumers: passes that\r\n * create shared resources register the returned handles by name, and later\r\n * passes look them up to declare read dependencies. This replaces passing\r\n * textures through mutable `DrawContext` fields.\r\n *\r\n * A blackboard instance is valid for a single graph build; create a new one\r\n * (or clear it) every frame together with the graph.\r\n *\r\n * @public\r\n */\r\nexport class RGBlackboard {\r\n  /** @internal */\r\n  private _handles: Map<string, RGHandle> = new Map();\r\n  /**\r\n   * Register a resource handle under a name, replacing any previous entry.\r\n   * @param name - Resource name, typically one of {@link FrameResources}.\r\n   * @param handle - The handle to register.\r\n   */\r\n  set(name: string, handle: RGHandle): void {\r\n    this._handles.set(name, handle);\r\n  }\r\n  /**\r\n   * Look up a resource handle by name.\r\n   * @param name - Resource name, typically one of {@link FrameResources}.\r\n   * @returns The registered handle, or null if not present this frame.\r\n   */\r\n  get(name: string): Nullable<RGHandle> {\r\n    return this._handles.get(name) ?? null;\r\n  }\r\n  /**\r\n   * Check whether a resource is registered.\r\n   * @param name - Resource name.\r\n   * @returns true if a handle is registered under the name.\r\n   */\r\n  has(name: string): boolean {\r\n    return this._handles.has(name);\r\n  }\r\n  /**\r\n   * Look up a resource handle that must exist.\r\n   * @param name - Resource name.\r\n   * @returns The registered handle.\r\n   */\r\n  expect(name: string): RGHandle {\r\n    const handle = this._handles.get(name);\r\n    if (!handle) {\r\n      throw new Error(`RGBlackboard: required frame resource \"${name}\" was not registered`);\r\n    }\r\n    return handle;\r\n  }\r\n  /**\r\n   * Remove all registered handles.\r\n   */\r\n  clear(): void {\r\n    this._handles.clear();\r\n  }\r\n}\r\n"],"names":["FrameResources","SceneColor","SceneColorCopy","LinearDepth","SceneDepthAttachment","MotionVector","HiZ","SSRRoughness","SSRNormal","SSSProfile","SSSParam","SSSDiffuse","SSSTransmission","SkinSSS","ShadowMask","RGBlackboard","_handles","Map","set","name","handle","get","has","expect","Error","clear"],"mappings":"AAGA;;;;;;;;UASaA,cAAiB,GAAA;IAC5BC,UAAY,EAAA,YAAA;IACZC,cAAgB,EAAA,gBAAA;IAChBC,WAAa,EAAA,aAAA;IACbC,oBAAsB,EAAA,sBAAA;IACtBC,YAAc,EAAA,cAAA;IACdC,GAAK,EAAA,KAAA;IACLC,YAAc,EAAA,cAAA;IACdC,SAAW,EAAA,WAAA;IACXC,UAAY,EAAA,YAAA;IACZC,QAAU,EAAA,UAAA;IACVC,UAAY,EAAA,YAAA;IACZC,eAAiB,EAAA,iBAAA;IACjBC,OAAS,EAAA,SAAA;IACTC,UAAY,EAAA;AACd;AAEA;;;;;;;;;;;;AAYC,IACM,MAAMC,YAAAA,CAAAA;AACX,qBACQC,QAAkC,GAAA,IAAIC,GAAM,EAAA;AACpD;;;;AAIC,MACDC,GAAIC,CAAAA,IAAY,EAAEC,MAAgB,EAAQ;AACxC,QAAA,IAAI,CAACJ,QAAQ,CAACE,GAAG,CAACC,IAAMC,EAAAA,MAAAA,CAAAA;AAC1B;AACA;;;;MAKAC,GAAAA,CAAIF,IAAY,EAAsB;AACpC,QAAA,OAAO,IAAI,CAACH,QAAQ,CAACK,GAAG,CAACF,IAAS,CAAA,IAAA,IAAA;AACpC;AACA;;;;MAKAG,GAAAA,CAAIH,IAAY,EAAW;AACzB,QAAA,OAAO,IAAI,CAACH,QAAQ,CAACM,GAAG,CAACH,IAAAA,CAAAA;AAC3B;AACA;;;;MAKAI,MAAAA,CAAOJ,IAAY,EAAY;AAC7B,QAAA,MAAMC,SAAS,IAAI,CAACJ,QAAQ,CAACK,GAAG,CAACF,IAAAA,CAAAA;AACjC,QAAA,IAAI,CAACC,MAAQ,EAAA;AACX,YAAA,MAAM,IAAII,KAAM,CAAA,CAAC,uCAAuC,EAAEL,IAAAA,CAAK,oBAAoB,CAAC,CAAA;AACtF;QACA,OAAOC,MAAAA;AACT;AACA;;AAEC,MACDK,KAAc,GAAA;QACZ,IAAI,CAACT,QAAQ,CAACS,KAAK,EAAA;AACrB;AACF;;;;"}
+{"version":3,"file":"blackboard.js","sources":["../../../src/render/rendergraph/blackboard.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\r\nimport type { RGHandle, RGTextureHandle } from './types';\r\n\r\n/** Typed key used to publish a frame resource. @public */\r\nexport type FrameResourceKey<THandle extends RGHandle = RGHandle> = string & {\r\n  readonly __frameResourceHandle: THandle;\r\n};\r\n\r\ntype FrameResourceMap = {\r\n  readonly SceneColor: FrameResourceKey<RGTextureHandle>;\r\n  readonly SceneColorCopy: FrameResourceKey<RGTextureHandle>;\r\n  readonly SceneColorNoFog: FrameResourceKey<RGTextureHandle>;\r\n  readonly LinearDepth: FrameResourceKey<RGTextureHandle>;\r\n  readonly SceneDepthAttachment: FrameResourceKey<RGTextureHandle>;\r\n  readonly MotionVector: FrameResourceKey<RGTextureHandle>;\r\n  readonly HiZ: FrameResourceKey<RGTextureHandle>;\r\n  readonly SceneRoughness: FrameResourceKey<RGTextureHandle>;\r\n  readonly SceneNormal: FrameResourceKey<RGTextureHandle>;\r\n  readonly SSSProfile: FrameResourceKey<RGTextureHandle>;\r\n  readonly SSSParam: FrameResourceKey<RGTextureHandle>;\r\n  readonly SSSDiffuse: FrameResourceKey<RGTextureHandle>;\r\n  readonly SSSTransmission: FrameResourceKey<RGTextureHandle>;\r\n  readonly SkinSSS: FrameResourceKey<RGTextureHandle>;\r\n  readonly ShadowMask: FrameResourceKey<RGTextureHandle>;\r\n  readonly PresentedColor: FrameResourceKey<RGTextureHandle>;\r\n};\r\n\r\n/** Well-known frame resource names shared through {@link RGBlackboard}. @public */\r\nexport const FrameResources = {\r\n  SceneColor: 'sceneColor',\r\n  SceneColorCopy: 'sceneColorCopy',\r\n  /**\r\n   * Opaque scene color with sky but before height fog is composited.\r\n   *\r\n   * Screen-space passes read this as the outgoing radiance of a traced hit. Fog\r\n   * along the camera-to-hit ray is unrelated to the shading-point-to-hit path\r\n   * those passes integrate, and sampling it would both tint hits with the fog\r\n   * color and feed back into the next frame. Only published when fog is present\r\n   * and a consumer needs it.\r\n   */\r\n  SceneColorNoFog: 'sceneColorNoFog',\r\n  LinearDepth: 'linearDepth',\r\n  SceneDepthAttachment: 'sceneDepthAttachment',\r\n  MotionVector: 'motionVector',\r\n  HiZ: 'hiZ',\r\n  SceneRoughness: 'sceneRoughness',\r\n  SceneNormal: 'sceneNormal',\r\n  SSSProfile: 'sssProfile',\r\n  SSSParam: 'sssParam',\r\n  SSSDiffuse: 'sssDiffuse',\r\n  SSSTransmission: 'sssTransmission',\r\n  SkinSSS: 'skinSSS',\r\n  ShadowMask: 'shadowMask',\r\n  /** Final presented color. The last registration becomes the graph sink. */\r\n  PresentedColor: 'presentedColor'\r\n} as unknown as FrameResourceMap;\r\n\r\n/** Per-frame registry of named render graph resources. @public */\r\nexport class RGBlackboard {\r\n  /** @internal */\r\n  private _handles: Map<string, RGHandle> = new Map();\r\n  /** Register or replace a resource handle. */\r\n  set<THandle extends RGHandle>(name: FrameResourceKey<THandle>, handle: THandle): void {\r\n    this._handles.set(name, handle);\r\n  }\r\n  /** Return a resource handle, or null when absent. */\r\n  get<THandle extends RGHandle = RGHandle>(name: FrameResourceKey<THandle>): Nullable<THandle> {\r\n    return (this._handles.get(name) as THandle | undefined) ?? null;\r\n  }\r\n  /** Check whether a resource is registered. */\r\n  has(name: FrameResourceKey): boolean {\r\n    return this._handles.has(name);\r\n  }\r\n  /** Return a required resource handle. */\r\n  expect<THandle extends RGHandle = RGHandle>(name: FrameResourceKey<THandle>): THandle {\r\n    const handle = this._handles.get(name);\r\n    if (!handle) {\r\n      throw new Error(`RGBlackboard: required frame resource \"${name}\" was not registered`);\r\n    }\r\n    return handle as THandle;\r\n  }\r\n  /** Remove all registered handles. */\r\n  clear(): void {\r\n    this._handles.clear();\r\n  }\r\n}\r\n"],"names":["FrameResources","SceneColor","SceneColorCopy","SceneColorNoFog","LinearDepth","SceneDepthAttachment","MotionVector","HiZ","SceneRoughness","SceneNormal","SSSProfile","SSSParam","SSSDiffuse","SSSTransmission","SkinSSS","ShadowMask","PresentedColor","RGBlackboard","_handles","Map","set","name","handle","get","has","expect","Error","clear"],"mappings":"AA2BA,oFACO,MAAMA,cAAiB,GAAA;IAC5BC,UAAY,EAAA,YAAA;IACZC,cAAgB,EAAA,gBAAA;AAChB;;;;;;;;AAQC,MACDC,eAAiB,EAAA,iBAAA;IACjBC,WAAa,EAAA,aAAA;IACbC,oBAAsB,EAAA,sBAAA;IACtBC,YAAc,EAAA,cAAA;IACdC,GAAK,EAAA,KAAA;IACLC,cAAgB,EAAA,gBAAA;IAChBC,WAAa,EAAA,aAAA;IACbC,UAAY,EAAA,YAAA;IACZC,QAAU,EAAA,UAAA;IACVC,UAAY,EAAA,YAAA;IACZC,eAAiB,EAAA,iBAAA;IACjBC,OAAS,EAAA,SAAA;IACTC,UAAY,EAAA,YAAA;AACZ,gFACAC,cAAgB,EAAA;AAClB;AAEA,mEACO,MAAMC,YAAAA,CAAAA;AACX,qBACQC,QAAkC,GAAA,IAAIC,GAAM,EAAA;AACpD,kDACAC,GAAAA,CAA8BC,IAA+B,EAAEC,MAAe,EAAQ;AACpF,QAAA,IAAI,CAACJ,QAAQ,CAACE,GAAG,CAACC,IAAMC,EAAAA,MAAAA,CAAAA;AAC1B;0DAEAC,GAAyCF,CAAAA,IAA+B,EAAqB;AAC3F,QAAA,OAAO,IAAK,CAACH,QAAQ,CAACK,GAAG,CAACF,IAAiC,CAAA,IAAA,IAAA;AAC7D;mDAEAG,GAAIH,CAAAA,IAAsB,EAAW;AACnC,QAAA,OAAO,IAAI,CAACH,QAAQ,CAACM,GAAG,CAACH,IAAAA,CAAAA;AAC3B;8CAEAI,MAA4CJ,CAAAA,IAA+B,EAAW;AACpF,QAAA,MAAMC,SAAS,IAAI,CAACJ,QAAQ,CAACK,GAAG,CAACF,IAAAA,CAAAA;AACjC,QAAA,IAAI,CAACC,MAAQ,EAAA;AACX,YAAA,MAAM,IAAII,KAAM,CAAA,CAAC,uCAAuC,EAAEL,IAAAA,CAAK,oBAAoB,CAAC,CAAA;AACtF;QACA,OAAOC,MAAAA;AACT;AACA,0CACAK,KAAc,GAAA;QACZ,IAAI,CAACT,QAAQ,CAACS,KAAK,EAAA;AACrB;AACF;;;;"}

package/dist/render/rendergraph/device_pool_allocator.js

@@ -1,75 +1,39 @@
 import { getDevice } from '../../app/api.js';
 
-/**
- * Bridges the render graph's {@link RGTextureAllocator} interface to the
- * engine's device resource pool (`device.pool`).
- *
- * Transient textures are fetched from the pool on `allocate()` and
- * returned to the pool on `release()`, enabling automatic reuse
- * across frames without manual lifecycle management.
- *
- * Usage:
- * ```ts
- * const allocator = new DevicePoolAllocator();
- * const executor = new RenderGraphExecutor(allocator, width, height);
- * ```
- *
- * @public
- */ class DevicePoolAllocator {
+/** Render graph allocator backed by the device resource pool. @public */ class DevicePoolAllocator {
     _device;
-    /**
-   * Creates a new instance of the DevicePoolAllocator.
-   * @param device - Optional device instance to use for resource allocation. If not provided, the global device will be used.
-   */ constructor(device){
+    /** Create an allocator using the given device or the global device. */ constructor(device){
         this._device = device ?? null;
     }
-    /**
-   * Allocate a transient texture from the device pool.
-   *
-   * @param desc - Texture descriptor from the render graph pass.
-   * @param size - Resolved pixel dimensions.
-   * @returns A pooled Texture2D instance.
-   */ allocate(desc, size) {
+    /** Allocate a transient texture from the device pool. */ allocate(desc, size, preferred) {
         const device = this._device ?? getDevice();
-        const mipmapping = (desc.mipLevels ?? 1) > 1;
+        const requestedMips = desc.mipLevels ?? 1;
+        // The pool allocates either one mip or a full chain.
+        if (requestedMips > 1) {
+            const maxMips = Math.max(1, Math.floor(Math.log2(Math.max(1, size.width, size.height))) + 1);
+            if (requestedMips > maxMips) {
+                throw new Error(`DevicePoolAllocator: texture "${desc.label ?? '<unnamed>'}" requested ${requestedMips} ` + `mip levels, but a ${size.width}x${size.height} texture supports at most ${maxMips}.`);
+            }
+        }
+        const mipmapping = requestedMips > 1;
         const arrayLayers = desc.arrayLayers;
-        // A defined arrayLayers (even 1) requests a 2D array texture — a single-layer
-        // array is a distinct texture type from a plain 2D texture, and the two are
-        // not interchangeable when bound to a tex2DArray sampler. Array textures are
-        // fetched as Texture2DArray. The render graph's TTexture channel is nominally
-        // Texture2D (see forward_plus_builder's executor annotation); TS types are
-        // erased at runtime, every pool op below accepts BaseTexture, so the cast is
-        // safe. Passes resolve the real type via getTexture<Texture2DArray>().
-        // Individual layers are targeted through RGFramebufferDesc.attachmentLayer.
-        const texture = arrayLayers !== undefined ? device.pool.fetchTemporalTexture2DArray(false, desc.format, size.width, size.height, arrayLayers, mipmapping) : device.pool.fetchTemporalTexture2D(false, desc.format, size.width, size.height, mipmapping);
+        // Any defined arrayLayers value requests Texture2DArray, including 1.
+        const texture = arrayLayers !== undefined ? device.pool.fetchTemporalTexture2DArray(false, desc.format, size.width, size.height, arrayLayers, mipmapping, preferred) : device.pool.fetchTemporalTexture2D(false, desc.format, size.width, size.height, mipmapping, preferred);
         if (desc.mipLevels && texture.mipLevelCount < desc.mipLevels) {
             device.pool.releaseTexture(texture);
             throw new Error(`DevicePoolAllocator: texture "${desc.label ?? '<unnamed>'}" requested ${desc.mipLevels} ` + `mip levels, but only ${texture.mipLevelCount} were allocated.`);
         }
         return texture;
     }
-    /**
-   * Release a transient texture back to the device pool.
-   *
-   * @param texture - The texture to release.
-   */ release(texture) {
+    /** Release a transient texture to the pool. */ release(texture) {
         const device = this._device ?? getDevice();
         device.pool.releaseTexture(texture);
     }
-    /**
-   * Retain a pooled texture so it can be owned outside the graph lifetime.
-   *
-   * @param texture - The texture to retain.
-   */ retain(texture) {
+    /** Retain a pooled texture beyond graph execution. */ retain(texture) {
         const device = this._device ?? getDevice();
         device.pool.retainTexture(texture);
     }
-    /**
-   * Allocate a temporary framebuffer from the device pool.
-   *
-   * @param desc - Framebuffer descriptor from the render graph pass.
-   * @returns A pooled FrameBuffer instance.
-   */ allocateFramebuffer(desc) {
+    /** Allocate a temporary framebuffer from the pool. */ allocateFramebuffer(desc) {
         const device = this._device ?? getDevice();
         const colors = Array.isArray(desc.colorAttachments) ? desc.colorAttachments : desc.colorAttachments ? [
             desc.colorAttachments
@@ -77,11 +41,7 @@ import { getDevice } from '../../app/api.js';
         const depthAttachment = desc.depthAttachment ?? null;
         return device.pool.fetchTemporalFramebuffer(false, desc.width ?? 0, desc.height ?? 0, colors, depthAttachment, desc.mipmapping ?? false, desc.sampleCount ?? 1, desc.ignoreDepthStencil ?? true, desc.attachmentMipLevel ?? 0, desc.attachmentCubeface ?? 0, desc.attachmentLayer ?? 0);
     }
-    /**
-   * Release a temporary framebuffer back to the device pool.
-   *
-   * @param framebuffer - The framebuffer to release.
-   */ releaseFramebuffer(framebuffer) {
+    /** Release a temporary framebuffer to the pool. */ releaseFramebuffer(framebuffer) {
         const device = this._device ?? getDevice();
         device.pool.releaseFrameBuffer(framebuffer);
     }

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

@@ -1 +1 @@
-{"version":3,"file":"device_pool_allocator.js","sources":["../../../src/render/rendergraph/device_pool_allocator.ts"],"sourcesContent":["import type { FrameBuffer, Texture2D, TextureFormat, AbstractDevice } from '@zephyr3d/device';\r\nimport type { RGFramebufferDesc, RGTextureAllocator, RGTextureDesc, RGResolvedSize } from './types';\r\nimport { getDevice } from '../../app/api';\r\nimport type { Nullable } from '@zephyr3d/base';\r\n\r\n/**\r\n * Bridges the render graph's {@link RGTextureAllocator} interface to the\r\n * engine's device resource pool (`device.pool`).\r\n *\r\n * Transient textures are fetched from the pool on `allocate()` and\r\n * returned to the pool on `release()`, enabling automatic reuse\r\n * across frames without manual lifecycle management.\r\n *\r\n * Usage:\r\n * ```ts\r\n * const allocator = new DevicePoolAllocator();\r\n * const executor = new RenderGraphExecutor(allocator, width, height);\r\n * ```\r\n *\r\n * @public\r\n */\r\nexport class DevicePoolAllocator implements RGTextureAllocator<Texture2D, FrameBuffer> {\r\n  private _device: Nullable<AbstractDevice>;\r\n  /**\r\n   * Creates a new instance of the DevicePoolAllocator.\r\n   * @param device - Optional device instance to use for resource allocation. If not provided, the global device will be used.\r\n   */\r\n  constructor(device?: AbstractDevice) {\r\n    this._device = device ?? null;\r\n  }\r\n  /**\r\n   * Allocate a transient texture from the device pool.\r\n   *\r\n   * @param desc - Texture descriptor from the render graph pass.\r\n   * @param size - Resolved pixel dimensions.\r\n   * @returns A pooled Texture2D instance.\r\n   */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize): Texture2D {\r\n    const device = this._device ?? getDevice();\r\n    const mipmapping = (desc.mipLevels ?? 1) > 1;\r\n    const arrayLayers = desc.arrayLayers;\r\n    // A defined arrayLayers (even 1) requests a 2D array texture — a single-layer\r\n    // array is a distinct texture type from a plain 2D texture, and the two are\r\n    // not interchangeable when bound to a tex2DArray sampler. Array textures are\r\n    // fetched as Texture2DArray. The render graph's TTexture channel is nominally\r\n    // Texture2D (see forward_plus_builder's executor annotation); TS types are\r\n    // erased at runtime, every pool op below accepts BaseTexture, so the cast is\r\n    // safe. Passes resolve the real type via getTexture<Texture2DArray>().\r\n    // Individual layers are targeted through RGFramebufferDesc.attachmentLayer.\r\n    const texture =\r\n      arrayLayers !== undefined\r\n        ? (device.pool.fetchTemporalTexture2DArray(\r\n            false,\r\n            desc.format,\r\n            size.width,\r\n            size.height,\r\n            arrayLayers,\r\n            mipmapping\r\n          ) as unknown as Texture2D)\r\n        : device.pool.fetchTemporalTexture2D(false, desc.format, size.width, size.height, mipmapping);\r\n    if (desc.mipLevels && texture.mipLevelCount < desc.mipLevels) {\r\n      device.pool.releaseTexture(texture);\r\n      throw new Error(\r\n        `DevicePoolAllocator: texture \"${desc.label ?? '<unnamed>'}\" requested ${desc.mipLevels} ` +\r\n          `mip levels, but only ${texture.mipLevelCount} were allocated.`\r\n      );\r\n    }\r\n    return texture;\r\n  }\r\n\r\n  /**\r\n   * Release a transient texture back to the device pool.\r\n   *\r\n   * @param texture - The texture to release.\r\n   */\r\n  release(texture: Texture2D): void {\r\n    const device = this._device ?? getDevice();\r\n    device.pool.releaseTexture(texture);\r\n  }\r\n\r\n  /**\r\n   * Retain a pooled texture so it can be owned outside the graph lifetime.\r\n   *\r\n   * @param texture - The texture to retain.\r\n   */\r\n  retain(texture: Texture2D): void {\r\n    const device = this._device ?? getDevice();\r\n    device.pool.retainTexture(texture);\r\n  }\r\n\r\n  /**\r\n   * Allocate a temporary framebuffer from the device pool.\r\n   *\r\n   * @param desc - Framebuffer descriptor from the render graph pass.\r\n   * @returns A pooled FrameBuffer instance.\r\n   */\r\n  allocateFramebuffer(desc: RGFramebufferDesc): FrameBuffer {\r\n    const device = this._device ?? getDevice();\r\n    const colors = Array.isArray(desc.colorAttachments)\r\n      ? (desc.colorAttachments as Array<Texture2D | TextureFormat>)\r\n      : desc.colorAttachments\r\n        ? [desc.colorAttachments as Texture2D | TextureFormat]\r\n        : [];\r\n    const depthAttachment = (desc.depthAttachment ?? null) as Texture2D | TextureFormat | null;\r\n    return device.pool.fetchTemporalFramebuffer(\r\n      false,\r\n      desc.width ?? 0,\r\n      desc.height ?? 0,\r\n      colors,\r\n      depthAttachment,\r\n      desc.mipmapping ?? false,\r\n      desc.sampleCount ?? 1,\r\n      desc.ignoreDepthStencil ?? true,\r\n      desc.attachmentMipLevel ?? 0,\r\n      desc.attachmentCubeface ?? 0,\r\n      desc.attachmentLayer ?? 0\r\n    );\r\n  }\r\n\r\n  /**\r\n   * Release a temporary framebuffer back to the device pool.\r\n   *\r\n   * @param framebuffer - The framebuffer to release.\r\n   */\r\n  releaseFramebuffer(framebuffer: FrameBuffer): void {\r\n    const device = this._device ?? getDevice();\r\n    device.pool.releaseFrameBuffer(framebuffer);\r\n  }\r\n}\r\n"],"names":["DevicePoolAllocator","_device","device","allocate","desc","size","getDevice","mipmapping","mipLevels","arrayLayers","texture","undefined","pool","fetchTemporalTexture2DArray","format","width","height","fetchTemporalTexture2D","mipLevelCount","releaseTexture","Error","label","release","retain","retainTexture","allocateFramebuffer","colors","Array","isArray","colorAttachments","depthAttachment","fetchTemporalFramebuffer","sampleCount","ignoreDepthStencil","attachmentMipLevel","attachmentCubeface","attachmentLayer","releaseFramebuffer","framebuffer","releaseFrameBuffer"],"mappings":"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"}
+{"version":3,"file":"device_pool_allocator.js","sources":["../../../src/render/rendergraph/device_pool_allocator.ts"],"sourcesContent":["import type { FrameBuffer, Texture2D, Texture2DArray, TextureFormat, AbstractDevice } from '@zephyr3d/device';\r\nimport type { RGFramebufferDesc, RGTextureAllocator, RGTextureDesc, RGResolvedSize } from './types';\r\nimport { getDevice } from '../../app/api';\r\nimport type { Nullable } from '@zephyr3d/base';\r\n\r\n/** Render graph allocator backed by the device resource pool. @public */\r\nexport class DevicePoolAllocator implements RGTextureAllocator<Texture2D, FrameBuffer> {\r\n  private _device: Nullable<AbstractDevice>;\r\n  /** Create an allocator using the given device or the global device. */\r\n  constructor(device?: AbstractDevice) {\r\n    this._device = device ?? null;\r\n  }\r\n  /** Allocate a transient texture from the device pool. */\r\n  allocate(desc: RGTextureDesc, size: RGResolvedSize, preferred?: Texture2D): Texture2D {\r\n    const device = this._device ?? getDevice();\r\n    const requestedMips = desc.mipLevels ?? 1;\r\n    // The pool allocates either one mip or a full chain.\r\n    if (requestedMips > 1) {\r\n      const maxMips = Math.max(1, Math.floor(Math.log2(Math.max(1, size.width, size.height))) + 1);\r\n      if (requestedMips > maxMips) {\r\n        throw new Error(\r\n          `DevicePoolAllocator: texture \"${desc.label ?? '<unnamed>'}\" requested ${requestedMips} ` +\r\n            `mip levels, but a ${size.width}x${size.height} texture supports at most ${maxMips}.`\r\n        );\r\n      }\r\n    }\r\n    const mipmapping = requestedMips > 1;\r\n    const arrayLayers = desc.arrayLayers;\r\n    // Any defined arrayLayers value requests Texture2DArray, including 1.\r\n    const texture =\r\n      arrayLayers !== undefined\r\n        ? (device.pool.fetchTemporalTexture2DArray(\r\n            false,\r\n            desc.format,\r\n            size.width,\r\n            size.height,\r\n            arrayLayers,\r\n            mipmapping,\r\n            preferred as unknown as Texture2DArray\r\n          ) as unknown as Texture2D)\r\n        : device.pool.fetchTemporalTexture2D(\r\n            false,\r\n            desc.format,\r\n            size.width,\r\n            size.height,\r\n            mipmapping,\r\n            preferred\r\n          );\r\n    if (desc.mipLevels && texture.mipLevelCount < desc.mipLevels) {\r\n      device.pool.releaseTexture(texture);\r\n      throw new Error(\r\n        `DevicePoolAllocator: texture \"${desc.label ?? '<unnamed>'}\" requested ${desc.mipLevels} ` +\r\n          `mip levels, but only ${texture.mipLevelCount} were allocated.`\r\n      );\r\n    }\r\n    return texture;\r\n  }\r\n\r\n  /** Release a transient texture to the pool. */\r\n  release(texture: Texture2D): void {\r\n    const device = this._device ?? getDevice();\r\n    device.pool.releaseTexture(texture);\r\n  }\r\n\r\n  /** Retain a pooled texture beyond graph execution. */\r\n  retain(texture: Texture2D): void {\r\n    const device = this._device ?? getDevice();\r\n    device.pool.retainTexture(texture);\r\n  }\r\n\r\n  /** Allocate a temporary framebuffer from the pool. */\r\n  allocateFramebuffer(desc: RGFramebufferDesc): FrameBuffer {\r\n    const device = this._device ?? getDevice();\r\n    const colors = Array.isArray(desc.colorAttachments)\r\n      ? (desc.colorAttachments as Array<Texture2D | TextureFormat>)\r\n      : desc.colorAttachments\r\n        ? [desc.colorAttachments as Texture2D | TextureFormat]\r\n        : [];\r\n    const depthAttachment = (desc.depthAttachment ?? null) as Texture2D | TextureFormat | null;\r\n    return device.pool.fetchTemporalFramebuffer(\r\n      false,\r\n      desc.width ?? 0,\r\n      desc.height ?? 0,\r\n      colors,\r\n      depthAttachment,\r\n      desc.mipmapping ?? false,\r\n      desc.sampleCount ?? 1,\r\n      desc.ignoreDepthStencil ?? true,\r\n      desc.attachmentMipLevel ?? 0,\r\n      desc.attachmentCubeface ?? 0,\r\n      desc.attachmentLayer ?? 0\r\n    );\r\n  }\r\n\r\n  /** Release a temporary framebuffer to the pool. */\r\n  releaseFramebuffer(framebuffer: FrameBuffer): void {\r\n    const device = this._device ?? getDevice();\r\n    device.pool.releaseFrameBuffer(framebuffer);\r\n  }\r\n}\r\n"],"names":["DevicePoolAllocator","_device","device","allocate","desc","size","preferred","getDevice","requestedMips","mipLevels","maxMips","Math","max","floor","log2","width","height","Error","label","mipmapping","arrayLayers","texture","undefined","pool","fetchTemporalTexture2DArray","format","fetchTemporalTexture2D","mipLevelCount","releaseTexture","release","retain","retainTexture","allocateFramebuffer","colors","Array","isArray","colorAttachments","depthAttachment","fetchTemporalFramebuffer","sampleCount","ignoreDepthStencil","attachmentMipLevel","attachmentCubeface","attachmentLayer","releaseFramebuffer","framebuffer","releaseFrameBuffer"],"mappings":"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"}