s3m-three 0.4.18 → 0.4.19

package/dist/core/GaussianSplat.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 3DGS（高斯泼溅）逐点属性的解码
+ *
+ * 输入是 MeshOpt 骨架里的两条自定义流，各 4 字节/顶点：
+ *   `gsScale`    —— 3 个 u8，log 量化；第 4 字节是填充
+ *   `gsRotation` —— 3 个 u8 存四元数的 x/y/z；w 由公式补；第 4 字节是填充
+ *
+ * 这两条流以前是「保留原始字节但语义未知」（FORMAT-NOTES 第九节的 D 级），
+ * 所以只能按点渲染。量化格式最终不是靠统计猜出来的，是从官方 worker
+ * `SuperMap3D/Workers/GaussianSplating.js`（3.9 KB）里读出来的，公式逐字如下：
+ *
+ * ```js
+ * function j(t){                    // scale
+ *   a[n*3+0] = Math.exp(t[n*4+0]/16 - 10)
+ *   a[n*3+1] = Math.exp(t[n*4+1]/16 - 10)
+ *   a[n*3+2] = Math.exp(t[n*4+2]/16 - 10)
+ * }
+ * function D(t){                    // rotation
+ *   c = t[n]/127.5 - 1; f = t[n+1]/127.5 - 1; x = t[n+2]/127.5 - 1
+ *   s = Math.sqrt(Math.max(0, 1 - (c*c + f*f + x*x)))
+ *   a[n] = s; a[n+1] = c; a[n+2] = f; a[n+3] = x      // (w, x, y, z)
+ * }
+ * ```
+ *
+ * 官方还有第二条分支（`isSPZCompress && version === 1.1`）走 10-10-10-2 的
+ * 「smallest three」打包，本模块也实现了 —— 见 `decodeRotation` 的 mode 判定。
+ *
+ * **为什么以前看这 4 字节像乱码**：第 4 字节确实不参与解码，于是同一瓦片里它
+ * 一会儿是 0 一会儿是 207（填充的残留），拿 32 位整数字段或 4 分量向量去套，
+ * 自然怎么都对不上。只取前 3 字节 + w 由单位化补出，立刻就是干净的四元数。
+ */
+export interface SplatData {
+    /** 3N（米，场景 ENU 坐标） */
+    positions: Float32Array;
+    /** 3N（米，三个主轴的高斯半径） */
+    scales: Float32Array;
+    /** 4N，单位四元数 (x, y, z, w) —— three 的 Quaternion 顺序 */
+    rotations: Float32Array;
+    /** 4N，RGBA8 */
+    colors: Uint8Array;
+    count: number;
+}
+/**
+ * scale：`exp(byte/16 - 10)` 米。
+ * 值域 byte ∈ [0,255] → [4.54e-5, 380] 米，建筑泼溅的典型值（0.01~1 米）落在中段。
+ */
+export declare function decodeScale(bytes: Uint8Array, stride: number, offset: number, count: number): Float32Array;
+/**
+ * rotation：3 个 u8 直接归一化到 [-1,1]，第四个分量由单位化补出。
+ *
+ * 输出顺序是 three 的 `(x, y, z, w)`，而官方内部是 `(w, x, y, z)` —— 这里已经换过。
+ */
+export declare function decodeRotation(bytes: Uint8Array, stride: number, offset: number, count: number): Float32Array;
+export declare function lastRotationResidual(): number;
+/**
+ * 10-10-10-2 的 smallest-three（官方 `U()`，`isSPZCompress && version === 1.1` 时走这条）。
+ *
+ * 3 个分量各 10 bit（第 9 bit 是符号），剩下 2 bit 记录「哪一维是最大的」，
+ * 最大维由单位化补出 —— 这样只需要 32 bit 就能无损表达一个单位四元数。
+ */
+export declare function decodeRotationSmallestThree(bytes: Uint8Array, stride: number, offset: number, count: number): Float32Array;
+/** 逐点协方差矩阵的上三角（6 个 float）：`Σ = R S Sᵀ Rᵀ`，供 EWA 投影用 */
+export declare function covariance(sx: number, sy: number, sz: number, qx: number, qy: number, qz: number, qw: number, out: Float32Array, at: number): void;
+//# sourceMappingURL=GaussianSplat.d.ts.map

package/dist/core/GaussianSplat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GaussianSplat.d.ts","sourceRoot":"","sources":["../../src/core/GaussianSplat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AASH,MAAM,WAAW,SAAS;IACxB,sBAAsB;IACtB,SAAS,EAAE,YAAY,CAAC;IACxB,sBAAsB;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,qDAAqD;IACrD,SAAS,EAAE,YAAY,CAAC;IACxB,eAAe;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAS1G;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAkB7G;AAUD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,YAAY,CA0Bd;AAED,uDAAuD;AACvD,wBAAgB,UAAU,CACxB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,YAAY,EACjB,EAAE,EAAE,MAAM,GACT,IAAI,CAqBN"}

package/dist/core/GaussianSplat.js

@@ -0,0 +1,139 @@
+/**
+ * 3DGS（高斯泼溅）逐点属性的解码
+ *
+ * 输入是 MeshOpt 骨架里的两条自定义流，各 4 字节/顶点：
+ *   `gsScale`    —— 3 个 u8，log 量化；第 4 字节是填充
+ *   `gsRotation` —— 3 个 u8 存四元数的 x/y/z；w 由公式补；第 4 字节是填充
+ *
+ * 这两条流以前是「保留原始字节但语义未知」（FORMAT-NOTES 第九节的 D 级），
+ * 所以只能按点渲染。量化格式最终不是靠统计猜出来的，是从官方 worker
+ * `SuperMap3D/Workers/GaussianSplating.js`（3.9 KB）里读出来的，公式逐字如下：
+ *
+ * ```js
+ * function j(t){                    // scale
+ *   a[n*3+0] = Math.exp(t[n*4+0]/16 - 10)
+ *   a[n*3+1] = Math.exp(t[n*4+1]/16 - 10)
+ *   a[n*3+2] = Math.exp(t[n*4+2]/16 - 10)
+ * }
+ * function D(t){                    // rotation
+ *   c = t[n]/127.5 - 1; f = t[n+1]/127.5 - 1; x = t[n+2]/127.5 - 1
+ *   s = Math.sqrt(Math.max(0, 1 - (c*c + f*f + x*x)))
+ *   a[n] = s; a[n+1] = c; a[n+2] = f; a[n+3] = x      // (w, x, y, z)
+ * }
+ * ```
+ *
+ * 官方还有第二条分支（`isSPZCompress && version === 1.1`）走 10-10-10-2 的
+ * 「smallest three」打包，本模块也实现了 —— 见 `decodeRotation` 的 mode 判定。
+ *
+ * **为什么以前看这 4 字节像乱码**：第 4 字节确实不参与解码，于是同一瓦片里它
+ * 一会儿是 0 一会儿是 207（填充的残留），拿 32 位整数字段或 4 分量向量去套，
+ * 自然怎么都对不上。只取前 3 字节 + w 由单位化补出，立刻就是干净的四元数。
+ */
+/** SPZ 的 log 量化：scale 实际是 exp(v/16 - 10) 米 */
+const SCALE_LOG_DIV = 16;
+const SCALE_LOG_BIAS = 10;
+/** rotation 的 u8 归一化：0 → -1，255 → 1 */
+const ROT_U8_SCALE = 127.5;
+/**
+ * scale：`exp(byte/16 - 10)` 米。
+ * 值域 byte ∈ [0,255] → [4.54e-5, 380] 米，建筑泼溅的典型值（0.01~1 米）落在中段。
+ */
+export function decodeScale(bytes, stride, offset, count) {
+    const out = new Float32Array(count * 3);
+    for (let i = 0; i < count; i++) {
+        const o = i * stride + offset;
+        out[i * 3] = Math.exp(bytes[o] / SCALE_LOG_DIV - SCALE_LOG_BIAS);
+        out[i * 3 + 1] = Math.exp(bytes[o + 1] / SCALE_LOG_DIV - SCALE_LOG_BIAS);
+        out[i * 3 + 2] = Math.exp(bytes[o + 2] / SCALE_LOG_DIV - SCALE_LOG_BIAS);
+    }
+    return out;
+}
+/**
+ * rotation：3 个 u8 直接归一化到 [-1,1]，第四个分量由单位化补出。
+ *
+ * 输出顺序是 three 的 `(x, y, z, w)`，而官方内部是 `(w, x, y, z)` —— 这里已经换过。
+ */
+export function decodeRotation(bytes, stride, offset, count) {
+    const out = new Float32Array(count * 4);
+    let maxErr = 0;
+    for (let i = 0; i < count; i++) {
+        const o = i * stride + offset;
+        const x = bytes[o] / ROT_U8_SCALE - 1;
+        const y = bytes[o + 1] / ROT_U8_SCALE - 1;
+        const z = bytes[o + 2] / ROT_U8_SCALE - 1;
+        const w = Math.sqrt(Math.max(0, 1 - (x * x + y * y + z * z)));
+        out[i * 4] = x;
+        out[i * 4 + 1] = y;
+        out[i * 4 + 2] = z;
+        out[i * 4 + 3] = w;
+        maxErr = Math.max(maxErr, Math.abs(x * x + y * y + z * z + w * w - 1));
+    }
+    // 模长偏差只可能在「四元数确实不是这套编码」时出现，留给调用方判断
+    rotationResidual = maxErr;
+    return out;
+}
+/**
+ * 上一次 `decodeRotation` 的单位化残差（|q|²-1 的最大绝对值）。
+ *
+ * 这是判定「编码分支猜对没有」的判据：`D()` 分支下 w 是补出来的，残差恒 ≈ 0；
+ * 如果数据其实是 smallest-three 打包，把前 3 字节当分量解出来的 |q|² 会明显偏离 1。
+ */
+let rotationResidual = 0;
+export function lastRotationResidual() {
+    return rotationResidual;
+}
+/**
+ * 10-10-10-2 的 smallest-three（官方 `U()`，`isSPZCompress && version === 1.1` 时走这条）。
+ *
+ * 3 个分量各 10 bit（第 9 bit 是符号），剩下 2 bit 记录「哪一维是最大的」，
+ * 最大维由单位化补出 —— 这样只需要 32 bit 就能无损表达一个单位四元数。
+ */
+export function decodeRotationSmallestThree(bytes, stride, offset, count) {
+    const out = new Float32Array(count * 4);
+    const MASK = (1 << 9) - 1;
+    const SQRT_HALF = Math.SQRT1_2;
+    for (let i = 0; i < count; i++) {
+        const o = i * stride + offset;
+        const packed = (bytes[o] | (bytes[o + 1] << 8) | (bytes[o + 2] << 16) | (bytes[o + 3] << 24)) >>> 0;
+        const largest = (packed >>> 30) & 3;
+        let rest = packed;
+        let sumSq = 0;
+        for (let axis = 3; axis >= 0; axis--) {
+            if (axis === largest)
+                continue;
+            const mag = rest & MASK;
+            const negative = (rest >>> 9) & 1;
+            rest >>>= 10;
+            // 值域 [-√½, √½]：单位四元数里任一分量的上界
+            let v = (SQRT_HALF * mag) / MASK;
+            if (negative)
+                v = -v;
+            out[i * 4 + axis] = v;
+            sumSq += v * v;
+        }
+        out[i * 4 + largest] = Math.sqrt(Math.max(1 - sumSq, 0));
+    }
+    rotationResidual = 0;
+    return out;
+}
+/** 逐点协方差矩阵的上三角（6 个 float）：`Σ = R S Sᵀ Rᵀ`，供 EWA 投影用 */
+export function covariance(sx, sy, sz, qx, qy, qz, qw, out, at) {
+    // 旋转矩阵（列主序 3×3）
+    const xx = qx * qx, yy = qy * qy, zz = qz * qz;
+    const xy = qx * qy, xz = qx * qz, yz = qy * qz;
+    const wx = qw * qx, wy = qw * qy, wz = qw * qz;
+    const r00 = 1 - 2 * (yy + zz), r01 = 2 * (xy - wz), r02 = 2 * (xz + wy);
+    const r10 = 2 * (xy + wz), r11 = 1 - 2 * (xx + zz), r12 = 2 * (yz - wx);
+    const r20 = 2 * (xz - wy), r21 = 2 * (yz + wx), r22 = 1 - 2 * (xx + yy);
+    // M = R · diag(s)，则 Σ = M Mᵀ
+    const m00 = r00 * sx, m01 = r01 * sy, m02 = r02 * sz;
+    const m10 = r10 * sx, m11 = r11 * sy, m12 = r12 * sz;
+    const m20 = r20 * sx, m21 = r21 * sy, m22 = r22 * sz;
+    out[at] = m00 * m00 + m01 * m01 + m02 * m02;
+    out[at + 1] = m00 * m10 + m01 * m11 + m02 * m12;
+    out[at + 2] = m00 * m20 + m01 * m21 + m02 * m22;
+    out[at + 3] = m10 * m10 + m11 * m11 + m12 * m12;
+    out[at + 4] = m10 * m20 + m11 * m21 + m12 * m22;
+    out[at + 5] = m20 * m20 + m21 * m21 + m22 * m22;
+}
+//# sourceMappingURL=GaussianSplat.js.map

package/dist/core/GaussianSplat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GaussianSplat.js","sourceRoot":"","sources":["../../src/core/GaussianSplat.ts"],"names":[],"mappings":"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"}

package/dist/core/S3M1Parser.d.ts

@@ -2,7 +2,7 @@ import type { ParsedTile } from './types.js';
 export interface ParseS3M1Options {
     inflate?: (bytes: Uint8Array) => Uint8Array | Promise<Uint8Array>;
 }
-/** 是不是 S3M 1.x 容器 */
+/** 是不是 S3M 1.x 容器（版本字节 0 或 1） */
 export declare function isS3M1Buffer(buffer: ArrayBuffer): boolean;
 /**
  * 按「字节/像素」反推 S3MPixelFormat。

package/dist/core/S3M1Parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"S3M1Parser.d.ts","sourceRoot":"","sources":["../../src/core/S3M1Parser.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAKV,UAAU,EAIX,MAAM,YAAY,CAAC;AAKpB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACnE;AAED,qBAAqB;AACrB,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAGzD;AAoMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQvE;AA4CD,wBAAsB,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAuH7G"}
+{"version":3,"file":"S3M1Parser.d.ts","sourceRoot":"","sources":["../../src/core/S3M1Parser.ts"],"names":[],"mappings":"AA+DA,OAAO,KAAK,EAKV,UAAU,EAKX,MAAM,YAAY,CAAC;AAepB,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACnE;AAED,iCAAiC;AACjC,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAKzD;AAsZD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAQvE;AAgDD,wBAAsB,SAAS,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAwK7G"}