@sparkjsdev/spark 0.1.8 → 0.1.10

package/dist/types/SparkRenderer.d.ts

@@ -48,6 +48,11 @@ export type SparkRendererOptions = {
      * @default Math.sqrt(8)
      */
     maxStdDev?: number;
+    /**
+     * Minimum pixel radius for splat rendering.
+     * @default 0.0
+     */
+    minPixelRadius?: number;
     /**
      * Maximum pixel radius for splat rendering.
      * @default 512.0
@@ -132,6 +137,7 @@ export declare class SparkRenderer extends THREE.Mesh {
     needsUpdate: boolean;
     originDistance: number;
     maxStdDev: number;
+    minPixelRadius: number;
     maxPixelRadius: number;
     minAlpha: number;
     enable2DGS: boolean;
@@ -196,6 +202,9 @@ export declare class SparkRenderer extends THREE.Mesh {
         maxStdDev: {
             value: number;
         };
+        minPixelRadius: {
+            value: number;
+        };
         maxPixelRadius: {
             value: number;
         };

package/dist/types/SplatLoader.d.ts

@@ -58,11 +58,38 @@ export type PcSogsJson = {
         files: string[];
     };
 };
+export type PcSogsV2Json = {
+    version: 2;
+    count: number;
+    antialias?: boolean;
+    means: {
+        mins: number[];
+        maxs: number[];
+        files: string[];
+    };
+    scales: {
+        codebook: number[];
+        files: string[];
+    };
+    quats: {
+        files: string[];
+    };
+    sh0: {
+        codebook: number[];
+        files: string[];
+    };
+    shN?: {
+        count: number;
+        bands: number;
+        codebook: 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 tryPcSogs(input: ArrayBuffer | Uint8Array | string): PcSogsJson | PcSogsV2Json | undefined;
 export declare function tryPcSogsZip(input: ArrayBuffer | Uint8Array): {
     name: string;
-    json: PcSogsJson;
+    json: PcSogsJson | PcSogsV2Json;
 } | undefined;
 export declare function unpackSplats({ input, extraFiles, fileType, pathOrUrl, splatEncoding, }: {
     input: Uint8Array | ArrayBuffer;

package/dist/types/defines.d.ts

@@ -16,3 +16,4 @@ export declare const SPLAT_TEX_WIDTH_MASK: number;
 export declare const SPLAT_TEX_HEIGHT_MASK: number;
 export declare const SPLAT_TEX_DEPTH_MASK: number;
 export declare const WASM_SPLAT_SORT = true;
+export declare const USE_COMPILED_PARSER_FUNCTION = true;

package/dist/types/index.d.ts

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

package/dist/types/pcsogs.d.ts

@@ -1,6 +1,6 @@
 import { SplatEncoding } from './PackedSplats';
-import { PcSogsJson } from './SplatLoader';
-export declare function unpackPcSogs(json: PcSogsJson, extraFiles: Record<string, ArrayBuffer>, splatEncoding: SplatEncoding): Promise<{
+import { PcSogsJson, PcSogsV2Json } from './SplatLoader';
+export declare function unpackPcSogs(json: PcSogsJson | PcSogsV2Json, extraFiles: Record<string, ArrayBuffer>, splatEncoding: SplatEncoding): Promise<{
     packedArray: Uint32Array;
     numSplats: number;
     extra: Record<string, unknown>;

package/dist/types/ply.d.ts

@@ -1,4 +1,5 @@
-export type PlyPropertyType = "char" | "uchar" | "short" | "ushort" | "int" | "uint" | "float" | "double";
+declare const PLY_PROPERTY_TYPES: readonly ["char", "uchar", "short", "ushort", "int", "uint", "float", "double"];
+export type PlyPropertyType = (typeof PLY_PROPERTY_TYPES)[number];
 export type PlyElement = {
     name: string;
     count: number;
@@ -29,3 +30,4 @@ export declare class PlyReader {
     injectRgba(rgba: Uint8Array): void;
 }
 export declare const SH_C0 = 0.28209479177387814;
+export {};

package/dist/types/spz.d.ts

@@ -10,14 +10,16 @@ export declare class SpzReader {
     flags: number;
     flagAntiAlias: boolean;
     reserved: number;
+    headerParsed: boolean;
     parsed: boolean;
     constructor({ fileBytes }: {
         fileBytes: Uint8Array | ArrayBuffer;
     });
-    parseSplats(centerCallback?: (index: number, x: number, y: number, z: number) => void, alphaCallback?: (index: number, alpha: number) => void, rgbCallback?: (index: number, r: number, g: number, b: number) => void, scalesCallback?: (index: number, scaleX: number, scaleY: number, scaleZ: number) => void, quatCallback?: (index: number, quatX: number, quatY: number, quatZ: number, quatW: number) => void, shCallback?: (index: number, sh1: Float32Array, sh2?: Float32Array, sh3?: Float32Array) => void): void;
+    parseHeader(): Promise<void>;
+    parseSplats(centerCallback?: (index: number, x: number, y: number, z: number) => void, alphaCallback?: (index: number, alpha: number) => void, rgbCallback?: (index: number, r: number, g: number, b: number) => void, scalesCallback?: (index: number, scaleX: number, scaleY: number, scaleZ: number) => void, quatCallback?: (index: number, quatX: number, quatY: number, quatZ: number, quatW: number) => void, shCallback?: (index: number, sh1: Float32Array, sh2?: Float32Array, sh3?: Float32Array) => void): Promise<void>;
 }
 export declare const SPZ_MAGIC = 1347635022;
-export declare const SPZ_VERSION = 2;
+export declare const SPZ_VERSION = 3;
 export declare const FLAG_ANTIALIASED = 1;
 export declare class SpzWriter {
     buffer: ArrayBuffer;
@@ -39,7 +41,7 @@ export declare class SpzWriter {
     static scaleRgb(r: number): number;
     setRgb(index: number, r: number, g: number, b: number): void;
     setScale(index: number, scaleX: number, scaleY: number, scaleZ: number): void;
-    setQuat(index: number, quatX: number, quatY: number, quatZ: number, quatW: number): void;
+    setQuat(index: number, ...q: [number, number, number, number]): void;
     static quantizeSh(sh: number, bits: number): number;
     setSh(index: number, sh1: Float32Array, sh2?: Float32Array, sh3?: Float32Array): void;
     finalize(): Promise<Uint8Array>;

package/dist/types/utils.d.ts

@@ -1,9 +1,11 @@
-import { Gunzip } from 'fflate';
 import * as THREE from "three";
+export declare function normalize(vec: number[]): number[];
 export declare function floatBitsToUint(f: number): number;
 export declare function uintBitsToFloat(u: number): number;
-export declare function toHalf(f: number): number;
-export declare function fromHalf(h: number): number;
+export declare const toHalf: typeof toHalfNative;
+export declare const fromHalf: typeof fromHalfNative;
+declare function toHalfNative(f: number): number;
+declare function fromHalfNative(u: number): number;
 export declare function floatToUint8(v: number): number;
 export declare function floatToSint8(v: number): number;
 export declare function Uint8ToFloat(v: number): number;
@@ -167,13 +169,13 @@ export declare function decompressPartialGzip(fileBytes: Uint8Array, numBytes: n
 export declare class GunzipReader {
     fileBytes: Uint8Array;
     chunkBytes: number;
-    offset: number;
     chunks: Uint8Array[];
     totalBytes: number;
-    gunzip: Gunzip;
+    reader: ReadableStreamDefaultReader;
     constructor({ fileBytes, chunkBytes, }: {
         fileBytes: Uint8Array;
         chunkBytes?: number;
     });
-    read(numBytes: number): Uint8Array;
+    read(numBytes: number): Promise<Uint8Array>;
 }
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sparkjsdev/spark",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "An advanced 3D Gaussian Splatting renderer for THREE.js",
   "homepage": "https://sparkjs.dev/",
   "type": "module",
@@ -44,12 +44,12 @@
   "license": "MIT",
   "devDependencies": {
     "@biomejs/biome": "1.9.4",
-    "@types/three": "0.172.0",
+    "@types/three": "0.178.0",
     "lefthook": "1.11.12",
     "lil-gui": "^0.20.0",
     "onchange": "7.1.0",
     "stats.js": "^0.17.0",
-    "three": "^0.172.0",
+    "three": "^0.178.0",
     "ts-node": "10.9.2",
     "typescript": "^5.7.3",
     "vite": "^6.0.11",