@meimu/mutracer 0.0.0-stage → 0.1.0

package/lib/renderer/committedScene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"committedScene.js","sourceRoot":"","sources":["../../src/renderer/committedScene.ts"],"names":[],"mappings":"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","sourcesContent":["import {createCanvas} from '../util/canvas.js';\nimport Geometry from '../scene/Geometry.js';\nimport InstancedMesh from '../scene/InstancedMesh.js';\nimport Texture from '../scene/Texture.js';\nimport { copyGeometryChangeState } from '../scene/geometryChanges.js';\nimport { getGeometryBvh, setGeometryBvh } from './geometryBvh.js';\nimport type { Scene } from '../scene/Scene.js';\nimport type { SceneChanges } from './sceneChangeDetector.js';\n\n/** Stable engine-owned mirrors isolate deferred GPU uploads from external edits. */\nexport class CommittedScene {\n  private readonly copies = new WeakMap<object, any>();\n  private readonly geometryVersions = new WeakMap<Geometry, number>();\n  private readonly instanceVersions = new WeakMap<InstancedMesh, {transformsVersion: number; transforms: Float32Array; colorsVersion: number; colors?: Float32Array}>();\n  private value?: Scene;\n  private readonly copying = new WeakSet<object>();\n\n  private copy<T>(value: T): T {\n    if (!value || typeof value !== 'object') return value;\n    const object = value as object;\n    if ((typeof HTMLImageElement !== 'undefined' && object instanceof HTMLImageElement) || (typeof HTMLCanvasElement !== 'undefined' && object instanceof HTMLCanvasElement) ||\n        (typeof OffscreenCanvas !== 'undefined' && object instanceof OffscreenCanvas) ||\n        (typeof ImageBitmap !== 'undefined' && object instanceof ImageBitmap)) {\n      const source = object as HTMLImageElement | HTMLCanvasElement | OffscreenCanvas | ImageBitmap;\n      let canvas = this.copies.get(object) as HTMLCanvasElement | OffscreenCanvas | undefined;\n      if (!canvas) { canvas = createCanvas(source.width, source.height); this.copies.set(object, canvas); }\n      canvas.width = source.width; canvas.height = source.height;\n      const context = canvas.getContext('2d') as CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D | null;\n      if (!context) throw new Error('Texture snapshot context is not available.');\n      context.drawImage(source, 0, 0);\n      return canvas as T;\n    }\n    if (typeof Node !== 'undefined' && object instanceof Node) return value;\n    if (value instanceof Geometry && this.geometryVersions.get(value) === value.version) return this.copies.get(value);\n    if (ArrayBuffer.isView(value)) {\n      const previous = this.copies.get(object);\n      if (previous?.constructor === value.constructor && previous.length === (value as any).length) {\n        previous.set(value); return previous;\n      }\n      const cloned = (value as any).slice(); this.copies.set(object, cloned); return cloned;\n    }\n    if (value instanceof ArrayBuffer) return value.slice(0) as T;\n    let cloned = this.copies.get(object);\n    if (!cloned) { cloned = Array.isArray(value) ? [] : Object.create(Object.getPrototypeOf(value)); this.copies.set(object, cloned); }\n    if (this.copying.has(object)) return cloned;\n    this.copying.add(object);\n    try {\n      for (const key of Object.keys(value)) {\n        if (value instanceof InstancedMesh && (key === 'transforms' || key === 'colors')) {\n          const previous = this.instanceVersions.get(value);\n          const version = key === 'transforms' ? value.transformsVersion : value.colorsVersion;\n          const priorVersion = key === 'transforms' ? previous?.transformsVersion : previous?.colorsVersion;\n          const array = value[key];\n          if (!previous || priorVersion !== version || previous[key] !== array) {\n            // Each batch owns its snapshot even when callers share source storage.\n            if (!array) cloned[key] = undefined;\n            else if (previous?.[key] === array && cloned[key]?.length === array.length) cloned[key].set(array);\n            else cloned[key] = array.slice();\n          }\n        } else cloned[key] = value instanceof Texture && key === 'source' ? value.source : this.copy((value as any)[key]);\n      }\n    } finally { this.copying.delete(object); }\n    if (Array.isArray(value)) cloned.length = value.length;\n    if (value instanceof InstancedMesh) this.instanceVersions.set(value, {\n      transformsVersion: value.transformsVersion, transforms: value.transforms,\n      colorsVersion: value.colorsVersion, colors: value.colors\n    });\n    if (value instanceof Geometry) {\n      this.geometryVersions.set(value, value.version);\n      setGeometryBvh(cloned, getGeometryBvh(value));\n      copyGeometryChangeState(value, cloned);\n    }\n    return cloned;\n  }\n\n  mirror<T extends object>(source: T): T { return this.copies.get(source); }\n\n  capture(scene: Scene, changes: SceneChanges): Scene {\n    if (!this.value || changes.meshes === 'full') this.value = { meshes: this.copy(scene.meshes), lights: this.copy(scene.lights), background: this.copy(scene.background) };\n    else {\n      for (const mesh of changes.transforms) {\n        this.copy(mesh.transform);\n        if (mesh instanceof InstancedMesh) this.copy(mesh);\n      }\n      for (const mesh of changes.colors) this.copy(mesh);\n      for (const geometry of changes.geometries) this.copy(geometry);\n      for (const material of changes.materials) this.copy(material);\n      if (changes.lights) this.value.lights = this.copy(scene.lights);\n      if (changes.background) this.value.background = this.copy(scene.background);\n    }\n    return this.value;\n  }\n}\n"]}

package/lib/renderer/dataTextureUtil.d.ts

@@ -0,0 +1,32 @@
+import { Texture2D } from './webgl.js';
+export declare function padArray(typedArray: Float32Array | Int32Array, length: number): Float32Array | Int32Array;
+export declare function textureDimensionsFromArray(count: number): {
+    columnsLog: number;
+    columns: number;
+    rows: number;
+    size: number;
+};
+export declare function setDataTexture(texture: Texture2D, dataArray: Float32Array | Int32Array, channels: 1 | 2 | 3 | 4): {
+    columnsLog: number;
+    columns: number;
+    rows: number;
+    size: number;
+};
+export declare const commonLinearFloatProps: {
+    wrapS: 33071;
+    wrapT: 33071;
+    type: 5126;
+    minFilter: 9729;
+    magFilter: 9729;
+    flipY: boolean;
+    useMipmap: boolean;
+};
+export declare const commonNearestFloatProps: {
+    wrapS: 33071;
+    wrapT: 33071;
+    minFilter: 9728;
+    magFilter: 9728;
+    type: 5126;
+    flipY: boolean;
+    useMipmap: boolean;
+};

package/lib/renderer/dataTextureUtil.js

@@ -0,0 +1,46 @@
+import { constants } from './webgl.js';
+export function padArray(typedArray, length) {
+    const newArray = new typedArray.constructor(length);
+    newArray.set(typedArray);
+    return newArray;
+}
+export function textureDimensionsFromArray(count) {
+    const columnsLog = Math.round(Math.log2(Math.sqrt(count)));
+    const columns = 2 ** columnsLog;
+    const rows = Math.ceil(count / columns);
+    return {
+        columnsLog,
+        columns,
+        rows,
+        size: rows * columns
+    };
+}
+export function setDataTexture(texture, dataArray, channels) {
+    const textureDim = textureDimensionsFromArray(dataArray.length / channels);
+    texture.source = {
+        data: padArray(dataArray, textureDim.size * channels),
+        width: textureDim.columns,
+        height: textureDim.rows
+    };
+    return textureDim;
+}
+export const commonLinearFloatProps = {
+    wrapS: constants.CLAMP_TO_EDGE,
+    wrapT: constants.CLAMP_TO_EDGE,
+    // TODO HALF_FLOAT needs Uint16Array. Float32Array not work
+    type: constants.FLOAT,
+    minFilter: constants.LINEAR,
+    magFilter: constants.LINEAR,
+    flipY: false,
+    useMipmap: false
+};
+export const commonNearestFloatProps = {
+    wrapS: constants.CLAMP_TO_EDGE,
+    wrapT: constants.CLAMP_TO_EDGE,
+    minFilter: constants.NEAREST,
+    magFilter: constants.NEAREST,
+    type: constants.FLOAT,
+    flipY: false,
+    useMipmap: false
+};
+//# sourceMappingURL=dataTextureUtil.js.map

package/lib/renderer/dataTextureUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataTextureUtil.js","sourceRoot":"","sources":["../../src/renderer/dataTextureUtil.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,SAAS,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,UAAU,QAAQ,CACtB,UAAqC,EACrC,MAAc;IAEd,MAAM,QAAQ,GAAG,IAAK,UAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7D,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAAa;IACtD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,CAAC,IAAI,UAAU,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC;IACxC,OAAO;QACL,UAAU;QACV,OAAO;QACP,IAAI;QACJ,IAAI,EAAE,IAAI,GAAG,OAAO;KACrB,CAAC;AACJ,CAAC;AACD,MAAM,UAAU,cAAc,CAC5B,OAAkB,EAClB,SAAoC,EACpC,QAAuB;IAEvB,MAAM,UAAU,GAAG,0BAA0B,CAAC,SAAS,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,GAAG;QACf,IAAI,EAAE,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;QACrD,KAAK,EAAE,UAAU,CAAC,OAAO;QACzB,MAAM,EAAE,UAAU,CAAC,IAAI;KACxB,CAAC;IACF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,KAAK,EAAE,SAAS,CAAC,aAAa;IAC9B,KAAK,EAAE,SAAS,CAAC,aAAa;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,SAAS,CAAC,KAAK;IACrB,SAAS,EAAE,SAAS,CAAC,MAAM;IAC3B,SAAS,EAAE,SAAS,CAAC,MAAM;IAC3B,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,KAAK;CACjB,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,KAAK,EAAE,SAAS,CAAC,aAAa;IAC9B,KAAK,EAAE,SAAS,CAAC,aAAa;IAC9B,SAAS,EAAE,SAAS,CAAC,OAAO;IAC5B,SAAS,EAAE,SAAS,CAAC,OAAO;IAC5B,IAAI,EAAE,SAAS,CAAC,KAAK;IACrB,KAAK,EAAE,KAAK;IACZ,SAAS,EAAE,KAAK;CACjB,CAAC","sourcesContent":["import { Texture2D, constants } from './webgl.js';\n\nexport function padArray(\n  typedArray: Float32Array | Int32Array,\n  length: number\n): Float32Array | Int32Array {\n  const newArray = new (typedArray as any).constructor(length);\n  newArray.set(typedArray);\n  return newArray;\n}\n\nexport function textureDimensionsFromArray(count: number) {\n  const columnsLog = Math.round(Math.log2(Math.sqrt(count)));\n  const columns = 2 ** columnsLog;\n  const rows = Math.ceil(count / columns);\n  return {\n    columnsLog,\n    columns,\n    rows,\n    size: rows * columns\n  };\n}\nexport function setDataTexture(\n  texture: Texture2D,\n  dataArray: Float32Array | Int32Array,\n  channels: 1 | 2 | 3 | 4\n) {\n  const textureDim = textureDimensionsFromArray(dataArray.length / channels);\n  texture.source = {\n    data: padArray(dataArray, textureDim.size * channels),\n    width: textureDim.columns,\n    height: textureDim.rows\n  };\n  return textureDim;\n}\n\nexport const commonLinearFloatProps = {\n  wrapS: constants.CLAMP_TO_EDGE,\n  wrapT: constants.CLAMP_TO_EDGE,\n  // TODO HALF_FLOAT needs Uint16Array. Float32Array not work\n  type: constants.FLOAT,\n  minFilter: constants.LINEAR,\n  magFilter: constants.LINEAR,\n  flipY: false,\n  useMipmap: false\n};\n\nexport const commonNearestFloatProps = {\n  wrapS: constants.CLAMP_TO_EDGE,\n  wrapT: constants.CLAMP_TO_EDGE,\n  minFilter: constants.NEAREST,\n  magFilter: constants.NEAREST,\n  type: constants.FLOAT,\n  flipY: false,\n  useMipmap: false\n};\n"]}

package/lib/renderer/denoiser.d.ts

@@ -0,0 +1,65 @@
+import type { Denoiser } from '../Render.js';
+import type { JNLMDenoiser } from './jnlm.js';
+import type { OIDNDenoiser } from './oidnNetwork.js';
+export interface OIDNWebGPUData {
+    data: GPUBuffer | GPUTexture;
+    width: number;
+    height: number;
+}
+export interface OIDNWebGPUOutputData {
+    data: GPUBuffer;
+    width: number;
+    height: number;
+}
+export interface OIDNWeb {
+    auxiliaryDenoisers?: {
+        albedo: OIDNWeb;
+        normal: OIDNWeb;
+    };
+    /** Optional serializable execution details exposed by native oidn-web. */
+    getRuntimeInfo?: () => unknown;
+    /** Optional shape preparation supported by newer oidn-web runtimes. */
+    prepareForImage?: (width: number, height: number, options?: {
+        tileOverlap?: number;
+    }) => Promise<void>;
+    tileExecute: (opts: {
+        color: OIDNWebGPUData;
+        albedo?: OIDNWebGPUData;
+        normal?: OIDNWebGPUData;
+        denoiseAlpha?: boolean;
+        wholeImage?: boolean;
+        tileOverlap?: number;
+        scheduling?: 'animation-frame' | 'event-loop';
+        done: (outputData: {
+            data: GPUBuffer;
+            width: number;
+            height: number;
+        }) => void;
+        error?: (reason: unknown) => void;
+        progress?: (outputData: OIDNWebGPUOutputData, tileData: OIDNWebGPUOutputData | undefined, tile: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }, currentIdx: number, totalIdx: number) => void;
+    }) => () => void;
+}
+/** Explicit private dispatch; built-ins do not implement the public custom interface. */
+export type DenoiserHandle = {
+    kind: 'jnlm';
+    denoiser: JNLMDenoiser;
+} | {
+    kind: 'oidn';
+    denoiser: OIDNWeb;
+} | {
+    kind: 'custom';
+    denoiser: Denoiser;
+};
+/** Only these handles are owned and released by the engine. */
+export type OwnedDenoiser = {
+    kind: 'jnlm';
+    denoiser: JNLMDenoiser;
+} | {
+    kind: 'oidn';
+    denoiser: OIDNDenoiser;
+};

package/lib/renderer/denoiser.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=denoiser.js.map

package/lib/renderer/denoiser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"denoiser.js","sourceRoot":"","sources":["../../src/renderer/denoiser.ts"],"names":[],"mappings":"","sourcesContent":["import type {Denoiser} from '../Render.js';\nimport type {JNLMDenoiser} from './jnlm.js';\nimport type {OIDNDenoiser} from './oidnNetwork.js';\n\nexport interface OIDNWebGPUData {\n  data: GPUBuffer | GPUTexture;\n  width: number;\n  height: number;\n}\nexport interface OIDNWebGPUOutputData {\n  data: GPUBuffer;\n  width: number;\n  height: number;\n}\n\nexport interface OIDNWeb {\n  auxiliaryDenoisers?: {\n    albedo: OIDNWeb;\n    normal: OIDNWeb;\n  };\n  /** Optional serializable execution details exposed by native oidn-web. */\n  getRuntimeInfo?: () => unknown;\n  /** Optional shape preparation supported by newer oidn-web runtimes. */\n  prepareForImage?: (\n    width: number,\n    height: number,\n    options?: { tileOverlap?: number }\n  ) => Promise<void>;\n  tileExecute: (opts: {\n    color: OIDNWebGPUData;\n    albedo?: OIDNWebGPUData;\n    normal?: OIDNWebGPUData;\n    denoiseAlpha?: boolean;\n    wholeImage?: boolean;\n    tileOverlap?: number;\n    scheduling?: 'animation-frame' | 'event-loop';\n    done: (outputData: {\n      data: GPUBuffer;\n      width: number;\n      height: number;\n    }) => void;\n    error?: (reason: unknown) => void;\n    progress?: (\n      outputData: OIDNWebGPUOutputData,\n      tileData: OIDNWebGPUOutputData | undefined,\n      tile: { x: number; y: number; width: number; height: number },\n      currentIdx: number,\n      totalIdx: number\n    ) => void;\n  }) => () => void;\n}\n\n/** Explicit private dispatch; built-ins do not implement the public custom interface. */\nexport type DenoiserHandle =\n  | {kind: 'jnlm'; denoiser: JNLMDenoiser}\n  | {kind: 'oidn'; denoiser: OIDNWeb}\n  | {kind: 'custom'; denoiser: Denoiser};\n/** Only these handles are owned and released by the engine. */\nexport type OwnedDenoiser =\n  | {kind: 'jnlm'; denoiser: JNLMDenoiser}\n  | {kind: 'oidn'; denoiser: OIDNDenoiser};\n"]}

package/lib/renderer/depthQuery.d.ts

@@ -0,0 +1,14 @@
+/** A square depth sampling area in viewport coordinates. */
+export interface DepthSampleArea {
+    /** Horizontal center, 0..1 from the left. Required. */
+    x: number;
+    /** Vertical center, 0..1 from the top. Required. */
+    y: number;
+    /** Half height as a fraction of viewport height; 0 samples one point. Required. */
+    size: number;
+}
+export declare const DEPTH_SAMPLE_GRID = 7;
+export declare const DEPTH_SAMPLE_COUNT: number;
+/** Bottom-left UV center and half extent, matching both camera-ray shaders. */
+export declare function packDepthSampleArea(area: DepthSampleArea, aspect: number): Float32Array<ArrayBuffer>;
+export declare function unpackDepthSamples(rgba: Float32Array): Float32Array<ArrayBuffer>;

package/lib/renderer/depthQuery.js

@@ -0,0 +1,14 @@
+export const DEPTH_SAMPLE_GRID = 7;
+export const DEPTH_SAMPLE_COUNT = DEPTH_SAMPLE_GRID ** 2;
+/** Bottom-left UV center and half extent, matching both camera-ray shaders. */
+export function packDepthSampleArea(area, aspect) {
+    if (![area.x, area.y, area.size, aspect].every(Number.isFinite) ||
+        area.x < 0 || area.x > 1 || area.y < 0 || area.y > 1 || area.size < 0 || aspect <= 0) {
+        throw new RangeError('Depth sampling requires a viewport center in 0..1, a non-negative size and a positive aspect.');
+    }
+    return new Float32Array([area.x, 1 - area.y, area.size / aspect, area.size]);
+}
+export function unpackDepthSamples(rgba) {
+    return Float32Array.from({ length: DEPTH_SAMPLE_COUNT }, (_, i) => rgba[i * 4]);
+}
+//# sourceMappingURL=depthQuery.js.map

package/lib/renderer/depthQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"depthQuery.js","sourceRoot":"","sources":["../../src/renderer/depthQuery.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,IAAI,CAAC,CAAC;AAEzD,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,IAAqB,EAAE,MAAc;IACvE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC7D,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,UAAU,CAAC,+FAA+F,CAAC,CAAC;IACxH,CAAC;IACD,OAAO,IAAI,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC","sourcesContent":["/** A square depth sampling area in viewport coordinates. */\nexport interface DepthSampleArea {\n  /** Horizontal center, 0..1 from the left. Required. */\n  x: number;\n  /** Vertical center, 0..1 from the top. Required. */\n  y: number;\n  /** Half height as a fraction of viewport height; 0 samples one point. Required. */\n  size: number;\n}\n\nexport const DEPTH_SAMPLE_GRID = 7;\nexport const DEPTH_SAMPLE_COUNT = DEPTH_SAMPLE_GRID ** 2;\n\n/** Bottom-left UV center and half extent, matching both camera-ray shaders. */\nexport function packDepthSampleArea(area: DepthSampleArea, aspect: number) {\n  if (![area.x, area.y, area.size, aspect].every(Number.isFinite) ||\n    area.x < 0 || area.x > 1 || area.y < 0 || area.y > 1 || area.size < 0 || aspect <= 0) {\n    throw new RangeError('Depth sampling requires a viewport center in 0..1, a non-negative size and a positive aspect.');\n  }\n  return new Float32Array([area.x, 1 - area.y, area.size / aspect, area.size]);\n}\n\nexport function unpackDepthSamples(rgba: Float32Array) {\n  return Float32Array.from({ length: DEPTH_SAMPLE_COUNT }, (_, i) => rgba[i * 4]);\n}\n"]}

package/lib/renderer/deviceRequirements.d.ts

@@ -0,0 +1,23 @@
+/** Internal pipeline floor: 4 scene + 4 accumulation buffers, 8 textures
+ * including displacement, one adaptive storage texture, and 16×16 compute.
+ * Buffer capacity covers one aligned 16×16 shadow-catcher target (48 B/pixel).
+ * Larger scenes/images and OIDN impose additional, size-dependent requirements.
+ */
+export declare const minimumDeviceLimits: {
+    readonly maxStorageBuffersPerShaderStage: 8;
+    readonly maxStorageBufferBindingSize: 12288;
+    readonly maxBufferSize: 12288;
+    readonly maxSampledTexturesPerShaderStage: 8;
+    readonly maxStorageTexturesPerShaderStage: 1;
+    readonly maxComputeWorkgroupStorageSize: 0;
+    readonly maxComputeWorkgroupSizeX: 64;
+    readonly maxComputeWorkgroupSizeY: 16;
+    readonly maxComputeInvocationsPerWorkgroup: 256;
+    readonly maxBindGroups: 4;
+};
+export declare function validateDevice(device: GPUDevice): void;
+/** Recommended descriptor for MuTracer and OIDN on this adapter. Requests
+ * supported optional features and adapter limits; defaults depend on adapter.
+ * The resulting device remains owned by the caller.
+ */
+export declare function getRecommendedDeviceDescriptor(adapter: GPUAdapter): GPUDeviceDescriptor;

package/lib/renderer/deviceRequirements.js

@@ -0,0 +1,50 @@
+/** Internal pipeline floor: 4 scene + 4 accumulation buffers, 8 textures
+ * including displacement, one adaptive storage texture, and 16×16 compute.
+ * Buffer capacity covers one aligned 16×16 shadow-catcher target (48 B/pixel).
+ * Larger scenes/images and OIDN impose additional, size-dependent requirements.
+ */
+export const minimumDeviceLimits = {
+    maxStorageBuffersPerShaderStage: 8,
+    maxStorageBufferBindingSize: 12288,
+    maxBufferSize: 12288,
+    maxSampledTexturesPerShaderStage: 8,
+    maxStorageTexturesPerShaderStage: 1,
+    maxComputeWorkgroupStorageSize: 0,
+    maxComputeWorkgroupSizeX: 64,
+    maxComputeWorkgroupSizeY: 16,
+    maxComputeInvocationsPerWorkgroup: 256,
+    maxBindGroups: 4,
+};
+export function validateDevice(device) {
+    const missing = [];
+    for (const [key, required] of Object.entries(minimumDeviceLimits)) {
+        const actual = device.limits[key];
+        if (typeof actual !== 'number' || actual < required)
+            missing.push(`${key}: requires ${required}, actual ${actual}`);
+    }
+    // No mandatory optional features: tracing uses f32, manual float filtering
+    // and render attachments; timestamp queries have a wall-clock fallback.
+    if (missing.length)
+        throw new Error(`GPUDevice does not meet MuTracer requirements:\n${missing.join('\n')}`);
+}
+/** Recommended descriptor for MuTracer and OIDN on this adapter. Requests
+ * supported optional features and adapter limits; defaults depend on adapter.
+ * The resulting device remains owned by the caller.
+ */
+export function getRecommendedDeviceDescriptor(adapter) {
+    const features = [];
+    for (const feature of ['timestamp-query', 'bgra8unorm-storage', 'shader-f16', 'subgroups',
+        'texture-formats-tier1', 'texture-formats-tier2', 'float32-filterable']) {
+        if (adapter.features.has(feature))
+            features.push(feature);
+    }
+    const limits = adapter.limits;
+    const requiredLimits = {};
+    for (const key of ['maxComputeWorkgroupStorageSize', 'maxComputeWorkgroupsPerDimension',
+        'maxStorageBufferBindingSize', 'maxStorageBuffersPerShaderStage', 'maxSampledTexturesPerShaderStage',
+        'maxStorageTexturesPerShaderStage', 'maxBufferSize', 'maxTextureArrayLayers',
+        'maxComputeWorkgroupSizeX', 'maxComputeInvocationsPerWorkgroup'])
+        requiredLimits[key] = limits[key];
+    return { requiredFeatures: features, requiredLimits };
+}
+//# sourceMappingURL=deviceRequirements.js.map

package/lib/renderer/deviceRequirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deviceRequirements.js","sourceRoot":"","sources":["../../src/renderer/deviceRequirements.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,+BAA+B,EAAE,CAAC;IAClC,2BAA2B,EAAE,KAAK;IAClC,aAAa,EAAE,KAAK;IACpB,gCAAgC,EAAE,CAAC;IACnC,gCAAgC,EAAE,CAAC;IACnC,8BAA8B,EAAE,CAAC;IACjC,wBAAwB,EAAE,EAAE;IAC5B,wBAAwB,EAAE,EAAE;IAC5B,iCAAiC,EAAE,GAAG;IACtC,aAAa,EAAE,CAAC;CACR,CAAC;AAEX,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAClE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,GAA+B,CAAC,CAAC;QAC9D,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,QAAQ;YAAE,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,cAAc,QAAQ,YAAY,MAAM,EAAE,CAAC,CAAC;IACtH,CAAC;IACD,2EAA2E;IAC3E,wEAAwE;IACxE,IAAI,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,OAAmB;IAChE,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,KAAK,MAAM,OAAO,IAAI,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,YAAY,EAAE,WAAW;QACvF,uBAAuB,EAAE,uBAAuB,EAAE,oBAAoB,CAAqB,EAAE,CAAC;QAC9F,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,cAAc,GAA2B,EAAE,CAAC;IAClD,KAAK,MAAM,GAAG,IAAI,CAAC,gCAAgC,EAAE,kCAAkC;QACrF,6BAA6B,EAAE,iCAAiC,EAAE,kCAAkC;QACpG,kCAAkC,EAAE,eAAe,EAAE,uBAAuB;QAC5E,0BAA0B,EAAE,mCAAmC,CAAU;QAAE,cAAc,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/G,OAAO,EAAC,gBAAgB,EAAE,QAAQ,EAAE,cAAc,EAAC,CAAC;AACtD,CAAC","sourcesContent":["/** Internal pipeline floor: 4 scene + 4 accumulation buffers, 8 textures\n * including displacement, one adaptive storage texture, and 16×16 compute.\n * Buffer capacity covers one aligned 16×16 shadow-catcher target (48 B/pixel).\n * Larger scenes/images and OIDN impose additional, size-dependent requirements.\n */\nexport const minimumDeviceLimits = {\n  maxStorageBuffersPerShaderStage: 8,\n  maxStorageBufferBindingSize: 12288,\n  maxBufferSize: 12288,\n  maxSampledTexturesPerShaderStage: 8,\n  maxStorageTexturesPerShaderStage: 1,\n  maxComputeWorkgroupStorageSize: 0,\n  maxComputeWorkgroupSizeX: 64,\n  maxComputeWorkgroupSizeY: 16,\n  maxComputeInvocationsPerWorkgroup: 256,\n  maxBindGroups: 4,\n} as const;\n\nexport function validateDevice(device: GPUDevice): void {\n  const missing: string[] = [];\n  for (const [key, required] of Object.entries(minimumDeviceLimits)) {\n    const actual = device.limits[key as keyof GPUSupportedLimits];\n    if (typeof actual !== 'number' || actual < required) missing.push(`${key}: requires ${required}, actual ${actual}`);\n  }\n  // No mandatory optional features: tracing uses f32, manual float filtering\n  // and render attachments; timestamp queries have a wall-clock fallback.\n  if (missing.length) throw new Error(`GPUDevice does not meet MuTracer requirements:\\n${missing.join('\\n')}`);\n}\n\n/** Recommended descriptor for MuTracer and OIDN on this adapter. Requests\n * supported optional features and adapter limits; defaults depend on adapter.\n * The resulting device remains owned by the caller.\n */\nexport function getRecommendedDeviceDescriptor(adapter: GPUAdapter): GPUDeviceDescriptor {\n  const features: GPUFeatureName[] = [];\n  for (const feature of ['timestamp-query', 'bgra8unorm-storage', 'shader-f16', 'subgroups',\n    'texture-formats-tier1', 'texture-formats-tier2', 'float32-filterable'] as GPUFeatureName[]) {\n    if (adapter.features.has(feature)) features.push(feature);\n  }\n  const limits = adapter.limits;\n  const requiredLimits: Record<string, number> = {};\n  for (const key of ['maxComputeWorkgroupStorageSize', 'maxComputeWorkgroupsPerDimension',\n    'maxStorageBufferBindingSize', 'maxStorageBuffersPerShaderStage', 'maxSampledTexturesPerShaderStage',\n    'maxStorageTexturesPerShaderStage', 'maxBufferSize', 'maxTextureArrayLayers',\n    'maxComputeWorkgroupSizeX', 'maxComputeInvocationsPerWorkgroup'] as const) requiredLimits[key] = limits[key];\n  return {requiredFeatures: features, requiredLimits};\n}\n"]}

package/lib/renderer/envMapCreation.d.ts

@@ -0,0 +1,10 @@
+import { ColorRGBA } from '../types.js';
+import { TextureDataSource } from '../scene/Texture.js';
+import AmbientLight from '../scene/AmbientLight.js';
+import EnvironmentLight from '../scene/EnvironmentLight.js';
+import { SceneBackground } from '../scene/Scene.js';
+import type { EnvironmentMapSource } from './envMapDistribution.js';
+export declare function generateBackgroundMapFromSceneBackground(background: SceneBackground): TextureDataSource | undefined;
+export declare function generateEnvMapFromSceneComponents(ambientLights: AmbientLight[], environmentLights: EnvironmentLight[]): EnvironmentMapSource;
+export declare function initializeEnvMap(environmentLights: EnvironmentLight[]): EnvironmentMapSource;
+export declare function generateSolidMap(width: number, height: number, color?: ColorRGBA, intensity?: number): TextureDataSource;

package/lib/renderer/envMapCreation.js

@@ -0,0 +1,96 @@
+// Portions adapted from ray-tracing-renderer@0.10.15
+// (https://github.com/hoverinc/ray-tracing-renderer).
+// Copyright (c) 2019 HOVER, MIT license; see LICENSES/RayTracingRenderer-MIT.txt.
+import { isTextureDataSource } from '../scene/Texture.js';
+const DEFAULT_MAP_RESOLUTION = {
+    width: 8,
+    height: 4
+};
+// Tools for generating and modify env maps for lighting from scene component data
+export function generateBackgroundMapFromSceneBackground(background) {
+    let backgroundImage;
+    // Is [r,g,b,a] color
+    if (Array.isArray(background)) {
+        backgroundImage = generateSolidMap(1, 1, background);
+    }
+    else {
+        const texture = 'map' in background ? background.map : background;
+        if (!isTextureDataSource(texture.image))
+            return;
+        // Is rgbe data
+        backgroundImage = {
+            width: texture.image.width,
+            height: texture.image.height,
+            data: texture.image.data
+        };
+    }
+    return backgroundImage;
+}
+export function generateEnvMapFromSceneComponents(ambientLights, environmentLights) {
+    let envImage = initializeEnvMap(environmentLights);
+    if (ambientLights.length > 0 && environmentLights.length > 0) {
+        envImage = {
+            width: envImage.width,
+            height: envImage.height,
+            data: envImage.data.slice()
+        };
+    }
+    ambientLights.forEach((light) => {
+        addAmbientLightToEnvMap(light, envImage);
+    });
+    return envImage;
+}
+export function initializeEnvMap(environmentLights) {
+    let envImage;
+    // Initialize map from environment light if present
+    if (environmentLights.length > 0) {
+        // TODO: support multiple environment lights (what if they have different resolutions?)
+        const environmentLight = environmentLights[0];
+        envImage = {
+            width: environmentLight.map.image.width,
+            height: environmentLight.map.image.height,
+            data: environmentLight.map.image.data,
+            distributionCacheKey: environmentLight.map.source ??
+                environmentLight.map.image.data,
+            distributionCacheVersion: environmentLight.map.version
+        };
+    }
+    else {
+        // initialize blank map
+        envImage = generateSolidMap(DEFAULT_MAP_RESOLUTION.width, DEFAULT_MAP_RESOLUTION.height, [0, 0, 0, 1]);
+    }
+    return envImage;
+}
+export function generateSolidMap(width, height, color, intensity) {
+    const texels = width * height;
+    const floatBuffer = new Float32Array(texels * 4);
+    if (color && Array.isArray(color)) {
+        setBufferToColor(floatBuffer, color, intensity);
+    }
+    return {
+        width: width,
+        height: height,
+        data: floatBuffer
+    };
+}
+function setBufferToColor(buffer, color, intensity = 1) {
+    for (let i = 0; i < buffer.length;) {
+        buffer[i++] = color[0] * intensity;
+        buffer[i++] = color[1] * intensity;
+        buffer[i++] = color[2] * intensity;
+        buffer[i++] = color[3];
+    }
+    return buffer;
+}
+function addAmbientLightToEnvMap(light, image) {
+    const color = light.color;
+    const intensity = light.intensity;
+    const buffer = image.data;
+    for (let i = 0; i < buffer.length;) {
+        buffer[i++] += color[0] * intensity;
+        buffer[i++] += color[1] * intensity;
+        buffer[i++] += color[2] * intensity;
+        i++;
+    }
+}
+//# sourceMappingURL=envMapCreation.js.map

package/lib/renderer/envMapCreation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envMapCreation.js","sourceRoot":"","sources":["../../src/renderer/envMapCreation.ts"],"names":[],"mappings":"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","sourcesContent":["// Portions adapted from ray-tracing-renderer@0.10.15\n// (https://github.com/hoverinc/ray-tracing-renderer).\n// Copyright (c) 2019 HOVER, MIT license; see LICENSES/RayTracingRenderer-MIT.txt.\n\n// Convert image data from the RGBE format to a 32-bit floating point format\n// See https://www.cg.tuwien.ac.at/research/theses/matkovic/node84.html for a description of the RGBE format\n\nimport { ColorRGBA, WritableArrayLike } from '../types.js';\nimport Texture, {\n  isTextureDataSource,\n  TextureDataSource\n} from '../scene/Texture.js';\nimport AmbientLight from '../scene/AmbientLight.js';\nimport EnvironmentLight from '../scene/EnvironmentLight.js';\nimport { SceneBackground } from '../scene/Scene.js';\nimport type { EnvironmentMapSource } from './envMapDistribution.js';\n\nconst DEFAULT_MAP_RESOLUTION = {\n  width: 8,\n  height: 4\n};\n\n// Tools for generating and modify env maps for lighting from scene component data\n\nexport function generateBackgroundMapFromSceneBackground(\n  background: SceneBackground\n) {\n  let backgroundImage;\n\n  // Is [r,g,b,a] color\n  if (Array.isArray(background)) {\n    backgroundImage = generateSolidMap(1, 1, background);\n  } else {\n    const texture: Texture =\n      'map' in background ? background.map : (background as Texture);\n    if (!isTextureDataSource(texture.image)) return;\n    // Is rgbe data\n    backgroundImage = {\n      width: texture.image.width,\n      height: texture.image.height,\n      data: texture.image.data\n    };\n  }\n  return backgroundImage;\n}\n\nexport function generateEnvMapFromSceneComponents(\n  ambientLights: AmbientLight[],\n  environmentLights: EnvironmentLight[]\n) {\n  let envImage = initializeEnvMap(environmentLights);\n  if (ambientLights.length > 0 && environmentLights.length > 0) {\n    envImage = {\n      width: envImage.width,\n      height: envImage.height,\n      data: envImage.data.slice() as TextureDataSource['data']\n    };\n  }\n  ambientLights.forEach((light) => {\n    addAmbientLightToEnvMap(light, envImage);\n  });\n\n  return envImage;\n}\n\nexport function initializeEnvMap(environmentLights: EnvironmentLight[]) {\n  let envImage: EnvironmentMapSource;\n\n  // Initialize map from environment light if present\n  if (environmentLights.length > 0) {\n    // TODO: support multiple environment lights (what if they have different resolutions?)\n    const environmentLight = environmentLights[0];\n    envImage = {\n      width: environmentLight.map.image.width,\n      height: environmentLight.map.image.height,\n      data: (environmentLight.map.image as TextureDataSource).data,\n      distributionCacheKey:\n        environmentLight.map.source ??\n        (environmentLight.map.image as TextureDataSource).data,\n      distributionCacheVersion: environmentLight.map.version\n    };\n  } else {\n    // initialize blank map\n    envImage = generateSolidMap(\n      DEFAULT_MAP_RESOLUTION.width,\n      DEFAULT_MAP_RESOLUTION.height,\n      [0, 0, 0, 1]\n    );\n  }\n\n  return envImage;\n}\n\nexport function generateSolidMap(\n  width: number,\n  height: number,\n  color?: ColorRGBA,\n  intensity?: number\n): TextureDataSource {\n  const texels = width * height;\n  const floatBuffer = new Float32Array(texels * 4);\n  if (color && Array.isArray(color)) {\n    setBufferToColor(floatBuffer, color, intensity);\n  }\n  return {\n    width: width,\n    height: height,\n    data: floatBuffer\n  };\n}\n\nfunction setBufferToColor(\n  buffer: WritableArrayLike<number>,\n  color: ColorRGBA,\n  intensity = 1\n) {\n  for (let i = 0; i < buffer.length; ) {\n    buffer[i++] = color[0] * intensity;\n    buffer[i++] = color[1] * intensity;\n    buffer[i++] = color[2] * intensity;\n    buffer[i++] = color[3];\n  }\n\n  return buffer;\n}\n\nfunction addAmbientLightToEnvMap(\n  light: AmbientLight,\n  image: TextureDataSource\n) {\n  const color = light.color;\n  const intensity = light.intensity;\n  const buffer = image.data;\n\n  for (let i = 0; i < buffer.length; ) {\n    buffer[i++] += color[0] * intensity;\n    buffer[i++] += color[1] * intensity;\n    buffer[i++] += color[2] * intensity;\n    i++;\n  }\n}\n"]}

package/lib/renderer/envMapDistribution.d.ts

@@ -0,0 +1,9 @@
+import { TextureDataSource } from '../scene/Texture.js';
+export interface EnvironmentMapSource extends TextureDataSource {
+    /** Stable identity shared by adapters that recreate source wrappers. */
+    distributionCacheKey?: object;
+    /** Incremented whenever the source pixels change in place. */
+    distributionCacheVersion?: number;
+}
+export declare function environmentMapSourcesMatch(first: EnvironmentMapSource | undefined, second: EnvironmentMapSource | undefined): boolean;
+export declare function envMapDistribution(image: EnvironmentMapSource): TextureDataSource;

package/lib/renderer/envMapDistribution.js

@@ -0,0 +1,107 @@
+// Portions adapted from ray-tracing-renderer@0.10.15
+// (https://github.com/hoverinc/ray-tracing-renderer).
+// Copyright (c) 2019 HOVER, MIT license; see LICENSES/RayTracingRenderer-MIT.txt.
+const distributionCache = new WeakMap();
+function distributionCacheIdentity(image) {
+    return image.distributionCacheKey ?? image.data;
+}
+export function environmentMapSourcesMatch(first, second) {
+    if (first === second)
+        return true;
+    if (!first || !second)
+        return false;
+    return (distributionCacheIdentity(first) === distributionCacheIdentity(second) &&
+        first.width === second.width &&
+        first.height === second.height &&
+        (first.distributionCacheVersion ?? 0) ===
+            (second.distributionCacheVersion ?? 0));
+}
+export function envMapDistribution(image) {
+    const cacheKey = distributionCacheIdentity(image);
+    const version = image.distributionCacheVersion ?? 0;
+    const cached = distributionCache.get(cacheKey);
+    if (cached &&
+        cached.width === image.width &&
+        cached.height === image.height &&
+        cached.version === version) {
+        return cached.distribution;
+    }
+    const data = image.data;
+    const cdfImage = {
+        width: image.width + 2,
+        height: image.height + 1
+    };
+    const cdf = makeTextureArray(cdfImage.width, cdfImage.height, 2);
+    const channels = Math.max(Math.floor(data.length / (image.width * image.height)), 1);
+    const sourceScale = (data instanceof Uint8Array || data instanceof Uint8ClampedArray) ? 1 / 255 : 1;
+    const luminance = new Float32Array(image.width * image.height);
+    for (let y = 0; y < image.height; y++) {
+        for (let x = 0; x < image.width; x++) {
+            const sourceIndex = channels * (y * image.width + x);
+            luminance[y * image.width + x] =
+                sourceScale * (0.2126 * data[sourceIndex]
+                    + 0.7152 * data[sourceIndex + Math.min(1, channels - 1)]
+                    + 0.0722 * data[sourceIndex + Math.min(2, channels - 1)]);
+        }
+    }
+    // Environment radiance is read with bilinear filtering while the CDF is
+    // piecewise constant. Dilating luminance over the filter footprint keeps a
+    // sharp HDR sun from leaking into a neighbouring low-PDF cell and producing
+    // fireflies. This only changes the importance distribution, not the
+    // radiance integral, so the estimator remains unbiased.
+    const filteredLuminance = (x, y) => {
+        let maximum = 0;
+        for (let dy = -1; dy <= 1; dy++) {
+            const sourceY = Math.min(image.height - 1, Math.max(0, y + dy));
+            for (let dx = -1; dx <= 1; dx++) {
+                const sourceX = Math.min(image.width - 1, Math.max(0, x + dx));
+                maximum = Math.max(maximum, luminance[sourceY * image.width + sourceX]);
+            }
+        }
+        return Math.max(maximum, 1e-12);
+    };
+    for (let y = 0; y < image.height; y++) {
+        const sinTheta = Math.sin((Math.PI * (y + 0.5)) / image.height);
+        for (let x = 0; x < image.width; x++) {
+            const weight = filteredLuminance(x, y) * sinTheta;
+            cdf.set(x + 2, y, 0, cdf.get(x + 1, y, 0) + weight / image.width);
+            cdf.set(x + 1, y, 1, weight);
+        }
+        const rowIntegral = cdf.get(cdfImage.width - 1, y, 0);
+        for (let x = 1; x < cdf.width; x++) {
+            cdf.set(x, y, 0, cdf.get(x, y, 0) / rowIntegral);
+            cdf.set(x, y, 1, cdf.get(x, y, 1) / rowIntegral);
+        }
+        cdf.set(0, y + 1, 0, cdf.get(0, y, 0) + rowIntegral / image.height);
+        cdf.set(0, y, 1, rowIntegral);
+    }
+    const integral = cdf.get(0, cdf.height - 1, 0);
+    for (let y = 0; y < cdf.height; y++) {
+        cdf.set(0, y, 0, cdf.get(0, y, 0) / integral);
+        cdf.set(0, y, 1, cdf.get(0, y, 1) / integral);
+    }
+    cdfImage.data = cdf.array;
+    distributionCache.set(cacheKey, {
+        width: image.width,
+        height: image.height,
+        version,
+        distribution: cdfImage
+    });
+    return cdfImage;
+}
+function makeTextureArray(width, height, channels) {
+    const array = new Float32Array(channels * width * height);
+    return {
+        set(x, y, channel, val) {
+            array[channels * (y * width + x) + channel] = val;
+        },
+        get(x, y, channel) {
+            return array[channels * (y * width + x) + channel];
+        },
+        width,
+        height,
+        channels,
+        array
+    };
+}
+//# sourceMappingURL=envMapDistribution.js.map

package/lib/renderer/envMapDistribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envMapDistribution.js","sourceRoot":"","sources":["../../src/renderer/envMapDistribution.ts"],"names":[],"mappings":"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","sourcesContent":["// Portions adapted from ray-tracing-renderer@0.10.15\n// (https://github.com/hoverinc/ray-tracing-renderer).\n// Copyright (c) 2019 HOVER, MIT license; see LICENSES/RayTracingRenderer-MIT.txt.\n\n// Create a piecewise 2D cumulative distribution function of light intensity from an env map\n// http://www.pbr-book.org/3ed-2018/Monte_Carlo_Integration/2D_Sampling_with_Multidimensional_Transformations.html#Piecewise-Constant2DDistributions\n\nimport { TextureDataSource } from '../scene/Texture.js';\n\nexport interface EnvironmentMapSource extends TextureDataSource {\n  /** Stable identity shared by adapters that recreate source wrappers. */\n  distributionCacheKey?: object;\n  /** Incremented whenever the source pixels change in place. */\n  distributionCacheVersion?: number;\n}\n\ninterface DistributionCacheEntry {\n  width: number;\n  height: number;\n  version: number;\n  distribution: TextureDataSource;\n}\n\nconst distributionCache = new WeakMap<object, DistributionCacheEntry>();\n\nfunction distributionCacheIdentity(image: EnvironmentMapSource) {\n  return image.distributionCacheKey ?? image.data;\n}\n\nexport function environmentMapSourcesMatch(\n  first: EnvironmentMapSource | undefined,\n  second: EnvironmentMapSource | undefined\n) {\n  if (first === second) return true;\n  if (!first || !second) return false;\n  return (\n    distributionCacheIdentity(first) === distributionCacheIdentity(second) &&\n    first.width === second.width &&\n    first.height === second.height &&\n    (first.distributionCacheVersion ?? 0) ===\n      (second.distributionCacheVersion ?? 0)\n  );\n}\n\nexport function envMapDistribution(\n  image: EnvironmentMapSource\n): TextureDataSource {\n  const cacheKey = distributionCacheIdentity(image);\n  const version = image.distributionCacheVersion ?? 0;\n  const cached = distributionCache.get(cacheKey);\n  if (\n    cached &&\n    cached.width === image.width &&\n    cached.height === image.height &&\n    cached.version === version\n  ) {\n    return cached.distribution;\n  }\n  const data = image.data;\n\n  const cdfImage = {\n    width: image.width + 2,\n    height: image.height + 1\n  } as TextureDataSource;\n\n  const cdf = makeTextureArray(cdfImage.width, cdfImage.height, 2);\n\n  const channels = Math.max(\n    Math.floor(data.length / (image.width * image.height)),\n    1\n  );\n  const sourceScale = (data instanceof Uint8Array || data instanceof Uint8ClampedArray) ? 1 / 255 : 1;\n  const luminance = new Float32Array(image.width * image.height);\n  for (let y = 0; y < image.height; y++) {\n    for (let x = 0; x < image.width; x++) {\n      const sourceIndex = channels * (y * image.width + x);\n      luminance[y * image.width + x] =\n        sourceScale * (\n          0.2126 * data[sourceIndex]\n          + 0.7152 * data[sourceIndex + Math.min(1, channels - 1)]\n          + 0.0722 * data[sourceIndex + Math.min(2, channels - 1)]\n        );\n    }\n  }\n\n  // Environment radiance is read with bilinear filtering while the CDF is\n  // piecewise constant. Dilating luminance over the filter footprint keeps a\n  // sharp HDR sun from leaking into a neighbouring low-PDF cell and producing\n  // fireflies. This only changes the importance distribution, not the\n  // radiance integral, so the estimator remains unbiased.\n  const filteredLuminance = (x: number, y: number) => {\n    let maximum = 0;\n    for (let dy = -1; dy <= 1; dy++) {\n      const sourceY = Math.min(image.height - 1, Math.max(0, y + dy));\n      for (let dx = -1; dx <= 1; dx++) {\n        const sourceX = Math.min(image.width - 1, Math.max(0, x + dx));\n        maximum = Math.max(\n          maximum,\n          luminance[sourceY * image.width + sourceX]\n        );\n      }\n    }\n    return Math.max(maximum, 1e-12);\n  };\n\n  for (let y = 0; y < image.height; y++) {\n    const sinTheta = Math.sin((Math.PI * (y + 0.5)) / image.height);\n    for (let x = 0; x < image.width; x++) {\n      const weight = filteredLuminance(x, y) * sinTheta;\n      cdf.set(x + 2, y, 0, cdf.get(x + 1, y, 0) + weight / image.width);\n      cdf.set(x + 1, y, 1, weight);\n    }\n\n    const rowIntegral = cdf.get(cdfImage.width - 1, y, 0);\n\n    for (let x = 1; x < cdf.width; x++) {\n      cdf.set(x, y, 0, cdf.get(x, y, 0) / rowIntegral);\n      cdf.set(x, y, 1, cdf.get(x, y, 1) / rowIntegral);\n    }\n\n    cdf.set(0, y + 1, 0, cdf.get(0, y, 0) + rowIntegral / image.height);\n    cdf.set(0, y, 1, rowIntegral);\n  }\n\n  const integral = cdf.get(0, cdf.height - 1, 0);\n\n  for (let y = 0; y < cdf.height; y++) {\n    cdf.set(0, y, 0, cdf.get(0, y, 0) / integral);\n    cdf.set(0, y, 1, cdf.get(0, y, 1) / integral);\n  }\n  cdfImage.data = cdf.array;\n\n  distributionCache.set(cacheKey, {\n    width: image.width,\n    height: image.height,\n    version,\n    distribution: cdfImage\n  });\n\n  return cdfImage;\n}\n\nfunction makeTextureArray(width: number, height: number, channels: number) {\n  const array = new Float32Array(channels * width * height);\n\n  return {\n    set(x: number, y: number, channel: number, val: number) {\n      array[channels * (y * width + x) + channel] = val;\n    },\n    get(x: number, y: number, channel: number) {\n      return array[channels * (y * width + x) + channel];\n    },\n    width,\n    height,\n    channels,\n    array\n  };\n}\n"]}

package/lib/renderer/float16.d.ts

@@ -0,0 +1 @@
+export declare function float16Bits(value: number): number;

package/lib/renderer/float16.js

@@ -0,0 +1,19 @@
+// Round to nearest, ties to even, matching RGBA16F storage on both backends.
+function roundEven(value) {
+    const integer = Math.floor(value);
+    const fraction = value - integer;
+    return integer + Number(fraction > 0.5 || fraction === 0.5 && integer % 2 === 1);
+}
+export function float16Bits(value) {
+    const sign = value < 0 || Object.is(value, -0) ? 0x8000 : 0;
+    const absolute = Math.abs(value);
+    if (Number.isNaN(absolute))
+        return 0x7e00;
+    if (absolute >= 65520)
+        return sign | 0x7c00;
+    if (absolute < 2 ** -14)
+        return sign | roundEven(absolute * 2 ** 24);
+    const exponent = Math.floor(Math.log2(absolute));
+    return sign | ((exponent + 14) * 1024 + roundEven(absolute / 2 ** (exponent - 10)));
+}
+//# sourceMappingURL=float16.js.map

package/lib/renderer/float16.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"float16.js","sourceRoot":"","sources":["../../src/renderer/float16.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IACjC,OAAO,OAAO,GAAG,MAAM,CAAC,QAAQ,GAAG,GAAG,IAAI,QAAQ,KAAK,GAAG,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACjC,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC;IAC1C,IAAI,QAAQ,IAAI,KAAK;QAAE,OAAO,IAAI,GAAG,MAAM,CAAC;IAC5C,IAAI,QAAQ,GAAG,CAAC,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,GAAG,SAAS,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACjD,OAAO,IAAI,GAAG,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;AACtF,CAAC","sourcesContent":["// Round to nearest, ties to even, matching RGBA16F storage on both backends.\nfunction roundEven(value: number) {\n  const integer = Math.floor(value);\n  const fraction = value - integer;\n  return integer + Number(fraction > 0.5 || fraction === 0.5 && integer % 2 === 1);\n}\n\nexport function float16Bits(value: number): number {\n  const sign = value < 0 || Object.is(value, -0) ? 0x8000 : 0;\n  const absolute = Math.abs(value);\n  if (Number.isNaN(absolute)) return 0x7e00;\n  if (absolute >= 65520) return sign | 0x7c00;\n  if (absolute < 2 ** -14) return sign | roundEven(absolute * 2 ** 24);\n  const exponent = Math.floor(Math.log2(absolute));\n  return sign | ((exponent + 14) * 1024 + roundEven(absolute / 2 ** (exponent - 10)));\n}\n"]}

package/lib/renderer/geometryBvh.d.ts

@@ -0,0 +1,11 @@
+import type { TinyBvhLayout } from '../tinybvh/TinyBvhBuilder.js';
+import type Geometry from '../scene/Geometry.js';
+import type { FlattendBVH } from './bvhAccel.js';
+export interface BvhBuildConfig {
+    builder: 'builtin' | 'tinybvh';
+    layout: TinyBvhLayout;
+    spatialSplits: boolean;
+}
+export declare function geometryBvhConfigMatches(geometry: Geometry, config: BvhBuildConfig): boolean;
+export declare function getGeometryBvh(geometry: Geometry): FlattendBVH | undefined;
+export declare function setGeometryBvh(geometry: Geometry, bvh: FlattendBVH | undefined, config?: BvhBuildConfig): void;