@miris-inc/core 0.0.8-a932469 → 0.0.8-a997939

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miris-inc/core",
-  "version": "0.0.8-a932469",
+  "version": "0.0.8-a997939",
   "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, numbered as RenderViewModes.h's AOV_* defines. setRenderView below sets
+  // the AOV together with the rest of a named view.
+  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;
@@ -102,12 +123,80 @@ export interface SplatSet {
   modelRootInverseTransformsView(): Float32Array;
   // Sized by resizeChunkFades. Defaults to slot 0 (identity) for every chunk
   chunkModelRootsView(): Int32Array;
+  // resizeModelRootSlots resets every slot to the absolute decode. False for a slot outside the table
+  setModelRootRootRelativeDecode(
+    slot: number,
+    originX: number,
+    originY: number,
+    originZ: number,
+    step: number,
+  ): boolean;
   // int32 render-order buffer (sized 2*splatCount after finalize). Valid only until the next resize.
   orderingView(): Int32Array;
   finalize(): void;
   // 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 GlassMeshRegistry {
+  // Decodes one octree node's glass payload and registers it, replacing any previous entry for
+  // that object. False for a malformed or empty payload, leaving the registry unchanged.
+  //
+  // The two slot arguments are different numbers here, unlike on the native path, and swapping
+  // them renders glass that does not follow its asset: modelRootSlot scopes the panel dedupe to
+  // one asset instance, while chunkModelRootIndex is stamped into every vertex and read back as
+  // chunkModelRoots[pos.w], so that one takes the chunk's fade slot.
+  //
+  // geometryPtr/panelPtr address THIS module's heap - _malloc here and copy the bytes in, since
+  // the attributes live in the engine module's. The AABB is the geometry attribute's own range.
+  registerObject(
+    objectId: number,
+    lodIndex: number,
+    modelRootSlot: number,
+    chunkModelRootIndex: number,
+    geometryPtr: number,
+    geometryByteCount: number,
+    panelPtr: number,
+    panelByteCount: number,
+    aabbMinX: number,
+    aabbMinY: number,
+    aabbMinZ: number,
+    aabbMaxX: number,
+    aabbMaxY: number,
+    aabbMaxZ: number,
+  ): boolean;
+  // Returns true if the object had glass, which is what says the buffers need rebuilding.
+  removeObject(objectId: number): boolean;
+  clear(): void;
+  isDirty(): boolean;
+  // Rebuilds the flattened buffers, keeping each panel from its deepest resident LOD. Stays dirty
+  // so uploadIfDirty still fires. Walks every registered object, so not per frame.
+  flattenIfDirty(): void;
+  uploadIfDirty(renderState: RenderState): void;
+  vertexCount(): number;
+  panelCount(): number;
+  delete(): void;
 }
 
 export interface WebGPUInterface {
@@ -120,6 +209,7 @@ export interface MainModule {
   Camera: new () => Camera;
   RenderState: new () => RenderState;
   SplatSet: new () => SplatSet;
+  GlassMeshRegistry: new () => GlassMeshRegistry;
   vec4: new (x: number, y: number, z: number, w: number) => vec4;
 
   SortType: {
@@ -157,6 +247,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,
@@ -192,6 +289,15 @@ export interface MainModule {
     depthTarget: number,
     renderGES: boolean,
   ): void;
+  // Render view registry, indexed as RenderViews.h orders it. setRenderView ignores an index
+  // Shark cannot produce.
+  setRenderView(viewIndex: number): void;
+  renderView(): number;
+  renderViewCount(): number;
+  renderViewName(viewIndex: number): string;
+  renderViewSupported(viewIndex: number): boolean;
+  // The next supported view, forwards for direction 1 and backwards for -1.
+  stepRenderView(from: number, direction: number): number;
 }
 
 declare function WebShark(