earthsdk3 3.11.0 → 3.11.1

package/dist/types/ESObjects/general/ESGeoSmoothPolygon.d.ts

@@ -0,0 +1,66 @@
+import { ESJEditingBindModeType, ESJFillStyle } from '../../ESJTypes';
+import { SceneObjectKey, UniteChanged } from '../../xbsj-base';
+import { ESGeoVector } from '../base';
+/**
+ * 平滑多边形类，继承自 ESGeoVector。
+ * 用于在场景中创建平滑多边形对象，支持填充和描边，并额外提供贴地（ground）和厚度（depth）属性。
+ * 编辑模式支持圆形追加和圆形插入。
+ * @remarks 平滑多边形
+ */
+export declare class ESGeoSmoothPolygon extends ESGeoVector {
+    static readonly createDefaultProps: () => {
+        /** 是否贴地 @deprecated */
+        ground: boolean;
+        /** 厚度 */
+        depth: number;
+        /** 是否描边 */
+        stroked: boolean;
+        /** 是否填充 */
+        filled: boolean;
+        /** 填充样式 */
+        fillStyle: import('../..').ReactiveVariable<ESJFillStyle>;
+        pointed: boolean;
+        pointStyle: import('../..').ReactiveVariable<import('../..').ESJPointStyle>;
+        strokeStyle: import('../..').ReactiveVariable<import('../..').ESJStrokeStyle>;
+        points: import('../..').ReactiveVariable<[number, number, number][] | undefined>;
+        show: boolean;
+        collision: boolean;
+        allowPicking: boolean;
+        flyToParam: import('../..').ReactiveVariable<import('../..').ESJFlyToParam | undefined>;
+        flyInParam: import('../..').ReactiveVariable<import('../..').ESJFlyInParam | undefined>;
+        name: string;
+        ref: string | undefined;
+        extras: import('../..').ReactiveVariable<import('../..').JsonValue>;
+        devTags: import('../..').ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+    static readonly type: string;
+    _deprecated: string[];
+    private _deprecatedWarningFunc;
+    /**
+     * 构造一个 ESGeoSmoothPolygon 实例。
+     * @param id - 场景对象的键值标识，可选。
+     */
+    constructor(id?: SceneObjectKey);
+    static supportEditingModes: string[];
+    editingBindMode: ESJEditingBindModeType;
+    /**
+     * 获取当前对象的属性配置。
+     * 在继承父类属性的基础上，额外添加了通用分组下的贴地（ground）和厚度（depth）属性。
+     * @returns 包含完整属性配置的对象。
+     */
+    getESProperties(): {
+        more: import('../..').Property[];
+        defaultMenu: string;
+        coordinate: import('../..').Property[];
+        style: import('../..').Property[];
+        general: import('../..').Property[];
+        basic: import('../..').Property[];
+        dataSource: import('../..').Property[];
+        location: import('../..').Property[];
+    };
+}
+export interface ESGeoSmoothPolygon extends UniteChanged<ReturnType<typeof ESGeoSmoothPolygon.createDefaultProps>> {
+}

package/dist/types/ESObjects/general/ESGeoWater.d.ts

@@ -20,6 +20,7 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  * 特殊使用限制或潜在的副作用：
  * - 在设置水域类型为 'custom' 时，其他控制效果的参数才会生效，否则使用预定效果。
  * - 水体浑浊度的取值范围是 0 - 10，超出该范围可能会导致渲染异常。
+ * @remarks 地理水面
  */
 export declare class ESGeoWater extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESGltfModel.d.ts

@@ -62,13 +62,14 @@ type ModelNodeTransformation = {
  * - 在设置节点变换信息时，需要确保传入的向量元素都是有限数值，否则会触发错误日志。
  * - 设置材质时，需要通过 `setMaterial` 方法，该方法返回一个 Promise，需要在 Promise 解析后获取最终的材质信息。
  * - 仅 Cesium 引擎生效的设置，如 `setLight122` 方法，用于设置默认光照。
+ * @remarks glTF模型加载
  */
 export declare class ESGltfModel extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {
         /**
          * 模型资源路径（GLB/GLTF 文件地址）
          * @type {string | ESJResource | undefined}
-         * @default /assets/glb/building.glb
+         * @default ${earthsdk3-assets-script-dir}/assets/glb/building.glb
          */
         url: string | ESJResource | undefined;
         /**

package/dist/types/ESObjects/general/ESHeightLimitAnalysis.d.ts

@@ -22,6 +22,7 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  * 特殊使用限制或潜在的副作用：
  * - 该类依赖于 ESGeoPolygon、ESClassification 和 ESGeoExtrudedPolygon 等类，确保这些类已正确导入和使用。
  * - 在设置高度、最高高度和颜色等属性时，需要确保传入的值在合理范围内，以避免显示异常。
+ * @remarks 控高分析
  */
 export declare class ESHeightLimitAnalysis extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESHeightMeasurement.d.ts

@@ -19,6 +19,8 @@ import { ESGeoVector } from '../base';
  * 特殊使用限制或潜在的副作用：
  * - 该类依赖于 ESGeoVector 类，因此需要确保 ESGeoVector 已正确导入和使用。
  * - 高度值的计算基于传入的点的 Z 轴坐标差值，确保点的坐标格式正确。
+ *
+ * @remarks 高度测量
  */
 export declare class ESHeightMeasurement extends ESGeoVector {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESHole.d.ts

@@ -19,6 +19,7 @@ import { ESPit } from './ESPit';
  * 特殊的使用限制或潜在的副作用：
  * - 该类是组合类，使用时需要注意组件之间的依赖关系和状态同步。
  * - 在设置属性时，需要确保相关组件的状态一致，以避免出现不一致的情况。
+ * @remarks 孔洞
  */
 export declare class ESHole extends ESPit {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESHuman.d.ts

@@ -18,6 +18,7 @@ import { ESObjectWithLocation } from '../base';
  * 特殊使用限制或潜在的副作用：
  * - 该类的使用需要依赖 ESObjectWithLocation 类和相关的事件系统。
  * - 自动寻路事件和停止自动寻路事件的触发需要确保相关的事件监听器已经设置。
+ * @remarks 人员
  */
 export declare class ESHuman extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESHumanFountain.d.ts

@@ -21,6 +21,7 @@ import { ESHuman } from './ESHuman';
  * 特殊使用限制或潜在的副作用：
  * - 该类是组合类，内部包含 ESHuman 和 ESFountainParticleSystem 实例，因此在使用时需要注意这两个实例的属性和方法。
  * - 在创建实例时，建议提供唯一的 ID，以避免潜在的冲突。
+ * @remarks 人员喷泉
  */
 export declare class ESHumanFountain extends ESHuman {
     static readonly createDefaultProps: () => {
@@ -43,9 +44,7 @@ export declare class ESHumanFountain extends ESHuman {
         /** 粒子发射率（每秒发射数量） */
         fountainEmissionRate: number;
         mode: (typeof ESHuman.modes)[number][1];
-        animation: 
-        /** 喷泉扩散角度（度），影响水柱的扩散范围 */
-        (typeof ESHuman.animations)[number][1];
+        animation: (typeof ESHuman.animations)[number][1];
         allowPicking: boolean;
         instances: import('../..').ReactiveVariable<import('../..').ESJESGltfModelInstances | undefined>;
         pointed: boolean;

package/dist/types/ESObjects/general/ESHumanPoi.d.ts

@@ -22,6 +22,7 @@ import { ESPoi2D } from './ESPoi2D';
  * 特殊使用限制或潜在的副作用：
  * - 该类是组合类，内部包含 ESHuman 和 ESPoi2D 实例，因此在使用时需要注意这两个实例的属性和方法。
  * - 在创建实例时，建议提供唯一的 ID，以避免潜在的冲突。
+ * @remarks 人员POI
  */
 export declare class ESHumanPoi extends ESHuman {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESHumans.d.ts

@@ -1,6 +1,12 @@
 import { ESJVector3D, Property } from '../../ESJTypes';
 import { SceneObjectKey, UniteChanged } from '../../xbsj-base';
 import { ESHuman } from './ESHuman';
+/**
+ * ESHumans - 用于在场景中指定位置批量创建人员（角色）实例的可视化对象。
+ * 继承自 ESHuman，支持通过 instancesCount 和 radius 属性批量生成并分布多个人员实例。
+ * 每个子实例会自动继承父对象的显示、拾取、缩放、动画、飞行等行为和属性。
+ * @remarks 人员批量
+ */
 export declare class ESHumans extends ESHuman {
     static readonly createDefaultProps: () => {
         instancesCount: number;
@@ -35,6 +41,10 @@ export declare class ESHumans extends ESHuman {
     static readonly type: string;
     humans: ESHuman[];
     humansOffset: Map<string, ESJVector3D>;
+    /**
+     * 创建 ESHumans 实例。
+     * @param id - 场景对象键标识符，可选。传入后可用于在场景中定位和引用该对象。
+     */
     constructor(id?: SceneObjectKey);
     getESProperties(): {
         basic: Property[];

package/dist/types/ESObjects/general/ESImageLabel.d.ts

@@ -23,6 +23,8 @@ import { ESLabel } from '../base';
  * - 默认锚点为 [0.5, 1]，即水平居中、底部对齐
  * - 默认渲染模式为 4
  * - 该类支持 Cesium 和 UE 引擎实现
+ *
+ * @remarks 图片标签
  */
 export declare class ESImageLabel extends ESLabel {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESKml.d.ts

@@ -0,0 +1,70 @@
+import { ESJResource } from '../../ESJTypes';
+import { Listener, Event, UniteChanged } from '../../xbsj-base';
+import { ESSceneObject } from '../base';
+/**
+ * ESKml 是用于在场景中加载和显示 KML/KMZ 数据的对象，支持路径、地标和时空数据的展示与管理。
+ * @remarks 支持 KML/KMZ 格式文件的加载，可通过 uri（远程/本地路径）或 data（直接数据）两种方式进行加载。
+ */
+export declare class ESKml extends ESSceneObject {
+    static readonly createDefaultProps: () => {
+        show: boolean;
+        uri: string | undefined | ESJResource;
+        allowPicking: boolean;
+        loadFuncStr: string | undefined;
+        data: string | undefined;
+        autoResetClock: boolean;
+        clockEnabled: boolean;
+        startTime: number | undefined;
+        stopTime: number | undefined;
+        currentTime: number | undefined;
+        multiplier: number;
+        clockStep: string;
+        clockRange: string;
+        shouldAnimate: boolean;
+        clampToGround: boolean;
+        name: string;
+        ref: string | undefined;
+        extras: import('../..').ReactiveVariable<import('../..').JsonValue>;
+        devTags: import('../..').ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+    static readonly type: string;
+    private _flyToEvent;
+    /**
+     * 获取飞入事件监听器
+     */
+    get flyToEvent(): Listener<[number | undefined]>;
+    /**
+     * 飞入到目标位置
+     * @param duration - 飞行动画时长（毫秒），可选。
+     */
+    flyTo(duration?: number): void;
+    private _resetClockEvent;
+    /**
+     * 获取重置时钟事件监听器
+     */
+    get resetClockEvent(): Event<[]>;
+    /**
+     * 重置时钟
+     */
+    resetClock(): void;
+    /**
+     * 构造函数
+     * @param id - 实例唯一标识符。
+     */
+    constructor(id?: string);
+    getESProperties(): {
+        defaultMenu: string;
+        basic: import('../..').Property[];
+        general: import('../..').Property[];
+        more: import('../..').Property[];
+        dataSource: import('../..').Property[];
+        location: import('../..').Property[];
+        coordinate: import('../..').Property[];
+        style: import('../..').Property[];
+    };
+}
+export interface ESKml extends UniteChanged<ReturnType<typeof ESKml.createDefaultProps>> {
+}

package/dist/types/ESObjects/general/ESLandSlide.d.ts

@@ -12,6 +12,7 @@ import { ESGeoVector } from '../base';
  * - 获取地形高度图
  * - 擦除编辑模拟流动效果
  * - 支持 Cesium 引擎渲染
+ * @remarks 滑坡
  */
 export declare class ESLandSlide extends ESGeoVector {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESLevelRuntimeModel.d.ts

@@ -20,6 +20,7 @@ import { ESObjectWithLocation } from '../base';
  * - url 属性必须指向有效的关卡包资源
  * - downloadProgress 属性为只读，用于监控下载进度
  * - 关卡加载距离会影响性能，建议根据实际需求合理设置
+ * @remarks 关卡运行时模型
  */
 export declare class ESLevelRuntimeModel extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESLocalCircle.d.ts

@@ -24,6 +24,7 @@ import { ESLocalVector2D } from '../base';
  * - 默认启用填充，禁用描边和碰撞检测
  * - 面积和周长会随着半径变化自动更新
  * - 支持双点编辑模式，适用于交互式编辑场景
+ * @remarks 局部圆形
  */
 export declare class ESLocalCircle extends ESLocalVector2D {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESLocalLineString.d.ts

@@ -0,0 +1,73 @@
+import { SceneObjectKey, UniteChanged } from '../../xbsj-base';
+import { ESLocalVector2D } from '../base';
+/**
+ * 局部2D坐标折线，用于在局部2D坐标系中创建和显示折线路径的可视化对象
+ * @remarks 局部二维折线
+ */
+export declare class ESLocalLineString extends ESLocalVector2D {
+    static readonly createDefaultProps: () => {
+        /** 折线顶点数组，每个元素为局部2D坐标 [x, y] */
+        points: import('../..').ReactiveVariable<[number, number][] | undefined>;
+        /** 是否首尾相连形成闭合环 */
+        loop: boolean;
+        /** 是否为虚线 */
+        hasDash: boolean;
+        /** 虚线间隔颜色，RGBA 数组 [r, g, b, a] */
+        gapColor: import('../..').ReactiveVariable<[number, number, number, number]>;
+        /** 虚线长度（像素） */
+        dashLength: number;
+        /** 虚线图案掩码，每位表示一个像素的开关状态 */
+        dashPattern: number;
+        /** 是否在终点显示箭头 */
+        hasArrow: boolean;
+        /** 是否开启深度检测 */
+        depthTest: boolean;
+        /** 是否绘制描边 */
+        stroked: boolean;
+        pointed: boolean;
+        pointStyle: import('../..').ReactiveVariable<import('../..').ESJPointStyle>;
+        strokeStyle: import('../..').ReactiveVariable<import('../..').ESJStrokeStyle>;
+        filled: boolean;
+        fillStyle: import('../..').ReactiveVariable<import('../..').ESJFillStyle>;
+        position: import('../..').ReactiveVariable<import('../..').ESJVector3D>;
+        rotation: import('../..').ReactiveVariable<import('../..').ESJVector3D>;
+        positionOffset: import('../..').ReactiveVariable<import('../..').ESJVector3D>;
+        scale: import('../..').ReactiveVariable<import('../..').ESJVector3D>;
+        minVisibleDistance: import('../..').ReactiveVariable<number>;
+        maxVisibleDistance: import('../..').ReactiveVariable<number>;
+        show: boolean;
+        collision: boolean;
+        allowPicking: boolean;
+        flyToParam: import('../..').ReactiveVariable<import('../..').ESJFlyToParam | undefined>;
+        flyInParam: import('../..').ReactiveVariable<import('../..').ESJFlyInParam | undefined>;
+        name: string;
+        ref: string | undefined;
+        extras: import('../..').ReactiveVariable<import('../..').JsonValue>;
+        devTags: import('../..').ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+    static readonly type: string;
+    /**
+     * 创建 ESLocalLineString 实例
+     * @param id 场景对象标识键，可选
+     */
+    constructor(id?: SceneObjectKey);
+    /**
+     * @override
+     * @returns 包含折线相关属性的 ESJTypes 属性数组
+     */
+    getESProperties(): {
+        more: import('../..').Property[];
+        style: import('../..').Property[];
+        defaultMenu: string;
+        location: import('../..').Property[];
+        general: import('../..').Property[];
+        basic: import('../..').Property[];
+        dataSource: import('../..').Property[];
+        coordinate: import('../..').Property[];
+    };
+}
+export interface ESLocalLineString extends UniteChanged<ReturnType<typeof ESLocalLineString.createDefaultProps>> {
+}

package/dist/types/ESObjects/general/ESLocalLineStringZ.d.ts

@@ -0,0 +1,79 @@
+import { SceneObjectKey, UniteChanged } from '../../xbsj-base';
+import { ESLocalVector } from '../base';
+/**
+ * 局部三维坐标折线
+ *
+ * 在局部坐标系中创建和显示带有高度信息的三维折线。
+ * 支持设置坐标点、颜色、虚线样式、箭头、深度检测等属性。
+ * @remarks 局部三维折线
+ */
+export declare class ESLocalLineStringZ extends ESLocalVector {
+    static readonly createDefaultProps: () => {
+        /** 三维坐标位置数组 */
+        points: import('../..').ReactiveVariable<[number, number, number][] | undefined>;
+        /** 是否首尾相连 */
+        loop: boolean;
+        /** 宽度（像素），默认为1.0 */
+        width: number | undefined;
+        /** 颜色，默认为 [1, 1, 1, 1] */
+        color: import('../..').ReactiveVariable<[number, number, number, number] | undefined>;
+        /** 是否为虚线 */
+        hasDash: boolean;
+        /** 虚线间隔颜色，默认为 [0, 0, 0, 0] */
+        gapColor: import('../..').ReactiveVariable<[number, number, number, number]>;
+        /** 虚线长度，默认为 16 */
+        dashLength: number;
+        /** 虚线图案，默认为 255 */
+        dashPattern: number;
+        /** 是否带箭头 */
+        hasArrow: boolean;
+        /** 是否开启深度检测 */
+        depthTest: boolean;
+        /** 是否描边 */
+        stroked: boolean;
+        pointed: boolean;
+        pointStyle: import('../..').ReactiveVariable<import('../..').ESJPointStyle>;
+        strokeStyle: import('../..').ReactiveVariable<import('../..').ESJStrokeStyle>;
+        filled: boolean;
+        fillStyle: import('../..').ReactiveVariable<import('../..').ESJFillStyle>;
+        position: import('../..').ReactiveVariable<import('../..').ESJVector3D>;
+        rotation: import('../..').ReactiveVariable<import('../..').ESJVector3D>;
+        positionOffset: import('../..').ReactiveVariable<import('../..').ESJVector3D>;
+        scale: import('../..').ReactiveVariable<import('../..').ESJVector3D>;
+        minVisibleDistance: import('../..').ReactiveVariable<number>;
+        maxVisibleDistance: import('../..').ReactiveVariable<number>;
+        show: boolean;
+        collision: boolean;
+        allowPicking: boolean;
+        flyToParam: import('../..').ReactiveVariable<import('../..').ESJFlyToParam | undefined>;
+        flyInParam: import('../..').ReactiveVariable<import('../..').ESJFlyInParam | undefined>;
+        name: string;
+        ref: string | undefined;
+        extras: import('../..').ReactiveVariable<import('../..').JsonValue>;
+        devTags: import('../..').ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+    static readonly type: string;
+    /**
+     * @param id - 场景对象键，可选
+     */
+    constructor(id?: SceneObjectKey);
+    /**
+     * @override
+     * @returns 包含更多属性配置的对象
+     */
+    getESProperties(): {
+        more: import('../..').Property[];
+        style: import('../..').Property[];
+        defaultMenu: string;
+        location: import('../..').Property[];
+        general: import('../..').Property[];
+        basic: import('../..').Property[];
+        dataSource: import('../..').Property[];
+        coordinate: import('../..').Property[];
+    };
+}
+export interface ESLocalLineStringZ extends UniteChanged<ReturnType<typeof ESLocalLineStringZ.createDefaultProps>> {
+}

package/dist/types/ESObjects/general/ESLocalPolygon.d.ts

@@ -25,6 +25,7 @@ import { ESLocalVector2D } from '../base';
  * - 坐标点数组为2D坐标，不包含高度信息
  * - 坐标单位为米，相对于局部坐标系原点的偏移量
  * - 需要至少3个点才能形成有效的多边形
+ * @remarks 局部多边形
  */
 export declare class ESLocalPolygon extends ESLocalVector2D {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESLocalPolygonZ.d.ts

@@ -21,6 +21,7 @@ import { UniteChanged } from '../../xbsj-base';
  * - 该类适用于 Cesium 和 UE（Unreal Engine）实现
  * - 多边形默认启用填充（filled = true）
  * - 需要设置 points 属性来定义多边形的顶点坐标
+ * @remarks 局部三维多边形
  */
 export declare class ESLocalPolygonZ extends ESLocalVector {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESLocalRectangle.d.ts

@@ -22,6 +22,7 @@ import { ESLocalVector2D } from '../base';
  * - 默认宽度为 500000 单位，默认高度为 300000 单位
  * - 矩形的位置基于继承自父类的局部坐标系属性
  * - 适用于 Cesium 和 UE 引擎的实现
+ * @remarks 局部矩形
  */
 export declare class ESLocalRectangle extends ESLocalVector2D {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESLocalSkyBox.d.ts

@@ -59,6 +59,7 @@ export type ESLocalSkyBoxUrlType = {
  * - 自动跟随模式下会在约5000米距离时产生渐变消失效果
  * - 天空盒尺寸影响渲染范围和透明度计算
  * - 支持Cesium和UE引擎实现
+ * @remarks 局部天空盒
  */
 export declare class ESLocalSkyBox extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESLocationMeasurement.d.ts

@@ -22,6 +22,8 @@ import { ESObjectWithLocation } from '../base';
  * - 位置信息会自动与对象的 position 属性保持同步
  * - 该类使用响应式变量管理位置数据，确保数据变化的实时性
  * - 适用于 Cesium 和 UE 引擎实现
+ *
+ * @remarks 位置测量
  */
 export declare class ESLocationMeasurement extends ESObjectWithLocation {
     /**

package/dist/types/ESObjects/general/ESMVTLayer.d.ts

@@ -2,6 +2,10 @@ import { ESJPickedResult, ESJVector4D } from '../../ESJTypes';
 import { UniteChanged, Event } from '../../xbsj-base';
 import { ESVisualObject } from '../base';
 import { ESJSplitDirectionType } from './ESImageryLayer/types';
+/**
+ * 矢量瓦片图层
+ * @remarks 矢量瓦片图层
+ */
 export declare class ESMVTLayer extends ESVisualObject {
     static readonly createDefaultProps: () => {
         rectangle: import('../..').ReactiveVariable<ESJVector4D | undefined>;

package/dist/types/ESObjects/general/ESNavigator.d.ts

@@ -24,6 +24,8 @@ import { ESSceneObject } from '../base';
  * - 该控件依赖于ESSceneObject基类
  * - 支持Cesium和UE引擎实现
  * - 图片地址需要确保可访问性
+ *
+ * @remarks 导航控件
  */
 export declare class ESNavigator extends ESSceneObject {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESParticleSystemPrimitive.d.ts

@@ -25,6 +25,7 @@ import { ESObjectWithLocation } from '../base';
  * - 图像资源路径需要确保可访问，默认使用烟雾纹理
  * - 播放器的时间控制会影响粒子的生成和更新频率
  * - 某些属性（如发射器类型）的修改可能需要重新初始化粒子系统
+ * @remarks 粒子系统图元
  */
 export declare class ESParticleSystemPrimitive extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPath/ESPathImpl/PolylineResetting.d.ts

@@ -1,5 +1,9 @@
 import { ESPathImpl } from '.';
 import { Destroyable } from '../../../../xbsj-base';
+/**
+ * 折线重置类，用于管理 ESPathImpl 的折线位置更新。
+ * 当 show 为 false 时不会对 positions 赋值，这会导致 flyTo 不起作用。
+ */
 export declare class PolylineResetting extends Destroyable {
     constructor(geoPath: ESPathImpl);
 }

package/dist/types/ESObjects/general/ESPipeFence.d.ts

@@ -22,6 +22,8 @@ import { ESGeoVector } from '../base';
  * - 需要至少2个点才能计算距离
  * - 部分旧版本的属性（如某些materialMode值）已被弃用，使用时会触发警告
  * - 该类支持 Cesium 和 UE 平台的实现
+ *
+ * @remarks 管道围栏
  */
 export declare class ESPipeFence extends ESGeoVector {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPipeline.d.ts

@@ -22,6 +22,8 @@ import { ESGeoLineString } from './ESGeoLineString';
  * - 部分属性已被标记为弃用（如旧版本的 materialMode 值和 show 属性）
  * - 管线需要至少两个坐标点才能正确显示
  * - 材质图片配置需要提供有效的图片资源URL
+ *
+ * @remarks 管线
  */
 export declare class ESPipeline extends ESGeoLineString {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPipeserTileset.d.ts

@@ -20,6 +20,7 @@ import { ES3DTileset } from './ES3DTileset';
  * - 该类专门用于 PipeSer 管线数据，不适用于其他类型的 3D 数据
  * - layerJson 参数可以是 JSON 字符串或对象数组格式
  * - 颜色模式的切换会影响整个图层的渲染效果
+ * @remarks 管线瓦片集
  */
 export declare class ESPipeserTileset extends ES3DTileset {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPit.d.ts

@@ -34,6 +34,7 @@ export type ESJTexture = {
  * - 该对象默认关闭碰撞检测和拾取功能，适用于视觉展示场景
  * - 坑的深度和插值距离会影响渲染性能，建议根据实际需求合理设置
  * - 纹理图片路径依赖于环境变量配置，请确保资源路径正确
+ * @remarks 坑（Pit）是一种特殊的多边形挖洞效果，通过深度、侧面/底面纹理等参数控制外观。深度为正表示向下凹陷，插值距离控制坑壁与地表之间过渡的平滑范围。默认关闭碰撞检测和拾取，适用于视觉展示而非交互操作。
  */
 export declare class ESPit extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPoi2D.d.ts

@@ -25,6 +25,7 @@ import { ESLabel } from '../base';
  * - getInitialStyle() 方法有 2 秒超时限制
  * - 某些模式可能在不同平台上有不同的渲染效果
  * - 文本框的显示模式会影响用户交互体验
+ * @remarks 二维POI
  */
 export declare class ESPoi2D extends ESLabel {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPoi3D.d.ts

@@ -21,6 +21,7 @@ import { ESObjectWithLocation } from '../base';
  * - 模式只支持 'triangle' 和 'diamond' 两种值
  * - 样式颜色值为RGBA格式的数组，取值范围0-1
  * - 该类已注册到 earthsdk 系统中，支持 Cesium 和 UE 实现
+ * @remarks 三维POI
  */
 export declare class ESPoi3D extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPoiTileset.d.ts

@@ -42,6 +42,7 @@ export type ESPoiType = {
  * - poiTypes属性是一个复杂对象数组，每个元素包含type、povit、widget、worldScale、hiddenDistance等字段
  * - 该类依赖于UE（Unreal Engine）实现，使用时需确保运行环境支持
  * - POI的显示效果受hiddenDistance参数影响，距离过远时POI会被隐藏以优化性能
+ * @remarks POI瓦片集
  */
 export declare class ESPoiTileset extends ESVisualObject {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPolygonFence.d.ts

@@ -24,6 +24,7 @@ import { ESGeoVector } from '../base';
  * - 该类默认启用填充模式和禁用碰撞检测
  * - 支持Cesium和UE引擎实现
  * - 编辑模式采用圆形绑定方式
+ * @remarks 多边形围栏
  */
 export declare class ESPolygonFence extends ESGeoVector {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPolygonFlattenedPlane.d.ts

@@ -20,6 +20,8 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  * - 该类默认将多边形设置为不填充状态（filled = false）
  * - 需要配合有效的瓦片图层ID才能实现压平效果
  * - 仅在支持 Cesium 和 UE 的实现环境中可用
+ *
+ * @remarks 多边形压平
  */
 export declare class ESPolygonFlattenedPlane extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPolygonWithHole.d.ts

@@ -24,6 +24,7 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  * - 坐标数据需要符合地理坐标系统的格式要求
  *
  * @extends ESGeoPolygon
+ * @remarks 带孔多边形
  */
 export declare class ESPolygonWithHole extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESPolygonsFlattenedPlane.d.ts

@@ -16,6 +16,8 @@ import { ESVisualObject } from '../base';
  * - 默认不填充多边形（filled = false）
  * - 需要配合有效的瓦片图层ID才能实现压平效果
  * - 仅在支持 Cesium 的实现环境中可用
+ *
+ * @remarks 多压平
  */
 export declare class ESPolygonsFlattenedPlane extends ESVisualObject {
     static readonly createDefaultProps: () => {