@forgeax/engine-render 0.1.33 → 0.1.34
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1010 -124
- package/dist/assembly/backend-contract.d.ts +2 -0
- package/dist/assembly/backend-contract.d.ts.map +1 -1
- package/dist/assembly/barrel-distortion-inspection.d.ts +3 -0
- package/dist/assembly/barrel-distortion-inspection.d.ts.map +1 -0
- package/dist/assembly/canvas-draw-guard.d.ts +3 -0
- package/dist/assembly/canvas-draw-guard.d.ts.map +1 -0
- package/dist/assembly/cloud-shadow-entry.d.ts +4 -0
- package/dist/assembly/cloud-shadow-entry.d.ts.map +1 -0
- package/dist/assembly/dynamic-geometry-host.d.ts +4 -1
- package/dist/assembly/dynamic-geometry-host.d.ts.map +1 -1
- package/dist/assembly/dynamic-geometry-runtime.d.ts +1 -1
- package/dist/assembly/dynamic-geometry-runtime.d.ts.map +1 -1
- package/dist/assembly/factory.d.ts +1 -1
- package/dist/assembly/factory.d.ts.map +1 -1
- package/dist/assembly/host-contract.d.ts +3 -3
- package/dist/assembly/host-contract.d.ts.map +1 -1
- package/dist/assembly/material/assembly.d.ts.map +1 -1
- package/dist/assembly/material/pipeline-helpers.d.ts +5 -0
- package/dist/assembly/material/pipeline-helpers.d.ts.map +1 -1
- package/dist/assembly/material-shader-policy.d.ts +16 -2
- package/dist/assembly/material-shader-policy.d.ts.map +1 -1
- package/dist/assembly/material-shader-prewarm.d.ts.map +1 -1
- package/dist/assembly/recovery/device-loss-fanout.d.ts.map +1 -1
- package/dist/assembly/recovery/renderer-recover.d.ts +2 -0
- package/dist/assembly/recovery/renderer-recover.d.ts.map +1 -1
- package/dist/assembly/render-feature-post-processes.d.ts +6 -0
- package/dist/assembly/render-feature-post-processes.d.ts.map +1 -0
- package/dist/assembly/renderer-facade.d.ts.map +1 -1
- package/dist/assembly/renderer-feature-inspection.d.ts +1 -1
- package/dist/assembly/renderer-feature-inspection.d.ts.map +1 -1
- package/dist/assembly/renderer-frame-transaction.d.ts +12 -0
- package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -1
- package/dist/assembly/renderer-inspection.d.ts +11 -0
- package/dist/assembly/renderer-inspection.d.ts.map +1 -1
- package/dist/assembly/webgpu-pbr-ready.d.ts +1 -0
- package/dist/assembly/webgpu-pbr-ready.d.ts.map +1 -1
- package/dist/assembly/webgpu-ready-per-pass.d.ts +39 -0
- package/dist/assembly/webgpu-ready-per-pass.d.ts.map +1 -0
- package/dist/assembly/webgpu-ready.d.ts +1 -1
- package/dist/assembly/webgpu-ready.d.ts.map +1 -1
- package/dist/assembly/webgpu-renderer-bootstrap.d.ts.map +1 -1
- package/dist/assembly/webgpu-renderer-observation-owner.d.ts +35 -0
- package/dist/assembly/webgpu-renderer-observation-owner.d.ts.map +1 -0
- package/dist/assembly/webgpu-renderer.d.ts +1 -1
- package/dist/assembly/webgpu-renderer.d.ts.map +1 -1
- package/dist/authoring.mjs +1 -1
- package/dist/barrel-distortion.d.ts +47 -0
- package/dist/barrel-distortion.d.ts.map +1 -0
- package/dist/{chunk-PA5DRJNI.mjs → chunk-ELJFJ2BU.mjs} +2 -2
- package/dist/chunk-ELJFJ2BU.mjs.map +1 -0
- package/dist/{chunk-ZDQWGQW7.mjs → chunk-HEB564WF.mjs} +4 -4
- package/dist/{chunk-ZDQWGQW7.mjs.map → chunk-HEB564WF.mjs.map} +1 -1
- package/dist/{chunk-VOZWDM3L.mjs → chunk-MKDIT2EM.mjs} +1307 -188
- package/dist/chunk-MKDIT2EM.mjs.map +1 -0
- package/dist/{chunk-LEAXOMYJ.mjs → chunk-OCDLEI6I.mjs} +3 -3
- package/dist/{chunk-LEAXOMYJ.mjs.map → chunk-OCDLEI6I.mjs.map} +1 -1
- package/dist/chunk-ODZWR6JQ.mjs +4927 -0
- package/dist/chunk-ODZWR6JQ.mjs.map +1 -0
- package/dist/{chunk-3RTCJTH4.mjs → chunk-SHFUFJ5N.mjs} +184 -13
- package/dist/chunk-SHFUFJ5N.mjs.map +1 -0
- package/dist/{chunk-OO3DRYK7.mjs → chunk-UI5SFODX.mjs} +176 -96
- package/dist/chunk-UI5SFODX.mjs.map +1 -0
- package/dist/{chunk-PLAXOOX5.mjs → chunk-UINHLCZA.mjs} +561 -79
- package/dist/chunk-UINHLCZA.mjs.map +1 -0
- package/dist/{chunk-NB2S7ZRX.mjs → chunk-WEX45HKH.mjs} +127 -386
- package/dist/chunk-WEX45HKH.mjs.map +1 -0
- package/dist/cloud/density.d.ts +55 -0
- package/dist/cloud/density.d.ts.map +1 -0
- package/dist/cloud/extract.d.ts +25 -0
- package/dist/cloud/extract.d.ts.map +1 -0
- package/dist/cloud/feature.d.ts +57 -0
- package/dist/cloud/feature.d.ts.map +1 -0
- package/dist/cloud/frame-context.d.ts +8 -0
- package/dist/cloud/frame-context.d.ts.map +1 -0
- package/dist/cloud/inspection.d.ts +59 -0
- package/dist/cloud/inspection.d.ts.map +1 -0
- package/dist/cloud/optics.d.ts +56 -0
- package/dist/cloud/optics.d.ts.map +1 -0
- package/dist/cloud/parameters.d.ts +73 -0
- package/dist/cloud/parameters.d.ts.map +1 -0
- package/dist/cloud/resources.d.ts +60 -0
- package/dist/cloud/resources.d.ts.map +1 -0
- package/dist/cloud/shadow.d.ts +42 -0
- package/dist/cloud/shadow.d.ts.map +1 -0
- package/dist/cloud/temporal.d.ts +74 -0
- package/dist/cloud/temporal.d.ts.map +1 -0
- package/dist/components/barrel-distortion.d.ts +13 -0
- package/dist/components/barrel-distortion.d.ts.map +1 -0
- package/dist/components/cloud-layer.d.ts +29 -0
- package/dist/components/cloud-layer.d.ts.map +1 -0
- package/dist/components/index.d.ts +2 -0
- package/dist/components/index.d.ts.map +1 -1
- package/dist/components/instances.d.ts +20 -6
- package/dist/components/instances.d.ts.map +1 -1
- package/dist/construct-renderer.d.ts +1 -1
- package/dist/construct-renderer.d.ts.map +1 -1
- package/dist/construct-renderer.mjs +6759 -2875
- package/dist/construct-renderer.mjs.map +1 -1
- package/dist/dynamic-geometry.d.ts +5 -1
- package/dist/dynamic-geometry.d.ts.map +1 -1
- package/dist/errors/cloud.d.ts +59 -0
- package/dist/errors/cloud.d.ts.map +1 -0
- package/dist/errors/render.d.ts +18 -4
- package/dist/errors/render.d.ts.map +1 -1
- package/dist/examples/single-layer-medium-surface.d.ts +47 -0
- package/dist/examples/single-layer-medium-surface.d.ts.map +1 -0
- package/dist/extract/camera.d.ts.map +1 -1
- package/dist/extract/contracts.d.ts +5 -1
- package/dist/extract/contracts.d.ts.map +1 -1
- package/dist/features/barrel-distortion.d.ts +29 -0
- package/dist/features/barrel-distortion.d.ts.map +1 -0
- package/dist/features/error-reporting.d.ts +6 -2
- package/dist/features/error-reporting.d.ts.map +1 -1
- package/dist/features/host.d.ts +10 -0
- package/dist/features/host.d.ts.map +1 -1
- package/dist/features/plan.d.ts +8 -0
- package/dist/features/plan.d.ts.map +1 -1
- package/dist/features/render-graph-contribution.d.ts +5 -0
- package/dist/features/render-graph-contribution.d.ts.map +1 -1
- package/dist/features/render-graph-raster.d.ts +1 -0
- package/dist/features/render-graph-raster.d.ts.map +1 -1
- package/dist/features/targets.d.ts +2 -0
- package/dist/features/targets.d.ts.map +1 -1
- package/dist/features/types.d.ts +44 -0
- package/dist/features/types.d.ts.map +1 -1
- package/dist/fullscreen-post-process-pass.d.ts +15 -7
- package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
- package/dist/gpu-dirty-ranges.d.ts +11 -0
- package/dist/gpu-dirty-ranges.d.ts.map +1 -0
- package/dist/gpu-driven/batch-topology.d.ts +17 -0
- package/dist/gpu-driven/batch-topology.d.ts.map +1 -1
- package/dist/gpu-driven/material-artifacts.d.ts +6 -0
- package/dist/gpu-driven/material-artifacts.d.ts.map +1 -1
- package/dist/gpu-driven/prepared-draw.d.ts.map +1 -1
- package/dist/gpu-driven/production-raster-material.d.ts +178 -0
- package/dist/gpu-driven/production-raster-material.d.ts.map +1 -0
- package/dist/gpu-driven/production-raster.d.ts +47 -3
- package/dist/gpu-driven/production-raster.d.ts.map +1 -1
- package/dist/gpu-driven/resource-allocation.d.ts +31 -0
- package/dist/gpu-driven/resource-allocation.d.ts.map +1 -0
- package/dist/gpu-driven/shadow-ownership.d.ts +14 -0
- package/dist/gpu-driven/shadow-ownership.d.ts.map +1 -0
- package/dist/gpu-driven/view-gpu.d.ts +26 -2
- package/dist/gpu-driven/view-gpu.d.ts.map +1 -1
- package/dist/gpu-scene.d.ts +5 -0
- package/dist/gpu-scene.d.ts.map +1 -1
- package/dist/hdrp-buffers.d.ts +2 -2
- package/dist/hdrp-buffers.d.ts.map +1 -1
- package/dist/ibl/skylight-bind-group.d.ts +10 -1
- package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
- package/dist/index.d.ts +27 -7
- package/dist/index.d.ts.map +1 -1
- package/dist/index.mjs +258 -8
- package/dist/index.mjs.map +1 -1
- package/dist/inspection-types.d.ts +135 -1
- package/dist/inspection-types.d.ts.map +1 -1
- package/dist/instance-buffer-cache.d.ts +4 -4
- package/dist/instance-buffer-cache.d.ts.map +1 -1
- package/dist/instances.d.ts +48 -100
- package/dist/instances.d.ts.map +1 -1
- package/dist/internal.mjs +7 -7
- package/dist/pbr-pipeline.d.ts +19 -1
- package/dist/pbr-pipeline.d.ts.map +1 -1
- package/dist/pipeline/single-layer-medium-passes.d.ts +73 -0
- package/dist/pipeline/single-layer-medium-passes.d.ts.map +1 -0
- package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
- package/dist/pipeline/standard-output/graph.d.ts.map +1 -1
- package/dist/pipeline/standard-output/types.d.ts +4 -2
- package/dist/pipeline/standard-output/types.d.ts.map +1 -1
- package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
- package/dist/pipeline/standard-post.d.ts.map +1 -1
- package/dist/pipeline-builder.d.ts +1 -1
- package/dist/pipeline-builder.d.ts.map +1 -1
- package/dist/plugin.d.ts.map +1 -1
- package/dist/prepare/prepared-graphics-resolver.d.ts +2 -0
- package/dist/prepare/prepared-graphics-resolver.d.ts.map +1 -1
- package/dist/record/barrel-distortion-frame.d.ts +15 -0
- package/dist/record/barrel-distortion-frame.d.ts.map +1 -0
- package/dist/record/dynamic-geometry-consumption.d.ts +10 -2
- package/dist/record/dynamic-geometry-consumption.d.ts.map +1 -1
- package/dist/record/fold-buckets.d.ts +95 -0
- package/dist/record/fold-buckets.d.ts.map +1 -0
- package/dist/record/fold-instance-buffer.d.ts +6 -0
- package/dist/record/fold-instance-buffer.d.ts.map +1 -0
- package/dist/record/frame-lighting.d.ts +1 -0
- package/dist/record/frame-lighting.d.ts.map +1 -1
- package/dist/record/frame-snapshot.d.ts +37 -3
- package/dist/record/frame-snapshot.d.ts.map +1 -1
- package/dist/record/frame.d.ts +10 -61
- package/dist/record/frame.d.ts.map +1 -1
- package/dist/record/gpu-draw-receipts.d.ts +11 -0
- package/dist/record/gpu-draw-receipts.d.ts.map +1 -0
- package/dist/record/gpu-timing.d.ts +8 -0
- package/dist/record/gpu-timing.d.ts.map +1 -1
- package/dist/record/main-pass-geometry.d.ts +21 -5
- package/dist/record/main-pass-geometry.d.ts.map +1 -1
- package/dist/record/main-pass-material.d.ts +7 -1
- package/dist/record/main-pass-material.d.ts.map +1 -1
- package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
- package/dist/record/main-pass.d.ts +13 -2
- package/dist/record/main-pass.d.ts.map +1 -1
- package/dist/record/motion-blur-receipt.d.ts +11 -0
- package/dist/record/motion-blur-receipt.d.ts.map +1 -0
- package/dist/record/probe-blend-buffer.d.ts +16 -0
- package/dist/record/probe-blend-buffer.d.ts.map +1 -0
- package/dist/record/recovery-pipeline.d.ts.map +1 -1
- package/dist/record/render-context.d.ts +22 -3
- package/dist/record/render-context.d.ts.map +1 -1
- package/dist/record/shadow-pass.d.ts +2 -0
- package/dist/record/shadow-pass.d.ts.map +1 -1
- package/dist/record/skybox-post-pass.d.ts +1 -1
- package/dist/record/skybox-post-pass.d.ts.map +1 -1
- package/dist/record/typed-frame-graph.d.ts +22 -2
- package/dist/record/typed-frame-graph.d.ts.map +1 -1
- package/dist/record/view-ubo.d.ts +11 -3
- package/dist/record/view-ubo.d.ts.map +1 -1
- package/dist/record/volume-params.d.ts +9 -0
- package/dist/record/volume-params.d.ts.map +1 -0
- package/dist/recovery/render-system-candidate.d.ts +10 -0
- package/dist/recovery/render-system-candidate.d.ts.map +1 -1
- package/dist/reflection/record-owner.d.ts.map +1 -1
- package/dist/render-contract.d.ts +42 -4
- package/dist/render-contract.d.ts.map +1 -1
- package/dist/render-graph-primitives.d.ts.map +1 -1
- package/dist/render-pipeline.d.ts +103 -2
- package/dist/render-pipeline.d.ts.map +1 -1
- package/dist/render-system-extract-tail.d.ts +3 -2
- package/dist/render-system-extract-tail.d.ts.map +1 -1
- package/dist/render-system-extract.d.ts +16 -9
- package/dist/render-system-extract.d.ts.map +1 -1
- package/dist/render-system-presentation.d.ts +23 -0
- package/dist/render-system-presentation.d.ts.map +1 -0
- package/dist/render-system-producer-roots.d.ts +10 -0
- package/dist/render-system-producer-roots.d.ts.map +1 -0
- package/dist/render-system-residency.d.ts +12 -0
- package/dist/render-system-residency.d.ts.map +1 -0
- package/dist/render-system.d.ts +19 -14
- package/dist/render-system.d.ts.map +1 -1
- package/dist/scene/probe-blend.d.ts +27 -0
- package/dist/scene/probe-blend.d.ts.map +1 -1
- package/dist/scene/render-scene.d.ts +12 -5
- package/dist/scene/render-scene.d.ts.map +1 -1
- package/dist/ssao-buffers.d.ts +9 -0
- package/dist/ssao-buffers.d.ts.map +1 -1
- package/dist/surface/dynamic-input.d.ts +133 -0
- package/dist/surface/dynamic-input.d.ts.map +1 -0
- package/dist/surface/gpu-driven.d.ts +41 -0
- package/dist/surface/gpu-driven.d.ts.map +1 -0
- package/dist/surface/submission-observation.d.ts +136 -0
- package/dist/surface/submission-observation.d.ts.map +1 -0
- package/dist/systems/skin-palette-allocator.d.ts.map +1 -1
- package/dist/temporal/gpu.d.ts +13 -1
- package/dist/temporal/gpu.d.ts.map +1 -1
- package/dist/temporal/index.mjs +5 -5
- package/dist/temporal/inspection.d.ts.map +1 -1
- package/dist/temporal/standard-scene-data.d.ts.map +1 -1
- package/dist/temporal/target-coverage-attachment.d.ts.map +1 -1
- package/dist/transmission/single-layer-medium.d.ts +89 -0
- package/dist/transmission/single-layer-medium.d.ts.map +1 -0
- package/dist/typed-render-graph-primitives.d.ts +14 -2
- package/dist/typed-render-graph-primitives.d.ts.map +1 -1
- package/dist/volume/component.d.ts +9 -4
- package/dist/volume/component.d.ts.map +1 -1
- package/dist/volume/extract.d.ts +1 -1
- package/dist/volume/extract.d.ts.map +1 -1
- package/dist/volume/inspection.d.ts +2 -0
- package/dist/volume/inspection.d.ts.map +1 -1
- package/dist/volume/passes.d.ts +4 -1
- package/dist/volume/passes.d.ts.map +1 -1
- package/dist/volume/resources.d.ts.map +1 -1
- package/package.json +22 -21
- package/src/__tests__/atmosphere-daylight.dawn.test.ts +72 -0
- package/src/__tests__/barrel-distortion-lkg.integration.test.ts +353 -0
- package/src/__tests__/barrel-distortion.dawn.test.ts +41 -0
- package/src/__tests__/barrel-distortion.unit.test.ts +364 -0
- package/src/__tests__/construct-renderer-identity.unit.test.ts +49 -0
- package/src/__tests__/detached-recovery-graph.unit.test.ts +277 -0
- package/src/__tests__/device-loss-fanout.unit.test.ts +36 -1
- package/src/__tests__/docs-gate-green.unit.test.ts +112 -1
- package/src/__tests__/factory-contract.integration.test.ts +295 -45
- package/src/__tests__/feature-depth-input.dawn.test.ts +129 -2
- package/src/__tests__/fullscreen-feature-plan.unit.test.ts +14 -3
- package/src/__tests__/gpu-dirty-ranges.unit.test.ts +22 -0
- package/src/__tests__/gpu-driven-baseline.characterization.test.ts +16 -3
- package/src/__tests__/gpu-driven-batch-topology-pbr.unit.test.ts +12 -0
- package/src/__tests__/gpu-driven-material-artifacts.unit.test.ts +143 -0
- package/src/__tests__/gpu-driven-pbr.dawn.test.ts +2 -2
- package/src/__tests__/gpu-driven-production.integration.test.ts +482 -3
- package/src/__tests__/gpu-driven-shadow-views.dawn.test.ts +6 -5
- package/src/__tests__/gpu-driven-view-gpu-evidence.ts +94 -6
- package/src/__tests__/gpu-driven-view-graph.integration.test.ts +18 -2
- package/src/__tests__/gpu-driven-view.browser.test.ts +5 -8
- package/src/__tests__/gpu-driven-view.dawn.test.ts +6 -2
- package/src/__tests__/gpu-driven-view.unit.test.ts +1 -1
- package/src/__tests__/gpu-pass-timing-lifecycle.integration.test.ts +1 -0
- package/src/__tests__/gpu-pass-timing.browser.test.ts +6 -4
- package/src/__tests__/gpu-pass-timing.rhi-null.unit.test.ts +1 -0
- package/src/__tests__/gpu-scene.unit.test.ts +119 -9
- package/src/__tests__/instance-allocation-failure.unit.test.ts +57 -0
- package/src/__tests__/instances-culling.integration.test.ts +10 -36
- package/src/__tests__/instances-store.unit.test.ts +97 -305
- package/src/__tests__/instances-world-ownership.integration.test.ts +62 -0
- package/src/__tests__/main-pass-material-medium-selection.unit.test.ts +146 -0
- package/src/__tests__/material-shader-prewarm.unit.test.ts +59 -0
- package/src/__tests__/material-snapshot-mutation.integration.test.ts +39 -1
- package/src/__tests__/morph-culling-reentry.dawn.test.ts +5 -5
- package/src/__tests__/morph-visual-evidence.integration.test.ts +8 -7
- package/src/__tests__/motion-blur-compute.dawn.test.ts +13 -7
- package/src/__tests__/motion-blur.pixel.integration.test.ts +2 -2
- package/src/__tests__/nineslice-handle-surface.unit.test.ts +4 -4
- package/src/__tests__/pbr-view-layout.unit.test.ts +9 -0
- package/src/__tests__/physical-clearcoat.integration.test.ts +58 -0
- package/src/__tests__/prepared-graphics-capability.unit.test.ts +66 -2
- package/src/__tests__/probe-bindings.unit.test.ts +582 -1
- package/src/__tests__/probe-scene-dirty.integration.test.ts +28 -1
- package/src/__tests__/receipt-observation-retirement.unit.test.ts +65 -0
- package/src/__tests__/recovery-candidate-prepare.contract.test.ts +69 -0
- package/src/__tests__/render-error-code-owner.test-d.ts +7 -0
- package/src/__tests__/render-feature-diagnostics.unit.test.ts +15 -2
- package/src/__tests__/render-feature-error-reporting.unit.test.ts +21 -1
- package/src/__tests__/render-feature-prepared-diagnostics.unit.test.ts +10 -1
- package/src/__tests__/render-feature-retry.unit.test.ts +12 -1
- package/src/__tests__/render-scene-mixed-updates.integration.test.ts +145 -19
- package/src/__tests__/render-scene-projection.unit.test.ts +36 -11
- package/src/__tests__/render-scene-temporal-retry.unit.test.ts +20 -20
- package/src/__tests__/render-target-probe-soak.perf.test.ts +2 -2
- package/src/__tests__/render-temporal-environment-consumer.browser.test.ts +3 -3
- package/src/__tests__/render-temporal-environment-consumer.dawn.test.ts +5 -2
- package/src/__tests__/renderer-factory-material-contract.unit.test.ts +41 -7
- package/src/__tests__/renderer-frame-generation-fence.integration.test.ts +16 -0
- package/src/__tests__/renderer-frame-transaction.integration.test.ts +26 -10
- package/src/__tests__/resource-allocation.unit.test.ts +123 -0
- package/src/__tests__/single-layer-medium-passes.unit.test.ts +275 -0
- package/src/__tests__/skin-motion-regression.unit.test.ts +70 -1
- package/src/__tests__/skin-palette-recycling.dawn.test.ts +97 -0
- package/src/__tests__/skinned-shadow-caster.test.ts +15 -0
- package/src/__tests__/ssr-carrier-public-contract.unit.test.ts +21 -0
- package/src/__tests__/ssr-gpu-dispatch.browser.test.ts +4 -4
- package/src/__tests__/ssr-gpu-dispatch.dawn.test.ts +2 -2
- package/src/__tests__/ssr-gpu-dispatch.ts +1 -1
- package/src/__tests__/ssr-receiver-coverage.dawn.test.ts +6 -2
- package/src/__tests__/standard-output-chain-contract.unit.test.ts +28 -0
- package/src/__tests__/standard-pbr-artifact-assembly.unit.test.ts +46 -1
- package/src/__tests__/standard-pipeline.integration.test.ts +182 -1
- package/src/__tests__/surface-dynamic-buffer-lifecycle.unit.test.ts +506 -0
- package/src/__tests__/surface-submission-observation.unit.test.ts +812 -0
- package/src/__tests__/temporal-history-lifecycle.unit.test.ts +32 -0
- package/src/__tests__/temporal-performance.integration.test.ts +3 -3
- package/src/__tests__/visibility-instances.integration.test.ts +7 -19
- package/src/__tests__/visibility-producer-matrix.integration.test.ts +9 -20
- package/src/__tests__/volume-optics-oracle.unit.test.ts +4 -2
- package/src/__tests__/volumetric-fog-budget-recovery.integration.test.ts +30 -20
- package/src/__tests__/volumetric-fog-errors.unit.test.ts +4 -3
- package/src/__tests__/volumetric-fog-multiple.unit.test.ts +55 -0
- package/src/__tests__/volumetric-fog-spot-frame-optics.integration.test.ts +1 -1
- package/src/__tests__/volumetric-fog-stage-readback.dawn.test.ts +113 -9
- package/src/__tests__/volumetric-fog-topology.unit.test.ts +5 -3
- package/src/assembly/backend-contract.ts +30 -0
- package/src/assembly/barrel-distortion-inspection.ts +22 -0
- package/src/assembly/canvas-draw-guard.ts +11 -0
- package/src/assembly/cloud-shadow-entry.ts +22 -0
- package/src/assembly/dynamic-geometry-host.ts +65 -37
- package/src/assembly/dynamic-geometry-runtime.ts +7 -1
- package/src/assembly/factory.ts +2 -30
- package/src/assembly/host-contract.ts +3 -3
- package/src/assembly/material/assembly.ts +25 -13
- package/src/assembly/material/pipeline-helpers.ts +53 -12
- package/src/assembly/material-shader-policy.ts +55 -0
- package/src/assembly/material-shader-prewarm.ts +21 -10
- package/src/assembly/recovery/device-loss-fanout.ts +13 -0
- package/src/assembly/recovery/renderer-recover.ts +41 -18
- package/src/assembly/render-feature-post-processes.ts +54 -0
- package/src/assembly/renderer-facade.ts +4 -1
- package/src/assembly/renderer-feature-inspection.ts +8 -2
- package/src/assembly/renderer-frame-transaction.ts +23 -0
- package/src/assembly/renderer-inspection.ts +28 -0
- package/src/assembly/skin-palette-owner.ts +1 -1
- package/src/assembly/temporal-post-process-prewarm.ts +3 -3
- package/src/assembly/webgpu-pbr-ready.ts +9 -1
- package/src/assembly/webgpu-ready-per-pass.ts +104 -0
- package/src/assembly/webgpu-ready.ts +115 -61
- package/src/assembly/webgpu-renderer-bootstrap.ts +0 -12
- package/src/assembly/webgpu-renderer-observation-owner.ts +222 -0
- package/src/assembly/webgpu-renderer.ts +214 -252
- package/src/assembly/webgpu-vertex-layouts.ts +1 -1
- package/src/barrel-distortion.ts +247 -0
- package/src/cloud/__tests__/cloud-density-parity.dawn.test.ts +173 -0
- package/src/cloud/__tests__/cloud-layer-framebuffer-y.dawn.test.ts +265 -0
- package/src/cloud/__tests__/cloud-layer.browser.test.ts +432 -0
- package/src/cloud/__tests__/cloud-layer.unit.test.ts +634 -0
- package/src/cloud/density.ts +600 -0
- package/src/cloud/extract.ts +110 -0
- package/src/cloud/feature.ts +1810 -0
- package/src/cloud/frame-context.ts +42 -0
- package/src/cloud/inspection.ts +130 -0
- package/src/cloud/optics.ts +285 -0
- package/src/cloud/parameters.ts +255 -0
- package/src/cloud/resources.ts +122 -0
- package/src/cloud/shadow.ts +167 -0
- package/src/cloud/temporal.ts +226 -0
- package/src/components/barrel-distortion.ts +46 -0
- package/src/components/cloud-layer.ts +47 -0
- package/src/components/index.ts +2 -0
- package/src/components/instances.ts +18 -45
- package/src/components/sprite-instances.ts +1 -1
- package/src/construct-renderer.ts +1 -1
- package/src/dynamic-geometry.ts +12 -1
- package/src/errors/cloud.ts +103 -0
- package/src/errors/render.ts +44 -7
- package/src/examples/single-layer-medium-surface.ts +59 -0
- package/src/extract/camera.ts +15 -1
- package/src/extract/contracts.ts +5 -0
- package/src/features/barrel-distortion.ts +172 -0
- package/src/features/error-reporting.ts +26 -6
- package/src/features/host.ts +115 -14
- package/src/features/plan.ts +8 -0
- package/src/features/render-graph-contribution.ts +9 -0
- package/src/features/render-graph-raster.ts +45 -3
- package/src/features/targets.ts +66 -0
- package/src/features/types.ts +47 -0
- package/src/fullscreen-post-process-pass.ts +41 -9
- package/src/gpu-dirty-ranges.ts +48 -0
- package/src/gpu-driven/batch-topology.ts +53 -0
- package/src/gpu-driven/material-artifacts.ts +33 -25
- package/src/gpu-driven/prepared-draw.ts +12 -4
- package/src/gpu-driven/production-raster-material.ts +1894 -0
- package/src/gpu-driven/production-raster.ts +825 -784
- package/src/gpu-driven/resource-allocation.ts +142 -0
- package/src/gpu-driven/shadow-ownership.ts +71 -0
- package/src/gpu-driven/view-gpu.ts +164 -10
- package/src/gpu-scene.ts +75 -84
- package/src/hdrp-buffers.ts +4 -3
- package/src/ibl/skylight-bind-group.ts +49 -7
- package/src/index.ts +196 -9
- package/src/inspection-types.ts +162 -0
- package/src/instance-buffer-cache.ts +4 -4
- package/src/instances.ts +149 -569
- package/src/pbr-pipeline.ts +219 -13
- package/src/pipeline/single-layer-medium-passes.ts +267 -0
- package/src/pipeline/standard-forward-lane.ts +313 -57
- package/src/pipeline/standard-output/graph.ts +8 -2
- package/src/pipeline/standard-output/types.ts +12 -1
- package/src/pipeline/standard-pipeline.ts +291 -18
- package/src/pipeline/standard-post.ts +90 -24
- package/src/pipeline-builder.ts +1 -1
- package/src/plugin.ts +4 -0
- package/src/points-lines/__tests__/points-lines.bench.ts +17 -8
- package/src/prepare/prepared-graphics-resolver.ts +2 -0
- package/src/record/__tests__/main-pass-geometry.unit.test.ts +30 -0
- package/src/record/__tests__/sprite-material-abi.unit.test.ts +1 -1
- package/src/record/__tests__/temporal-payload.unit.test.ts +1 -1
- package/src/record/__tests__/transparent-group2-selection.unit.test.ts +11 -0
- package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +1 -0
- package/src/record/__tests__/view-ubo-layout.unit.test.ts +4 -3
- package/src/record/barrel-distortion-frame.ts +110 -0
- package/src/record/dynamic-geometry-consumption.ts +39 -9
- package/src/record/fold-buckets.ts +852 -0
- package/src/record/fold-instance-buffer.ts +51 -0
- package/src/record/frame-lighting.ts +36 -2
- package/src/record/frame-snapshot.ts +39 -3
- package/src/record/frame.ts +217 -1084
- package/src/record/gpu-draw-receipts.ts +38 -0
- package/src/record/gpu-timing.ts +48 -5
- package/src/record/main-pass-geometry.ts +251 -82
- package/src/record/main-pass-material.ts +66 -4
- package/src/record/main-pass-sprite-draws.ts +7 -65
- package/src/record/main-pass.ts +156 -20
- package/src/record/motion-blur-receipt.ts +91 -0
- package/src/record/probe-blend-buffer.ts +180 -0
- package/src/record/recovery-pipeline.ts +35 -3
- package/src/record/render-context.ts +39 -3
- package/src/record/shadow-pass.ts +30 -1
- package/src/record/skybox-post-pass.ts +28 -4
- package/src/record/typed-frame-graph.ts +770 -134
- package/src/record/view-ubo.ts +26 -3
- package/src/record/volume-params.ts +225 -0
- package/src/recovery/render-system-candidate.ts +235 -42
- package/src/reflection/record-owner.ts +7 -3
- package/src/render-contract.ts +48 -4
- package/src/render-graph-primitives.ts +7 -1
- package/src/render-pipeline.ts +130 -0
- package/src/render-system-extract-tail.ts +57 -61
- package/src/render-system-extract.ts +74 -76
- package/src/render-system-presentation.ts +56 -0
- package/src/render-system-producer-roots.ts +96 -0
- package/src/render-system-residency.ts +159 -0
- package/src/render-system.ts +347 -363
- package/src/scene/probe-blend.ts +96 -4
- package/src/scene/render-scene.ts +349 -280
- package/src/ssao-buffers.ts +95 -2
- package/src/surface/__tests__/dynamic-input.unit.test.ts +374 -0
- package/src/surface/__tests__/gpu-driven.unit.test.ts +87 -0
- package/src/surface/dynamic-input.ts +658 -0
- package/src/surface/gpu-driven.ts +147 -0
- package/src/surface/submission-observation.ts +517 -0
- package/src/systems/skin-palette-allocator.ts +4 -1
- package/src/temporal/gpu.ts +101 -17
- package/src/temporal/inspection.ts +7 -1
- package/src/temporal/standard-scene-data.ts +5 -0
- package/src/temporal/target-coverage-attachment.ts +4 -0
- package/src/transmission/__tests__/single-layer-medium.unit.test.ts +149 -0
- package/src/transmission/__tests__/standard-transmission.dawn.test.ts +12 -11
- package/src/transmission/single-layer-medium.ts +322 -0
- package/src/typed-render-graph-primitives.ts +70 -2
- package/src/volume/component.ts +10 -9
- package/src/volume/extract.ts +11 -5
- package/src/volume/inspection.ts +3 -0
- package/src/volume/passes.ts +87 -4
- package/src/volume/resources.ts +2 -1
- package/dist/chunk-3RTCJTH4.mjs.map +0 -1
- package/dist/chunk-NB2S7ZRX.mjs.map +0 -1
- package/dist/chunk-NNQL7CB3.mjs +0 -1713
- package/dist/chunk-NNQL7CB3.mjs.map +0 -1
- package/dist/chunk-OO3DRYK7.mjs.map +0 -1
- package/dist/chunk-PA5DRJNI.mjs.map +0 -1
- package/dist/chunk-PLAXOOX5.mjs.map +0 -1
- package/dist/chunk-VOZWDM3L.mjs.map +0 -1
|
@@ -3,15 +3,27 @@ import { World } from '@forgeax/engine-ecs';
|
|
|
3
3
|
import { deriveVertexLayoutProjection } from '@forgeax/engine-geometry';
|
|
4
4
|
import { vec3 } from '@forgeax/engine-math';
|
|
5
5
|
import { RenderGraphBuilder } from '@forgeax/engine-render-graph';
|
|
6
|
-
import {
|
|
7
|
-
|
|
6
|
+
import {
|
|
7
|
+
type BindGroup,
|
|
8
|
+
type Buffer,
|
|
9
|
+
type Result,
|
|
10
|
+
RhiError,
|
|
11
|
+
type RhiRenderPassEncoder,
|
|
12
|
+
} from '@forgeax/engine-rhi';
|
|
13
|
+
import {
|
|
14
|
+
RhiNullCommandEncoder,
|
|
15
|
+
RhiNullDevice,
|
|
16
|
+
type RhiNullDevice as RhiNullDeviceType,
|
|
17
|
+
RhiNullQueue,
|
|
18
|
+
rhi,
|
|
19
|
+
} from '@forgeax/engine-rhi-null';
|
|
8
20
|
import { propagateTransforms, Transform } from '@forgeax/engine-scene';
|
|
9
21
|
import {
|
|
10
22
|
createStandardPbrArtifactReceipt,
|
|
11
23
|
DEFAULT_STANDARD_PBR_PARAM_SCHEMA,
|
|
12
24
|
DEFAULT_UNLIT_PARAM_SCHEMA,
|
|
13
25
|
} from '@forgeax/engine-shader';
|
|
14
|
-
import { ok } from '@forgeax/engine-types';
|
|
26
|
+
import { deriveMaterialDynamicInputLayout, ok } from '@forgeax/engine-types';
|
|
15
27
|
import { describe, expect, it, vi } from 'vitest';
|
|
16
28
|
import { createRenderer as constructRenderer } from '../assembly/factory';
|
|
17
29
|
import { Camera, MeshFilter, MeshRenderer, PointLight } from '../components';
|
|
@@ -23,6 +35,7 @@ import {
|
|
|
23
35
|
adaptStandardPbrFrameResources,
|
|
24
36
|
GpuDrivenProduction,
|
|
25
37
|
projectStandardPbrScene,
|
|
38
|
+
resolveGpuDrivenMeshGroup,
|
|
26
39
|
} from '../gpu-driven/production-raster';
|
|
27
40
|
import { GPU_DRIVEN_VIEW_WGSL } from '../gpu-driven/view-gpu';
|
|
28
41
|
import { GpuBuffer } from '../gpu-resource';
|
|
@@ -30,11 +43,13 @@ import { GpuScene } from '../gpu-scene';
|
|
|
30
43
|
import {
|
|
31
44
|
GPU_BUFFER_USAGE_COPY_DST,
|
|
32
45
|
GPU_BUFFER_USAGE_INDEX,
|
|
46
|
+
GPU_BUFFER_USAGE_STORAGE,
|
|
33
47
|
GPU_BUFFER_USAGE_UNIFORM,
|
|
34
48
|
GPU_BUFFER_USAGE_VERTEX,
|
|
35
49
|
} from '../gpu-usage';
|
|
36
50
|
import { buildDispatchPlan } from '../record/frame';
|
|
37
51
|
import { makeZeroCameraFallbackSnapshot, worldEntityKey } from '../record/frame-snapshot';
|
|
52
|
+
import { emitGpuDrivenDrawReceipts } from '../record/gpu-draw-receipts';
|
|
38
53
|
import {
|
|
39
54
|
encodeDirectionalShadowPass,
|
|
40
55
|
encodePointShadowPass,
|
|
@@ -51,6 +66,7 @@ import type {
|
|
|
51
66
|
} from '../render-system-extract';
|
|
52
67
|
import { shadowCasterCpuReason } from '../render-system-extract';
|
|
53
68
|
import { PersistentRenderScene, RenderScene } from '../scene/render-scene';
|
|
69
|
+
import { ReadonlyDynamicInputPage } from '../surface/dynamic-input';
|
|
54
70
|
import {
|
|
55
71
|
preparedPbrSnapshot as preparedPbrFixture,
|
|
56
72
|
standardPbrInputs,
|
|
@@ -58,6 +74,105 @@ import {
|
|
|
58
74
|
|
|
59
75
|
const STANDARD_PBR_RECEIPT = createStandardPbrArtifactReceipt();
|
|
60
76
|
|
|
77
|
+
describe('GPU-driven scene-index mesh address selection', () => {
|
|
78
|
+
it('keeps direct batches on their local group and rebuilds clustered group(2) around the same projection buffer', () => {
|
|
79
|
+
const directGroup = {} as BindGroup;
|
|
80
|
+
const clusteredGroup = {} as BindGroup;
|
|
81
|
+
const legacyClusterGroup = {} as BindGroup;
|
|
82
|
+
const projectionBuffer = {} as Buffer;
|
|
83
|
+
const clusterBindGroupForMesh = vi.fn(() => clusteredGroup);
|
|
84
|
+
const frameResources = { clusterBindGroup: legacyClusterGroup, clusterBindGroupForMesh };
|
|
85
|
+
|
|
86
|
+
expect(
|
|
87
|
+
resolveGpuDrivenMeshGroup({
|
|
88
|
+
clustered: false,
|
|
89
|
+
deformation: 'rigid',
|
|
90
|
+
meshBindGroup: directGroup,
|
|
91
|
+
meshProjectionBuffer: projectionBuffer,
|
|
92
|
+
meshProjectionBytes: 256,
|
|
93
|
+
frameResources,
|
|
94
|
+
}),
|
|
95
|
+
).toBe(directGroup);
|
|
96
|
+
expect(clusterBindGroupForMesh).not.toHaveBeenCalled();
|
|
97
|
+
|
|
98
|
+
expect(
|
|
99
|
+
resolveGpuDrivenMeshGroup({
|
|
100
|
+
clustered: true,
|
|
101
|
+
deformation: 'rigid',
|
|
102
|
+
meshBindGroup: directGroup,
|
|
103
|
+
meshProjectionBuffer: projectionBuffer,
|
|
104
|
+
meshProjectionBytes: 512,
|
|
105
|
+
frameResources,
|
|
106
|
+
}),
|
|
107
|
+
).toBe(clusteredGroup);
|
|
108
|
+
expect(clusterBindGroupForMesh).toHaveBeenCalledExactlyOnceWith(projectionBuffer, 512);
|
|
109
|
+
});
|
|
110
|
+
|
|
111
|
+
it('rebuilds clustered skin group(2) from the matching scene-index mesh and palette pages', () => {
|
|
112
|
+
const directSkinGroup = {} as BindGroup;
|
|
113
|
+
const clusteredSkinGroup = {} as BindGroup;
|
|
114
|
+
const projectionBuffer = {} as Buffer;
|
|
115
|
+
const paletteBuffer = {} as Buffer;
|
|
116
|
+
const clusterBindGroupForSkin = vi.fn(() => clusteredSkinGroup);
|
|
117
|
+
|
|
118
|
+
expect(
|
|
119
|
+
resolveGpuDrivenMeshGroup({
|
|
120
|
+
clustered: true,
|
|
121
|
+
deformation: 'skin',
|
|
122
|
+
meshBindGroup: directSkinGroup,
|
|
123
|
+
meshProjectionBuffer: projectionBuffer,
|
|
124
|
+
meshProjectionBytes: 768,
|
|
125
|
+
skinPaletteBinding: { buffer: paletteBuffer, bindingWindowBytes: 16_320 },
|
|
126
|
+
frameResources: { clusterBindGroupForSkin },
|
|
127
|
+
}),
|
|
128
|
+
).toBe(clusteredSkinGroup);
|
|
129
|
+
expect(clusterBindGroupForSkin).toHaveBeenCalledExactlyOnceWith(
|
|
130
|
+
projectionBuffer,
|
|
131
|
+
768,
|
|
132
|
+
paletteBuffer,
|
|
133
|
+
16_320,
|
|
134
|
+
);
|
|
135
|
+
});
|
|
136
|
+
});
|
|
137
|
+
|
|
138
|
+
interface BufferWrite {
|
|
139
|
+
readonly buffer: Buffer;
|
|
140
|
+
readonly offset: number;
|
|
141
|
+
readonly bytes: Uint8Array;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
class RecordingQueue extends RhiNullQueue {
|
|
145
|
+
readonly writes: BufferWrite[] = [];
|
|
146
|
+
|
|
147
|
+
override writeBuffer(
|
|
148
|
+
buffer: Buffer,
|
|
149
|
+
bufferOffset: number,
|
|
150
|
+
data: ArrayBufferView | ArrayBuffer,
|
|
151
|
+
dataOffset?: number,
|
|
152
|
+
size?: number,
|
|
153
|
+
): Result<void, RhiError> {
|
|
154
|
+
const source =
|
|
155
|
+
data instanceof ArrayBuffer
|
|
156
|
+
? new Uint8Array(data)
|
|
157
|
+
: new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
|
|
158
|
+
const start = dataOffset ?? 0;
|
|
159
|
+
const length = size ?? source.byteLength - start;
|
|
160
|
+
this.writes.push({
|
|
161
|
+
buffer,
|
|
162
|
+
offset: bufferOffset,
|
|
163
|
+
bytes: source.slice(start, start + length),
|
|
164
|
+
});
|
|
165
|
+
return super.writeBuffer(buffer, bufferOffset, data, dataOffset, size);
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
function recordingDevice(queue: RecordingQueue): RhiNullDeviceType {
|
|
170
|
+
return new RhiNullDevice(
|
|
171
|
+
queue,
|
|
172
|
+
(bookkeeper, device) => new RhiNullCommandEncoder(bookkeeper, device),
|
|
173
|
+
);
|
|
174
|
+
}
|
|
175
|
+
|
|
61
176
|
const EMPTY_RESOURCE_CLASS = JSON.stringify({ textures: [], samplers: [], video: [] });
|
|
62
177
|
const OUTPUT_TRANSFORM_WGSL =
|
|
63
178
|
'@vertex fn vs_main(@builtin(vertex_index) i: u32) -> @builtin(position) vec4<f32> { ' +
|
|
@@ -453,6 +568,314 @@ describe('GPU-driven production projection', () => {
|
|
|
453
568
|
availability.scene.dispose();
|
|
454
569
|
});
|
|
455
570
|
|
|
571
|
+
it('validates and consumes a published Surface dynamic page through production prepare', async () => {
|
|
572
|
+
const queue = new RecordingQueue();
|
|
573
|
+
const device = recordingDevice(queue);
|
|
574
|
+
const shader = (await rhi.createShaderModule(device, { code: 'synthetic' })).unwrap();
|
|
575
|
+
const viewLayout = device
|
|
576
|
+
.createBindGroupLayout({
|
|
577
|
+
entries: [{ binding: 0, visibility: 0x1, buffer: { type: 'uniform' } }],
|
|
578
|
+
})
|
|
579
|
+
.unwrap();
|
|
580
|
+
const pbrInputs = standardPbrInputs(device, shader, viewLayout);
|
|
581
|
+
const baseArtifact = pbrInputs.standardPbrArtifact;
|
|
582
|
+
expect(baseArtifact).toBeDefined();
|
|
583
|
+
if (baseArtifact === undefined) return;
|
|
584
|
+
const dynamicSchema = {
|
|
585
|
+
name: 'surfaceEvents',
|
|
586
|
+
fields: [
|
|
587
|
+
{ name: 'position', type: 'vec3<f32>' as const },
|
|
588
|
+
{ name: 'strength', type: 'f32' as const },
|
|
589
|
+
],
|
|
590
|
+
maxRecords: 4,
|
|
591
|
+
maxDomains: 2,
|
|
592
|
+
maxPageBytes: 64,
|
|
593
|
+
maxBindings: 1,
|
|
594
|
+
maxEventsPerSample: 2,
|
|
595
|
+
};
|
|
596
|
+
const layout = deriveMaterialDynamicInputLayout(dynamicSchema).unwrap();
|
|
597
|
+
const surfaceReceipt = {
|
|
598
|
+
...STANDARD_PBR_RECEIPT,
|
|
599
|
+
surface: {
|
|
600
|
+
model: 'single-layer-medium' as const,
|
|
601
|
+
module: 'forgeax::single-layer-medium',
|
|
602
|
+
inputAbi: 'SingleLayerMediumSurfaceInput',
|
|
603
|
+
outputAbi: 'SingleLayerMediumSurfaceData',
|
|
604
|
+
passes: ['nearest-layer', 'color'] as const,
|
|
605
|
+
dynamicInput: {
|
|
606
|
+
layout,
|
|
607
|
+
group: 3,
|
|
608
|
+
binding: 3,
|
|
609
|
+
readOnly: true as const,
|
|
610
|
+
accessor: `read_${layout.name}`,
|
|
611
|
+
},
|
|
612
|
+
},
|
|
613
|
+
};
|
|
614
|
+
const artifact = {
|
|
615
|
+
...baseArtifact,
|
|
616
|
+
receipt: surfaceReceipt,
|
|
617
|
+
};
|
|
618
|
+
const projection = new RenderScene();
|
|
619
|
+
const source = preparedPbrFixture(snapshot(1, 3));
|
|
620
|
+
const identity = [1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1];
|
|
621
|
+
const twoInstanceSurface = {
|
|
622
|
+
...source,
|
|
623
|
+
instances: {
|
|
624
|
+
transforms: new Float32Array([...identity, ...identity]),
|
|
625
|
+
instanceCount: 2,
|
|
626
|
+
cacheKey: 1,
|
|
627
|
+
archVersion: 1,
|
|
628
|
+
revision: 1,
|
|
629
|
+
},
|
|
630
|
+
} satisfies RenderableSnapshot;
|
|
631
|
+
const delta = projection.apply([updateSnapshot(twoInstanceSurface)]);
|
|
632
|
+
const availability = GpuScene.create(device, 1).unwrap();
|
|
633
|
+
expect(availability.status).toBe('available');
|
|
634
|
+
if (availability.status !== 'available') return;
|
|
635
|
+
availability.scene.sync(delta).unwrap();
|
|
636
|
+
const topology = new BatchTopology();
|
|
637
|
+
topology.rebuild(projection.slotsSnapshot());
|
|
638
|
+
const page = ReadonlyDynamicInputPage.create({
|
|
639
|
+
sourceId: 'surface-producer',
|
|
640
|
+
pageId: 1,
|
|
641
|
+
schema: dynamicSchema,
|
|
642
|
+
}).unwrap();
|
|
643
|
+
page.writeRecord(0, { position: [1, 2, 3], strength: 0.75 }).unwrap();
|
|
644
|
+
page.writeRecord(1, { position: [4, 5, 6], strength: 0.25 }).unwrap();
|
|
645
|
+
const firstRange = page
|
|
646
|
+
.reserveRange({
|
|
647
|
+
domain: 'surface-a',
|
|
648
|
+
recordStart: 0,
|
|
649
|
+
recordCount: 1,
|
|
650
|
+
instanceIndex: 3,
|
|
651
|
+
member: {
|
|
652
|
+
worldIdentity: 'world-a',
|
|
653
|
+
entityKey: 1,
|
|
654
|
+
drawItemIndex: 0,
|
|
655
|
+
instanceOrdinal: 0,
|
|
656
|
+
},
|
|
657
|
+
})
|
|
658
|
+
.unwrap();
|
|
659
|
+
const secondRange = page
|
|
660
|
+
.reserveRange({
|
|
661
|
+
domain: 'surface-b',
|
|
662
|
+
recordStart: 1,
|
|
663
|
+
recordCount: 1,
|
|
664
|
+
instanceIndex: 7,
|
|
665
|
+
member: {
|
|
666
|
+
worldIdentity: 'world-a',
|
|
667
|
+
entityKey: 1,
|
|
668
|
+
drawItemIndex: 0,
|
|
669
|
+
instanceOrdinal: 1,
|
|
670
|
+
},
|
|
671
|
+
})
|
|
672
|
+
.unwrap();
|
|
673
|
+
const stableRanges = Object.freeze([firstRange, secondRange]);
|
|
674
|
+
const production = new GpuDrivenProduction(device, {
|
|
675
|
+
createShaderModule: () => ok(shader),
|
|
676
|
+
});
|
|
677
|
+
const probeBlendRecordBuffer = device
|
|
678
|
+
.createBuffer({ size: 4096, usage: GPU_BUFFER_USAGE_STORAGE })
|
|
679
|
+
.unwrap();
|
|
680
|
+
const prepared = production
|
|
681
|
+
.prepare({
|
|
682
|
+
...pbrInputs,
|
|
683
|
+
standardPbrArtifact: artifact,
|
|
684
|
+
scene: {
|
|
685
|
+
scene: availability.scene,
|
|
686
|
+
plan: topology.plan(),
|
|
687
|
+
slots: projection.slotsSnapshot(),
|
|
688
|
+
worldIdentities: ['world-a'],
|
|
689
|
+
},
|
|
690
|
+
camera: makeZeroCameraFallbackSnapshot(),
|
|
691
|
+
meshBySlot: new Map([[0, mesh(device)]]),
|
|
692
|
+
viewBindGroupLayout: viewLayout,
|
|
693
|
+
meshResidencyEpoch: 1,
|
|
694
|
+
probeBlendRecordBuffer,
|
|
695
|
+
hdrp: false,
|
|
696
|
+
surfaceDynamicInput: {
|
|
697
|
+
page,
|
|
698
|
+
ranges: [secondRange, firstRange],
|
|
699
|
+
projectionRevision: 1,
|
|
700
|
+
frameTime: 1,
|
|
701
|
+
},
|
|
702
|
+
deviceGeneration: 1,
|
|
703
|
+
})
|
|
704
|
+
.unwrap();
|
|
705
|
+
expect(prepared?.surfaceSubmission).toMatchObject({
|
|
706
|
+
model: 'single-layer-medium',
|
|
707
|
+
lane: 'gpu-driven',
|
|
708
|
+
passes: [{ pass: 'nearest-layer' }, { pass: 'color' }],
|
|
709
|
+
});
|
|
710
|
+
expect(page.uploadedRevision).toBe(page.contentRevision);
|
|
711
|
+
const consumeSpy = vi.spyOn(page, 'consume');
|
|
712
|
+
expect(prepared?._consumeSurfaceDynamicInput?.(31)).toMatchObject({
|
|
713
|
+
ok: true,
|
|
714
|
+
});
|
|
715
|
+
expect(consumeSpy).toHaveBeenCalledTimes(2);
|
|
716
|
+
const frameBuffer = prepared?.standardPbrFrameResources.surfaceDynamicInput?.frame;
|
|
717
|
+
expect(frameBuffer).toBeDefined();
|
|
718
|
+
if (frameBuffer === undefined) return;
|
|
719
|
+
const frameWrites = queue.writes.filter(
|
|
720
|
+
(write) => write.buffer === frameBuffer && write.bytes.byteLength === 48,
|
|
721
|
+
);
|
|
722
|
+
const mappedFrameWrite = frameWrites.find((write) => {
|
|
723
|
+
if (write.buffer !== frameBuffer || write.bytes.byteLength !== 48) return false;
|
|
724
|
+
return (
|
|
725
|
+
new DataView(write.bytes.buffer, write.bytes.byteOffset, write.bytes.byteLength).getUint32(
|
|
726
|
+
12,
|
|
727
|
+
true,
|
|
728
|
+
) === 3
|
|
729
|
+
);
|
|
730
|
+
});
|
|
731
|
+
expect(mappedFrameWrite?.offset).toBe(0);
|
|
732
|
+
expect(
|
|
733
|
+
mappedFrameWrite === undefined
|
|
734
|
+
? undefined
|
|
735
|
+
: new DataView(
|
|
736
|
+
mappedFrameWrite.bytes.buffer,
|
|
737
|
+
mappedFrameWrite.bytes.byteOffset,
|
|
738
|
+
mappedFrameWrite.bytes.byteLength,
|
|
739
|
+
).getUint32(44, true),
|
|
740
|
+
).toBe(1);
|
|
741
|
+
const secondMappedFrameWrite = frameWrites.find((write) => {
|
|
742
|
+
if (write.buffer !== frameBuffer || write.bytes.byteLength !== 48) return false;
|
|
743
|
+
return (
|
|
744
|
+
new DataView(write.bytes.buffer, write.bytes.byteOffset, write.bytes.byteLength).getUint32(
|
|
745
|
+
12,
|
|
746
|
+
true,
|
|
747
|
+
) === 7
|
|
748
|
+
);
|
|
749
|
+
});
|
|
750
|
+
expect(secondMappedFrameWrite?.offset).toBe(48);
|
|
751
|
+
const frameWriteCount = frameWrites.length;
|
|
752
|
+
expect(production.inspect()).toMatchObject({
|
|
753
|
+
surfaceFrameRangeBuilds: 1,
|
|
754
|
+
surfaceFrameMemberScans: 4,
|
|
755
|
+
surfaceFrameRowAllocations: 2,
|
|
756
|
+
surfaceFrameTimeWrites: 1,
|
|
757
|
+
});
|
|
758
|
+
const repeated = production
|
|
759
|
+
.prepare({
|
|
760
|
+
...pbrInputs,
|
|
761
|
+
standardPbrArtifact: artifact,
|
|
762
|
+
scene: {
|
|
763
|
+
scene: availability.scene,
|
|
764
|
+
plan: topology.plan(),
|
|
765
|
+
slots: projection.slotsSnapshot(),
|
|
766
|
+
worldIdentities: ['world-a'],
|
|
767
|
+
},
|
|
768
|
+
camera: makeZeroCameraFallbackSnapshot(),
|
|
769
|
+
meshBySlot: new Map([[0, mesh(device)]]),
|
|
770
|
+
viewBindGroupLayout: viewLayout,
|
|
771
|
+
meshResidencyEpoch: 1,
|
|
772
|
+
probeBlendRecordBuffer,
|
|
773
|
+
hdrp: false,
|
|
774
|
+
surfaceDynamicInput: { page, ranges: stableRanges, projectionRevision: 1, frameTime: 1 },
|
|
775
|
+
deviceGeneration: 1,
|
|
776
|
+
})
|
|
777
|
+
.unwrap();
|
|
778
|
+
expect(repeated).toBeDefined();
|
|
779
|
+
expect(repeated?._consumeSurfaceDynamicInput?.(32)).toMatchObject({ ok: true });
|
|
780
|
+
expect(consumeSpy).toHaveBeenCalledTimes(2);
|
|
781
|
+
expect(
|
|
782
|
+
queue.writes.filter((write) => write.buffer === frameBuffer && write.bytes.byteLength === 48),
|
|
783
|
+
).toHaveLength(frameWriteCount);
|
|
784
|
+
const stableInspection = production.inspect();
|
|
785
|
+
expect(stableInspection).toMatchObject({
|
|
786
|
+
surfaceFrameRangeBuilds: 1,
|
|
787
|
+
surfaceFrameMemberScans: 4,
|
|
788
|
+
surfaceFrameRowAllocations: 2,
|
|
789
|
+
surfaceFrameTimeWrites: 1,
|
|
790
|
+
});
|
|
791
|
+
|
|
792
|
+
const writesBeforeTimeAdvance = queue.writes.length;
|
|
793
|
+
production
|
|
794
|
+
.prepare({
|
|
795
|
+
...pbrInputs,
|
|
796
|
+
standardPbrArtifact: artifact,
|
|
797
|
+
scene: {
|
|
798
|
+
scene: availability.scene,
|
|
799
|
+
plan: topology.plan(),
|
|
800
|
+
slots: projection.slotsSnapshot(),
|
|
801
|
+
worldIdentities: ['world-a'],
|
|
802
|
+
},
|
|
803
|
+
camera: makeZeroCameraFallbackSnapshot(),
|
|
804
|
+
meshBySlot: new Map([[0, mesh(device)]]),
|
|
805
|
+
viewBindGroupLayout: viewLayout,
|
|
806
|
+
meshResidencyEpoch: 1,
|
|
807
|
+
probeBlendRecordBuffer,
|
|
808
|
+
hdrp: false,
|
|
809
|
+
surfaceDynamicInput: { page, ranges: stableRanges, projectionRevision: 1, frameTime: 2 },
|
|
810
|
+
deviceGeneration: 1,
|
|
811
|
+
})
|
|
812
|
+
.unwrap();
|
|
813
|
+
const timeAdvanceWrites = queue.writes.slice(writesBeforeTimeAdvance);
|
|
814
|
+
const sharedFrameBuffer = prepared?.standardPbrFrameResources.surfaceDynamicInput?.sharedFrame;
|
|
815
|
+
expect(sharedFrameBuffer).toBeDefined();
|
|
816
|
+
expect(timeAdvanceWrites.filter((write) => write.buffer === sharedFrameBuffer)).toMatchObject([
|
|
817
|
+
{ offset: 0, bytes: { byteLength: 16 } },
|
|
818
|
+
]);
|
|
819
|
+
expect(timeAdvanceWrites.some((write) => write.buffer === frameBuffer)).toBe(false);
|
|
820
|
+
expect(production.inspect()).toMatchObject({
|
|
821
|
+
surfaceFrameRangeBuilds: stableInspection.surfaceFrameRangeBuilds,
|
|
822
|
+
surfaceFrameMemberScans: stableInspection.surfaceFrameMemberScans,
|
|
823
|
+
surfaceFrameRowAllocations: stableInspection.surfaceFrameRowAllocations,
|
|
824
|
+
surfaceFrameTimeWrites: stableInspection.surfaceFrameTimeWrites + 1,
|
|
825
|
+
});
|
|
826
|
+
|
|
827
|
+
const invalid = production.prepare({
|
|
828
|
+
...pbrInputs,
|
|
829
|
+
standardPbrArtifact: artifact,
|
|
830
|
+
scene: {
|
|
831
|
+
scene: availability.scene,
|
|
832
|
+
plan: topology.plan(),
|
|
833
|
+
slots: projection.slotsSnapshot(),
|
|
834
|
+
worldIdentities: ['world-a'],
|
|
835
|
+
},
|
|
836
|
+
camera: makeZeroCameraFallbackSnapshot(),
|
|
837
|
+
meshBySlot: new Map([[0, mesh(device)]]),
|
|
838
|
+
viewBindGroupLayout: viewLayout,
|
|
839
|
+
meshResidencyEpoch: 1,
|
|
840
|
+
probeBlendRecordBuffer,
|
|
841
|
+
hdrp: false,
|
|
842
|
+
surfaceDynamicInput: {
|
|
843
|
+
page,
|
|
844
|
+
ranges: [{ ...firstRange, byteOffset: firstRange.byteOffset + 4 }, secondRange],
|
|
845
|
+
projectionRevision: 2,
|
|
846
|
+
frameTime: 1,
|
|
847
|
+
},
|
|
848
|
+
deviceGeneration: 1,
|
|
849
|
+
});
|
|
850
|
+
expect(invalid).toMatchObject({ ok: false, error: { code: 'rhi-descriptor-invalid' } });
|
|
851
|
+
const retried = production.prepare({
|
|
852
|
+
...pbrInputs,
|
|
853
|
+
standardPbrArtifact: artifact,
|
|
854
|
+
scene: {
|
|
855
|
+
scene: availability.scene,
|
|
856
|
+
plan: topology.plan(),
|
|
857
|
+
slots: projection.slotsSnapshot(),
|
|
858
|
+
worldIdentities: ['world-a'],
|
|
859
|
+
},
|
|
860
|
+
camera: makeZeroCameraFallbackSnapshot(),
|
|
861
|
+
meshBySlot: new Map([[0, mesh(device)]]),
|
|
862
|
+
viewBindGroupLayout: viewLayout,
|
|
863
|
+
meshResidencyEpoch: 1,
|
|
864
|
+
probeBlendRecordBuffer,
|
|
865
|
+
hdrp: false,
|
|
866
|
+
surfaceDynamicInput: {
|
|
867
|
+
page,
|
|
868
|
+
ranges: stableRanges,
|
|
869
|
+
projectionRevision: 2,
|
|
870
|
+
frameTime: 2,
|
|
871
|
+
},
|
|
872
|
+
deviceGeneration: 1,
|
|
873
|
+
});
|
|
874
|
+
expect(retried.ok).toBe(true);
|
|
875
|
+
production.dispose();
|
|
876
|
+
availability.scene.dispose();
|
|
877
|
+
});
|
|
878
|
+
|
|
456
879
|
it('keeps GPU batches World-homogeneous for same-submit counter attribution', async () => {
|
|
457
880
|
const adapter = (await rhi.requestAdapter()).unwrap();
|
|
458
881
|
const device = (await adapter.requestDevice()).unwrap() as RhiNullDevice;
|
|
@@ -531,6 +954,62 @@ describe('GPU-driven production projection', () => {
|
|
|
531
954
|
cpuFallbackDrawItems: 0,
|
|
532
955
|
validatedGpuOwnedRows: 0,
|
|
533
956
|
});
|
|
957
|
+
|
|
958
|
+
// Composition-local world indices do not necessarily equal the retained
|
|
959
|
+
// stable world identity used by the GPU draw-key producer.
|
|
960
|
+
const worldKeys = [101, 202] as const;
|
|
961
|
+
const stableGpuOwned = new Set([
|
|
962
|
+
gpuDrivenDrawKey(
|
|
963
|
+
worldEntityKey(worldKeys[gpuLodRow.worldId] ?? -1, gpuLodRow.entityKey),
|
|
964
|
+
-1,
|
|
965
|
+
0,
|
|
966
|
+
),
|
|
967
|
+
]);
|
|
968
|
+
production.recordCpuValidation(
|
|
969
|
+
[{ source: gpuLodRow }],
|
|
970
|
+
stableGpuOwned,
|
|
971
|
+
'stable-world',
|
|
972
|
+
worldKeys,
|
|
973
|
+
);
|
|
974
|
+
expect(production.inspect()).toMatchObject({
|
|
975
|
+
cpuFallbackDrawItems: 0,
|
|
976
|
+
validatedGpuOwnedRows: 0,
|
|
977
|
+
});
|
|
978
|
+
production.dispose();
|
|
979
|
+
});
|
|
980
|
+
|
|
981
|
+
it('keeps unclaimed mixed draws on the CPU lane while GPU receipts stay concrete', async () => {
|
|
982
|
+
const adapter = (await rhi.requestAdapter()).unwrap();
|
|
983
|
+
const device = (await adapter.requestDevice()).unwrap() as RhiNullDevice;
|
|
984
|
+
const shader = (await rhi.createShaderModule(device, { code: 'synthetic' })).unwrap();
|
|
985
|
+
const production = new GpuDrivenProduction(device, {
|
|
986
|
+
createShaderModule: () => ok(shader),
|
|
987
|
+
});
|
|
988
|
+
const base = snapshot(8, 3);
|
|
989
|
+
const firstDraw = base.gpuDrivenDraws?.[0];
|
|
990
|
+
if (firstDraw === undefined) throw new Error('mixed ownership fixture has no first draw');
|
|
991
|
+
const mixed = {
|
|
992
|
+
...base,
|
|
993
|
+
gpuDrivenDraws: [
|
|
994
|
+
firstDraw,
|
|
995
|
+
{ ...firstDraw, drawItemIndex: 1, first: firstDraw.first + firstDraw.count },
|
|
996
|
+
],
|
|
997
|
+
};
|
|
998
|
+
const claimed = new Set([
|
|
999
|
+
gpuDrivenDrawKey(worldEntityKey(mixed.worldId, mixed.entityKey), -1, 0),
|
|
1000
|
+
]);
|
|
1001
|
+
const gpuReceipts: { readonly submeshIndex: number; readonly lane: string }[] = [];
|
|
1002
|
+
emitGpuDrivenDrawReceipts({ source: mixed }, claimed, (_entry, submeshIndex, receipt) =>
|
|
1003
|
+
gpuReceipts.push({ submeshIndex, lane: receipt.lane }),
|
|
1004
|
+
);
|
|
1005
|
+
expect(gpuReceipts).toEqual([{ submeshIndex: 0, lane: 'gpu' }]);
|
|
1006
|
+
expect(gpuReceipts.some((receipt) => receipt.submeshIndex === 1)).toBe(false);
|
|
1007
|
+
|
|
1008
|
+
production.recordCpuValidation([{ source: mixed }], claimed);
|
|
1009
|
+
expect(production.inspect()).toMatchObject({
|
|
1010
|
+
cpuFallbackDrawItems: 1,
|
|
1011
|
+
validatedGpuOwnedRows: 1,
|
|
1012
|
+
});
|
|
534
1013
|
production.dispose();
|
|
535
1014
|
});
|
|
536
1015
|
|
|
@@ -196,7 +196,7 @@ describe('GPU-driven shadow views Dawn structural evidence', () => {
|
|
|
196
196
|
visibleReadback: device
|
|
197
197
|
.createBuffer({
|
|
198
198
|
label: `shadow-view-${index}-visible-readback`,
|
|
199
|
-
size:
|
|
199
|
+
size: 1040,
|
|
200
200
|
usage: GPU_BUFFER_USAGE_MAP_READ | GPU_BUFFER_USAGE_COPY_DST,
|
|
201
201
|
})
|
|
202
202
|
.unwrap(),
|
|
@@ -219,7 +219,7 @@ describe('GPU-driven shadow views Dawn structural evidence', () => {
|
|
|
219
219
|
const encoder = device.createCommandEncoder({ label: 'gpu-driven-shadow-views-dawn' }).unwrap();
|
|
220
220
|
compiled.execute({ encoder }).unwrap();
|
|
221
221
|
for (const readback of readbacks) {
|
|
222
|
-
encoder.copyBufferToBuffer(readback.visible, 0, readback.visibleReadback, 0,
|
|
222
|
+
encoder.copyBufferToBuffer(readback.visible, 0, readback.visibleReadback, 0, 1040);
|
|
223
223
|
encoder.copyBufferToBuffer(readback.indirect, 0, readback.indirectReadback, 0, 40);
|
|
224
224
|
encoder.copyBufferToBuffer(
|
|
225
225
|
readback.overflow,
|
|
@@ -243,10 +243,11 @@ describe('GPU-driven shadow views Dawn structural evidence', () => {
|
|
|
243
243
|
const overflowMap = (await readback.overflowReadback.mapAsync(GPU_MAP_MODE_READ)).unwrap();
|
|
244
244
|
const overflow = new Uint32Array(overflowMap.getMappedRange().unwrap().slice(0));
|
|
245
245
|
overflowMap.unmap();
|
|
246
|
-
expect(Array.from(visible.slice(0,
|
|
246
|
+
expect(Array.from(visible.slice(0, 4))).toEqual([0, 0, 1, 0]);
|
|
247
247
|
// Each indirect batch binds its own projected Mesh table, so the
|
|
248
|
-
// compact visible row is batch-local
|
|
249
|
-
|
|
248
|
+
// compact visible row is batch-local. The retained RenderScene slot and
|
|
249
|
+
// generation remain global addresses for scene-index side tables.
|
|
250
|
+
expect(Array.from(visible.slice(256, 260))).toEqual([0, 1, 2, 0]);
|
|
250
251
|
expect(Array.from(indirect)).toEqual([36, 1, 0, 0, 0, 36, 1, 0, 0, 0]);
|
|
251
252
|
expect(Array.from(overflow)).toEqual([0]);
|
|
252
253
|
device.destroyBuffer(readback.visibleReadback);
|