earthsdk3 3.0.8-beta.4 → 3.0.8-beta.6

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

@@ -1,25 +1,64 @@
-import { ESJColor } from "../../ESJTypes";
 import { UniteChanged } from "xbsj-base";
+import { ESJColor } from "../../ESJTypes";
 import { ESGeoPolygon } from "./ESGeoPolygon";
 /**
- * https://www.wolai.com/earthsdk/jRv9H5BbPGUaJ8MwxPf5oF
+ * ESGeoWater 类用于表示和渲染地理水面，继承自 ESGeoPolygon 类。
+ * 该类提供了水面渲染所需的一系列属性和方法，包括水的颜色、波动频率、振幅、镜面反射强度、流动方向和速度等。
+ * 用户可以通过设置这些属性来控制水面的外观和行为。
+ *
+ * 核心功能或关键方法包括：
+ * - 设置和获取水面属性，如颜色、频率、振幅等。
+ * - 注册类类型并获取类型名称。
+ * - 获取默认属性配置。
+ * - 获取 ES 属性配置和属性 UI 配置。
+ *
+ * 使用示例：
+ *
+ * 构造函数参数：
+ * - id: 实例的可选ID，用于唯一标识该实例。
+ *
+ * 特殊使用限制或潜在的副作用：
+ * - 在设置水域类型为 'custom' 时，其他控制效果的参数才会生效，否则使用预定效果。
+ * - 水体浑浊度的取值范围是 0 - 10，超出该范围可能会导致渲染异常。
  */
 export declare class ESGeoWater extends ESGeoPolygon {
+    /**
+     * 注册类类型，指定类名为'ESGeoWater'，并提供中文名称、标签和描述。
+     */
     static readonly type: string;
+    /**
+     * 获取类的类型名称。
+     * @returns 类的类型名称 'ESGeoWater'。
+     */
     get typeName(): string;
+    /**
+     * 获取默认属性。
+     * @returns 默认属性对象。
+     */
     get defaultProps(): {
+        /**是否允许拾取 默认为true */
         allowPicking: boolean;
+        /**水的图片*/
         waterImage: import("xbsj-base").ReactiveVariable<{
             [xx: string]: any;
         } | undefined>;
+        /**水体颜色 */
         waterColor: ESJColor;
+        /**频率, 控制波数的数值(次/千米) */
         frequency: number;
+        /**波动频率, 控制水波纹扰动的速率 */
         waveVelocity: number;
+        /**振幅, 控制水波振幅的数值 */
         amplitude: number;
+        /**镜面反射强度, 控制镜面反射强度的数值 */
         specularIntensity: number;
-        waterType: "river" | "ocean" | "lake" | "custom";
+        /**水域类型 [["river", "river"], ["ocean", "ocean"], ["lake", "lake"], ["custom", "custom"]] 当为 custom 时其他控制效果的参数生效，否则不生效，使用对应水域类型的预定效果 */
+        waterType: string;
+        /**流向, 控制水流方向，局部坐标方向 */
         flowDirection: number;
+        /**水流速度, 控制水流速度，单位 米/秒 */
         flowSpeed: number;
+        /**水体浑浊度, 控制水体的浑浊程度，数值越大，浑浊程度越大，取值范围 0 - 10。 */
         murkiness: number;
         pointed: boolean;
         pointStyle: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJPointStyle>;
@@ -41,7 +80,7 @@ export declare class ESGeoWater extends ESGeoPolygon {
         toDestroyFuncStr: string | undefined;
     };
     /**
-     *  默认属性
+     * 默认属性说明：
      * baseWaterColor: [0.1497, 0.165, 0.0031, 1] 水的底色
      * frequency: 1000 频率：控制波数的数值,单位 次/千米
      * waveVelocity: 0.5 波动速率：控制水波纹扰动的速率
@@ -50,7 +89,7 @@ export declare class ESGeoWater extends ESGeoPolygon {
      * waterType:river 水域类型，当为custom是其他控制效果的参数生效，否则不生效，使用对应水域类型的预定效果
      * flowDirection: 0 流动方向：控制水流方向，局部坐标方向
      * flowSpeed: 0 流动速度：控制水流速度，单位 米/秒
-     * murkiness: 5 水体浑浊度，控制水体的浑浊程度，数值越大，浑浊程度越大，取值范围0-10。
+     * murkiness: 5 水体浑浊度，控制水体的浑浊程度，数值越大，浑浊程度越大，取值范围0 - 10。
      */
     static defaults: {
         waterColor: ESJColor;
@@ -77,7 +116,15 @@ export declare class ESGeoWater extends ESGeoPolygon {
         flyToParam: import("../../ESJTypes").ESJFlyToParam;
         flyInParam: import("../../ESJTypes").ESJFlyInParam;
     };
+    /**
+     * 构造函数，创建ESGeoWater实例。
+     * @param id 实例的可选ID。
+     */
     constructor(id?: string);
+    /**
+     * 获取ES属性配置。
+     * @returns ES属性配置对象。
+     */
     getESProperties(): {
         defaultMenu: string;
         basic: import("../../ESJTypes").Property[];
@@ -87,22 +134,42 @@ export declare class ESGeoWater extends ESGeoPolygon {
         dataSource: import("../../ESJTypes").Property[];
         location: import("../../ESJTypes").Property[];
     };
+    /**
+     * 获取属性配置。
+     * @param language 语言类型。
+     * @returns 属性配置数组。
+     */
     getProperties(language: string): import("../../ESJTypes").Property[];
 }
 export declare namespace ESGeoWater {
+    /**
+     * 创建默认属性对象。
+     * @returns 默认属性对象。
+     */
     const createDefaultProps: () => {
+        /**是否允许拾取 默认为true */
         allowPicking: boolean;
+        /**水的图片*/
         waterImage: import("xbsj-base").ReactiveVariable<{
             [xx: string]: any;
         } | undefined>;
+        /**水体颜色 */
         waterColor: ESJColor;
+        /**频率, 控制波数的数值(次/千米) */
         frequency: number;
+        /**波动频率, 控制水波纹扰动的速率 */
         waveVelocity: number;
+        /**振幅, 控制水波振幅的数值 */
         amplitude: number;
+        /**镜面反射强度, 控制镜面反射强度的数值 */
         specularIntensity: number;
-        waterType: "river" | "ocean" | "lake" | "custom";
+        /**水域类型 [["river", "river"], ["ocean", "ocean"], ["lake", "lake"], ["custom", "custom"]] 当为 custom 时其他控制效果的参数生效，否则不生效，使用对应水域类型的预定效果 */
+        waterType: string;
+        /**流向, 控制水流方向，局部坐标方向 */
         flowDirection: number;
+        /**水流速度, 控制水流速度，单位 米/秒 */
         flowSpeed: number;
+        /**水体浑浊度, 控制水体的浑浊程度，数值越大，浑浊程度越大，取值范围 0 - 10。 */
         murkiness: number;
         pointed: boolean;
         pointStyle: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJPointStyle>;
@@ -124,6 +191,9 @@ export declare namespace ESGeoWater {
         toDestroyFuncStr: string | undefined;
     };
 }
+/**
+ * ESGeoWater接口，继承自UniteChanged，返回创建默认属性函数的返回类型。
+ */
 export interface ESGeoWater extends UniteChanged<ReturnType<typeof ESGeoWater.createDefaultProps>> {
 }
 //# sourceMappingURL=ESGeoWater.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ESGeoWater.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESGeoWater.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,QAAQ,EAAqE,MAAM,gBAAgB,CAAC;AAC1I,OAAO,EAA4C,YAAY,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;GAEG;AACH,qBAAa,UAAW,SAAQ,YAAY;IACxC,gBAAyB,IAAI,SAAwI;IACrK,IAAa,QAAQ,WAA2B;IAChD,IAAa,YAAY;;;;;oBA+EuB,QAAQ;;;;;mBAK9B,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ;;;;;;;;;;;;;;;;;;;;;;MApFQ;IACvE;;;;;;;;;;;OAWG;IACH,OAAgB,QAAQ;oBAEwB,QAAQ;;;;;oBAK4C,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;mBACzG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ;;;;;;;;;;;;;;;;;MAK9D;gBAEW,EAAE,CAAC,EAAE,MAAM;IAId,eAAe;;;;;;;;;IAqBf,aAAa,CAAC,QAAQ,EAAE,MAAM;CAkB1C;AAED,yBAAiB,UAAU,CAAC;IACjB,MAAM,kBAAkB;;;;;oBAKiB,QAAQ;;;;;mBAK9B,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ;;;;;;;;;;;;;;;;;;;;;;KAI7D,CAAC;CACN;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC;CAAI"}
+{"version":3,"file":"ESGeoWater.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESGeoWater.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4C,YAAY,EAAE,MAAM,WAAW,CAAC;AACnF,OAAO,EAA+B,QAAQ,EAAqE,MAAM,gBAAgB,CAAC;AAC1I,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,UAAW,SAAQ,YAAY;IACxC;;OAEG;IACH,gBAAyB,IAAI,SAAwI;IAErK;;;OAGG;IACH,IAAa,QAAQ,WAA2B;IAEhD;;;OAGG;IACH,IAAa,YAAY;QA8FrB,oBAAoB;;QAEpB,SAAS;;;;QAET,UAAU;oBACgC,QAAQ;QAClD,uBAAuB;;QAEvB,sBAAsB;;QAEtB,mBAAmB;;QAEnB,yBAAyB;;QAEzB,sIAAsI;;QAEtI,uBAAuB;;QAEvB,yBAAyB;;QAEzB,+CAA+C;;;;;;;;;;;;;;;;;;;;MAlHoB;IAEvE;;;;;;;;;;;OAWG;IACH,OAAgB,QAAQ;oBAEwB,QAAQ;;;;;oBAK4C,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE;mBACzG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ;;;;;;;;;;;;;;;;;MAK9D;IAED;;;OAGG;gBACS,EAAE,CAAC,EAAE,MAAM;IAIvB;;;OAGG;IACM,eAAe;;;;;;;;;IAqBxB;;;;OAIG;IACM,aAAa,CAAC,QAAQ,EAAE,MAAM;CAkB1C;AAED,yBAAiB,UAAU,CAAC;IACxB;;;OAGG;IACI,MAAM,kBAAkB;QAE3B,oBAAoB;;QAEpB,SAAS;;;;QAET,UAAU;oBACgC,QAAQ;QAClD,uBAAuB;;QAEvB,sBAAsB;;QAEtB,mBAAmB;;QAEnB,yBAAyB;;QAEzB,sIAAsI;;QAEtI,uBAAuB;;QAEvB,yBAAyB;;QAEzB,+CAA+C;;;;;;;;;;;;;;;;;;;;KAEjD,CAAC;CACN;AAOD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,UAAU,CAAC,kBAAkB,CAAC,CAAC;CAAI"}

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

@@ -1,37 +1,145 @@
-import { Event, SceneObjectKey, ReactivePropsToNativePropsAndChanged } from "xbsj-base";
-import { ESObjectWithLocation } from "../base";
-import { ESJColor, ESJEnvironmentMapManagerType, ESJMaterialType, ESJResource, ESJVector2D, ESJVector3D } from "../../ESJTypes";
 import { ESJInstances } from "../../ESJTypes/properties/ESJInstances";
+import { Event, ReactivePropsToNativePropsAndChanged, SceneObjectKey } from "xbsj-base";
+import { ESJColor, ESJEnvironmentMapManagerType, ESJMaterialType, ESJResource, ESJVector2D, ESJVector3D } from "../../ESJTypes";
+import { ESObjectWithLocation } from "../base";
+/**
+ * 模型节点变换的类型定义
+ */
 type ModelNodeTransformation = {
+    /**
+     * 节点在X轴上的平移量
+     */
     translationX: number;
+    /**
+     * 节点在Y轴上的平移量
+     */
     translationY: number;
+    /**
+     * 节点在Z轴上的平移量
+     */
     translationZ: number;
+    /**
+     * 节点绕Z轴的旋转角度（航向角）
+     */
     rotationHeading: number;
+    /**
+     * 节点绕X轴的旋转角度（俯仰角）
+     */
     rotationPitch: number;
+    /**
+     * 节点绕Y轴的旋转角度（横滚角）
+     */
     rotationRoll: number;
+    /**
+     * 节点在X轴上的缩放比例
+     */
     scaleX: number;
+    /**
+     * 节点在Y轴上的缩放比例
+     */
     scaleY: number;
+    /**
+     * 节点在Z轴上的缩放比例
+     */
     scaleZ: number;
 };
 /**
- * https://www.wolai.com/earthsdk/sJisEK7X7WgurSVJK6kXTe
+ * ESGltfModel 类用于表示和操作 glTF 模型。它继承自 ESObjectWithLocation 类，提供了对模型节点变换、材质设置、事件处理等功能的支持。
+ *
+ * 核心功能包括：
+ * - 管理模型节点的位置、旋转和缩放变换。
+ * - 处理 Cesium 模型准备就绪事件。
+ * - 设置和获取模型的材质信息。
+ * - 触发和监听自定义事件，如节点位置、旋转、缩放变化等。
+ * - 提供默认属性和属性列表的获取方法。
+ *
+ * 使用示例：
+ *
+ * 构造函数参数：
+ * - `id`：场景对象的 ID，类型为 `SceneObjectKey`，可选。
+ *
+ * 特殊使用限制或潜在的副作用：
+ * - 在设置节点变换信息时，需要确保传入的向量元素都是有限数值，否则会触发错误日志。
+ * - 设置材质时，需要通过 `setMaterial` 方法，该方法返回一个 Promise，需要在 Promise 解析后获取最终的材质信息。
+ * - 仅 Cesium 引擎生效的设置，如 `setLight122` 方法，用于设置默认光照。
  */
 export declare class ESGltfModel extends ESObjectWithLocation {
+    /**
+     * 注册类类型，指定名称、类本身以及相关信息
+     */
     static readonly type: string;
+    /**
+     * 获取类的类型名称
+     */
     get typeName(): string;
+    /**
+     * 获取默认属性
+     */
     get defaultProps(): {
+        /**
+         * 模型资源路径（GLB/GLTF 文件地址）
+         * @type {string | ESJResource}
+         * @default ${earthsdk3-assets-script-dir}/assets/glb/building.glb
+         */
         url: string | ESJResource;
+        /**
+         * 模型最大缩放比例（Cesium 引擎专用）
+         * @type {number | undefined}
+         *  限制模型缩放的最大值，未设置时无上限
+         */
         czmMaximumScale: number | undefined;
+        /**
+         * 模型最小像素尺寸（Cesium 引擎专用）
+         * @type {number}
+         * @default 0
+         *  值为 0 时表示不启用最小像素尺寸限制
+         */
         czmMinimumPixelSize: number;
+        /**
+         * 模型统一缩放值（全局缩放因子）
+         * @type {number}
+         * @default 1
+         *  同时应用于 X/Y/Z 轴的缩放比例
+         */
         czmNativeScale: number;
+        /**
+         * 模型颜色（RGBA 通道值）
+         * @type {ESJColor[]}
+         * @default [1, 1, 1, 1]
+         *  数组顺序为 [红, 绿, 蓝, 透明度]，取值范围 0-1
+         */
         czmColor: import("xbsj-base").ReactiveVariable<ESJColor>;
+        /**
+         * 是否允许模型被鼠标拾取（交互选中）
+         * @type {boolean}
+         * @default true
+         */
         allowPicking: boolean;
+        /**
+         * 实例化矩阵数组（用于批量渲染相同模型）
+         * @type {ESJInstances[] | undefined}
+         *  每个元素包含模型实例的位置、旋转、缩放矩阵信息，未设置时不启用实例化
+         */
         instances: import("xbsj-base").ReactiveVariable<ESJInstances | undefined>;
+        /**
+         * 环境光反射强度因子（Cesium 引擎专用）
+         * @type {ESJVector2D[]}
+         * @default [1, 1]
+         *  二维向量分别控制 X 轴和 Y 轴方向的反射强度
+         */
         czmImageBasedLightingFactor: import("xbsj-base").ReactiveVariable<ESJVector2D>;
         /**
-         * @deprecated 已弃用，请使用czmEnvironmentMapManager代替
+         * 大气散射强度（已弃用，Cesium 引擎专用）
+         * @type {number}
+         * @default 2
+         * @deprecated 请使用 `czmEnvironmentMapManager` 配置环境光照
          */
         czmAtmosphereScatteringIntensity: number;
+        /**
+         * 动态环境贴图管理器配置（Cesium 引擎专用）
+         * @type {ESJEnvironmentMapManagerType | undefined}
+         *  用于配置模型的环境光照、反射探头等高级参数，未设置时使用引擎默认值
+         */
         czmEnvironmentMapManager: import("xbsj-base").ReactiveVariable<ESJEnvironmentMapManagerType | undefined>;
         position: import("xbsj-base").ReactiveVariable<ESJVector3D>;
         rotation: import("xbsj-base").ReactiveVariable<ESJVector3D>;
@@ -50,52 +158,149 @@ export declare class ESGltfModel extends ESObjectWithLocation {
         updateFuncStr: string | undefined;
         toDestroyFuncStr: string | undefined;
     };
+    /**
+     * 私有属性，用于存储节点变换信息
+     */
     private _nodeTransformations;
+    /**
+     * 获取节点变换信息
+     */
     get nodeTransformations(): {
         [key: string]: ModelNodeTransformation;
     } | undefined;
+    /**
+     * 设置节点变换信息
+     * @param value 节点变换信息对象
+     */
     set nodeTransformations(value: {
         [key: string]: ModelNodeTransformation;
     } | undefined);
+    /**
+     * 获取节点变换信息的变更事件
+     */
     get nodeTransformationsChanged(): import("xbsj-base").Listener<[{
         [key: string]: ModelNodeTransformation;
     } | undefined, {
         [key: string]: ModelNodeTransformation;
     } | undefined]>;
+    /**
+     * Cesium模型准备就绪事件
+     */
     private _czmModelReadyEvent;
+    /**
+     * 获取Cesium模型准备就绪事件
+     */
     get czmModelReadyEvent(): Event<[model: any]>;
+    /**
+     * 删除指定节点的变换信息
+     * @param nodeName 节点名称
+     */
     deleteNodeTransformation(nodeName: string): void;
+    /**
+     * 设置节点位置的事件
+     */
     private _setNodePositionEvent;
+    /**
+     * 获取设置节点位置的事件
+     */
     get setNodePositionEvent(): Event<[string, ESJVector3D]>;
+    /**
+     * 设置指定节点的位置
+     * @param nodeName 节点名称
+     * @param nodePosition 节点位置向量
+     */
     setNodePosition(nodeName: string, nodePosition: ESJVector3D): void;
+    /**
+     * 设置节点旋转的事件
+     */
     private _setNodeRotationEvent;
+    /**
+     * 获取设置节点旋转的事件
+     */
     get setNodeRotationEvent(): Event<[string, ESJVector3D]>;
+    /**
+     * 设置指定节点的旋转
+     * @param nodeName 节点名称
+     * @param nodeRotation 节点旋转向量
+     */
     setNodeRotation(nodeName: string, nodeRotation: ESJVector3D): void;
+    /**
+     * 设置节点缩放的事件
+     */
     private _setNodeScaleEvent;
+    /**
+     * 获取设置节点缩放的事件
+     */
     get setNodeScaleEvent(): Event<[string, ESJVector3D]>;
+    /**
+     * 设置指定节点的缩放
+     * @param nodeName 节点名称
+     * @param nodeScale 节点缩放向量
+     */
     setNodeScale(nodeName: string, nodeScale: ESJVector3D): void;
+    /**
+     * 获取指定节点的位置
+     * @param nodeName 节点名称
+     * @returns 节点位置向量，如果不存在则返回undefined
+     */
     getNodePosition(nodeName: string): ESJVector3D | undefined;
+    /**
+     * 获取指定节点的旋转
+     * @param nodeName 节点名称
+     * @returns 节点旋转向量，如果不存在则返回undefined
+     */
     getNodeRotation(nodeName: string): ESJVector3D | undefined;
+    /**
+     * 获取指定节点的缩放
+     * @param nodeName 节点名称
+     * @returns 节点缩放向量，如果不存在则返回undefined
+     */
     getNodeScale(nodeName: string): ESJVector3D | undefined;
+    /**
+     * 打印调试信息的事件
+     */
     private _printDebugInfoEvent;
+    /**
+     * 获取打印调试信息的事件
+     */
     get printDebugInfoEvent(): Event<[]>;
+    /**
+     * 触发打印调试信息的事件
+     */
     printDebugInfo(): void;
+    /**
+     * 设置材质信息的事件
+     */
     setMaterialInfoEvent: Event<[{
         [xx: string]: any;
     }]>;
+    /**
+     * 设置材质的事件
+     */
     private _setMaterialEvent;
+    /**
+     * 获取设置材质的事件
+     */
     get setMaterialEvent(): Event<["default" | {
         [xx: string]: ESJMaterialType;
     }]>;
+    /**
+     * 设置模型的材质
+     * @param options 材质选项，可以是材质对象或 'default'
+     * @returns 一个Promise，当材质设置完成后解析为材质信息对象
+     */
     setMaterial(options: {
         [xx: string]: ESJMaterialType;
     } | 'default'): Promise<{
         [xx: string]: any;
     }>;
     /**
-     * 仅Cesium引擎生效
+     * 仅Cesium引擎生效，设置默认光照
      */
     setLight122(): void;
+    /**
+     * 类的默认属性
+     */
     static defaults: {
         url: string;
         instances: never[];
@@ -105,7 +310,15 @@ export declare class ESGltfModel extends ESObjectWithLocation {
         flyToParam: import("../../ESJTypes").ESJFlyToParam;
         flyInParam: import("../../ESJTypes").ESJFlyInParam;
     };
+    /**
+     * 构造函数
+     * @param id 场景对象的ID
+     */
     constructor(id?: SceneObjectKey);
+    /**
+     * 获取ES属性
+     * @returns ES属性对象
+     */
     getESProperties(): {
         defaultMenu: string;
         dataSource: import("../../ESJTypes").Property[];
@@ -115,22 +328,83 @@ export declare class ESGltfModel extends ESObjectWithLocation {
         coordinate: import("../../ESJTypes").Property[];
         style: import("../../ESJTypes").Property[];
     };
+    /**
+     * 获取属性列表
+     * @param language 语言
+     * @returns 属性列表
+     */
     getProperties(language?: string): import("../../ESJTypes").Property[];
 }
 export declare namespace ESGltfModel {
+    /**
+     * 创建默认属性对象
+     * @returns 默认属性对象
+     */
     const createDefaultProps: () => {
+        /**
+         * 模型资源路径（GLB/GLTF 文件地址）
+         * @type {string | ESJResource}
+         * @default ${earthsdk3-assets-script-dir}/assets/glb/building.glb
+         */
         url: string | ESJResource;
+        /**
+         * 模型最大缩放比例（Cesium 引擎专用）
+         * @type {number | undefined}
+         *  限制模型缩放的最大值，未设置时无上限
+         */
         czmMaximumScale: number | undefined;
+        /**
+         * 模型最小像素尺寸（Cesium 引擎专用）
+         * @type {number}
+         * @default 0
+         *  值为 0 时表示不启用最小像素尺寸限制
+         */
         czmMinimumPixelSize: number;
+        /**
+         * 模型统一缩放值（全局缩放因子）
+         * @type {number}
+         * @default 1
+         *  同时应用于 X/Y/Z 轴的缩放比例
+         */
         czmNativeScale: number;
+        /**
+         * 模型颜色（RGBA 通道值）
+         * @type {ESJColor[]}
+         * @default [1, 1, 1, 1]
+         *  数组顺序为 [红, 绿, 蓝, 透明度]，取值范围 0-1
+         */
         czmColor: import("xbsj-base").ReactiveVariable<ESJColor>;
+        /**
+         * 是否允许模型被鼠标拾取（交互选中）
+         * @type {boolean}
+         * @default true
+         */
         allowPicking: boolean;
+        /**
+         * 实例化矩阵数组（用于批量渲染相同模型）
+         * @type {ESJInstances[] | undefined}
+         *  每个元素包含模型实例的位置、旋转、缩放矩阵信息，未设置时不启用实例化
+         */
         instances: import("xbsj-base").ReactiveVariable<ESJInstances | undefined>;
+        /**
+         * 环境光反射强度因子（Cesium 引擎专用）
+         * @type {ESJVector2D[]}
+         * @default [1, 1]
+         *  二维向量分别控制 X 轴和 Y 轴方向的反射强度
+         */
         czmImageBasedLightingFactor: import("xbsj-base").ReactiveVariable<ESJVector2D>;
         /**
-         * @deprecated 已弃用，请使用czmEnvironmentMapManager代替
+         * 大气散射强度（已弃用，Cesium 引擎专用）
+         * @type {number}
+         * @default 2
+         * @deprecated 请使用 `czmEnvironmentMapManager` 配置环境光照
          */
         czmAtmosphereScatteringIntensity: number;
+        /**
+         * 动态环境贴图管理器配置（Cesium 引擎专用）
+         * @type {ESJEnvironmentMapManagerType | undefined}
+         *  用于配置模型的环境光照、反射探头等高级参数，未设置时使用引擎默认值
+         */
         czmEnvironmentMapManager: import("xbsj-base").ReactiveVariable<ESJEnvironmentMapManagerType | undefined>;
         position: import("xbsj-base").ReactiveVariable<ESJVector3D>;
         rotation: import("xbsj-base").ReactiveVariable<ESJVector3D>;
@@ -150,6 +424,9 @@ export declare namespace ESGltfModel {
         toDestroyFuncStr: string | undefined;
     };
 }
+/**
+ * ESGltfModel类的扩展接口
+ */
 export interface ESGltfModel extends ReactivePropsToNativePropsAndChanged<ReturnType<typeof ESGltfModel.createDefaultProps>> {
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"ESGltfModel.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESGltfModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ESGltfModel.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESGltfModel.ts"],"names":[],"mappings":"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"}