@soonspacejs/plugin-tiles 2.15.1 → 2.15.4

package/dist/plot/GroundDecalManager.d.ts

@@ -41,7 +41,7 @@ export declare class GroundDecalManager {
      * 内部使用的 `PlotOverlay` 实例。
      * 注册到 `ImageOverlayPlugin` 的 `overlays` 数组中，顺序靠后者通常绘制在上层。
      */
-    get plotSdfPlugin(): PlotSdfPlugin;
+    get plotSdfPlugin(): PlotSdfPlugin | undefined;
     /**
      * 绑定 / 更换 PlotOverlayPlugin（切换地形重建插件后调用）。
      * 如果当前已有图形，会在下一帧自动重新注册 overlay。

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

@@ -76,16 +76,33 @@ export type PlotArrowOptions = GisPlotBaseOptions & {
 };
 /** 文本标绘 */
 export type PlotTextAlign = 'left' | 'center' | 'right';
+export type PlotTextVerticalAlign = 'top' | 'middle' | 'bottom';
+export type PlotTextAnchorX = 'left' | 'center' | 'right';
+export type PlotTextAnchorY = 'top' | 'middle' | 'bottom';
+export type PlotTextLayoutDirection = 'horizontal' | 'vertical-rl' | 'vertical-lr';
+/**
+ * Text box plot options.
+ * `points[0]` is the textbox anchor point in lon / lat degrees.
+ * `textAlign` / `verticalAlign` control content alignment inside the box.
+ * `anchorX` / `anchorY` control where the box sits relative to the anchor point.
+ */
 export type PlotTextOptions = GisPlotBaseOptions & {
     content: string;
     fontColor: string;
     fontSize: number;
+    scale?: number;
     textAlign?: PlotTextAlign;
-    showBorder?: boolean;
-    fillColor?: string;
-    fillOpacity?: number;
+    verticalAlign?: PlotTextVerticalAlign;
+    anchorX?: PlotTextAnchorX;
+    anchorY?: PlotTextAnchorY;
+    boxWidth?: number;
+    boxHeight?: number;
+    padding?: number;
+    layoutDirection?: PlotTextLayoutDirection;
+    rotation?: number;
     offsetX?: number;
     offsetY?: number;
+    showBorder?: boolean;
 };
 /** 箭头快照：在 options 外附加 `generatedCoords` */
 export type GisPlotArrowSnapshot = GisPlotSnapshot<PlotArrowOptions> & {

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

@@ -13,17 +13,18 @@ export declare class OverlayManager {
     private imageOverlayPlugin;
     private resourceManager?;
     /** 存储所有 overlay 实例 */
+    private static readonly MAX_OVERLAY_INSTANCES;
     private _instances;
     constructor(imageOverlayPlugin: ImageOverlayPlugin | undefined, resourceManager?: ResourceManager | undefined);
-    addGeoJSON(options: IGeoJSONOverlayOptions): GeoJSONOverlay | null;
+    addGeoJSONOverlay(options: IGeoJSONOverlayOptions): GeoJSONOverlay | null;
     updateGeoJSONColor(id: string, color: string): boolean;
     updateGeoJSONStrokeStyle(id: string, strokeStyle: string): boolean;
     updateGeoJSONStrokeWidth(id: string, strokeWidth: number): boolean;
     updateGeoJSONFillStyle(id: string, fillStyle: string): boolean;
     updateGeoJSONMode(id: string, mode: 'overlay' | 'mask' | 'invertMask'): boolean;
-    addCesiumIon(options: ICesiumIonOverlayOptions): CesiumIonOverlay | null;
-    addTMS(options: ITMSTilesOverlayOptions): TMSTilesOverlay | null;
-    addXYZ(options: IXYZTilesOverlayOptions): XYZTilesOverlay | null;
+    addCesiumIonOverlay(options: ICesiumIonOverlayOptions): CesiumIonOverlay | null;
+    addTMSOverlay(options: ITMSTilesOverlayOptions): TMSTilesOverlay | null;
+    addXYZOverlay(options: IXYZTilesOverlayOptions): XYZTilesOverlay | null;
     /**
      * 添加 URL 模板 Overlay
      *
@@ -55,9 +56,9 @@ export declare class OverlayManager {
      *   url: 'https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}'
      * })
      */
-    addUrlTemplate(options: IUrlTemplateOverlayOptions): UrlTemplateTilesOverlay | null;
-    addWMS(options: IWMSTilesOverlayOptions): Promise<WMSTilesOverlay | null>;
-    addWMTS(options: IWMTSTilesOverlayOptions): Promise<WMTSTilesOverlay | null>;
+    addUrlTemplateOverlay(options: IUrlTemplateOverlayOptions): UrlTemplateTilesOverlay | null;
+    addWMSOverlay(options: IWMSTilesOverlayOptions): Promise<WMSTilesOverlay | null>;
+    addWMTSOverlay(options: IWMTSTilesOverlayOptions): Promise<WMTSTilesOverlay | null>;
     /**
      * 移除 overlay
      */
@@ -110,6 +111,7 @@ export declare class OverlayManager {
      * 获取 overlay 数量
      */
     get count(): number;
+    private _getImageOverlayPluginForAdd;
     /**
      * 获取本地影像数量（不依赖 ResourceManager）
      */

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

@@ -1,4 +1,4 @@
-import { TilesRenderer } from 'um-3d-tiles-renderer';
+import { Tile, TilesRenderer } from 'um-3d-tiles-renderer';
 import { TilesFadePlugin, UpdateOnChangePlugin, ImageOverlayPlugin, ReorientationPlugin, PlotSdfPlugin } from 'um-3d-tiles-renderer/plugins';
 import { default as SoonSpace } from 'soonspacejs';
 import { TileCustomMaterialPlugin } from './plugins';
@@ -85,6 +85,14 @@ export declare class TerrainTilesRenderer {
      * 更新所有已加载模型的 alpha 裁剪模式
      */
     private _updateAlphaClipMode;
+    /**
+     * 添加影像或倾斜加载事件监听
+     */
+    addEventLoad(callback: (options: {
+        tile: Tile | null;
+        error: Error;
+        url: string | URL;
+    }) => void): void;
     /**
      * 设置地形
      * 会创建新的 TilesRenderer 实例以避免状态残留问题
@@ -105,59 +113,12 @@ export declare class TerrainTilesRenderer {
      */
     setTerrain(config: ITerrainConfig, options?: ITerrainTilesRendererOptions | undefined): void;
     /**
-     * 添加 GeoJSON Overlay
-     * @example
-     * tilesRenderer.addGeoJSON({
-     *   id: 'china-boundary',
-     *   url: './data/china.geojson',
-     *   color: '#ff0000',
-     *   opacity: 0.8
-     * })
+     * 添加  Overlay
+     * 根据 options.type 自动识别类型并调用对应方法
+     * @param options Overlay 配置选项，必须包含 type 字段
+     * @returns Overlay 实例或 null（如果添加失败）
      */
-    addGeoJSON(options: IGeoJSONOverlayOptions): import('um-3d-tiles-renderer/plugins').GeoJSONOverlay | null;
-    /**
-     * 添加 Cesium Ion Overlay
-     */
-    addCesiumIonOverlay(options: ICesiumIonOverlayOptions): import('um-3d-tiles-renderer/plugins').CesiumIonOverlay | null;
-    /**
-     * 添加 TMS Tiles Overlay
-     */
-    addTMSOverlay(options: ITMSTilesOverlayOptions): import('um-3d-tiles-renderer/plugins').TMSTilesOverlay | null;
-    /**
-     * 添加 XYZ Tiles Overlay
-     */
-    addXYZOverlay(options: IXYZTilesOverlayOptions): import('um-3d-tiles-renderer/plugins').XYZTilesOverlay | null;
-    /**
-     * 添加 URL Template Overlay
-     *
-     * 支持多种 URL 模板变量：
-     * - `{z}`, `{x}`, `{y}` - 标准 XYZ 坐标
-     * - `{s}` - 子域名轮换
-     * - `{reverseY}` - TMS 风格的 Y 坐标
-     * - `{westDegrees}`, `{southDegrees}`, `{eastDegrees}`, `{northDegrees}` - 地理边界框
-     *
-     * @example
-     * tilesPlugin.addUrlTemplateOverlay({
-     *   id: 'osm',
-     *   url: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png'
-     * })
-     *
-     * @example
-     * tilesPlugin.addUrlTemplateOverlay({
-     *   id: 'carto',
-     *   url: 'https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}.png',
-     *   subdomains: 'abcd'
-     * })
-     */
-    addUrlTemplateOverlay(options: IUrlTemplateOverlayOptions): import('um-3d-tiles-renderer/plugins').UrlTemplateTilesOverlay | null;
-    /**
-     * 添加 WMS Tiles Overlay
-     */
-    addWMSOverlay(options: IWMSTilesOverlayOptions): Promise<import('um-3d-tiles-renderer/plugins').WMSTilesOverlay | null>;
-    /**
-     * 添加 WMTS Tiles Overlay
-     */
-    addWMTSOverlay(options: IWMTSTilesOverlayOptions): Promise<import('um-3d-tiles-renderer/plugins').WMTSTilesOverlay | null>;
+    addOverlay(options: IGeoJSONOverlayOptions | ICesiumIonOverlayOptions | IGeoJSONOverlayOptions | ITMSTilesOverlayOptions | IXYZTilesOverlayOptions | IWMSTilesOverlayOptions | IWMTSTilesOverlayOptions | IUrlTemplateOverlayOptions): Promise<import('um-3d-tiles-renderer/plugins').XYZTilesOverlay | import('um-3d-tiles-renderer/plugins').GeoJSONOverlay | import('um-3d-tiles-renderer/plugins').CesiumIonOverlay | import('um-3d-tiles-renderer/plugins').TMSTilesOverlay | import('um-3d-tiles-renderer/plugins').UrlTemplateTilesOverlay | import('um-3d-tiles-renderer/plugins').WMSTilesOverlay | import('um-3d-tiles-renderer/plugins').WMTSTilesOverlay | null>;
     /**
      * 移除指定 overlay
      */
@@ -185,6 +146,12 @@ export declare class TerrainTilesRenderer {
      * 更新 GeoJSON 填充样式
      */
     updateGeoJSONFillStyle(id: string, fillStyle: string): boolean;
+    /**
+     * 合并多个 GeoJSON
+     * @param geojsons 待合并的 GeoJSON 数组
+     * @returns 合并后的 GeoJSON
+     */
+    mergeGeoJSON(geojsons: any[]): import('geojson-merge-ts').GeoJSONFeatureCollection;
     /**
      * 设置 overlay 层级顺序
      * @param id overlay ID

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

@@ -82,6 +82,8 @@ export interface IOverlayBaseOptions {
     opacity?: number;
     /** 层级顺序（数值越大越靠上），默认按添加顺序 */
     order?: number;
+    /** 类型 */
+    type: OverlayType;
 }
 /**
  * GeoJSON Overlay 配置

package/dist/tiles-renderer/TilesRendererManager.d.ts

@@ -1,5 +1,19 @@
 import { default as SoonSpace } from 'soonspacejs';
 import { TilesRenderer, ITilesRendererOptions, ICesiumIonOptions } from './TilesRenderer';
+import { IReorientationOptions } from '../terrain-tiles-renderer/types';
+export type ReferencePlacementUp = '+x' | '-x' | '+y' | '-y' | '+z' | '-z' | 'x' | 'y' | 'z';
+export type IReferenceOriginOptions = IReorientationOptions;
+export interface IReferencePlacementOptions extends IReorientationOptions {
+    /** Local up axis of the tileset. Default is +z, matching ReorientationPlugin. */
+    up?: ReferencePlacementUp;
+}
+export type IManagedTilesRendererOptions = (ITilesRendererOptions | ICesiumIonOptions) & {
+    /**
+     * Place this tileset relative to the manager reference origin.
+     * If omitted and reference origin is set, the existing reorientation option is used as placement.
+     */
+    placement?: IReferencePlacementOptions | false;
+};
 /**
  * TilesRendererManager - 管理多个 TilesRenderer 实例
  * 参考 TilesPlugin 的设计
@@ -15,16 +29,32 @@ export declare class TilesRendererManager {
     private _lruCache;
     private _parseQueue;
     private _downloadQueue;
+    private _referenceOrigin;
+    private _referencePlacements;
+    private _referenceFrame;
+    private _targetFrame;
+    private _sourceFrame;
+    private _placementMatrix;
+    private _upCorrectionMatrix;
+    private _boundingSphere;
     constructor(ssp: SoonSpace);
     private _beforeRenderHandler;
     private _onCameraObjectChange;
+    get referenceOrigin(): IReferenceOriginOptions | null;
+    /**
+     * Set the shared geographic origin provided by terrain.
+     * Tiles with placement / reorientation are positioned relative to this origin.
+     */
+    setReferenceOrigin(origin: IReferenceOriginOptions): void;
+    setReferenceOrigin(lon: number, lat: number, height?: number): void;
+    clearReferenceOrigin(): void;
     /**
      * 加载 3D Tiles
      * @param url - tileset.json 地址
      * @param options - 配置项
      * @returns Promise<ThreeDTilesRenderer>
      */
-    loadTiles(options: ITilesRendererOptions | ICesiumIonOptions): Promise<TilesRenderer | undefined>;
+    loadTiles(options: IManagedTilesRendererOptions): Promise<TilesRenderer | undefined>;
     /**
      * 移除 3D Tiles
      * @param url - tileset.json 地址
@@ -43,7 +73,13 @@ export declare class TilesRendererManager {
      * 清除所有 tiles
      */
     clear(): void;
-    invalidate(lon: number, lat: number, alt: number): void;
+    invalidate(lon: number, lat: number, alt: number, targetRenderer?: TilesRenderer): void;
+    applyReferencePlacement(renderer: TilesRenderer, placement: IReferencePlacementOptions | null): boolean;
+    private _isGeoreferenced;
+    private _getSourceFrame;
+    private _getReferencePlacement;
+    private _getTilesRendererOptions;
+    private _getUpCorrectionMatrix;
     /**
      * 销毁插件
      */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@soonspacejs/plugin-tiles",
   "pluginName": "TilesPlugin",
-  "version": "2.15.1",
+  "version": "2.15.4",
   "description": "3D Tiles plugin for SoonSpace.js",
   "main": "dist/index.esm.js",
   "module": "dist/index.esm.js",
@@ -18,8 +18,9 @@
   "license": "UNLICENSED",
   "gitHead": "4a87dd85050651088e11c3da777c49fab3db7e5d",
   "peerDependencies": {
-    "um-3d-tiles-renderer": "^0.4.41",
+    "um-3d-tiles-renderer": "^0.4.46",
     "three": "^0.183.0",
-    "soonspacejs": "2.15.1"
+    "@mapbox/geojson-merge": "^1.1.1",
+    "soonspacejs": "2.15.4"
   }
 }