@miris-inc/core 0.0.8-e3d6727 → 0.0.8-e3fcc2a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miris-inc/core",
-  "version": "0.0.8-e3d6727",
+  "version": "0.0.8-e3fcc2a",
   "description": "Core scene-graph runtime for the Miris 3D streaming SDK. WASM-backed Engine, Client, Scene, Stream, and LOD primitives shared by all higher-level packages.",
   "keywords": [
     "3d",

package/webshark.d.ts

@@ -56,6 +56,23 @@ export interface RenderState {
     height: number,
     splatTriangles: number,
   ): void;
+  // Decodes Radiance .hdr bytes into roughness-ladder level `level` (0 is the sharp mirror).
+  // hdrPtr must address THIS module's heap - _malloc here and copy the bytes in.
+  // Returns false for bytes that are not a usable Radiance image, or a level out of range.
+  uploadEnvironmentLadderLevelFromHdr(
+    level: number,
+    sigmaDeg: number,
+    hdrPtr: number,
+    hdrSizeBytes: number,
+  ): boolean;
+  // Republish the ladder's shape. Call after any level lands, or it is sampled at whatever shape
+  // the last uploadSplatSetData declared. Pass SplatSet.hasReflectionParams().
+  uploadReflectionLadderParams(reflectionsEnabled: boolean): void;
+  // Debug controls. Drop the reflection term, or replace the surfel colour with one of the layers
+  // it is shaded from (0 off, 1 world normals, 2 reflectance, 3 roughness, 4 reflection,
+  // 6 base colour, 18 surfel index).
+  setReflectionsEnabled(enabled: boolean): void;
+  setDebugAovMode(mode: number): void;
 }
 
 export interface vec4 {
@@ -83,6 +100,10 @@ export interface SplatSet {
   sh2View(): Uint32Array;
   sh3aView(): Uint32Array;
   sh3bView(): Uint32Array;
+  // mod_depth is a half-float per primitive slot (dense, padded for non-surfels), so this is a
+  // Uint16Array unlike every other view here -- do not address it with the uint32 splat strides
+  // used for ellipsoids/colors/sh*.
+  modDepthView(): Uint16Array;
   // Per-chunk fade (opacity multiplier), one float per chunk, defaults to 1.0.
   // Also sizes the chunk slot to model root slot map below, since both are indexed by chunk slot
   resizeChunkFades(chunkCount: number): void;
@@ -108,6 +129,26 @@ export interface SplatSet {
   // like finalize() but keeps splats in their delivered (octant-sorted) order — no kd-tree reorder —
   // so sparse-octant range masking can index child-octant ranges directly. RADIX_SORT only.
   finalizeBounds(): void;
+  // Whether the asset carries per-surfel reflectance records, which is what decides whether
+  // reflections are shaded at all. Pass to RenderState.uploadReflectionLadderParams.
+  hasReflectionParams(): boolean;
+  // Widens packed 26-byte reflectanceDataV1 records into the per-splat GPU records at
+  // bufferOffset. wirePtr must address THIS module's heap - _malloc here and copy the bytes in,
+  // since the attribute lives in the engine module's. Records cover a node's surfel range, which
+  // starts at its first splat. Returns the records written; 0 if the data was rejected.
+  decodeReflectionParams(
+    wirePtr: number,
+    wireSizeBytes: number,
+    elementCount: number,
+    bufferOffset: number,
+    nodeSplatCount: number,
+    logId: number,
+  ): number;
+  // Zeroes records in [startSplat, endSplat). Needed wherever splats are re-packed at fresh
+  // offsets, or a reused slot shades its splat from the previous occupant's material.
+  clearReflectionParams(startSplat: number, endSplat: number): void;
+  // Splats in [0, count) holding a non-zero record. Diagnostic.
+  populatedReflectionParamCount(count: number): number;
 }
 
 export interface WebGPUInterface {
@@ -157,6 +198,13 @@ export interface MainModule {
 
   WebGPU: WebGPUInterface;
 
+  // Emscripten runtime, exported by modules/shark/CMakeLists.txt. The pointer-taking bindings
+  // above address THIS heap, so bytes from the engine module have to be staged through it.
+  // HEAPU8 is replaced whenever the heap grows, so read it fresh rather than caching it.
+  _malloc(byteCount: number): number;
+  _free(ptr: number): void;
+  readonly HEAPU8: Uint8Array;
+
   uploadSplatSetData(
     set: SplatSet,
     renderState: RenderState,