@d5techs/3dgs-lib 1.4.19 → 1.4.20

package/dist/gs/SOGEncoder.d.ts

@@ -1,18 +1,23 @@
 /**
  * SOGEncoder - 将 CompactSplatData 编码为 SOG v2 格式
  *
- * SOG 是 PlayCanvas 的压缩容器格式，本质是 ZIP 包含 meta.json + WebP 图像
- * 编码步骤：
- *  1. Morton 空间排序（提升渲染时缓存命中率）
+ * 完整移植 supersplat 的 SOG 导出流程：
+ *  0. 坐标系逆变换（含 SH Wigner D-矩阵逆变换）
+ *  1. Morton 码空间排序
  *  2. 位置：对称对数变换 → 16-bit 量化 → 拆分为 lower/upper 两张 WebP
  *  3. 缩放：k-means++ 构建 256 codebook → 量化 → WebP
  *  4. 四元数：smallest-three 编码 → WebP
  *  5. DC 颜色 + 不透明度：codebook 量化 → WebP
+ *  6. 高阶 SH (L1-L3)：k-means palette + codebook → centroids/labels WebP
  */
 import type { CompactSplatData, CoordinateSystem } from './PLYLoaderMobile';
+export interface SOGEncodeOptions {
+    maxSHBands?: number;
+    iterations?: number;
+    paletteSize?: number;
+}
 /**
  * @param coordinateSystem 内部数据的坐标系来源。
- *   'blender' 表示数据在加载时做过 Blender→WebGPU 变换，需要先做逆变换再编码。
- *   'webgpu'  表示数据已在 SOG 原生坐标系，直接编码。
+ * @param options SOG 编码选项
  */
-export declare function serializeSOG(data: CompactSplatData, coordinateSystem?: CoordinateSystem): Promise<ArrayBuffer>;
+export declare function serializeSOG(data: CompactSplatData, coordinateSystem?: CoordinateSystem, options?: SOGEncodeOptions): Promise<ArrayBuffer>;

package/dist/index.d.ts

@@ -29,6 +29,7 @@ export { loadSplat, deserializeSplat } from './gs/SplatLoader';
 export { loadSOG, deserializeSOG } from './gs/SOGLoader';
 export type { SOGProgressCallback } from './gs/SOGLoader';
 export { serializeSOG } from './gs/SOGEncoder';
+export type { SOGEncodeOptions } from './gs/SOGEncoder';
 export { GSSplatRenderer } from './gs/GSSplatRenderer';
 export { GSSplatSorter } from './gs/GSSplatSorter';
 export type { SorterOptions, CullingOptions, ScreenInfo } from './gs/GSSplatSorter';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@d5techs/3dgs-lib",
-  "version": "1.4.19",
+  "version": "1.4.20",
   "description": "可扩展的 WebGPU 3D 渲染引擎",
   "type": "module",
   "main": "./dist/3dgs-lib.cjs",