@forgeax/engine-render 0.1.28 → 0.1.30
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 +856 -126
- package/dist/assembly/atmosphere-shader-prewarm.d.ts +6 -0
- package/dist/assembly/atmosphere-shader-prewarm.d.ts.map +1 -0
- package/dist/assembly/device-feature-admission.d.ts +4 -3
- package/dist/assembly/device-feature-admission.d.ts.map +1 -1
- package/dist/assembly/dynamic-geometry-host.d.ts +27 -0
- package/dist/assembly/dynamic-geometry-host.d.ts.map +1 -1
- package/dist/assembly/dynamic-geometry-runtime.d.ts +20 -0
- package/dist/assembly/dynamic-geometry-runtime.d.ts.map +1 -0
- package/dist/assembly/factory.d.ts +3 -1
- package/dist/assembly/factory.d.ts.map +1 -1
- package/dist/assembly/gpu-driven-owner.d.ts +10 -0
- package/dist/assembly/gpu-driven-owner.d.ts.map +1 -0
- package/dist/assembly/host-contract.d.ts +14 -0
- package/dist/assembly/host-contract.d.ts.map +1 -1
- package/dist/assembly/material/assembly.d.ts +31 -1
- package/dist/assembly/material/assembly.d.ts.map +1 -1
- package/dist/assembly/material/pipeline-helpers.d.ts +24 -0
- package/dist/assembly/material/pipeline-helpers.d.ts.map +1 -0
- package/dist/assembly/material-shader-policy.d.ts +3 -1
- package/dist/assembly/material-shader-policy.d.ts.map +1 -1
- package/dist/assembly/recovery/device-loss-fanout.d.ts.map +1 -1
- package/dist/assembly/recovery/failure-location.d.ts +12 -0
- package/dist/assembly/recovery/failure-location.d.ts.map +1 -0
- package/dist/assembly/recovery/recovery-attempt.d.ts +1 -6
- package/dist/assembly/recovery/recovery-attempt.d.ts.map +1 -1
- package/dist/assembly/recovery/renderer-recover.d.ts +7 -4
- package/dist/assembly/recovery/renderer-recover.d.ts.map +1 -1
- package/dist/assembly/renderer-facade.d.ts.map +1 -1
- package/dist/assembly/renderer-feature-inspection.d.ts +5 -0
- package/dist/assembly/renderer-feature-inspection.d.ts.map +1 -0
- package/dist/assembly/renderer-frame-transaction.d.ts +19 -0
- package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -1
- package/dist/assembly/renderer-helpers.d.ts +3 -0
- package/dist/assembly/renderer-helpers.d.ts.map +1 -1
- package/dist/assembly/renderer-inspection.d.ts +4 -0
- package/dist/assembly/renderer-inspection.d.ts.map +1 -1
- package/dist/assembly/shader-prewarm-policy.d.ts +7 -1
- package/dist/assembly/shader-prewarm-policy.d.ts.map +1 -1
- package/dist/assembly/skin-palette-owner.d.ts +8 -0
- package/dist/assembly/skin-palette-owner.d.ts.map +1 -0
- package/dist/assembly/ssr-shader-prewarm.d.ts +6 -0
- package/dist/assembly/ssr-shader-prewarm.d.ts.map +1 -0
- package/dist/assembly/webgpu-device-loss.d.ts +15 -0
- package/dist/assembly/webgpu-device-loss.d.ts.map +1 -0
- package/dist/assembly/webgpu-pbr-ready.d.ts +38 -0
- package/dist/assembly/webgpu-pbr-ready.d.ts.map +1 -0
- package/dist/assembly/webgpu-ready-mipmap.d.ts +11 -0
- package/dist/assembly/webgpu-ready-mipmap.d.ts.map +1 -0
- package/dist/assembly/webgpu-ready.d.ts +7 -3
- package/dist/assembly/webgpu-ready.d.ts.map +1 -1
- package/dist/assembly/webgpu-renderer-bootstrap.d.ts +10 -0
- package/dist/assembly/webgpu-renderer-bootstrap.d.ts.map +1 -0
- package/dist/assembly/webgpu-renderer-contract.d.ts +62 -0
- package/dist/assembly/webgpu-renderer-contract.d.ts.map +1 -0
- package/dist/assembly/webgpu-renderer-guards.d.ts +9 -0
- package/dist/assembly/webgpu-renderer-guards.d.ts.map +1 -0
- package/dist/assembly/webgpu-renderer-observation.d.ts +6 -0
- package/dist/assembly/webgpu-renderer-observation.d.ts.map +1 -0
- package/dist/assembly/webgpu-renderer-recovery-failure.d.ts +12 -0
- package/dist/assembly/webgpu-renderer-recovery-failure.d.ts.map +1 -0
- package/dist/assembly/webgpu-renderer.d.ts +7 -141
- package/dist/assembly/webgpu-renderer.d.ts.map +1 -1
- package/dist/assembly/webgpu-vertex-layouts.d.ts +28 -84
- package/dist/assembly/webgpu-vertex-layouts.d.ts.map +1 -1
- package/dist/authoring.mjs +2 -2
- package/dist/capture/scene-projection.d.ts +41 -0
- package/dist/capture/scene-projection.d.ts.map +1 -0
- package/dist/{chunk-J52NMQKR.mjs → chunk-7MQ3XBSP.mjs} +1098 -844
- package/dist/chunk-7MQ3XBSP.mjs.map +1 -0
- package/dist/{chunk-GF523LHF.mjs → chunk-BLXGONR2.mjs} +30 -12
- package/dist/chunk-BLXGONR2.mjs.map +1 -0
- package/dist/{chunk-VSL23LZE.mjs → chunk-C3DDSXYK.mjs} +1188 -463
- package/dist/chunk-C3DDSXYK.mjs.map +1 -0
- package/dist/{chunk-IQMKJLNU.mjs → chunk-FUUO4UND.mjs} +443 -30
- package/dist/chunk-FUUO4UND.mjs.map +1 -0
- package/dist/{chunk-J6KACNOH.mjs → chunk-JRBDO2KB.mjs} +617 -7
- package/dist/chunk-JRBDO2KB.mjs.map +1 -0
- package/dist/{chunk-GE3SDD72.mjs → chunk-MDQJPY3T.mjs} +20 -40
- package/dist/chunk-MDQJPY3T.mjs.map +1 -0
- package/dist/{chunk-MYJ5RPJO.mjs → chunk-NO4WZCAH.mjs} +3 -3
- package/dist/chunk-NO4WZCAH.mjs.map +1 -0
- package/dist/{chunk-RBDBZ5R7.mjs → chunk-PA5DRJNI.mjs} +2 -2
- package/dist/chunk-PA5DRJNI.mjs.map +1 -0
- package/dist/{chunk-MBU4ZVE7.mjs → chunk-PSEQ6QPH.mjs} +4655 -892
- package/dist/chunk-PSEQ6QPH.mjs.map +1 -0
- package/dist/{chunk-JAASCMXA.mjs → chunk-S5UE2T5P.mjs} +289 -41
- package/dist/chunk-S5UE2T5P.mjs.map +1 -0
- package/dist/components/camera.d.ts +62 -2
- package/dist/components/camera.d.ts.map +1 -1
- package/dist/components/directional-light.d.ts +2 -2
- package/dist/components/dynamic-resolution.d.ts +15 -0
- package/dist/components/dynamic-resolution.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 +6 -20
- package/dist/components/instances.d.ts.map +1 -1
- package/dist/components/light-helpers.d.ts.map +1 -1
- package/dist/components/reflection-probe.d.ts +1 -0
- package/dist/components/reflection-probe.d.ts.map +1 -1
- package/dist/components/scene-instance.d.ts +2 -1
- package/dist/components/scene-instance.d.ts.map +1 -1
- package/dist/components/screen-space-reflection.d.ts +14 -0
- package/dist/components/screen-space-reflection.d.ts.map +1 -0
- package/dist/components/skylight.d.ts +4 -1
- package/dist/components/skylight.d.ts.map +1 -1
- package/dist/construct-renderer.mjs +14809 -7570
- package/dist/construct-renderer.mjs.map +1 -1
- package/dist/device/device-scope.d.ts +2 -0
- package/dist/device/device-scope.d.ts.map +1 -1
- package/dist/device/gpu-residency.d.ts +3 -14
- package/dist/device/gpu-residency.d.ts.map +1 -1
- package/dist/dynamic-geometry.d.ts.map +1 -1
- package/dist/environment/background.d.ts +7 -0
- package/dist/environment/background.d.ts.map +1 -0
- package/dist/environment/ibl.d.ts +11 -0
- package/dist/environment/ibl.d.ts.map +1 -0
- package/dist/environment/storage.d.ts +14 -0
- package/dist/environment/storage.d.ts.map +1 -0
- package/dist/errors/gpu-driven.d.ts +6 -3
- package/dist/errors/gpu-driven.d.ts.map +1 -1
- package/dist/errors/render.d.ts +41 -4
- package/dist/errors/render.d.ts.map +1 -1
- package/dist/extract/camera.d.ts.map +1 -1
- package/dist/extract/contracts.d.ts +7 -0
- package/dist/extract/contracts.d.ts.map +1 -1
- package/dist/extract/gpu-driven.d.ts +50 -3
- package/dist/extract/gpu-driven.d.ts.map +1 -1
- package/dist/features/host.d.ts +23 -1
- package/dist/features/host.d.ts.map +1 -1
- package/dist/features/noise-texture.d.ts +17 -0
- package/dist/features/noise-texture.d.ts.map +1 -0
- package/dist/features/plan.d.ts +83 -2
- package/dist/features/plan.d.ts.map +1 -1
- package/dist/features/prepared-gpu-work.d.ts +37 -4
- package/dist/features/prepared-gpu-work.d.ts.map +1 -1
- package/dist/features/prepared-graphics-store.d.ts.map +1 -1
- package/dist/features/prepared-graphics.d.ts +5 -0
- package/dist/features/prepared-graphics.d.ts.map +1 -1
- package/dist/features/render-graph-compute.d.ts +5 -3
- package/dist/features/render-graph-compute.d.ts.map +1 -1
- package/dist/features/render-graph-contribution.d.ts +11 -3
- package/dist/features/render-graph-contribution.d.ts.map +1 -1
- package/dist/features/render-graph-raster.d.ts +19 -3
- package/dist/features/render-graph-raster.d.ts.map +1 -1
- package/dist/features/types.d.ts +11 -0
- package/dist/features/types.d.ts.map +1 -1
- package/dist/fullscreen-post-process-pass.d.ts +2 -0
- package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
- package/dist/gpu-driven/batch-topology.d.ts +34 -1
- package/dist/gpu-driven/batch-topology.d.ts.map +1 -1
- package/dist/gpu-driven/material-artifacts.d.ts +24 -0
- package/dist/gpu-driven/material-artifacts.d.ts.map +1 -0
- package/dist/gpu-driven/material-bindings.d.ts +7 -0
- package/dist/gpu-driven/material-bindings.d.ts.map +1 -0
- package/dist/gpu-driven/pbr-program.d.ts +10 -0
- package/dist/gpu-driven/pbr-program.d.ts.map +1 -0
- package/dist/gpu-driven/prepared-draw.d.ts +2 -0
- package/dist/gpu-driven/prepared-draw.d.ts.map +1 -1
- package/dist/gpu-driven/production-raster.d.ts +169 -27
- package/dist/gpu-driven/production-raster.d.ts.map +1 -1
- package/dist/gpu-driven/shadow-views.d.ts +126 -0
- package/dist/gpu-driven/shadow-views.d.ts.map +1 -0
- package/dist/gpu-driven/view-gpu.d.ts +18 -2
- package/dist/gpu-driven/view-gpu.d.ts.map +1 -1
- package/dist/gpu-resource.d.ts +5 -2
- package/dist/gpu-resource.d.ts.map +1 -1
- package/dist/gpu-scene-schema.d.ts +2 -8
- package/dist/gpu-scene-schema.d.ts.map +1 -1
- package/dist/gpu-scene.d.ts +14 -0
- package/dist/gpu-scene.d.ts.map +1 -1
- package/dist/gpu-texture-usage.d.ts +1 -0
- package/dist/gpu-texture-usage.d.ts.map +1 -1
- package/dist/hdrp-buffers.d.ts +9 -0
- package/dist/hdrp-buffers.d.ts.map +1 -1
- package/dist/ibl/IblPipelineCache.d.ts +2 -0
- package/dist/ibl/IblPipelineCache.d.ts.map +1 -1
- package/dist/ibl/frame-resources.d.ts +8 -0
- package/dist/ibl/frame-resources.d.ts.map +1 -0
- package/dist/ibl/skylight-bind-group.d.ts +3 -1
- package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
- package/dist/index.d.ts +87 -75
- package/dist/index.d.ts.map +1 -1
- package/dist/index.mjs +10 -8
- package/dist/index.mjs.map +1 -1
- package/dist/inspection-types.d.ts +180 -1
- package/dist/inspection-types.d.ts.map +1 -1
- package/dist/instances-derived-bounds.d.ts +11 -0
- package/dist/instances-derived-bounds.d.ts.map +1 -1
- package/dist/instances.d.ts +89 -44
- package/dist/instances.d.ts.map +1 -1
- package/dist/internal.d.ts +3 -0
- package/dist/internal.d.ts.map +1 -1
- package/dist/internal.mjs +117 -9
- package/dist/internal.mjs.map +1 -1
- package/dist/lifecycle.d.ts +2 -1
- package/dist/lifecycle.d.ts.map +1 -1
- package/dist/material-row.d.ts +15 -0
- package/dist/material-row.d.ts.map +1 -0
- package/dist/materials.d.ts +15 -0
- package/dist/materials.d.ts.map +1 -1
- package/dist/pbr-pipeline.d.ts +23 -5
- package/dist/pbr-pipeline.d.ts.map +1 -1
- package/dist/pipeline/render-extent.d.ts +51 -0
- package/dist/pipeline/render-extent.d.ts.map +1 -0
- package/dist/pipeline/standard-build-context.d.ts +7 -0
- package/dist/pipeline/standard-build-context.d.ts.map +1 -0
- package/dist/pipeline/standard-forward-lane.d.ts +3 -2
- package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
- package/dist/pipeline/standard-output/auto-exposure/capability.d.ts +12 -0
- package/dist/pipeline/standard-output/auto-exposure/capability.d.ts.map +1 -0
- package/dist/pipeline/standard-output/auto-exposure/gpu.d.ts +70 -0
- package/dist/pipeline/standard-output/auto-exposure/gpu.d.ts.map +1 -0
- package/dist/pipeline/standard-output/auto-exposure/graph.d.ts +75 -0
- package/dist/pipeline/standard-output/auto-exposure/graph.d.ts.map +1 -0
- package/dist/pipeline/standard-output/auto-exposure/inspection.d.ts +111 -0
- package/dist/pipeline/standard-output/auto-exposure/inspection.d.ts.map +1 -0
- package/dist/pipeline/standard-output/auto-exposure/oracle.d.ts +16 -0
- package/dist/pipeline/standard-output/auto-exposure/oracle.d.ts.map +1 -0
- package/dist/pipeline/standard-output/auto-exposure/preset.d.ts +14 -0
- package/dist/pipeline/standard-output/auto-exposure/preset.d.ts.map +1 -0
- package/dist/pipeline/standard-output/auto-exposure/state.d.ts +46 -0
- package/dist/pipeline/standard-output/auto-exposure/state.d.ts.map +1 -0
- package/dist/pipeline/standard-output/color-transform.d.ts +27 -0
- package/dist/pipeline/standard-output/color-transform.d.ts.map +1 -0
- package/dist/pipeline/standard-output/graph.d.ts +15 -0
- package/dist/pipeline/standard-output/graph.d.ts.map +1 -0
- package/dist/pipeline/standard-output/lut-admission.d.ts +29 -0
- package/dist/pipeline/standard-output/lut-admission.d.ts.map +1 -0
- package/dist/pipeline/standard-output/lut-gpu.d.ts +48 -0
- package/dist/pipeline/standard-output/lut-gpu.d.ts.map +1 -0
- package/dist/pipeline/standard-output/lut-state.d.ts +68 -0
- package/dist/pipeline/standard-output/lut-state.d.ts.map +1 -0
- package/dist/pipeline/standard-output/resources.d.ts +10 -0
- package/dist/pipeline/standard-output/resources.d.ts.map +1 -0
- package/dist/pipeline/standard-output/types.d.ts +39 -0
- package/dist/pipeline/standard-output/types.d.ts.map +1 -0
- package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
- package/dist/pipeline/standard-post.d.ts +2 -2
- package/dist/pipeline/standard-post.d.ts.map +1 -1
- package/dist/pipeline/standard-profile.d.ts +2 -1
- package/dist/pipeline/standard-profile.d.ts.map +1 -1
- package/dist/pipeline-builder.d.ts +5 -2
- package/dist/pipeline-builder.d.ts.map +1 -1
- package/dist/pipeline-spec-types.d.ts +4 -0
- package/dist/pipeline-spec-types.d.ts.map +1 -1
- package/dist/pipeline-spec.d.ts +1 -9
- package/dist/pipeline-spec.d.ts.map +1 -1
- package/dist/plugin.d.ts.map +1 -1
- package/dist/points-lines/standard-owner.d.ts +1 -1
- package/dist/points-lines/standard-owner.d.ts.map +1 -1
- package/dist/post-process-errors.d.ts +9 -2
- package/dist/post-process-errors.d.ts.map +1 -1
- package/dist/prepare/extended-lighting/resources.d.ts +3 -3
- package/dist/prepare/prepared-graphics-resolver.d.ts +6 -1
- package/dist/prepare/prepared-graphics-resolver.d.ts.map +1 -1
- package/dist/record/dynamic-geometry-consumption.d.ts +15 -0
- package/dist/record/dynamic-geometry-consumption.d.ts.map +1 -0
- package/dist/record/frame-lighting.d.ts +3 -3
- package/dist/record/frame-lighting.d.ts.map +1 -1
- package/dist/record/frame-snapshot.d.ts +109 -13
- package/dist/record/frame-snapshot.d.ts.map +1 -1
- package/dist/record/frame-targets.d.ts.map +1 -1
- package/dist/record/frame.d.ts +41 -5
- package/dist/record/frame.d.ts.map +1 -1
- package/dist/record/main-pass-geometry.d.ts +13 -9
- package/dist/record/main-pass-geometry.d.ts.map +1 -1
- package/dist/record/main-pass-material.d.ts +43 -3
- package/dist/record/main-pass-material.d.ts.map +1 -1
- package/dist/record/main-pass-sprite-draws.d.ts +2 -10
- package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
- package/dist/record/main-pass.d.ts +14 -2
- package/dist/record/main-pass.d.ts.map +1 -1
- package/dist/record/mesh-ssbo.d.ts +15 -6
- package/dist/record/mesh-ssbo.d.ts.map +1 -1
- package/dist/record/prepared-material-bindings.d.ts +19 -0
- package/dist/record/prepared-material-bindings.d.ts.map +1 -0
- package/dist/record/recovery-pipeline.d.ts +1 -0
- package/dist/record/recovery-pipeline.d.ts.map +1 -1
- package/dist/record/render-context.d.ts +101 -22
- package/dist/record/render-context.d.ts.map +1 -1
- package/dist/record/shadow-pass.d.ts +62 -7
- 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 +39 -8
- package/dist/record/typed-frame-graph.d.ts.map +1 -1
- package/dist/record/view-ubo.d.ts +1 -0
- package/dist/record/view-ubo.d.ts.map +1 -1
- package/dist/recovery/render-system-candidate.d.ts +10 -2
- package/dist/recovery/render-system-candidate.d.ts.map +1 -1
- package/dist/recovery/render-system-roots.d.ts +11 -0
- package/dist/recovery/render-system-roots.d.ts.map +1 -0
- package/dist/recovery/types.d.ts +76 -0
- package/dist/recovery/types.d.ts.map +1 -0
- package/dist/reflection/background.d.ts +14 -0
- package/dist/reflection/background.d.ts.map +1 -0
- package/dist/reflection/filter.d.ts.map +1 -1
- package/dist/reflection/projection.d.ts +1 -0
- package/dist/reflection/projection.d.ts.map +1 -1
- package/dist/reflection/record-owner.d.ts +4 -4
- package/dist/reflection/record-owner.d.ts.map +1 -1
- package/dist/render-contract.d.ts +211 -53
- package/dist/render-contract.d.ts.map +1 -1
- package/dist/render-graph-primitives.d.ts +1 -0
- package/dist/render-graph-primitives.d.ts.map +1 -1
- package/dist/render-pipeline.d.ts +81 -6
- package/dist/render-pipeline.d.ts.map +1 -1
- package/dist/render-system-extract-tail.d.ts +15 -6
- package/dist/render-system-extract-tail.d.ts.map +1 -1
- package/dist/render-system-extract.d.ts +128 -41
- package/dist/render-system-extract.d.ts.map +1 -1
- package/dist/render-system-projections.d.ts +22 -0
- package/dist/render-system-projections.d.ts.map +1 -0
- package/dist/render-system.d.ts +27 -77
- package/dist/render-system.d.ts.map +1 -1
- package/dist/scene/render-scene-types.d.ts +14 -7
- package/dist/scene/render-scene-types.d.ts.map +1 -1
- package/dist/scene/render-scene.d.ts +31 -11
- package/dist/scene/render-scene.d.ts.map +1 -1
- package/dist/scene/shadow-visibility.d.ts +5 -0
- package/dist/scene/shadow-visibility.d.ts.map +1 -0
- package/dist/ssao-config.d.ts +8 -6
- package/dist/ssao-config.d.ts.map +1 -1
- package/dist/ssr/admission.d.ts +70 -1
- package/dist/ssr/admission.d.ts.map +1 -1
- package/dist/ssr/compose.d.ts +13 -0
- package/dist/ssr/compose.d.ts.map +1 -0
- package/dist/ssr/errors.d.ts +35 -0
- package/dist/ssr/errors.d.ts.map +1 -1
- package/dist/ssr/graph.d.ts +60 -0
- package/dist/ssr/graph.d.ts.map +1 -0
- package/dist/ssr/history.d.ts +97 -0
- package/dist/ssr/history.d.ts.map +1 -0
- package/dist/ssr/hiz.d.ts +37 -0
- package/dist/ssr/hiz.d.ts.map +1 -0
- package/dist/ssr/inspection.d.ts +42 -0
- package/dist/ssr/inspection.d.ts.map +1 -0
- package/dist/ssr/resources.d.ts +58 -0
- package/dist/ssr/resources.d.ts.map +1 -0
- package/dist/ssr/temporal.d.ts +38 -0
- package/dist/ssr/temporal.d.ts.map +1 -0
- package/dist/systems/skin-palette-allocator.d.ts +32 -10
- package/dist/systems/skin-palette-allocator.d.ts.map +1 -1
- package/dist/systems/skin-palette-types.d.ts +15 -0
- package/dist/systems/skin-palette-types.d.ts.map +1 -1
- package/dist/systems/transparent-dispatch.d.ts +9 -0
- package/dist/systems/transparent-dispatch.d.ts.map +1 -0
- package/dist/targets/material-source.d.ts +7 -0
- package/dist/targets/material-source.d.ts.map +1 -1
- package/dist/temporal/frame-coordinator.d.ts +7 -0
- package/dist/temporal/frame-coordinator.d.ts.map +1 -1
- package/dist/temporal/gpu.d.ts +8 -0
- package/dist/temporal/gpu.d.ts.map +1 -1
- package/dist/temporal/history.d.ts.map +1 -1
- package/dist/temporal/index.mjs +6 -6
- package/dist/temporal/inspection.d.ts.map +1 -1
- package/dist/temporal/standard-scene-data.d.ts +4 -2
- package/dist/temporal/standard-scene-data.d.ts.map +1 -1
- package/dist/temporal/target-coverage-attachment.d.ts +15 -0
- package/dist/temporal/target-coverage-attachment.d.ts.map +1 -0
- package/dist/temporal/temporal-view.d.ts +6 -0
- package/dist/temporal/temporal-view.d.ts.map +1 -1
- package/dist/temporal/view.d.ts +6 -0
- package/dist/temporal/view.d.ts.map +1 -1
- package/dist/typed-render-graph-primitives.d.ts +41 -1
- package/dist/typed-render-graph-primitives.d.ts.map +1 -1
- package/dist/typed-shadow-passes.d.ts +3 -1
- package/dist/typed-shadow-passes.d.ts.map +1 -1
- package/dist/volume/component.d.ts +1 -0
- package/dist/volume/component.d.ts.map +1 -1
- package/dist/volume/temporal.d.ts +6 -0
- package/dist/volume/temporal.d.ts.map +1 -1
- package/package.json +21 -20
- package/src/__tests__/auto-exposure-gpu-evidence.ts +291 -0
- package/src/__tests__/auto-exposure-inspection.unit.test.ts +80 -0
- package/src/__tests__/auto-exposure-transaction.integration.test.ts +99 -0
- package/src/__tests__/auto-exposure.browser.test.ts +33 -0
- package/src/__tests__/auto-exposure.dawn.test.ts +33 -0
- package/src/__tests__/capture-scene-projection.unit.test.ts +24 -0
- package/src/__tests__/detached-inspection.integration.test.ts +5 -0
- package/src/__tests__/device-feature-admission.unit.test.ts +15 -24
- package/src/__tests__/device-loss-fanout.unit.test.ts +43 -0
- package/src/__tests__/device-scope-lifecycle.unit.test.ts +18 -0
- package/src/__tests__/device-scope-stale-matrix.unit.test.ts +18 -0
- package/src/__tests__/docs-gate-green.unit.test.ts +3 -3
- package/src/__tests__/dynamic-geometry-batch.unit.test.ts +157 -0
- package/src/__tests__/dynamic-geometry.unit.test.ts +36 -0
- package/src/__tests__/dynamic-resolution-plugin.integration.test.ts +81 -0
- package/src/__tests__/factory-contract.integration.test.ts +231 -9
- package/src/__tests__/fallback-row-stride-surface.unit.test.ts +19 -0
- package/src/__tests__/feature-depth-input.dawn.test.ts +121 -0
- package/src/__tests__/feature-noise.unit.test.ts +38 -0
- package/src/__tests__/fixtures/taa-resolve-pinned-baseline.wgsl +301 -0
- package/src/__tests__/frame-camera-selection.unit.test.ts +131 -0
- package/src/__tests__/frame-observation.contract.test.ts +21 -0
- package/src/__tests__/frame-plan-contract.unit.test.ts +24 -0
- package/src/__tests__/frame-targets.unit.test.ts +24 -0
- package/src/__tests__/fullscreen-feature-plan.unit.test.ts +3 -0
- package/src/__tests__/gpu-driven-baseline.characterization.test.ts +79 -0
- package/src/__tests__/gpu-driven-batch-topology-pbr.unit.test.ts +307 -7
- package/src/__tests__/gpu-driven-indirect-raster-evidence.ts +122 -142
- package/src/__tests__/gpu-driven-indirect-raster.browser.test.ts +10 -1
- package/src/__tests__/gpu-driven-lod-cache.unit.test.ts +261 -0
- package/src/__tests__/gpu-driven-mesh-world-identity.unit.test.ts +346 -0
- package/src/__tests__/gpu-driven-pbr.dawn.test.ts +1422 -0
- package/src/__tests__/gpu-driven-pbr.integration.test.ts +21 -0
- package/src/__tests__/gpu-driven-production-fixture.ts +96 -0
- package/src/__tests__/gpu-driven-production.integration.test.ts +1076 -106
- package/src/__tests__/gpu-driven-scaling.unit.test.ts +1 -3
- package/src/__tests__/gpu-driven-shadow-views.browser.test.ts +63 -0
- package/src/__tests__/gpu-driven-shadow-views.dawn.test.ts +294 -0
- package/src/__tests__/gpu-driven-shadow-views.integration.test.ts +97 -0
- package/src/__tests__/gpu-driven-shadow-views.unit.test.ts +168 -0
- package/src/__tests__/gpu-driven-skin-contract.test-d.ts +11 -0
- package/src/__tests__/gpu-driven-view-gpu-evidence.ts +72 -20
- package/src/__tests__/gpu-driven-view-graph.integration.test.ts +30 -9
- package/src/__tests__/gpu-driven-view.unit.test.ts +160 -52
- package/src/__tests__/gpu-pass-timing-browser-runner.ts +15 -0
- package/src/__tests__/gpu-pass-timing.browser.test.ts +20 -2
- package/src/__tests__/gpu-resource-scope.unit.test.ts +71 -0
- package/src/__tests__/gpu-resource-store-stride.unit.test.ts +42 -0
- package/src/__tests__/gpu-scene-render-graph-gpu.ts +19 -5
- package/src/__tests__/gpu-scene.dawn.test.ts +40 -13
- package/src/__tests__/gpu-scene.unit.test.ts +613 -33
- package/src/__tests__/instances-culling.integration.test.ts +36 -10
- package/src/__tests__/instances-derived-bounds.unit.test.ts +54 -0
- package/src/__tests__/instances-store.unit.test.ts +242 -39
- package/src/__tests__/ktx2-basis-gpu-consumer.dawn.test.ts +6 -0
- package/src/__tests__/lighting-scene-roundtrip.integration.test.ts +13 -16
- package/src/__tests__/lut-lkg-transaction.integration.test.ts +122 -0
- package/src/__tests__/material-contract-inventory.unit.test.ts +5 -6
- package/src/__tests__/material-dispatch-shader-id.unit.test.ts +51 -0
- package/src/__tests__/material-lane-selection.unit.test.ts +60 -0
- package/src/__tests__/material-numeric-upload.unit.test.ts +53 -0
- package/src/__tests__/material-texture-handles.unit.test.ts +18 -0
- package/src/__tests__/material-texture-source.unit.test.ts +87 -0
- package/src/__tests__/materials-authoring-validation.unit.test.ts +41 -0
- package/src/__tests__/materials-standard-contract.unit.test.ts +57 -3
- package/src/__tests__/mesh-buffer-usage-surface.unit.test.ts +4 -0
- package/src/__tests__/mesh-submission-lifetime.unit.test.ts +8 -0
- package/src/__tests__/morph-neutral-admission.unit.test.ts +19 -0
- package/src/__tests__/normal-fallback.dawn.test.ts +122 -0
- package/src/__tests__/particle-material-input-layout.unit.test.ts +104 -0
- package/src/__tests__/physical-clearcoat.integration.test.ts +42 -3
- package/src/__tests__/pipeline-texture-specialization.unit.test.ts +138 -0
- package/src/__tests__/point-shadow-inspection.unit.test.ts +2 -0
- package/src/__tests__/post-process-error-policy-owner.unit.test.ts +6 -5
- package/src/__tests__/prepared-gpu-driven-pbr-contract.test-d.ts +31 -0
- package/src/__tests__/prepared-gpu-driven-pbr-contract.unit.test.ts +39 -0
- package/src/__tests__/prepared-gpu-driven-pbr.integration.test.ts +251 -9
- package/src/__tests__/prepared-graphics-capability.unit.test.ts +21 -0
- package/src/__tests__/prepared-graphics-pipeline-warmup.unit.test.ts +6 -2
- package/src/__tests__/profiler-phase-catalog.test.ts +5 -0
- package/src/__tests__/public-surface.test-d.ts +3 -0
- package/src/__tests__/recovery-candidate-prepare.contract.test.ts +30 -12
- package/src/__tests__/reflection-fallback-async-publication.unit.test.ts +171 -0
- package/src/__tests__/reflection-probe-authoring.unit.test.ts +12 -10
- package/src/__tests__/reflection-probe-box.dawn.test.ts +71 -0
- package/src/__tests__/reflection-probe-filter.unit.test.ts +9 -0
- package/src/__tests__/reflection-probe-orientation.dawn.test.ts +294 -0
- package/src/__tests__/reflection-probe-record-owner.characterization.unit.test.ts +5 -14
- package/src/__tests__/reflection-probe-updates.unit.test.ts +129 -0
- package/src/__tests__/render-error-code-owner.test-d.ts +7 -0
- package/src/__tests__/render-error-detail-ssot.test-d.ts +27 -1
- package/src/__tests__/render-error-exhaustive.test-d.ts +15 -0
- package/src/__tests__/render-extent.unit.test.ts +63 -0
- package/src/__tests__/render-feature-gpu-work.integration.test.ts +285 -2
- package/src/__tests__/render-feature-plan.unit.test.ts +245 -0
- package/src/__tests__/render-feature-shadow-order.unit.test.ts +228 -0
- package/src/__tests__/render-feature-zero-work.unit.test.ts +35 -1
- package/src/__tests__/render-graph-fallback.integration.test.ts +2 -2
- package/src/__tests__/render-owner-cohesion.unit.test.ts +55 -0
- package/src/__tests__/render-scene-mixed-updates.integration.test.ts +426 -0
- package/src/__tests__/render-scene-projection.unit.test.ts +915 -23
- package/src/__tests__/render-scene-resource-updates.integration.test.ts +214 -0
- package/src/__tests__/render-scene-skin-lifecycle.integration.test.ts +173 -0
- package/src/__tests__/render-scene-temporal-retry.unit.test.ts +133 -0
- package/src/__tests__/render-target-material-source.test-d.ts +27 -3
- package/src/__tests__/renderer-factory-material-contract.unit.test.ts +233 -9
- package/src/__tests__/renderer-frame-transaction.integration.test.ts +923 -5
- package/src/__tests__/shader-manifest-fixture.ts +45 -0
- package/src/__tests__/skin-motion-regression.unit.test.ts +0 -33
- package/src/__tests__/skin-palette-persistent.integration.test.ts +28 -0
- package/src/__tests__/skin-palette-persistent.unit.test.ts +247 -0
- package/src/__tests__/skinned-shadow-caster.test.ts +125 -14
- package/src/__tests__/specular-environment-scale.dawn.test.ts +158 -0
- package/src/__tests__/ssao-config.unit.test.ts +7 -0
- package/src/__tests__/ssao-surface.dawn.test.ts +252 -0
- package/src/__tests__/ssr-admission-matrix.integration.test.ts +7 -1
- package/src/__tests__/ssr-confidence-compose.unit.test.ts +84 -0
- package/src/__tests__/ssr-coordinate-oracle.unit.test.ts +28 -0
- package/src/__tests__/ssr-cube-silhouette.dawn.test.ts +270 -0
- package/src/__tests__/ssr-format-probe-gating.integration.test.ts +82 -0
- package/src/__tests__/ssr-gpu-dispatch.browser.test.ts +99 -0
- package/src/__tests__/ssr-gpu-dispatch.dawn.test.ts +116 -0
- package/src/__tests__/ssr-gpu-dispatch.ts +951 -0
- package/src/__tests__/ssr-graph-topology.unit.test.ts +104 -0
- package/src/__tests__/ssr-history-filter.dawn.test.ts +198 -0
- package/src/__tests__/ssr-hit-color.dawn.test.ts +273 -0
- package/src/__tests__/ssr-hiz-odd-reduction.dawn.test.ts +569 -0
- package/src/__tests__/ssr-hiz-rescue.dawn.test.ts +279 -0
- package/src/__tests__/ssr-hiz.browser.test.ts +150 -0
- package/src/__tests__/ssr-hiz.dawn.test.ts +150 -0
- package/src/__tests__/ssr-hiz.unit.test.ts +56 -0
- package/src/__tests__/ssr-inspection.unit.test.ts +105 -0
- package/src/__tests__/ssr-memory-budget.unit.test.ts +45 -0
- package/src/__tests__/ssr-performance-sequence-aggregation.unit.test.ts +15 -0
- package/src/__tests__/ssr-public-surface.test-d.ts +37 -0
- package/src/__tests__/ssr-receiver-coverage.dawn.test.ts +387 -0
- package/src/__tests__/ssr-reflection-mip-reducer.dawn.test.ts +309 -0
- package/src/__tests__/ssr-reprojection-probe.ts +90 -0
- package/src/__tests__/ssr-roughness-mip.dawn.test.ts +163 -0
- package/src/__tests__/ssr-shader-prewarm.unit.test.ts +59 -0
- package/src/__tests__/ssr-spatial.integration.test.ts +141 -0
- package/src/__tests__/ssr-stable-lattice.dawn.test.ts +475 -0
- package/src/__tests__/ssr-temporal-history.unit.test.ts +202 -0
- package/src/__tests__/ssr-texel-crossing.dawn.test.ts +448 -0
- package/src/__tests__/ssr-zero-work.integration.test.ts +87 -0
- package/src/__tests__/standard-cluster-variant-resolution.unit.test.ts +84 -12
- package/src/__tests__/standard-clustered-pipeline.unit.test.ts +29 -0
- package/src/__tests__/standard-output-chain-contract.unit.test.ts +99 -0
- package/src/__tests__/standard-output-chain.integration.test.ts +73 -0
- package/src/__tests__/standard-output-gpu-evidence.ts +205 -0
- package/src/__tests__/standard-output.browser.test.ts +15 -0
- package/src/__tests__/standard-output.dawn.test.ts +15 -0
- package/src/__tests__/standard-pbr-artifact-assembly.unit.test.ts +275 -0
- package/src/__tests__/standard-pipeline.integration.test.ts +320 -3
- package/src/__tests__/standard-profile-oracle.unit.test.ts +49 -0
- package/src/__tests__/standard-surface-lighting.unit.test.ts +41 -0
- package/src/__tests__/standard-texture-specialization.dawn.test.ts +141 -0
- package/src/__tests__/surface-adjacent-regressions.integration.test.ts +6 -3
- package/src/__tests__/taa-coverage-edge.dawn.test.ts +199 -0
- package/src/__tests__/taa-history-clipping.dawn.test.ts +328 -0
- package/src/__tests__/taa-neighborhood-equivalence.dawn.test.ts +782 -0
- package/src/__tests__/taa-stability-feedback.browser.test.ts +23 -0
- package/src/__tests__/taa-stability-feedback.dawn.test.ts +68 -0
- package/src/__tests__/taa-stability-feedback.ts +342 -0
- package/src/__tests__/temporal-history-lifecycle.unit.test.ts +49 -7
- package/src/__tests__/temporal-reset-matrix.unit.test.ts +9 -0
- package/src/__tests__/temporal-transaction.integration.test.ts +28 -0
- package/src/__tests__/temporal-view.unit.test.ts +17 -0
- package/src/__tests__/texture-usage-surface.unit.test.ts +4 -2
- package/src/__tests__/transmission-prewarm.unit.test.ts +57 -0
- package/src/__tests__/typed-pipeline-topology.unit.test.ts +109 -4
- package/src/__tests__/typed-scene-pass-material-cache.integration.test.ts +126 -0
- package/src/__tests__/vertex-layouts-ssot.unit.test.ts +47 -0
- package/src/__tests__/visibility-extract.perf.test.ts +20 -8
- package/src/__tests__/visibility-instances.integration.test.ts +19 -7
- package/src/__tests__/visibility-producer-matrix.integration.test.ts +20 -9
- package/src/__tests__/volumetric-fog-stage-readback.dawn.test.ts +62 -13
- package/src/__tests__/volumetric-fog-topology.unit.test.ts +7 -7
- package/src/assembly/atmosphere-shader-prewarm.ts +39 -0
- package/src/assembly/device-feature-admission.ts +9 -4
- package/src/assembly/dynamic-geometry-host.ts +284 -163
- package/src/assembly/dynamic-geometry-runtime.ts +71 -0
- package/src/assembly/factory.ts +4 -0
- package/src/assembly/gpu-driven-owner.ts +29 -0
- package/src/assembly/host-contract.ts +19 -0
- package/src/assembly/material/assembly.ts +383 -1
- package/src/assembly/material/pipeline-helpers.ts +100 -0
- package/src/assembly/material-shader-policy.ts +110 -46
- package/src/assembly/recovery/device-loss-fanout.ts +5 -0
- package/src/assembly/recovery/failure-location.ts +62 -0
- package/src/assembly/recovery/recovery-attempt.ts +2 -29
- package/src/assembly/recovery/renderer-recover.ts +16 -17
- package/src/assembly/renderer-facade.ts +34 -1
- package/src/assembly/renderer-feature-inspection.ts +13 -0
- package/src/assembly/renderer-frame-transaction.ts +63 -0
- package/src/assembly/renderer-helpers.ts +26 -0
- package/src/assembly/renderer-inspection.ts +6 -0
- package/src/assembly/shader-prewarm-policy.ts +46 -1
- package/src/assembly/skin-palette-owner.ts +21 -0
- package/src/assembly/ssr-shader-prewarm.ts +41 -0
- package/src/assembly/webgpu-device-loss.ts +75 -0
- package/src/assembly/webgpu-pbr-ready.ts +232 -0
- package/src/assembly/webgpu-ready-mipmap.ts +26 -0
- package/src/assembly/webgpu-ready.ts +161 -131
- package/src/assembly/webgpu-renderer-bootstrap.ts +85 -0
- package/src/assembly/webgpu-renderer-contract.ts +69 -0
- package/src/assembly/webgpu-renderer-guards.ts +32 -0
- package/src/assembly/webgpu-renderer-observation.ts +43 -0
- package/src/assembly/webgpu-renderer-recovery-failure.ts +62 -0
- package/src/assembly/webgpu-renderer.ts +744 -730
- package/src/assembly/webgpu-vertex-layouts.ts +233 -87
- package/src/capture/scene-projection.ts +37 -0
- package/src/components/__tests__/camera-exposure.contract.unit.test.ts +153 -0
- package/src/components/__tests__/dynamic-resolution-schema.unit.test.ts +65 -0
- package/src/components/__tests__/light-radius.integration.test.ts +59 -0
- package/src/components/camera.ts +287 -7
- package/src/components/directional-light.ts +3 -3
- package/src/components/dynamic-resolution.ts +67 -0
- package/src/components/index.ts +2 -0
- package/src/components/instances.ts +45 -18
- package/src/components/light-helpers.ts +6 -1
- package/src/components/reflection-probe.ts +1 -0
- package/src/components/scene-instance.ts +2 -1
- package/src/components/screen-space-reflection.ts +21 -0
- package/src/components/skylight.ts +4 -1
- package/src/components/sprite-animation.ts +2 -2
- package/src/components/sprite-instances.ts +1 -1
- package/src/device/device-scope.ts +13 -7
- package/src/device/gpu-residency.ts +45 -42
- package/src/dynamic-geometry.ts +13 -8
- package/src/environment/background.ts +281 -0
- package/src/environment/ibl.ts +211 -0
- package/src/environment/storage.ts +63 -0
- package/src/errors/gpu-driven.ts +49 -8
- package/src/errors/render.ts +91 -3
- package/src/extract/camera.ts +37 -1
- package/src/extract/contracts.ts +10 -0
- package/src/extract/gpu-driven.ts +240 -10
- package/src/features/host.ts +237 -19
- package/src/features/noise-texture.ts +91 -0
- package/src/features/plan.ts +553 -24
- package/src/features/prepared-gpu-work.ts +631 -49
- package/src/features/prepared-graphics-store.ts +31 -0
- package/src/features/prepared-graphics.ts +5 -0
- package/src/features/render-graph-compute.ts +41 -8
- package/src/features/render-graph-contribution.ts +141 -3
- package/src/features/render-graph-raster.ts +143 -30
- package/src/features/types.ts +11 -0
- package/src/fullscreen-post-process-pass.ts +3 -0
- package/src/gpu-driven/batch-topology.ts +452 -108
- package/src/gpu-driven/material-artifacts.ts +179 -0
- package/src/gpu-driven/material-bindings.ts +41 -0
- package/src/gpu-driven/pbr-program.ts +31 -0
- package/src/gpu-driven/prepared-draw.ts +42 -6
- package/src/gpu-driven/production-raster.ts +2806 -716
- package/src/gpu-driven/shadow-views.ts +539 -0
- package/src/gpu-driven/view-gpu.ts +188 -41
- package/src/gpu-resource.ts +21 -2
- package/src/gpu-scene-schema.ts +61 -11
- package/src/gpu-scene.ts +197 -99
- package/src/gpu-texture-usage.ts +1 -0
- package/src/hdrp-buffers.ts +141 -36
- package/src/ibl/IblPipelineCache.ts +5 -0
- package/src/ibl/frame-resources.ts +38 -0
- package/src/ibl/skylight-bind-group.ts +32 -21
- package/src/index.ts +194 -75
- package/src/inspection-types.ts +207 -1
- package/src/instances-derived-bounds.ts +258 -34
- package/src/instances.ts +459 -150
- package/src/internal.ts +22 -0
- package/src/lifecycle.ts +2 -0
- package/src/material-row.ts +194 -0
- package/src/materials.ts +44 -8
- package/src/pbr-pipeline.ts +172 -19
- package/src/pipeline/render-extent.ts +111 -0
- package/src/pipeline/standard-build-context.ts +7 -0
- package/src/pipeline/standard-forward-lane.ts +74 -29
- package/src/pipeline/standard-output/__tests__/lut-admission.unit.test.ts +103 -0
- package/src/pipeline/standard-output/auto-exposure/__tests__/capability.unit.test.ts +40 -0
- package/src/pipeline/standard-output/auto-exposure/__tests__/gpu.contract.unit.test.ts +125 -0
- package/src/pipeline/standard-output/auto-exposure/__tests__/graph.contract.unit.test.ts +94 -0
- package/src/pipeline/standard-output/auto-exposure/__tests__/oracle.test.ts +108 -0
- package/src/pipeline/standard-output/auto-exposure/__tests__/preset.test.ts +26 -0
- package/src/pipeline/standard-output/auto-exposure/capability.ts +38 -0
- package/src/pipeline/standard-output/auto-exposure/gpu.ts +567 -0
- package/src/pipeline/standard-output/auto-exposure/graph.ts +221 -0
- package/src/pipeline/standard-output/auto-exposure/inspection.ts +231 -0
- package/src/pipeline/standard-output/auto-exposure/oracle.ts +291 -0
- package/src/pipeline/standard-output/auto-exposure/preset.ts +28 -0
- package/src/pipeline/standard-output/auto-exposure/state.ts +156 -0
- package/src/pipeline/standard-output/color-transform.ts +124 -0
- package/src/pipeline/standard-output/graph.ts +139 -0
- package/src/pipeline/standard-output/lut-admission.ts +121 -0
- package/src/pipeline/standard-output/lut-gpu.ts +399 -0
- package/src/pipeline/standard-output/lut-state.ts +176 -0
- package/src/pipeline/standard-output/resources.ts +121 -0
- package/src/pipeline/standard-output/types.ts +58 -0
- package/src/pipeline/standard-pipeline.ts +232 -70
- package/src/pipeline/standard-post.ts +190 -27
- package/src/pipeline/standard-profile.ts +2 -1
- package/src/pipeline-builder.ts +28 -9
- package/src/pipeline-spec-types.ts +4 -0
- package/src/pipeline-spec.ts +37 -29
- package/src/plugin.ts +4 -0
- package/src/points-lines/standard-owner.ts +6 -14
- package/src/post-process-errors.ts +26 -18
- package/src/prepare/__tests__/extended-lighting-capability.unit.test.ts +2 -2
- package/src/prepare/extended-lighting/resources.ts +3 -3
- package/src/prepare/prepared-graphics-resolver.ts +9 -2
- package/src/record/__tests__/main-pass-geometry.unit.test.ts +68 -0
- package/src/record/__tests__/material-bg-cache.unit.test.ts +45 -0
- package/src/record/__tests__/material-slot-plan.unit.test.ts +57 -0
- package/src/record/__tests__/mesh-ssbo.unit.test.ts +40 -1
- package/src/record/__tests__/recovery-pipeline.unit.test.ts +20 -1
- package/src/record/__tests__/sprite-material-abi.unit.test.ts +41 -6
- package/src/record/__tests__/temporal-payload.unit.test.ts +2 -0
- package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +45 -0
- package/src/record/__tests__/view-ubo-layout.unit.test.ts +5 -0
- package/src/record/dynamic-geometry-consumption.ts +59 -0
- package/src/record/frame-lighting.ts +15 -12
- package/src/record/frame-snapshot.ts +146 -34
- package/src/record/frame-targets.ts +9 -0
- package/src/record/frame.ts +838 -170
- package/src/record/main-pass-geometry.ts +209 -103
- package/src/record/main-pass-material.ts +157 -40
- package/src/record/main-pass-sprite-draws.ts +16 -107
- package/src/record/main-pass.ts +141 -12
- package/src/record/material-uniforms.ts +1 -1
- package/src/record/mesh-ssbo.ts +59 -15
- package/src/record/prepared-material-bindings.ts +238 -0
- package/src/record/recovery-pipeline.ts +69 -90
- package/src/record/render-context.ts +123 -24
- package/src/record/shadow-pass.ts +1389 -230
- package/src/record/skybox-post-pass.ts +14 -3
- package/src/record/typed-frame-graph.ts +1064 -47
- package/src/record/view-ubo.ts +12 -1
- package/src/recovery/render-system-candidate.ts +135 -68
- package/src/recovery/render-system-roots.ts +113 -0
- package/src/recovery/types.ts +77 -0
- package/src/reflection/background.ts +151 -0
- package/src/reflection/filter.ts +3 -0
- package/src/reflection/projection.ts +16 -6
- package/src/reflection/record-owner.ts +308 -140
- package/src/render-contract.ts +237 -49
- package/src/render-graph-primitives.ts +34 -5
- package/src/render-pipeline.ts +90 -2
- package/src/render-system-extract-tail.ts +431 -162
- package/src/render-system-extract.ts +478 -119
- package/src/render-system-projections.ts +241 -0
- package/src/render-system.ts +715 -828
- package/src/scene/render-scene-types.ts +13 -4
- package/src/scene/render-scene.ts +577 -355
- package/src/scene/shadow-visibility.ts +21 -0
- package/src/ssao-config.ts +25 -8
- package/src/ssr/admission.ts +380 -14
- package/src/ssr/compose.ts +144 -0
- package/src/ssr/errors.ts +48 -0
- package/src/ssr/graph.ts +797 -0
- package/src/ssr/history.ts +436 -0
- package/src/ssr/hiz.ts +124 -0
- package/src/ssr/inspection.ts +124 -0
- package/src/ssr/resources.ts +202 -0
- package/src/ssr/temporal.ts +164 -0
- package/src/systems/skin-palette-allocator.ts +495 -148
- package/src/systems/skin-palette-types.ts +17 -0
- package/src/systems/transparent-dispatch.ts +90 -0
- package/src/targets/material-source.ts +34 -0
- package/src/temporal/coverage.ts +1 -1
- package/src/temporal/frame-coordinator.ts +23 -2
- package/src/temporal/gpu.ts +79 -12
- package/src/temporal/history.ts +3 -1
- package/src/temporal/inspection.ts +2 -1
- package/src/temporal/standard-scene-data.ts +10 -2
- package/src/temporal/target-coverage-attachment.ts +72 -0
- package/src/temporal/temporal-view.ts +11 -2
- package/src/temporal/view.ts +12 -2
- package/src/transmission/__tests__/standard-transmission.dawn.test.ts +219 -139
- package/src/typed-render-graph-primitives.ts +304 -74
- package/src/typed-shadow-passes.ts +122 -12
- package/src/volume/component.ts +1 -0
- package/src/volume/passes.ts +3 -3
- package/src/volume/temporal.ts +10 -0
- package/dist/chunk-GE3SDD72.mjs.map +0 -1
- package/dist/chunk-GF523LHF.mjs.map +0 -1
- package/dist/chunk-IQMKJLNU.mjs.map +0 -1
- package/dist/chunk-J52NMQKR.mjs.map +0 -1
- package/dist/chunk-J6KACNOH.mjs.map +0 -1
- package/dist/chunk-JAASCMXA.mjs.map +0 -1
- package/dist/chunk-MBU4ZVE7.mjs.map +0 -1
- package/dist/chunk-MYJ5RPJO.mjs.map +0 -1
- package/dist/chunk-RBDBZ5R7.mjs.map +0 -1
- package/dist/chunk-VSL23LZE.mjs.map +0 -1
- package/src/__tests__/instances-world-ownership.integration.test.ts +0 -62
- package/src/scene/__tests__/changed-block-summary.candidate.test.ts +0 -36
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { beforeAll, expect, it } from 'vitest';
|
|
2
|
+
import { verifyTaaStabilityFeedback } from './taa-stability-feedback';
|
|
3
|
+
|
|
4
|
+
let publishedSource: string;
|
|
5
|
+
|
|
6
|
+
beforeAll(async () => {
|
|
7
|
+
const response = await fetch('/shaders/manifest.json');
|
|
8
|
+
expect(response.ok).toBe(true);
|
|
9
|
+
const manifest = (await response.json()) as { entries: { wgsl: string }[] };
|
|
10
|
+
const entries = manifest.entries.filter((entry) => entry.wgsl.includes('fn fs_taa_resolve('));
|
|
11
|
+
expect(entries).toHaveLength(1);
|
|
12
|
+
const entry = entries[0];
|
|
13
|
+
if (!entry) throw new Error('Missing published TAA shader');
|
|
14
|
+
publishedSource = entry.wgsl;
|
|
15
|
+
});
|
|
16
|
+
|
|
17
|
+
it.each([
|
|
18
|
+
'feedback',
|
|
19
|
+
'secondary-motion',
|
|
20
|
+
'clipping-recovery',
|
|
21
|
+
] as const)('preserves HDR feedback and recovery through browser shader publication (%s)', async (scenario) => {
|
|
22
|
+
await verifyTaaStabilityFeedback(publishedSource, scenario);
|
|
23
|
+
});
|
|
@@ -0,0 +1,68 @@
|
|
|
1
|
+
import { readFileSync } from 'node:fs';
|
|
2
|
+
import { resolve } from 'node:path';
|
|
3
|
+
import { expect, it } from 'vitest';
|
|
4
|
+
import { verifyTaaStabilityFeedback } from './taa-stability-feedback';
|
|
5
|
+
|
|
6
|
+
it('preserves temporal metadata and accumulates cyclic radiance without biased half-float feedback', async () => {
|
|
7
|
+
const source = readFileSync(resolve('packages/shader/src/taa-resolve.wgsl'), 'utf8').replace(
|
|
8
|
+
/^#define_import_path.*$/gm,
|
|
9
|
+
'',
|
|
10
|
+
);
|
|
11
|
+
await verifyTaaStabilityFeedback(source);
|
|
12
|
+
const premature = source.replace(
|
|
13
|
+
'mix(0.95, 0.99, smoothstep(64.0, TAA_HISTORY_SETTLE_FRAMES, stableAge))',
|
|
14
|
+
'0.99',
|
|
15
|
+
);
|
|
16
|
+
expect(premature).not.toBe(source);
|
|
17
|
+
await expect(verifyTaaStabilityFeedback(premature)).rejects.toThrow(
|
|
18
|
+
'TAA must follow delayed accumulation',
|
|
19
|
+
);
|
|
20
|
+
});
|
|
21
|
+
|
|
22
|
+
it('invalidates final TAA for secondary source motion without changing receiver velocity', async () => {
|
|
23
|
+
const source = readFileSync(resolve('packages/shader/src/taa-resolve.wgsl'), 'utf8').replace(
|
|
24
|
+
/^#define_import_path.*$/gm,
|
|
25
|
+
'',
|
|
26
|
+
);
|
|
27
|
+
await verifyTaaStabilityFeedback(source, 'secondary-motion');
|
|
28
|
+
const ignored = source.replace(
|
|
29
|
+
/fn sampleSecondaryReactivity\([\s\S]*?\n}/,
|
|
30
|
+
'fn sampleSecondaryReactivity(uv : vec2<f32>) -> f32 { return 0.0; }',
|
|
31
|
+
);
|
|
32
|
+
expect(ignored).not.toBe(source);
|
|
33
|
+
await expect(verifyTaaStabilityFeedback(ignored, 'secondary-motion')).rejects.toThrow(
|
|
34
|
+
'secondary motion must reject old radiance',
|
|
35
|
+
);
|
|
36
|
+
});
|
|
37
|
+
|
|
38
|
+
it('preserves phase-local coverage while rejecting persistent unmarked color changes', async () => {
|
|
39
|
+
const source = readFileSync(resolve('packages/shader/src/taa-resolve.wgsl'), 'utf8').replace(
|
|
40
|
+
/^#define_import_path.*$/gm,
|
|
41
|
+
'',
|
|
42
|
+
);
|
|
43
|
+
await verifyTaaStabilityFeedback(source, 'clipping-recovery');
|
|
44
|
+
const resetFootprint = source.replace(
|
|
45
|
+
'return TaaClipDecision(clipped, TAA_HISTORY_SETTLE_FRAMES / 255.0);',
|
|
46
|
+
'return TaaClipDecision(clipped, 0.0);',
|
|
47
|
+
);
|
|
48
|
+
expect(resetFootprint).not.toBe(source);
|
|
49
|
+
await expect(verifyTaaStabilityFeedback(resetFootprint, 'clipping-recovery')).rejects.toThrow(
|
|
50
|
+
'color clipping must not discard the accepted stationary reconstruction footprint',
|
|
51
|
+
);
|
|
52
|
+
const delayedRelease = source.replace(
|
|
53
|
+
'smoothstep(TAA_STABILITY_FRAMES, 64.0, age)',
|
|
54
|
+
'0.9 * smoothstep(64.0, TAA_HISTORY_SETTLE_FRAMES, age)',
|
|
55
|
+
);
|
|
56
|
+
expect(delayedRelease).not.toBe(source);
|
|
57
|
+
await expect(verifyTaaStabilityFeedback(delayedRelease, 'clipping-recovery')).rejects.toThrow(
|
|
58
|
+
'coverage must converge before increasing the stationary history weight',
|
|
59
|
+
);
|
|
60
|
+
const frozen = source.replace(
|
|
61
|
+
/fn resolveTaaClipping\([\s\S]*?\n}/,
|
|
62
|
+
'fn resolveTaaClipping(clipped : vec3<f32>, history : vec3<f32>, previous : f32, age : f32) -> TaaClipDecision { return TaaClipDecision(history, age / 255.0); }',
|
|
63
|
+
);
|
|
64
|
+
expect(frozen).not.toBe(source);
|
|
65
|
+
await expect(verifyTaaStabilityFeedback(frozen, 'clipping-recovery')).rejects.toThrow(
|
|
66
|
+
'persistent unmarked color change must recover within one jitter cycle',
|
|
67
|
+
);
|
|
68
|
+
});
|
|
@@ -0,0 +1,342 @@
|
|
|
1
|
+
import { createShaderModuleImmediate, rhi } from '@forgeax/engine-rhi-webgpu';
|
|
2
|
+
import { expect } from 'vitest';
|
|
3
|
+
import { DeviceScope } from '../device/device-scope';
|
|
4
|
+
import {
|
|
5
|
+
GPU_TEXTURE_USAGE_COPY_DST,
|
|
6
|
+
GPU_TEXTURE_USAGE_TEXTURE_BINDING,
|
|
7
|
+
} from '../gpu-texture-usage';
|
|
8
|
+
import { GPU_BUFFER_USAGE_COPY_DST, GPU_BUFFER_USAGE_MAP_READ } from '../gpu-usage';
|
|
9
|
+
import type { RenderFrameState } from '../record/frame-snapshot';
|
|
10
|
+
import {
|
|
11
|
+
commitTemporalGpuSubmit,
|
|
12
|
+
getTemporalBindGroupResources,
|
|
13
|
+
getTemporalGpuState,
|
|
14
|
+
getTemporalParamsBuffer,
|
|
15
|
+
retireTemporalGpuState,
|
|
16
|
+
stageTemporalGpuSubmit,
|
|
17
|
+
} from '../temporal/gpu';
|
|
18
|
+
|
|
19
|
+
export async function verifyTaaStabilityFeedback(
|
|
20
|
+
source: string,
|
|
21
|
+
scenario: 'feedback' | 'secondary-motion' | 'clipping-recovery' = 'feedback',
|
|
22
|
+
) {
|
|
23
|
+
const secondaryMotion = scenario === 'secondary-motion';
|
|
24
|
+
const clippingCycle = scenario === 'clipping-recovery';
|
|
25
|
+
const frameCount = secondaryMotion || clippingCycle ? 658 : 528;
|
|
26
|
+
const frameBytes = 768;
|
|
27
|
+
const device = (await (await rhi.requestAdapter()).unwrap().requestDevice()).unwrap();
|
|
28
|
+
const state = getTemporalGpuState(
|
|
29
|
+
{} as RenderFrameState,
|
|
30
|
+
device,
|
|
31
|
+
DeviceScope.create(23, 'taa-feedback'),
|
|
32
|
+
2,
|
|
33
|
+
1,
|
|
34
|
+
);
|
|
35
|
+
const inputs = getTemporalBindGroupResources(state);
|
|
36
|
+
if (inputs.sampler === null || inputs.temporalSampler === null)
|
|
37
|
+
throw new Error('Missing TAA samplers');
|
|
38
|
+
const params = getTemporalParamsBuffer(state);
|
|
39
|
+
const module = createShaderModuleImmediate(device, { code: source }).unwrap();
|
|
40
|
+
const empty = device.createBindGroupLayout({ entries: [] }).unwrap();
|
|
41
|
+
const emptyGroup = device.createBindGroup({ layout: empty, entries: [] }).unwrap();
|
|
42
|
+
const pipeline = device
|
|
43
|
+
.createRenderPipeline({
|
|
44
|
+
layout: device.createPipelineLayout({ bindGroupLayouts: [empty, inputs.layout] }).unwrap(),
|
|
45
|
+
vertex: { module, entryPoint: 'vs_main', buffers: [] },
|
|
46
|
+
fragment: {
|
|
47
|
+
module,
|
|
48
|
+
entryPoint: 'fs_main',
|
|
49
|
+
targets: [{ format: 'rgba16float' }, { format: 'rgba16float' }, { format: 'r8unorm' }],
|
|
50
|
+
},
|
|
51
|
+
primitive: { topology: 'triangle-list' },
|
|
52
|
+
})
|
|
53
|
+
.unwrap();
|
|
54
|
+
const current = Array.from({ length: 3 }, () => {
|
|
55
|
+
const texture = device
|
|
56
|
+
.createTexture({
|
|
57
|
+
size: { width: 2, height: 1, depthOrArrayLayers: 1 },
|
|
58
|
+
format: 'rgba16float',
|
|
59
|
+
textureBindingViewDimension: '2d',
|
|
60
|
+
usage: GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_TEXTURE_BINDING,
|
|
61
|
+
})
|
|
62
|
+
.unwrap();
|
|
63
|
+
return { texture, view: device.createTextureView(texture, {}).unwrap() };
|
|
64
|
+
});
|
|
65
|
+
const readback = device
|
|
66
|
+
.createBuffer({
|
|
67
|
+
size: frameBytes * frameCount,
|
|
68
|
+
usage: GPU_BUFFER_USAGE_MAP_READ | GPU_BUFFER_USAGE_COPY_DST,
|
|
69
|
+
})
|
|
70
|
+
.unwrap();
|
|
71
|
+
try {
|
|
72
|
+
const color = current[0];
|
|
73
|
+
const temporal = current[1];
|
|
74
|
+
const secondary = current[2];
|
|
75
|
+
if (!color || !temporal || !secondary) throw new Error('Missing current inputs');
|
|
76
|
+
device.queue
|
|
77
|
+
.writeTexture(
|
|
78
|
+
{ texture: color.texture },
|
|
79
|
+
new Uint16Array(Array(8).fill(0x3c00)),
|
|
80
|
+
{ bytesPerRow: 16, rowsPerImage: 1 },
|
|
81
|
+
{ width: 2, height: 1, depthOrArrayLayers: 1 },
|
|
82
|
+
)
|
|
83
|
+
.unwrap();
|
|
84
|
+
const ages = [];
|
|
85
|
+
const errors: number[] = [];
|
|
86
|
+
let reference = 0;
|
|
87
|
+
let previousActual = 0;
|
|
88
|
+
let stepReference = 0;
|
|
89
|
+
// Initial seed, eight stationary frames, motion, stop, reactive material,
|
|
90
|
+
// then depth disocclusion. Values below are exact half-float encodings.
|
|
91
|
+
const cycleTail: number[] = [];
|
|
92
|
+
const earlyCycle: number[] = [];
|
|
93
|
+
for (let frame = 0; frame < frameCount; frame++) {
|
|
94
|
+
const reactive = secondaryMotion && frame === 528;
|
|
95
|
+
const metadata = new Uint16Array([
|
|
96
|
+
frame === 9 ? 0x3000 : 0,
|
|
97
|
+
0,
|
|
98
|
+
frame >= 14 ? 0x4400 : 0x4000,
|
|
99
|
+
frame === 12 ? 0x3800 : 0,
|
|
100
|
+
]);
|
|
101
|
+
if (frame >= 16) {
|
|
102
|
+
// Complementary neighboring pixels keep the color bounds at [0, 1].
|
|
103
|
+
// Only temporal feedback (not clipping or input quantization) changes
|
|
104
|
+
// the analytic Karis recurrence. All input values are exact in FP16.
|
|
105
|
+
const value = clippingCycle ? (frame >= 528 ? 0 : Number(frame % 8 !== 2)) : frame % 2;
|
|
106
|
+
const neighbor = clippingCycle ? value : 1 - value;
|
|
107
|
+
if (frame === 16) state.valid = false;
|
|
108
|
+
device.queue
|
|
109
|
+
.writeTexture(
|
|
110
|
+
{ texture: color.texture },
|
|
111
|
+
new Uint16Array([
|
|
112
|
+
value * 0x3c00,
|
|
113
|
+
value * 0x3c00,
|
|
114
|
+
value * 0x3c00,
|
|
115
|
+
0x3c00,
|
|
116
|
+
neighbor * 0x3c00,
|
|
117
|
+
neighbor * 0x3c00,
|
|
118
|
+
neighbor * 0x3c00,
|
|
119
|
+
0x3c00,
|
|
120
|
+
]),
|
|
121
|
+
{ bytesPerRow: 16, rowsPerImage: 1 },
|
|
122
|
+
{ width: 2, height: 1, depthOrArrayLayers: 1 },
|
|
123
|
+
)
|
|
124
|
+
.unwrap();
|
|
125
|
+
}
|
|
126
|
+
device.queue
|
|
127
|
+
.writeTexture(
|
|
128
|
+
{ texture: temporal.texture },
|
|
129
|
+
new Uint16Array([...metadata, ...metadata]),
|
|
130
|
+
{ bytesPerRow: 16, rowsPerImage: 1 },
|
|
131
|
+
{ width: 2, height: 1, depthOrArrayLayers: 1 },
|
|
132
|
+
)
|
|
133
|
+
.unwrap();
|
|
134
|
+
device.queue
|
|
135
|
+
.writeTexture(
|
|
136
|
+
{ texture: secondary.texture },
|
|
137
|
+
new Uint16Array([reactive ? 0x3c00 : 0, 0, 0, 0, reactive ? 0x3c00 : 0, 0, 0, 0]),
|
|
138
|
+
{ bytesPerRow: 16, rowsPerImage: 1 },
|
|
139
|
+
{ width: 2, height: 1, depthOrArrayLayers: 1 },
|
|
140
|
+
)
|
|
141
|
+
.unwrap();
|
|
142
|
+
device.queue
|
|
143
|
+
.writeBuffer(
|
|
144
|
+
params,
|
|
145
|
+
0,
|
|
146
|
+
new Uint32Array([0, 0, Number(state.valid), frame, Number(secondaryMotion), 0, 0, 0]),
|
|
147
|
+
)
|
|
148
|
+
.unwrap();
|
|
149
|
+
const index = state.readIndex;
|
|
150
|
+
const group = device
|
|
151
|
+
.createBindGroup({
|
|
152
|
+
layout: inputs.layout,
|
|
153
|
+
entries: [
|
|
154
|
+
{ binding: 0, resource: { kind: 'textureView', value: color.view } },
|
|
155
|
+
{ binding: 1, resource: { kind: 'sampler', value: inputs.sampler } },
|
|
156
|
+
{ binding: 2, resource: { kind: 'textureView', value: state.color[index].view } },
|
|
157
|
+
{ binding: 3, resource: { kind: 'sampler', value: inputs.sampler } },
|
|
158
|
+
{ binding: 4, resource: { kind: 'textureView', value: state.temporal[index].view } },
|
|
159
|
+
{ binding: 5, resource: { kind: 'sampler', value: inputs.temporalSampler } },
|
|
160
|
+
{ binding: 6, resource: { kind: 'textureView', value: temporal.view } },
|
|
161
|
+
{ binding: 7, resource: { kind: 'sampler', value: inputs.temporalSampler } },
|
|
162
|
+
{ binding: 8, resource: { kind: 'buffer', value: { buffer: params } } },
|
|
163
|
+
{ binding: 9, resource: { kind: 'textureView', value: state.stability[index].view } },
|
|
164
|
+
{ binding: 10, resource: { kind: 'textureView', value: secondary.view } },
|
|
165
|
+
{ binding: 11, resource: { kind: 'textureView', value: temporal.view } },
|
|
166
|
+
],
|
|
167
|
+
})
|
|
168
|
+
.unwrap();
|
|
169
|
+
stageTemporalGpuSubmit(state);
|
|
170
|
+
const next = state.pendingIndex;
|
|
171
|
+
if (next === undefined) throw new Error('Missing staged history write');
|
|
172
|
+
const encoder = device.createCommandEncoder().unwrap();
|
|
173
|
+
const targets = [state.color[next], state.temporal[next], state.stability[next]];
|
|
174
|
+
const pass = encoder.beginRenderPass({
|
|
175
|
+
colorAttachments: targets.map(({ view }) => ({
|
|
176
|
+
view,
|
|
177
|
+
loadOp: 'clear',
|
|
178
|
+
storeOp: 'store',
|
|
179
|
+
clearValue: { r: 0, g: 0, b: 0, a: 0 },
|
|
180
|
+
})),
|
|
181
|
+
});
|
|
182
|
+
pass.setPipeline(pipeline);
|
|
183
|
+
pass.setBindGroup(0, emptyGroup);
|
|
184
|
+
pass.setBindGroup(1, group);
|
|
185
|
+
pass.draw(3, 1, 0, 0);
|
|
186
|
+
pass.end();
|
|
187
|
+
for (const [slot, surface] of targets.entries())
|
|
188
|
+
encoder.copyTextureToBuffer(
|
|
189
|
+
{ texture: surface.texture },
|
|
190
|
+
{
|
|
191
|
+
buffer: readback,
|
|
192
|
+
offset: frame * frameBytes + slot * 256,
|
|
193
|
+
bytesPerRow: 256,
|
|
194
|
+
rowsPerImage: 1,
|
|
195
|
+
},
|
|
196
|
+
{ width: 1, height: 1, depthOrArrayLayers: 1 },
|
|
197
|
+
);
|
|
198
|
+
device.queue.submit([encoder.finish().unwrap()]).unwrap();
|
|
199
|
+
expect(commitTemporalGpuSubmit(state)).toBe(true);
|
|
200
|
+
}
|
|
201
|
+
// Preserve every submitted frame and its three outputs, but synchronize
|
|
202
|
+
// with the GPU once. No input depends on CPU readback; the analytic oracle
|
|
203
|
+
// can consume the complete ordered history after the queue finishes.
|
|
204
|
+
const mapped = (await readback.mapAsync(GPU_BUFFER_USAGE_MAP_READ)).unwrap();
|
|
205
|
+
const history = mapped.getMappedRange().unwrap().slice(0);
|
|
206
|
+
mapped.unmap();
|
|
207
|
+
for (let frame = 0; frame < frameCount; frame++) {
|
|
208
|
+
const reactive = secondaryMotion && frame === 528;
|
|
209
|
+
const metadata = [
|
|
210
|
+
frame === 9 ? 0x3000 : 0,
|
|
211
|
+
0,
|
|
212
|
+
frame >= 14 ? 0x4400 : 0x4000,
|
|
213
|
+
frame === 12 ? 0x3800 : 0,
|
|
214
|
+
];
|
|
215
|
+
const bytes = history.slice(frame * frameBytes, (frame + 1) * frameBytes);
|
|
216
|
+
if (frame >= 16) {
|
|
217
|
+
const value = clippingCycle ? (frame >= 528 ? 0 : Number(frame % 8 !== 2)) : frame % 2;
|
|
218
|
+
const settled = Math.max(0, Math.min(1, (frame - 16 - 64) / 64));
|
|
219
|
+
const steadyWeight = 0.95 + 0.04 * settled * settled * (3 - 2 * settled);
|
|
220
|
+
const weight = Math.min(steadyWeight, frame / (frame + 1));
|
|
221
|
+
const a = (1 - weight) / (1 + value);
|
|
222
|
+
const b = weight / (1 + reference);
|
|
223
|
+
reference = frame === 16 ? value : (value * a + reference * b) / (a + b);
|
|
224
|
+
const previousWeight = weight / (1 + previousActual);
|
|
225
|
+
stepReference =
|
|
226
|
+
frame === 16
|
|
227
|
+
? value
|
|
228
|
+
: (value * a + previousActual * previousWeight) / (a + previousWeight);
|
|
229
|
+
}
|
|
230
|
+
const result = new Uint16Array(bytes, 0, 4);
|
|
231
|
+
if (frame >= 16 && frame < 528 && !clippingCycle) {
|
|
232
|
+
const half = result[0];
|
|
233
|
+
if (half === undefined) throw new Error('Missing TAA color readback');
|
|
234
|
+
const actual =
|
|
235
|
+
half < 1024 ? half * 2 ** -24 : (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15);
|
|
236
|
+
// Stochastic FP16 rounding feeds its error into later frames, so a
|
|
237
|
+
// per-frame formula check must start with the actual stored history.
|
|
238
|
+
// Only the two adjacent FP16 values are legal (plus FP32 arithmetic
|
|
239
|
+
// tolerance). The independent infinite-precision tail below still
|
|
240
|
+
// detects accumulated bias; it is not reset to the GPU result.
|
|
241
|
+
const spacing = 2 ** Math.max(-24, Math.floor(Math.log2(stepReference)) - 10);
|
|
242
|
+
const lower = Math.floor(stepReference / spacing) * spacing;
|
|
243
|
+
const upper = Math.ceil(stepReference / spacing) * spacing;
|
|
244
|
+
const message = `TAA must follow delayed accumulation: frame=${frame}, actual=${actual}, expected=${stepReference}`;
|
|
245
|
+
expect(actual, message).toBeGreaterThanOrEqual(lower - 0.000001);
|
|
246
|
+
expect(actual, message).toBeLessThanOrEqual(upper + 0.000001);
|
|
247
|
+
previousActual = actual;
|
|
248
|
+
}
|
|
249
|
+
if (frame < 16) {
|
|
250
|
+
expect([...result]).toEqual([0x3c00, 0x3c00, 0x3c00, 0x3c00]);
|
|
251
|
+
ages.push(new Uint8Array(bytes)[512]);
|
|
252
|
+
} else if (frame >= 464 && frame < 528 && !clippingCycle) {
|
|
253
|
+
const half = result[0];
|
|
254
|
+
if (half === undefined) throw new Error('Missing TAA color readback');
|
|
255
|
+
// The expected steady values are normal, positive half floats.
|
|
256
|
+
expect(half >>> 10).toBeGreaterThan(0);
|
|
257
|
+
expect(half >>> 10).toBeLessThan(31);
|
|
258
|
+
const actual = (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15);
|
|
259
|
+
errors.push(actual - reference);
|
|
260
|
+
expect(result[1]).toBe(half);
|
|
261
|
+
expect(result[2]).toBe(half);
|
|
262
|
+
expect(result[3]).toBe(0x3c00);
|
|
263
|
+
}
|
|
264
|
+
if (clippingCycle && frame >= 120 && frame < 128) {
|
|
265
|
+
const half = result[0];
|
|
266
|
+
if (half === undefined) throw new Error('Missing early clipping-cycle color');
|
|
267
|
+
earlyCycle.push(
|
|
268
|
+
half < 1024 ? half * 2 ** -24 : (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15),
|
|
269
|
+
);
|
|
270
|
+
if (frame === 127)
|
|
271
|
+
expect(
|
|
272
|
+
Math.abs(earlyCycle.reduce((sum, value) => sum + value, 0) / earlyCycle.length - 7 / 9),
|
|
273
|
+
'coverage must converge before increasing the stationary history weight',
|
|
274
|
+
).toBeLessThan(0.03);
|
|
275
|
+
}
|
|
276
|
+
if (clippingCycle && frame >= 464) {
|
|
277
|
+
expect(
|
|
278
|
+
new Uint8Array(bytes)[512],
|
|
279
|
+
'color clipping must not discard the accepted stationary reconstruction footprint',
|
|
280
|
+
).toBeGreaterThanOrEqual(128);
|
|
281
|
+
const half = result[0];
|
|
282
|
+
if (half === undefined) throw new Error('Missing clipping-cycle color');
|
|
283
|
+
const actual =
|
|
284
|
+
half < 1024 ? half * 2 ** -24 : (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15);
|
|
285
|
+
if (frame < 528) cycleTail.push(actual);
|
|
286
|
+
if (frame === 527)
|
|
287
|
+
expect(
|
|
288
|
+
Math.max(...cycleTail) - Math.min(...cycleTail),
|
|
289
|
+
'phase-local clipping must not repeatedly erase settled history',
|
|
290
|
+
).toBeLessThan(0.03);
|
|
291
|
+
if (frame >= 536)
|
|
292
|
+
expect(
|
|
293
|
+
actual,
|
|
294
|
+
'persistent unmarked color change must recover within one jitter cycle',
|
|
295
|
+
).toBeLessThan(0.01);
|
|
296
|
+
}
|
|
297
|
+
if (frame >= 528 && !clippingCycle) {
|
|
298
|
+
if (reactive) {
|
|
299
|
+
expect(
|
|
300
|
+
[...result],
|
|
301
|
+
'secondary motion must reject old radiance on a stationary receiver',
|
|
302
|
+
).toEqual([0, 0, 0, 0x3c00]);
|
|
303
|
+
}
|
|
304
|
+
if (frame === 529) {
|
|
305
|
+
const half = result[0];
|
|
306
|
+
if (half === undefined) throw new Error('Missing post-motion color');
|
|
307
|
+
const actual = (1 + (half & 1023) / 1024) * 2 ** ((half >>> 10) - 15);
|
|
308
|
+
// A fresh white sample after reactive black must use fast 0.95
|
|
309
|
+
// feedback, not the previously settled 0.99 history weight.
|
|
310
|
+
expect(actual).toBeCloseTo(0.025 / 0.975, 4);
|
|
311
|
+
}
|
|
312
|
+
const expectedAge = Math.min(frame - 528, 128);
|
|
313
|
+
expect(
|
|
314
|
+
new Uint8Array(bytes)[512],
|
|
315
|
+
'secondary motion restarts the complete settling cycle',
|
|
316
|
+
).toBe(expectedAge);
|
|
317
|
+
}
|
|
318
|
+
const expectedMetadata = [...metadata];
|
|
319
|
+
if (reactive) expectedMetadata[3] = 0x3c00;
|
|
320
|
+
expect([...new Uint16Array(bytes, 256, 4)]).toEqual(expectedMetadata);
|
|
321
|
+
}
|
|
322
|
+
expect(ages).toEqual([0, 1, 2, 3, 4, 5, 6, 7, 8, 0, 0, 1, 0, 1, 0, 1]);
|
|
323
|
+
if (clippingCycle) {
|
|
324
|
+
expect(cycleTail).toHaveLength(64);
|
|
325
|
+
expect(
|
|
326
|
+
Math.max(...cycleTail) - Math.min(...cycleTail),
|
|
327
|
+
'phase-local clipping must not repeatedly erase settled history',
|
|
328
|
+
).toBeLessThan(0.03);
|
|
329
|
+
expect(cycleTail.reduce((a, b) => a + b, 0) / cycleTail.length).toBeCloseTo(7 / 9, 2);
|
|
330
|
+
return;
|
|
331
|
+
}
|
|
332
|
+
expect(errors).toHaveLength(64);
|
|
333
|
+
expect(Math.abs(errors.reduce((sum, error) => sum + error, 0) / errors.length)).toBeLessThan(
|
|
334
|
+
0.0005,
|
|
335
|
+
);
|
|
336
|
+
expect(Math.max(...errors.map(Math.abs))).toBeLessThan(0.001);
|
|
337
|
+
} finally {
|
|
338
|
+
device.destroyBuffer(readback).unwrap();
|
|
339
|
+
for (const { texture } of current) device.destroyTexture(texture).unwrap();
|
|
340
|
+
retireTemporalGpuState(state);
|
|
341
|
+
}
|
|
342
|
+
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { RhiQueue } from '@forgeax/engine-rhi';
|
|
2
2
|
import { RhiNullAdapter } from '@forgeax/engine-rhi-null';
|
|
3
|
-
import { describe, expect, it } from 'vitest';
|
|
3
|
+
import { describe, expect, it, vi } from 'vitest';
|
|
4
4
|
import { DeviceScope } from '../device/device-scope';
|
|
5
5
|
import type { RenderFrameState } from '../record/frame-snapshot';
|
|
6
6
|
import {
|
|
@@ -12,15 +12,57 @@ import {
|
|
|
12
12
|
stageTemporalGpuSubmit,
|
|
13
13
|
} from '../temporal/gpu';
|
|
14
14
|
import { TemporalHistory } from '../temporal/history';
|
|
15
|
+
import { inspectTemporal } from '../temporal/inspection';
|
|
15
16
|
import { createTemporalView } from '../temporal/view';
|
|
16
17
|
|
|
17
18
|
describe('TAA history lifecycle', () => {
|
|
18
|
-
it('
|
|
19
|
+
it('keeps stability history separate from downstream temporal-v1 metadata', async () => {
|
|
20
|
+
const device = (await new RhiNullAdapter().requestDevice()).unwrap();
|
|
21
|
+
const textures = vi.spyOn(device, 'createTexture');
|
|
22
|
+
const scope = DeviceScope.create(22, 'taa-stability-test');
|
|
23
|
+
const state = getTemporalGpuState({} as RenderFrameState, device, scope, 8, 8);
|
|
24
|
+
try {
|
|
25
|
+
expect(textures.mock.calls.map(([desc]) => desc.format)).toEqual([
|
|
26
|
+
'rgba16float',
|
|
27
|
+
'rgba16float',
|
|
28
|
+
'rgba16float',
|
|
29
|
+
'rgba16float',
|
|
30
|
+
'r8unorm',
|
|
31
|
+
'r8unorm',
|
|
32
|
+
]);
|
|
33
|
+
expect(state).toHaveProperty('stability');
|
|
34
|
+
const view = createTemporalView({ antialias: 'taa', width: 8, height: 8 });
|
|
35
|
+
const inspection = inspectTemporal(view, undefined, { active: state });
|
|
36
|
+
expect(inspection.historyBytes).toBe(34 * 8 * 8);
|
|
37
|
+
expect(inspection.resources.activeBytes).toBe(34 * 8 * 8);
|
|
38
|
+
} finally {
|
|
39
|
+
retireTemporalGpuState(state);
|
|
40
|
+
}
|
|
41
|
+
});
|
|
42
|
+
it('filters subpixel color reconstruction without filtering temporal metadata', async () => {
|
|
43
|
+
const device = (await new RhiNullAdapter().requestDevice()).unwrap();
|
|
44
|
+
const samplers = vi.spyOn(device, 'createSampler');
|
|
45
|
+
const layouts = vi.spyOn(device, 'createBindGroupLayout');
|
|
46
|
+
const state = getTemporalGpuState(
|
|
47
|
+
{} as RenderFrameState,
|
|
48
|
+
device,
|
|
49
|
+
DeviceScope.create(20, 'taa-test'),
|
|
50
|
+
8,
|
|
51
|
+
8,
|
|
52
|
+
);
|
|
53
|
+
getTemporalBindGroupResources(state);
|
|
54
|
+
expect(samplers.mock.calls.map(([desc]) => desc?.magFilter)).toEqual(['linear', 'nearest']);
|
|
55
|
+
const entries = layouts.mock.calls[0]?.[0].entries;
|
|
56
|
+
expect(entries?.find((entry) => entry.binding === 1)?.sampler?.type).toBe('filtering');
|
|
57
|
+
expect(entries?.find((entry) => entry.binding === 5)?.sampler?.type).toBe('non-filtering');
|
|
58
|
+
retireTemporalGpuState(state);
|
|
59
|
+
});
|
|
60
|
+
it('accounts for color, temporal, and private stability histories only for TAA', () => {
|
|
19
61
|
const scope = DeviceScope.create(8, 'renderer');
|
|
20
62
|
const taa = new TemporalHistory(scope, { width: 320, height: 200, mode: 'taa' });
|
|
21
63
|
const off = new TemporalHistory(scope, { width: 320, height: 200, mode: 'off' });
|
|
22
|
-
expect(taa.historyCount).toBe(
|
|
23
|
-
expect(taa.historyBytes).toBe(
|
|
64
|
+
expect(taa.historyCount).toBe(6);
|
|
65
|
+
expect(taa.historyBytes).toBe(34 * 320 * 200);
|
|
24
66
|
expect(taa.childScope?.parent).toBe(scope);
|
|
25
67
|
expect(off.historyCount).toBe(0);
|
|
26
68
|
expect(off.historyBytes).toBe(0);
|
|
@@ -70,10 +112,10 @@ describe('TAA history lifecycle', () => {
|
|
|
70
112
|
frameState.activeTemporalGpuState = active;
|
|
71
113
|
frameState.temporalGpuState = undefined;
|
|
72
114
|
expect(active.childScope.parent).toBe(scope);
|
|
73
|
-
expect(active.childScope.resourceDelta()).toBe(
|
|
115
|
+
expect(active.childScope.resourceDelta()).toBe(6);
|
|
74
116
|
const bindGroupResources = getTemporalBindGroupResources(active);
|
|
75
117
|
expect(bindGroupResources.sampler).not.toBeNull();
|
|
76
|
-
expect(active.childScope.resourceDelta()).toBe(
|
|
118
|
+
expect(active.childScope.resourceDelta()).toBe(9);
|
|
77
119
|
expect(getTemporalGpuState(frameState, device, scope, 64, 64)).toBe(active);
|
|
78
120
|
|
|
79
121
|
const replacement = getTemporalGpuState(frameState, device, scope, 128, 64);
|
|
@@ -110,7 +152,7 @@ describe('TAA history lifecycle', () => {
|
|
|
110
152
|
throw new Error('unexpected temporal retirement failure');
|
|
111
153
|
});
|
|
112
154
|
expect(state.childScope.state).toBe('retiring');
|
|
113
|
-
expect(state.childScope.resourceDelta()).toBe(
|
|
155
|
+
expect(state.childScope.resourceDelta()).toBe(9);
|
|
114
156
|
expect(retiring.has(state)).toBe(true);
|
|
115
157
|
resolveFence();
|
|
116
158
|
await fence;
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { describe, expect, it } from 'vitest';
|
|
2
|
+
import { TEMPORAL_TAAU_DEPENDENCY_STATUS } from '../temporal/temporal-view';
|
|
2
3
|
import { createTemporalView, HALTON_23_8, resolveTemporalReset } from '../temporal/view';
|
|
4
|
+
import { VOLUME_TAAU_DEPENDENCY } from '../volume/temporal';
|
|
3
5
|
|
|
4
6
|
const base = () =>
|
|
5
7
|
createTemporalView({
|
|
@@ -94,4 +96,11 @@ describe('TemporalView reset matrix', () => {
|
|
|
94
96
|
expect(next.temporalFrameIndex).toBe(1);
|
|
95
97
|
expect(next.jitter).toEqual(HALTON_23_8[1]);
|
|
96
98
|
});
|
|
99
|
+
|
|
100
|
+
it('records the renderer TAAU owner as available while volume stays deferred', () => {
|
|
101
|
+
expect(TEMPORAL_TAAU_DEPENDENCY_STATUS).toBe('available');
|
|
102
|
+
expect(VOLUME_TAAU_DEPENDENCY.status).toBe('dependency-deferred');
|
|
103
|
+
expect(VOLUME_TAAU_DEPENDENCY.siblingFeature).toBe('feat-20260831-taau-dynamic-resolution');
|
|
104
|
+
expect(VOLUME_TAAU_DEPENDENCY.candidateShas).toHaveLength(2);
|
|
105
|
+
});
|
|
97
106
|
});
|
|
@@ -58,3 +58,31 @@ describe('temporal successful-submit transaction', () => {
|
|
|
58
58
|
expect(coordinator.historyStore.inspect().valid).toBe(false);
|
|
59
59
|
});
|
|
60
60
|
});
|
|
61
|
+
|
|
62
|
+
import { executeAutoExposureFrameTransaction } from '../assembly/renderer-frame-transaction';
|
|
63
|
+
import {
|
|
64
|
+
createAutoExposureState,
|
|
65
|
+
resetAutoExposureState,
|
|
66
|
+
} from '../pipeline/standard-output/auto-exposure/state';
|
|
67
|
+
|
|
68
|
+
describe('temporal and auto exposure transaction identity', () => {
|
|
69
|
+
it('keeps reset and device identity when submit aborts', () => {
|
|
70
|
+
const initial = createAutoExposureState({ fallback: 1, targetGeneration: 2, deviceEpoch: 5 });
|
|
71
|
+
if (!initial.ok) throw initial.error;
|
|
72
|
+
const reset = resetAutoExposureState(initial.value, 'device-lost', {
|
|
73
|
+
targetGeneration: 3,
|
|
74
|
+
deviceEpoch: 6,
|
|
75
|
+
});
|
|
76
|
+
const result = executeAutoExposureFrameTransaction(
|
|
77
|
+
reset,
|
|
78
|
+
{ ev: 2, generation: 3, deviceEpoch: 6, frameId: 12 },
|
|
79
|
+
{ failAt: 'submit' },
|
|
80
|
+
);
|
|
81
|
+
|
|
82
|
+
expect(result.ok).toBe(false);
|
|
83
|
+
expect(result.state).toBe(reset);
|
|
84
|
+
expect(result.state.reset).toEqual(['device-lost']);
|
|
85
|
+
expect(result.state.deviceEpoch).toBe(6);
|
|
86
|
+
expect(result.state.receipt.committed).toBe(false);
|
|
87
|
+
});
|
|
88
|
+
});
|
|
@@ -39,6 +39,23 @@ describe('TemporalView v1', () => {
|
|
|
39
39
|
expect(view.jitterCancellationUv).toEqual([jitter[0] / 1280, jitter[1] / 720]);
|
|
40
40
|
});
|
|
41
41
|
|
|
42
|
+
it('uses the fixed internal extent for TAAU jitter while preserving output dimensions', () => {
|
|
43
|
+
const view = createTemporalView({
|
|
44
|
+
antialias: 'taa',
|
|
45
|
+
width: 200,
|
|
46
|
+
height: 150,
|
|
47
|
+
internalWidth: 128,
|
|
48
|
+
internalHeight: 96,
|
|
49
|
+
frameIndex: 1,
|
|
50
|
+
});
|
|
51
|
+
const jitter = (HALTON_23_8[1] ?? [0, 0]) as readonly [number, number];
|
|
52
|
+
expect(view.input.width).toBe(200);
|
|
53
|
+
expect(view.input.height).toBe(150);
|
|
54
|
+
expect(view.input.internalWidth).toBe(128);
|
|
55
|
+
expect(view.input.internalHeight).toBe(96);
|
|
56
|
+
expect(view.jitterCancellationUv).toEqual([jitter[0] / 128, jitter[1] / 96]);
|
|
57
|
+
});
|
|
58
|
+
|
|
42
59
|
it.each([
|
|
43
60
|
['first-frame', undefined, 'first-frame'],
|
|
44
61
|
['resize', { width: 640, height: 360 }, 'resize'],
|
|
@@ -5,6 +5,7 @@ import {
|
|
|
5
5
|
GPU_TEXTURE_USAGE_COPY_SRC,
|
|
6
6
|
GPU_TEXTURE_USAGE_RENDER_ATTACHMENT,
|
|
7
7
|
GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING,
|
|
8
|
+
GPU_TEXTURE_USAGE_STORAGE_BINDING,
|
|
8
9
|
GPU_TEXTURE_USAGE_TEXTURE_BINDING,
|
|
9
10
|
} from '../gpu-texture-usage';
|
|
10
11
|
|
|
@@ -19,13 +20,14 @@ const consumerSources = [
|
|
|
19
20
|
];
|
|
20
21
|
|
|
21
22
|
describe('texture usage owner', () => {
|
|
22
|
-
it('keeps the
|
|
23
|
+
it('keeps the five texture usage bits in one owner', () => {
|
|
23
24
|
expect(GPU_TEXTURE_USAGE_COPY_SRC).toBe(0x01);
|
|
24
25
|
expect(GPU_TEXTURE_USAGE_COPY_DST).toBe(0x02);
|
|
25
26
|
expect(GPU_TEXTURE_USAGE_TEXTURE_BINDING).toBe(0x04);
|
|
27
|
+
expect(GPU_TEXTURE_USAGE_STORAGE_BINDING).toBe(0x08);
|
|
26
28
|
expect(GPU_TEXTURE_USAGE_RENDER_ATTACHMENT).toBe(0x10);
|
|
27
29
|
expect(GPU_TEXTURE_USAGE_RENDER_ATTACHMENT_AND_TEXTURE_BINDING).toBe(0x14);
|
|
28
|
-
expect(ownerSource.match(/export const GPU_TEXTURE_USAGE_/g)).toHaveLength(
|
|
30
|
+
expect(ownerSource.match(/export const GPU_TEXTURE_USAGE_/g)).toHaveLength(6);
|
|
29
31
|
});
|
|
30
32
|
|
|
31
33
|
it('routes texture usage consumers through the owner', () => {
|