@forgeax/engine-render 0.1.6 → 0.1.19
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 +279 -2
- package/dist/.tsbuildinfo +1 -1
- package/dist/assembly/backend-contract.d.ts +12 -0
- package/dist/assembly/backend-contract.d.ts.map +1 -1
- package/dist/assembly/factory.d.ts +19 -2
- package/dist/assembly/factory.d.ts.map +1 -1
- package/dist/assembly/host-contract.d.ts +4 -0
- package/dist/assembly/host-contract.d.ts.map +1 -1
- package/dist/assembly/material/assembly.d.ts.map +1 -1
- package/dist/assembly/renderer-frame-transaction.d.ts +39 -0
- package/dist/assembly/renderer-frame-transaction.d.ts.map +1 -0
- package/dist/assembly/renderer-inspection.d.ts +22 -0
- package/dist/assembly/renderer-inspection.d.ts.map +1 -0
- package/dist/assembly/renderer-lifecycle.d.ts +4 -0
- package/dist/assembly/renderer-lifecycle.d.ts.map +1 -0
- package/dist/authoring.d.ts +1 -0
- package/dist/authoring.d.ts.map +1 -1
- package/dist/authoring.mjs +4 -2
- package/dist/authoring.mjs.map +1 -1
- package/dist/chunk-FJ6P52EE.mjs +46 -0
- package/dist/chunk-FJ6P52EE.mjs.map +1 -0
- package/dist/chunk-IPXCABEP.mjs +73 -0
- package/dist/chunk-IPXCABEP.mjs.map +1 -0
- package/dist/chunk-JDWARUOI.mjs +44 -0
- package/dist/chunk-JDWARUOI.mjs.map +1 -0
- package/dist/chunk-LOSO4CTV.mjs +901 -0
- package/dist/chunk-LOSO4CTV.mjs.map +1 -0
- package/dist/chunk-PCHBPYML.mjs +385 -0
- package/dist/chunk-PCHBPYML.mjs.map +1 -0
- package/dist/chunk-RJRUS55L.mjs +9323 -0
- package/dist/chunk-RJRUS55L.mjs.map +1 -0
- package/dist/{chunk-QC4VW3XJ.mjs → chunk-RXZ3RGOU.mjs} +4 -30
- package/dist/chunk-RXZ3RGOU.mjs.map +1 -0
- package/dist/{chunk-CQXZC5XI.mjs → chunk-VFPLTKCU.mjs} +79 -69
- package/dist/chunk-VFPLTKCU.mjs.map +1 -0
- package/dist/{chunk-SCRSAK5B.mjs → chunk-YTQ5C7YQ.mjs} +231 -127
- package/dist/chunk-YTQ5C7YQ.mjs.map +1 -0
- package/dist/components/atmosphere.d.ts +9 -0
- package/dist/components/atmosphere.d.ts.map +1 -0
- package/dist/components/camera.d.ts +2 -1
- package/dist/components/camera.d.ts.map +1 -1
- package/dist/components/fog.d.ts +8 -0
- package/dist/components/fog.d.ts.map +1 -0
- package/dist/components/index.d.ts +5 -0
- package/dist/components/index.d.ts.map +1 -1
- package/dist/components/lines.d.ts +5 -0
- package/dist/components/lines.d.ts.map +1 -0
- package/dist/components/motion-blur.d.ts +7 -0
- package/dist/components/motion-blur.d.ts.map +1 -0
- package/dist/components/points.d.ts +15 -0
- package/dist/components/points.d.ts.map +1 -0
- package/dist/construct-renderer.d.ts +2 -2
- package/dist/construct-renderer.d.ts.map +1 -1
- package/dist/construct-renderer.mjs +11419 -16442
- package/dist/construct-renderer.mjs.map +1 -1
- package/dist/device/device-scope.d.ts +4 -0
- package/dist/device/device-scope.d.ts.map +1 -1
- package/dist/environment/frame.d.ts +60 -0
- package/dist/environment/frame.d.ts.map +1 -0
- package/dist/environment/generation.d.ts +21 -0
- package/dist/environment/generation.d.ts.map +1 -0
- package/dist/environment/graph.d.ts +4 -0
- package/dist/environment/graph.d.ts.map +1 -0
- package/dist/environment/inspection.d.ts +48 -0
- package/dist/environment/inspection.d.ts.map +1 -0
- package/dist/environment/lifecycle.d.ts +39 -0
- package/dist/environment/lifecycle.d.ts.map +1 -0
- package/dist/environment/signature.d.ts +25 -0
- package/dist/environment/signature.d.ts.map +1 -0
- package/dist/errors/render.d.ts +217 -1
- package/dist/errors/render.d.ts.map +1 -1
- package/dist/extract/camera.d.ts +5 -0
- package/dist/extract/camera.d.ts.map +1 -0
- package/dist/extract/environment.d.ts +74 -0
- package/dist/extract/environment.d.ts.map +1 -0
- package/dist/extract/visibility.d.ts +1 -1
- package/dist/extract/visibility.d.ts.map +1 -1
- package/dist/features/host.d.ts +9 -2
- package/dist/features/host.d.ts.map +1 -1
- package/dist/features/motion-blur/motion-blur-feature.d.ts +16 -0
- package/dist/features/motion-blur/motion-blur-feature.d.ts.map +1 -0
- package/dist/features/motion-blur/motion-blur-params.d.ts +25 -0
- package/dist/features/motion-blur/motion-blur-params.d.ts.map +1 -0
- package/dist/features/plan.d.ts +17 -2
- package/dist/features/plan.d.ts.map +1 -1
- package/dist/features/prepared-gpu-work.d.ts +3 -1
- package/dist/features/prepared-gpu-work.d.ts.map +1 -1
- package/dist/features/prepared-graphics.d.ts +2 -1
- package/dist/features/prepared-graphics.d.ts.map +1 -1
- package/dist/features/render-graph-raster.d.ts +7 -2
- package/dist/features/render-graph-raster.d.ts.map +1 -1
- package/dist/features/targets.d.ts +3 -0
- package/dist/features/targets.d.ts.map +1 -1
- package/dist/features/types.d.ts +12 -0
- package/dist/features/types.d.ts.map +1 -1
- package/dist/fullscreen-post-process-pass.d.ts +7 -1
- package/dist/fullscreen-post-process-pass.d.ts.map +1 -1
- package/dist/gpu-driven/production-raster.d.ts.map +1 -1
- package/dist/gpu-scene.d.ts +2 -0
- package/dist/gpu-scene.d.ts.map +1 -1
- package/dist/ibl/skylight-bind-group.d.ts +5 -6
- package/dist/ibl/skylight-bind-group.d.ts.map +1 -1
- package/dist/index.d.ts +21 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.mjs +8 -4
- package/dist/index.mjs.map +1 -1
- package/dist/inspection-types.d.ts +46 -1
- package/dist/inspection-types.d.ts.map +1 -1
- package/dist/internal.d.ts +2 -0
- package/dist/internal.d.ts.map +1 -1
- package/dist/internal.mjs +2 -0
- package/dist/materials.d.ts +22 -0
- package/dist/materials.d.ts.map +1 -1
- package/dist/pbr-pipeline.d.ts +12 -6
- package/dist/pbr-pipeline.d.ts.map +1 -1
- package/dist/pipeline/standard-forward-lane.d.ts.map +1 -1
- package/dist/pipeline/standard-pipeline.d.ts +3 -0
- package/dist/pipeline/standard-pipeline.d.ts.map +1 -1
- package/dist/pipeline/standard-post.d.ts +48 -0
- package/dist/pipeline/standard-post.d.ts.map +1 -0
- package/dist/pipeline/standard-profile.d.ts +3 -6
- package/dist/pipeline/standard-profile.d.ts.map +1 -1
- package/dist/pipeline-builder.d.ts +18 -0
- package/dist/pipeline-builder.d.ts.map +1 -1
- package/dist/pipeline-spec.d.ts.map +1 -1
- package/dist/plugin.d.ts.map +1 -1
- package/dist/points-lines/admission.d.ts +36 -0
- package/dist/points-lines/admission.d.ts.map +1 -0
- package/dist/points-lines/bounds.d.ts +8 -0
- package/dist/points-lines/bounds.d.ts.map +1 -0
- package/dist/points-lines/expansion-cache.d.ts +28 -0
- package/dist/points-lines/expansion-cache.d.ts.map +1 -0
- package/dist/points-lines/inspection.d.ts +53 -0
- package/dist/points-lines/inspection.d.ts.map +1 -0
- package/dist/points-lines/prepare.d.ts +67 -0
- package/dist/points-lines/prepare.d.ts.map +1 -0
- package/dist/points-lines/record.d.ts +60 -0
- package/dist/points-lines/record.d.ts.map +1 -0
- package/dist/points-lines/snapshot.d.ts +49 -0
- package/dist/points-lines/snapshot.d.ts.map +1 -0
- package/dist/record/frame-lighting.d.ts.map +1 -1
- package/dist/record/frame-snapshot.d.ts +100 -5
- 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 +4 -2
- package/dist/record/frame.d.ts.map +1 -1
- package/dist/record/main-pass-geometry.d.ts +18 -0
- package/dist/record/main-pass-geometry.d.ts.map +1 -1
- package/dist/record/main-pass-material.d.ts +8 -5
- package/dist/record/main-pass-material.d.ts.map +1 -1
- package/dist/record/main-pass-sprite-draws.d.ts +8 -1
- package/dist/record/main-pass-sprite-draws.d.ts.map +1 -1
- package/dist/record/main-pass.d.ts +2 -0
- package/dist/record/main-pass.d.ts.map +1 -1
- package/dist/record/mesh-ssbo.d.ts.map +1 -1
- package/dist/record/render-context.d.ts +93 -18
- package/dist/record/render-context.d.ts.map +1 -1
- package/dist/record/shadow-pass.d.ts.map +1 -1
- package/dist/record/skybox-post-pass.d.ts +1 -11
- package/dist/record/skybox-post-pass.d.ts.map +1 -1
- package/dist/record/typed-frame-graph.d.ts +26 -2
- package/dist/record/typed-frame-graph.d.ts.map +1 -1
- package/dist/record/view-ubo.d.ts +10 -1
- package/dist/record/view-ubo.d.ts.map +1 -1
- package/dist/render-contract.d.ts +102 -10
- 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 +50 -6
- package/dist/render-pipeline.d.ts.map +1 -1
- package/dist/render-system-extract.d.ts +32 -5
- package/dist/render-system-extract.d.ts.map +1 -1
- package/dist/render-system.d.ts +27 -5
- package/dist/render-system.d.ts.map +1 -1
- package/dist/scene/render-scene-types.d.ts +3 -0
- package/dist/scene/render-scene-types.d.ts.map +1 -1
- package/dist/scene/render-scene.d.ts +43 -2
- package/dist/scene/render-scene.d.ts.map +1 -1
- package/dist/temporal/coverage.d.ts +42 -0
- package/dist/temporal/coverage.d.ts.map +1 -0
- package/dist/temporal/frame-coordinator.d.ts +99 -0
- package/dist/temporal/frame-coordinator.d.ts.map +1 -0
- package/dist/temporal/gpu.d.ts +39 -0
- package/dist/temporal/gpu.d.ts.map +1 -0
- package/dist/temporal/history.d.ts +37 -0
- package/dist/temporal/history.d.ts.map +1 -0
- package/dist/temporal/index.d.ts +7 -0
- package/dist/temporal/index.d.ts.map +1 -0
- package/dist/temporal/index.mjs +8 -0
- package/dist/temporal/index.mjs.map +1 -0
- package/dist/temporal/inspection.d.ts +36 -0
- package/dist/temporal/inspection.d.ts.map +1 -0
- package/dist/temporal/scene-data-catalog.d.ts +48 -0
- package/dist/temporal/scene-data-catalog.d.ts.map +1 -0
- package/dist/temporal/scene-data.d.ts +43 -0
- package/dist/temporal/scene-data.d.ts.map +1 -0
- package/dist/temporal/standard-scene-data.d.ts +61 -0
- package/dist/temporal/standard-scene-data.d.ts.map +1 -0
- package/dist/temporal/taa-history-resources.d.ts +22 -0
- package/dist/temporal/taa-history-resources.d.ts.map +1 -0
- package/dist/temporal/taa-history-store.d.ts +27 -0
- package/dist/temporal/taa-history-store.d.ts.map +1 -0
- package/dist/temporal/taa-resolve.d.ts +15 -0
- package/dist/temporal/taa-resolve.d.ts.map +1 -0
- package/dist/temporal/temporal-view.d.ts +40 -0
- package/dist/temporal/temporal-view.d.ts.map +1 -0
- package/dist/temporal/transaction.d.ts +9 -0
- package/dist/temporal/transaction.d.ts.map +1 -0
- package/dist/temporal/view.d.ts +56 -0
- package/dist/temporal/view.d.ts.map +1 -0
- package/dist/transmission/backdrop.d.ts +147 -0
- package/dist/transmission/backdrop.d.ts.map +1 -0
- package/dist/transmission/inspection.d.ts +57 -0
- package/dist/transmission/inspection.d.ts.map +1 -0
- package/dist/transmission/oracle.d.ts +42 -0
- package/dist/transmission/oracle.d.ts.map +1 -0
- package/dist/transmission/projection.d.ts +37 -0
- package/dist/transmission/projection.d.ts.map +1 -0
- package/dist/typed-render-graph-primitives.d.ts +25 -2
- package/dist/typed-render-graph-primitives.d.ts.map +1 -1
- package/package.json +24 -19
- package/src/__tests__/ai-user-cold-start.integration.test.ts +59 -0
- package/src/__tests__/ai-user-public-surface.test-d.ts +45 -0
- package/src/__tests__/authoring-path.unit.test.ts +9 -0
- package/src/__tests__/bloom-exact-zero.unit.test.ts +202 -0
- package/src/__tests__/bloom-lifecycle.integration.test.ts +125 -0
- package/src/__tests__/construct-renderer-identity.unit.test.ts +4 -3
- package/src/__tests__/detached-inspection.integration.test.ts +177 -0
- package/src/__tests__/environment-fog-lanes.integration.test.ts +219 -0
- package/src/__tests__/environment-generation.integration.test.ts +141 -0
- package/src/__tests__/environment-selection.unit.test.ts +245 -0
- package/src/__tests__/factory-contract.integration.test.ts +1380 -9
- package/src/__tests__/frame-plan-contract.unit.test.ts +90 -0
- package/src/__tests__/fullscreen-feature-plan.unit.test.ts +7 -0
- package/src/__tests__/gpu-driven-indirect-raster-evidence.ts +12 -2
- package/src/__tests__/gpu-driven-production.integration.test.ts +74 -22
- package/src/__tests__/gpu-driven-view-graph.integration.test.ts +37 -0
- package/src/__tests__/gpu-scene.unit.test.ts +10 -0
- package/src/__tests__/injection-kind-owner.test-d.ts +2 -1
- package/src/__tests__/material-contract-inventory.unit.test.ts +62 -0
- package/src/__tests__/material-cooked-projection.unit.test.ts +18 -124
- package/src/__tests__/material-static-dynamic-route.unit.test.ts +28 -28
- package/src/__tests__/materials-transmission-validation.unit.test.ts +36 -0
- package/src/__tests__/morph-feature-plan.unit.test.ts +7 -0
- package/src/__tests__/motion-blur.pixel.integration.test.ts +121 -0
- package/src/__tests__/public-surface.test-d.ts +15 -1
- package/src/__tests__/render-error-code-owner.test-d.ts +15 -0
- package/src/__tests__/render-error-detail-ssot.test-d.ts +11 -2
- package/src/__tests__/render-error-exhaustive.test-d.ts +22 -0
- package/src/__tests__/render-feature-errors.unit.test.ts +33 -3
- package/src/__tests__/render-feature-gpu-work.integration.test.ts +44 -0
- package/src/__tests__/render-feature-plan.test-d.ts +22 -89
- package/src/__tests__/render-scene-projection.unit.test.ts +28 -0
- package/src/__tests__/render-temporal-environment-consumer.browser.test.ts +26 -0
- package/src/__tests__/render-temporal-environment-consumer.dawn.test.ts +21 -0
- package/src/__tests__/renderer-factory-material-contract.unit.test.ts +433 -1
- package/src/__tests__/renderer-frame-transaction.integration.test.ts +405 -0
- package/src/__tests__/renderer-lifecycle.integration.test.ts +22 -0
- package/src/__tests__/scene-data-catalog.unit.test.ts +59 -0
- package/src/__tests__/scene-data-consumer.integration.test.ts +67 -0
- package/src/__tests__/scene-data-contract.test-d.ts +35 -0
- package/src/__tests__/scene-data-inspection.unit.test.ts +41 -0
- package/src/__tests__/scene-data-public-surface.test-d.ts +34 -0
- package/src/__tests__/shader-manifest-fixture.ts +111 -0
- package/src/__tests__/skinned-shadow-caster.test.ts +102 -0
- package/src/__tests__/standard-clustered-pipeline.unit.test.ts +24 -3
- package/src/__tests__/standard-pipeline.dawn.test.ts +15 -0
- package/src/__tests__/standard-pipeline.integration.test.ts +543 -1
- package/src/__tests__/standard-profile-oracle.unit.test.ts +10 -2
- package/src/__tests__/standard-temporal-producer.integration.test.ts +35 -0
- package/src/__tests__/surface-configuration.unit.test.ts +211 -12
- package/src/__tests__/taa-transaction.integration.test.ts +30 -0
- package/src/__tests__/temporal-admission.integration.test.ts +40 -0
- package/src/__tests__/temporal-coverage.unit.test.ts +35 -0
- package/src/__tests__/temporal-demand.unit.test.ts +44 -0
- package/src/__tests__/temporal-frame-coordinator.unit.test.ts +64 -0
- package/src/__tests__/temporal-graph-topology.unit.test.ts +51 -0
- package/src/__tests__/temporal-history-lifecycle.unit.test.ts +170 -0
- package/src/__tests__/temporal-performance.integration.test.ts +615 -0
- package/src/__tests__/temporal-reset-matrix.unit.test.ts +97 -0
- package/src/__tests__/temporal-transaction.integration.test.ts +60 -0
- package/src/__tests__/temporal-view.unit.test.ts +152 -0
- package/src/__tests__/transmission-prewarm.unit.test.ts +93 -0
- package/src/__tests__/typed-pipeline-topology.unit.test.ts +230 -1
- package/src/__tests__/urp-pipeline-targets.unit.test.ts +25 -1
- package/src/__tests__/urp-pipeline.unit.test.ts +4 -3
- package/src/__tests__/visibility-extract.integration.test.ts +27 -1
- package/src/__tests__/visibility-producer-matrix.integration.test.ts +10 -0
- package/src/assembly/backend-contract.ts +47 -1
- package/src/assembly/factory.ts +1295 -507
- package/src/assembly/host-contract.ts +4 -0
- package/src/assembly/material/assembly.ts +2 -5
- package/src/assembly/renderer-frame-transaction.ts +75 -0
- package/src/assembly/renderer-inspection.ts +112 -0
- package/src/assembly/renderer-lifecycle.ts +6 -0
- package/src/authoring.ts +1 -0
- package/src/components/__tests__/motion-blur.unit.test.ts +14 -0
- package/src/components/__tests__/points-lines-admission.unit.test.ts +219 -0
- package/src/components/__tests__/points-lines-schema.unit.test.ts +56 -0
- package/src/components/__tests__/schema-contract.unit.test.ts +6 -1
- package/src/components/atmosphere.ts +10 -0
- package/src/components/camera.ts +2 -1
- package/src/components/fog.ts +9 -0
- package/src/components/index.ts +10 -0
- package/src/components/lines.ts +18 -0
- package/src/components/motion-blur.ts +8 -0
- package/src/components/points.ts +40 -0
- package/src/construct-renderer.ts +40 -3
- package/src/device/device-scope.ts +15 -1
- package/src/environment/frame.ts +185 -0
- package/src/environment/generation.ts +23 -0
- package/src/environment/graph.ts +9 -0
- package/src/environment/inspection.ts +87 -0
- package/src/environment/lifecycle.ts +250 -0
- package/src/environment/signature.ts +55 -0
- package/src/errors/render.ts +429 -1
- package/src/extract/camera.ts +78 -0
- package/src/extract/environment.ts +171 -0
- package/src/extract/visibility.ts +38 -19
- package/src/features/host.ts +36 -5
- package/src/features/motion-blur/__tests__/motion-blur-feature.unit.test.ts +67 -0
- package/src/features/motion-blur/__tests__/motion-blur-params.unit.test.ts +53 -0
- package/src/features/motion-blur/motion-blur-feature.ts +119 -0
- package/src/features/motion-blur/motion-blur-params.ts +89 -0
- package/src/features/plan.ts +32 -3
- package/src/features/prepared-gpu-work.ts +21 -6
- package/src/features/prepared-graphics.ts +2 -1
- package/src/features/render-graph-raster.ts +24 -4
- package/src/features/targets.ts +24 -2
- package/src/features/types.ts +13 -0
- package/src/fullscreen-post-process-pass.ts +34 -4
- package/src/gpu-driven/production-raster.ts +6 -1
- package/src/gpu-scene.ts +24 -0
- package/src/ibl/skylight-bind-group.ts +30 -38
- package/src/index.ts +83 -6
- package/src/inspection-types.ts +52 -0
- package/src/internal.ts +5 -0
- package/src/materials.ts +119 -24
- package/src/pbr-pipeline.ts +66 -20
- package/src/pipeline/standard-forward-lane.ts +158 -101
- package/src/pipeline/standard-pipeline.ts +156 -105
- package/src/pipeline/standard-post.ts +373 -0
- package/src/pipeline/standard-profile.ts +11 -11
- package/src/pipeline-builder.ts +102 -12
- package/src/pipeline-spec.ts +9 -0
- package/src/plugin.ts +6 -0
- package/src/points-lines/__tests__/bounds.unit.test.ts +21 -0
- package/src/points-lines/__tests__/cache-recovery.unit.test.ts +157 -0
- package/src/points-lines/__tests__/inspection-lanes.integration.test.ts +146 -0
- package/src/points-lines/__tests__/inspection.unit.test.ts +173 -0
- package/src/points-lines/__tests__/lane-structural.integration.test.ts +122 -0
- package/src/points-lines/__tests__/points-lines.bench.ts +400 -0
- package/src/points-lines/__tests__/raster-lane.integration.test.ts +44 -0
- package/src/points-lines/__tests__/snapshot.unit.test.ts +101 -0
- package/src/points-lines/__tests__/view-ubo.unit.test.ts +73 -0
- package/src/points-lines/admission.ts +238 -0
- package/src/points-lines/bounds.ts +23 -0
- package/src/points-lines/expansion-cache.ts +215 -0
- package/src/points-lines/inspection.ts +97 -0
- package/src/points-lines/prepare.ts +177 -0
- package/src/points-lines/record.ts +125 -0
- package/src/points-lines/snapshot.ts +130 -0
- package/src/record/__tests__/fullscreen-temporal-routing.unit.test.ts +25 -0
- package/src/record/__tests__/main-pass-geometry.unit.test.ts +47 -0
- package/src/record/__tests__/material-bg-cache.unit.test.ts +12 -1
- package/src/record/__tests__/material-pipeline-pending-cache.unit.test.ts +22 -0
- package/src/record/__tests__/sprite-material-abi.unit.test.ts +75 -0
- package/src/record/__tests__/standard-pbr-ubo-layout.unit.test.ts +67 -0
- package/src/record/__tests__/temporal-payload.unit.test.ts +164 -0
- package/src/record/__tests__/typed-frame-graph-plan.unit.test.ts +127 -0
- package/src/record/frame-lighting.ts +14 -2
- package/src/record/frame-snapshot.ts +129 -5
- package/src/record/frame-targets.ts +15 -6
- package/src/record/frame.ts +119 -4
- package/src/record/main-pass-geometry.ts +178 -40
- package/src/record/main-pass-material.ts +114 -66
- package/src/record/main-pass-sprite-draws.ts +79 -102
- package/src/record/main-pass.ts +83 -7
- package/src/record/mesh-ssbo.ts +22 -3
- package/src/record/render-context.ts +209 -23
- package/src/record/shadow-pass.ts +129 -28
- package/src/record/skybox-post-pass.ts +99 -42
- package/src/record/typed-frame-graph.ts +582 -42
- package/src/record/view-ubo.ts +99 -4
- package/src/render-contract.ts +121 -7
- package/src/render-graph-primitives.ts +18 -1
- package/src/render-pipeline.ts +100 -27
- package/src/render-system-extract.ts +264 -77
- package/src/render-system.ts +786 -43
- package/src/scene/render-scene-types.ts +3 -0
- package/src/scene/render-scene.ts +307 -9
- package/src/temporal/__tests__/taa-history-resources.unit.test.ts +45 -0
- package/src/temporal/coverage.ts +76 -0
- package/src/temporal/frame-coordinator.ts +311 -0
- package/src/temporal/gpu.ts +287 -0
- package/src/temporal/history.ts +92 -0
- package/src/temporal/index.ts +6 -0
- package/src/temporal/inspection.ts +97 -0
- package/src/temporal/scene-data-catalog.ts +200 -0
- package/src/temporal/scene-data.ts +149 -0
- package/src/temporal/standard-scene-data.ts +182 -0
- package/src/temporal/taa-history-resources.ts +128 -0
- package/src/temporal/taa-history-store.ts +79 -0
- package/src/temporal/taa-resolve.ts +34 -0
- package/src/temporal/temporal-view.ts +169 -0
- package/src/temporal/transaction.ts +17 -0
- package/src/temporal/view.ts +161 -0
- package/src/transmission/__tests__/capability.unit.test.ts +83 -0
- package/src/transmission/__tests__/composition.integration.test.ts +161 -0
- package/src/transmission/__tests__/inspection.unit.test.ts +241 -0
- package/src/transmission/__tests__/lifecycle.integration.test.ts +96 -0
- package/src/transmission/__tests__/oracle.unit.test.ts +131 -0
- package/src/transmission/__tests__/projection.unit.test.ts +71 -0
- package/src/transmission/__tests__/standard-transmission.dawn.test.ts +438 -0
- package/src/transmission/__tests__/transmission-backdrop-topology.unit.test.ts +109 -0
- package/src/transmission/__tests__/transmission-backdrop.dawn.test.ts +105 -0
- package/src/transmission/backdrop.ts +572 -0
- package/src/transmission/inspection.ts +190 -0
- package/src/transmission/oracle.ts +141 -0
- package/src/transmission/projection.ts +83 -0
- package/src/typed-render-graph-primitives.ts +162 -9
- package/dist/__tests__/authoring-path.unit.test.d.ts +0 -2
- package/dist/__tests__/authoring-path.unit.test.d.ts.map +0 -1
- package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts +0 -2
- package/dist/__tests__/backend-selection-rhi-capture.test-d.d.ts.map +0 -1
- package/dist/__tests__/callback-inference.test-d.d.ts +0 -2
- package/dist/__tests__/callback-inference.test-d.d.ts.map +0 -1
- package/dist/__tests__/cluster-binner.test.d.ts +0 -2
- package/dist/__tests__/cluster-binner.test.d.ts.map +0 -1
- package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/cluster-grid-default-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/construct-renderer-identity.unit.test.d.ts +0 -2
- package/dist/__tests__/construct-renderer-identity.unit.test.d.ts.map +0 -1
- package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts +0 -2
- package/dist/__tests__/device-scope-lifecycle.unit.test.d.ts.map +0 -1
- package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts +0 -2
- package/dist/__tests__/device-scope-stale-matrix.unit.test.d.ts.map +0 -1
- package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts +0 -2
- package/dist/__tests__/direct-extract-consumer-contract.test-d.d.ts.map +0 -1
- package/dist/__tests__/direct-light-snapshot.unit.test.d.ts +0 -2
- package/dist/__tests__/direct-light-snapshot.unit.test.d.ts.map +0 -1
- package/dist/__tests__/factory-contract.integration.test.d.ts +0 -2
- package/dist/__tests__/factory-contract.integration.test.d.ts.map +0 -1
- package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/fallback-row-stride-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/frame-observation.contract.test.d.ts +0 -2
- package/dist/__tests__/frame-observation.contract.test.d.ts.map +0 -1
- package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts +0 -2
- package/dist/__tests__/fullscreen-feature-plan.unit.test.d.ts.map +0 -1
- package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts +0 -2
- package/dist/__tests__/glyph-text-layout-recovery.unit.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts +0 -6
- package/dist/__tests__/gpu-driven-indirect-raster-evidence.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts +0 -2
- package/dist/__tests__/gpu-driven-indirect-raster.browser.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts +0 -2
- package/dist/__tests__/gpu-driven-indirect-raster.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-production.integration.test.d.ts +0 -2
- package/dist/__tests__/gpu-driven-production.integration.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts +0 -2
- package/dist/__tests__/gpu-driven-scaling.unit.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts +0 -18
- package/dist/__tests__/gpu-driven-view-gpu-evidence.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts +0 -2
- package/dist/__tests__/gpu-driven-view-graph.integration.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-view-reference.d.ts +0 -15
- package/dist/__tests__/gpu-driven-view-reference.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-view.browser.test.d.ts +0 -2
- package/dist/__tests__/gpu-driven-view.browser.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-view.dawn.test.d.ts +0 -2
- package/dist/__tests__/gpu-driven-view.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-driven-view.unit.test.d.ts +0 -2
- package/dist/__tests__/gpu-driven-view.unit.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts +0 -2
- package/dist/__tests__/gpu-resource-store-stride.unit.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts +0 -7
- package/dist/__tests__/gpu-scene-render-graph-gpu.d.ts.map +0 -1
- package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts +0 -2
- package/dist/__tests__/gpu-scene-render-graph.browser.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts +0 -2
- package/dist/__tests__/gpu-scene-render-graph.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-scene-schema.unit.test.d.ts +0 -2
- package/dist/__tests__/gpu-scene-schema.unit.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-scene.dawn.test.d.ts +0 -2
- package/dist/__tests__/gpu-scene.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/gpu-scene.unit.test.d.ts +0 -2
- package/dist/__tests__/gpu-scene.unit.test.d.ts.map +0 -1
- package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts +0 -2
- package/dist/__tests__/ibl/face-uniforms.unit.test.d.ts.map +0 -1
- package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts +0 -2
- package/dist/__tests__/infinite-grid-no-vertex-probe.unit.test.d.ts.map +0 -1
- package/dist/__tests__/injection-kind-owner.test-d.d.ts +0 -2
- package/dist/__tests__/injection-kind-owner.test-d.d.ts.map +0 -1
- package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts +0 -2
- package/dist/__tests__/ktx2-basis-gpu-consumer.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/light-buffer-layout.unit.test.d.ts +0 -2
- package/dist/__tests__/light-buffer-layout.unit.test.d.ts.map +0 -1
- package/dist/__tests__/material-contract-inventory.unit.test.d.ts +0 -2
- package/dist/__tests__/material-contract-inventory.unit.test.d.ts.map +0 -1
- package/dist/__tests__/material-cooked-projection.unit.test.d.ts +0 -2
- package/dist/__tests__/material-cooked-projection.unit.test.d.ts.map +0 -1
- package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts +0 -2
- package/dist/__tests__/material-snapshot-mutation.integration.test.d.ts.map +0 -1
- package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts +0 -2
- package/dist/__tests__/material-static-dynamic-route.unit.test.d.ts.map +0 -1
- package/dist/__tests__/material-stride-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/material-stride-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/mesh-buffer-usage-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/mesh-material-bindings.unit.test.d.ts +0 -2
- package/dist/__tests__/mesh-material-bindings.unit.test.d.ts.map +0 -1
- package/dist/__tests__/mesh-stride-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/mesh-stride-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts +0 -2
- package/dist/__tests__/morph-culling-reentry.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts +0 -2
- package/dist/__tests__/morph-feature-gpu-work.integration.test.d.ts.map +0 -1
- package/dist/__tests__/morph-feature-plan.unit.test.d.ts +0 -2
- package/dist/__tests__/morph-feature-plan.unit.test.d.ts.map +0 -1
- package/dist/__tests__/morph-visual-evidence.integration.test.d.ts +0 -2
- package/dist/__tests__/morph-visual-evidence.integration.test.d.ts.map +0 -1
- package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/nineslice-handle-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts +0 -2
- package/dist/__tests__/post-process-error-policy-owner.unit.test.d.ts.map +0 -1
- package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts +0 -2
- package/dist/__tests__/prepared-buffer-kind-owner.test-d.d.ts.map +0 -1
- package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts +0 -2
- package/dist/__tests__/prepared-graphics-capability.unit.test.d.ts.map +0 -1
- package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts +0 -2
- package/dist/__tests__/prepared-graphics-generation.unit.test.d.ts.map +0 -1
- package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts +0 -2
- package/dist/__tests__/prepared-graphics-lifecycle.unit.test.d.ts.map +0 -1
- package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts +0 -2
- package/dist/__tests__/prepared-graphics-pipeline-warmup.unit.test.d.ts.map +0 -1
- package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts +0 -2
- package/dist/__tests__/prepared-graphics-resolver.unit.test.d.ts.map +0 -1
- package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts +0 -2
- package/dist/__tests__/prepared-graphics-snapshot.unit.test.d.ts.map +0 -1
- package/dist/__tests__/prepared-graphics-store.unit.test.d.ts +0 -2
- package/dist/__tests__/prepared-graphics-store.unit.test.d.ts.map +0 -1
- package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts +0 -2
- package/dist/__tests__/prepared-graphics-validation.unit.test.d.ts.map +0 -1
- package/dist/__tests__/profiler-default-off.test.d.ts +0 -2
- package/dist/__tests__/profiler-default-off.test.d.ts.map +0 -1
- package/dist/__tests__/profiler-phase-catalog.test.d.ts +0 -2
- package/dist/__tests__/profiler-phase-catalog.test.d.ts.map +0 -1
- package/dist/__tests__/profiler-phase-integration.test.d.ts +0 -2
- package/dist/__tests__/profiler-phase-integration.test.d.ts.map +0 -1
- package/dist/__tests__/profiler-phase-token.test.d.ts +0 -2
- package/dist/__tests__/profiler-phase-token.test.d.ts.map +0 -1
- package/dist/__tests__/public-surface.test-d.d.ts +0 -2
- package/dist/__tests__/public-surface.test-d.d.ts.map +0 -1
- package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts +0 -2
- package/dist/__tests__/recover-error-policy-owner.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-error-code-owner.test-d.d.ts +0 -2
- package/dist/__tests__/render-error-code-owner.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-error-detail-ssot.test-d.d.ts +0 -2
- package/dist/__tests__/render-error-detail-ssot.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-error-exhaustive.test-d.d.ts +0 -2
- package/dist/__tests__/render-error-exhaustive.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-assembly.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-assembly.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-context.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-context.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-contract.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-contract.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-diagnostics.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-docs.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-docs.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-errors.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-errors.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts +0 -2
- package/dist/__tests__/render-feature-gpu-work.integration.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-plan.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-plan.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-plan.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-plan.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-prepared-diagnostics.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-prepared-errors.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-prepared-graphics-docs.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-prepared-graphics-isolation.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-prepared-graphics-negative.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-prepared-graphics.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-prepared-graphics.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-public-surface.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-public-surface.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-retry.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-retry.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-scheduling.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-scheduling.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-stage-failed-policy-owner.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-stage-fault-recovery.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-visibility-context.test-d.d.ts +0 -2
- package/dist/__tests__/render-feature-visibility-context.test-d.d.ts.map +0 -1
- package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-visibility-context.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-feature-zero-work.unit.test.d.ts +0 -2
- package/dist/__tests__/render-feature-zero-work.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-graph-compute-raster-gpu.d.ts +0 -7
- package/dist/__tests__/render-graph-compute-raster-gpu.d.ts.map +0 -1
- package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts +0 -2
- package/dist/__tests__/render-graph-compute-raster.browser.test.d.ts.map +0 -1
- package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts +0 -2
- package/dist/__tests__/render-graph-compute-raster.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/render-graph-hzb-gpu.d.ts +0 -7
- package/dist/__tests__/render-graph-hzb-gpu.d.ts.map +0 -1
- package/dist/__tests__/render-graph-hzb.browser.test.d.ts +0 -2
- package/dist/__tests__/render-graph-hzb.browser.test.d.ts.map +0 -1
- package/dist/__tests__/render-graph-hzb.dawn.test.d.ts +0 -2
- package/dist/__tests__/render-graph-hzb.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/render-graph-primitives.unit.test.d.ts +0 -2
- package/dist/__tests__/render-graph-primitives.unit.test.d.ts.map +0 -1
- package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts +0 -12
- package/dist/__tests__/render-graph-storage-indirect-gpu.d.ts.map +0 -1
- package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts +0 -2
- package/dist/__tests__/render-graph-storage-indirect.browser.test.d.ts.map +0 -1
- package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts +0 -2
- package/dist/__tests__/render-graph-storage-indirect.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/render-scene-projection.unit.test.d.ts +0 -2
- package/dist/__tests__/render-scene-projection.unit.test.d.ts.map +0 -1
- package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts +0 -2
- package/dist/__tests__/renderer-factory-material-contract.unit.test.d.ts.map +0 -1
- package/dist/__tests__/renderer-lifecycle.integration.test.d.ts +0 -2
- package/dist/__tests__/renderer-lifecycle.integration.test.d.ts.map +0 -1
- package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts +0 -2
- package/dist/__tests__/rhi-backend-package-boundary.unit.test.d.ts.map +0 -1
- package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts +0 -2
- package/dist/__tests__/scriptable-pack-consumer.test-d.d.ts.map +0 -1
- package/dist/__tests__/shader-stage-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/shader-stage-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/ssao-config.unit.test.d.ts +0 -2
- package/dist/__tests__/ssao-config.unit.test.d.ts.map +0 -1
- package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/ssao-kernel-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts +0 -2
- package/dist/__tests__/standard-clustered-pipeline.unit.test.d.ts.map +0 -1
- package/dist/__tests__/standard-descriptors.test-d.d.ts +0 -2
- package/dist/__tests__/standard-descriptors.test-d.d.ts.map +0 -1
- package/dist/__tests__/standard-pipeline.dawn.test.d.ts +0 -2
- package/dist/__tests__/standard-pipeline.dawn.test.d.ts.map +0 -1
- package/dist/__tests__/standard-pipeline.integration.test.d.ts +0 -2
- package/dist/__tests__/standard-pipeline.integration.test.d.ts.map +0 -1
- package/dist/__tests__/standard-profile-oracle.unit.test.d.ts +0 -2
- package/dist/__tests__/standard-profile-oracle.unit.test.d.ts.map +0 -1
- package/dist/__tests__/surface-configuration.unit.test.d.ts +0 -2
- package/dist/__tests__/surface-configuration.unit.test.d.ts.map +0 -1
- package/dist/__tests__/texture-usage-surface.unit.test.d.ts +0 -2
- package/dist/__tests__/texture-usage-surface.unit.test.d.ts.map +0 -1
- package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts +0 -2
- package/dist/__tests__/typed-pipeline-topology.unit.test.d.ts.map +0 -1
- package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts +0 -2
- package/dist/__tests__/urp-pipeline-targets.unit.test.d.ts.map +0 -1
- package/dist/__tests__/urp-pipeline.unit.test.d.ts +0 -2
- package/dist/__tests__/urp-pipeline.unit.test.d.ts.map +0 -1
- package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts +0 -2
- package/dist/__tests__/vertex-color-pipeline.unit.test.d.ts.map +0 -1
- package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts +0 -2
- package/dist/__tests__/vertex-layout-consumer.unit.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-diagnostics.integration.test.d.ts +0 -2
- package/dist/__tests__/visibility-diagnostics.integration.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-extract.integration.test.d.ts +0 -2
- package/dist/__tests__/visibility-extract.integration.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-extract.perf.test.d.ts +0 -2
- package/dist/__tests__/visibility-extract.perf.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts +0 -2
- package/dist/__tests__/visibility-feature-dedup.integration.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-hidden-report.unit.test.d.ts +0 -2
- package/dist/__tests__/visibility-hidden-report.unit.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-instances.integration.test.d.ts +0 -2
- package/dist/__tests__/visibility-instances.integration.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-multi-world.integration.test.d.ts +0 -2
- package/dist/__tests__/visibility-multi-world.integration.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts +0 -2
- package/dist/__tests__/visibility-producer-matrix.integration.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts +0 -2
- package/dist/__tests__/visibility-producer-matrix.unit.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-public-surface.test-d.d.ts +0 -2
- package/dist/__tests__/visibility-public-surface.test-d.d.ts.map +0 -1
- package/dist/__tests__/visibility-resolver.unit.test.d.ts +0 -2
- package/dist/__tests__/visibility-resolver.unit.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts +0 -2
- package/dist/__tests__/visibility-resource-short-circuit.unit.test.d.ts.map +0 -1
- package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts +0 -2
- package/dist/__tests__/visibility-snapshot-contract.unit.test.d.ts.map +0 -1
- package/dist/__tests__/vocabulary.unit.test.d.ts +0 -2
- package/dist/__tests__/vocabulary.unit.test.d.ts.map +0 -1
- package/dist/chunk-CQXZC5XI.mjs.map +0 -1
- package/dist/chunk-QC4VW3XJ.mjs.map +0 -1
- package/dist/chunk-SCRSAK5B.mjs.map +0 -1
- package/dist/components/__tests__/schema-contract.unit.test.d.ts +0 -2
- package/dist/components/__tests__/schema-contract.unit.test.d.ts.map +0 -1
- package/dist/components/__tests__/schema-parity.unit.test.d.ts +0 -2
- package/dist/components/__tests__/schema-parity.unit.test.d.ts.map +0 -1
- package/dist/components/__tests__/visibility-schema.unit.test.d.ts +0 -2
- package/dist/components/__tests__/visibility-schema.unit.test.d.ts.map +0 -1
- package/dist/record/__tests__/material-bg-cache.unit.test.d.ts +0 -2
- package/dist/record/__tests__/material-bg-cache.unit.test.d.ts.map +0 -1
- package/dist/record/__tests__/material-slot-plan.unit.test.d.ts +0 -2
- package/dist/record/__tests__/material-slot-plan.unit.test.d.ts.map +0 -1
- package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts +0 -2
- package/dist/record/__tests__/typed-frame-graph-plan.unit.test.d.ts.map +0 -1
- package/dist/record/__tests__/video-texture-view.unit.test.d.ts +0 -2
- package/dist/record/__tests__/video-texture-view.unit.test.d.ts.map +0 -1
|
@@ -0,0 +1,438 @@
|
|
|
1
|
+
import { World } from '@forgeax/engine-ecs';
|
|
2
|
+
import { createPlaneGeometry } from '@forgeax/engine-geometry';
|
|
3
|
+
import {
|
|
4
|
+
_internal_getRawDevice,
|
|
5
|
+
createShaderModule,
|
|
6
|
+
rhi,
|
|
7
|
+
translateErrorEventToRhiError as translateWebgpuError,
|
|
8
|
+
} from '@forgeax/engine-rhi-webgpu';
|
|
9
|
+
import { Transform } from '@forgeax/engine-scene';
|
|
10
|
+
import type { TextureAsset } from '@forgeax/engine-types';
|
|
11
|
+
import { describe, expect, it } from 'vitest';
|
|
12
|
+
import {
|
|
13
|
+
Camera,
|
|
14
|
+
DirectionalLight,
|
|
15
|
+
MeshFilter,
|
|
16
|
+
MeshRenderer,
|
|
17
|
+
TONEMAP_LINEAR,
|
|
18
|
+
} from '../../components';
|
|
19
|
+
import { constructRendererHost, type RhiBackendPack } from '../../construct-renderer';
|
|
20
|
+
import { Materials } from '../../materials';
|
|
21
|
+
import { DEFAULT_STANDARD_PROFILE } from '../../pipeline/standard-profile';
|
|
22
|
+
|
|
23
|
+
const WIDTH = 32;
|
|
24
|
+
const HEIGHT = 32;
|
|
25
|
+
const TEXTURE_USAGE_COPY_SRC = 0x01;
|
|
26
|
+
const TEXTURE_USAGE_RENDER_ATTACHMENT = 0x10;
|
|
27
|
+
const BUFFER_USAGE_MAP_READ = 0x0001;
|
|
28
|
+
const BUFFER_USAGE_COPY_DST = 0x0008;
|
|
29
|
+
const GPU_MAP_MODE_READ = 0x0001;
|
|
30
|
+
const TEST_REACTIVE = 0;
|
|
31
|
+
|
|
32
|
+
const ENGINE_MANIFEST = await (async () => {
|
|
33
|
+
const { buildEngineShaderManifest } = await import('@forgeax/engine-vite-plugin-shader');
|
|
34
|
+
return buildEngineShaderManifest();
|
|
35
|
+
})();
|
|
36
|
+
const ENGINE_MANIFEST_URL = `data:application/json,${encodeURIComponent(
|
|
37
|
+
JSON.stringify(ENGINE_MANIFEST),
|
|
38
|
+
)}`;
|
|
39
|
+
const DAWN_BACKEND: RhiBackendPack = {
|
|
40
|
+
rhi,
|
|
41
|
+
createShaderModule,
|
|
42
|
+
_internal_getRawDevice,
|
|
43
|
+
translateErrorEventToRhiError: translateWebgpuError as NonNullable<
|
|
44
|
+
RhiBackendPack['translateErrorEventToRhiError']
|
|
45
|
+
>,
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
interface TransmissionCase {
|
|
49
|
+
readonly name: string;
|
|
50
|
+
readonly transmission: number;
|
|
51
|
+
readonly ior: number;
|
|
52
|
+
readonly thickness: number;
|
|
53
|
+
readonly roughness: number;
|
|
54
|
+
readonly attenuationColor: readonly [number, number, number];
|
|
55
|
+
readonly attenuationDistance?: number;
|
|
56
|
+
readonly transmissionTexture?: number;
|
|
57
|
+
readonly thicknessTexture?: number;
|
|
58
|
+
readonly masked?: boolean;
|
|
59
|
+
readonly overlap?: boolean;
|
|
60
|
+
readonly lane?: 'direct' | 'clustered';
|
|
61
|
+
readonly surfaceQuat?: readonly [number, number, number, number];
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
function textureAsset(value: number): TextureAsset {
|
|
65
|
+
const channel = Math.round(value * 255);
|
|
66
|
+
return {
|
|
67
|
+
kind: 'texture',
|
|
68
|
+
width: 1,
|
|
69
|
+
height: 1,
|
|
70
|
+
format: 'rgba8unorm',
|
|
71
|
+
data: Uint8Array.from([channel, channel, channel, 255]),
|
|
72
|
+
colorSpace: 'linear',
|
|
73
|
+
mipmap: false,
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
async function readCenter(
|
|
78
|
+
device: GPUDevice,
|
|
79
|
+
target: GPUTexture,
|
|
80
|
+
): Promise<[number, number, number, number]> {
|
|
81
|
+
const bytesPerRow = Math.ceil((WIDTH * 4) / 256) * 256;
|
|
82
|
+
const readback = device.createBuffer({
|
|
83
|
+
size: bytesPerRow * HEIGHT,
|
|
84
|
+
usage: BUFFER_USAGE_MAP_READ | BUFFER_USAGE_COPY_DST,
|
|
85
|
+
});
|
|
86
|
+
const encoder = device.createCommandEncoder();
|
|
87
|
+
encoder.copyTextureToBuffer(
|
|
88
|
+
{ texture: target },
|
|
89
|
+
{ buffer: readback, bytesPerRow, rowsPerImage: HEIGHT },
|
|
90
|
+
{ width: WIDTH, height: HEIGHT, depthOrArrayLayers: 1 },
|
|
91
|
+
);
|
|
92
|
+
device.queue.submit([encoder.finish()]);
|
|
93
|
+
await readback.mapAsync(GPU_MAP_MODE_READ);
|
|
94
|
+
const bytes = new Uint8Array(readback.getMappedRange().slice(0));
|
|
95
|
+
readback.unmap();
|
|
96
|
+
readback.destroy();
|
|
97
|
+
const offset = Math.floor(HEIGHT / 2) * bytesPerRow + Math.floor(WIDTH / 2) * 4;
|
|
98
|
+
return [
|
|
99
|
+
bytes[offset] ?? 0,
|
|
100
|
+
bytes[offset + 1] ?? 0,
|
|
101
|
+
bytes[offset + 2] ?? 0,
|
|
102
|
+
bytes[offset + 3] ?? 0,
|
|
103
|
+
];
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
async function renderCase(testCase: TransmissionCase): Promise<{
|
|
107
|
+
readonly pixel: readonly [number, number, number, number];
|
|
108
|
+
readonly passNames: readonly string[];
|
|
109
|
+
readonly observation: boolean;
|
|
110
|
+
}> {
|
|
111
|
+
let device: GPUDevice | undefined;
|
|
112
|
+
let configuredDevice: GPUDevice | undefined;
|
|
113
|
+
let target: GPUTexture | undefined;
|
|
114
|
+
const originalRequestAdapter = globalThis.navigator.gpu.requestAdapter.bind(
|
|
115
|
+
globalThis.navigator.gpu,
|
|
116
|
+
);
|
|
117
|
+
globalThis.navigator.gpu.requestAdapter = async (options) => {
|
|
118
|
+
const adapter = await originalRequestAdapter(options);
|
|
119
|
+
if (adapter === null) return adapter;
|
|
120
|
+
const requestDevice = adapter.requestDevice.bind(adapter);
|
|
121
|
+
adapter.requestDevice = async (descriptor) => {
|
|
122
|
+
const next = await requestDevice(descriptor);
|
|
123
|
+
device ??= next;
|
|
124
|
+
return next;
|
|
125
|
+
};
|
|
126
|
+
return adapter;
|
|
127
|
+
};
|
|
128
|
+
const canvas = {
|
|
129
|
+
width: WIDTH,
|
|
130
|
+
height: HEIGHT,
|
|
131
|
+
getContext(kind: string): unknown {
|
|
132
|
+
if (kind !== 'webgpu') return null;
|
|
133
|
+
return {
|
|
134
|
+
configure(desc: { device: GPUDevice; format?: GPUTextureFormat }) {
|
|
135
|
+
configuredDevice ??= desc.device;
|
|
136
|
+
target ??= desc.device.createTexture({
|
|
137
|
+
size: { width: WIDTH, height: HEIGHT, depthOrArrayLayers: 1 },
|
|
138
|
+
format: desc.format ?? 'rgba8unorm',
|
|
139
|
+
usage: TEXTURE_USAGE_COPY_SRC | TEXTURE_USAGE_RENDER_ATTACHMENT,
|
|
140
|
+
viewFormats: ['rgba8unorm-srgb'],
|
|
141
|
+
});
|
|
142
|
+
},
|
|
143
|
+
unconfigure() {},
|
|
144
|
+
getCurrentTexture() {
|
|
145
|
+
if (target === undefined) throw new Error('render target was not configured');
|
|
146
|
+
return target;
|
|
147
|
+
},
|
|
148
|
+
};
|
|
149
|
+
},
|
|
150
|
+
addEventListener() {},
|
|
151
|
+
removeEventListener() {},
|
|
152
|
+
} as unknown as HTMLCanvasElement;
|
|
153
|
+
|
|
154
|
+
let host: Awaited<ReturnType<typeof constructRendererHost>>;
|
|
155
|
+
try {
|
|
156
|
+
host = await constructRendererHost(
|
|
157
|
+
canvas,
|
|
158
|
+
{
|
|
159
|
+
standardProfile: {
|
|
160
|
+
...DEFAULT_STANDARD_PROFILE,
|
|
161
|
+
lighting: testCase.lane ?? 'direct',
|
|
162
|
+
},
|
|
163
|
+
},
|
|
164
|
+
{ shaderManifestUrl: ENGINE_MANIFEST_URL },
|
|
165
|
+
DAWN_BACKEND,
|
|
166
|
+
);
|
|
167
|
+
} finally {
|
|
168
|
+
globalThis.navigator.gpu.requestAdapter = originalRequestAdapter;
|
|
169
|
+
}
|
|
170
|
+
expect(host.ok).toBe(true);
|
|
171
|
+
if (!host.ok || device === undefined) {
|
|
172
|
+
throw new Error('runtime Dawn renderer was not ready');
|
|
173
|
+
}
|
|
174
|
+
|
|
175
|
+
const { renderer } = host.value;
|
|
176
|
+
const world = new World();
|
|
177
|
+
const lease = renderer.attach(world);
|
|
178
|
+
if (!lease.ok) throw lease.error;
|
|
179
|
+
const plane = createPlaneGeometry(2, 2);
|
|
180
|
+
if (!plane.ok) throw plane.error;
|
|
181
|
+
const mesh = world.allocSharedRef('MeshAsset', {
|
|
182
|
+
...plane.value,
|
|
183
|
+
materialSlots: [{ slotName: 'Default' }],
|
|
184
|
+
});
|
|
185
|
+
const transmissionHandle =
|
|
186
|
+
testCase.transmissionTexture === undefined
|
|
187
|
+
? undefined
|
|
188
|
+
: world.allocSharedRef('TextureAsset', textureAsset(testCase.transmissionTexture));
|
|
189
|
+
const thicknessHandle =
|
|
190
|
+
testCase.thicknessTexture === undefined
|
|
191
|
+
? undefined
|
|
192
|
+
: world.allocSharedRef('TextureAsset', textureAsset(testCase.thicknessTexture));
|
|
193
|
+
const material = Materials.standard({
|
|
194
|
+
baseColor: [0.7, 0.8, 0.9, testCase.masked ? 0.35 : 1],
|
|
195
|
+
metallic: 0,
|
|
196
|
+
roughness: testCase.roughness,
|
|
197
|
+
transmission: testCase.transmission,
|
|
198
|
+
ior: testCase.ior,
|
|
199
|
+
thickness: testCase.thickness,
|
|
200
|
+
attenuationColor: testCase.attenuationColor,
|
|
201
|
+
castShadow: false,
|
|
202
|
+
...(testCase.attenuationDistance === undefined
|
|
203
|
+
? {}
|
|
204
|
+
: { attenuationDistance: testCase.attenuationDistance }),
|
|
205
|
+
...(testCase.masked
|
|
206
|
+
? {
|
|
207
|
+
queue: 2450,
|
|
208
|
+
alphaCutoff: 0.5,
|
|
209
|
+
baseColorTexture: {
|
|
210
|
+
texture: world.allocSharedRef('TextureAsset', {
|
|
211
|
+
kind: 'texture',
|
|
212
|
+
width: 2,
|
|
213
|
+
height: 2,
|
|
214
|
+
format: 'rgba8unorm',
|
|
215
|
+
data: Uint8Array.from([
|
|
216
|
+
255, 255, 255, 0, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 255, 0,
|
|
217
|
+
]),
|
|
218
|
+
colorSpace: 'linear',
|
|
219
|
+
mipmap: false,
|
|
220
|
+
}),
|
|
221
|
+
},
|
|
222
|
+
}
|
|
223
|
+
: { queue: 2000 }),
|
|
224
|
+
...(testCase.surfaceQuat === undefined ? {} : { renderState: { cullMode: 'none' as const } }),
|
|
225
|
+
...(transmissionHandle === undefined
|
|
226
|
+
? {}
|
|
227
|
+
: { transmissionTexture: { texture: transmissionHandle as never } }),
|
|
228
|
+
...(thicknessHandle === undefined
|
|
229
|
+
? {}
|
|
230
|
+
: { thicknessTexture: { texture: thicknessHandle as never } }),
|
|
231
|
+
});
|
|
232
|
+
const materialHandle = world.allocSharedRef('MaterialAsset', material);
|
|
233
|
+
const meshEntity = world.spawn(
|
|
234
|
+
{
|
|
235
|
+
component: Transform,
|
|
236
|
+
data: testCase.surfaceQuat === undefined ? {} : { quat: testCase.surfaceQuat },
|
|
237
|
+
},
|
|
238
|
+
{ component: MeshFilter, data: { assetHandle: mesh } },
|
|
239
|
+
{ component: MeshRenderer, data: { materials: [materialHandle] } },
|
|
240
|
+
);
|
|
241
|
+
expect(meshEntity.ok, `${testCase.name}: mesh spawn must succeed`).toBe(true);
|
|
242
|
+
if (!meshEntity.ok) throw meshEntity.error;
|
|
243
|
+
if (testCase.overlap) {
|
|
244
|
+
const overlay = Materials.unlit([0.1, 0.9, 0.2, 0.35], {
|
|
245
|
+
castShadow: false,
|
|
246
|
+
queue: 3000,
|
|
247
|
+
renderState: {
|
|
248
|
+
cullMode: 'none',
|
|
249
|
+
depthWriteEnabled: false,
|
|
250
|
+
blend: {
|
|
251
|
+
color: { srcFactor: 'src-alpha', dstFactor: 'one-minus-src-alpha', operation: 'add' },
|
|
252
|
+
alpha: { srcFactor: 'one', dstFactor: 'one-minus-src-alpha', operation: 'add' },
|
|
253
|
+
},
|
|
254
|
+
},
|
|
255
|
+
});
|
|
256
|
+
const overlayHandle = world.allocSharedRef('MaterialAsset', overlay);
|
|
257
|
+
const overlayEntity = world.spawn(
|
|
258
|
+
{ component: Transform, data: { pos: [0, 0, -0.1] } },
|
|
259
|
+
{ component: MeshFilter, data: { assetHandle: mesh } },
|
|
260
|
+
{ component: MeshRenderer, data: { materials: [overlayHandle] } },
|
|
261
|
+
);
|
|
262
|
+
expect(overlayEntity.ok, `${testCase.name}: overlay spawn must succeed`).toBe(true);
|
|
263
|
+
if (!overlayEntity.ok) throw overlayEntity.error;
|
|
264
|
+
}
|
|
265
|
+
const cameraEntity = world.spawn(
|
|
266
|
+
{ component: Transform, data: { pos: [0, 0, 3] } },
|
|
267
|
+
{
|
|
268
|
+
component: Camera,
|
|
269
|
+
data: {
|
|
270
|
+
fov: Math.PI / 4,
|
|
271
|
+
aspect: 1,
|
|
272
|
+
near: 0.1,
|
|
273
|
+
far: 10,
|
|
274
|
+
tonemap: TONEMAP_LINEAR,
|
|
275
|
+
clearColor: [0.05, 0.1, 0.15, 1],
|
|
276
|
+
},
|
|
277
|
+
},
|
|
278
|
+
);
|
|
279
|
+
expect(cameraEntity.ok, `${testCase.name}: camera spawn must succeed`).toBe(true);
|
|
280
|
+
if (!cameraEntity.ok) throw cameraEntity.error;
|
|
281
|
+
const lightEntity = world.spawn({
|
|
282
|
+
component: DirectionalLight,
|
|
283
|
+
data: { direction: [0, 0, -1], color: [1, 1, 1], intensity: 1, castShadow: false },
|
|
284
|
+
});
|
|
285
|
+
expect(lightEntity.ok, `${testCase.name}: light spawn must succeed`).toBe(true);
|
|
286
|
+
if (!lightEntity.ok) throw lightEntity.error;
|
|
287
|
+
world.update().unwrap();
|
|
288
|
+
const drawn = renderer.draw({
|
|
289
|
+
leases: [lease.value],
|
|
290
|
+
camera: { lease: lease.value },
|
|
291
|
+
environment: { lease: lease.value },
|
|
292
|
+
});
|
|
293
|
+
expect(drawn.ok, drawn.ok ? undefined : JSON.stringify(drawn.error)).toBe(true);
|
|
294
|
+
if (!drawn.ok) throw drawn.error;
|
|
295
|
+
await drawn.value.completed;
|
|
296
|
+
const observation = await renderer.observe(drawn.value, { include: ['draws', 'bindings'] });
|
|
297
|
+
expect(observation.ok).toBe(true);
|
|
298
|
+
await device.queue.onSubmittedWorkDone();
|
|
299
|
+
if (target === undefined) throw new Error('render target was not configured after draw');
|
|
300
|
+
const renderDevice = configuredDevice ?? device;
|
|
301
|
+
const passNames = renderer.inspect().perFramePassNames;
|
|
302
|
+
expect(renderer.inspect().renderScene.projectionRecords).toBeGreaterThanOrEqual(1);
|
|
303
|
+
return {
|
|
304
|
+
pixel: await readCenter(renderDevice, target),
|
|
305
|
+
passNames,
|
|
306
|
+
observation: observation.ok,
|
|
307
|
+
};
|
|
308
|
+
}
|
|
309
|
+
|
|
310
|
+
function luma(pixel: readonly [number, number, number, number]): number {
|
|
311
|
+
return 0.2126 * pixel[0] + 0.7152 * pixel[1] + 0.0722 * pixel[2];
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
describe('Standard transmission Dawn ROI', () => {
|
|
315
|
+
it('uses linear HDR observation and responds to F0, Beer, texture, TIR, and fallback inputs', async () => {
|
|
316
|
+
const baseline = await renderCase({
|
|
317
|
+
name: 'baseline',
|
|
318
|
+
transmission: 0,
|
|
319
|
+
ior: 1.5,
|
|
320
|
+
thickness: 0,
|
|
321
|
+
roughness: 0.5,
|
|
322
|
+
attenuationColor: [1, 1, 1],
|
|
323
|
+
});
|
|
324
|
+
const transmitted = await renderCase({
|
|
325
|
+
name: 'transmitted',
|
|
326
|
+
transmission: 1,
|
|
327
|
+
ior: 1.5,
|
|
328
|
+
thickness: 0.5,
|
|
329
|
+
roughness: 0.5,
|
|
330
|
+
attenuationColor: [0.1, 0.4, 0.8],
|
|
331
|
+
attenuationDistance: 1,
|
|
332
|
+
transmissionTexture: 1,
|
|
333
|
+
thicknessTexture: 1,
|
|
334
|
+
});
|
|
335
|
+
const tir = await renderCase({
|
|
336
|
+
name: 'total-internal-reflection',
|
|
337
|
+
transmission: 1,
|
|
338
|
+
ior: 1.5,
|
|
339
|
+
thickness: 0.5,
|
|
340
|
+
roughness: 0.5,
|
|
341
|
+
attenuationColor: [0.1, 0.4, 0.8],
|
|
342
|
+
attenuationDistance: 1,
|
|
343
|
+
transmissionTexture: 1,
|
|
344
|
+
thicknessTexture: 1,
|
|
345
|
+
// Back side at a grazing angle: eta=ior exercises TIR. The old case
|
|
346
|
+
// duplicated the air-to-glass inputs (eta=1/ior), where TIR is impossible.
|
|
347
|
+
surfaceQuat: [0, Math.sin((Math.PI * 235) / 360), 0, Math.cos((Math.PI * 235) / 360)],
|
|
348
|
+
});
|
|
349
|
+
|
|
350
|
+
expect(baseline.passNames).not.toContain('transmission-forward');
|
|
351
|
+
expect(transmitted.passNames).toContain('linear-hdr-observation');
|
|
352
|
+
expect(transmitted.passNames).toContain('transmission-forward');
|
|
353
|
+
expect(transmitted.observation).toBe(true);
|
|
354
|
+
expect(transmitted.pixel.every(Number.isFinite)).toBe(true);
|
|
355
|
+
expect(transmitted.pixel).not.toEqual(baseline.pixel);
|
|
356
|
+
expect(tir.pixel).not.toEqual(transmitted.pixel);
|
|
357
|
+
expect(TEST_REACTIVE).toBe(0);
|
|
358
|
+
}, 120_000);
|
|
359
|
+
|
|
360
|
+
it('keeps IOR, thickness, and roughness monotonic in a finite linear ROI', async () => {
|
|
361
|
+
const cases = await Promise.all([
|
|
362
|
+
renderCase({
|
|
363
|
+
name: 'ior-low',
|
|
364
|
+
transmission: 1,
|
|
365
|
+
ior: 1.1,
|
|
366
|
+
thickness: 0.1,
|
|
367
|
+
roughness: 0.1,
|
|
368
|
+
attenuationColor: [0.8, 0.8, 0.8],
|
|
369
|
+
attenuationDistance: 4,
|
|
370
|
+
}),
|
|
371
|
+
renderCase({
|
|
372
|
+
name: 'ior-high',
|
|
373
|
+
transmission: 1,
|
|
374
|
+
ior: 2.2,
|
|
375
|
+
thickness: 0.1,
|
|
376
|
+
roughness: 0.1,
|
|
377
|
+
attenuationColor: [0.8, 0.8, 0.8],
|
|
378
|
+
attenuationDistance: 4,
|
|
379
|
+
}),
|
|
380
|
+
renderCase({
|
|
381
|
+
name: 'thick',
|
|
382
|
+
transmission: 1,
|
|
383
|
+
ior: 1.5,
|
|
384
|
+
thickness: 1.5,
|
|
385
|
+
roughness: 0.1,
|
|
386
|
+
attenuationColor: [0.1, 0.1, 0.1],
|
|
387
|
+
attenuationDistance: 1,
|
|
388
|
+
}),
|
|
389
|
+
renderCase({
|
|
390
|
+
name: 'rough',
|
|
391
|
+
transmission: 1,
|
|
392
|
+
ior: 1.5,
|
|
393
|
+
thickness: 0.1,
|
|
394
|
+
roughness: 0.9,
|
|
395
|
+
attenuationColor: [0.8, 0.8, 0.8],
|
|
396
|
+
attenuationDistance: 4,
|
|
397
|
+
}),
|
|
398
|
+
]);
|
|
399
|
+
for (const result of cases) expect(result.pixel.every(Number.isFinite)).toBe(true);
|
|
400
|
+
expect(cases[1]?.pixel).not.toEqual(cases[0]?.pixel);
|
|
401
|
+
expect(cases[2]?.pixel).not.toEqual(cases[0]?.pixel);
|
|
402
|
+
expect(luma(cases[3]?.pixel ?? [0, 0, 0, 0])).toBeLessThanOrEqual(
|
|
403
|
+
luma(cases[0]?.pixel ?? [0, 0, 0, 0]) + 2,
|
|
404
|
+
);
|
|
405
|
+
}, 120_000);
|
|
406
|
+
|
|
407
|
+
it('exercises direct/clustered lanes and transmission-before-BLEND overlap order', async () => {
|
|
408
|
+
const direct = await renderCase({
|
|
409
|
+
name: 'direct',
|
|
410
|
+
transmission: 1,
|
|
411
|
+
ior: 1.5,
|
|
412
|
+
thickness: 0.5,
|
|
413
|
+
roughness: 0.3,
|
|
414
|
+
attenuationColor: [0.7, 0.8, 0.9],
|
|
415
|
+
attenuationDistance: 2,
|
|
416
|
+
overlap: true,
|
|
417
|
+
lane: 'direct',
|
|
418
|
+
});
|
|
419
|
+
const clustered = await renderCase({
|
|
420
|
+
name: 'clustered',
|
|
421
|
+
transmission: 1,
|
|
422
|
+
ior: 1.5,
|
|
423
|
+
thickness: 0.5,
|
|
424
|
+
roughness: 0.3,
|
|
425
|
+
attenuationColor: [0.7, 0.8, 0.9],
|
|
426
|
+
attenuationDistance: 2,
|
|
427
|
+
overlap: true,
|
|
428
|
+
lane: 'clustered',
|
|
429
|
+
});
|
|
430
|
+
const transmissionIndex = direct.passNames.indexOf('transmission-forward');
|
|
431
|
+
const transparentIndex = direct.passNames.indexOf('transparent');
|
|
432
|
+
expect(transmissionIndex).toBeGreaterThanOrEqual(0);
|
|
433
|
+
expect(transparentIndex).toBeGreaterThan(transmissionIndex);
|
|
434
|
+
expect(clustered.pixel).not.toEqual(direct.pixel);
|
|
435
|
+
expect(clustered.pixel.every(Number.isFinite)).toBe(true);
|
|
436
|
+
expect(direct.pixel.every(Number.isFinite)).toBe(true);
|
|
437
|
+
}, 120_000);
|
|
438
|
+
});
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { RenderGraphBuilder } from '@forgeax/engine-render-graph';
|
|
2
|
+
import { describe, expect, it } from 'vitest';
|
|
3
|
+
import type { RenderPipelineFrame } from '../../render-pipeline';
|
|
4
|
+
import { createRenderPipelineTarget } from '../../render-pipeline';
|
|
5
|
+
import {
|
|
6
|
+
addTransmissionBackdropPasses,
|
|
7
|
+
resolveTransmissionBackdropTopology,
|
|
8
|
+
type TransmissionBackdropTopologyInput,
|
|
9
|
+
} from '../backdrop';
|
|
10
|
+
|
|
11
|
+
function topology(
|
|
12
|
+
overrides: Partial<TransmissionBackdropTopologyInput> = {},
|
|
13
|
+
): TransmissionBackdropTopologyInput {
|
|
14
|
+
return {
|
|
15
|
+
demand: { activeCount: 1, needsRoughMips: false },
|
|
16
|
+
sourceSampleCount: 1,
|
|
17
|
+
...overrides,
|
|
18
|
+
};
|
|
19
|
+
}
|
|
20
|
+
|
|
21
|
+
describe('TransmissionBackdrop typed topology', () => {
|
|
22
|
+
it('keeps the demand-off path exact zero', () => {
|
|
23
|
+
expect(
|
|
24
|
+
resolveTransmissionBackdropTopology({
|
|
25
|
+
demand: { activeCount: 0, needsRoughMips: false },
|
|
26
|
+
sourceSampleCount: 4,
|
|
27
|
+
}),
|
|
28
|
+
).toEqual({
|
|
29
|
+
active: false,
|
|
30
|
+
sourceSampleCount: 4,
|
|
31
|
+
copyCount: 0,
|
|
32
|
+
mipCount: 0,
|
|
33
|
+
submitCount: 1,
|
|
34
|
+
aliasCount: 0,
|
|
35
|
+
phases: [],
|
|
36
|
+
});
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
it('places one resolved copy before transmission and ordinary transparent work', () => {
|
|
40
|
+
expect(resolveTransmissionBackdropTopology(topology()).phases).toEqual([
|
|
41
|
+
'opaque-resolve',
|
|
42
|
+
'transmission-backdrop-copy',
|
|
43
|
+
'transmission-forward',
|
|
44
|
+
'transparent',
|
|
45
|
+
'temporal',
|
|
46
|
+
]);
|
|
47
|
+
expect(resolveTransmissionBackdropTopology(topology())).toMatchObject({
|
|
48
|
+
active: true,
|
|
49
|
+
copyCount: 1,
|
|
50
|
+
mipCount: 0,
|
|
51
|
+
});
|
|
52
|
+
});
|
|
53
|
+
|
|
54
|
+
it('adds only shared raster mip work for rough transmission', () => {
|
|
55
|
+
expect(
|
|
56
|
+
resolveTransmissionBackdropTopology(
|
|
57
|
+
topology({ demand: { activeCount: 2, needsRoughMips: true } }),
|
|
58
|
+
),
|
|
59
|
+
).toMatchObject({
|
|
60
|
+
active: true,
|
|
61
|
+
copyCount: 1,
|
|
62
|
+
mipCount: 1,
|
|
63
|
+
phases: [
|
|
64
|
+
'opaque-resolve',
|
|
65
|
+
'transmission-backdrop-copy',
|
|
66
|
+
'transmission-backdrop-mip',
|
|
67
|
+
'transmission-forward',
|
|
68
|
+
'transparent',
|
|
69
|
+
'temporal',
|
|
70
|
+
],
|
|
71
|
+
});
|
|
72
|
+
});
|
|
73
|
+
|
|
74
|
+
it('never creates a second submission or aliases the backdrop source', () => {
|
|
75
|
+
const result = resolveTransmissionBackdropTopology(topology({ sourceSampleCount: 4 }));
|
|
76
|
+
|
|
77
|
+
expect(result).toMatchObject({ sourceSampleCount: 4, submitCount: 1, aliasCount: 0 });
|
|
78
|
+
});
|
|
79
|
+
|
|
80
|
+
it('rejects rough mips without a renderer-owned sampling encoder', () => {
|
|
81
|
+
const graph = new RenderGraphBuilder<RenderPipelineFrame>();
|
|
82
|
+
const source = createRenderPipelineTarget(graph, 'opaque-resolved', {
|
|
83
|
+
format: 'rgba16float',
|
|
84
|
+
size: 'surface',
|
|
85
|
+
});
|
|
86
|
+
expect(source.ok).toBe(true);
|
|
87
|
+
if (!source.ok) return;
|
|
88
|
+
|
|
89
|
+
const result = addTransmissionBackdropPasses({
|
|
90
|
+
graph,
|
|
91
|
+
source: source.value,
|
|
92
|
+
demand: { activeCount: 1, needsRoughMips: true },
|
|
93
|
+
copySize: { width: 8, height: 4 },
|
|
94
|
+
});
|
|
95
|
+
|
|
96
|
+
expect(result.ok).toBe(false);
|
|
97
|
+
if (result.ok) return;
|
|
98
|
+
expect(result.error).toMatchObject({
|
|
99
|
+
code: 'resource-descriptor-invalid',
|
|
100
|
+
detail: {
|
|
101
|
+
resourceLabel: 'transmission-backdrop',
|
|
102
|
+
field: 'roughMipEncoder',
|
|
103
|
+
actual: 'missing',
|
|
104
|
+
},
|
|
105
|
+
});
|
|
106
|
+
expect(result.error.expected).toContain('fullscreen/downsample owner');
|
|
107
|
+
expect(result.error.hint).toContain('encodeRoughMip');
|
|
108
|
+
});
|
|
109
|
+
});
|
|
@@ -0,0 +1,105 @@
|
|
|
1
|
+
import { RenderGraphBuilder } from '@forgeax/engine-render-graph';
|
|
2
|
+
import type { RhiDevice } from '@forgeax/engine-rhi';
|
|
3
|
+
import { rhi } from '@forgeax/engine-rhi-webgpu';
|
|
4
|
+
import { describe, expect, it } from 'vitest';
|
|
5
|
+
import type { RenderPipelineFrame } from '../../render-pipeline';
|
|
6
|
+
import { createRenderPipelineTarget } from '../../render-pipeline';
|
|
7
|
+
import { addTransmissionBackdropPasses, type TransmissionBackdropGraph } from '../backdrop';
|
|
8
|
+
|
|
9
|
+
async function buildBackdrop(device: RhiDevice): Promise<TransmissionBackdropGraph> {
|
|
10
|
+
const graph = new RenderGraphBuilder<RenderPipelineFrame>();
|
|
11
|
+
const source = createRenderPipelineTarget(graph, 'opaque-resolved', {
|
|
12
|
+
format: 'rgba16float',
|
|
13
|
+
size: 'surface',
|
|
14
|
+
sampleCount: 1,
|
|
15
|
+
});
|
|
16
|
+
expect(source.ok).toBe(true);
|
|
17
|
+
if (!source.ok) throw source.error;
|
|
18
|
+
graph
|
|
19
|
+
.addRasterPass('opaque', {
|
|
20
|
+
accesses: [{ resource: source.value.view, usage: 'color-attachment' }],
|
|
21
|
+
colorAttachments: [{ view: source.value.view, loadOp: 'clear', storeOp: 'store' }],
|
|
22
|
+
encode: () => undefined,
|
|
23
|
+
})
|
|
24
|
+
.unwrap();
|
|
25
|
+
const added = addTransmissionBackdropPasses({
|
|
26
|
+
graph,
|
|
27
|
+
source: source.value,
|
|
28
|
+
demand: { activeCount: 2, needsRoughMips: true },
|
|
29
|
+
copySize: { width: 4, height: 4 },
|
|
30
|
+
encodeRoughMip: ({ pass }) => {
|
|
31
|
+
pass.draw(3, 1, 0, 0);
|
|
32
|
+
},
|
|
33
|
+
});
|
|
34
|
+
expect(added.ok).toBe(true);
|
|
35
|
+
if (!added.ok) throw added.error;
|
|
36
|
+
const compiled = graph.compile({ device, surfaceSize: { width: 4, height: 4 } });
|
|
37
|
+
if (!compiled.ok) throw compiled.error;
|
|
38
|
+
const names = compiled.value.inspect().passes.map((pass) => pass.name);
|
|
39
|
+
expect(names).toEqual([
|
|
40
|
+
'opaque',
|
|
41
|
+
'transmission-backdrop-copy',
|
|
42
|
+
'transmission-backdrop-mip',
|
|
43
|
+
'transmission-backdrop-mip-2',
|
|
44
|
+
'transmission-forward',
|
|
45
|
+
'transparent',
|
|
46
|
+
'temporal',
|
|
47
|
+
]);
|
|
48
|
+
expect(compiled.value.inspect().resources.map((resource) => resource.label)).toContain(
|
|
49
|
+
'transmission-backdrop',
|
|
50
|
+
);
|
|
51
|
+
return added.value;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
describe('TransmissionBackdrop Dawn topology', () => {
|
|
55
|
+
it('compiles the single rgba16float backdrop with one copy and raster mip', async () => {
|
|
56
|
+
const adapter = (await rhi.requestAdapter()).unwrap();
|
|
57
|
+
const device = (await adapter.requestDevice()).unwrap();
|
|
58
|
+
const result = await buildBackdrop(device);
|
|
59
|
+
|
|
60
|
+
expect(result.topology).toMatchObject({
|
|
61
|
+
active: true,
|
|
62
|
+
copyCount: 1,
|
|
63
|
+
mipCount: 1,
|
|
64
|
+
submitCount: 1,
|
|
65
|
+
aliasCount: 0,
|
|
66
|
+
});
|
|
67
|
+
});
|
|
68
|
+
|
|
69
|
+
it('does not allocate a backdrop on exact-zero demand', async () => {
|
|
70
|
+
const adapter = (await rhi.requestAdapter()).unwrap();
|
|
71
|
+
const device = (await adapter.requestDevice()).unwrap();
|
|
72
|
+
const graph = new RenderGraphBuilder<RenderPipelineFrame>();
|
|
73
|
+
const source = createRenderPipelineTarget(graph, 'opaque-resolved', {
|
|
74
|
+
format: 'rgba16float',
|
|
75
|
+
size: 'surface',
|
|
76
|
+
});
|
|
77
|
+
expect(source.ok).toBe(true);
|
|
78
|
+
if (!source.ok) return;
|
|
79
|
+
const added = addTransmissionBackdropPasses({
|
|
80
|
+
graph,
|
|
81
|
+
source: source.value,
|
|
82
|
+
demand: { activeCount: 0, needsRoughMips: false },
|
|
83
|
+
copySize: { width: 1, height: 1 },
|
|
84
|
+
});
|
|
85
|
+
expect(added).toEqual({
|
|
86
|
+
ok: true,
|
|
87
|
+
value: {
|
|
88
|
+
topology: {
|
|
89
|
+
active: false,
|
|
90
|
+
sourceSampleCount: 1,
|
|
91
|
+
copyCount: 0,
|
|
92
|
+
mipCount: 0,
|
|
93
|
+
submitCount: 1,
|
|
94
|
+
aliasCount: 0,
|
|
95
|
+
phases: [],
|
|
96
|
+
},
|
|
97
|
+
backdrop: undefined,
|
|
98
|
+
mipViews: [],
|
|
99
|
+
},
|
|
100
|
+
});
|
|
101
|
+
const compiled = graph.compile({ device, surfaceSize: { width: 1, height: 1 } });
|
|
102
|
+
expect(compiled.ok).toBe(true);
|
|
103
|
+
if (compiled.ok) expect(compiled.value.inspect().passes).toEqual([]);
|
|
104
|
+
});
|
|
105
|
+
});
|