@soonspacejs/plugin-tiles 2.15.16 → 2.15.17

package/dist/plot/GroundDecalManager.d.ts

@@ -1,12 +1,14 @@
 import { default as SoonSpace } from 'soonspacejs';
 import { CesiumGroundFrameState } from 'cesium-to-three/ground';
-import { GisPlotBase } from './plugins/base';
+import { GisPlotBase, GisPlotBoundingBoxResolver } from './plugins/base';
 import { GisPlotArrowSnapshot, GisPlotSnapshot, LonLatPoint, PlotAddOptions } from './plugins/types';
 import { PlotPrimitiveBridge } from './PlotPrimitiveBridge';
 /** 构造 GroundDecalManager 时的选项（注入 ssp）。 */
 export type GroundDecalManagerOptions = {
     /** SoonSpace 实例（必传）；标绘图元挂载到 ssp.viewport.scene。 */
     ssp: SoonSpace;
+    /** 把标绘经纬度转换为当前地形场景包围盒。 */
+    boundingBoxResolver?: GisPlotBoundingBoxResolver;
 };
 /** getItem / getItemDeep 的联合返回类型（箭头额外带 generatedCoords）。 */
 export type GisPlotItemSnapshot = GisPlotSnapshot | GisPlotArrowSnapshot;
@@ -34,6 +36,8 @@ export declare class GroundDecalManager {
     private _overlayAttached;
     /** 合并同一帧内多次 _markDirty，值为 requestAnimationFrame 句柄 */
     private _redrawTimer;
+    /** 由 TerrainTilesRenderer 提供的场景包围盒计算器。 */
+    private readonly _boundingBoxResolver?;
     constructor(options: GroundDecalManagerOptions);
     /** 暴露内部桥接器，业务若需自定义场景接入可选择性使用 */
     get bridge(): PlotPrimitiveBridge;
@@ -51,59 +55,67 @@ export declare class GroundDecalManager {
     /**
      * 添加标绘：由 options.type 决定实例化哪一类 GisPlot*。
      *
-     * @returns 新建标绘的自增字符串 id。
+     * @returns 新建标绘继承自 Object3D 的数字 id。
      * @throws  当 options.type 未知时抛错。
      */
-    addPlot(options: PlotAddOptions): string;
+    addPlot(options: PlotAddOptions): number;
     /** 按 id 移除标绘；存在并删除成功时触发重绘 */
-    remove(id: string): void;
+    remove(id: number): void;
     /** 清空全部标绘 */
     clear(): void;
+    /**
+     * 返回所有标绘项的 [id, GisPlotBase] 数组（浅拷贝，避免外部修改 _items）。
+     * 业务可用来遍历所有标绘项，或在渲染循环中做自定义处理。
+     * 注意：返回的 GisPlotBase 实例仍是原对象，修改其 options 会影响 _items。
+     */
+    getAllItems(): Array<GisPlotBase>;
+    /** 地形重定向或切换后清除全部标绘的场景包围盒缓存。 */
+    invalidateBoundingBoxes(): void;
     /**
      * 读取标绘浅快照（options 为新对象，points 仍共享引用；箭头附带 generatedCoords）。
      *
      * @returns 浅快照；id 不存在时返回 null。
      */
-    getItem(id: string): GisPlotItemSnapshot | null;
+    getItem(id: number): GisPlotItemSnapshot | null;
     /**
      * 读取标绘深快照：points 等嵌套数组被复制；箭头额外深拷贝 generatedCoords。
      *
      * @returns 深快照；id 不存在时返回 null。
      */
-    getItemDeep(id: string): GisPlotItemSnapshot | null;
+    getItemDeep(id: number): GisPlotItemSnapshot | null;
     /**
      * 合并更新样式与几何字段（调用对应 GisPlot*.update 做不可变整表替换）。
      */
-    setStyle(id: string, patch: GisPlotStylePatch): void;
+    setStyle(id: number, patch: GisPlotStylePatch): void;
     /**
      * 将第一个顶点设为新的经纬度中心（点 / 矩形中心 / 扇心 / 文字锚点等单中心
      * 语义）。**就地修改** points[0]（与 update 的不可变风格不同）。
      */
-    setCenter(id: string, center: CenterLonLat): void;
+    setCenter(id: number, center: CenterLonLat): void;
     /**
      * 整体替换顶点列表（每项为 [lon, lat]，深拷贝防止外部引用泄漏）。
      */
-    setCoords(id: string, coords: LonLatPoint[]): void;
+    setCoords(id: number, coords: LonLatPoint[]): void;
     /**
      * 修改指定下标顶点；coord 分量为 undefined 表示不改该分量。越界静默返回。
      */
-    setCoord(id: string, index: number, coord: Partial<LonLatPoint> | [number?, number?]): void;
+    setCoord(id: number, index: number, coord: Partial<LonLatPoint> | [number?, number?]): void;
     /**
      * 在 index 处插入一个顶点（可插末尾，越界钳位）。插入顶点深拷贝。
      */
-    insertCoord(id: string, index: number, coord: LonLatPoint): void;
+    insertCoord(id: number, index: number, coord: LonLatPoint): void;
     /**
      * 删除指定下标顶点。多边形至少保留 3 点，其余至少 2 点；越界 / 触底静默返回。
      */
-    removeCoord(id: string, index: number): void;
+    removeCoord(id: number, index: number): void;
     /**
      * 对所有顶点做经纬度平移（度），就地修改。
      */
-    translateCoords(id: string, dLon: number, dLat: number): void;
+    translateCoords(id: number, dLon: number, dLat: number): void;
     /**
      * 仅对 category === 'text' 的项更新 options.content。
      */
-    setText(id: string, text: string): void;
+    setText(id: number, text: string): void;
     /**
      * 设置整个标绘层的全局不透明度（0..1）。桥接器内部钳位。
      */
@@ -111,11 +123,11 @@ export declare class GroundDecalManager {
     /**
      * 返回某标绘顶点数（不存在返回 0）。
      */
-    getCoordCount(id: string): number;
+    getCoordCount(id: number): number;
     /**
      * 在经纬度平面找离 (lon, lat) 最近的顶点下标（平方距离最小）；无顶点返回 -1。
      */
-    findNearestCoord(id: string, lon: number, lat: number): number;
+    findNearestCoord(id: number, lon: number, lat: number): number;
     /**
      * 宿主每帧调用：在深度纹理渲染之后、renderer.render 之前，
      * 把深度纹理 / 视口 / 相机透传给所有标绘图元。
@@ -136,4 +148,4 @@ export declare class GroundDecalManager {
      */
     private _markDirty;
 }
-export type { PlotAddOptions, } from './plugins/types';
+export type { PlotAddOptions } from './plugins/types';

package/dist/plot/PlotPrimitiveBridge.d.ts

@@ -27,9 +27,9 @@ export declare class PlotPrimitiveBridge {
     private _disposed;
     constructor(options: PlotPrimitiveBridgeOptions);
     /** 接收 GroundDecalManager 交付的 Map */
-    set shapes(value: Map<string, GisPlotBase>);
+    set shapes(value: Map<number, GisPlotBase>);
     /** 当前持有的标绘集合（引用，与 GroundDecalManager._items 同一） */
-    get shapes(): Map<string, GisPlotBase>;
+    get shapes(): Map<number, GisPlotBase>;
     /** 全局不透明度，写入时钳到 [0, 1] */
     set opacity(value: number);
     get opacity(): number;

package/dist/plot/fly-to.d.ts

@@ -0,0 +1,16 @@
+import { Box3 } from 'three';
+import { TerrainTilesRenderer } from '../terrain-tiles-renderer/TerrainTilesRenderer';
+import { GisPlotBase } from './plugins/base';
+/**
+ * 计算标绘在当前地形对应的 SoonSpace 场景包围盒。
+ */
+export declare function computePlotBoundingBox(tilesRenderer: TerrainTilesRenderer, plot: GisPlotBase): Box3 | null;
+/**
+ * 根据 groundDecalManager.addPlot 返回的 id 飞向标绘。
+ *
+ * @param tilesRenderer 已启用的地形渲染器。
+ * @param plotId 标绘 id。
+ * @param delay 延迟执行时间（毫秒），默认 200ms。
+ * @returns true 表示已安排飞向；false 表示标绘或当前地形坐标不可用。
+ */
+export declare function flyToPlotById(tilesRenderer: TerrainTilesRenderer, plotId: number, delay?: number): boolean;

package/dist/plot/index.d.ts

@@ -6,6 +6,7 @@ export type { NormalizedRGBA, StyleOpacityInput, } from './plugins/utils/colorUt
 export * from './plugins/utils/ArrowUtils';
 export { PlotPrimitiveBridge, } from './PlotPrimitiveBridge';
 export type { PlotPrimitiveBridgeOptions, } from './PlotPrimitiveBridge';
+export { computePlotBoundingBox, flyToPlotById, } from './fly-to';
 export { EMERGENCY_RESOURCE_ICON_BY_ONTOLOGY_ID, EMERGENCY_RESOURCE_ONTOLOGY_IDS, resolveEmergencyResourceIcon, resolvePlotPointImageUrl, } from './emergency-resource-icons';
 export type { EmergencyResourceOntologyId, } from './emergency-resource-icons';
 export { plotOrderToRenderOrder, sanitizePlotOrder, } from './plot-order';

package/dist/plot/plugins/base.d.ts

@@ -1,11 +1,12 @@
 import { GisPlotBaseOptions, GisPlotCategory, GisPlotSnapshot, LonLatPoint } from './types';
+import { BaseMesh } from 'soonspacejs';
+import { Box3, Sphere } from 'three';
+/** 把标绘经纬度转换为当前 SoonSpace 场景包围盒。 */
+export type GisPlotBoundingBoxResolver = (plot: GisPlotBase) => Box3 | null;
 /**
- * 标绘数据模型基类。每个实例是一个**纯数据对象**：只持有 id / category /
- * options，不持有任何 GPU 资源 / Three 对象 / DOM 节点。
+ * 标绘数据模型基类。继承 BaseMesh，以便作为 SoonSpace 相机飞向目标使用。
  */
-export declare class GisPlotBase {
-    /** 自增字符串 id（'1' / '2' / '3' ...） */
-    readonly id: string;
+export declare class GisPlotBase extends BaseMesh {
     /**
      * 类别。基类构造为空串，子类用 `readonly category = 'xxx' as const` 覆写。
      * 桥接器据此 switch 分支。
@@ -16,7 +17,25 @@ export declare class GisPlotBase {
      * 收窄类型提示。
      */
     options: GisPlotBaseOptions;
+    /** 当前几何对应的场景包围盒缓存。 */
+    boundingBox: Box3 | null;
+    /** 当前几何对应的场景包围球缓存。 */
+    boundingSphere: Sphere | null;
+    /** 缓存对应的 options 快照键，兼容业务侧对 points 的就地修改。 */
+    private _boundingBoxCacheKey;
+    /** 由掌握地形坐标变换的 TerrainTilesRenderer 注入。 */
+    private _boundingBoxResolver;
     constructor(options: GisPlotBaseOptions);
+    /**
+     * 注入场景包围盒计算器。模型自身只有经纬度，不负责猜测地形坐标变换。
+     */
+    setBoundingBoxResolver(resolver: GisPlotBoundingBoxResolver): void;
+    /** 清除包围盒缓存；地形重定向或数据改变后调用。 */
+    invalidateBoundingBox(): void;
+    /** 按 Three.js Object3D 包围盒协议更新 boundingBox。 */
+    computeBoundingBox(): void;
+    /** 按 Three.js Object3D 包围体协议更新 boundingSphere。 */
+    computeBoundingSphere(): void;
     /**
      * 不可变整表替换：用展开 + patch 重建 options。
      * 子类覆写此方法仅为收窄 patch 的类型提示，方法体相同。

package/dist/plot/plugins/types.d.ts

@@ -1,3 +1,4 @@
+import { BaseObjectInfo } from 'soonspacejs';
 import { EmergencyResourceOntologyId } from '../emergency-resource-icons';
 /** 经纬度顶点：[经度°, 纬度°]，单位度。 */
 export type LonLatPoint = [number, number];
@@ -11,7 +12,7 @@ export type GisPlotCategory = 'point' | 'line' | 'polygon' | 'rectangle' | 'sect
  *   - strokeColor / fillColor 为 CSS 颜色字符串。
  *   - points 元素顺序固定为 [lon, lat]。
  */
-export type GisPlotBaseOptions = {
+export type GisPlotBaseOptions = Omit<BaseObjectInfo, 'rotation'> & {
     /** 图形顶点列表 [[lon, lat], ...] */
     points: LonLatPoint[];
     /** 描边色（CSS 字符串） */

package/dist/terrain-tiles-renderer/TerrainTilesRenderer.d.ts

@@ -120,6 +120,14 @@ export declare class TerrainTilesRenderer {
      * })
      */
     setTerrain(config: ITerrainConfig, options?: ITerrainTilesRendererOptions | undefined): void;
+    /**
+     * 根据 groundDecalManager.addPlot 返回的 id 飞向标绘。
+     *
+     * @param plotId 标绘 id。
+     * @param delay 延迟执行时间（毫秒），默认 200ms。
+     * @returns true 表示已安排飞向；false 表示标绘或当前地形坐标不可用。
+     */
+    flyToPlotById(plotId: number, delay?: number): boolean;
     /**
      * 添加  Overlay
      * 根据 options.type 自动识别类型并调用对应方法

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soonspacejs/plugin-tiles",
   "pluginName": "TilesPlugin",
-  "version": "2.15.16",
+  "version": "2.15.17",
   "description": "3D Tiles plugin for SoonSpace.js",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",
@@ -21,7 +21,7 @@
     "um-3d-tiles-renderer": "^0.4.48",
     "three": "^0.183.0",
     "@mapbox/geojson-merge": "^1.1.1",
-    "cesium-to-three": "^0.2.4",
-    "soonspacejs": "2.15.16"
+    "cesium-to-three": "0.2.4",
+    "soonspacejs": "2.15.17"
   }
 }