@forgeax/engine-render 0.1.32 → 0.1.34

package/src/assembly/webgpu-pbr-ready.ts

@@ -15,6 +15,7 @@ import {
   buildGpuDrivenPbrPipelineLayout,
   buildGpuDrivenPbrSkinPipelineLayout,
   buildPbrSkinLayouts,
+  buildSurfaceDirectInstancesBindGroupLayout,
   type PbrPipelineLayoutBundle,
   SKIN_MATERIAL_SHADER_ID,
 } from '../pbr-pipeline';
@@ -43,6 +44,7 @@ export interface GpuDrivenPbrReadyLayouts {
   readonly gpuDrivenInstancesBindGroupLayout: BindGroupLayout | null;
   readonly gpuDrivenPbrPipelineLayout: PipelineLayout | null;
   readonly gpuDrivenPbrSkinPipelineLayout: PipelineLayout | null;
+  readonly surfaceDirectInstancesBindGroupLayout: BindGroupLayout | null;
 }
 
 interface GpuDrivenPbrModuleInput {
@@ -183,6 +185,7 @@ export function buildGpuDrivenPbrReadyLayouts(
   let gpuDrivenInstancesBindGroupLayout: BindGroupLayout | null = null;
   let gpuDrivenPbrPipelineLayout: PipelineLayout | null = null;
   let gpuDrivenPbrSkinPipelineLayout: PipelineLayout | null = null;
+  let surfaceDirectInstancesBindGroupLayout: BindGroupLayout | null = null;
   const skinResult = runShimSyncStep(
     () => ok(buildPbrSkinLayouts(device, { storageBuffer: storageBufferCapable }, pbrLayouts)),
     'webgpu-runtime-error',
@@ -200,6 +203,9 @@ export function buildGpuDrivenPbrReadyLayouts(
         const instances = buildGpuDrivenPbrInstancesBindGroupLayout(device, {
           storageBuffer: true,
         });
+        const surfaceDirect = buildSurfaceDirectInstancesBindGroupLayout(device, {
+          storageBuffer: true,
+        });
         const rigid = buildGpuDrivenPbrPipelineLayout(device, pbrLayouts, instances);
         const skin =
           pbrSkinMeshBindGroupLayout === null
@@ -209,7 +215,7 @@ export function buildGpuDrivenPbrReadyLayouts(
                 { ...pbrLayouts, meshArrayBgl: pbrSkinMeshBindGroupLayout },
                 instances,
               );
-        return ok({ instances, rigid, skin });
+        return ok({ instances, rigid, skin, surfaceDirect });
       },
       'webgpu-runtime-error',
       'build GPU-driven PBR pipeline layouts succeeded',
@@ -219,6 +225,7 @@ export function buildGpuDrivenPbrReadyLayouts(
       gpuDrivenInstancesBindGroupLayout = layoutResult.value.instances;
       gpuDrivenPbrPipelineLayout = layoutResult.value.rigid;
       gpuDrivenPbrSkinPipelineLayout = layoutResult.value.skin;
+      surfaceDirectInstancesBindGroupLayout = layoutResult.value.surfaceDirect;
     }
   }
   return {
@@ -228,5 +235,6 @@ export function buildGpuDrivenPbrReadyLayouts(
     gpuDrivenInstancesBindGroupLayout,
     gpuDrivenPbrPipelineLayout,
     gpuDrivenPbrSkinPipelineLayout,
+    surfaceDirectInstancesBindGroupLayout,
   };
 }

package/src/assembly/webgpu-ready-contract.ts

@@ -7,8 +7,13 @@ export const MIPMAP_PREWARM_FORMATS: readonly GPUTextureFormat[] = [
   'rgba8unorm',
   'rgba16float',
 ];
-export const BRIGHT_PARAMS_BYTES = 16;
-export const BLUR_PARAMS_BYTES = 16;
-export const COMPOSITE_PARAMS_BYTES = 16;
+// WebGPU requires every dynamic uniform-buffer binding offset to satisfy the
+// device's minimum uniform-buffer offset alignment.  Keep one shared buffer
+// per pass family, with the small POD payload at the start of each 256-byte
+// slice so every level remains a single production path.
+export const BLOOM_UNIFORM_PARAMS_STRIDE_BYTES = 256;
+export const BLOOM_DOWNSAMPLE_PARAMS_BYTES = 5 * BLOOM_UNIFORM_PARAMS_STRIDE_BYTES;
+export const BLOOM_UPSAMPLE_PARAMS_BYTES = 4 * BLOOM_UNIFORM_PARAMS_STRIDE_BYTES;
+export const BLOOM_COMPOSITE_PARAMS_BYTES = 16;
 export const HDR_COLOR_ATTACHMENT_FORMAT: GPUTextureFormat = 'rgba16float';
 export const DEPTH_TEXTURE_FORMAT: GPUTextureFormat = 'depth24plus-stencil8';

package/src/assembly/webgpu-ready-per-pass.ts

@@ -0,0 +1,104 @@
+import type { PerPassResources } from '../record/render-context';
+
+export interface ReadyPerPassResourceInputs {
+  readonly fxaaPipeline: PerPassResources['fxaaPipeline'];
+  readonly fxaaBindGroupLayout: PerPassResources['fxaaBindGroupLayout'];
+  readonly fxaaSampler: PerPassResources['fxaaSampler'];
+  readonly skyboxPipeline: PerPassResources['skyboxPipeline'];
+  readonly skyboxPipelineMsaa: PerPassResources['skyboxPipelineMsaa'];
+  readonly skyboxBindGroupLayout: PerPassResources['skyboxBindGroupLayout'];
+  readonly skyboxSampler: PerPassResources['skyboxSampler'];
+  readonly skyboxRotationBuffer: PerPassResources['skyboxRotationBuffer'];
+  readonly shadowSampler: PerPassResources['shadowSampler'];
+  readonly shadowLightSpaceMatrix: PerPassResources['shadowLightSpaceMatrix'];
+  readonly shadowCsmLightViewProj: PerPassResources['shadowCsmLightViewProj'];
+  readonly shadowCsmSelection: PerPassResources['shadowCsmSelection'];
+  readonly bloomDownsamplePipeline: PerPassResources['bloomDownsamplePipeline'];
+  readonly bloomUpsamplePipeline: PerPassResources['bloomUpsamplePipeline'];
+  readonly bloomCompositePipeline: PerPassResources['bloomCompositePipeline'];
+  readonly bloomDownsampleBindGroupLayout: PerPassResources['bloomDownsampleBindGroupLayout'];
+  readonly bloomUpsampleBindGroupLayout: PerPassResources['bloomUpsampleBindGroupLayout'];
+  readonly bloomCompositeBindGroupLayout: PerPassResources['bloomCompositeBindGroupLayout'];
+  readonly bloomSampler: PerPassResources['bloomSampler'];
+  readonly bloomDownsampleParamsBuffer: PerPassResources['bloomDownsampleParamsBuffer'];
+  readonly bloomUpsampleParamsBuffer: PerPassResources['bloomUpsampleParamsBuffer'];
+  readonly bloomCompositeParamsBuffer: PerPassResources['bloomCompositeParamsBuffer'];
+  readonly ensureBloomResources: NonNullable<PerPassResources['ensureBloomResources']>;
+  readonly getBloomResources: NonNullable<PerPassResources['getBloomResources']>;
+  readonly commitBloomResources: NonNullable<PerPassResources['commitBloomResources']>;
+  readonly commitBloomFrameReceipts: NonNullable<PerPassResources['commitBloomFrameReceipts']>;
+  readonly discardBloomResources: NonNullable<PerPassResources['discardBloomResources']>;
+  readonly retireBloomResources: NonNullable<PerPassResources['retireBloomResources']>;
+  readonly drainBloomResources: NonNullable<PerPassResources['drainBloomResources']>;
+  readonly inspectBloomResources: NonNullable<PerPassResources['inspectBloomResources']>;
+  readonly ssaoCalcPipeline: PerPassResources['ssaoCalcPipeline'];
+  readonly ssaoBlurPipeline: PerPassResources['ssaoBlurPipeline'];
+  readonly ssaoBgl: PerPassResources['ssaoBgl'];
+}
+
+/** Creates the mutable per-pass slots owned by one prepared device generation. */
+export function createReadyPerPassResources(input: ReadyPerPassResourceInputs): PerPassResources {
+  return {
+    depthTexture: null,
+    depthTextureView: null,
+    depthTextureWidth: 0,
+    depthTextureHeight: 0,
+    configured: false,
+    hdrColorTexture: null,
+    hdrColorView: null,
+    hdrDepthTexture: null,
+    hdrDepthView: null,
+    hdrTextureWidth: 0,
+    hdrTextureHeight: 0,
+    hdrDepthSampleCount: 1,
+    fxaaPipeline: input.fxaaPipeline,
+    fxaaBindGroupLayout: input.fxaaBindGroupLayout,
+    fxaaSampler: input.fxaaSampler,
+    msaaColorTexture: null,
+    msaaColorView: null,
+    msaaSpriteColorTexture: null,
+    msaaSpriteColorView: null,
+    msaaDepthTexture: null,
+    msaaDepthView: null,
+    msaaTextureWidth: 0,
+    msaaTextureHeight: 0,
+    hdrColorMsaaTexture: null,
+    hdrColorMsaaView: null,
+    skyboxPipeline: input.skyboxPipeline,
+    skyboxPipelineMsaa: input.skyboxPipelineMsaa,
+    skyboxBindGroupLayout: input.skyboxBindGroupLayout,
+    skyboxSampler: input.skyboxSampler,
+    skyboxRotationBuffer: input.skyboxRotationBuffer,
+    shadowTexture: null,
+    shadowMapSize: 0,
+    shadowCascadeCount: 0,
+    shadowSampler: input.shadowSampler,
+    shadowLightSpaceMatrix: input.shadowLightSpaceMatrix,
+    shadowCsmLightViewProj: input.shadowCsmLightViewProj,
+    shadowCsmSelection: input.shadowCsmSelection,
+    bloomDownsamplePipeline: input.bloomDownsamplePipeline,
+    bloomUpsamplePipeline: input.bloomUpsamplePipeline,
+    bloomCompositePipeline: input.bloomCompositePipeline,
+    bloomDownsampleBindGroupLayout: input.bloomDownsampleBindGroupLayout,
+    bloomUpsampleBindGroupLayout: input.bloomUpsampleBindGroupLayout,
+    bloomCompositeBindGroupLayout: input.bloomCompositeBindGroupLayout,
+    bloomSampler: input.bloomSampler,
+    bloomDownsampleParamsBuffer: input.bloomDownsampleParamsBuffer,
+    bloomUpsampleParamsBuffer: input.bloomUpsampleParamsBuffer,
+    bloomCompositeParamsBuffer: input.bloomCompositeParamsBuffer,
+    ensureBloomResources: input.ensureBloomResources,
+    getBloomResources: input.getBloomResources,
+    commitBloomResources: input.commitBloomResources,
+    commitBloomFrameReceipts: input.commitBloomFrameReceipts,
+    discardBloomResources: input.discardBloomResources,
+    retireBloomResources: input.retireBloomResources,
+    drainBloomResources: input.drainBloomResources,
+    inspectBloomResources: input.inspectBloomResources,
+    ssaoCalcPipeline: input.ssaoCalcPipeline,
+    ssaoBlurPipeline: input.ssaoBlurPipeline,
+    ssaoBgl: input.ssaoBgl,
+    ssaoFilteringSampler: null,
+    ssaoDepthSampler: null,
+    ssaoFallbackRawView: null,
+  };
+}