@aibee/crc-bmap 0.14.30 → 0.14.32

package/lib/meta.json

@@ -273,15 +273,15 @@
       "format": "esm"
     },
     "../lib/src/utils/text-layout.js": {
-      "bytes": 8986,
+      "bytes": 11045,
       "imports": [
         {
-          "path": "core-js/modules/es.array.push.js",
+          "path": "core-js/modules/es.regexp.exec.js",
           "kind": "import-statement",
           "external": true
         },
         {
-          "path": "core-js/modules/es.regexp.exec.js",
+          "path": "core-js/modules/es.array.push.js",
           "kind": "import-statement",
           "external": true
         },
@@ -1111,7 +1111,7 @@
       "format": "esm"
     },
     "../lib/src/factory/material.js": {
-      "bytes": 18099,
+      "bytes": 17404,
       "imports": [
         {
           "path": "core-js/modules/web.dom-collections.iterator.js",
@@ -1153,7 +1153,7 @@
       "format": "esm"
     },
     "../lib/src/factory/sdf-text.js": {
-      "bytes": 17640,
+      "bytes": 17858,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -1762,7 +1762,7 @@
       "format": "esm"
     },
     "../lib/src/elements/graphic.js": {
-      "bytes": 17324,
+      "bytes": 18300,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -2103,7 +2103,7 @@
       "format": "esm"
     },
     "../src/factory/material.ts": {
-      "bytes": 18157,
+      "bytes": 17779,
       "imports": [
         {
           "path": "three/examples/jsm/lines/LineMaterial.js",
@@ -2193,7 +2193,7 @@
       "format": "esm"
     },
     "../src/factory/sdf-text.ts": {
-      "bytes": 18116,
+      "bytes": 18715,
       "imports": [
         {
           "path": "three",
@@ -2382,7 +2382,7 @@
       "format": "esm"
     },
     "../src/utils/text-layout.ts": {
-      "bytes": 8784,
+      "bytes": 11298,
       "imports": [
         {
           "path": "three",
@@ -3193,7 +3193,7 @@
       "format": "esm"
     },
     "../lib/src/elements/poi2.js": {
-      "bytes": 24968,
+      "bytes": 25509,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -3625,7 +3625,7 @@
       "format": "esm"
     },
     "../lib/src/elements/text-texture.js": {
-      "bytes": 5425,
+      "bytes": 5644,
       "imports": [
         {
           "path": "../../../node_modules/.pnpm/@swc+helpers@0.5.17/node_modules/@swc/helpers/esm/_extends.js",
@@ -7194,12 +7194,12 @@
           "external": true
         },
         {
-          "path": "core-js/modules/es.array.push.js",
+          "path": "core-js/modules/es.regexp.exec.js",
           "kind": "import-statement",
           "external": true
         },
         {
-          "path": "core-js/modules/es.regexp.exec.js",
+          "path": "core-js/modules/es.array.push.js",
           "kind": "import-statement",
           "external": true
         },
@@ -9848,10 +9848,10 @@
           "bytesInOutput": 208
         },
         "../lib/src/bmap.js": {
-          "bytesInOutput": 11142
+          "bytesInOutput": 11143
         },
         "../lib/src/context/context.js": {
-          "bytesInOutput": 9421
+          "bytesInOutput": 9410
         },
         "../lib/src/utils/timer.js": {
           "bytesInOutput": 1783
@@ -9899,7 +9899,7 @@
           "bytesInOutput": 196
         },
         "../lib/src/utils/text-layout.js": {
-          "bytesInOutput": 2623
+          "bytesInOutput": 2962
         },
         "../lib/src/utils/string.js": {
           "bytesInOutput": 423
@@ -9941,7 +9941,7 @@
           "bytesInOutput": 829
         },
         "../lib/src/utils/event-dispatcher.js": {
-          "bytesInOutput": 95
+          "bytesInOutput": 96
         },
         "../lib/src/utils/kalman-filter.js": {
           "bytesInOutput": 405
@@ -9956,13 +9956,13 @@
           "bytesInOutput": 3434
         },
         "../lib/src/elements/graphic.js": {
-          "bytesInOutput": 7531
+          "bytesInOutput": 7516
         },
         "../lib/src/factory/material.js": {
-          "bytesInOutput": 14229
+          "bytesInOutput": 13988
         },
         "../lib/src/factory/sdf-text.js": {
-          "bytesInOutput": 7718
+          "bytesInOutput": 7759
         },
         "../../../node_modules/.pnpm/@mapbox+tiny-sdf@2.3.0/node_modules/@mapbox/tiny-sdf/index.js": {
           "bytesInOutput": 2371
@@ -10031,10 +10031,10 @@
           "bytesInOutput": 5457
         },
         "../lib/src/elements/overlay.js": {
-          "bytesInOutput": 4420
+          "bytesInOutput": 4421
         },
         "../lib/src/elements/floor.js": {
-          "bytesInOutput": 4503
+          "bytesInOutput": 4504
         },
         "../lib/src/elements/model.js": {
           "bytesInOutput": 410
@@ -10049,7 +10049,7 @@
           "bytesInOutput": 2240
         },
         "../lib/src/layer/poi-layer2.js": {
-          "bytesInOutput": 1754
+          "bytesInOutput": 1756
         },
         "../lib/src/layer/parking-layer.js": {
           "bytesInOutput": 4035
@@ -10061,22 +10061,22 @@
           "bytesInOutput": 4578
         },
         "../src/factory/material.ts": {
-          "bytesInOutput": 14227
+          "bytesInOutput": 14000
         },
         "../src/factory/unique-key.ts": {
-          "bytesInOutput": 368
+          "bytesInOutput": 369
         },
         "../src/utils/webworker.ts": {
           "bytesInOutput": 277
         },
         "../src/utils/worker-pool.ts": {
-          "bytesInOutput": 826
+          "bytesInOutput": 829
         },
         "../src/factory/worker/merge-geometry.worker.ts": {
           "bytesInOutput": 103
         },
         "../src/factory/merge-geometry.ts": {
-          "bytesInOutput": 1695
+          "bytesInOutput": 1696
         },
         "../lib/src/layer/tile-layer.js": {
           "bytesInOutput": 3860
@@ -10085,7 +10085,7 @@
           "bytesInOutput": 1595
         },
         "../lib/src/elements/poi2.js": {
-          "bytesInOutput": 12068
+          "bytesInOutput": 12193
         },
         "../lib/src/elements/heatmap.js": {
           "bytesInOutput": 2123
@@ -10118,7 +10118,7 @@
           "bytesInOutput": 3905
         },
         "../lib/src/elements/text-texture.js": {
-          "bytesInOutput": 2168
+          "bytesInOutput": 2224
         },
         "../lib/src/elements/line.js": {
           "bytesInOutput": 1125
@@ -10154,7 +10154,7 @@
           "bytesInOutput": 2645
         },
         "../lib/src/operations/hover/hover-helper.js": {
-          "bytesInOutput": 2929
+          "bytesInOutput": 2930
         },
         "../lib/src/utils/camera-bound.js": {
           "bytesInOutput": 2201
@@ -10163,7 +10163,7 @@
           "bytesInOutput": 3691
         },
         "../lib/src/context/OrbitControls.js": {
-          "bytesInOutput": 13559
+          "bytesInOutput": 13548
         },
         "../lib/src/context/renderer.js": {
           "bytesInOutput": 1126
@@ -10184,10 +10184,10 @@
           "bytesInOutput": 1276
         },
         "../lib/src/loader/AibeeLoader/index.js": {
-          "bytesInOutput": 9188
+          "bytesInOutput": 9189
         },
         "../lib/src/loader/AibeeLoader/layer.js": {
-          "bytesInOutput": 4410
+          "bytesInOutput": 4413
         },
         "../lib/src/loader/AibeeLoader/utils.js": {
           "bytesInOutput": 1143
@@ -10211,10 +10211,10 @@
           "bytesInOutput": 1524
         },
         "../lib/src/plugins/base.js": {
-          "bytesInOutput": 205
+          "bytesInOutput": 206
         },
         "../lib/src/plugins/navigation/navigation.js": {
-          "bytesInOutput": 15448
+          "bytesInOutput": 15451
         },
         "../lib/src/plugins/navigation/path.js": {
           "bytesInOutput": 2839
@@ -10223,10 +10223,10 @@
           "bytesInOutput": 13835
         },
         "../lib/src/plugins/navigation/position-navigation.js": {
-          "bytesInOutput": 7114
+          "bytesInOutput": 7115
         },
         "../lib/src/plugins/navigation/start-rotate-helper-poi.js": {
-          "bytesInOutput": 3438
+          "bytesInOutput": 3439
         },
         "../lib/src/plugins/mul-floors/mul-floors.js": {
           "bytesInOutput": 2266
@@ -10250,13 +10250,13 @@
           "bytesInOutput": 2645
         },
         "../lib/src/plugins/pdr-position/sensor.js": {
-          "bytesInOutput": 2925
+          "bytesInOutput": 2926
         },
         "../lib/src/plugins/pdr-position/enum.js": {
           "bytesInOutput": 125
         },
         "../lib/src/plugins/pdr-position/position.js": {
-          "bytesInOutput": 930
+          "bytesInOutput": 931
         },
         "../lib/src/plugins/pdr-position/pdr.js": {
           "bytesInOutput": 3682
@@ -10286,7 +10286,7 @@
           "bytesInOutput": 1040
         },
         "../lib/src/plugins/car-inertial-position/car-inertial-position.js": {
-          "bytesInOutput": 6825
+          "bytesInOutput": 6826
         },
         "../lib/src/plugins/car-inertial-position/utils.js": {
           "bytesInOutput": 1820
@@ -10301,10 +10301,10 @@
           "bytesInOutput": 4004
         },
         "../lib/src/plugins/position/position.js": {
-          "bytesInOutput": 11417
+          "bytesInOutput": 11409
         },
         "../lib/src/plugins/position/socket.js": {
-          "bytesInOutput": 2592
+          "bytesInOutput": 2593
         },
         "../lib/src/plugins/position/utils.js": {
           "bytesInOutput": 140
@@ -10340,7 +10340,7 @@
           "bytesInOutput": 0
         }
       },
-      "bytes": 452178
+      "bytes": 452255
     }
   }
 }

package/lib/src/elements/graphic.d.ts

@@ -1,4 +1,4 @@
-import { Object3D, ExtrudeGeometry, Mesh, MeshBasicMaterial, Raycaster, Object3DEventMap, Vector3, BufferGeometry, LineBasicMaterial, LineSegments, ShaderMaterial, LineDashedMaterial } from "three";
+import { Object3D, ExtrudeGeometry, Mesh, Box3, MeshBasicMaterial, Raycaster, Object3DEventMap, Vector3, BufferGeometry, LineBasicMaterial, LineSegments, ShaderMaterial, LineDashedMaterial } from "three";
 import { GraphicOptions } from "src/types";
 import { Context } from "../context/context";
 export type GraphicOptionsParam = Partial<GraphicOptions>;
@@ -35,7 +35,26 @@ export declare class Graphic extends Object3D<GraphicEventMap> {
     initDoor(): void;
     initGeometry(): ExtrudeGeometry;
     initSingleMaterial(): MeshBasicMaterial | MeshBasicMaterial[];
-    getMaxAndMin(pos: Vector3, dir: Vector3): {
+    /**
+     * 几何体本地包围盒（shader 里 position 用的就是这个坐标系）
+     *
+     * 不能用 Box3.setFromObject(this)：它给的是世界坐标包围盒。图元摆到楼层上之后，
+     * 端点会带上楼层高度 / airHeight / deltaHeight 的偏移，而 shader 用的是本地 position，
+     * 坐标系不一致会让渐变整体平移（偏移量 = dot(Δ, lineVec) / |lineVec|²）。
+     */
+    getLocalBox(): Box3;
+    /**
+     * 沿 direction 取渐变线段的两个端点
+     *
+     * 线性投影的极值一定落在包围盒角点上，遍历 8 个角点即可。
+     * 端点恒在包围盒内、且与 shader 的 position 同坐标系：
+     * 不会出现射线求交打空退化成 (0, 0, 0)（t = 0/0 = NaN → 整面纯色），
+     * 也不受图元摆放位置、airHeight、deltaHeight 影响。
+     *
+     * min = 沿 direction 投影较小的一端（shader 里 t = 0 → uColor），
+     * max = 投影较大的一端（t = 1 → uGradualColor）。
+     */
+    getGradualEndpoints(box: Box3, direction: Vector3): {
         max: Vector3;
         min: Vector3;
     };

package/lib/src/elements/poi2.d.ts

@@ -91,6 +91,11 @@ export declare class Poi2 extends Object3D<PoiEventMap2> {
     get iconWidth(): number;
     get iconHeight(): number;
     get textWidth(): number;
+    /**
+     * 文字块高度（显示像素）。
+     * 直接由排版高度按固定比例换算：`text_font_size / spec.fontSize`，
+     * 与行数、字符组成无关，保证每一行在屏幕上都精确等于 text_font_size 像素。
+     */
     get textHeight(): number;
     get initedTextRect(): true | "" | {
         width: number;

package/lib/src/factory/material.d.ts

@@ -16,12 +16,17 @@ interface MeshBasicMaterialOptions {
 }
 interface ShaderMaterialOptions {
     gradualColor: string[];
-    center: Vector3;
-    maxValue: number;
     opacity: number;
-    direction: Vector3;
+    /** 渐变线段的两端，必须是几何体本地坐标系（与 shader 里的 position 同系） */
     max: Vector3;
     min: Vector3;
+    /**
+     * @deprecated 渐变轴只由 min / max 决定，center / maxValue / direction
+     * 已不参与渲染，仅为兼容旧调用保留。
+     */
+    center?: Vector3;
+    maxValue?: number;
+    direction?: Vector3;
 }
 interface Line2MaterialMapOptions {
     color: string;
@@ -45,7 +50,7 @@ export declare class MaterialFactory {
     static createLineMaterial({ color, opacity, vertexColors }: LineMaterialOptions): LineBasicMaterial;
     static createMeshStandardMaterial({ color, opacity }: MeshStandardMaterialOptions): MeshStandardMaterial;
     static createMeshBasicMaterial({ color, opacity, vertexColors }: MeshBasicMaterialOptions): MeshBasicMaterial;
-    static createShaderMaterial({ gradualColor, center, maxValue, opacity, direction, max, min, }: ShaderMaterialOptions): ShaderMaterial;
+    static createShaderMaterial({ gradualColor, opacity, max, min, }: ShaderMaterialOptions): ShaderMaterial;
     static createLine2MaterialMap({ color, width, dashed, resolution, vertexColors }: Line2MaterialMapOptions): LineMaterial;
     private static lineDashedMaterialMap;
     static createLineDashedMaterial(options: {

package/lib/src/factory/sdf-text.d.ts

@@ -12,8 +12,18 @@ export interface SdfFontSpec {
     cutoff: number;
     /** 字形位图四周的 SDF padding（参考像素），决定描边的最大可用宽度 */
     buffer: number;
-    /** 行距（在 fontSize 之上追加的参考像素），与 SDF padding 解耦 */
-    lineGap: number;
+    /**
+     * 行距（相对 fontSize 的比例，与 SDF padding 解耦）。
+     * 0.125 表示行高 = 1.125em：显示字号 14px 时行距为 1.75px。
+     */
+    lineGapRatio: number;
+    /**
+     * 字体上升部（相对 fontSize 的比例）：行顶到基线的距离。
+     * 属于字体级度量，与具体字符无关，是排版高度的唯一来源。
+     */
+    ascentRatio: number;
+    /** 字体下降部（相对 fontSize 的比例）：基线到行底的距离 */
+    descentRatio: number;
 }
 /**
  * 默认字体规格。

package/lib/src/utils/text-layout.d.ts

@@ -15,21 +15,37 @@ export interface TextLayoutResult {
     glyphs: PositionedGlyph[];
     /** 布局宽度（SDF 基准字号像素） */
     width: number;
-    /** 布局高度（SDF 基准字号像素） */
+    /**
+     * 文本块高度（SDF 基准字号像素，即 em 单位）。
+     * 只由字号、行距、行数决定，与具体字符无关：
+     * `[1 + (行数 - 1) × (1 + lineGapRatio)] × fontSize`
+     * （ascentRatio + descentRatio 默认合计为 1em）
+     */
     height: number;
     /** 宽高比 */
     aspect: number;
     /** 行数 */
     linesCount: number;
+    /** 实际字形 ink 的下边界（相对文本块底部，SDF 基准字号像素） */
+    inkBottom: number;
+    /** 实际字形 ink 的高度（SDF 基准字号像素）；如需紧贴文字的旧行为，用它做归一化 */
+    inkHeight: number;
 }
 type MeasureFn = (str: string) => number;
 /**
  * 按括号/空格/中文逐字规则换行。
  * 逻辑与旧 `TextTextureFactory.splitText` 保持一致，仅把度量方式换成字形 advance 累加。
+ *
+ * 显式换行符 `\n` 优先：业务方常用它按字段分行，不能被宽度折行打乱。
  */
 export declare function splitTextByMeasure(text: string, maxWidth: number, measure: MeasureFn): string[];
 /**
  * 对文字进行 SDF 布局。
+ *
+ * 排版高度与基线位置全部由字体规格（fontSize / lineGapRatio / ascentRatio / descentRatio）决定，
+ * 与实际渲染的字符无关，因此同一字号在不同行数、不同文本下都能得到一致的显示字号。
+ * 这里的数值都是 em 单位，最终乘 `text_font_size / fontSize` 即可得到显示像素。
+ *
  * @param text 文本
  * @param charMap 字符 → 字形度量（来自 SdfTextFactory 图集）
  * @param spec 字体规格
@@ -41,6 +57,13 @@ interface BuildGeometryOptions {
     pivotY?: number;
     /** 水平 pivot，对应 Sprite.center.x，默认 0.5 */
     pivotX?: number;
+    /**
+     * 归一化区间的下边界（默认 0：以整个文本块底部为准）。
+     * 传入 `layout.inkBottom` + `layout.inkHeight` 可让几何紧贴字形 ink，保持旧行为的视觉尺寸。
+     */
+    normalizeBottom?: number;
+    /** 归一化区间的高度（默认整个文本块高度） */
+    normalizeHeight?: number;
 }
 /** 某个图集页对应的那部分文字几何 */
 export interface SdfTextGeometryPart {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aibee/crc-bmap",
-  "version": "0.14.30",
+  "version": "0.14.32",
   "description": "",
   "main": "lib/index.cjs",
   "module": "lib/index.esm.min.js",