earthsdk3 3.11.1 → 3.11.2-beta.2

package/dist/types/ESObjectManager/index.d.ts

@@ -67,7 +67,7 @@ export declare class ESObjectsManager extends Destroyable {
      * @param option - 可以是对象 ID 或者对象类型，为空则返回所有对象。
      * @returns 单个场景对象、场景对象数组或undefined。
      */
-    getSceneObject(option?: string): ESSceneObject | ESSceneObject[] | undefined;
+    getSceneObject(option?: string, exactType?: boolean): ESSceneObject | ESSceneObject[] | undefined;
     /**
      * 获取场景对象的引用。
      */

package/dist/types/ESObjects/base/ESSceneObject/ESObjectsContext.d.ts

@@ -117,9 +117,10 @@ export declare class ESObjectsContext extends Destroyable {
     /**
      * 根据不同的条件获取场景对象实例
      * @param option 可选的条件，如果未提供则返回所有场景对象；如果以 'ES' 开头，则返回指定类型的所有场景对象；否则返回指定ID的场景对象
+     * @param exactType 传类查询时（typeof option === 'function'）为 true 则要求 typeName 与构造函数静态 type 严格一致，排除继承子类（如 ESRtsTileset 之于 ES3DTileset）；默认 false 保持 instanceof 语义（含子类）
      * @returns 符合条件的场景对象实例数组或单个实例，如果未找到则返回 undefined
      */
-    getSceneObject(option?: string | (new (...args: any[]) => ESSceneObject)): ESSceneObject | ESSceneObject[] | undefined;
+    getSceneObject(option?: string | (new (...args: any[]) => ESSceneObject), exactType?: boolean): ESSceneObject | ESSceneObject[] | undefined;
     /**
      * 根据场景对象类型名获取对应的构造函数
      * @param sceneObjectType 场景对象类型名

package/dist/types/ESObjects/base/ESSceneObject/index.d.ts

@@ -113,7 +113,7 @@ export declare class ESSceneObject extends Destroyable {
      * @param id - 对象的唯一标识符。
      * @returns 对应的场景对象，如果未找到则返回 undefined。
      */
-    static getSceneObj: (option?: string | (new (...args: any[]) => ESSceneObject)) => ESSceneObject | ESSceneObject[] | undefined;
+    static getSceneObj: (option?: string | (new (...args: any[]) => ESSceneObject), exactType?: boolean) => ESSceneObject | ESSceneObject[] | undefined;
     /**
      * 获取环境变量的方法。
      * @param key - 环境变量的键。
@@ -231,7 +231,7 @@ export declare class ESSceneObject extends Destroyable {
      * @param id - 对象的唯一标识符。
      * @returns 对应的场景对象，如果未找到则返回 undefined。
      */
-    static readonly getSceneObject: (option?: string | (new (...args: any[]) => ESSceneObject)) => ESSceneObject | ESSceneObject[] | undefined;
+    static readonly getSceneObject: (option?: string | (new (...args: any[]) => ESSceneObject), exactType?: boolean) => ESSceneObject | ESSceneObject[] | undefined;
     /**
      * 对象创建事件，由实现类决定何时触发，当对象创建完成时触发。
      */

package/dist/types/ESObjects/general/ESTerrainLayerEditing/EditingESGeoPolygon.d.ts

@@ -1,14 +1,30 @@
 import { ESTerrainLayerEditing } from '.';
 import { ESViewer } from '../../../ESViewer';
 import { Destroyable } from '../../../xbsj-base';
+/** 编辑对象支持的编辑模式：areaLifting=区域升降围栏；polygonFit=多边形拟合 */
+export type ESTerrainEditingMode = 'areaLifting' | 'polygonFit';
 /**
- * 地形图层编辑中的多边形对象
+ * 地形图层编辑中的可编辑对象（围栏 / 多边形）
  *
  * @remarks
- * 用于在地形图层编辑模式下创建一个可编辑的多边形围栏（ESGeoPolygon），
- * 将该多边形的点位（points）与场景对象的区域抬升点（areaLiftingPoints）进行双向绑定。
- * 当多边形编辑完成（editing 变为 false）时，自动销毁自身实例。
+ * 两种模式：
+ * - areaLifting：ESGeoPolygon 围栏，点位与 areaLiftingPoints 双向绑定；
+ * - polygonFit：ESGeoPolygon 多边形，点位与 polygonFitPoints 双向绑定（浮空显示），
+ *   绘制完成触发 polygonFitCompletedEvent。
+ * 两种模式绘制完成均保留绘制效果，销毁由核心层 ObjResettingWithEvent 统一管理
+ * （切换模式/重新启动时销毁）。
+ *
+ * 挂载方式：仅作为 sceneObject.components 的子组件存在（isMain=false，不调用 viewer.add，
+ * 避免注册到 objm、不出现在对象列表/场景树）。挂入 components 后，由 sceneObject 的 Czm 引擎对象
+ * （EngineObject 基类的 components watcher）自动 viewer.add：设置 parentID=sceneObject.id、
+ * 创建 Czm 引擎对象（渲染）并设置 activeViewer（editing 才能启动编辑且不被 bindCustomEditing 回滚）。
  */
 export declare class EditingESGeoPolygon extends Destroyable {
-    constructor(sceneObject: ESTerrainLayerEditing, activeViewer: ESViewer | undefined);
+    constructor(sceneObject: ESTerrainLayerEditing, activeViewer: ESViewer | undefined, mode?: ESTerrainEditingMode);
+    /**
+     * 创建多边形编辑器（areaLifting 围栏 / polygonFit 共用）
+     * @param options.pointsProp 绑定的点位属性名（areaLiftingPoints 或 polygonFitPoints）
+     * @param options.onCompleted 绘制完成回调（多边形 ≥3 点时触发），可选
+     */
+    private createEditor;
 }

package/dist/types/ESObjects/general/ESTerrainLayerEditing/index.d.ts

@@ -24,6 +24,30 @@ export type ESJTerrainLayerEditingConfig = {
     modelMatrix: ESJNativeNumber16;
     inverseModelMatrix: ESJNativeNumber16;
 };
+/**
+ * 矩形区域内的地形格点集合（由引擎层计算返回）
+ */
+export type ESTerrainRectGridItem = {
+    url: string;
+    tileX: number;
+    tileY: number;
+    points: {
+        vi: number;
+        lng: number;
+        lat: number;
+        height: number;
+    }[];
+};
+/**
+ * 待回填高度的地形格点集合（webui → 引擎层写顶点 buffer）
+ */
+export type ESTerrainRectFitItem = {
+    url: string;
+    points: {
+        vi: number;
+        height: number;
+    }[];
+};
 export declare enum ESTerrainLayerEditingFlattenMode {
     None = 0,
     Up = 1,
@@ -69,6 +93,11 @@ export declare class ESTerrainLayerEditing extends ESObjectWithLocation {
         flattenOffset: number;
         areaLiftingPoints: import('../../..').ReactiveVariable<[number, number, number][] | undefined>;
         areaLiftingOffset: number;
+        polygonFitEditing: import('../../..').ReactiveVariable<boolean>;
+        /** 拟合 3DTiles 会话标志（webui 在拟合模式下置 true）：会话中无绘制时不启动其他编辑 */
+        polygonFitMode: import('../../..').ReactiveVariable<boolean>;
+        /** 多边形拟合绘制完成的区域多边形（带拾取高度 z） */
+        polygonFitPoints: import('../../..').ReactiveVariable<[number, number, number][] | undefined>;
         fencePoints: import('../../..').ReactiveVariable<[number, number, number][] | undefined>;
         fenceMode: import('../../..').ReactiveVariable<"in" | "out">;
         pointed: boolean;
@@ -119,6 +148,33 @@ export declare class ESTerrainLayerEditing extends ESObjectWithLocation {
     private _areaLiftingUpdateEvent;
     get areaLiftingUpdateEvent(): Event<[]>;
     areaLiftingUpdate(): void;
+    private _requestPolygonGridEvent;
+    get requestPolygonGridEvent(): Event<[{
+        points: [number, number, number][];
+        callback: (items: ESTerrainRectGridItem[]) => void;
+    }]>;
+    private _applyHeightsEvent;
+    get applyHeightsEvent(): Event<[{
+        items: ESTerrainRectFitItem[];
+    }]>;
+    private _polygonFitCompletedEvent;
+    /**
+     * 多边形拟合绘制完成事件（用户绘制结束后自然触发，携带区域多边形 points，度）。
+     * 手动取消（polygonFitEditing 由外部置 false）不会触发。
+     */
+    get polygonFitCompletedEvent(): Event<[[number, number, number][]]>;
+    /**
+     * 获取多边形区域内地形格点的真实经纬度、顶点索引与原始高度。
+     * 内部通过 requestPolygonGridEvent 委托给引擎层计算（多边形内部过滤），结果经 Promise 返回。
+     * @param points 区域多边形经纬度点数组；缺省时读取 polygonFitPoints
+     * @returns 多边形覆盖的各瓦片格点集合
+     */
+    getPolygonGrid(points?: [number, number, number][]): Promise<ESTerrainRectGridItem[]>;
+    /**
+     * 将指定高度应用到地形瓦片顶点 buffer（引擎层执行，含邻居瓦片边界同步防裂缝）。
+     * @param items 待回填的高度格点集合（url → vi → height）
+     */
+    applyHeights(items: ESTerrainRectFitItem[]): void;
     constructor(id?: SceneObjectKey);
     getESProperties(): {
         coordinate: Property[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "earthsdk3",
-  "version": "3.11.1",
+  "version": "3.11.2-beta.2",
   "description": "地球可视化实验室 (EarthSDK&CesiumLab) https://www.bjxbsj.cn",
   "private": false,
   "type": "module",