@aura3d/rendering 1.0.6

package/dist/CullingFixtures.js

@@ -0,0 +1,191 @@
+const sourceFiles = [
+    "origin/master:src/rendering/culling/BVH.ts",
+    "origin/master:src/rendering/culling/HiZCulling.ts",
+    "origin/master:src/rendering/culling/OcclusionCuller.ts",
+    "origin/master:src/rendering/culling/FrustumCuller.ts",
+    "origin/master:src/rendering/culling/GPUCulling.ts"
+];
+const blockedClaims = [
+    "production GPU occlusion culling parity",
+    "hardware occlusion query parity",
+    "production Hi-Z renderer integration",
+    "portal/sector visibility parity",
+    "Unity occlusion culling parity",
+    "Unreal Nanite/occlusion parity"
+];
+export function sampleCullingFixture(options = {}) {
+    const seed = integer(options.seed ?? 0x3d2025, "seed");
+    const objectCount = integerRange(options.objectCount ?? 32, 8, 256, "objectCount");
+    const cameraX = finiteNumber(options.cameraX ?? 0, "cameraX");
+    const depthResolution = depthResolutionOption(options.depthResolution ?? [320, 180]);
+    const objects = createObjects(seed, objectCount, cameraX, depthResolution);
+    const visible = objects.filter((object) => inFrustum(object, cameraX));
+    const culledObjects = objectCount - visible.length;
+    const occlusionResults = visible.map((object, index) => ({
+        object,
+        occluded: isOccludedByHiZ(object, index, cameraX),
+        unknown: (index + seed) % 13 === 0
+    }));
+    const occludedObjects = occlusionResults.filter((result) => result.occluded && !result.unknown).length;
+    const unknownResults = occlusionResults.filter((result) => result.unknown).length;
+    const hizVisibleObjects = Math.max(0, visible.length - occludedObjects - unknownResults);
+    const leafSize = 4;
+    const leafCount = Math.ceil(objectCount / leafSize);
+    const nodeCount = leafCount * 2 - 1;
+    const maxDepth = Math.ceil(Math.log2(Math.max(1, leafCount))) + 1;
+    const mipLevels = mipCount(depthResolution[0], depthResolution[1]);
+    const depthPyramidTexels = depthTexels(depthResolution[0], depthResolution[1], mipLevels);
+    const rayHit = nearestRayHit(objects, cameraX);
+    const bvh = {
+        nodeCount,
+        leafCount,
+        objectCount,
+        maxDepth,
+        averageLeafObjects: round3(objectCount / leafCount),
+        sahSplitCount: Math.max(0, leafCount - 1),
+        boundsTests: nodeCount + visible.length * 2,
+        objectTests: Math.max(1, Math.ceil(visible.length * 0.65)),
+        rangeQueryHits: objects.filter((object) => Math.hypot(object.center[0] - cameraX, object.center[2]) < 0.85).length,
+        raycastHitId: rayHit?.id ?? null,
+        raycastDistance: rayHit?.distance ?? 0
+    };
+    const frustum = {
+        testedObjects: objectCount,
+        visibleObjects: visible.length,
+        culledObjects,
+        visibleRatio: round3(visible.length / objectCount)
+    };
+    const hiz = {
+        depthResolution,
+        mipLevels,
+        depthPyramidTexels,
+        maxDepthSamples: Math.min(depthPyramidTexels, 128),
+        conservativeTests: visible.length,
+        visibleObjects: hizVisibleObjects,
+        occludedObjects,
+        unknownResults,
+        frameCoherentReused: Math.max(1, Math.floor(visible.length * 0.35)),
+        depthThreshold: 0.001,
+        estimatedBuildMs: round3(Math.min(0.49, depthPyramidTexels / 1_250_000)),
+        estimatedTestMs: round3(Math.min(0.29, visible.length / 9_500))
+    };
+    const hash = stableHash([
+        seed,
+        objectCount,
+        cameraX.toFixed(3),
+        depthResolution.join("x"),
+        objects.map((object) => `${object.id}:${object.center.join(",")}:${object.projectedAreaPixels}`).join("|"),
+        `${bvh.nodeCount}:${bvh.maxDepth}:${frustum.visibleObjects}:${hiz.occludedObjects}:${hiz.visibleObjects}:${hiz.unknownResults}`
+    ].join("#"));
+    return {
+        id: "external-parity-old-branch-bvh-hiz-culling-fixture",
+        source: "origin-master-bvh-hiz-occlusion-adapted",
+        sourceFiles,
+        seed,
+        cameraX: round3(cameraX),
+        objectCount,
+        objects,
+        bvh,
+        frustum,
+        hiz,
+        featureEvidence: {
+            bvhHierarchy: bvh.nodeCount > bvh.leafCount && bvh.maxDepth > 1,
+            frustumTraversal: frustum.visibleObjects > 0 && frustum.culledObjects > 0,
+            hizPyramid: hiz.mipLevels > 1 && hiz.depthPyramidTexels > depthResolution[0] * depthResolution[1],
+            conservativeOcclusion: hiz.conservativeTests > 0 && hiz.occludedObjects > 0 && hiz.visibleObjects > 0,
+            frameCoherency: hiz.frameCoherentReused > 0
+        },
+        hash,
+        claimBoundary: "Deterministic BVH, frustum traversal, Hi-Z mip telemetry, conservative occlusion-test counts, and frame-coherency metrics adapted from the old culling subsystem; this is bounded fixture evidence, not production GPU occlusion culling, hardware query, portal, or Nanite-style visibility parity.",
+        blockedClaims
+    };
+}
+function createObjects(seed, objectCount, cameraX, depthResolution) {
+    return Array.from({ length: objectCount }, (_, index) => {
+        const lane = index % 5;
+        const t = objectCount <= 1 ? 0 : index / (objectCount - 1);
+        const centerX = -2.05 + t * 4.1 + (hash01(seed, index) - 0.5) * 0.12;
+        const centerY = -0.18 + (lane - 2) * 0.045 + hash01(seed + 17, index) * 0.08;
+        const centerZ = -0.18 + lane * 0.17 + hash01(seed + 29, index) * 0.08;
+        const halfX = 0.045 + hash01(seed + 41, index) * 0.08;
+        const halfY = 0.08 + hash01(seed + 53, index) * 0.18;
+        const halfZ = 0.035 + hash01(seed + 67, index) * 0.06;
+        const distance = Math.max(0.12, Math.hypot(centerX - cameraX, centerZ + 0.25));
+        const screenScale = Math.max(depthResolution[0], depthResolution[1]) / 4.5;
+        return {
+            id: `cull-object-${String(index).padStart(2, "0")}`,
+            center: [round3(centerX), round3(centerY), round3(centerZ)],
+            halfExtents: [round3(halfX), round3(halfY), round3(halfZ)],
+            projectedAreaPixels: Math.max(1, Math.round((halfX * 2 * halfY * 2 * screenScale) / distance))
+        };
+    });
+}
+function inFrustum(object, cameraX) {
+    const x = object.center[0] - cameraX;
+    const z = object.center[2];
+    return Math.abs(x) <= 1.32 && z >= -0.22 && z <= 0.72;
+}
+function isOccludedByHiZ(object, visibleIndex, cameraX) {
+    const distance = Math.hypot(object.center[0] - cameraX, object.center[2] + 0.18);
+    const smallEnoughForConservativeTest = object.projectedAreaPixels < 18;
+    return distance > 0.74 && (smallEnoughForConservativeTest || visibleIndex % 4 === 1);
+}
+function nearestRayHit(objects, cameraX) {
+    let best = null;
+    for (const object of objects) {
+        const screenX = Math.abs(object.center[0] - cameraX);
+        if (screenX > object.halfExtents[0] + 0.08)
+            continue;
+        const distance = Math.hypot(object.center[0] - cameraX, object.center[1], object.center[2] + 1);
+        if (!best || distance < best.distance)
+            best = { id: object.id, distance: round3(distance) };
+    }
+    return best;
+}
+function depthResolutionOption(value) {
+    const width = integerRange(value[0], 64, 4096, "depthResolution[0]");
+    const height = integerRange(value[1], 64, 4096, "depthResolution[1]");
+    return [width, height];
+}
+function mipCount(width, height) {
+    return Math.floor(Math.log2(Math.max(width, height))) + 1;
+}
+function depthTexels(width, height, levels) {
+    let texels = 0;
+    for (let level = 0; level < levels; level += 1) {
+        texels += Math.max(1, Math.ceil(width / 2 ** level)) * Math.max(1, Math.ceil(height / 2 ** level));
+    }
+    return texels;
+}
+function integer(value, name) {
+    if (!Number.isInteger(value))
+        throw new RangeError(`Culling fixture ${name} must be an integer.`);
+    return value;
+}
+function integerRange(value, min, max, name) {
+    const result = integer(value, name);
+    if (result < min || result > max)
+        throw new RangeError(`Culling fixture ${name} must be between ${min} and ${max}.`);
+    return result;
+}
+function finiteNumber(value, name) {
+    if (!Number.isFinite(value))
+        throw new RangeError(`Culling fixture ${name} must be finite.`);
+    return value;
+}
+function hash01(seed, index) {
+    const x = Math.sin(seed * 12.9898 + index * 78.233) * 43758.5453;
+    return x - Math.floor(x);
+}
+function stableHash(input) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < input.length; index += 1) {
+        hash ^= input.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return (hash >>> 0).toString(16).padStart(8, "0");
+}
+function round3(value) {
+    return Number(value.toFixed(3));
+}
+//# sourceMappingURL=CullingFixtures.js.map

package/dist/CullingFixtures.js.map

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

package/dist/DecalGeometry.d.ts

@@ -0,0 +1,3 @@
+export { createProjectedDecalGeometry as createDecalGeometry, createProjectedDecalGeometry, createRaycastProjectedDecalGeometry, raycastProjectedDecalMesh } from "./production-runtime/geometry/ProjectedDecalGeometry";
+export type { ProjectedDecalBasis as DecalBasis, ProjectedDecalBox as DecalBox, ProjectedDecalGeometryResult as DecalGeometryResult, ProjectedDecalRay as DecalRay, ProjectedDecalRaycastHit as DecalRaycastHit, ProjectedDecalRaycastOptions as DecalRaycastOptions, ProjectedDecalRaycastResult as DecalRaycastResult, ProjectedDecalShape as DecalShape, ProjectedDecalTriangleMesh as DecalTriangleMesh, ProjectedDecalBasis, ProjectedDecalBox, ProjectedDecalGeometryResult, ProjectedDecalRay, ProjectedDecalRaycastHit, ProjectedDecalRaycastOptions, ProjectedDecalRaycastResult, ProjectedDecalShape, ProjectedDecalTriangleMesh } from "./production-runtime/geometry/ProjectedDecalGeometry";
+//# sourceMappingURL=DecalGeometry.d.ts.map

package/dist/DecalGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecalGeometry.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/DecalGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,IAAI,mBAAmB,EACnD,4BAA4B,EAC5B,mCAAmC,EACnC,yBAAyB,EAC1B,MAAM,sDAAsD,CAAC;AAC9D,YAAY,EACV,mBAAmB,IAAI,UAAU,EACjC,iBAAiB,IAAI,QAAQ,EAC7B,4BAA4B,IAAI,mBAAmB,EACnD,iBAAiB,IAAI,QAAQ,EAC7B,wBAAwB,IAAI,eAAe,EAC3C,4BAA4B,IAAI,mBAAmB,EACnD,2BAA2B,IAAI,kBAAkB,EACjD,mBAAmB,IAAI,UAAU,EACjC,0BAA0B,IAAI,iBAAiB,EAC/C,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,iBAAiB,EACjB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,sDAAsD,CAAC"}

package/dist/DecalGeometry.js

@@ -0,0 +1,2 @@
+export { createProjectedDecalGeometry as createDecalGeometry, createProjectedDecalGeometry, createRaycastProjectedDecalGeometry, raycastProjectedDecalMesh } from "./production-runtime/geometry/ProjectedDecalGeometry.js";
+//# sourceMappingURL=DecalGeometry.js.map

package/dist/DecalGeometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecalGeometry.js","sourceRoot":"","sources":["../../../../packages/rendering/src/DecalGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,4BAA4B,IAAI,mBAAmB,EACnD,4BAA4B,EAC5B,mCAAmC,EACnC,yBAAyB,EAC1B,MAAM,sDAAsD,CAAC"}

package/dist/DepthPass.d.ts

@@ -0,0 +1,23 @@
+import { Material } from "./Material";
+import { BaseRenderPass, type RenderPassContext } from "./RenderPass";
+import { type ShaderLibrary } from "./ShaderLibrary";
+import { type RenderItem } from "./ForwardPass";
+export interface DepthPassOptions {
+    readonly casters: readonly RenderItem[];
+    readonly shaderLibrary?: ShaderLibrary;
+    readonly viewProjectionMatrix?: Float32Array | readonly number[];
+}
+export declare class DepthMaterial extends Material {
+    constructor();
+}
+export declare class DepthPass extends BaseRenderPass {
+    private readonly options;
+    private readonly shaderLibrary;
+    private readonly material;
+    private shaderModule;
+    constructor(options: DepthPassOptions);
+    execute(context: RenderPassContext): void;
+    private drawCaster;
+    private getShader;
+}
+//# sourceMappingURL=DepthPass.d.ts.map

package/dist/DepthPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DepthPass.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/DepthPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAA6B,KAAK,aAAa,EAA8B,MAAM,iBAAiB,CAAC;AAC5G,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;IACvC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;CAClE;AAED,qBAAa,aAAc,SAAQ,QAAQ;;CAY1C;AAED,qBAAa,SAAU,SAAQ,cAAc;IAK/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,YAAY,CAA6B;gBAEpB,OAAO,EAAE,gBAAgB;IAKtD,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAMzC,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,SAAS;CAMlB"}

package/dist/DepthPass.js

@@ -0,0 +1,99 @@
+import { Material } from "./Material.js";
+import { RenderDeviceError } from "./RenderDevice.js";
+import { BaseRenderPass } from "./RenderPass.js";
+import { ShaderModule } from "./ShaderModule.js";
+import { DEFAULT_DEPTH_SHADER_NAME, createDefaultShaderLibrary } from "./ShaderLibrary.js";
+import {} from "./ForwardPass.js";
+import { identityMat4, multiplyMat4 } from "@aura3d/scene";
+export class DepthMaterial extends Material {
+    constructor() {
+        super({
+            name: "depth",
+            shaderKey: DEFAULT_DEPTH_SHADER_NAME,
+            parameters: {
+                u_modelViewProjection: identityMatrix()
+            },
+            requiredAttributes: ["a_position"],
+            uniformSchema: [{ name: "u_modelViewProjection", kind: "mat4" }]
+        });
+    }
+}
+export class DepthPass extends BaseRenderPass {
+    options;
+    shaderLibrary;
+    material = new DepthMaterial();
+    shaderModule = null;
+    constructor(options) {
+        super("depth", [], ["depth"]);
+        this.options = options;
+        this.shaderLibrary = options.shaderLibrary ?? createDefaultShaderLibrary();
+    }
+    execute(context) {
+        for (const caster of this.options.casters) {
+            this.drawCaster(context.device, caster);
+        }
+    }
+    drawCaster(device, caster) {
+        const shader = this.getShader(device);
+        const vertexBuffer = caster.geometry.vertexBuffer.upload(device);
+        const indexBuffer = caster.geometry.indexBuffer?.upload(device);
+        const drawRange = resolveDepthDrawRange(caster.geometry, caster.drawRange);
+        const modelMatrix = toMat4(caster.modelMatrix ?? identityMat4(), caster.label);
+        const viewProjection = toMat4(this.options.viewProjectionMatrix ?? identityMat4(), caster.label);
+        this.material.setParameter("u_modelViewProjection", multiplyMat4(viewProjection, modelMatrix));
+        const command = {
+            label: caster.label ?? "shadow-caster",
+            topology: caster.geometry.topology,
+            vertexBuffer,
+            vertexFormat: caster.geometry.vertexBuffer.format,
+            vertexCount: indexBuffer ? caster.geometry.vertexBuffer.vertexCount : drawRange.count,
+            ...(indexBuffer === undefined && drawRange.start > 0 ? { firstVertex: drawRange.start } : {}),
+            shader,
+            uniforms: this.material.getParameters()
+        };
+        if (indexBuffer) {
+            Object.assign(command, {
+                indexBuffer,
+                indexType: caster.geometry.indexBuffer?.type,
+                indexCount: drawRange.count,
+                ...(drawRange.start > 0 ? { firstIndex: drawRange.start } : {})
+            });
+        }
+        device.draw(command);
+    }
+    getShader(device) {
+        if (!this.shaderModule) {
+            this.shaderModule = ShaderModule.fromLibrary(this.shaderLibrary, this.material.shaderKey);
+        }
+        return this.shaderModule.compile(device);
+    }
+}
+function resolveDepthDrawRange(geometry, range) {
+    const available = geometry.indexBuffer?.count ?? geometry.vertexBuffer.vertexCount;
+    if (!range)
+        return { start: 0, count: available };
+    if (!Number.isInteger(range.start) || range.start < 0 || !Number.isInteger(range.count) || range.count <= 0 || range.start + range.count > available) {
+        throw new RenderDeviceError("Depth caster drawRange must fit inside geometry draw count", "DEPTH_DRAW_RANGE_INVALID", {
+            start: range.start,
+            count: range.count,
+            available
+        });
+    }
+    return range;
+}
+function identityMatrix() {
+    return new Float32Array([
+        1, 0, 0, 0,
+        0, 1, 0, 0,
+        0, 0, 1, 0,
+        0, 0, 0, 1
+    ]);
+}
+function toMat4(value, label) {
+    const values = Array.from(value);
+    if (values.length !== 16 || values.some((entry) => !Number.isFinite(entry))) {
+        throw new Error(`DepthPass ${label ?? "caster"} matrix must contain 16 finite numbers.`);
+    }
+    return values;
+}
+//# sourceMappingURL=DepthPass.js.map

package/dist/DepthPass.js.map

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

package/dist/EnvironmentBackgroundPass.d.ts

@@ -0,0 +1,27 @@
+import { type UniformValue } from "./RenderDevice";
+import { BaseRenderPass, type RenderPassContext } from "./RenderPass";
+import { type ShaderLibrary } from "./ShaderLibrary";
+import { TextureBinding } from "./TextureBinding";
+export type EnvironmentBackgroundProjection = "equirect" | "cubemap";
+export type EnvironmentBackgroundEncoding = "linear" | "srgb" | "rgbe";
+export interface EnvironmentBackgroundOptions {
+    readonly projection: EnvironmentBackgroundProjection;
+    readonly texture: TextureBinding;
+    readonly encoding?: EnvironmentBackgroundEncoding;
+    readonly intensity?: number;
+    readonly rotation?: number;
+    readonly outputColorSpace?: "linear" | "srgb";
+    readonly inverseViewProjectionMatrix?: Float32Array | readonly number[];
+    readonly shaderLibrary?: ShaderLibrary;
+}
+export declare const ENVIRONMENT_BACKGROUND_COLOR_RESOURCE = "environment-background-color";
+export declare class EnvironmentBackgroundPass extends BaseRenderPass {
+    private readonly options;
+    private static readonly shaderCaches;
+    private readonly shaderLibrary;
+    constructor(options: EnvironmentBackgroundOptions);
+    execute(context: RenderPassContext): void;
+    private getShader;
+}
+export declare function createEnvironmentBackgroundUniforms(options: EnvironmentBackgroundOptions): ReadonlyMap<string, UniformValue>;
+//# sourceMappingURL=EnvironmentBackgroundPass.d.ts.map

package/dist/EnvironmentBackgroundPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentBackgroundPass.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/EnvironmentBackgroundPass.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkE,KAAK,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnH,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAA0E,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7H,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIlD,MAAM,MAAM,+BAA+B,GAAG,UAAU,GAAG,SAAS,CAAC;AACrE,MAAM,MAAM,6BAA6B,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvE,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,UAAU,EAAE,+BAA+B,CAAC;IACrD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,2BAA2B,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;IACxE,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAED,eAAO,MAAM,qCAAqC,iCAAiC,CAAC;AASpF,qBAAa,yBAA0B,SAAQ,cAAc;IAI/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAqE;IACzG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAEjB,OAAO,EAAE,4BAA4B;IAKlE,OAAO,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAwBzC,OAAO,CAAC,SAAS;CAalB;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,4BAA4B,GAAG,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAwB5H"}

package/dist/EnvironmentBackgroundPass.js

@@ -0,0 +1,167 @@
+import { Geometry } from "./Geometry.js";
+import { DEFAULT_RENDER_STATE } from "./Material.js";
+import { RenderDeviceError } from "./RenderDevice.js";
+import { RenderPipeline } from "./RenderPipeline.js";
+import { BaseRenderPass } from "./RenderPass.js";
+import { ShaderModule } from "./ShaderModule.js";
+import { createDefaultShaderLibrary, DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_NAME } from "./ShaderLibrary.js";
+import { TextureBinding } from "./TextureBinding.js";
+import { VertexBuffer } from "./VertexBuffer.js";
+import { VertexFormat } from "./VertexFormat.js";
+export const ENVIRONMENT_BACKGROUND_COLOR_RESOURCE = "environment-background-color";
+const BACKGROUND_RENDER_STATE = {
+    ...DEFAULT_RENDER_STATE,
+    depthTest: false,
+    depthWrite: false,
+    cullMode: "none"
+};
+export class EnvironmentBackgroundPass extends BaseRenderPass {
+    options;
+    static shaderCaches = new WeakMap();
+    shaderLibrary;
+    constructor(options) {
+        super("environment-background", [], [ENVIRONMENT_BACKGROUND_COLOR_RESOURCE]);
+        this.options = options;
+        this.shaderLibrary = options.shaderLibrary ?? createDefaultShaderLibrary();
+    }
+    execute(context) {
+        validateEnvironmentBackgroundOptions(this.options);
+        const geometry = createFullscreenTriangleGeometry();
+        try {
+            const shader = this.getShader(context.device);
+            const pipeline = new RenderPipeline({
+                label: "environment-background",
+                shader,
+                vertexFormat: geometry.vertexBuffer.format,
+                topology: geometry.topology,
+                renderState: BACKGROUND_RENDER_STATE
+            });
+            const command = pipeline.createDrawCommand({
+                label: "environment-background",
+                vertexBuffer: geometry.vertexBuffer.upload(context.device),
+                vertexCount: geometry.vertexBuffer.vertexCount,
+                uniforms: createEnvironmentBackgroundUniforms(this.options)
+            });
+            context.device.draw(command);
+        }
+        finally {
+            geometry.dispose();
+        }
+    }
+    getShader(device) {
+        let libraryCaches = EnvironmentBackgroundPass.shaderCaches.get(device);
+        if (!libraryCaches) {
+            libraryCaches = new WeakMap();
+            EnvironmentBackgroundPass.shaderCaches.set(device, libraryCaches);
+        }
+        let module = libraryCaches.get(this.shaderLibrary);
+        if (!module) {
+            module = ShaderModule.fromLibrary(this.shaderLibrary, DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_NAME);
+            libraryCaches.set(this.shaderLibrary, module);
+        }
+        return module.compile(device);
+    }
+}
+export function createEnvironmentBackgroundUniforms(options) {
+    validateEnvironmentBackgroundOptions(options);
+    const projectionMode = options.projection === "cubemap" ? 2 : 1;
+    const encoding = options.encoding ?? "linear";
+    const uniforms = new Map();
+    uniforms.set("u_environmentBackgroundTexture", options.projection === "equirect"
+        ? options.texture
+        : new TextureBinding({ name: "u_environmentBackgroundTexture", required: false }));
+    uniforms.set("u_environmentBackgroundCubeTexture", options.projection === "cubemap"
+        ? options.texture
+        : new TextureBinding({ name: "u_environmentBackgroundCubeTexture", required: false }));
+    uniforms.set("u_environmentBackgroundProjection", projectionMode);
+    uniforms.set("u_environmentBackgroundRotation", options.rotation ?? 0);
+    uniforms.set("u_environmentBackgroundIntensity", options.intensity ?? 1);
+    uniforms.set("u_environmentBackgroundEncoding", backgroundEncodingUniform(encoding));
+    uniforms.set("u_outputColorSpace", (options.outputColorSpace ?? "srgb") === "srgb" ? 1 : 0);
+    uniforms.set("u_environmentBackgroundInverseViewProjection", toMat4Uniform(options.inverseViewProjectionMatrix, "inverseViewProjectionMatrix"));
+    return uniforms;
+}
+function createFullscreenTriangleGeometry() {
+    const vertices = new VertexBuffer(VertexFormat.P3, 3);
+    vertices.setAttribute(0, "position", [-1, -1, 0]);
+    vertices.setAttribute(1, "position", [3, -1, 0]);
+    vertices.setAttribute(2, "position", [-1, 3, 0]);
+    return new Geometry(vertices, null, "triangles", { min: [-1, -1, 0], max: [3, 3, 0] });
+}
+function validateEnvironmentBackgroundOptions(options) {
+    if (options.projection !== "equirect" && options.projection !== "cubemap") {
+        throw new RenderDeviceError("Environment background projection must be equirect or cubemap", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            projection: options.projection
+        });
+    }
+    const validation = options.texture.validate();
+    if (!options.texture.texture) {
+        throw new RenderDeviceError("Environment background requires a texture binding", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            projection: options.projection,
+            diagnostics: ["Missing required texture: environment background"]
+        });
+    }
+    if (!validation.ok) {
+        throw new RenderDeviceError("Environment background texture binding validation failed", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            projection: options.projection,
+            diagnostics: validation.diagnostics
+        });
+    }
+    if (options.projection === "cubemap" && options.texture.texture.dimension !== "cube") {
+        throw new RenderDeviceError("Cubemap environment background requires a cube texture", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            textureDimension: options.texture.texture.dimension
+        });
+    }
+    if (options.projection === "equirect" && options.texture.texture.dimension !== "2d") {
+        throw new RenderDeviceError("Equirect environment background requires a 2D panorama texture", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            textureDimension: options.texture.texture.dimension
+        });
+    }
+    if (options.intensity !== undefined && (!Number.isFinite(options.intensity) || options.intensity < 0)) {
+        throw new RenderDeviceError("Environment background intensity must be finite and non-negative", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            intensity: options.intensity
+        });
+    }
+    if (options.rotation !== undefined && !Number.isFinite(options.rotation)) {
+        throw new RenderDeviceError("Environment background rotation must be finite", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            rotation: options.rotation
+        });
+    }
+    const outputColorSpace = options.outputColorSpace ?? "srgb";
+    if (outputColorSpace !== "linear" && outputColorSpace !== "srgb") {
+        throw new RenderDeviceError("Environment background outputColorSpace must be linear or srgb", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            outputColorSpace
+        });
+    }
+    backgroundEncodingUniform(options.encoding ?? "linear");
+    toMat4Uniform(options.inverseViewProjectionMatrix, "inverseViewProjectionMatrix");
+}
+function backgroundEncodingUniform(encoding) {
+    switch (encoding) {
+        case "linear":
+        case "srgb":
+            return 0;
+        case "rgbe":
+            return 2;
+        default:
+            throw new RenderDeviceError("Environment background encoding must be linear, srgb, or rgbe", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+                encoding
+            });
+    }
+}
+function toMat4Uniform(value, label) {
+    const source = value ?? [
+        1, 0, 0, 0,
+        0, 1, 0, 0,
+        0, 0, 1, 0,
+        0, 0, 0, 1
+    ];
+    if (source.length !== 16 || !Array.from(source).every(Number.isFinite)) {
+        throw new RenderDeviceError("Environment background inverse view-projection matrix must contain 16 finite numbers", "ENVIRONMENT_BACKGROUND_CONTRACT", {
+            label,
+            matrixLength: source.length
+        });
+    }
+    return new Float32Array(source);
+}
+//# sourceMappingURL=EnvironmentBackgroundPass.js.map

package/dist/EnvironmentBackgroundPass.js.map

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

package/dist/EnvironmentBackgroundResources.d.ts

@@ -0,0 +1,31 @@
+import { type EnvironmentBackgroundEncoding, type EnvironmentBackgroundOptions } from "./EnvironmentBackgroundPass";
+import { type TextureColorSpace, type TextureCubeFace, type TextureFormat, type TexturePixelData } from "./Texture";
+export type EnvironmentBackgroundPixelFormat = Extract<TextureFormat, "rgba8" | "rgba16f" | "rgba32f">;
+export interface EnvironmentBackgroundResourceOptions {
+    readonly encoding?: EnvironmentBackgroundEncoding;
+    readonly intensity?: number;
+    readonly rotation?: number;
+    readonly outputColorSpace?: "linear" | "srgb";
+    readonly format?: EnvironmentBackgroundPixelFormat;
+    readonly colorSpace?: TextureColorSpace;
+    readonly textureLabel?: string;
+    readonly bindingName?: string;
+}
+export interface EquirectEnvironmentBackgroundResourceOptions extends EnvironmentBackgroundResourceOptions {
+    readonly width: number;
+    readonly height: number;
+    readonly data: TexturePixelData;
+}
+export interface CubemapEnvironmentBackgroundFacePixels {
+    readonly face: TextureCubeFace;
+    readonly data: TexturePixelData;
+}
+export interface CubemapEnvironmentBackgroundResourceOptions extends EnvironmentBackgroundResourceOptions {
+    readonly size: number;
+    readonly faces: readonly CubemapEnvironmentBackgroundFacePixels[];
+}
+export declare const ENVIRONMENT_BACKGROUND_CUBE_FACES: readonly TextureCubeFace[];
+export declare function createEquirectEnvironmentBackgroundOptions(options: EquirectEnvironmentBackgroundResourceOptions): EnvironmentBackgroundOptions;
+export declare function createCubemapEnvironmentBackgroundOptions(options: CubemapEnvironmentBackgroundResourceOptions): EnvironmentBackgroundOptions;
+export declare function validateEnvironmentBackgroundResourceOptions(options: EnvironmentBackgroundOptions): EnvironmentBackgroundOptions;
+//# sourceMappingURL=EnvironmentBackgroundResources.d.ts.map

package/dist/EnvironmentBackgroundResources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentBackgroundResources.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/EnvironmentBackgroundResources.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,6BAA6B,EAClC,KAAK,4BAA4B,EAClC,MAAM,6BAA6B,CAAC;AAErC,OAAO,EAA0B,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG5I,MAAM,MAAM,gCAAgC,GAAG,OAAO,CAAC,aAAa,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;AAEvG,MAAM,WAAW,oCAAoC;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,6BAA6B,CAAC;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,gCAAgC,CAAC;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,4CAA6C,SAAQ,oCAAoC;IACxG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,sCAAsC;IACrD,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,2CAA4C,SAAQ,oCAAoC;IACvG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,sCAAsC,EAAE,CAAC;CACnE;AAED,eAAO,MAAM,iCAAiC,EAAE,SAAS,eAAe,EAAyC,CAAC;AAElH,wBAAgB,0CAA0C,CACxD,OAAO,EAAE,4CAA4C,GACpD,4BAA4B,CA8B9B;AAED,wBAAgB,yCAAyC,CACvD,OAAO,EAAE,2CAA2C,GACnD,4BAA4B,CAqC9B;AAED,wBAAgB,4CAA4C,CAAC,OAAO,EAAE,4BAA4B,GAAG,4BAA4B,CAWhI"}