@zephyr3d/scene 0.9.5 → 0.9.7

package/dist/render/renderer.js

@@ -7,17 +7,18 @@ import { GlobalBindGroupAllocator } from './globalbindgroup_allocator.js';
 import { fetchSampler } from '../utility/misc.js';
 import { executeForwardPlusGraph } from './rendergraph/forward_plus_builder.js';
 
-/**
- * Forward render scheme
- * @internal
+/**
+ * Forward render scheme
+ * @internal
  */ class SceneRenderer {
-    /**
-   * Renders a scene by given camera
-   * @param scene - The scene to render
-   * @param camera - The camera that will be used to render the scene
+    /**
+   * Renders a scene by given camera
+   * @param scene - The scene to render
+   * @param camera - The camera that will be used to render the scene
    */ static renderScene(scene, camera) {
         const device = getDevice();
-        const colorFormat = camera.HDR && device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer ? 'rgba16f' : 'rgba8unorm';
+        const halfFloatColorBuffer = device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer;
+        const colorFormat = camera.HDR && halfFloatColorBuffer ? 'rgba16f' : 'rgba8unorm';
         const depthFormat = device.getDeviceCaps().framebufferCaps.supportDepth32floatStencil8 ? 'd32fs8' : 'd24s8';
         const globalBindGroupAllocator = GlobalBindGroupAllocator.get();
         scene.frameUpdate();
@@ -28,67 +29,80 @@ import { executeForwardPlusGraph } from './rendergraph/forward_plus_builder.js';
             const renderY = camera.viewport ? device.screenYToDevice(camera.viewport[1]) : 0;
             const renderWidth = camera.viewport ? device.screenXToDevice(camera.viewport[2]) : device.getDrawingBufferWidth();
             const renderHeight = camera.viewport ? device.screenYToDevice(camera.viewport[3]) : device.getDrawingBufferHeight();
-            if (renderWidth <= 0 || renderHeight <= 0) {
+            if (renderWidth > 0 && renderHeight > 0) {
+                const tmpFramebuffer = defaultViewport ? null : device.pool.fetchTemporalFramebuffer(false, renderWidth, renderHeight, colorFormat, depthFormat);
+                const originFramebuffer = device.getFramebuffer();
+                if (tmpFramebuffer) {
+                    device.pushDeviceStates();
+                    device.setFramebuffer(tmpFramebuffer);
+                }
+                device.clearFrameBuffer(camera.clearColor, camera.clearDepth, camera.clearStencil);
+                const SSR = camera.SSR && scene.env.light.envLight && scene.env.light.envLight.hasRadiance();
+                const SSS = camera.SSS;
+                const glossySurfaceFormat = halfFloatColorBuffer ? 'rgba16f' : 'rgba8unorm';
+                const ctx = {
+                    device,
+                    scene,
+                    renderWidth,
+                    renderHeight,
+                    oit: null,
+                    motionVectors: device.type !== 'webgl' && (camera.TAA || camera.motionBlur || SSR && camera.ssrTemporal),
+                    HiZ: camera.HiZ && device.type !== 'webgl',
+                    HiZTexture: null,
+                    globalBindGroupAllocator,
+                    camera,
+                    compositor: camera.compositor,
+                    queue: 0,
+                    lightBlending: false,
+                    renderPass: null,
+                    renderPassHash: null,
+                    flip: false,
+                    depthFormat,
+                    colorFormat,
+                    drawEnvLight: false,
+                    env: null,
+                    sunLight: null,
+                    primaryDirectionalLight: null,
+                    primaryTransmissionLight: null,
+                    materialFlags: 0,
+                    SSR,
+                    SSS,
+                    SSRCalcThickness: SSR && camera.ssrCalcThickness,
+                    SSRRoughnessTexture: SSR ? device.pool.fetchTemporalTexture2D(true, glossySurfaceFormat, renderWidth, renderHeight) : null,
+                    SSRNormalTexture: SSR ? device.pool.fetchTemporalTexture2D(true, glossySurfaceFormat, renderWidth, renderHeight) : null,
+                    SSSProfileTexture: null,
+                    SSSParamTexture: null,
+                    SSSDiffuseTexture: null,
+                    SSSTransmissionTexture: null,
+                    ssrSDFBoxBuffer: null,
+                    ssrSDFBoxCount: 0,
+                    finalFramebuffer: device.getFramebuffer(),
+                    intermediateFramebuffer: null
+                };
+                this._renderScene(ctx);
+                if (tmpFramebuffer) {
+                    device.popDeviceStates();
+                    const oversizedViewport = renderX < 0 || renderY < 0 || renderX + renderWidth > device.getDrawingBufferWidth() || renderY + renderHeight > device.getDrawingBufferHeight();
+                    const blitter = new CopyBlitter();
+                    if (oversizedViewport) {
+                        blitter.destRect = [
+                            renderX,
+                            renderY,
+                            renderWidth,
+                            renderHeight
+                        ];
+                    } else {
+                        blitter.viewport = camera.viewport ? camera.viewport.slice() : null;
+                    }
+                    blitter.scissor = camera.scissor ? camera.scissor.slice() : null;
+                    blitter.srgbOut = !originFramebuffer;
+                    blitter.blit(tmpFramebuffer.getColorAttachments()[0], originFramebuffer ?? null, fetchSampler('clamp_nearest_nomip'));
+                    device.pool.releaseFrameBuffer(tmpFramebuffer);
+                }
+            } else {
                 camera.getPickResultResolveFunc()?.(null);
                 return;
             }
-            const tmpFramebuffer = defaultViewport ? null : device.pool.fetchTemporalFramebuffer(false, renderWidth, renderHeight, colorFormat, depthFormat);
-            const originFramebuffer = device.getFramebuffer();
-            if (tmpFramebuffer) {
-                device.pushDeviceStates();
-                device.setFramebuffer(tmpFramebuffer);
-            }
-            device.clearFrameBuffer(camera.clearColor, camera.clearDepth, camera.clearStencil);
-            const SSR = camera.SSR && scene.env.light.envLight && scene.env.light.envLight.hasRadiance();
-            const ctx = {
-                device,
-                scene,
-                renderWidth,
-                renderHeight,
-                oit: null,
-                motionVectors: device.type !== 'webgl' && (camera.TAA || camera.motionBlur),
-                HiZ: camera.HiZ && device.type !== 'webgl',
-                HiZTexture: null,
-                globalBindGroupAllocator,
-                camera,
-                compositor: camera.compositor,
-                queue: 0,
-                lightBlending: false,
-                renderPass: null,
-                renderPassHash: null,
-                flip: false,
-                depthFormat,
-                colorFormat,
-                drawEnvLight: false,
-                env: null,
-                materialFlags: 0,
-                SSR,
-                SSRCalcThickness: SSR && camera.ssrCalcThickness,
-                SSRRoughnessTexture: device.pool.fetchTemporalTexture2D(true, 'rgba8unorm', renderWidth, renderHeight),
-                SSRNormalTexture: device.pool.fetchTemporalTexture2D(true, 'rgba8unorm', renderWidth, renderHeight),
-                finalFramebuffer: device.getFramebuffer(),
-                intermediateFramebuffer: null
-            };
-            this._renderScene(ctx);
-            if (tmpFramebuffer) {
-                device.popDeviceStates();
-                const oversizedViewport = renderX < 0 || renderY < 0 || renderX + renderWidth > device.getDrawingBufferWidth() || renderY + renderHeight > device.getDrawingBufferHeight();
-                const blitter = new CopyBlitter();
-                if (oversizedViewport) {
-                    blitter.destRect = [
-                        renderX,
-                        renderY,
-                        renderWidth,
-                        renderHeight
-                    ];
-                } else {
-                    blitter.viewport = camera.viewport ? camera.viewport.slice() : null;
-                }
-                blitter.scissor = camera.scissor ? camera.scissor.slice() : null;
-                blitter.srgbOut = !originFramebuffer;
-                blitter.blit(tmpFramebuffer.getColorAttachments()[0], originFramebuffer ?? null, fetchSampler('clamp_nearest_nomip'));
-                device.pool.releaseFrameBuffer(tmpFramebuffer);
-            }
         }
         GlobalBindGroupAllocator.release(globalBindGroupAllocator);
     }

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 colorFormat =\r\n      camera.HDR && device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer ? '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        camera.getPickResultResolveFunc()?.(null);\r\n        return;\r\n      }\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 ctx: DrawContext = {\r\n        device,\r\n        scene,\r\n        renderWidth,\r\n        renderHeight,\r\n        oit: null,\r\n        motionVectors: device.type !== 'webgl' && (camera.TAA || camera.motionBlur),\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        materialFlags: 0,\r\n        SSR,\r\n        SSRCalcThickness: SSR && camera.ssrCalcThickness,\r\n        SSRRoughnessTexture: device.pool.fetchTemporalTexture2D(\r\n          true,\r\n          'rgba8unorm',\r\n          renderWidth,\r\n          renderHeight\r\n        ),\r\n        SSRNormalTexture: device.pool.fetchTemporalTexture2D(true, 'rgba8unorm', renderWidth, renderHeight),\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    }\r\n    GlobalBindGroupAllocator.release(globalBindGroupAllocator);\r\n  }\r\n  /** @internal */\r\n  protected static _renderScene(ctx: DrawContext) {\r\n    executeForwardPlusGraph(ctx);\r\n  }\r\n}\r\n"],"names":["SceneRenderer","renderScene","scene","camera","device","getDevice","colorFormat","HDR","getDeviceCaps","textureCaps","supportHalfFloatColorBuffer","depthFormat","framebufferCaps","supportDepth32floatStencil8","globalBindGroupAllocator","GlobalBindGroupAllocator","get","frameUpdate","frameUpdatePerCamera","isContextLost","defaultViewport","TAA","type","viewport","scissor","renderX","screenXToDevice","renderY","screenYToDevice","renderWidth","getDrawingBufferWidth","renderHeight","getDrawingBufferHeight","getPickResultResolveFunc","tmpFramebuffer","pool","fetchTemporalFramebuffer","originFramebuffer","getFramebuffer","pushDeviceStates","setFramebuffer","clearFrameBuffer","clearColor","clearDepth","clearStencil","SSR","env","light","envLight","hasRadiance","ctx","oit","motionVectors","motionBlur","HiZ","HiZTexture","compositor","queue","lightBlending","renderPass","renderPassHash","flip","drawEnvLight","materialFlags","SSRCalcThickness","ssrCalcThickness","SSRRoughnessTexture","fetchTemporalTexture2D","SSRNormalTexture","finalFramebuffer","intermediateFramebuffer","_renderScene","popDeviceStates","oversizedViewport","blitter","CopyBlitter","destRect","slice","srgbOut","blit","getColorAttachments","fetchSampler","releaseFrameBuffer","release","executeForwardPlusGraph"],"mappings":"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"}
+{"version":3,"file":"renderer.js","sources":["../../src/render/renderer.ts"],"sourcesContent":["import type { TextureFormat } from '@zephyr3d/device';\nimport { CopyBlitter } from '../blitter';\nimport type { DrawContext } from './drawable';\nimport type { Scene } from '../scene';\nimport type { Camera } from '../camera';\nimport { GlobalBindGroupAllocator } from './globalbindgroup_allocator';\nimport { fetchSampler } from '../utility/misc';\nimport { getDevice } from '../app/api';\nimport { executeForwardPlusGraph } from './rendergraph/forward_plus_builder';\n\n/**\n * Forward render scheme\n * @internal\n */\nexport class SceneRenderer {\n  /**\n   * Renders a scene by given camera\n   * @param scene - The scene to render\n   * @param camera - The camera that will be used to render the scene\n   */\n  static renderScene(scene: Scene, camera: Camera): void {\n    const device = getDevice();\n    const halfFloatColorBuffer = device.getDeviceCaps().textureCaps.supportHalfFloatColorBuffer;\n    const colorFormat = camera.HDR && halfFloatColorBuffer ? 'rgba16f' : 'rgba8unorm';\n    const depthFormat = device.getDeviceCaps().framebufferCaps.supportDepth32floatStencil8\n      ? 'd32fs8'\n      : 'd24s8';\n    const globalBindGroupAllocator = GlobalBindGroupAllocator.get();\n    scene.frameUpdate();\n    scene.frameUpdatePerCamera(camera);\n    if (camera && !device.isContextLost()) {\n      const defaultViewport = (!camera.TAA || device.type === 'webgl') && !camera.viewport && !camera.scissor;\n      const renderX = camera.viewport ? device.screenXToDevice(camera.viewport[0]) : 0;\n      const renderY = camera.viewport ? device.screenYToDevice(camera.viewport[1]) : 0;\n      const renderWidth = camera.viewport\n        ? device.screenXToDevice(camera.viewport[2])\n        : device.getDrawingBufferWidth();\n      const renderHeight = camera.viewport\n        ? device.screenYToDevice(camera.viewport[3])\n        : device.getDrawingBufferHeight();\n      if (renderWidth > 0 && renderHeight > 0) {\n        const tmpFramebuffer = defaultViewport\n          ? null\n          : device.pool.fetchTemporalFramebuffer(false, renderWidth, renderHeight, colorFormat, depthFormat);\n        const originFramebuffer = device.getFramebuffer();\n        if (tmpFramebuffer) {\n          device.pushDeviceStates();\n          device.setFramebuffer(tmpFramebuffer);\n        }\n        device.clearFrameBuffer(camera.clearColor, camera.clearDepth, camera.clearStencil);\n        const SSR = camera.SSR && scene.env.light.envLight && scene.env.light.envLight.hasRadiance();\n        const SSS = camera.SSS;\n        const glossySurfaceFormat: TextureFormat = halfFloatColorBuffer ? 'rgba16f' : 'rgba8unorm';\n        const ctx: DrawContext = {\n          device,\n          scene,\n          renderWidth,\n          renderHeight,\n          oit: null,\n          motionVectors:\n            device.type !== 'webgl' && (camera.TAA || camera.motionBlur || (SSR && camera.ssrTemporal)),\n          HiZ: camera.HiZ && device.type !== 'webgl',\n          HiZTexture: null,\n          globalBindGroupAllocator,\n          camera,\n          compositor: camera.compositor,\n          queue: 0,\n          lightBlending: false,\n          renderPass: null,\n          renderPassHash: null,\n          flip: false,\n          depthFormat,\n          colorFormat,\n          drawEnvLight: false,\n          env: null,\n          sunLight: null,\n          primaryDirectionalLight: null,\n          primaryTransmissionLight: null,\n          materialFlags: 0,\n          SSR,\n          SSS,\n          SSRCalcThickness: SSR && camera.ssrCalcThickness,\n          SSRRoughnessTexture: SSR\n            ? device.pool.fetchTemporalTexture2D(true, glossySurfaceFormat, renderWidth, renderHeight)\n            : null,\n          SSRNormalTexture: SSR\n            ? device.pool.fetchTemporalTexture2D(true, glossySurfaceFormat, renderWidth, renderHeight)\n            : null,\n          SSSProfileTexture: null,\n          SSSParamTexture: null,\n          SSSDiffuseTexture: null,\n          SSSTransmissionTexture: null,\n          ssrSDFBoxBuffer: null,\n          ssrSDFBoxCount: 0,\n          finalFramebuffer: device.getFramebuffer(),\n          intermediateFramebuffer: null\n        };\n        this._renderScene(ctx);\n        if (tmpFramebuffer) {\n          device.popDeviceStates();\n          const oversizedViewport =\n            renderX < 0 ||\n            renderY < 0 ||\n            renderX + renderWidth > device.getDrawingBufferWidth() ||\n            renderY + renderHeight > device.getDrawingBufferHeight();\n          const blitter = new CopyBlitter();\n          if (oversizedViewport) {\n            blitter.destRect = [renderX, renderY, renderWidth, renderHeight];\n          } else {\n            blitter.viewport = camera.viewport ? camera.viewport.slice() : null;\n          }\n          blitter.scissor = camera.scissor ? camera.scissor.slice() : null;\n          blitter.srgbOut = !originFramebuffer;\n          blitter.blit(\n            tmpFramebuffer.getColorAttachments()[0],\n            originFramebuffer ?? null,\n            fetchSampler('clamp_nearest_nomip')\n          );\n          device.pool.releaseFrameBuffer(tmpFramebuffer);\n        }\n      } else {\n        camera.getPickResultResolveFunc()?.(null);\n        return;\n      }\n    }\n    GlobalBindGroupAllocator.release(globalBindGroupAllocator);\n  }\n\n  /** @internal */\n  protected static _renderScene(ctx: DrawContext): void {\n    executeForwardPlusGraph(ctx);\n  }\n}\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","ssrSDFBoxBuffer","ssrSDFBoxCount","finalFramebuffer","intermediateFramebuffer","_renderScene","popDeviceStates","oversizedViewport","blitter","CopyBlitter","destRect","slice","srgbOut","blit","getColorAttachments","fetchSampler","releaseFrameBuffer","getPickResultResolveFunc","release","executeForwardPlusGraph"],"mappings":";;;;;;;;;AAUA;;;AAGC,IACM,MAAMA,aAAAA,CAAAA;AACX;;;;AAIC,MACD,OAAOC,WAAAA,CAAYC,KAAY,EAAEC,MAAc,EAAQ;AACrD,QAAA,MAAMC,MAASC,GAAAA,SAAAA,EAAAA;AACf,QAAA,MAAMC,uBAAuBF,MAAOG,CAAAA,aAAa,EAAGC,CAAAA,WAAW,CAACC,2BAA2B;AAC3F,QAAA,MAAMC,WAAcP,GAAAA,MAAAA,CAAOQ,GAAG,IAAIL,uBAAuB,SAAY,GAAA,YAAA;QACrE,MAAMM,WAAAA,GAAcR,OAAOG,aAAa,EAAA,CAAGM,eAAe,CAACC,2BAA2B,GAClF,QACA,GAAA,OAAA;QACJ,MAAMC,wBAAAA,GAA2BC,yBAAyBC,GAAG,EAAA;AAC7Df,QAAAA,KAAAA,CAAMgB,WAAW,EAAA;AACjBhB,QAAAA,KAAAA,CAAMiB,oBAAoB,CAAChB,MAAAA,CAAAA;AAC3B,QAAA,IAAIA,MAAU,IAAA,CAACC,MAAOgB,CAAAA,aAAa,EAAI,EAAA;AACrC,YAAA,MAAMC,kBAAkB,CAAC,CAAClB,MAAOmB,CAAAA,GAAG,IAAIlB,MAAOmB,CAAAA,IAAI,KAAK,OAAM,KAAM,CAACpB,MAAAA,CAAOqB,QAAQ,IAAI,CAACrB,OAAOsB,OAAO;YACvG,MAAMC,OAAAA,GAAUvB,MAAOqB,CAAAA,QAAQ,GAAGpB,MAAAA,CAAOuB,eAAe,CAACxB,MAAOqB,CAAAA,QAAQ,CAAC,CAAA,CAAE,CAAI,GAAA,CAAA;YAC/E,MAAMI,OAAAA,GAAUzB,MAAOqB,CAAAA,QAAQ,GAAGpB,MAAAA,CAAOyB,eAAe,CAAC1B,MAAOqB,CAAAA,QAAQ,CAAC,CAAA,CAAE,CAAI,GAAA,CAAA;AAC/E,YAAA,MAAMM,WAAc3B,GAAAA,MAAAA,CAAOqB,QAAQ,GAC/BpB,MAAOuB,CAAAA,eAAe,CAACxB,MAAAA,CAAOqB,QAAQ,CAAC,CAAE,CAAA,CAAA,GACzCpB,OAAO2B,qBAAqB,EAAA;AAChC,YAAA,MAAMC,YAAe7B,GAAAA,MAAAA,CAAOqB,QAAQ,GAChCpB,MAAOyB,CAAAA,eAAe,CAAC1B,MAAAA,CAAOqB,QAAQ,CAAC,CAAE,CAAA,CAAA,GACzCpB,OAAO6B,sBAAsB,EAAA;YACjC,IAAIH,WAAAA,GAAc,CAAKE,IAAAA,YAAAA,GAAe,CAAG,EAAA;gBACvC,MAAME,cAAAA,GAAiBb,eACnB,GAAA,IAAA,GACAjB,MAAO+B,CAAAA,IAAI,CAACC,wBAAwB,CAAC,KAAA,EAAON,WAAaE,EAAAA,YAAAA,EAActB,WAAaE,EAAAA,WAAAA,CAAAA;gBACxF,MAAMyB,iBAAAA,GAAoBjC,OAAOkC,cAAc,EAAA;AAC/C,gBAAA,IAAIJ,cAAgB,EAAA;AAClB9B,oBAAAA,MAAAA,CAAOmC,gBAAgB,EAAA;AACvBnC,oBAAAA,MAAAA,CAAOoC,cAAc,CAACN,cAAAA,CAAAA;AACxB;gBACA9B,MAAOqC,CAAAA,gBAAgB,CAACtC,MAAOuC,CAAAA,UAAU,EAAEvC,MAAOwC,CAAAA,UAAU,EAAExC,MAAAA,CAAOyC,YAAY,CAAA;AACjF,gBAAA,MAAMC,MAAM1C,MAAO0C,CAAAA,GAAG,IAAI3C,KAAM4C,CAAAA,GAAG,CAACC,KAAK,CAACC,QAAQ,IAAI9C,MAAM4C,GAAG,CAACC,KAAK,CAACC,QAAQ,CAACC,WAAW,EAAA;gBAC1F,MAAMC,GAAAA,GAAM/C,OAAO+C,GAAG;gBACtB,MAAMC,mBAAAA,GAAqC7C,uBAAuB,SAAY,GAAA,YAAA;AAC9E,gBAAA,MAAM8C,GAAmB,GAAA;AACvBhD,oBAAAA,MAAAA;AACAF,oBAAAA,KAAAA;AACA4B,oBAAAA,WAAAA;AACAE,oBAAAA,YAAAA;oBACAqB,GAAK,EAAA,IAAA;AACLC,oBAAAA,aAAAA,EACElD,MAAOmB,CAAAA,IAAI,KAAK,OAAA,KAAYpB,MAAAA,CAAOmB,GAAG,IAAInB,MAAOoD,CAAAA,UAAU,IAAKV,GAAAA,IAAO1C,OAAOqD,WAAW,CAAA;AAC3FC,oBAAAA,GAAAA,EAAKtD,MAAOsD,CAAAA,GAAG,IAAIrD,MAAAA,CAAOmB,IAAI,KAAK,OAAA;oBACnCmC,UAAY,EAAA,IAAA;AACZ3C,oBAAAA,wBAAAA;AACAZ,oBAAAA,MAAAA;AACAwD,oBAAAA,UAAAA,EAAYxD,OAAOwD,UAAU;oBAC7BC,KAAO,EAAA,CAAA;oBACPC,aAAe,EAAA,KAAA;oBACfC,UAAY,EAAA,IAAA;oBACZC,cAAgB,EAAA,IAAA;oBAChBC,IAAM,EAAA,KAAA;AACNpD,oBAAAA,WAAAA;AACAF,oBAAAA,WAAAA;oBACAuD,YAAc,EAAA,KAAA;oBACdnB,GAAK,EAAA,IAAA;oBACLoB,QAAU,EAAA,IAAA;oBACVC,uBAAyB,EAAA,IAAA;oBACzBC,wBAA0B,EAAA,IAAA;oBAC1BC,aAAe,EAAA,CAAA;AACfxB,oBAAAA,GAAAA;AACAK,oBAAAA,GAAAA;oBACAoB,gBAAkBzB,EAAAA,GAAAA,IAAO1C,OAAOoE,gBAAgB;oBAChDC,mBAAqB3B,EAAAA,GAAAA,GACjBzC,OAAO+B,IAAI,CAACsC,sBAAsB,CAAC,IAAA,EAAMtB,mBAAqBrB,EAAAA,WAAAA,EAAaE,YAC3E,CAAA,GAAA,IAAA;oBACJ0C,gBAAkB7B,EAAAA,GAAAA,GACdzC,OAAO+B,IAAI,CAACsC,sBAAsB,CAAC,IAAA,EAAMtB,mBAAqBrB,EAAAA,WAAAA,EAAaE,YAC3E,CAAA,GAAA,IAAA;oBACJ2C,iBAAmB,EAAA,IAAA;oBACnBC,eAAiB,EAAA,IAAA;oBACjBC,iBAAmB,EAAA,IAAA;oBACnBC,sBAAwB,EAAA,IAAA;oBACxBC,eAAiB,EAAA,IAAA;oBACjBC,cAAgB,EAAA,CAAA;AAChBC,oBAAAA,gBAAAA,EAAkB7E,OAAOkC,cAAc,EAAA;oBACvC4C,uBAAyB,EAAA;AAC3B,iBAAA;gBACA,IAAI,CAACC,YAAY,CAAC/B,GAAAA,CAAAA;AAClB,gBAAA,IAAIlB,cAAgB,EAAA;AAClB9B,oBAAAA,MAAAA,CAAOgF,eAAe,EAAA;AACtB,oBAAA,MAAMC,iBACJ3D,GAAAA,OAAAA,GAAU,CACVE,IAAAA,OAAAA,GAAU,CACVF,IAAAA,OAAAA,GAAUI,WAAc1B,GAAAA,MAAAA,CAAO2B,qBAAqB,EAAA,IACpDH,OAAUI,GAAAA,YAAAA,GAAe5B,OAAO6B,sBAAsB,EAAA;AACxD,oBAAA,MAAMqD,UAAU,IAAIC,WAAAA,EAAAA;AACpB,oBAAA,IAAIF,iBAAmB,EAAA;AACrBC,wBAAAA,OAAAA,CAAQE,QAAQ,GAAG;AAAC9D,4BAAAA,OAAAA;AAASE,4BAAAA,OAAAA;AAASE,4BAAAA,WAAAA;AAAaE,4BAAAA;AAAa,yBAAA;qBAC3D,MAAA;wBACLsD,OAAQ9D,CAAAA,QAAQ,GAAGrB,MAAOqB,CAAAA,QAAQ,GAAGrB,MAAOqB,CAAAA,QAAQ,CAACiE,KAAK,EAAK,GAAA,IAAA;AACjE;oBACAH,OAAQ7D,CAAAA,OAAO,GAAGtB,MAAOsB,CAAAA,OAAO,GAAGtB,MAAOsB,CAAAA,OAAO,CAACgE,KAAK,EAAK,GAAA,IAAA;oBAC5DH,OAAQI,CAAAA,OAAO,GAAG,CAACrD,iBAAAA;oBACnBiD,OAAQK,CAAAA,IAAI,CACVzD,cAAAA,CAAe0D,mBAAmB,EAAE,CAAC,CAAE,CAAA,EACvCvD,iBAAqB,IAAA,IAAA,EACrBwD,YAAa,CAAA,qBAAA,CAAA,CAAA;oBAEfzF,MAAO+B,CAAAA,IAAI,CAAC2D,kBAAkB,CAAC5D,cAAAA,CAAAA;AACjC;aACK,MAAA;AACL/B,gBAAAA,MAAAA,CAAO4F,wBAAwB,EAAK,GAAA,IAAA,CAAA;AACpC,gBAAA;AACF;AACF;AACA/E,QAAAA,wBAAAA,CAAyBgF,OAAO,CAACjF,wBAAAA,CAAAA;AACnC;AAEA,qBACA,OAAiBoE,YAAa/B,CAAAA,GAAgB,EAAQ;QACpD6C,uBAAwB7C,CAAAA,GAAAA,CAAAA;AAC1B;AACF;;;;"}

package/dist/render/rendergraph/device_pool_allocator.js

@@ -41,6 +41,14 @@ import { getDevice } from '../../app/api.js';
         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) {
+        const device = getDevice();
+        device.pool.retainTexture(texture);
+    }
+    /**
    * Allocate a temporary framebuffer from the device pool.
    *
    * @param desc - Framebuffer descriptor from the render graph pass.

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 } from '@zephyr3d/device';\r\nimport type { RGFramebufferDesc, RGTextureAllocator, RGTextureDesc, RGResolvedSize } from './types';\r\nimport { getDevice } from '../../app/api';\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  /**\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 = 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 = getDevice();\r\n    device.pool.releaseTexture(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 = 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 = getDevice();\r\n    device.pool.releaseFrameBuffer(framebuffer);\r\n  }\r\n}\r\n"],"names":["DevicePoolAllocator","allocate","desc","size","device","getDevice","mipmapping","mipLevels","texture","pool","fetchTemporalTexture2D","format","width","height","mipLevelCount","releaseTexture","Error","label","release","allocateFramebuffer","colors","Array","isArray","colorAttachments","depthAttachment","fetchTemporalFramebuffer","sampleCount","ignoreDepthStencil","attachmentMipLevel","attachmentCubeface","attachmentLayer","releaseFramebuffer","framebuffer","releaseFrameBuffer"],"mappings":";;AAIA;;;;;;;;;;;;;;;AAeC,IACM,MAAMA,mBAAAA,CAAAA;AACX;;;;;;AAMC,MACDC,QAASC,CAAAA,IAAmB,EAAEC,IAAoB,EAAa;AAC7D,QAAA,MAAMC,MAASC,GAAAA,SAAAA,EAAAA;AACf,QAAA,MAAMC,aAAa,CAACJ,KAAKK,SAAS,IAAI,CAAA,IAAK,CAAA;AAC3C,QAAA,MAAMC,OAAUJ,GAAAA,MAAAA,CAAOK,IAAI,CAACC,sBAAsB,CAChD,KAAA,EACAR,IAAKS,CAAAA,MAAM,EACXR,IAAKS,CAAAA,KAAK,EACVT,IAAAA,CAAKU,MAAM,EACXP,UAAAA,CAAAA;QAEF,IAAIJ,IAAAA,CAAKK,SAAS,IAAIC,OAAAA,CAAQM,aAAa,GAAGZ,IAAAA,CAAKK,SAAS,EAAE;YAC5DH,MAAOK,CAAAA,IAAI,CAACM,cAAc,CAACP,OAAAA,CAAAA;YAC3B,MAAM,IAAIQ,KACR,CAAA,CAAC,8BAA8B,EAAEd,KAAKe,KAAK,IAAI,WAAY,CAAA,YAAY,EAAEf,IAAAA,CAAKK,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,MAAMJ,MAASC,GAAAA,SAAAA,EAAAA;QACfD,MAAOK,CAAAA,IAAI,CAACM,cAAc,CAACP,OAAAA,CAAAA;AAC7B;AAEA;;;;;MAMAW,mBAAAA,CAAoBjB,IAAuB,EAAe;AACxD,QAAA,MAAME,MAASC,GAAAA,SAAAA,EAAAA;AACf,QAAA,MAAMe,MAASC,GAAAA,KAAAA,CAAMC,OAAO,CAACpB,IAAKqB,CAAAA,gBAAgB,CAC7CrB,GAAAA,IAAAA,CAAKqB,gBAAgB,GACtBrB,IAAKqB,CAAAA,gBAAgB,GACnB;AAACrB,YAAAA,IAAAA,CAAKqB;AAA8C,SAAA,GACpD,EAAE;QACR,MAAMC,eAAAA,GAAmBtB,IAAKsB,CAAAA,eAAe,IAAI,IAAA;AACjD,QAAA,OAAOpB,OAAOK,IAAI,CAACgB,wBAAwB,CACzC,OACAvB,IAAKU,CAAAA,KAAK,IAAI,CAAA,EACdV,KAAKW,MAAM,IAAI,GACfO,MACAI,EAAAA,eAAAA,EACAtB,KAAKI,UAAU,IAAI,KACnBJ,EAAAA,IAAAA,CAAKwB,WAAW,IAAI,CAAA,EACpBxB,IAAKyB,CAAAA,kBAAkB,IAAI,IAC3BzB,EAAAA,IAAAA,CAAK0B,kBAAkB,IAAI,GAC3B1B,IAAK2B,CAAAA,kBAAkB,IAAI,CAC3B3B,EAAAA,IAAAA,CAAK4B,eAAe,IAAI,CAAA,CAAA;AAE5B;AAEA;;;;MAKAC,kBAAAA,CAAmBC,WAAwB,EAAQ;AACjD,QAAA,MAAM5B,MAASC,GAAAA,SAAAA,EAAAA;QACfD,MAAOK,CAAAA,IAAI,CAACwB,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 } from '@zephyr3d/device';\r\nimport type { RGFramebufferDesc, RGTextureAllocator, RGTextureDesc, RGResolvedSize } from './types';\r\nimport { getDevice } from '../../app/api';\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  /**\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 = 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 = 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 = 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 = 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 = getDevice();\r\n    device.pool.releaseFrameBuffer(framebuffer);\r\n  }\r\n}\r\n"],"names":["DevicePoolAllocator","allocate","desc","size","device","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":";;AAIA;;;;;;;;;;;;;;;AAeC,IACM,MAAMA,mBAAAA,CAAAA;AACX;;;;;;AAMC,MACDC,QAASC,CAAAA,IAAmB,EAAEC,IAAoB,EAAa;AAC7D,QAAA,MAAMC,MAASC,GAAAA,SAAAA,EAAAA;AACf,QAAA,MAAMC,aAAa,CAACJ,KAAKK,SAAS,IAAI,CAAA,IAAK,CAAA;AAC3C,QAAA,MAAMC,OAAUJ,GAAAA,MAAAA,CAAOK,IAAI,CAACC,sBAAsB,CAChD,KAAA,EACAR,IAAKS,CAAAA,MAAM,EACXR,IAAKS,CAAAA,KAAK,EACVT,IAAAA,CAAKU,MAAM,EACXP,UAAAA,CAAAA;QAEF,IAAIJ,IAAAA,CAAKK,SAAS,IAAIC,OAAAA,CAAQM,aAAa,GAAGZ,IAAAA,CAAKK,SAAS,EAAE;YAC5DH,MAAOK,CAAAA,IAAI,CAACM,cAAc,CAACP,OAAAA,CAAAA;YAC3B,MAAM,IAAIQ,KACR,CAAA,CAAC,8BAA8B,EAAEd,KAAKe,KAAK,IAAI,WAAY,CAAA,YAAY,EAAEf,IAAAA,CAAKK,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,MAAMJ,MAASC,GAAAA,SAAAA,EAAAA;QACfD,MAAOK,CAAAA,IAAI,CAACM,cAAc,CAACP,OAAAA,CAAAA;AAC7B;AAEA;;;;MAKAW,MAAAA,CAAOX,OAAkB,EAAQ;AAC/B,QAAA,MAAMJ,MAASC,GAAAA,SAAAA,EAAAA;QACfD,MAAOK,CAAAA,IAAI,CAACW,aAAa,CAACZ,OAAAA,CAAAA;AAC5B;AAEA;;;;;MAMAa,mBAAAA,CAAoBnB,IAAuB,EAAe;AACxD,QAAA,MAAME,MAASC,GAAAA,SAAAA,EAAAA;AACf,QAAA,MAAMiB,MAASC,GAAAA,KAAAA,CAAMC,OAAO,CAACtB,IAAKuB,CAAAA,gBAAgB,CAC7CvB,GAAAA,IAAAA,CAAKuB,gBAAgB,GACtBvB,IAAKuB,CAAAA,gBAAgB,GACnB;AAACvB,YAAAA,IAAAA,CAAKuB;AAA8C,SAAA,GACpD,EAAE;QACR,MAAMC,eAAAA,GAAmBxB,IAAKwB,CAAAA,eAAe,IAAI,IAAA;AACjD,QAAA,OAAOtB,OAAOK,IAAI,CAACkB,wBAAwB,CACzC,OACAzB,IAAKU,CAAAA,KAAK,IAAI,CAAA,EACdV,KAAKW,MAAM,IAAI,GACfS,MACAI,EAAAA,eAAAA,EACAxB,KAAKI,UAAU,IAAI,KACnBJ,EAAAA,IAAAA,CAAK0B,WAAW,IAAI,CAAA,EACpB1B,IAAK2B,CAAAA,kBAAkB,IAAI,IAC3B3B,EAAAA,IAAAA,CAAK4B,kBAAkB,IAAI,GAC3B5B,IAAK6B,CAAAA,kBAAkB,IAAI,CAC3B7B,EAAAA,IAAAA,CAAK8B,eAAe,IAAI,CAAA,CAAA;AAE5B;AAEA;;;;MAKAC,kBAAAA,CAAmBC,WAAwB,EAAQ;AACjD,QAAA,MAAM9B,MAASC,GAAAA,SAAAA,EAAAA;QACfD,MAAOK,CAAAA,IAAI,CAAC0B,kBAAkB,CAACD,WAAAA,CAAAA;AACjC;AACF;;;;"}