@loaders.gl/splats 4.5.3 → 5.0.0-alpha.10

package/src/splat-loader-types.ts

@@ -11,7 +11,13 @@ import {SPLATFormat} from './splats-format';
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
 const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
 
-/** Loader metadata for raw `.splat` Gaussian splat files. */
+/** Preloads the parser-bearing SPLAT loader implementation. */
+async function preload() {
+  const {SPLATLoaderWithParser} = await import('./splat-loader');
+  return SPLATLoaderWithParser;
+}
+
+/** Metadata-only loader for raw `.splat` Gaussian splat files. */
 export const SPLATLoader = {
   dataType: null as unknown as MeshArrowTable,
   batchType: null as never,
@@ -21,5 +27,6 @@ export const SPLATLoader = {
     splats: {
       shape: 'arrow-table'
     }
-  }
+  },
+  preload
 } as const satisfies Loader<MeshArrowTable, never, SplatsLoaderOptions>;

package/src/splat-loader.ts

@@ -8,9 +8,11 @@ import type {SplatsLoaderOptions} from './types';
 import {parseSPLAT} from './lib/parse-splat';
 import {SPLATLoader as SPLATLoaderMetadata} from './splat-loader-types';
 
+const {preload: _SPLATLoaderPreload, ...SPLATLoaderMetadataWithoutPreload} = SPLATLoaderMetadata;
+
 /** Parser-bearing loader for raw `.splat` Gaussian splat files. */
 export const SPLATLoaderWithParser = {
-  ...SPLATLoaderMetadata,
+  ...SPLATLoaderMetadataWithoutPreload,
   parse: async (arrayBuffer: ArrayBuffer) => parseSPLAT(arrayBuffer),
   parseSync: (arrayBuffer: ArrayBuffer) => parseSPLAT(arrayBuffer)
 } as const satisfies LoaderWithParser<MeshArrowTable, never, SplatsLoaderOptions>;

package/src/splats-format.ts

@@ -9,6 +9,7 @@ export const SPLATFormat = {
   name: 'SPLAT',
   id: 'splat',
   module: 'splats',
+  format: 'splat',
   extensions: ['splat'],
   mimeTypes: ['application/octet-stream'],
   binary: true
@@ -19,6 +20,7 @@ export const KSPLATFormat = {
   name: 'KSPLAT',
   id: 'ksplat',
   module: 'splats',
+  format: 'ksplat',
   extensions: ['ksplat'],
   mimeTypes: ['application/octet-stream'],
   binary: true
@@ -29,6 +31,7 @@ export const SPZFormat = {
   name: 'SPZ',
   id: 'spz',
   module: 'splats',
+  format: 'spz',
   extensions: ['spz'],
   mimeTypes: ['application/octet-stream'],
   binary: true,
@@ -40,6 +43,7 @@ export const RADFormat = {
   name: 'RAD',
   id: 'rad',
   module: 'splats',
+  format: 'rad',
   extensions: ['rad'],
   mimeTypes: ['application/octet-stream'],
   binary: true,

package/src/spz-loader-types.ts

@@ -11,7 +11,13 @@ import {SPZFormat} from './splats-format';
 // @ts-ignore TS2304: Cannot find name '__VERSION__'.
 const VERSION = typeof __VERSION__ !== 'undefined' ? __VERSION__ : 'latest';
 
-/** Loader metadata for Niantic Spatial `.spz` Gaussian splat files. */
+/** Preloads the parser-bearing SPZ loader implementation. */
+async function preload() {
+  const {SPZLoaderWithParser} = await import('./spz-loader');
+  return SPZLoaderWithParser;
+}
+
+/** Metadata-only loader for Niantic Spatial `.spz` Gaussian splat files. */
 export const SPZLoader = {
   dataType: null as unknown as MeshArrowTable,
   batchType: null as never,
@@ -21,5 +27,6 @@ export const SPZLoader = {
     splats: {
       shape: 'arrow-table'
     }
-  }
+  },
+  preload
 } as const satisfies Loader<MeshArrowTable, never, SplatsLoaderOptions>;

package/src/spz-loader.ts

@@ -8,9 +8,11 @@ import type {SplatsLoaderOptions} from './types';
 import {parseSPZ} from './lib/parse-spz';
 import {SPZLoader as SPZLoaderMetadata} from './spz-loader-types';
 
+const {preload: _SPZLoaderPreload, ...SPZLoaderMetadataWithoutPreload} = SPZLoaderMetadata;
+
 /** Parser-bearing loader for Niantic Spatial `.spz` Gaussian splat files. */
 export const SPZLoaderWithParser = {
-  ...SPZLoaderMetadata,
+  ...SPZLoaderMetadataWithoutPreload,
   parse: async (arrayBuffer: ArrayBuffer, options?: SplatsLoaderOptions) =>
     parseSPZ(arrayBuffer, options)
 } as const satisfies LoaderWithParser<MeshArrowTable, never, SplatsLoaderOptions>;

package/src/types.ts

@@ -9,9 +9,16 @@ export type SplatsLoaderOptions = LoaderOptions & {
   splats?: {
     /** Output shape. V1 supports loaders.gl Mesh Arrow tables. */
     shape?: 'arrow-table';
+    /** Coordinate frame stored in the source SPZ payload. */
+    sourceCoordinateSystem?: SPZCoordinateSystem;
+    /** Coordinate frame expected by the caller. Defaults to the source frame. */
+    targetCoordinateSystem?: SPZCoordinateSystem;
   };
 };
 
+/** Coordinate-system labels used by the SPZ container and glTF bridge. */
+export type SPZCoordinateSystem = 'RUB' | 'LUF' | 'RUF' | 'UNSPECIFIED';
+
 /** Linear Gaussian splat values before Arrow table construction. */
 export type GaussianSplats = {
   /** Source format identifier. */