@sparkjsdev/spark 0.1.4 → 0.1.6

package/dist/types/SparkRenderer.d.ts

@@ -17,6 +17,7 @@ export type SparkRendererOptions = {
     apertureAngle?: number;
     falloff?: number;
     clipXY?: number;
+    focalAdjustment?: number;
     view?: SparkViewpointOptions;
 };
 export declare class SparkRenderer extends THREE.Mesh {
@@ -34,6 +35,16 @@ export declare class SparkRenderer extends THREE.Mesh {
     apertureAngle: number;
     falloff: number;
     clipXY: number;
+    focalAdjustment: 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 +64,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 +109,31 @@ export declare class SparkRenderer extends THREE.Mesh {
         clipXY: {
             value: number;
         };
+        focalAdjustment: {
+            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,6 +4,7 @@ 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>;
@@ -13,13 +14,59 @@ export declare enum SplatFileType {
     PLY = "ply",
     SPZ = "spz",
     SPLAT = "splat",
-    KSPLAT = "ksplat"
+    KSPLAT = "ksplat",
+    PCSOGS = "pcsogs",
+    PCSOGSZIP = "pcsogszip"
 }
 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 tryPcSogsZip(input: ArrayBuffer | Uint8Array): {
+    name: string;
+    json: 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/defines.d.ts

@@ -1,8 +1,10 @@
-export declare const LN_SCALE_MIN = -9;
+export declare const LN_SCALE_MIN = -12;
 export declare const LN_SCALE_MAX = 9;
 export declare const LN_RESCALE: number;
 export declare const SCALE_MIN: number;
 export declare const SCALE_MAX: number;
+export declare const LN_SCALE_ZERO = -30;
+export declare const SCALE_ZERO: number;
 export declare const SPLAT_TEX_WIDTH_BITS = 11;
 export declare const SPLAT_TEX_HEIGHT_BITS = 11;
 export declare const SPLAT_TEX_DEPTH_BITS = 11;

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,11 @@
+import { PcSogsJson } from './SplatLoader';
+export declare function unpackPcSogs(json: PcSogsJson, extraFiles: Record<string, ArrayBuffer>): Promise<{
+    packedArray: Uint32Array;
+    numSplats: number;
+    extra: Record<string, unknown>;
+}>;
+export declare function unpackPcSogsZip(fileBytes: Uint8Array): 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.6",
   "description": "An advanced 3D Gaussian Splatting renderer for THREE.js",
   "homepage": "https://sparkjs.dev/",
   "type": "module",