s3m-three 0.0.0-stage → 0.1.0

package/dist/core/BinaryReader.js

@@ -0,0 +1,88 @@
+export class BinaryReader {
+    buffer;
+    base;
+    view;
+    offset;
+    _decoder = new TextDecoder('utf-8');
+    constructor(buffer, byteOffset = 0, byteLength) {
+        this.buffer = buffer;
+        this.base = byteOffset;
+        this.view = new DataView(buffer, byteOffset, byteLength === undefined ? buffer.byteLength - byteOffset : byteLength);
+        this.offset = 0;
+    }
+    get remaining() {
+        return this.view.byteLength - this.offset;
+    }
+    u8() {
+        const v = this.view.getUint8(this.offset);
+        this.offset += 1;
+        return v;
+    }
+    u16() {
+        const v = this.view.getUint16(this.offset, true);
+        this.offset += 2;
+        return v;
+    }
+    u32() {
+        const v = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        return v;
+    }
+    i32() {
+        const v = this.view.getInt32(this.offset, true);
+        this.offset += 4;
+        return v;
+    }
+    f32() {
+        const v = this.view.getFloat32(this.offset, true);
+        this.offset += 4;
+        return v;
+    }
+    f64() {
+        const v = this.view.getFloat64(this.offset, true);
+        this.offset += 8;
+        return v;
+    }
+    /** 返回原始字节视图（不拷贝，生命周期绑定底层 buffer） */
+    bytes(n) {
+        const a = new Uint8Array(this.buffer, this.base + this.offset, n);
+        this.offset += n;
+        return a;
+    }
+    /** 返回拷贝，用于纹理等需要脱离源 buffer 的数据 */
+    bytesCopy(n) {
+        const a = new Uint8Array(this.buffer, this.base + this.offset, n);
+        this.offset += n;
+        return a.slice();
+    }
+    string() {
+        const len = this.u32();
+        const a = new Uint8Array(this.buffer, this.base + this.offset, len);
+        this.offset += len;
+        return this._decoder.decode(a);
+    }
+    skip(n) {
+        this.offset += n;
+    }
+    /**
+     * 4 字节对齐。rel 是对齐基准在流中的偏移，默认 0（即整个流起点）。
+     * 纹理流用的是「纹理流起点」而不是文件起点，所以要显式传。
+     */
+    align4(rel = 0) {
+        const m = (this.offset - rel) % 4;
+        if (m !== 0)
+            this.skip(4 - m);
+    }
+    vec3f64() {
+        return { x: this.f64(), y: this.f64(), z: this.f64() };
+    }
+    boundingBox() {
+        return {
+            center: this.vec3f64(),
+            xExtent: this.vec3f64(),
+            yExtent: this.vec3f64(),
+            zExtent: this.vec3f64(),
+        };
+    }
+}
+//# sourceMappingURL=BinaryReader.js.map

package/dist/core/BinaryReader.js.map

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

package/dist/core/CRNDecode.d.ts

@@ -0,0 +1,13 @@
+export interface CRNResult {
+    width: number;
+    height: number;
+    /** CRN 里打包的 mip 层数（我们只取第 0 层，其余交给 three 生成） */
+    levels: number;
+    /** 1 / 3 / 5 */
+    dxtFormat: 1 | 3 | 5;
+    /** 第 0 层的 DXT 块数据 */
+    data: Uint8Array;
+}
+/** 解一个 CRN 块。失败时抛错（调用方负责降级成「无贴图」）。 */
+export declare function transcodeCRN(src: Uint8Array): Promise<CRNResult>;
+//# sourceMappingURL=CRNDecode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CRNDecode.d.ts","sourceRoot":"","sources":["../../src/core/CRNDecode.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB;IAChB,SAAS,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACrB,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;CAClB;AA2CD,sCAAsC;AACtC,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAyCtE"}

package/dist/core/CRNDecode.js

@@ -0,0 +1,84 @@
+let modulePromise = null;
+/**
+ * wasm 是否真的可用。
+ *
+ * 注意：胶水在实例化开始前就把 `Module.asm` 赋成了空对象，所以「asm 存在」不等于
+ * 「就绪」——必须看导出表里有没有东西，否则 `_malloc` 会在内部对一个 undefined 调 apply。
+ */
+function isReady(m) {
+    return !!m.asm && Object.keys(m.asm).length > 0;
+}
+/** wasm 只在真的遇到 CRN 纹理时才加载（内联在 vendor 里，不发额外请求） */
+async function getCrunch() {
+    if (!modulePromise) {
+        modulePromise = (async () => {
+            const mod = await import('../vendor/crunch_decoder.module.js');
+            const m = mod.default;
+            if (!isReady(m)) {
+                await new Promise((resolve) => {
+                    m.onRuntimeInitialized = () => resolve();
+                    const tick = () => {
+                        if (isReady(m))
+                            resolve();
+                        else
+                            setTimeout(tick, 8);
+                    };
+                    tick();
+                });
+            }
+            return m;
+        })();
+    }
+    return modulePromise;
+}
+/** CRN 文件头魔数 'Hx'；S3M 的纹理裸块没有容器头，但 crunch 负载自己保留了这两个字节 */
+const CRN_MAGIC = [0x48, 0x78];
+function hasMagic(src) {
+    return src.length >= 2 && src[0] === CRN_MAGIC[0] && src[1] === CRN_MAGIC[1];
+}
+/** 解一个 CRN 块。失败时抛错（调用方负责降级成「无贴图」）。 */
+export async function transcodeCRN(src) {
+    const srcSize = src.byteLength;
+    if (!srcSize)
+        throw new Error('[s3m] CRN 数据为空');
+    // 先验魔数：压缩方式标成 CRN 但数据其实不是（见过 DXT 被误标）时，
+    // crunch 会拿垃圾头解出一个尺寸「看着合理」的块，越早拦越好；也省掉一次 wasm 加载
+    if (!hasMagic(src))
+        throw new Error('[s3m] 数据没有 CRN 头（Hx），不是 crunch 负载');
+    const crunch = await getCrunch();
+    const srcPtr = crunch._malloc(srcSize);
+    if (!srcPtr)
+        throw new Error('[s3m] crunch 分配源数据失败');
+    try {
+        // 注意：malloc 可能触发堆扩容，HEAPU8 会换成新视图，所以每次都重新取
+        crunch.HEAPU8.set(src, srcPtr);
+        const fmt = crunch._crn_get_dxt_format(srcPtr, srcSize);
+        const dxtFormat = fmt === 0 ? 1 : fmt === 1 ? 3 : fmt === 2 ? 5 : 0;
+        if (!dxtFormat)
+            throw new Error(`[s3m] 不是可识别的 CRN 数据（dxtFormat=${fmt}）`);
+        const width = crunch._crn_get_width(srcPtr, srcSize);
+        const height = crunch._crn_get_height(srcPtr, srcSize);
+        const levels = crunch._crn_get_levels(srcPtr, srcSize);
+        if (!(width > 0) || !(height > 0)) {
+            throw new Error(`[s3m] CRN 尺寸异常：${width}×${height}`);
+        }
+        // 只解第 0 层：DXT1 每 4×4 块 8 字节，DXT3/5 是 16 字节
+        const blockSize = dxtFormat === 1 ? 8 : 16;
+        const dstSize = Math.max(1, width >> 2) * Math.max(1, height >> 2) * blockSize;
+        const dstPtr = crunch._malloc(dstSize);
+        if (!dstPtr)
+            throw new Error('[s3m] crunch 分配输出缓冲失败');
+        try {
+            crunch._crn_decompress(srcPtr, srcSize, dstPtr, dstSize, 0, 1);
+            const data = new Uint8Array(crunch.HEAPU8.subarray(dstPtr, dstPtr + dstSize));
+            return { width, height, levels, dxtFormat: dxtFormat, data };
+        }
+        finally {
+            crunch._free(dstPtr);
+        }
+    }
+    finally {
+        crunch._free(srcPtr);
+    }
+}
+//# sourceMappingURL=CRNDecode.js.map

package/dist/core/CRNDecode.js.map

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

package/dist/core/DXTTextureDecode.d.ts

@@ -0,0 +1,21 @@
+/**
+ * DXT1 / DXT3 / DXT5 纹理解码（squish 算法的 JS 移植）
+ *
+ * 来源：SuperMap iClient3D S3M SDK（Apache-2.0）。
+ * 迁移到 TS 时做了两件事，算法本身未改：
+ *   1. 补齐类型；
+ *   2. 修掉 `DecompressAlphaDxt3` 里把 `block` 误写成未定义全局 `bytes` 的笔误
+ *      （DXT3 纹理此前会直接 ReferenceError）。
+ */
+declare const DXTTextureDecode: {
+    /**
+     * @param out    输出缓冲，长度须为 width*height*4
+     * @param width  像素宽
+     * @param height 像素高
+     * @param block  压缩块
+     * @param format S3M pixelFormat（>11 或 5 走 DXT5，其余走 DXT1）
+     */
+    decode(out: Uint8Array, width: number, height: number, block: Uint8Array, format: number): void;
+};
+export default DXTTextureDecode;
+//# sourceMappingURL=DXTTextureDecode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DXTTextureDecode.d.ts","sourceRoot":"","sources":["../../src/core/DXTTextureDecode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoOH,QAAA,MAAM,gBAAgB;IACpB;;;;;;OAMG;gBACS,UAAU,SAAS,MAAM,UAAU,MAAM,SAAS,UAAU,UAAU,MAAM,GAAG,IAAI;CAahG,CAAC;AAEF,eAAe,gBAAgB,CAAC"}

package/dist/core/DXTTextureDecode.js

@@ -0,0 +1,236 @@
+/**
+ * DXT1 / DXT3 / DXT5 纹理解码（squish 算法的 JS 移植）
+ *
+ * 来源：SuperMap iClient3D S3M SDK（Apache-2.0）。
+ * 迁移到 TS 时做了两件事，算法本身未改：
+ *   1. 补齐类型；
+ *   2. 修掉 `DecompressAlphaDxt3` 里把 `block` 误写成未定义全局 `bytes` 的笔误
+ *      （DXT3 纹理此前会直接 ReferenceError）。
+ */
+const kDxt1 = 1 << 0;
+const kDxt3 = 1 << 1;
+const kDxt5 = 1 << 2;
+const krgb565 = 1 << 5;
+function Unpack565(packed0, packed1, colour, offset) {
+    const value = packed0 | (packed1 << 8);
+    const red = (value >> 11) & 0x1f;
+    const green = (value >> 5) & 0x3f;
+    const blue = value & 0x1f;
+    colour[offset + 0] = (red << 3) | (red >> 2);
+    colour[offset + 1] = (green << 2) | (green >> 4);
+    colour[offset + 2] = (blue << 3) | (blue >> 2);
+    colour[offset + 3] = 255;
+    return value;
+}
+function DecompressColour(rgba, block, nOffset, isDxt1) {
+    const codes = new Uint8Array(16);
+    const a = Unpack565(block[nOffset + 0], block[nOffset + 1], codes, 0);
+    const b = Unpack565(block[nOffset + 2], block[nOffset + 3], codes, 4);
+    for (let i = 0; i < 3; i++) {
+        const c = codes[i];
+        const d = codes[4 + i];
+        if (isDxt1 && a <= b) {
+            codes[8 + i] = (c + d) / 2;
+            codes[12 + i] = 0;
+        }
+        else {
+            codes[8 + i] = (2 * c + d) / 3;
+            codes[12 + i] = (c + 2 * d) / 3;
+        }
+    }
+    codes[8 + 3] = 255;
+    codes[12 + 3] = isDxt1 && a <= b ? 0 : 255;
+    const indices = new Uint8Array(16);
+    for (let i = 0; i < 4; ++i) {
+        const packed = block[nOffset + 4 + i];
+        indices[4 * i + 0] = packed & 0x3;
+        indices[4 * i + 1] = (packed >> 2) & 0x3;
+        indices[4 * i + 2] = (packed >> 4) & 0x3;
+        indices[4 * i + 3] = (packed >> 6) & 0x3;
+    }
+    for (let i = 0; i < 16; ++i) {
+        const offset = 4 * indices[i];
+        for (let j = 0; j < 4; ++j)
+            rgba[4 * i + j] = codes[offset + j];
+    }
+}
+function DecompressAlphaDxt3(rgba, block, nOffset) {
+    // unpack the alpha values pairwise
+    for (let i = 0; i < 8; ++i) {
+        // quantise down to 4 bits
+        const quant = block[nOffset + i];
+        // unpack the values
+        const lo = quant & 0x0f;
+        const hi = quant & 0xf0;
+        // convert back up to bytes
+        rgba[8 * i + 3] = lo | (lo << 4);
+        rgba[8 * i + 7] = hi | (hi >> 4);
+    }
+}
+function DecompressAlphaDxt5(rgba, block, start) {
+    const alpha0 = block[start + 0];
+    const alpha1 = block[start + 1];
+    const codes = new Uint8Array(8);
+    codes[0] = alpha0;
+    codes[1] = alpha1;
+    if (alpha0 <= alpha1) {
+        // use 5-alpha codebook
+        for (let i = 1; i < 5; ++i)
+            codes[1 + i] = ((5 - i) * alpha0 + i * alpha1) / 5;
+        codes[6] = 0;
+        codes[7] = 255;
+    }
+    else {
+        // use 7-alpha codebook
+        for (let i = 1; i < 7; ++i)
+            codes[1 + i] = ((7 - i) * alpha0 + i * alpha1) / 7;
+    }
+    const indices = new Uint8Array(16);
+    let nOffset = start + 2;
+    let nBegin = 0;
+    for (let i = 0; i < 2; ++i) {
+        // grab 3 bytes
+        let value = 0;
+        for (let j = 0; j < 3; ++j) {
+            const byte = block[nOffset++];
+            value |= byte << (8 * j);
+        }
+        // unpack 8 3-bit values from it
+        for (let j = 0; j < 8; ++j) {
+            const index = (value >> (3 * j)) & 0x7;
+            indices[nBegin++] = index;
+        }
+    }
+    for (let i = 0; i < 16; ++i)
+        rgba[4 * i + 3] = codes[indices[i]];
+}
+function Decompress(rgba, block, nOffset, flags) {
+    let nOffset2 = 0;
+    if ((flags & (kDxt3 | kDxt5)) !== 0)
+        nOffset2 = 8;
+    DecompressColour(rgba, block, nOffset + nOffset2, (flags & kDxt1) !== 0);
+    if ((flags & kDxt3) !== 0) {
+        DecompressAlphaDxt3(rgba, block, nOffset);
+    }
+    else if ((flags & kDxt5) !== 0) {
+        DecompressAlphaDxt5(rgba, block, nOffset);
+    }
+}
+/** 把 block 视为 uint16 数组：DXT1 的 565 快路径需要按 16 位读 */
+function asU16(view) {
+    const start = view.byteOffset & ~1;
+    const len = (view.byteLength + (view.byteOffset & 1)) >> 1;
+    return new Uint16Array(view.buffer, start, len);
+}
+function DecompressImage565(rgb565, width, height, blocks) {
+    const c = new Uint16Array(4);
+    const dst = rgb565;
+    let m = 0;
+    let dstI = 0;
+    let i = 0;
+    let r0 = 0;
+    let g0 = 0;
+    let b0 = 0;
+    let r1 = 0;
+    let g1 = 0;
+    let b1 = 0;
+    const blockWidth = width / 4;
+    const blockHeight = height / 4;
+    for (let blockY = 0; blockY < blockHeight; blockY++) {
+        for (let blockX = 0; blockX < blockWidth; blockX++) {
+            i = 4 * ((blockHeight - blockY) * blockWidth + blockX);
+            c[0] = blocks[i];
+            c[1] = blocks[i + 1];
+            r0 = c[0] & 0x1f;
+            g0 = c[0] & 0x7e0;
+            b0 = c[0] & 0xf800;
+            r1 = c[1] & 0x1f;
+            g1 = c[1] & 0x7e0;
+            b1 = c[1] & 0xf800;
+            // Interpolate between c0 and c1 to get c2 and c3.
+            // 1/3 用 3/8 近似、2/3 用 5/8 近似 —— 这也是多数 GPU 硬件解码器的做法
+            c[2] = ((5 * r0 + 3 * r1) >> 3) | (((5 * g0 + 3 * g1) >> 3) & 0x7e0) | (((5 * b0 + 3 * b1) >> 3) & 0xf800);
+            c[3] = ((5 * r1 + 3 * r0) >> 3) | (((5 * g1 + 3 * g0) >> 3) & 0x7e0) | (((5 * b1 + 3 * b0) >> 3) & 0xf800);
+            m = blocks[i + 2];
+            dstI = blockY * 4 * width + blockX * 4;
+            dst[dstI] = c[m & 0x3];
+            dst[dstI + 1] = c[(m >> 2) & 0x3];
+            dst[dstI + 2] = c[(m >> 4) & 0x3];
+            dst[dstI + 3] = c[(m >> 6) & 0x3];
+            dstI += width;
+            dst[dstI] = c[(m >> 8) & 0x3];
+            dst[dstI + 1] = c[(m >> 10) & 0x3];
+            dst[dstI + 2] = c[(m >> 12) & 0x3];
+            dst[dstI + 3] = c[(m >> 14) & 0x3];
+            m = blocks[i + 3];
+            dstI += width;
+            dst[dstI] = c[m & 0x3];
+            dst[dstI + 1] = c[(m >> 2) & 0x3];
+            dst[dstI + 2] = c[(m >> 4) & 0x3];
+            dst[dstI + 3] = c[(m >> 6) & 0x3];
+            dstI += width;
+            dst[dstI] = c[(m >> 8) & 0x3];
+            dst[dstI + 1] = c[(m >> 10) & 0x3];
+            dst[dstI + 2] = c[(m >> 12) & 0x3];
+            dst[dstI + 3] = c[(m >> 14) & 0x3];
+        }
+    }
+    return dst;
+}
+/**
+ * 解压整张 DXT 图。
+ *
+ * 解出的像素按 `{ r1,g1,b1,a1, ... , rn,gn,bn,an }`（n = width*height）连续写入 `rgba`。
+ */
+function DecompressImage(rgba, width, height, blocks, flags) {
+    const bytesPerBlock = (flags & kDxt1) !== 0 ? 8 : 16;
+    let nOffset = 0;
+    for (let y = 0; y < height; y += 4) {
+        for (let x = 0; x < width; x += 4) {
+            const targetRgba = new Uint8Array(4 * 16);
+            Decompress(targetRgba, blocks, nOffset, flags);
+            let nOffsetTarget = 0;
+            for (let py = 0; py < 4; ++py) {
+                for (let px = 0; px < 4; ++px) {
+                    const sx = x + px;
+                    const sy = y + py;
+                    if (sx < width && sy < height) {
+                        // flip Y
+                        let nBegin = 4 * (width * (height - sy) + sx);
+                        for (let i = 0; i < 4; ++i)
+                            rgba[nBegin++] = targetRgba[nOffsetTarget++];
+                    }
+                    else {
+                        nOffsetTarget += 4;
+                    }
+                }
+            }
+            // advance
+            nOffset += bytesPerBlock;
+        }
+    }
+}
+const DXTTextureDecode = {
+    /**
+     * @param out    输出缓冲，长度须为 width*height*4
+     * @param width  像素宽
+     * @param height 像素高
+     * @param block  压缩块
+     * @param format S3M pixelFormat（>11 或 5 走 DXT5，其余走 DXT1）
+     */
+    decode(out, width, height, block, format) {
+        if (out == null || block == null || height === 0 || width === 0)
+            return;
+        // 有 alpha 通道 → RGBA，否则走 rgb565
+        // S3MPixelFormat.BGR -> 11 / LUMINANCE_ALPHA -> 5
+        const flags = format > 11 || format === 5 ? kDxt5 : kDxt1 | krgb565;
+        if (flags & kDxt1 && flags & krgb565) {
+            DecompressImage565(asU16(out), width, height, asU16(block));
+        }
+        else {
+            DecompressImage(out, width, height, block, flags);
+        }
+    },
+};
+export default DXTTextureDecode;
+//# sourceMappingURL=DXTTextureDecode.js.map

package/dist/core/DXTTextureDecode.js.map

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

package/dist/core/FeatureInfo.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 单体属性提取
+ *
+ * S3M 的 `pickInfo` 是「SMID → batchId + 顶点区间」的映射，本身不带业务属性
+ * （OSGB 转 S3M 的数据通常没有属性表）。所以这里做两件事：
+ *   1. 反查 SMID —— 这是和 iServer 侧数据对齐的唯一标识；
+ *   2. 从几何直接算出可信的派生属性（高度、基底高程、外接盒、三角面数、楼层估算）。
+ *
+ * 派生属性是「算出来的」而不是「查出来的」，所以每一项都标注了计算口径，
+ * 避免使用者误以为是业务数据。
+ */
+import type { BufferGeometry } from 'three';
+import type { FeatureAttributes, GeoPackageEntry, PickEntry, PickSegment, SegmentBox } from './types.js';
+/** 楼层估算用的默认层高（米） */
+export declare const DEFAULT_FLOOR_HEIGHT = 3.2;
+/**
+ * 单体的控制位。
+ *
+ * 顶点区间型单体用 `batchId`（写进 `aBatchId`），实例化型用 `instanceBatchId`
+ * （写进 `aInstanceBatchId`）。两者都走「每网格一张状态纹理」，所以对上层是同一个概念。
+ */
+export declare function pickEntryId(entry?: PickEntry | null): number;
+/** 实例化几何里「实例序号 → 单体」的反查表 */
+export interface InstanceFeature {
+    smid: number;
+    /** 控制位（状态纹理下标） */
+    batchId: number;
+}
+export declare function buildInstanceLookup(pickInfo?: Record<number, PickEntry> | null): Map<number, InstanceFeature>;
+export declare function resolveFeature(geo: GeoPackageEntry | undefined, batchId: number): {
+    smid: number | null;
+    segments: PickSegment[];
+};
+/**
+ * 统计单体顶点区间包围盒 + 该单体自身的三角面数。
+ */
+export declare function measureSegments(geometry: BufferGeometry | undefined, segments: PickSegment[]): SegmentBox | null;
+/** 组装给 UI 展示的属性对象 */
+export declare function buildAttributes(args: {
+    smid: number | null;
+    box: SegmentBox | null;
+    triangles: number;
+    floorHeight?: number;
+}): FeatureAttributes;
+//# sourceMappingURL=FeatureInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureInfo.d.ts","sourceRoot":"","sources":["../../src/core/FeatureInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzG,oBAAoB;AACpB,eAAO,MAAM,oBAAoB,MAAM,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,MAAM,CAK5D;AAED,4BAA4B;AAC5B,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CACjC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,IAAI,GAC1C,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAW9B;AAED,wBAAgB,cAAc,CAC5B,GAAG,EAAE,eAAe,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,EAAE,CAAA;CAAE,CAUlD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,GAAG,IAAI,CA+ChH;AAED,qBAAqB;AACrB,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,UAAU,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,iBAAiB,CAmBpB"}

package/dist/core/FeatureInfo.js

@@ -0,0 +1,125 @@
+/** 楼层估算用的默认层高（米） */
+export const DEFAULT_FLOOR_HEIGHT = 3.2;
+/**
+ * 单体的控制位。
+ *
+ * 顶点区间型单体用 `batchId`（写进 `aBatchId`），实例化型用 `instanceBatchId`
+ * （写进 `aInstanceBatchId`）。两者都走「每网格一张状态纹理」，所以对上层是同一个概念。
+ */
+export function pickEntryId(entry) {
+    if (!entry)
+        return -1;
+    if (entry.batchId != null)
+        return entry.batchId;
+    if (entry.instanceBatchId != null)
+        return entry.instanceBatchId;
+    return -1;
+}
+export function buildInstanceLookup(pickInfo) {
+    const map = new Map();
+    if (!pickInfo)
+        return map;
+    for (const [key, entry] of Object.entries(pickInfo)) {
+        if (!entry?.instanceIds?.length)
+            continue;
+        const smid = Number(key);
+        if (!Number.isFinite(smid))
+            continue;
+        const batchId = pickEntryId(entry);
+        for (const instanceIndex of entry.instanceIds)
+            map.set(instanceIndex, { smid, batchId });
+    }
+    return map;
+}
+export function resolveFeature(geo, batchId) {
+    const pickInfo = geo?.pickInfo;
+    if (!pickInfo || batchId < 0)
+        return { smid: null, segments: [] };
+    for (const [id, entry] of Object.entries(pickInfo)) {
+        if (pickEntryId(entry) === batchId) {
+            return { smid: Number(id), segments: entry.segments ?? [] };
+        }
+    }
+    return { smid: null, segments: [] };
+}
+/**
+ * 统计单体顶点区间包围盒 + 该单体自身的三角面数。
+ */
+export function measureSegments(geometry, segments) {
+    const pos = geometry?.getAttribute('position');
+    if (!pos || !segments.length)
+        return null;
+    let minX = Infinity;
+    let minY = Infinity;
+    let minZ = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    let maxZ = -Infinity;
+    let count = 0;
+    for (const seg of segments) {
+        const end = Math.min(seg.vertexOffset + seg.vertexCount, pos.count);
+        for (let i = seg.vertexOffset; i < end; i++) {
+            const x = pos.getX(i);
+            const y = pos.getY(i);
+            const z = pos.getZ(i);
+            if (x < minX)
+                minX = x;
+            if (x > maxX)
+                maxX = x;
+            if (y < minY)
+                minY = y;
+            if (y > maxY)
+                maxY = y;
+            if (z < minZ)
+                minZ = z;
+            if (z > maxZ)
+                maxZ = z;
+            count++;
+        }
+    }
+    if (!count)
+        return null;
+    // 单体三角面数：索引三元组的三个顶点都落在本单体区间内才算，
+    // 直接用整个网格的 index.count 会把整片街区都算进去。
+    let triangles = 0;
+    const index = geometry.index;
+    if (index) {
+        const mask = new Uint8Array(pos.count);
+        for (const seg of segments) {
+            const end = Math.min(seg.vertexOffset + seg.vertexCount, pos.count);
+            mask.fill(1, seg.vertexOffset, end);
+        }
+        const arr = index.array;
+        for (let i = 0; i < arr.length; i += 3) {
+            if (mask[arr[i]] && mask[arr[i + 1]] && mask[arr[i + 2]])
+                triangles++;
+        }
+    }
+    return { minX, minY, minZ, maxX, maxY, maxZ, count, triangles };
+}
+/** 组装给 UI 展示的属性对象 */
+export function buildAttributes(args) {
+    const { smid, box, triangles, floorHeight = DEFAULT_FLOOR_HEIGHT } = args;
+    if (!box)
+        return { smid, triangles };
+    const height = box.maxZ - box.minZ;
+    return {
+        smid,
+        height: round(height, 1),
+        baseElevation: round(box.minZ, 1),
+        size: [round(box.maxX - box.minX, 1), round(box.maxY - box.minY, 1)],
+        bboxArea: round((box.maxX - box.minX) * (box.maxY - box.minY), 1),
+        floors: Math.max(1, Math.round(height / floorHeight)),
+        triangles: box.triangles ?? triangles,
+        vertices: box.count,
+        bbox: [
+            [round(box.minX, 1), round(box.minY, 1), round(box.minZ, 1)],
+            [round(box.maxX, 1), round(box.maxY, 1), round(box.maxZ, 1)],
+        ],
+    };
+}
+function round(v, d) {
+    const p = 10 ** d;
+    return Math.round(v * p) / p;
+}
+//# sourceMappingURL=FeatureInfo.js.map