@loaders.gl/splats 4.5.0-alpha.1

package/src/spz-loader.ts

@@ -0,0 +1,16 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoaderWithParser} from '@loaders.gl/loader-utils';
+import type {MeshArrowTable} from '@loaders.gl/schema';
+import type {SplatsLoaderOptions} from './types';
+import {parseSPZ} from './lib/parse-spz';
+import {SPZLoader as SPZLoaderMetadata} from './spz-loader-types';
+
+/** Parser-bearing loader for Niantic Spatial `.spz` Gaussian splat files. */
+export const SPZLoaderWithParser = {
+  ...SPZLoaderMetadata,
+  parse: async (arrayBuffer: ArrayBuffer, options?: SplatsLoaderOptions) =>
+    parseSPZ(arrayBuffer, options)
+} as const satisfies LoaderWithParser<MeshArrowTable, never, SplatsLoaderOptions>;

package/src/types.ts

@@ -0,0 +1,39 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+import type {LoaderOptions} from '@loaders.gl/loader-utils';
+
+/** Options shared by Gaussian splat loaders. */
+export type SplatsLoaderOptions = LoaderOptions & {
+  splats?: {
+    /** Output shape. V1 supports loaders.gl Mesh Arrow tables. */
+    shape?: 'arrow-table';
+  };
+};
+
+/** Linear Gaussian splat values before Arrow table construction. */
+export type GaussianSplats = {
+  /** Source format identifier. */
+  format: 'splat' | 'ksplat' | 'spz' | 'rad';
+  /** Number of decoded splats. */
+  splatCount: number;
+  /** Interleaved xyz positions. */
+  positions: Float32Array;
+  /** Interleaved xyz Gaussian scale standard deviations. */
+  scales: Float32Array;
+  /** Interleaved quaternions in `[w, x, y, z]` order. */
+  rotations: Float32Array;
+  /** Interleaved RGB colors as unorm8 values. */
+  colors: Uint8Array;
+  /** Optional interleaved RGB spherical harmonic DC coefficients. */
+  sphericalHarmonicDcs?: Float32Array;
+  /** Linear opacity values. Some LoD formats intentionally store values above 1. */
+  opacities: Float32Array;
+  /** Optional spherical harmonic rest coefficients. */
+  sphericalHarmonics?: Float32Array;
+  /** Number of SH rest coefficients per splat. */
+  sphericalHarmonicsComponentCount?: number;
+  /** Source-specific metadata. */
+  loaderData?: Record<string, unknown>;
+};

package/src/unbundled.ts

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+
+export {SPLATLoader, KSPLATLoader, SPZLoader, RADLoader, RADSourceLoader} from './index';