@aibee/crc-bmap 0.14.30 → 0.14.31

package/lib/meta.json

@@ -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",
@@ -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",
@@ -9956,10 +9956,10 @@
           "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
@@ -10061,7 +10061,7 @@
           "bytesInOutput": 4578
         },
         "../src/factory/material.ts": {
-          "bytesInOutput": 14227
+          "bytesInOutput": 13989
         },
         "../src/factory/unique-key.ts": {
           "bytesInOutput": 368
@@ -10340,7 +10340,7 @@
           "bytesInOutput": 0
         }
       },
-      "bytes": 452178
+      "bytes": 451684
     }
   }
 }

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/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/package.json

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