Skip to main content

The SPZ Format

SPZ is an open source compressed format for 3D Gaussian Splat data from Niantic. It stores quantized splat attributes in ZSTD compressed streams, making files roughly 10× smaller than the PLY equivalent with virtually no perceptible loss in visual quality. It is the native format of apps like Scaniverse.

You can create these files with SplatTransform and load them with the PlayCanvas Engine using a parser script.

Creating SPZ Files​

Convert any supported splat format using SplatTransform:

splat-transform scene.ply scene.spz

This writes SPZ version 4 by default, which is the version the engine parser supports.

Loading in PlayCanvas​

The SPZ parser is not part of the engine — it ships as a script with the engine (scripts/esm/parsers/spz-parser.mjs) and is registered with the gsplat resource handler by the application.

The SPZ attribute streams are ZSTD compressed, so the parser also needs a ZSTD decompression WebAssembly module, registered the same way as the Draco module. A prebuilt module is available in the engine repository.

import { SpzParser } from 'playcanvas/scripts/esm/parsers/spz-parser.mjs';

// the spz attribute streams are ZSTD compressed - register a decoder module
pc.WasmModule.setConfig('ZstdDecoderModule', {
    glueUrl: 'zstd.wasm.js',
    wasmUrl: 'zstd.wasm.wasm'
});

// register the spz parser with the gsplat resource handler
app.loader.getHandler('gsplat').addParser(new SpzParser(app));

// spz files then load as regular gsplat assets
const asset = new pc.Asset('scene', 'gsplat', { url: 'scene.spz' });
app.assets.add(asset);
app.assets.load(asset);

See the simple-spz example for a complete setup.

Engine Support Notes​

  • Only SPZ version 4 is supported. Older gzip-based files (versions 1–3) are rejected — reconvert them with SplatTransform.
  • The splat data is kept in its quantized form in GPU memory (roughly 20 bytes per splat plus spherical harmonics) and dequantized in the shader, so GPU memory use is comparable to compressed PLY and SOG rather than uncompressed formats.
  • Spherical harmonics are supported up to 3 bands. Files with degree 4 harmonics load with the extra band ignored.
  • Coordinate system: splat data uses a +Y up coordinate system (like glTF), so unlike PLY files, no flip rotation is needed when placing the loaded splat in a scene.
  • The antialiased flag and vendor extensions are ignored.

When to Use SPZ​

Use SPZ when your splat assets already exist in this format — for example scans captured with Scaniverse or content from tools built around the Niantic ecosystem.

tip

For web delivery, SOG remains the recommended format — it offers stronger compression and faster loading, and is supported by the engine out of the box.