@certe/atmos-renderer 0.1.0

package/dist/terrain-mesh-renderer.js

@@ -0,0 +1,131 @@
+/**
+ * TerrainMeshRenderer: MeshRenderer variant for terrain splat-map rendering.
+ *
+ * Uses the terrain pipeline (40B vertex stride) and binds 3 splat textures
+ * instead of the standard PBR albedo/normal/MR textures.
+ */
+import { Component } from '@certe/atmos-core';
+import { Mat4 } from '@certe/atmos-math';
+import { writeMaterialUniforms, MATERIAL_UNIFORM_SIZE } from './material.js';
+import { getWhiteFallbackTexture } from './texture.js';
+const OBJECT_UNIFORM_SIZE = 192;
+export class TerrainMeshRenderer extends Component {
+    mesh = null;
+    material = null;
+    castShadow = true;
+    receiveSSAO = false;
+    splatTextures = null;
+    uniformBuffer = null;
+    bindGroup = null;
+    materialBindGroup = null;
+    _device = null;
+    _terrainPipeline = null;
+    _mvp = Mat4.create();
+    _invModel = Mat4.create();
+    _normalMat = Mat4.create();
+    _matData = new Float32Array(MATERIAL_UNIFORM_SIZE / 4);
+    _worldBoundsCenter = new Float32Array(3);
+    _worldBounds = { center: this._worldBoundsCenter, radius: 0 };
+    init(device, terrainPipeline, mesh, material, splatTextures) {
+        this._device = device;
+        this._terrainPipeline = terrainPipeline;
+        this.mesh = mesh;
+        this.material = material ?? null;
+        this.splatTextures = splatTextures ?? null;
+        this.uniformBuffer = device.createBuffer({
+            size: OBJECT_UNIFORM_SIZE,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        this.bindGroup = device.createBindGroup({
+            layout: terrainPipeline.objectBindGroupLayout,
+            entries: [
+                { binding: 0, resource: { buffer: this.uniformBuffer } },
+            ],
+        });
+    }
+    initMaterialBindGroup(sceneBuffer) {
+        if (!this._device || !this._terrainPipeline || !this.material)
+            return;
+        if (this.materialBindGroup)
+            return;
+        if (!this.material.uniformBuffer) {
+            this.material.uniformBuffer = this._device.createBuffer({
+                size: MATERIAL_UNIFORM_SIZE,
+                usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            });
+            this.material.dirty = true;
+        }
+        const fallback = getWhiteFallbackTexture(this._device);
+        const t0 = this.splatTextures?.[0] ?? fallback;
+        const t1 = this.splatTextures?.[1] ?? fallback;
+        const t2 = this.splatTextures?.[2] ?? fallback;
+        this.materialBindGroup = this._device.createBindGroup({
+            layout: this._terrainPipeline.materialBindGroupLayout,
+            entries: [
+                { binding: 0, resource: { buffer: this.material.uniformBuffer } },
+                { binding: 1, resource: { buffer: sceneBuffer } },
+                { binding: 2, resource: t0.view },
+                { binding: 3, resource: t1.view },
+                { binding: 4, resource: t2.view },
+                { binding: 5, resource: t0.sampler },
+            ],
+        });
+    }
+    writeUniforms(viewProjection) {
+        if (!this._device || !this.uniformBuffer)
+            return;
+        const model = this.gameObject.transform.worldMatrix;
+        Mat4.multiply(this._mvp, viewProjection, model);
+        Mat4.invert(this._invModel, model);
+        Mat4.transpose(this._normalMat, this._invModel);
+        this._device.queue.writeBuffer(this.uniformBuffer, 0, this._mvp);
+        this._device.queue.writeBuffer(this.uniformBuffer, 64, model);
+        this._device.queue.writeBuffer(this.uniformBuffer, 128, this._normalMat);
+        if (this.material?.dirty && this.material.uniformBuffer) {
+            writeMaterialUniforms(this._matData, this.material);
+            this._device.queue.writeBuffer(this.material.uniformBuffer, 0, this._matData);
+            this.material.dirty = false;
+        }
+    }
+    draw(pass) {
+        if (!this.mesh || !this.bindGroup || !this._terrainPipeline || !this.materialBindGroup)
+            return;
+        pass.setPipeline(this._terrainPipeline.pipeline);
+        pass.setBindGroup(0, this.bindGroup);
+        pass.setBindGroup(1, this.materialBindGroup);
+        pass.setVertexBuffer(0, this.mesh.vertexBuffer);
+        pass.setIndexBuffer(this.mesh.indexBuffer, this.mesh.indexFormat);
+        pass.drawIndexed(this.mesh.indexCount);
+    }
+    get worldBoundingSphere() {
+        const bounds = this.mesh?.bounds;
+        if (!bounds)
+            return null;
+        const model = this.gameObject.transform.worldMatrix;
+        const cx = bounds.center[0];
+        const cy = bounds.center[1];
+        const cz = bounds.center[2];
+        this._worldBoundsCenter[0] = model[0] * cx + model[4] * cy + model[8] * cz + model[12];
+        this._worldBoundsCenter[1] = model[1] * cx + model[5] * cy + model[9] * cz + model[13];
+        this._worldBoundsCenter[2] = model[2] * cx + model[6] * cy + model[10] * cz + model[14];
+        const sx = Math.sqrt(model[0] * model[0] + model[1] * model[1] + model[2] * model[2]);
+        const sy = Math.sqrt(model[4] * model[4] + model[5] * model[5] + model[6] * model[6]);
+        const sz = Math.sqrt(model[8] * model[8] + model[9] * model[9] + model[10] * model[10]);
+        this._worldBounds.radius = bounds.radius * Math.max(sx, sy, sz);
+        return this._worldBounds;
+    }
+    onDestroy() {
+        this.uniformBuffer?.destroy();
+        this.uniformBuffer = null;
+        this.bindGroup = null;
+        this.materialBindGroup = null;
+    }
+    destroyMesh() {
+        if (this.mesh) {
+            this.mesh.vertexBuffer.destroy();
+            this.mesh.indexBuffer.destroy();
+            this.mesh = null;
+        }
+    }
+}
+//# sourceMappingURL=terrain-mesh-renderer.js.map

package/dist/terrain-mesh-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-mesh-renderer.js","sourceRoot":"","sources":["../src/terrain-mesh-renderer.ts"],"names":[],"mappings":"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"}

package/dist/terrain-pipeline.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Terrain splat-map render pipeline.
+ *
+ * Vertex format 40B: pos(3) + normal(3) + uv(2) + splatWeights(2) = 10 floats.
+ * Material bind group carries 3 splat textures + shared sampler instead of
+ * normal/MR maps used by the standard PBR pipeline.
+ */
+export declare const TERRAIN_VERTEX_STRIDE_FLOATS = 10;
+export declare const TERRAIN_VERTEX_STRIDE_BYTES = 40;
+export interface TerrainPipelineResources {
+    pipeline: GPURenderPipeline;
+    objectBindGroupLayout: GPUBindGroupLayout;
+    materialBindGroupLayout: GPUBindGroupLayout;
+    shadowBindGroupLayout: GPUBindGroupLayout;
+}
+export declare function createTerrainPipeline(device: GPUDevice, _format: GPUTextureFormat): TerrainPipelineResources;
+//# sourceMappingURL=terrain-pipeline.d.ts.map

package/dist/terrain-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-pipeline.d.ts","sourceRoot":"","sources":["../src/terrain-pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,qBAAqB,EAAE,kBAAkB,CAAC;IAC1C,uBAAuB,EAAE,kBAAkB,CAAC;IAC5C,qBAAqB,EAAE,kBAAkB,CAAC;CAC3C;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,gBAAgB,GACxB,wBAAwB,CA8D1B"}

package/dist/terrain-pipeline.js

@@ -0,0 +1,70 @@
+/**
+ * Terrain splat-map render pipeline.
+ *
+ * Vertex format 40B: pos(3) + normal(3) + uv(2) + splatWeights(2) = 10 floats.
+ * Material bind group carries 3 splat textures + shared sampler instead of
+ * normal/MR maps used by the standard PBR pipeline.
+ */
+import { TERRAIN_VERTEX_SHADER, TERRAIN_FRAGMENT_SHADER } from './terrain-shader.js';
+import { createShadowBindGroupLayout } from './shadow-uniforms.js';
+import { HDR_FORMAT, MSAA_SAMPLE_COUNT } from './pipeline.js';
+export const TERRAIN_VERTEX_STRIDE_FLOATS = 10;
+export const TERRAIN_VERTEX_STRIDE_BYTES = 40;
+export function createTerrainPipeline(device, _format) {
+    const vertexModule = device.createShaderModule({ code: TERRAIN_VERTEX_SHADER });
+    const fragmentModule = device.createShaderModule({ code: TERRAIN_FRAGMENT_SHADER });
+    // Group 0: per-object uniforms (MVP + model + normalMatrix) – vertex stage
+    const objectBindGroupLayout = device.createBindGroupLayout({
+        entries: [
+            { binding: 0, visibility: GPUShaderStage.VERTEX, buffer: { type: 'uniform' } },
+        ],
+    });
+    // Group 1: material UBO + scene UBO + 3 splat textures + sampler
+    const materialBindGroupLayout = device.createBindGroupLayout({
+        entries: [
+            { binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'uniform' } },
+            { binding: 1, visibility: GPUShaderStage.FRAGMENT, buffer: { type: 'uniform' } },
+            { binding: 2, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+            { binding: 3, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+            { binding: 4, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: 'float' } },
+            { binding: 5, visibility: GPUShaderStage.FRAGMENT, sampler: { type: 'filtering' } },
+        ],
+    });
+    const shadowBindGroupLayout = createShadowBindGroupLayout(device);
+    const pipelineLayout = device.createPipelineLayout({
+        bindGroupLayouts: [objectBindGroupLayout, materialBindGroupLayout, shadowBindGroupLayout],
+    });
+    const pipeline = device.createRenderPipeline({
+        layout: pipelineLayout,
+        vertex: {
+            module: vertexModule,
+            entryPoint: 'main',
+            buffers: [{
+                    arrayStride: TERRAIN_VERTEX_STRIDE_BYTES,
+                    attributes: [
+                        { shaderLocation: 0, offset: 0, format: 'float32x3' }, // position
+                        { shaderLocation: 1, offset: 12, format: 'float32x3' }, // normal
+                        { shaderLocation: 2, offset: 24, format: 'float32x2' }, // uv
+                        { shaderLocation: 3, offset: 32, format: 'float32x2' }, // splatWeights
+                    ],
+                }],
+        },
+        fragment: {
+            module: fragmentModule,
+            entryPoint: 'main',
+            targets: [{ format: HDR_FORMAT }],
+        },
+        multisample: { count: MSAA_SAMPLE_COUNT },
+        primitive: {
+            topology: 'triangle-list',
+            cullMode: 'back',
+        },
+        depthStencil: {
+            depthWriteEnabled: true,
+            depthCompare: 'less',
+            format: 'depth24plus',
+        },
+    });
+    return { pipeline, objectBindGroupLayout, materialBindGroupLayout, shadowBindGroupLayout };
+}
+//# sourceMappingURL=terrain-pipeline.js.map

package/dist/terrain-pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-pipeline.js","sourceRoot":"","sources":["../src/terrain-pipeline.ts"],"names":[],"mappings":"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"}

package/dist/terrain-shader.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Terrain splat-map shader: PBR lighting with 3-texture blending.
+ *
+ * Vertex format 40B: pos(3) + normal(3) + uv(2) + splatWeights(2) = 10 floats.
+ * Fragment blends 3 albedo textures using per-vertex splat weights:
+ *   w0 = grass, w1 = rock, w2 = 1 - w0 - w1 (snow/dirt).
+ */
+export declare const TERRAIN_VERTEX_SHADER = "\nstruct ObjectUniforms {\n  mvp: mat4x4<f32>,\n  model: mat4x4<f32>,\n  normalMatrix: mat4x4<f32>,\n};\n\n@group(0) @binding(0) var<uniform> object: ObjectUniforms;\n\nstruct VertexInput {\n  @location(0) position: vec3<f32>,\n  @location(1) normal: vec3<f32>,\n  @location(2) uv: vec2<f32>,\n  @location(3) splatWeights: vec2<f32>,\n};\n\nstruct VertexOutput {\n  @builtin(position) clipPosition: vec4<f32>,\n  @location(0) worldPosition: vec3<f32>,\n  @location(1) worldNormal: vec3<f32>,\n  @location(2) uv: vec2<f32>,\n  @location(3) splatWeights: vec2<f32>,\n};\n\n@vertex\nfn main(input: VertexInput) -> VertexOutput {\n  var output: VertexOutput;\n  let worldPos = object.model * vec4<f32>(input.position, 1.0);\n  output.clipPosition = object.mvp * vec4<f32>(input.position, 1.0);\n  output.worldPosition = worldPos.xyz;\n  output.worldNormal = (object.normalMatrix * vec4<f32>(input.normal, 0.0)).xyz;\n  output.uv = input.uv;\n  output.splatWeights = input.splatWeights;\n  return output;\n}\n";
+export declare const TERRAIN_FRAGMENT_SHADER: string;
+//# sourceMappingURL=terrain-shader.d.ts.map

package/dist/terrain-shader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-shader.d.ts","sourceRoot":"","sources":["../src/terrain-shader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,eAAO,MAAM,qBAAqB,i/BAmCjC,CAAC;AAEF,eAAO,MAAM,uBAAuB,QA2GnC,CAAC"}

package/dist/terrain-shader.js

@@ -0,0 +1,154 @@
+/**
+ * Terrain splat-map shader: PBR lighting with 3-texture blending.
+ *
+ * Vertex format 40B: pos(3) + normal(3) + uv(2) + splatWeights(2) = 10 floats.
+ * Fragment blends 3 albedo textures using per-vertex splat weights:
+ *   w0 = grass, w1 = rock, w2 = 1 - w0 - w1 (snow/dirt).
+ */
+import { SHADOW_FRAGMENT_WGSL } from './shadow-fragment-wgsl.js';
+import { PBR_FUNCTIONS_WGSL, LIGHT_LOOP_WGSL, FOG_WGSL } from './pbr-wgsl.js';
+export const TERRAIN_VERTEX_SHADER = /* wgsl */ `
+struct ObjectUniforms {
+  mvp: mat4x4<f32>,
+  model: mat4x4<f32>,
+  normalMatrix: mat4x4<f32>,
+};
+
+@group(0) @binding(0) var<uniform> object: ObjectUniforms;
+
+struct VertexInput {
+  @location(0) position: vec3<f32>,
+  @location(1) normal: vec3<f32>,
+  @location(2) uv: vec2<f32>,
+  @location(3) splatWeights: vec2<f32>,
+};
+
+struct VertexOutput {
+  @builtin(position) clipPosition: vec4<f32>,
+  @location(0) worldPosition: vec3<f32>,
+  @location(1) worldNormal: vec3<f32>,
+  @location(2) uv: vec2<f32>,
+  @location(3) splatWeights: vec2<f32>,
+};
+
+@vertex
+fn main(input: VertexInput) -> VertexOutput {
+  var output: VertexOutput;
+  let worldPos = object.model * vec4<f32>(input.position, 1.0);
+  output.clipPosition = object.mvp * vec4<f32>(input.position, 1.0);
+  output.worldPosition = worldPos.xyz;
+  output.worldNormal = (object.normalMatrix * vec4<f32>(input.normal, 0.0)).xyz;
+  output.uv = input.uv;
+  output.splatWeights = input.splatWeights;
+  return output;
+}
+`;
+export const TERRAIN_FRAGMENT_SHADER = /* wgsl */ `
+const PI: f32 = 3.14159265359;
+const MAX_DIR_LIGHTS: u32 = 4u;
+const MAX_POINT_LIGHTS: u32 = 4u;
+const MAX_SPOT_LIGHTS: u32 = 4u;
+
+struct MaterialUniforms {
+  albedo: vec4<f32>,
+  metallic: f32,
+  roughness: f32,
+  splatSharpness: f32,
+  _pad1: f32,
+  emissive: vec4<f32>,
+  texTiling: vec2<f32>,
+  _pad2: vec2<f32>,
+};
+
+struct DirLight {
+  direction: vec4<f32>,
+  color: vec4<f32>,
+};
+
+struct PointLight {
+  position: vec4<f32>,
+  color: vec4<f32>,
+};
+
+struct SpotLight {
+  position: vec4<f32>,
+  direction: vec4<f32>,
+  color: vec4<f32>,
+  extra: vec4<f32>,
+};
+
+struct SceneUniforms {
+  cameraPos: vec4<f32>,
+  numDirLights: u32,
+  numPointLights: u32,
+  numSpotLights: u32,
+  _pad1: u32,
+  dirLights: array<DirLight, 4>,
+  pointLights: array<PointLight, 4>,
+  spotLights: array<SpotLight, 4>,
+  fogEnabled: u32,
+  fogMode: u32,
+  fogDensity: f32,
+  fogStart: f32,
+  fogEnd: f32,
+  _fogPad: f32,
+  fogColor: vec4<f32>,
+};
+
+@group(1) @binding(0) var<uniform> material: MaterialUniforms;
+@group(1) @binding(1) var<uniform> scene: SceneUniforms;
+@group(1) @binding(2) var splatTex0: texture_2d<f32>;
+@group(1) @binding(3) var splatTex1: texture_2d<f32>;
+@group(1) @binding(4) var splatTex2: texture_2d<f32>;
+@group(1) @binding(5) var splatSampler: sampler;
+
+` + SHADOW_FRAGMENT_WGSL + PBR_FUNCTIONS_WGSL + /* wgsl */ `
+
+struct FragmentInput {
+  @location(0) worldPosition: vec3<f32>,
+  @location(1) worldNormal: vec3<f32>,
+  @location(2) uv: vec2<f32>,
+  @location(3) splatWeights: vec2<f32>,
+};
+
+@fragment
+fn main(input: FragmentInput) -> @location(0) vec4<f32> {
+  // Blend 3 splat textures with sharpening
+  let uv = input.uv * material.texTiling;
+  let c0 = textureSample(splatTex0, splatSampler, uv);
+  let c1 = textureSample(splatTex1, splatSampler, uv);
+  let c2 = textureSample(splatTex2, splatSampler, uv);
+  let rw0 = max(input.splatWeights.x, 0.0);
+  let rw1 = max(input.splatWeights.y, 0.0);
+  let rw2 = max(1.0 - rw0 - rw1, 0.0);
+  // Sharpen: raise weights to power, then renormalize
+  let sharpness = max(material.splatSharpness, 1.0);
+  let sw0 = pow(rw0, sharpness);
+  let sw1 = pow(rw1, sharpness);
+  let sw2 = pow(rw2, sharpness);
+  let wSum = sw0 + sw1 + sw2 + 0.0001;
+  let w0 = sw0 / wSum;
+  let w1 = sw1 / wSum;
+  let w2 = sw2 / wSum;
+  let texColor = c0 * w0 + c1 * w1 + c2 * w2;
+  let albedo = material.albedo.rgb * texColor.rgb;
+
+  let metallic = material.metallic;
+  let roughness = material.roughness;
+  let N = normalize(input.worldNormal);
+  let V = normalize(scene.cameraPos.xyz - input.worldPosition);
+  let F0 = mix(vec3<f32>(0.04), albedo, metallic);
+  let worldPosition = input.worldPosition;
+
+  var Lo = vec3<f32>(0.0);
+` + LIGHT_LOOP_WGSL + /* wgsl */ `
+  let ambient = vec3<f32>(0.03) * albedo;
+  var color = ambient + Lo;
+  color = color + material.emissive.rgb * material.emissive.w;
+
+` + FOG_WGSL + /* wgsl */ `
+
+  return vec4<f32>(color, material.albedo.a);
+}
+`;
+//# sourceMappingURL=terrain-shader.js.map

package/dist/terrain-shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terrain-shader.js","sourceRoot":"","sources":["../src/terrain-shader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmC9C,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DhD,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,UAAU,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCzD,GAAG,eAAe,GAAG,UAAU,CAAA;;;;;CAK/B,GAAG,QAAQ,GAAG,UAAU,CAAA;;;;CAIxB,CAAC"}

package/dist/texture.d.ts

@@ -0,0 +1,20 @@
+export interface GPUTextureHandle {
+    texture: GPUTexture;
+    view: GPUTextureView;
+    sampler: GPUSampler;
+}
+/** Returns a cached 1x1 white texture (avoids needing separate pipeline variants). */
+export declare function getWhiteFallbackTexture(device: GPUDevice): GPUTextureHandle;
+/** Create a GPU texture from raw RGBA pixel data with auto-generated mipmaps. */
+export declare function createTextureFromRGBA(device: GPUDevice, data: Uint8Array, width: number, height: number): GPUTextureHandle;
+/** Returns a cached 1x1 flat normal texture (127,127,255,255 = tangent-space up). */
+export declare function getFlatNormalFallback(device: GPUDevice): GPUTextureHandle;
+/** Returns a cached 1x1 white metallic-roughness fallback (uniform values override). */
+export declare function getDefaultMetallicRoughnessFallback(device: GPUDevice): GPUTextureHandle;
+/** Decode an image blob to RGBA pixel data using createImageBitmap. */
+export declare function decodeImageToRGBA(blob: Blob): Promise<{
+    data: Uint8Array;
+    width: number;
+    height: number;
+}>;
+//# sourceMappingURL=texture.d.ts.map

package/dist/texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture.d.ts","sourceRoot":"","sources":["../src/texture.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,UAAU,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,UAAU,CAAC;CACrB;AAID,sFAAsF;AACtF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAuB3E;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,UAAU,EAChB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,gBAAgB,CAwBlB;AAID,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAkBzE;AAID,wFAAwF;AACxF,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAmBvF;AAED,uEAAuE;AACvE,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,IAAI,GACT,OAAO,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAW9D"}

package/dist/texture.js

@@ -0,0 +1,87 @@
+import { generateMipmaps } from './mipmap-generator.js';
+let _whiteFallback = null;
+/** Returns a cached 1x1 white texture (avoids needing separate pipeline variants). */
+export function getWhiteFallbackTexture(device) {
+    if (_whiteFallback)
+        return _whiteFallback;
+    const texture = device.createTexture({
+        size: [1, 1],
+        format: 'rgba8unorm',
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST,
+    });
+    device.queue.writeTexture({ texture }, new Uint8Array([255, 255, 255, 255]), { bytesPerRow: 4 }, [1, 1]);
+    const view = texture.createView();
+    const sampler = device.createSampler({
+        magFilter: 'linear',
+        minFilter: 'linear',
+        mipmapFilter: 'linear',
+    });
+    _whiteFallback = { texture, view, sampler };
+    return _whiteFallback;
+}
+/** Create a GPU texture from raw RGBA pixel data with auto-generated mipmaps. */
+export function createTextureFromRGBA(device, data, width, height) {
+    const mipLevelCount = Math.floor(Math.log2(Math.max(width, height))) + 1;
+    const texture = device.createTexture({
+        size: [width, height],
+        format: 'rgba8unorm',
+        mipLevelCount,
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT,
+    });
+    device.queue.writeTexture({ texture }, data, { bytesPerRow: width * 4 }, [width, height]);
+    generateMipmaps(device, texture);
+    const view = texture.createView();
+    const sampler = device.createSampler({
+        magFilter: 'linear',
+        minFilter: 'linear',
+        mipmapFilter: 'linear',
+        addressModeU: 'repeat',
+        addressModeV: 'repeat',
+    });
+    return { texture, view, sampler };
+}
+let _flatNormalFallback = null;
+/** Returns a cached 1x1 flat normal texture (127,127,255,255 = tangent-space up). */
+export function getFlatNormalFallback(device) {
+    if (_flatNormalFallback)
+        return _flatNormalFallback;
+    const texture = device.createTexture({
+        size: [1, 1],
+        format: 'rgba8unorm',
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST,
+    });
+    device.queue.writeTexture({ texture }, new Uint8Array([127, 127, 255, 255]), { bytesPerRow: 4 }, [1, 1]);
+    const view = texture.createView();
+    const sampler = device.createSampler({ magFilter: 'linear', minFilter: 'linear' });
+    _flatNormalFallback = { texture, view, sampler };
+    return _flatNormalFallback;
+}
+let _defaultMRFallback = null;
+/** Returns a cached 1x1 white metallic-roughness fallback (uniform values override). */
+export function getDefaultMetallicRoughnessFallback(device) {
+    if (_defaultMRFallback)
+        return _defaultMRFallback;
+    const texture = device.createTexture({
+        size: [1, 1],
+        format: 'rgba8unorm',
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST,
+    });
+    // G=255 (roughness=1.0), B=255 (metallic=1.0) – multiplied by uniform values
+    device.queue.writeTexture({ texture }, new Uint8Array([255, 255, 255, 255]), { bytesPerRow: 4 }, [1, 1]);
+    const view = texture.createView();
+    const sampler = device.createSampler({ magFilter: 'linear', minFilter: 'linear' });
+    _defaultMRFallback = { texture, view, sampler };
+    return _defaultMRFallback;
+}
+/** Decode an image blob to RGBA pixel data using createImageBitmap. */
+export async function decodeImageToRGBA(blob) {
+    const bitmap = await createImageBitmap(blob);
+    const { width, height } = bitmap;
+    const canvas = new OffscreenCanvas(width, height);
+    const ctx = canvas.getContext('2d');
+    ctx.drawImage(bitmap, 0, 0);
+    bitmap.close();
+    const imageData = ctx.getImageData(0, 0, width, height);
+    return { data: new Uint8Array(imageData.data.buffer), width, height };
+}
+//# sourceMappingURL=texture.js.map

package/dist/texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture.js","sourceRoot":"","sources":["../src/texture.ts"],"names":[],"mappings":"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"}

package/dist/tonemap-pass.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tonemapping post-process pass.
+ * Reads HDR scene + bloom + SSAO textures. Applies:
+ *   1. SSAO (multiply AO into scene)
+ *   2. Exposure adjustment
+ *   3. ACES filmic tonemapping
+ *   4. Gamma correction
+ *   5. Vignette
+ * Outputs to the swapchain (rgba8unorm).
+ */
+export declare class TonemapPass {
+    private readonly _device;
+    private readonly _pipeline;
+    private readonly _bgl;
+    private readonly _sampler;
+    private readonly _paramsBuffer;
+    private readonly _paramsData;
+    constructor(device: GPUDevice, outputFormat: GPUTextureFormat);
+    execute(encoder: GPUCommandEncoder, hdrView: GPUTextureView, bloomView: GPUTextureView, aoView: GPUTextureView, outputView: GPUTextureView, bloomIntensity: number, exposure: number, vignetteIntensity: number, vignetteRadius: number): void;
+    destroy(): void;
+}
+//# sourceMappingURL=tonemap-pass.d.ts.map

package/dist/tonemap-pass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tonemap-pass.d.ts","sourceRoot":"","sources":["../src/tonemap-pass.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmDH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAY;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAC9C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAY;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;gBAEvC,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB;IAgC7D,OAAO,CACL,OAAO,EAAE,iBAAiB,EAC1B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,cAAc,EACzB,MAAM,EAAE,cAAc,EACtB,UAAU,EAAE,cAAc,EAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,GACrB,IAAI;IAgCP,OAAO,IAAI,IAAI;CAGhB"}