@soonspacejs/plugin-tiles 2.15.14 → 2.15.16

package/dist/plot/PlotPrimitiveBridge.d.ts

@@ -5,6 +5,8 @@ import { GisPlotBase } from './plugins/base';
 export interface PlotPrimitiveBridgeOptions {
     /** 标绘图元挂载的目标场景 */
     scene: Scene;
+    /** 图片资源异步就绪后请求宿主刷新 */
+    requestRender?: () => void;
 }
 /**
  * 标绘图元桥接器：把 Map<id, GisPlot*> 同步为一组 CesiumGround*Primitive。
@@ -18,6 +20,9 @@ export declare class PlotPrimitiveBridge {
     private _opacity;
     /** 挂载场景 */
     private readonly _scene;
+    /** 图片资源异步就绪后请求宿主刷新；按 URL 去重监听 */
+    private readonly _requestRender?;
+    private readonly _watchedImageUrls;
     /** 已释放标记 */
     private _disposed;
     constructor(options: PlotPrimitiveBridgeOptions);
@@ -41,7 +46,7 @@ export declare class PlotPrimitiveBridge {
     dispose(): void;
     /**
      * 当前图元是否支持样式热更新（颜色 / 描边等）。
-     * 折线（setColor / setWidth）与文字（setText）支持；面类不支持，需重建。
+     * 折线（setColor / setWidth）、文字（setText）和图片点透明度支持；面类不支持，需重建。
      */
     private _supportsStyleHotUpdate;
     /**
@@ -58,4 +63,10 @@ export declare class PlotPrimitiveBridge {
      * @returns 渲染图元；未知类型 / 退化情况返回 null。
      */
     private _buildPrimitive;
+    /**
+     * 贴地图元依赖异步 TextureLoader，而 SoonSpace 默认按需渲染；
+     * 图片解码完成后若没有新的渲染请求，纹理会等到相机交互才首次显示。
+     * 用原生 Image 监听资源就绪并通知宿主，按 URL 去重避免重复监听。
+     */
+    private _watchImageTexture;
 }

package/dist/plot/emergency-resource-icons.d.ts

@@ -0,0 +1,2 @@
+export { EMERGENCY_RESOURCE_ICON_BY_ONTOLOGY_ID, EMERGENCY_RESOURCE_ONTOLOGY_IDS, resolveEmergencyResourceIcon, resolvePlotPointImageUrl, } from 'cesium-to-three/plot';
+export type { EmergencyResourceOntologyId, } from 'cesium-to-three/plot';

package/dist/plot/index.d.ts

@@ -6,4 +6,6 @@ export type { NormalizedRGBA, StyleOpacityInput, } from './plugins/utils/colorUt
 export * from './plugins/utils/ArrowUtils';
 export { PlotPrimitiveBridge, } from './PlotPrimitiveBridge';
 export type { PlotPrimitiveBridgeOptions, } from './PlotPrimitiveBridge';
+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/types.d.ts

@@ -1,3 +1,4 @@
+import { EmergencyResourceOntologyId } from '../emergency-resource-icons';
 /** 经纬度顶点：[经度°, 纬度°]，单位度。 */
 export type LonLatPoint = [number, number];
 /** 标绘类别枚举，与 8 个 GisPlot* 子类一一对应；也是桥接器 switch(category) 的分支依据。 */
@@ -41,18 +42,31 @@ export type GisPlotSnapshot<T extends GisPlotBaseOptions = GisPlotBaseOptions> =
 export type GisPlotArrowSnapshot = GisPlotSnapshot<PlotArrowOptions> & {
     generatedCoords: LonLatPoint[];
 };
-/** 点标绘形状：'circle' = 圆点，'square' = 方点。 */
-export type PlotPointStyle = 'circle' | 'square';
+/** 点标绘形状：圆点、方点或使用米制宽高贴地的图片。 */
+export type PlotPointStyle = 'circle' | 'square' | 'image';
 /**
  * 点标绘选项。points[0] 为点中心；size 在 cesium-to-three 侧：
  * circle 解释为直径、square 解释为边长。
  */
-export type PlotPointOptions = GisPlotBaseOptions & {
-    /** 点形状：'circle' / 'square' */
-    pointStyle: PlotPointStyle;
-    /** 尺寸（米）：circle 为直径、square 为边长 */
+export type PlotPointOptions = GisPlotBaseOptions & ({
+    /** 普通点形状。 */
+    pointStyle: 'circle' | 'square';
+    /** 尺寸（米）：circle 为直径、square 为边长。 */
     size: number;
-};
+} | {
+    /** 图片点。 */
+    pointStyle: 'image';
+    /** 图片贴地足迹宽度（米）。 */
+    imageWidth: number;
+    /** 图片贴地足迹高度（米）。 */
+    imageHeight: number;
+    /** 俯视顺时针旋转角度；0 表示图片顶部朝北。 */
+    rotation?: number;
+    /** 本体 ID；显式图片 URL 同时存在时优先使用 URL。 */
+    ontologyId?: EmergencyResourceOntologyId | (string & {});
+    /** 显式图片资源地址。 */
+    imageUrl?: string;
+});
 /**
  * 折线描边样式：实线 / 虚线。cesium-to-three 贴地折线着色器只支持 solid / dash 两态。
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soonspacejs/plugin-tiles",
   "pluginName": "TilesPlugin",
-  "version": "2.15.14",
+  "version": "2.15.16",
   "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.1.7",
-    "soonspacejs": "2.15.14"
+    "cesium-to-three": "^0.2.4",
+    "soonspacejs": "2.15.16"
   }
 }