@miris-inc/core 0.0.8-9d53d06 → 0.0.8-9ed4bbb

package/webshark.d.ts

@@ -1,352 +0,0 @@
-export interface Camera {
-  dir: vec4;
-  U: vec4;
-  V: vec4;
-  eye: vec4;
-  l: number;
-  fov: number;
-}
-
-export interface Ellipsoid {
-  pos: vec4;
-  radii: vec4;
-  orientation: vec4;
-}
-
-export interface SphericalHarmonic {
-  col: vec4;
-  sh_0_1: vec4;
-  sh_0_2: vec4;
-  sh_0_3: vec4;
-}
-
-export interface AABB {
-  minExt: vec4;
-  maxExt: vec4;
-}
-
-export interface EmVector<T> {
-  push_back(value: T): void;
-  resize(count: number, value: T): void;
-  size(): number;
-  get(index: number): T | undefined;
-  set(index: number, value: T): boolean;
-  delete(): void;
-}
-
-export type EllipsoidVector = EmVector<Ellipsoid>;
-export type SphericalHarmonicVector = EmVector<SphericalHarmonic>;
-
-export interface SortTypeValue {
-  value: number;
-}
-
-export interface TextureFormatValue {
-  value: number;
-}
-
-export interface SharkComputeInfo {
-  dispatchCalls: number;
-  frameDispatchCalls: number;
-}
-
-export interface SharkRenderInfo {
-  totalRenderCalls: number;
-  frameRenderCalls: number;
-  triangles: number;
-  splats: number;
-}
-
-export interface SharkInfo {
-  renderCalls: number;
-  compute: SharkComputeInfo;
-  render: SharkRenderInfo;
-  reset(): void;
-}
-
-export interface RendererWGPU {
-  configureSurface(width: number, height: number): boolean;
-  getProgramCount(): number;
-  getTextureCount(): number;
-  getEstimatedTextureSize(): number;
-  getBufferCount(): number;
-  getTotalBufferSize(): number;
-  getBufferTypeSize(type: number): number;
-  surfaceFormat: TextureFormatValue;
-  info: SharkInfo;
-}
-
-export interface RenderState {
-  initRenderState(
-    renderer: RendererWGPU,
-    width: number,
-    height: number,
-    vertices: number,
-    splats: number,
-    cubes: number,
-    sortThreads: number,
-    sortGroupSize: number,
-    sortKeySize: number,
-  ): void;
-  initGraphicsState(
-    width: number,
-    height: number,
-    renderTextureFormat: TextureFormat,
-  ): void;
-  updateRenderDetails(
-    width: number,
-    height: number,
-    splatTriangles: number,
-  ): void;
-  uploadEllipsoids(ellipsoids: EllipsoidVector): void;
-  uploadSphericalHarmonics(sh: SphericalHarmonicVector): void;
-  uploadSphericalHarmonicsSOGs(sh: SphericalHarmonicVector): void;
-}
-
-export interface vec4 {
-  x: number;
-  y: number;
-  z: number;
-  w: number;
-  delete(): void;
-}
-
-export interface SplatSet {
-  splatCount: number;
-  // Number of splats actually drawn: ordering[0, activeSplats) holds the unmasked splat indices.
-  // Set alongside orderingView() to restrict the draw to unmasked octant ranges.
-  activeSplats: number;
-  setData(
-    splatCount: number,
-    ellipsoids: number,
-    sphericalHarmonics: number,
-  ): void;
-  // direct-write upload: resize -> write into the views -> finalize.
-  // views are valid only until the next resize.
-  resize(splatCount: number): void;
-  ellipsoidsView(): Uint32Array;
-  sphericalHarmonicsView(): Uint32Array;
-  sh1View(): Uint32Array;
-  sh2View(): Uint32Array;
-  sh3aView(): Uint32Array;
-  sh3bView(): Uint32Array;
-  // 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;
-  chunkFadesView(): Float32Array;
-  // Per-splat chunk index, defaults to slot 0. Write before finalize()
-  chunkIndicesView(): Int32Array;
-  // Model transforms, resolved per splat as
-  //   modelRootTransforms[chunkModelRoots[chunkIndices[splat]]]
-  // Slot 0 of both tables is reserved as identity, so real slots start at 1 and a set that
-  // never writes them renders untransformed.
-  resizeModelRootSlots(modelRootCount: number): void;
-  // 16 floats per model root, COLUMN-major - i.e. write THREE's Matrix4.toArray() straight in
-  modelRootTransformsView(): Float32Array;
-  // The inverses, same slots and layout. The true-perspective projection (Project.glsl) transforms
-  // a quadratic form and needs them; writing a transform without its inverse leaves that path
-  // projecting the splat as if untransformed. Use Matrix4.invert() on a copy
-  modelRootInverseTransformsView(): Float32Array;
-  // Sized by resizeChunkFades. Defaults to slot 0 (identity) for every chunk
-  chunkModelRootsView(): Int32Array;
-  // 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;
-}
-
-export interface WebGPUInternals {
-  jsObjects: unknown[];
-  bufferOnUnmaps: Record<number, unknown>;
-  futures: Promise<unknown>[];
-  jsObjectInsert(ptr: number, obj: unknown): void;
-  futureInsert(futureId: number, promise: Promise<unknown>): void;
-}
-
-export interface WebGPUInterface {
-  Internals: WebGPUInternals;
-
-  importJsAdapter(adapter: GPUAdapter, parentPtr?: number): number;
-  importJsDevice(device: GPUDevice, parentPtr?: number): number;
-  importJsBindGroup(obj: GPUBindGroup, parentPtr?: number): number;
-  importJsBindGroupLayout(obj: GPUBindGroupLayout, parentPtr?: number): number;
-  importJsBuffer(buffer: GPUBuffer, parentPtr?: number): number;
-  importJsCommandBuffer(obj: GPUCommandBuffer, parentPtr?: number): number;
-  importJsCommandEncoder(obj: GPUCommandEncoder, parentPtr?: number): number;
-  importJsComputePassEncoder(
-    obj: GPUComputePassEncoder,
-    parentPtr?: number,
-  ): number;
-  importJsComputePipeline(obj: GPUComputePipeline, parentPtr?: number): number;
-  importJsPipelineLayout(obj: GPUPipelineLayout, parentPtr?: number): number;
-  importJsQuerySet(obj: GPUQuerySet, parentPtr?: number): number;
-  importJsQueue(obj: GPUQueue, parentPtr?: number): number;
-  importJsRenderBundle(obj: GPURenderBundle, parentPtr?: number): number;
-  importJsRenderBundleEncoder(
-    obj: GPURenderBundleEncoder,
-    parentPtr?: number,
-  ): number;
-  importJsRenderPassEncoder(
-    obj: GPURenderPassEncoder,
-    parentPtr?: number,
-  ): number;
-  importJsRenderPipeline(obj: GPURenderPipeline, parentPtr?: number): number;
-  importJsSampler(obj: GPUSampler, parentPtr?: number): number;
-  importJsShaderModule(obj: GPUShaderModule, parentPtr?: number): number;
-  importJsTexture(obj: GPUTexture, parentPtr?: number): number;
-  importJsTextureView(obj: GPUTextureView, parentPtr?: number): number;
-
-  getJsObject(ptr: number): unknown;
-
-  makeStringFromStringView(stringViewPtr: number): string;
-  makeStringFromOptionalStringView(
-    stringViewPtr: number,
-  ): string | undefined | "";
-  setStringView(ptr: number, data: number, length: number): void;
-  makeColor(ptr: number): { r: number; g: number; b: number; a: number };
-  makeExtent3D(ptr: number): {
-    width: number;
-    height: number;
-    depthOrArrayLayers: number;
-  };
-  makeOrigin3D(ptr: number): { x: number; y: number; z: number };
-  fillLimitStruct(limits: GPUSupportedLimits, limitsOutPtr: number): void;
-  fillAdapterInfoStruct(adapterInfo: GPUAdapterInfo, infoStruct: number): void;
-  errorCallback(
-    callback: number,
-    type: number,
-    message: string,
-    userdata: number,
-  ): void;
-}
-
-export interface MainModule {
-  Camera: new () => Camera;
-  RenderState: new () => RenderState;
-  SplatSet: new () => SplatSet;
-  AABB: new () => AABB;
-  Ellipsoid: new () => Ellipsoid;
-  SphericalHarmonic: new () => SphericalHarmonic;
-  EllipsoidVector: new () => EllipsoidVector;
-  SphericalHarmonicVector: new () => SphericalHarmonicVector;
-  vec4: new (x: number, y: number, z: number, w: number) => vec4;
-
-  SortType: {
-    RADIX_SORT: SortTypeValue;
-    OCTREE_SORT: SortTypeValue;
-    KDTREE_SORT: SortTypeValue;
-    STD_SORT: SortTypeValue;
-  };
-
-  TextureFormat: {
-    RGBA32_Float: TextureFormatValue;
-    RGBA16_Float: TextureFormatValue;
-    RGBA32_UInt: TextureFormatValue;
-    RGBA32_SInt: TextureFormatValue;
-    RGBA16_UInt: TextureFormatValue;
-    RGBA16_SInt: TextureFormatValue;
-    RGBA8_UInt: TextureFormatValue;
-    RGBA8_SInt: TextureFormatValue;
-    RGBA8_UNorm: TextureFormatValue;
-    RGBA8_SNorm: TextureFormatValue;
-    RGBA16_UNorm: TextureFormatValue;
-    RGBA16_SNorm: TextureFormatValue;
-    BGRA8_UNorm: TextureFormatValue;
-    BC6HRGB_UFloat: TextureFormatValue;
-    BC6HRGB_Float: TextureFormatValue;
-    BC7RGBA_UNorm: TextureFormatValue;
-    BC7RGBA_UNormSrgb: TextureFormatValue;
-    BC3RGBA_UNorm: TextureFormatValue;
-    BC3RGBA_UNormSrgb: TextureFormatValue;
-  };
-
-  Usage_CopySrc: number;
-  Usage_CopyDest: number;
-  Usage_MapRead: number;
-  Usage_MapWrite: number;
-  Usage_Uniform: number;
-  Usage_Storage: number;
-  Usage_Index: number;
-  Usage_Vertex: number;
-  Usage_QueryResolve: number;
-
-  WebGPU: WebGPUInterface;
-
-  _malloc(bytes: number): number;
-  _free(ptr: number): void;
-  HEAPU32: Uint32Array;
-
-  setupCamera(
-    minExt: vec4,
-    maxExt: vec4,
-    axis: number,
-    direction: number,
-    width: number,
-    height: number,
-    camera: Camera,
-  ): void;
-
-  createRendererWGPU(canvasSelector: string): RendererWGPU;
-  createRendererWGPUWithoutSurface(
-    colorTargetFormat: TextureFormatValue,
-  ): RendererWGPU;
-
-  uploadSplatSetData(
-    set: SplatSet,
-    renderState: RenderState,
-    start: number,
-  ): void;
-  uploadChunkFades(set: SplatSet, renderState: RenderState): void;
-  // One mat4 per model root, so cheap enough to call every frame while an asset is moving
-  uploadModelRootTransforms(set: SplatSet, renderState: RenderState): void;
-  processSplatSet(
-    camera: Camera,
-    set: SplatSet,
-    renderState: RenderState,
-    width: number,
-    height: number,
-    triangles: number,
-    projectOnGPU: boolean,
-    cullEllipsoid: boolean,
-    useAffineApprox: boolean,
-    depthSortOnGPU: boolean,
-    useInvZ: boolean,
-    rasterizeWithCompute: boolean,
-    useSOGS: boolean,
-    sortType: SortTypeValue,
-  ): number;
-  renderSplatSet(
-    splats: number,
-    set: SplatSet,
-    renderState: RenderState,
-    width: number,
-    height: number,
-    triangles: number,
-    rasterizeWithCompute: boolean,
-    textureView: number,
-  ): void;
-  renderSplatSetToSceneTextures(
-    splatSet: SplatSet,
-    renderState: RenderState,
-    colorTarget: number,
-    depthTarget: number,
-  ): void;
-  mapToAABB(scale: number, minExt: vec4, maxExt: vec4, set: SplatSet): void;
-  loadPLYIntoSplatSet(filename: string, set: SplatSet): number;
-  getBoundsSplatSet(set: SplatSet, minExt: vec4, maxExt: vec4): void;
-  loadPLY(
-    filename: string,
-    count: number,
-    maxSplats: number,
-    ellipsoids: EllipsoidVector,
-    sphericalHarmonics: SphericalHarmonicVector,
-  ): number;
-}
-
-declare function WebShark(
-  moduleArg?: Record<string, unknown>,
-): Promise<MainModule>;
-
-export default WebShark;