@sparkjsdev/spark 0.1.4 → 0.1.5

package/dist/types/SparkRenderer.d.ts

@@ -34,6 +34,16 @@ export declare class SparkRenderer extends THREE.Mesh {
     apertureAngle: number;
     falloff: number;
     clipXY: number;
+    renderScale: number;
+    splatTexture: null | {
+        enable?: boolean;
+        texture?: THREE.Data3DTexture;
+        multiply?: THREE.Matrix2;
+        add?: THREE.Vector2;
+        near?: number;
+        far?: number;
+        mid?: number;
+    };
     time?: number;
     deltaTime?: number;
     clock: THREE.Clock;
@@ -53,11 +63,18 @@ export declare class SparkRenderer extends THREE.Mesh {
     private envViewpoint;
     private static cubeRender;
     private static pmrem;
+    static EMPTY_SPLAT_TEXTURE: THREE.Data3DTexture;
     constructor(options: SparkRendererOptions);
     static makeUniforms(): {
         renderSize: {
             value: THREE.Vector2;
         };
+        near: {
+            value: number;
+        };
+        far: {
+            value: number;
+        };
         numSplats: {
             value: number;
         };
@@ -91,6 +108,31 @@ export declare class SparkRenderer extends THREE.Mesh {
         clipXY: {
             value: number;
         };
+        renderScale: {
+            value: number;
+        };
+        splatTexEnable: {
+            value: boolean;
+        };
+        splatTexture: {
+            type: string;
+            value: THREE.Data3DTexture;
+        };
+        splatTexMul: {
+            value: THREE.Matrix2;
+        };
+        splatTexAdd: {
+            value: THREE.Vector2;
+        };
+        splatTexNear: {
+            value: number;
+        };
+        splatTexFar: {
+            value: number;
+        };
+        splatTexMid: {
+            value: number;
+        };
         packedSplats: {
             type: string;
             value: THREE.DataArrayTexture;

package/dist/types/SplatLoader.d.ts

@@ -4,22 +4,65 @@ import { SplatMesh } from './SplatMesh';
 export declare class SplatLoader extends Loader {
     fileLoader: FileLoader;
     fileType?: SplatFileType;
+    packedSplats?: PackedSplats;
     constructor(manager?: LoadingManager);
     load(url: string, onLoad?: (decoded: PackedSplats) => void, onProgress?: (event: ProgressEvent) => void, onError?: (error: unknown) => void): void;
     loadAsync(url: string, onProgress?: (event: ProgressEvent) => void): Promise<PackedSplats>;
+    loadExtra(url: string): Promise<ArrayBuffer>;
     parse(packedSplats: PackedSplats): SplatMesh;
 }
 export declare enum SplatFileType {
     PLY = "ply",
     SPZ = "spz",
     SPLAT = "splat",
-    KSPLAT = "ksplat"
+    KSPLAT = "ksplat",
+    PCSOGS = "pcsogs"
 }
 export declare function getSplatFileType(fileBytes: Uint8Array): SplatFileType | undefined;
 export declare function getFileExtension(pathOrUrl: string): string;
 export declare function getSplatFileTypeFromPath(pathOrUrl: string): SplatFileType | undefined;
-export declare function unpackSplats({ input, fileType, pathOrUrl, }: {
+export type PcSogsJson = {
+    means: {
+        shape: number[];
+        dtype: string;
+        mins: number[];
+        maxs: number[];
+        files: string[];
+    };
+    scales: {
+        shape: number[];
+        dtype: string;
+        mins: number[];
+        maxs: number[];
+        files: string[];
+    };
+    quats: {
+        shape: number[];
+        dtype: string;
+        encoding?: string;
+        files: string[];
+    };
+    sh0: {
+        shape: number[];
+        dtype: string;
+        mins: number[];
+        maxs: number[];
+        files: string[];
+    };
+    shN: {
+        shape: number[];
+        dtype: string;
+        mins: number;
+        maxs: number;
+        quantization: number;
+        files: string[];
+    };
+};
+export declare function isPcSogs(input: ArrayBuffer | Uint8Array | string): boolean;
+export declare function tryPcSogs(input: ArrayBuffer | Uint8Array | string): PcSogsJson | undefined;
+export declare function unpackSplats({ input, extraFiles, fileType, pathOrUrl, }: {
     input: Uint8Array | ArrayBuffer;
+    extraFiles?: Record<string, ArrayBuffer>;
     fileType?: SplatFileType;
     pathOrUrl?: string;
 }): Promise<{

package/dist/types/index.d.ts

@@ -1,7 +1,7 @@
 export { SparkRenderer, type SparkRendererOptions } from './SparkRenderer';
 export { SparkViewpoint, type SparkViewpointOptions } from './SparkViewpoint';
 export * as dyno from './dyno';
-export { SplatLoader, unpackSplats, SplatFileType, getSplatFileType, } from './SplatLoader';
+export { SplatLoader, unpackSplats, SplatFileType, getSplatFileType, isPcSogs, } from './SplatLoader';
 export { PlyReader } from './ply';
 export { SpzReader, SpzWriter, transcodeSpz } from './spz';
 export { PackedSplats, type PackedSplatsOptions } from './PackedSplats';

package/dist/types/pcsogs.d.ts

@@ -0,0 +1,5 @@
+export declare function unpackPcSogs(fileBytes: Uint8Array, extraFiles: Record<string, ArrayBuffer>): Promise<{
+    packedArray: Uint32Array;
+    numSplats: number;
+    extra: Record<string, unknown>;
+}>;

package/dist/types/utils.d.ts

@@ -43,6 +43,7 @@ export declare function setPackedSplat(packedSplats: Uint32Array, index: number,
 export declare function setPackedSplatCenter(packedSplats: Uint32Array, index: number, x: number, y: number, z: number): void;
 export declare function setPackedSplatScales(packedSplats: Uint32Array, index: number, scaleX: number, scaleY: number, scaleZ: number): void;
 export declare function setPackedSplatQuat(packedSplats: Uint32Array, index: number, quatX: number, quatY: number, quatZ: number, quatW: number): void;
+export declare function setPackedSplatRgba(packedSplats: Uint32Array, index: number, r: number, g: number, b: number, a: number): void;
 export declare function setPackedSplatRgb(packedSplats: Uint32Array, index: number, r: number, g: number, b: number): void;
 export declare function setPackedSplatOpacity(packedSplats: Uint32Array, index: number, opacity: number): void;
 export declare function unpackSplat(packedSplats: Uint32Array, index: number): {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkjsdev/spark",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "An advanced 3D Gaussian Splatting renderer for THREE.js",
   "homepage": "https://sparkjs.dev/",
   "type": "module",
@@ -58,6 +58,7 @@
     "spark-internal-rs": "file:rust/spark-internal-rs/pkg"
   },
   "dependencies": {
+    "@jsquash/webp": "^1.5.0",
     "fflate": "^0.8.2"
   },
   "keywords": ["3d", "three.js", "gsplats", "3dgs", "gaussian", "splats"]