@zephyr3d/scene 0.9.18 → 0.9.20

package/dist/render/renderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.js","sources":["../../src/render/renderer.ts"],"sourcesContent":["import type { TextureFormat } from '@zephyr3d/device';\r\nimport { 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 glossySurfaceFormat: TextureFormat = halfFloatColorBuffer ? 'rgba16f' : 'rgba8unorm';\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          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          SSRRoughnessTexture: SSR\r\n            ? device.pool.fetchTemporalTexture2D(true, glossySurfaceFormat, renderWidth, renderHeight)\r\n            : null,\r\n          SSRNormalTexture: SSR\r\n            ? device.pool.fetchTemporalTexture2D(true, glossySurfaceFormat, renderWidth, renderHeight)\r\n            : 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","glossySurfaceFormat","ctx","oit","motionVectors","motionBlur","ssrTemporal","HiZ","HiZTexture","compositor","queue","lightBlending","renderPass","renderPassHash","flip","drawEnvLight","sunLight","primaryDirectionalLight","primaryTransmissionLight","materialFlags","SSRCalcThickness","ssrCalcThickness","SSRRoughnessTexture","fetchTemporalTexture2D","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 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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"}

package/dist/render/rendergraph/blackboard.js

@@ -0,0 +1,79 @@
+/**
+ * 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 = {
+    SceneColor: 'sceneColor',
+    SceneColorCopy: 'sceneColorCopy',
+    LinearDepth: 'linearDepth',
+    SceneDepthAttachment: 'sceneDepthAttachment',
+    MotionVector: 'motionVector',
+    HiZ: 'hiZ',
+    SSRRoughness: 'ssrRoughness',
+    SSRNormal: 'ssrNormal',
+    SSSProfile: 'sssProfile',
+    SSSParam: 'sssParam',
+    SSSDiffuse: 'sssDiffuse',
+    SSSTransmission: 'sssTransmission',
+    SkinSSS: 'skinSSS',
+    ShadowMask: 'shadowMask'
+};
+/**
+ * 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 {
+    /** @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) {
+        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 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) {
+        return this._handles.has(name);
+    }
+    /**
+   * Look up a resource handle that must exist.
+   * @param name - Resource name.
+   * @returns The registered 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() {
+        this._handles.clear();
+    }
+}
+
+export { FrameResources, RGBlackboard };
+//# sourceMappingURL=blackboard.js.map

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

@@ -0,0 +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;;;;"}

package/dist/render/rendergraph/device_pool_allocator.js

@@ -32,7 +32,16 @@ import { getDevice } from '../../app/api.js';
    */ allocate(desc, size) {
         const device = this._device ?? getDevice();
         const mipmapping = (desc.mipLevels ?? 1) > 1;
-        const texture = device.pool.fetchTemporalTexture2D(false, desc.format, size.width, size.height, mipmapping);
+        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);
         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.`);

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 texture = device.pool.fetchTemporalTexture2D(\r\n      false,\r\n      desc.format,\r\n      size.width,\r\n      size.height,\r\n      mipmapping\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  /**\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","texture","pool","fetchTemporalTexture2D","format","width","height","mipLevelCount","releaseTexture","Error","label","release","retain","retainTexture","allocateFramebuffer","colors","Array","isArray","colorAttachments","depthAttachment","fetchTemporalFramebuffer","sampleCount","ignoreDepthStencil","attachmentMipLevel","attachmentCubeface","attachmentLayer","releaseFramebuffer","framebuffer","releaseFrameBuffer"],"mappings":";;AAKA;;;;;;;;;;;;;;;AAeC,IACM,MAAMA,mBAAAA,CAAAA;IACHC,OAAkC;AAC1C;;;MAIA,WAAA,CAAYC,MAAuB,CAAE;QACnC,IAAI,CAACD,OAAO,GAAGC,MAAU,IAAA,IAAA;AAC3B;AACA;;;;;;AAMC,MACDC,QAASC,CAAAA,IAAmB,EAAEC,IAAoB,EAAa;AAC7D,QAAA,MAAMH,MAAS,GAAA,IAAI,CAACD,OAAO,IAAIK,SAAAA,EAAAA;AAC/B,QAAA,MAAMC,aAAa,CAACH,KAAKI,SAAS,IAAI,CAAA,IAAK,CAAA;AAC3C,QAAA,MAAMC,OAAUP,GAAAA,MAAAA,CAAOQ,IAAI,CAACC,sBAAsB,CAChD,KAAA,EACAP,IAAKQ,CAAAA,MAAM,EACXP,IAAKQ,CAAAA,KAAK,EACVR,IAAAA,CAAKS,MAAM,EACXP,UAAAA,CAAAA;QAEF,IAAIH,IAAAA,CAAKI,SAAS,IAAIC,OAAAA,CAAQM,aAAa,GAAGX,IAAAA,CAAKI,SAAS,EAAE;YAC5DN,MAAOQ,CAAAA,IAAI,CAACM,cAAc,CAACP,OAAAA,CAAAA;YAC3B,MAAM,IAAIQ,KACR,CAAA,CAAC,8BAA8B,EAAEb,KAAKc,KAAK,IAAI,WAAY,CAAA,YAAY,EAAEd,IAAAA,CAAKI,SAAS,CAAC,CAAC,CAAC,GACxF,CAAC,qBAAqB,EAAEC,OAAQM,CAAAA,aAAa,CAAC,gBAAgB,CAAC,CAAA;AAErE;QACA,OAAON,OAAAA;AACT;AAEA;;;;MAKAU,OAAAA,CAAQV,OAAkB,EAAQ;AAChC,QAAA,MAAMP,MAAS,GAAA,IAAI,CAACD,OAAO,IAAIK,SAAAA,EAAAA;QAC/BJ,MAAOQ,CAAAA,IAAI,CAACM,cAAc,CAACP,OAAAA,CAAAA;AAC7B;AAEA;;;;MAKAW,MAAAA,CAAOX,OAAkB,EAAQ;AAC/B,QAAA,MAAMP,MAAS,GAAA,IAAI,CAACD,OAAO,IAAIK,SAAAA,EAAAA;QAC/BJ,MAAOQ,CAAAA,IAAI,CAACW,aAAa,CAACZ,OAAAA,CAAAA;AAC5B;AAEA;;;;;MAMAa,mBAAAA,CAAoBlB,IAAuB,EAAe;AACxD,QAAA,MAAMF,MAAS,GAAA,IAAI,CAACD,OAAO,IAAIK,SAAAA,EAAAA;AAC/B,QAAA,MAAMiB,MAASC,GAAAA,KAAAA,CAAMC,OAAO,CAACrB,IAAKsB,CAAAA,gBAAgB,CAC7CtB,GAAAA,IAAAA,CAAKsB,gBAAgB,GACtBtB,IAAKsB,CAAAA,gBAAgB,GACnB;AAACtB,YAAAA,IAAAA,CAAKsB;AAA8C,SAAA,GACpD,EAAE;QACR,MAAMC,eAAAA,GAAmBvB,IAAKuB,CAAAA,eAAe,IAAI,IAAA;AACjD,QAAA,OAAOzB,OAAOQ,IAAI,CAACkB,wBAAwB,CACzC,OACAxB,IAAKS,CAAAA,KAAK,IAAI,CAAA,EACdT,KAAKU,MAAM,IAAI,GACfS,MACAI,EAAAA,eAAAA,EACAvB,KAAKG,UAAU,IAAI,KACnBH,EAAAA,IAAAA,CAAKyB,WAAW,IAAI,CAAA,EACpBzB,IAAK0B,CAAAA,kBAAkB,IAAI,IAC3B1B,EAAAA,IAAAA,CAAK2B,kBAAkB,IAAI,GAC3B3B,IAAK4B,CAAAA,kBAAkB,IAAI,CAC3B5B,EAAAA,IAAAA,CAAK6B,eAAe,IAAI,CAAA,CAAA;AAE5B;AAEA;;;;MAKAC,kBAAAA,CAAmBC,WAAwB,EAAQ;AACjD,QAAA,MAAMjC,MAAS,GAAA,IAAI,CAACD,OAAO,IAAIK,SAAAA,EAAAA;QAC/BJ,MAAOQ,CAAAA,IAAI,CAAC0B,kBAAkB,CAACD,WAAAA,CAAAA;AACjC;AACF;;;;"}
+{"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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"}

package/dist/render/rendergraph/executor.js

@@ -39,6 +39,7 @@ const DEFAULT_PROFILING_OPTIONS = {
     /** @internal */ _allocatedTextures = new Map();
     /** @internal */ _allocatedFramebuffers = new Map();
     /** @internal */ _importedTextureAliases = new Map();
+    /** @internal */ _transientTextureAliases = new Map();
     /** @internal */ _resolvedImportedTextures = new Map();
     /** @internal */ _cleanupCallbacks = [];
     /** @internal */ _profilingOptions;
@@ -113,16 +114,27 @@ const DEFAULT_PROFILING_OPTIONS = {
         const releaseAt = new Map(); // passIndex -> transient texture resourceIds to release
         const allocateFramebufferAt = new Map(); // passIndex -> framebuffer resourceIds to allocate
         const releaseFramebufferAt = new Map(); // passIndex -> framebuffer resourceIds to release
+        // Transient write-versions (builder.write on a transient) alias the same
+        // physical texture as the original resource: merge their lifetimes by
+        // physicalId so one texture is allocated at the first use of any version
+        // and released after the last use of any version.
+        this._transientTextureAliases.clear();
+        const transientSchedules = new Map();
         for (const [resId, lifetime] of compiled.lifetimes){
             if (lifetime.resource.kind === 'transient') {
-                if (!allocateAt.has(lifetime.firstUse)) {
-                    allocateAt.set(lifetime.firstUse, []);
+                const physicalId = lifetime.resource.physicalId;
+                this._transientTextureAliases.set(resId, physicalId);
+                const merged = transientSchedules.get(physicalId);
+                if (merged) {
+                    merged.firstUse = Math.min(merged.firstUse, lifetime.firstUse);
+                    merged.lastUse = Math.max(merged.lastUse, lifetime.lastUse);
+                } else {
+                    transientSchedules.set(physicalId, {
+                        firstUse: lifetime.firstUse,
+                        lastUse: lifetime.lastUse,
+                        desc: lifetime.resource.desc
+                    });
                 }
-                allocateAt.get(lifetime.firstUse).push(resId);
-                if (!releaseAt.has(lifetime.lastUse)) {
-                    releaseAt.set(lifetime.lastUse, []);
-                }
-                releaseAt.get(lifetime.lastUse).push(resId);
             } else if (lifetime.resource.kind === 'framebuffer') {
                 if (!allocateFramebufferAt.has(lifetime.firstUse)) {
                     allocateFramebufferAt.set(lifetime.firstUse, []);
@@ -134,6 +146,16 @@ const DEFAULT_PROFILING_OPTIONS = {
                 releaseFramebufferAt.get(lifetime.lastUse).push(resId);
             }
         }
+        for (const [physicalId, schedule] of transientSchedules){
+            if (!allocateAt.has(schedule.firstUse)) {
+                allocateAt.set(schedule.firstUse, []);
+            }
+            allocateAt.get(schedule.firstUse).push(physicalId);
+            if (!releaseAt.has(schedule.lastUse)) {
+                releaseAt.set(schedule.lastUse, []);
+            }
+            releaseAt.get(schedule.lastUse).push(physicalId);
+        }
         let completed = false;
         let executionError = null;
         try {
@@ -143,10 +165,9 @@ const DEFAULT_PROFILING_OPTIONS = {
                 const toAllocate = allocateAt.get(i);
                 if (toAllocate) {
                     for (const resId of toAllocate){
-                        const lifetime = compiled.lifetimes.get(resId);
-                        const desc = lifetime.resource.desc;
-                        const size = this._resolveSize(desc);
-                        const texture = this._allocator.allocate(desc, size);
+                        const schedule = transientSchedules.get(resId);
+                        const size = this._resolveSize(schedule.desc);
+                        const texture = this._allocator.allocate(schedule.desc, size);
                         this._allocatedTextures.set(resId, texture);
                     }
                 }
@@ -268,6 +289,7 @@ const DEFAULT_PROFILING_OPTIONS = {
         this._allocatedTextures.clear();
         this._importedTextures.clear();
         this._importedTextureAliases.clear();
+        this._transientTextureAliases.clear();
         this._resolvedImportedTextures.clear();
     }
     // ─── Private ────────────────────────────────────────────────────────
@@ -593,6 +615,14 @@ const DEFAULT_PROFILING_OPTIONS = {
         if (allocated !== undefined) {
             return allocated;
         }
+        // Transient write-versions resolve to the physical texture of the original.
+        const transientAlias = this._transientTextureAliases.get(handle._id);
+        if (transientAlias !== undefined) {
+            const aliased = this._allocatedTextures.get(transientAlias);
+            if (aliased !== undefined) {
+                return aliased;
+            }
+        }
         throw new Error(`RenderGraphExecutor: cannot resolve resource "${handle.name}" (id=${handle._id}). ` + `It may not have been allocated yet or was already released.`);
     }
     /** @internal */ _createAccessScope(pass) {