@miris-inc/core 0.0.8-e627096 → 0.0.8-e68f11f

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miris-inc/core",
-  "version": "0.0.8-e627096",
+  "version": "0.0.8-e68f11f",
   "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

@@ -5,6 +5,9 @@ export interface Camera {
   eye: vec4;
   l: number;
   fov: number;
+  zNear: number;
+  zFar: number;
+  delete(): void;
 }
 
 export interface SortTypeValue {
@@ -31,9 +34,11 @@ export interface RendererWGPU {
   getEstimatedTextureSize(): number;
   getTotalBufferSize(): number;
   info: SharkInfo;
+  delete(): void;
 }
 
 export interface RenderState {
+  delete(): void;
   initRenderState(
     renderer: RendererWGPU,
     width: number,
@@ -69,9 +74,12 @@ export interface RenderState {
   // 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).
+  // 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;
+  // Render textured gaussians on pixels no surfel covers, resolved as fvdb's open gate does.
+  // Off by default: those pixels show the clear colour.
+  setSurfelLessTextureSplatsEnabled(enabled: boolean): void;
   setDebugAovMode(mode: number): void;
 }
 
@@ -123,6 +131,15 @@ 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,
+    lnScaleOffset: number,
+  ): boolean;
   // int32 render-order buffer (sized 2*splatCount after finalize). Valid only until the next resize.
   orderingView(): Int32Array;
   finalize(): void;
@@ -132,11 +149,13 @@ export interface SplatSet {
   // 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.
+  // Widens packed reflectance records - recordVersion 2 for 18-byte reflectanceDataV2, 1 for
+  // 26-byte reflectanceDataV1 - 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(
+    recordVersion: number,
     wirePtr: number,
     wireSizeBytes: number,
     elementCount: number,
@@ -149,6 +168,47 @@ export interface SplatSet {
   clearReflectionParams(startSplat: number, endSplat: number): void;
   // Splats in [0, count) holding a non-zero record. Diagnostic.
   populatedReflectionParamCount(count: number): number;
+  delete(): void;
+}
+
+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 {
@@ -161,6 +221,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: {
@@ -233,6 +294,8 @@ export interface MainModule {
   createRendererWGPUWithoutSurface(
     colorTargetFormat: TextureFormatValue,
   ): RendererWGPU;
+  /// Gives back the reference WebGPU.importJsTexture returned for a texture.
+  releaseImportedTexture(texture: number): void;
   renderSplatSetToSceneTextures(
     splatSet: SplatSet,
     renderState: RenderState,
@@ -240,6 +303,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(