@forgeax/engine-render 0.1.19 → 0.1.20

package/src/record/frame-snapshot.ts

@@ -63,7 +63,7 @@ import type { MaterialRenderState, RenderPipelineAsset } from '@forgeax/engine-t
 import type { MeshGpuHandles } from '../device/gpu-residency';
 import type { SkylightBindGroupResources } from '../ibl/skylight-bind-group';
 import type { InstanceBufferCacheEntry } from '../instance-buffer-cache';
-import type { CameraSnapshot } from '../render-contract';
+import type { CameraSnapshot, VolumetricFogFrameContext } from '../render-contract';
 import type { RenderPipeline as RenderPipelineDef, RenderPipelineFrame } from '../render-pipeline';
 import type {
   DispatchEntry,
@@ -73,6 +73,13 @@ import type {
   SpotLightSnapshot,
 } from '../render-system-extract';
 import type { ShadowAtlas } from '../shadow-atlas';
+import type {
+  TemporalFrame,
+  TemporalFrameInput,
+  TemporalFrameTransaction,
+} from '../temporal/frame';
+import type { VolumetricFogInspection } from '../volume/inspection';
+import type { VolumeTemporalSignature } from '../volume/temporal';
 
 /**
  * feat-20260608-create-app-param-surface-trim / M1 / D-8 (q8 user lock):
@@ -255,6 +262,12 @@ export interface RenderFrameState {
   graphGeneration: number;
   /** Number of successfully submitted TAA frames; failed attempts do not advance it. */
   successfulTemporalFrameIndex?: number;
+  /** The renderer-owned accepted-submit temporal fact consumed by consumers. */
+  temporalFrame?: TemporalFrame;
+  /** The sole transaction that advances temporal history after queue.submit. */
+  readonly temporalFrameTransaction: TemporalFrameTransaction;
+  /** Staged input is consumed only by the graph submit owner. */
+  temporalFrameInput: TemporalFrameInput | undefined;
   /** Optional graph resource lookup used by low-level record helpers and tests. */
   perFrameGraph?: {
     readonly getColorTargetDescriptor: (key: string) => ResolvedColorTargetDescriptor | undefined;
@@ -274,6 +287,33 @@ export interface RenderFrameState {
   /** The sole compiled owner for compute, copy, feature, and raster work. */
   compiledFrameGraph: CompiledRenderGraph<RenderPipelineFrame> | null;
   compiledFrameGraphTopologyKey: string | null;
+  /**
+   * Last-known-good graph held while a volume topology candidate is tested.
+   * The candidate is promoted only after its command buffer is submitted;
+   * failed encoding/finish/submit restores this graph and its topology key.
+   */
+  volumetricFogPreviousGraph: CompiledRenderGraph<RenderPipelineFrame> | null;
+  volumetricFogPreviousGraphKey: string | null;
+  volumetricFogCandidateGraph: CompiledRenderGraph<RenderPipelineFrame> | null;
+  /** Two renderer-owned parameter slots; only the pending slot is writable. */
+  volumetricFogParamsBuffers: [Buffer | null, Buffer | null];
+  /** Candidate parameter slot, promoted only after queue submission succeeds. */
+  volumetricFogParamsPendingSlot: 0 | 1 | null;
+  /** Parameter slot consumed by the last accepted volume frame. */
+  volumetricFogParamsAcceptedSlot: 0 | 1 | null;
+  /** CPU copy of the accepted parameter payload for degraded-frame staging. */
+  volumetricFogAcceptedParams: Float32Array | undefined;
+  /** CPU copy of the current candidate payload before submit. */
+  volumetricFogPendingParams: Float32Array | undefined;
+  /** Last candidate/accepted volume projection exposed through inspect(). */
+  volumetricFogInspection: VolumetricFogInspection;
+  /** Accepted volume POD/context retained while a later candidate degrades. */
+  volumetricFogAccepted: import('../render-system-extract').ExtractedVolumetricFog | undefined;
+  volumetricFogAcceptedContext: VolumetricFogFrameContext | undefined;
+  /** Accepted graph identity and ping-pong slot for temporal volume history. */
+  volumetricFogHistoryGraph: CompiledRenderGraph<RenderPipelineFrame> | null;
+  volumetricFogHistorySlot: 0 | 1 | null;
+  volumetricFogHistorySignature: VolumeTemporalSignature | null;
   readonly retiredCompiledFrameGraphs: Set<CompiledRenderGraph<RenderPipelineFrame>>;
   /** Physical outputs projected by typed graph passes for downstream observers. */
   currentFrameObservationSource: FrameObservationSource | undefined;

package/src/record/frame-targets.ts

@@ -1,6 +1,7 @@
 import type { RhiCanvasContext, Texture, TextureView } from '@forgeax/engine-rhi';
 import type { RenderGraphExecutionPhase } from '../render-contract';
 import type { ExtractedLights } from '../render-system-extract';
+import { resolveDirectionalShadowAtlasGrid } from '../typed-shadow-atlas';
 import { configureSurface, type PipelineState, type RenderSystemInternals } from './render-context';
 
 export function graphExecutionPhase(passName: string): RenderGraphExecutionPhase {
@@ -114,14 +115,17 @@ export function resolveShadowMapSize(
   const requested = lights.shadowMapSize;
   if (!(requested !== undefined && requested > 0)) return requested;
   const cascades = Math.max(1, Math.min(4, Math.round(lights.cascadeCount ?? 1)));
-  const tilesPerSide = Math.ceil(Math.sqrt(cascades));
+  const atlasGrid = resolveDirectionalShadowAtlasGrid(cascades);
   const maxDimension = internals.device.limits.maxTextureDimension2D;
   if (!(maxDimension > 0)) return Math.floor(requested);
   const depthTextureDimension =
     internals.device.caps?.backendKind === 'wgpu-webgl2'
       ? Math.max(1, Math.floor(maxDimension / 2))
       : maxDimension;
-  const maxPerTile = Math.max(1, Math.floor(depthTextureDimension / tilesPerSide));
+  const maxPerTile = Math.max(
+    1,
+    Math.floor(depthTextureDimension / Math.max(atlasGrid.columns, atlasGrid.rows)),
+  );
   return Math.max(1, Math.min(Math.floor(requested), maxPerTile));
 }