@meimu/mutracer 0.1.5 → 0.3.0

package/lib/renderer/ownedDenoiser.d.ts

@@ -0,0 +1,9 @@
+import type { JNLMDenoiser } from './jnlm.js';
+import type { OIDNDenoiser } from './oidnNetwork.js';
+export type OwnedDenoiser = {
+    kind: 'jnlm';
+    denoiser: JNLMDenoiser;
+} | {
+    kind: 'oidn';
+    denoiser: OIDNDenoiser;
+};

package/lib/renderer/ownedDenoiser.js

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

package/lib/renderer/ownedDenoiser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownedDenoiser.js","sourceRoot":"","sources":["../../src/renderer/ownedDenoiser.ts"],"names":[],"mappings":"","sourcesContent":["import type {JNLMDenoiser} from './jnlm.js';\nimport type {OIDNDenoiser} from './oidnNetwork.js';\n\n// Keep concrete OIDN types out of the public declaration graph: diagnostics\n// depend on denoiser.ts, but only Engine/Render own network implementations.\nexport type OwnedDenoiser =\n  | {kind: 'jnlm'; denoiser: JNLMDenoiser}\n  | {kind: 'oidn'; denoiser: OIDNDenoiser};\n"]}

package/lib/renderer/packedMeshInstances.d.ts

@@ -0,0 +1,23 @@
+import type { TLASInstance } from './bvhAccel.js';
+/** CPU instance records in numeric storage; one reusable synchronous read view. */
+export declare class PackedMeshInstances {
+    length: number;
+    readonly transforms: Float64Array;
+    readonly colors: Float32Array;
+    readonly bounds: Float32Array;
+    readonly blasIndices: Uint32Array;
+    readonly materials: Int32Array;
+    readonly displacement: Float64Array;
+    readonly sourceIndices: Uint32Array;
+    bindingSlots: number[][];
+    readonly bindingIndices: Uint32Array;
+    readonly localIndices: Uint32Array;
+    private readonly view;
+    constructor(capacity: number);
+    copy(): PackedMeshInstances;
+    read(index: number): TLASInstance;
+}
+export type MeshInstances = TLASInstance[] | PackedMeshInstances;
+export declare function readMeshInstance(instances: MeshInstances, index: number): TLASInstance;
+export declare function sameInstanceMembership(a: MeshInstances, b: MeshInstances): boolean;
+export declare function meshInstancesLength(instances: MeshInstances): number;

package/lib/renderer/packedMeshInstances.js

@@ -0,0 +1,80 @@
+import { Box3 } from './Box3.js';
+import { write } from '../math/access.js';
+/** CPU instance records in numeric storage; one reusable synchronous read view. */
+export class PackedMeshInstances {
+    length = 0;
+    transforms;
+    colors;
+    bounds;
+    blasIndices;
+    materials;
+    displacement;
+    sourceIndices;
+    bindingSlots = [];
+    bindingIndices;
+    localIndices;
+    view = { blasIndex: 0, bounds: new Box3(), transform: new Float64Array(16), materialsIndices: [0], color: [1, 1, 1] };
+    constructor(capacity) {
+        this.bindingIndices = new Uint32Array(capacity);
+        this.localIndices = new Uint32Array(capacity);
+        this.colors = new Float32Array(capacity * 3);
+        this.transforms = new Float64Array(capacity * 16);
+        this.bounds = new Float32Array(capacity * 6);
+        this.blasIndices = new Uint32Array(capacity);
+        this.materials = new Int32Array(capacity);
+        this.displacement = new Float64Array(capacity);
+        this.sourceIndices = new Uint32Array(capacity);
+    }
+    copy() {
+        const next = new PackedMeshInstances(this.transforms.length / 16);
+        next.length = this.length;
+        next.bindingSlots = this.bindingSlots;
+        next.transforms.set(this.transforms);
+        next.bounds.set(this.bounds);
+        next.colors.set(this.colors);
+        next.blasIndices.set(this.blasIndices);
+        next.materials.set(this.materials);
+        next.displacement.set(this.displacement);
+        next.sourceIndices.set(this.sourceIndices);
+        next.bindingIndices.set(this.bindingIndices);
+        next.localIndices.set(this.localIndices);
+        return next;
+    }
+    read(index) {
+        const v = this.view;
+        v.blasIndex = this.blasIndices[index];
+        v.materialsIndices[0] = this.materials[index];
+        v.displacementScale = this.displacement[index];
+        for (let i = 0; i < 16; i++)
+            write(v.transform, i, this.transforms[index * 16 + i]);
+        // Tuple-to-array conversion uses different native storage; update the tuple directly.
+        const color = v.color;
+        color[0] = this.colors[index * 3];
+        color[1] = this.colors[index * 3 + 1];
+        color[2] = this.colors[index * 3 + 2];
+        for (let i = 0; i < 3; i++) {
+            write(v.bounds.min, i, this.bounds[index * 6 + i]);
+            write(v.bounds.max, i, this.bounds[index * 6 + i + 3]);
+        }
+        return v;
+    }
+}
+export function readMeshInstance(instances, index) {
+    return Array.isArray(instances) ? instances[index] : instances.read(index);
+}
+export function sameInstanceMembership(a, b) {
+    if (meshInstancesLength(a) !== meshInstancesLength(b))
+        return false;
+    if (!Array.isArray(a) && !Array.isArray(b)) {
+        for (let i = 0; i < a.length; i++)
+            if (a.sourceIndices[i] !== b.sourceIndices[i])
+                return false;
+    }
+    return true;
+}
+export function meshInstancesLength(instances) {
+    if (Array.isArray(instances))
+        return instances.length;
+    return instances.length;
+}
+//# sourceMappingURL=packedMeshInstances.js.map

package/lib/renderer/packedMeshInstances.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packedMeshInstances.js","sourceRoot":"","sources":["../../src/renderer/packedMeshInstances.ts"],"names":[],"mappings":"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","sourcesContent":["import { Box3 } from './Box3.js';\nimport { write } from '../math/access.js';\nimport type { TLASInstance } from './bvhAccel.js';\n\n/** CPU instance records in numeric storage; one reusable synchronous read view. */\nexport class PackedMeshInstances {\n  length = 0;\n  readonly transforms: Float64Array;\n  readonly colors: Float32Array;\n  readonly bounds: Float32Array;\n  readonly blasIndices: Uint32Array;\n  readonly materials: Int32Array;\n  readonly displacement: Float64Array;\n  readonly sourceIndices: Uint32Array;\n  bindingSlots: number[][] = [];\n  readonly bindingIndices: Uint32Array;\n  readonly localIndices: Uint32Array;\n  private readonly view: TLASInstance = {blasIndex: 0, bounds: new Box3(), transform: new Float64Array(16), materialsIndices: [0], color: [1,1,1]};\n  constructor(capacity: number) {\n    this.bindingIndices = new Uint32Array(capacity); this.localIndices = new Uint32Array(capacity);\n    this.colors = new Float32Array(capacity * 3);\n    this.transforms = new Float64Array(capacity * 16); this.bounds = new Float32Array(capacity * 6);\n    this.blasIndices = new Uint32Array(capacity); this.materials = new Int32Array(capacity); this.displacement = new Float64Array(capacity); this.sourceIndices = new Uint32Array(capacity);\n  }\n  copy(): PackedMeshInstances {\n    const next = new PackedMeshInstances(this.transforms.length / 16);\n    next.length = this.length; next.bindingSlots = this.bindingSlots;\n    next.transforms.set(this.transforms); next.bounds.set(this.bounds); next.colors.set(this.colors);\n    next.blasIndices.set(this.blasIndices); next.materials.set(this.materials); next.displacement.set(this.displacement);\n    next.sourceIndices.set(this.sourceIndices); next.bindingIndices.set(this.bindingIndices); next.localIndices.set(this.localIndices);\n    return next;\n  }\n  read(index: number): TLASInstance {\n    const v = this.view;\n    v.blasIndex = this.blasIndices[index]; v.materialsIndices[0] = this.materials[index]; v.displacementScale = this.displacement[index];\n    for (let i = 0; i < 16; i++) write(v.transform, i, this.transforms[index * 16 + i]);\n    // Tuple-to-array conversion uses different native storage; update the tuple directly.\n    const color = v.color!;\n    color[0] = this.colors[index * 3];\n    color[1] = this.colors[index * 3 + 1];\n    color[2] = this.colors[index * 3 + 2];\n    for (let i = 0; i < 3; i++) {write(v.bounds.min, i, this.bounds[index * 6 + i]); write(v.bounds.max, i, this.bounds[index * 6 + i + 3]);}\n    return v;\n  }\n}\nexport type MeshInstances = TLASInstance[] | PackedMeshInstances;\nexport function readMeshInstance(instances: MeshInstances, index: number) {\n  return Array.isArray(instances) ? instances[index] : instances.read(index);\n}\n\nexport function sameInstanceMembership(a: MeshInstances, b: MeshInstances) {\n  if (meshInstancesLength(a) !== meshInstancesLength(b)) return false;\n  if (!Array.isArray(a) && !Array.isArray(b)) {\n    for (let i = 0; i < a.length; i++) if (a.sourceIndices[i] !== b.sourceIndices[i]) return false;\n  }\n  return true;\n}\n\nexport function meshInstancesLength(instances: MeshInstances): number {\n  if (Array.isArray(instances)) return instances.length;\n  return instances.length;\n}\n"]}

package/lib/renderer/prepareMeshBVH.d.ts

@@ -1,37 +1,14 @@
-import { PackedMeshInstances, type MeshInstances } from './meshInstances.js';
+import { type PreparedMeshInstanceBinding as SharedInstanceBinding } from './scenePreparation.js';
+import { type MeshInstances } from './meshInstances.js';
 import { type BvhBuildConfig } from './geometryBvh.js';
-import { mat4, vec2, vec3 } from '../math.js';
+export { sphericalProjectionTriangle, triplanarProjectionTriangle } from './displacementPreparation.js';
 import Geometry from '../scene/Geometry.js';
 import Mesh from '../scene/Mesh.js';
 import OpenPBRMaterial from '../scene/OpenPBRMaterial.js';
-import { TLASInstance } from './bvhAccel.js';
 import Texture from '../scene/Texture.js';
-export declare function getBvhBounds(geometry: Geometry): [vec3.Vec3Array, vec3.Vec3Array];
-export declare function computeBounds(_geometry: Geometry, m: mat4.Mat4Array, bvhBounds: [vec3.Vec3Array, vec3.Vec3Array], result?: {
-    min: any;
-    max: any;
-}, p?: any): {
-    min: any;
-    max: any;
-};
-export interface PreparedMeshInstanceBinding {
-    mesh: Mesh;
-    geometry: Geometry;
-    blasIndex: number;
-    materialIndices: number[];
-    displacementScale: number;
-    bvhBounds: [vec3.Vec3Array, vec3.Vec3Array];
-}
-export declare function updateMeshInstanceTransforms(bindings: PreparedMeshInstanceBinding[], current?: MeshInstances, dirtyIndices?: ReadonlySet<number>): PackedMeshInstances | TLASInstance[] | {
-    bounds: {
-        min: any;
-        max: any;
-    };
-    blasIndex: number;
-    transform: import("../types.js").Mat4;
-    materialsIndices: number[];
-    displacementScale: number;
-}[];
+export { getBvhBounds } from './geometryBvhBounds.js';
+export { computeBounds, updateMeshInstanceTransforms } from './scenePreparation.js';
+export type PreparedMeshInstanceBinding = SharedInstanceBinding<Mesh>;
 /** Returns the first material used for CPU displacement. */
 export declare function getMeshDisplacementMaterial(mesh: Mesh): OpenPBRMaterial;
 export declare function getMeshDisplacementMap(mesh: Mesh): Texture | undefined;
@@ -43,16 +20,14 @@ export declare function cachePreparedMeshGeometry(mesh: Mesh, generated: Geometr
 /** Returns cached prepared geometry, or the source while asynchronous preparation is pending. */
 export declare function getPreparedMeshGeometry(mesh: Mesh): Geometry;
 export declare function computeMinmaxCPU(_geometry: Geometry, heightImage: Texture['image']): Uint8Array<ArrayBufferLike>[];
-export declare function sphericalProjectionTriangle(na: vec3.Vec3Array, nb: vec3.Vec3Array, nc: vec3.Vec3Array, uvA: vec2.Vec2Array, uvB: vec2.Vec2Array, uvC: vec2.Vec2Array): boolean;
-export declare function triplanarProjectionTriangle(a: vec3.Vec3Array, b: vec3.Vec3Array, c: vec3.Vec3Array, na: vec3.Vec3Array, nb: vec3.Vec3Array, nc: vec3.Vec3Array, uvA: vec2.Vec2Array, uvB: vec2.Vec2Array, uvC: vec2.Vec2Array): void;
-export declare function getTrianglesDisplacementRange(geometry: Geometry, heightTexture: Texture | undefined, material: OpenPBRMaterial): Float32Array<ArrayBuffer> | undefined;
+export declare function getTrianglesDisplacementRange(geometry: Geometry, heightTexture: Texture | undefined, material: OpenPBRMaterial): Float32Array<ArrayBufferLike> | undefined;
 /** Prepare auto-generated source attributes before the renderer captures array identities. */
 export declare function ensureMeshGeometryAttributes(meshes: readonly Mesh[]): void;
 /** Geometry and displacement inputs shared by synchronous and Worker BLAS builds. */
 export declare function getMeshBlasInput(mesh: Mesh): {
     geometry: Geometry;
     displacementScale: number;
-    trianglesDisplacement: Float32Array<ArrayBuffer> | undefined;
+    trianglesDisplacement: Float32Array<ArrayBufferLike> | undefined;
 };
 /** Whether a static mesh still needs a BLAS before it can be rendered. */
 export declare function meshNeedsStaticBvh(mesh: Mesh, config?: BvhBuildConfig): boolean;
@@ -80,21 +55,12 @@ export declare function updateMeshInstances(meshes: Mesh[], options?: {
     }>;
     geometryStates: Map<Geometry, {
         topologyVersion: number;
-        indices: Uint16Array<ArrayBufferLike> | Uint32Array<ArrayBufferLike>;
+        indices: Uint16Array<ArrayBufferLike> | Uint32Array<ArrayBufferLike> | Uint16Array<ArrayBufferLike> | Uint32Array<ArrayBufferLike>;
         indexCount: number;
     }>;
-    instances: PackedMeshInstances | TLASInstance[] | {
-        bounds: {
-            min: any;
-            max: any;
-        };
-        blasIndex: number;
-        transform: import("../types.js").Mat4;
-        materialsIndices: number[];
-        displacementScale: number;
-    }[];
+    instances: MeshInstances;
     materials: OpenPBRMaterial[];
-    instanceBindings: PreparedMeshInstanceBinding[];
+    instanceBindings: SharedInstanceBinding<Mesh>[];
     emissiveBindings: {
         mesh: Mesh;
         geometry: Geometry;
@@ -106,7 +72,6 @@ export declare function updateMeshInstances(meshes: Mesh[], options?: {
         trainglesCount: number;
     }[];
 };
-/** Batch records are regenerated together; refit all numeric source slots. */
-export declare function dirtyMeshInstanceIndices(bindings: PreparedMeshInstanceBinding[], meshes: ReadonlySet<Mesh>, instances: MeshInstances): Set<number>;
+export { dirtyPreparedInstanceIndices as dirtyMeshInstanceIndices } from './scenePreparation.js';
 /** Refreshes color storage without computing transforms or bounds. Returns packed source slots. */
 export declare function updateMeshInstanceColors(bindings: PreparedMeshInstanceBinding[], instances: MeshInstances, meshes: ReadonlySet<Mesh>): Set<number>;