@playcanvas/splat-transform 1.9.1 → 1.9.2

package/dist/lib/index.d.cts

@@ -34,6 +34,8 @@ export { writeLod } from './writers/write-lod';
 export { writeGlb } from './writers/write-glb';
 export { writeVoxel } from './writers/write-voxel';
 export type { WriteVoxelOptions, VoxelMetadata } from './writers/write-voxel';
+export { marchingCubes } from './voxel/marching-cubes';
+export type { MarchingCubesMesh } from './voxel/marching-cubes';
 export type { Options, Param } from './types';
 export { logger } from './utils/logger';
 export type { Logger, ProgressNode } from './utils/logger';

package/dist/lib/index.d.ts

@@ -34,6 +34,8 @@ export { writeLod } from './writers/write-lod';
 export { writeGlb } from './writers/write-glb';
 export { writeVoxel } from './writers/write-voxel';
 export type { WriteVoxelOptions, VoxelMetadata } from './writers/write-voxel';
+export { marchingCubes } from './voxel/marching-cubes';
+export type { MarchingCubesMesh } from './voxel/marching-cubes';
 export type { Options, Param } from './types';
 export { logger } from './utils/logger';
 export type { Logger, ProgressNode } from './utils/logger';

package/dist/lib/types.d.ts

@@ -18,6 +18,10 @@ type Options = {
     voxelResolution?: number;
     /** Opacity threshold for solid voxels - voxels below this are considered empty. Default: 0.5 */
     opacityCutoff?: number;
+    /** Whether to generate a collision mesh (.collision.glb) alongside voxel output. Default: false */
+    collisionMesh?: boolean;
+    /** Ratio of triangles to keep when simplifying the collision mesh (0-1). Default: 0.25 */
+    meshSimplify?: number;
 };
 /**
  * Parameter passed to MJS generator scripts.

package/dist/lib/voxel/collision-glb.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Build a minimal GLB (glTF 2.0 binary) file containing a single triangle mesh.
+ *
+ * The output contains only positions and triangle indices — no normals,
+ * UVs, or materials — suitable for collision meshes.
+ *
+ * @param positions - Vertex positions (3 floats per vertex)
+ * @param indices - Triangle indices (3 per triangle, unsigned 32-bit)
+ * @returns GLB file as a Uint8Array
+ */
+declare function buildCollisionGlb(positions: Float32Array, indices: Uint32Array): Uint8Array;
+export { buildCollisionGlb };

package/dist/lib/voxel/index.d.ts

@@ -4,3 +4,5 @@ export { GpuVoxelization } from './gpu-voxelization.js';
 export type { BatchSpec, MultiBatchResult } from './gpu-voxelization.js';
 export { buildSparseOctree, alignGridBounds } from './sparse-octree.js';
 export type { SparseOctree, Bounds } from './sparse-octree.js';
+export { marchingCubes } from './marching-cubes.js';
+export type { MarchingCubesMesh } from './marching-cubes.js';

package/dist/lib/voxel/marching-cubes.d.ts

@@ -0,0 +1,25 @@
+import { BlockAccumulator, type Bounds } from './sparse-octree';
+/**
+ * Result of marching cubes surface extraction.
+ */
+interface MarchingCubesMesh {
+    /** Vertex positions (3 floats per vertex) */
+    positions: Float32Array;
+    /** Triangle indices (3 indices per triangle) */
+    indices: Uint32Array;
+}
+/**
+ * Extract a triangle mesh from a BlockAccumulator using marching cubes.
+ *
+ * Each voxel is treated as a cell in the marching cubes grid. Corner values
+ * are binary (0 = empty, 1 = occupied) with a 0.5 threshold. Vertices are
+ * placed at edge midpoints, producing a mesh that follows voxel boundaries.
+ *
+ * @param accumulator - Voxel block data after filtering
+ * @param gridBounds - Grid bounds aligned to block boundaries
+ * @param voxelResolution - Size of each voxel in world units
+ * @returns Mesh with positions and indices
+ */
+declare function marchingCubes(accumulator: BlockAccumulator, gridBounds: Bounds, voxelResolution: number): MarchingCubesMesh;
+export { marchingCubes };
+export type { MarchingCubesMesh };

package/dist/lib/writers/write-voxel.d.ts

@@ -15,6 +15,10 @@ type WriteVoxelOptions = {
     opacityCutoff?: number;
     /** Optional function to create a GPU device for voxelization */
     createDevice?: DeviceCreator;
+    /** Whether to generate a collision mesh (.collision.glb) alongside the voxel data. Default: false */
+    collisionMesh?: boolean;
+    /** Ratio of triangles to keep when simplifying the collision mesh (0-1). Default: 0.25 */
+    meshSimplify?: number;
 };
 /**
  * Metadata for a voxel octree file.
@@ -51,9 +55,10 @@ interface VoxelMetadata {
  * Voxelizes Gaussian splat data and writes the result as a sparse voxel octree.
  *
  * This function performs GPU-accelerated voxelization of Gaussian splat data
- * and outputs two files:
+ * and outputs two or three files:
  * - `filename` (.voxel.json) - JSON metadata including bounds, resolution, and array sizes
  * - Corresponding .voxel.bin - Binary octree data (nodes + leafData as Uint32 arrays)
+ * - Corresponding .collision.glb - Triangle mesh extracted via marching cubes (GLB format, optional)
  *
  * The binary file layout is:
  * - Bytes 0 to (nodeCount * 4 - 1): nodes array (Uint32, little-endian)
@@ -72,6 +77,7 @@ interface VoxelMetadata {
  *     dataTable: myDataTable,
  *     voxelResolution: 0.05,
  *     opacityCutoff: 0.5,
+ *     collisionMesh: true,
  *     createDevice: async () => myGraphicsDevice
  * }, fs);
  * ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@playcanvas/splat-transform",
-  "version": "1.9.1",
+  "version": "1.9.2",
   "author": "PlayCanvas<support@playcanvas.com>",
   "homepage": "https://playcanvas.com",
   "description": "Library and CLI tool for 3D Gaussian splat format conversion and transformation",
@@ -45,6 +45,7 @@
     "lib/"
   ],
   "dependencies": {
+    "meshoptimizer": "^1.0.1",
     "webgpu": "^0.3.8"
   },
   "devDependencies": {