@aura3d/engine 4.3.7 → 4.5.0

package/dist/rendering/Renderer.js

@@ -36,6 +36,7 @@ import { prd11LiveQualityTier } from "./quality/liveTier.js";
 import { MaterialInstance } from "./MaterialInstance.js";
 import { featuresForGeometry, materialRoutesToGeneratedProgram } from "./program/MaterialFeatures.js";
 import { selectShaderFeatureBits } from "./program/FeatureSelect.js";
+import { PROGRAM_OUTPUT_SRGB_FEATURE } from "./program/ProgramFeatures.js";
 import { collectWarmupFeatures, ProgramWarmup } from "./program/ProgramWarmup.js";
 import { PRD03_EXPOSURE, rendererQrFlags, setRendererQrFlags, withRendererQrFlags } from "./renderer/FrameGraph.js";
 import { consumeTaaHistoryWritten } from "./renderer/postSkipped.js";
@@ -48,6 +49,7 @@ import { ensureSceneDepthCopyTarget, SceneDepthCopyPass } from "./renderer/Scene
 import { probeHdrTargetFormat, DEFAULT_TONE_MAPPING } from "./contracts/output.js";
 import { resolveForwardClusteredLighting } from "./forward/Lighting.js";
 import { assertRendererFeatures, createRendererFeatureReport } from "./RendererFeatureGates.js";
+import { armFirstFrameGate, notifyFirstFramePresented } from "./environment/FirstFrameGate.js";
 import { batchStaticRenderItems } from "./SceneOptimization.js";
 import { createStaticMeshConsolidationCache } from "./MeshConsolidation.js";
 /**
@@ -130,6 +132,10 @@ export class Renderer {
     get postSkipped() {
         return this.lastPostSkipped;
     }
+    /** False when this renderer's flags pin the HDR-target/OutputPass route off (the direct canvas path). */
+    get outputPathActive() {
+        return qrCoreOutputOn(rendererQrFlags(this.device));
+    }
     resolutionGovernor;
     renderScaleCeiling = 1;
     unsubscribeDprWatch;
@@ -139,6 +145,7 @@ export class Renderer {
     probeGraph;
     constructor(device, options, temporalHistory) {
         this.device = device;
+        armFirstFrameGate();
         if (options.qrFlags)
             setRendererQrFlags(options.qrFlags, device);
         this.temporalHistory = temporalHistory;
@@ -264,6 +271,7 @@ export class Renderer {
         const cameraViewProjection = resolvedCamera?.viewProjectionMatrix;
         const collected = collectRenderItemsWithDiagnostics(source, cameraViewProjection, resolvedCamera?.camera);
         const before = this.device.getDiagnostics().programCompileCount ?? 0;
+        this.warmOutputSrgb = this.frameOutputsSrgb(source);
         await this.warmGeneratedPrograms(collected.items, collectRenderLights(source), collectEnvironmentLighting(source), collectEnvironmentFog(source), collectForwardShadowMap(source), cameraViewProjection);
         const after = this.device.getDiagnostics().programCompileCount ?? before;
         return {
@@ -603,7 +611,8 @@ export class Renderer {
         const shadowOptions = collectRendererShadowOptions(source);
         // C-02/T0-06: sync-path warm — kick generated-program compiles for the
         // exact draw feature records before the pass runs (bounded per frame).
-        this.warmGeneratedProgramsSync(items, lights, environmentLighting, environmentFog, explicitShadowMap, cameraViewProjection);
+        this.warmOutputSrgb = this.frameOutputsSrgb(source);
+        // The warm itself runs after the shadow step below: with renderer-owned shadows the program key's shadow axis only exists once the map does.
         const sourceCameraPosition = collectSourceCameraPosition(source);
         const explicitRenderTarget = collectRenderTarget(source);
         validateExplicitRenderTarget(explicitRenderTarget);
@@ -719,7 +728,8 @@ export class Renderer {
                 ownedTargets,
                 ownedShadowPasses,
                 camera: resolvedCamera?.camera,
-                frameCamera: shadowFrameCamera(cameraViewProjection, cameraPosition)
+                frameCamera: shadowFrameCamera(cameraViewProjection, cameraPosition, resolvedCamera?.viewMatrix),
+                receivers: items
             })) ?? explicitShadowMap ?? this.executeRendererShadowMap({
                 shadowOptions,
                 source,
@@ -728,9 +738,13 @@ export class Renderer {
                 ownedTargets,
                 ownedShadowPasses,
                 camera: resolvedCamera?.camera,
-                frameCamera: shadowFrameCamera(cameraViewProjection, cameraPosition)
+                frameCamera: shadowFrameCamera(cameraViewProjection, cameraPosition, resolvedCamera?.viewMatrix),
+                receivers: items
             });
             frameHooks.addPasses(this.graph, "shadows", items);
+            // C-02/T0-06 sync-path warm, keyed on the shadow map this frame actually draws with (warming before it existed compiled no-shadow
+            // variants nothing draws: 2 dead programs on a one-material scene, 4 with a skinned model).
+            this.warmGeneratedProgramsSync(items, lights, environmentLighting, environmentFog, rendererShadowMap, cameraViewProjection);
             this.lastShadowEvidence = rendererShadowMap ? {
                 lightMatrix: Array.from(rendererShadowMap.lightMatrix),
                 cascades: rendererShadowMap.cascades?.map(c => ({ index: c.index, near: c.near, far: c.far, lightMatrix: Array.from(c.shadowMap.lightMatrix) })) ?? [],
@@ -935,6 +949,7 @@ export class Renderer {
             }
         }
         this.submittedFrames += 1;
+        notifyFirstFramePresented();
         this.submittedShadowFrameId += 1;
         if (this.lastShadowEvidence)
             this.lastShadowEvidence = { ...this.lastShadowEvidence, submissionFrameId: this.submittedShadowFrameId };
@@ -1002,6 +1017,7 @@ export class Renderer {
         const shadowOptions = collectRendererShadowOptions(source);
         // C-02 (PRD-01 §403): pre-render warm-then-block compile of the generated
         // programs this scene needs. Flag-off: nothing (sync path untouched).
+        this.warmOutputSrgb = this.frameOutputsSrgb(source);
         await this.warmGeneratedPrograms(items, lights, environmentLighting, environmentFog, explicitShadowMap, cameraViewProjection);
         if (this.disposed || this.device.disposed) {
             return withRendererFrameDiagnostics(this.device.getDiagnostics(), collectionDiagnostics);
@@ -1121,7 +1137,8 @@ export class Renderer {
                 ownedTargets,
                 ownedShadowPasses,
                 camera: resolvedCamera?.camera,
-                frameCamera: shadowFrameCamera(cameraViewProjection, cameraPosition)
+                frameCamera: shadowFrameCamera(cameraViewProjection, cameraPosition, resolvedCamera?.viewMatrix),
+                receivers: items
             })) ?? explicitShadowMap ?? this.executeRendererShadowMap({
                 shadowOptions,
                 source,
@@ -1130,7 +1147,8 @@ export class Renderer {
                 ownedTargets,
                 ownedShadowPasses,
                 camera: resolvedCamera?.camera,
-                frameCamera: shadowFrameCamera(cameraViewProjection, cameraPosition)
+                frameCamera: shadowFrameCamera(cameraViewProjection, cameraPosition, resolvedCamera?.viewMatrix),
+                receivers: items
             });
             frameHooks.addPasses(this.graph, "shadows", items);
             this.lastShadowEvidence = rendererShadowMap ? {
@@ -1345,6 +1363,7 @@ export class Renderer {
             }
         }
         this.submittedFrames += 1;
+        notifyFirstFramePresented();
         this.submittedShadowFrameId += 1;
         if (this.lastShadowEvidence)
             this.lastShadowEvidence = { ...this.lastShadowEvidence, submissionFrameId: this.submittedShadowFrameId };
@@ -1366,6 +1385,14 @@ export class Renderer {
      * generated-program materials need (lights/shadow/environment axes at the
      * current tier). Returns `materials: []` early when nothing generated.
      */
+    /**
+     * Whether the frame being warmed writes straight to the canvas (no postprocess, no OutputPass): its generated programs
+     * carry the sRGB-encode feature bit, so the warmed keys match the draw keys. Set right before each warm call.
+     */
+    warmOutputSrgb = false;
+    frameOutputsSrgb(source) {
+        return !collectPostprocess(source) && !qrCoreOutputOn(rendererQrFlags(this.device));
+    }
     collectWarmupInput(items, lights, environmentLighting, environmentFog, shadowMap, cameraViewProjection, flags, tier) {
         const ctx = { flags, tier: QUALITY_TIERS[tier] };
         // T0-05: one record per (material revision, selected feature bits) — the
@@ -1384,6 +1411,8 @@ export class Renderer {
             if (selected[PRD02_IBL_FEATURE] !== undefined && !prd02IblEnvironmentAvailable(environmentLighting, item)) {
                 delete selected[PRD02_IBL_FEATURE];
             }
+            if (this.warmOutputSrgb)
+                selected[PROGRAM_OUTPUT_SRGB_FEATURE] = true;
             // #867 (games): same geometry-driven feature mask ForwardPass applies.
             const attrs = item.geometry.vertexBuffer.format.attributes;
             const has = (name) => attrs.some((a) => a.semantic === name || a.shaderName === name);
@@ -1402,7 +1431,9 @@ export class Renderer {
             materials: [...records.values()],
             lights: [axes.lights],
             shadows: axes.shadows ? [axes.shadows] : [],
-            environments: [axes.environment]
+            environments: [axes.environment],
+            // Nothing draws a generated `pass: "depth"` program: shadow casters render through the PRD-02 depth shaders.
+            includeDepth: false
         };
     }
     async warmGeneratedPrograms(items, lights, environmentLighting, environmentFog, shadowMap, cameraViewProjection) {