earthsdk3 3.11.0 → 3.11.1

package/dist/types/ESObjects/general/ESCustomPrimitive/readme/index.d.ts

@@ -0,0 +1,6 @@
+export * from './renderState';
+export * from './boundingVolume';
+export * from './shaderSource';
+export * from './uniformMap';
+export * from './attributes';
+export * from './indexTypeArray';

package/dist/types/ESObjects/general/ESCustomPrimitive/readme/indexTypeArray.d.ts

@@ -0,0 +1 @@
+export declare const indexTypeArrayReadMe = "### \u9ED8\u8BA4\u7684\u7D22\u5F15\u6570\u7EC4\n```\n{\n    \"type\": \"Uint16Array\",\n    \"array\": [0, 1, 2, 3, 4, 5]\n}\n```\n\n### \u7D22\u5F15\u7C7B\u578B\u89C4\u683C\u8BF4\u660E\n```\nexport type IndexJsonType = {\n    type: 'Uint8Array' | 'Uint16Array' | 'Uint32Array';\n    array: number[];\n}\n```\n";

package/dist/types/ESObjects/general/ESCustomPrimitive/readme/renderState.d.ts

@@ -0,0 +1 @@
+export declare const renderStateReadMe = "### \u9ED8\u8BA4\u4F7F\u7528\u7684\u6E32\u67D3\u72B6\u6001\n```\n{\n    depthTest: {\n        enabled: true,\n    },\n    cull: {\n        enabled: true,\n        face: 1029,\n    },\n    blending: {\n        enabled: true,\n        equationRgb: 0x8006,\n        equationAlpha: 0x8006,\n        functionSourceRgb: 0x0302,\n        functionSourceAlpha: 1,\n        functionDestinationRgb: 0x0303,\n        functionDestinationAlpha: 0x0303,\n    }\n};\n```\n\n### \u6240\u6709\u72B6\u6001\u503C\u8BF4\u660E\n```\ninterface RenderStateOptions {\n    // \u9ED8\u8BA4\u503C\uFF1A2305 \u53EF\u9009\u503C: 2304(CLOCKWISE\u987A\u65F6\u9488), 2305(COUNTER_CLOCKWISE\u9006\u65F6\u9488)\n    frontFace?: number, \n    cull?: {\n        enabled?: boolean, // false\n        // \u9ED8\u8BA4\u503C\uFF1A1029 \u53EF\u9009\u503C\uFF1A1028(FRONT), 1029(BACK), 1032(FRONT_AND_BACK)\n        face?: CullFace, // CullFace.BACK\n    },\n    lineWidth?: number, // 1 windows\u7CFB\u7EDF\u53EA\u80FD\u662F\uFF0C\u663E\u5361\u9A71\u52A8\u539F\u56E0\uFF0C\u8BBE\u7F6E\u5176\u4ED6\u6570\u503C\u4E0D\u8D77\u4F5C\u7528\uFF01\n    polygonOffset?: {\n        enabled?: boolean, // false\n        factor?: number, // 0,\n        units?: number, // 0\n    },\n    scissorTest?: {\n        enabled?: boolean, // false,\n        rectangle?: {\n            x?: number, // 0,\n            y?: number, // 0,\n            width?: number, // 0,\n            height?: number, // 0\n        }\n    },\n    depthRange?: {\n        near?: number, // 0,\n        far?: number, // 1\n    },\n    depthTest?: {\n        enabled?: boolean; // false,\n        // \u9ED8\u8BA4\u503C:513 \u53EF\u9009\u503C\uFF1A512(NEVER), 513(LESS), 514(EQUAL), 515(LESS_OR_EQUAL), \n        //   516(GREATER), 517(NOT_EQUAL), 518(GREATER_OR_EQUAL), 519(ALWAYS)\n        func?: number; \n    },\n    colorMask?: {\n        red?: boolean, // true,\n        green?: boolean, // true,\n        blue?: boolean, // true,\n        alpha?: boolean, // true\n    },\n    depthMask?: boolean, // true,\n    stencilMask?: number, // ~0\n    blending?: {\n        enabled?: boolean, // false,\n        color?: {\n            red?: number, // 0.0,\n            green?: number, // 0.0,\n            blue?: number, // 0.0,\n            alpha?: number, // 0.0\n        },\n        // \u9ED8\u8BA4\u503C\uFF1A32774, \u53EF\u9009\u503C\uFF1A32774(ADD), 32778(SUBTRACT), 32779(REVERSE_SUBTRACT), 32775(MIN), MIN(MAX)\n        equationRgb?: BlendEquation, // BlendEquation.ADD,\n        // \u9ED8\u8BA4\u503C\uFF1A32774, \u53EF\u9009\u503C\uFF1A32774(ADD), 32778(SUBTRACT), 32779(REVERSE_SUBTRACT), 32775(MIN), MIN(MAX)\n        equationAlpha?: BlendEquation, // BlendEquation.ADD,\n        // BlendFunction\u7C7B\u578B\u53EF\u9009\u503C\uFF1A0(ZERO), 1(ONE), 768(SOURCE_COLOR), 769(ONE_MINUS_SOURCE_COLOR),\n        //   774(DESTINATION_COLOR), 775(ONE_MINUS_DESTINATION_COLOR), 770(SOURCE_ALPHA),\n        //   771(ONE_MINUS_SOURCE_ALPHA), 772(DESTINATION_ALPHA), 773(ONE_MINUS_DESTINATION_ALPHA),\n        //   32769(CONSTANT_COLOR), 32770(ONE_MINUS_CONSTANT_COLOR), 32771(CONSTANT_ALPHA),\n        //   32772(ONE_MINUS_CONSTANT_ALPHA), 776(SOURCE_ALPHA_SATURATE)\n        // \u9ED8\u8BA4\u503C\uFF1A1, \u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9BlendFunction\u7C7B\u578B\u53EF\u9009\u503C\n        functionSourceRgb?: BlendFunction, // BlendFunction.ONE,\n        // \u9ED8\u8BA4\u503C\uFF1A1, \u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9BlendFunction\u7C7B\u578B\u53EF\u9009\u503C\n        functionSourceAlpha?: BlendFunction, // BlendFunction.ONE,\n        // \u9ED8\u8BA4\u503C\uFF1A0, \u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9BlendFunction\u7C7B\u578B\u53EF\u9009\u503C\n        functionDestinationRgb?: BlendFunction, // BlendFunction.ZERO,\n        // \u9ED8\u8BA4\u503C\uFF1A0, \u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9BlendFunction\u7C7B\u578B\u53EF\u9009\u503C\n        functionDestinationAlpha?: BlendFunction, // BlendFunction.ZERO\n    },\n    stencilTest?: {\n        enabled?: boolean, // false,\n        // StencilFunction\u7C7B\u578B\u53EF\u9009\u503C\uFF1A512(NEVER), 513(LESS), 514(EQUAL), 515(LESS_OR_EQUAL),\n        //   516(GREATER), 517(NOT_EQUAL), 518(GREATER_OR_EQUAL), 519(ALWAYS)\n        // \u9ED8\u8BA4\u503C 519, \u53EF\u9009\u503C\u53C2\u89C1StencilFunction\u7C7B\u578B\u53EF\u9009\u503C\n        frontFunction?: StencilFunction, // StencilFunction.ALWAYS,\n        // \u9ED8\u8BA4\u503C 519, \u53EF\u9009\u503C\u53C2\u89C1StencilFunction\u7C7B\u578B\u53EF\u9009\u503C\n        backFunction?: StencilFunction, // StencilFunction.ALWAYS,\n        reference?: number; // 0,\n        mask?: number; // ~0,\n        // StencilOperation\u7C7B\u578B\u53EF\u9009\u503C\uFF1A0(ZERO), 7680(KEEP), 7681(REPLACE), 7682(INCREMENT),\n        //   7683(DECREMENT), 5386(INVERT), 34055(INCREMENT_WRAP), 34056(DECREMENT_WRAP)\n        frontOperation?: {\n            // \u9ED8\u8BA4\u503C\uFF1A7680\uFF0C\u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9StencilOperation\u7C7B\u578B\u53EF\u9009\u503C\n            fail?: StencilOperation, // StencilOperation.KEEP,\n            // \u9ED8\u8BA4\u503C\uFF1A7680\uFF0C\u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9StencilOperation\u7C7B\u578B\u53EF\u9009\u503C\n            zFail?: StencilOperation, // StencilOperation.KEEP,\n            // \u9ED8\u8BA4\u503C\uFF1A7680\uFF0C\u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9StencilOperation\u7C7B\u578B\u53EF\u9009\u503C\n            zPass?: StencilOperation, // StencilOperation.KEEP\n        },\n        backOperation?: {\n            // \u9ED8\u8BA4\u503C\uFF1A7680\uFF0C\u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9StencilOperation\u7C7B\u578B\u53EF\u9009\u503C\n            fail?: StencilOperation, // StencilOperation.KEEP,\n            // \u9ED8\u8BA4\u503C\uFF1A7680\uFF0C\u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9StencilOperation\u7C7B\u578B\u53EF\u9009\u503C\n            zFail?: StencilOperation, // StencilOperation.KEEP,\n            // \u9ED8\u8BA4\u503C\uFF1A7680\uFF0C\u53EF\u9009\u503C\u53C2\u89C1\u4E0A\u65B9StencilOperation\u7C7B\u578B\u53EF\u9009\u503C\n            zPass?: StencilOperation, // StencilOperation.KEEP\n        }\n    },\n    sampleCoverage?: {\n        enabled?: boolean, // false,\n        value?: number, // 1.0,\n        invert?: boolean, // false\n    }\n}\n```\n";

package/dist/types/ESObjects/general/ESCustomPrimitive/readme/shaderSource.d.ts

@@ -0,0 +1,2 @@
+export declare const vertexShaderSourceReadMe = "### \u9ED8\u8BA4\u9876\u70B9Shader\u793A\u4F8B\n```\nin vec3 position;\nin vec3 normal;\nin vec2 st;\nout vec3 v_normalEC;\nout vec2 v_st;\nvoid main()\n{\n    // \u5982\u679C\u8FD9\u4E00\u53E5\u6CE8\u91CA\uFF0C\u8981\u76F8\u5E94\u5730\u6CE8\u91CA\u6389attribute\u4E2D\u7684normal\uFF0C\u4E5F\u5C31\u662F\u8BF4\u9876\u70B9\u5C5E\u6027\u8981\u548Cshader\u4E2D\u7684\u4E00\u4E00\u5339\u914D\uFF01\n    v_normalEC = czm_normal * normal; \n    v_st = st;\n    gl_Position = czm_modelViewProjection * vec4(position, 1.0);\n}\n```\n\n### \u76F8\u5BF9\u5B8C\u6574\u7684\u9876\u70B9Shader\n```\n// vtxf \u4F7F\u7528double\u7C7B\u578B\u7684position\u8FDB\u884C\u8BA1\u7B97\n// in vec3 position3DHigh;\n// in vec3 position3DLow;\nin vec3 position;\nin vec3 normal;\nin vec2 st;\nin float batchId;\nout vec3 v_positionEC;\nout vec3 v_normalEC;\nout vec2 v_st;\nvoid main()\n{\n    // vtxf \u4F7F\u7528double\u7C7B\u578B\u7684position\u8FDB\u884C\u8BA1\u7B97\n    // vec4 p = czm_translateRelativeToEye(position3DHigh, position3DLow);\n    // v_positionEC = (czm_modelViewRelativeToEye * p).xyz;      // position in eye coordinates\n    // v_normalEC = czm_normal * normal;                         // normal in eye coordinates\n    // v_st = st;\n    // gl_Position = czm_modelViewProjectionRelativeToEye * p;\n    v_positionEC = (czm_modelView * vec4(position, 1.0)).xyz;       // position in eye coordinates\n    v_normalEC = czm_normal * normal;                               // normal in eye coordinates\n    v_st = st;\n    gl_Position = czm_modelViewProjection * vec4(position, 1.0);\n}\n```\n";
+export declare const fragmentShaderSourceReadMe = "### \u9ED8\u8BA4\u7247\u5143Shader\u793A\u4F8B\n```\nin vec2 v_st;\nuniform sampler2D u_image;\nuniform vec4 u_color;\nvoid main()\n{\n    vec4 imageColor = texture(u_image, v_st);\n    out_FragColor = imageColor * u_color;\n}\n```\n\n### xe2VisibleAlpha\u4F7F\u7528\u793A\u4F8B\nxe2VisibleAlpha\u662F\u6839\u636E\u89C6\u8DDD\u8303\u56F4\u81EA\u52A8\u8BA1\u7B97\u51FA\u6765\u7684alpha\u503C\uFF0C\u7528\u6765\u8BBE\u7F6E\u900F\u660E\uFF0C\u4EA7\u751F\u6E10\u663E\u7684\u6548\u679C\u3002\n``` \nin vec2 v_st;\nuniform sampler2D u_image;\nuniform vec4 u_color;\nuniform float u_xe2VisibleAlpha;\nvoid main()\n{\n    vec4 imageColor = texture(u_image, v_st);\n    out_FragColor = imageColor * u_color * vec4(1., 1., 1., u_xe2VisibleAlpha);\n}\n```\n\n### \u76F8\u5BF9\u5B8C\u6574\u7684\u7247\u5143Shader\u793A\u4F8B\n```\nin vec3 v_positionEC;\nin vec3 v_normalEC;\nin vec2 v_st;\nuniform sampler2D myImage;\nvoid main()\n{\n    vec3 positionToEyeEC = -v_positionEC;\n    vec3 normalEC = normalize(v_normalEC);\n#ifdef FACE_FORWARD\n    normalEC = faceforward(normalEC, vec3(0.0, 0.0, 1.0), -normalEC);\n#endif\n    czm_materialInput materialInput;\n    materialInput.normalEC = normalEC;\n    materialInput.positionToEyeEC = positionToEyeEC;\n    materialInput.st = v_st;\n    //czm_material material = czm_getMaterial(materialInput);\n    czm_material material = czm_getDefaultMaterial(materialInput);\n    vec4 imageColor = texture(myImage, materialInput.st);\n    material.diffuse = imageColor.rgb;\n    material.alpha = imageColor.a;\n// #ifdef FLAT\n    out_FragColor = vec4(material.diffuse + material.emission, material.alpha);\n// #else\n    // out_FragColor = czm_phong(normalize(positionToEyeEC), material, czm_lightDirectionEC);\n// #endif\n}\n```\n";

package/dist/types/ESObjects/general/ESCustomPrimitive/readme/uniformMap.d.ts

@@ -0,0 +1 @@
+export declare const uniformMapReadMe = "### \u9ED8\u8BA4\u4F7F\u7528\u7684UniformMap\n```\n{\n    \"myImage\": { \n        \"type\": \"image\", \n        \"uri\": \"${earthsdk3-assets-script-dir}/assets/img/location.png\"\n    }\n}\n```\n\n### \u793A\u4F8B1\n```\n{\n    \"myImage\": { \n        \"type\": \"image\", \n        \"uri\": \"${earthsdk3-assets-script-dir}/assets/img/location.png\"\n    },\n    \"ratio\": 0.5,\n}\n```\n\n### \u793A\u4F8B2\n```\n{\n    \"u_image\": {\n        \"type\": \"texture\",\n        \"id\": \"3010d3bd-cbf8-46cd-939f-c0b39b926255\"\n    },\n    \"ratio\": 0.5,\n}\n\n```\n\n### \u793A\u4F8B3\n```\n{\n    \"ratioAndStart\": [0.5, 0.7],\n}\n```\n\n### UniformMap\u7C7B\u578B\u89C4\u683C\n```\nexport type CzmCustomPrimitiveUniformType = number | [number, number] | [number, number, number] | [number, number, number, number] | { type: 'image', uri: string };\nexport type CzmCustomPrimitiveUniformMapType = { [k: string]: CzmCustomPrimitiveUniformType };\n```\n";

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

@@ -25,6 +25,7 @@ export type ESJCylinderMaterialParamsType = {
  * 圆柱体对象类
  * 继承自 ESObjectWithLocation，提供圆柱体几何形状的可视化功能
  * 支持多种渲染引擎（Cesium、UE等）
+ * @remarks 圆柱体
  */
 export declare class ESCylinder extends ESObjectWithLocation {
     /**

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

@@ -18,6 +18,7 @@ import { ESSceneObject } from '../base';
  * 特殊使用限制或潜在的副作用：
  * - 在使用 flyTo 方法时，如果未指定持续时间，将使用默认值。
  * - 重置时钟时，会根据当前加载的数据重新设置时钟状态。
+ * @remarks CZML数据加载
  */
 export declare class ESCzml extends ESSceneObject {
     static readonly createDefaultProps: () => {

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

@@ -27,6 +27,7 @@ export type ESDataMeshColorStopType = {
  *
  * 特殊使用限制或潜在的副作用：
  * - maxTime 属性不可修改，如需修改请调整默认值。
+ * @remarks 数据网格
  */
 export declare class ESDataMesh extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -19,6 +19,7 @@ import { ESObjectWithLocation } from '../base';
  *
  * 特殊使用限制或潜在的副作用：
  * - 无特殊使用限制或潜在的副作用。
+ * @remarks Datasmith运行时模型
  */
 export declare class ESDatasmithRuntimeModel extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -17,6 +17,7 @@ import { ESJEditingBindModeType, ESJStrokeStyle } from '../../index';
  *
  * 特殊使用限制或潜在的副作用：
  * - 无特殊使用限制或潜在的副作用。
+ * @remarks 方向测量
  */
 export declare class ESDirectionMeasurement extends ESGeoVector {
     static readonly createDefaultProps: () => {

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

@@ -14,6 +14,7 @@ import { UniteChanged } from '../../xbsj-base';
  * 特殊使用限制或潜在的副作用：
  * - 该类依赖于 ESGeoLineString 类，因此需要确保 ESGeoLineString 已被正确导入和使用。
  * - 在设置线条颜色时，需要传入一个包含四个元素的数组，分别表示 RGBA 颜色值。
+ * @remarks 距离测量
  */
 export declare class ESDistanceMeasurement extends ESGeoLineString {
     static readonly createDefaultProps: () => {

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

@@ -24,6 +24,7 @@ import { ESLocalPolygon } from './ESLocalPolygon';
  * 特殊的使用限制或潜在的副作用：
  * - 当水域类型（waterType）不为 custom 时，其他控制效果的参数不会生效，而是使用对应水域类型的预定效果。
  * - 水体浑浊度（murkiness）的取值范围应在 0 到 10 之间，超出该范围可能导致不可预知的行为。
+ * @remarks 动态水面
  */
 export declare class ESDynamicWater extends ESLocalPolygon {
     static readonly createDefaultProps: () => {

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

@@ -66,6 +66,7 @@ export type ESEntityClusterStyle = {
  * 特殊使用限制或潜在的副作用：
  * - 在设置 `url` 属性时，如果 `url` 是一个对象或JSON字符串，数据将直接被解析和设置。如果是URL字符串，数据将通过 `fetch` 方法异步加载。
  * - 数据加载失败时，会在控制台输出警告信息。
+ * @remarks 实体聚合
  */
 export declare class ESEntityCluster extends ESVisualObject {
     static readonly createDefaultProps: () => {

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

@@ -17,6 +17,7 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  * 特殊使用限制或潜在的副作用：
  * - 该类依赖于 ESGeoPolygon 类，因此需要确保 ESGeoPolygon 已被正确导入和使用。
  * - 挖坑操作可能会影响地形数据，使用时需谨慎。
+ * @remarks 挖方
  */
 export declare class ESExcavate extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESFeatureLayer/FeatureLayer.d.ts

@@ -1,6 +1,18 @@
 import { ESViewer } from '../../../ESViewer';
 import { Destroyable } from '../../../xbsj-base';
 import { ESFeatureLayer } from './index';
+/**
+ * 要素图层类，负责管理点、线、面三种矢量图层的创建与生命周期。
+ *
+ * 根据 {@link ESFeatureLayer} 中配置的 `layerType`（`pointVector`、`polylineVector`、`polygonVector`），
+ * 自动实例化对应的 {@link PointLayer}、{@link PolyLineLayer} 或 {@link PolygonLayer}。
+ * 支持通过 URL 远程加载 GeoJSON/Fetch 数据，也支持直接传入 features 数组。
+ *
+ * 主要功能：
+ * - 响应 `featurePropsChanged` 事件，增量重建图层
+ * - 支持飞行定位到图层的所有要素（`flyToEvent`）
+ * - 自动清理旧图层，避免内存泄漏
+ */
 export declare class FeatureLayer extends Destroyable {
     private _initEvent;
     init(): void;

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

@@ -19,6 +19,7 @@ import { ESObjectWithLocation } from '../base';
  * 特殊使用限制或潜在的副作用：
  * - 该类依赖于 ESObjectWithLocation 类，因此需要确保 ESObjectWithLocation 已被正确导入和使用。
  * - 默认配置中包含了图片和偏移的默认值，这些值可以在实例化后通过属性进行修改。
+ * @remarks 火焰粒子。
  */
 export declare class ESFireParticleSystem extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -20,6 +20,7 @@ import { ESFireParticleSystem } from './ESFireParticleSystem';
  * 构造函数参数：
  * - 无特殊构造参数，使用默认构造函数
  * - 对象创建后可通过属性设置坐标和火焰参数
+ * @remarks 火焰墙
  */
 export declare class ESFireWall extends ESGeoVector {
     /**
@@ -93,6 +94,15 @@ export declare class ESFireWall extends ESGeoVector {
      */
     constructor(id?: string);
     createFires(): void;
+    /**
+     * 对多边形边界点进行插值，每两个相邻点之间插入中点，用于细化火焰墙粒子布置。
+     *
+     * 将输入点集视为环形多边形（首尾相连），对每个点与其下一个相邻点计算中点，
+     * 返回 `[原位置, 中点]` 交替排列的数组，使点数翻倍。
+     *
+     * @param points - 三维坐标点数组 `[经度, 纬度, 高度]`，表示环形多边形的顶点
+     * @returns 插值后的点数组，长度是输入的两倍，每对 `[原位置, 中点]` 交替排列
+     */
     interpolationPoints(points: [number, number, number][]): [number, number, number][];
     clear(): void;
     /**

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

@@ -46,6 +46,8 @@ export type ESXiaoBanWidget = {
  * 特殊使用限制或潜在的副作用：
  * - 该类依赖于 ESVisualObject 类，因此需要确保 ESVisualObject 已被正确导入和使用。
  * - 在使用该类时，需要提供有效的树类型和小板块属性，否则可能会导致渲染问题。
+ *
+ * @remarks 森林瓦片集
  */
 export declare class ESForestTileset extends ESVisualObject {
     static readonly createDefaultProps: () => {

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

@@ -19,6 +19,7 @@ import { ESObjectWithLocation } from '../base';
  *
  * 特殊的使用限制或潜在的副作用：
  * - 无特殊使用限制或潜在的副作用。
+ * @remarks 喷泉粒子
  */
 export declare class ESFountainParticleSystem extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -19,6 +19,7 @@ import { ESObjectWithLocation } from '../base';
  *
  * 特殊使用限制或潜在的副作用：
  * - 无特殊使用限制或潜在的副作用。
+ * @remarks 高斯溅射
  */
 export declare class ESGaussianSplatting extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -0,0 +1,62 @@
+import { Event, UniteChanged } from '../../../xbsj-base';
+import { ESJVector4D } from '../../../ESJTypes';
+import { ESViewer } from '../../../ESViewer';
+import { ESVisualObject } from '../../base';
+import { ESImageryLayer } from '../ESImageryLayer';
+/**
+ * ESGeHistoryImagery - 谷歌历史影像图层对象
+ *
+ * 用于在场景中加载和显示谷歌历史影像的图层对象，支持按时间选择影像数据。
+ * 可通过 currentDate 属性设置日期以查看不同时期的卫星影像。
+ *
+ * @see https://c0yh9tnn0na.feishu.cn/wiki/TgnAwbo9jiI3NpkxPg6czXqsnwe
+ * @see https://gggis.com/siyouhua/gehis.html 详细内容请参阅谷谷GIS
+ */
+export declare class ESGeHistoryImagery extends ESVisualObject {
+    static readonly createDefaultProps: () => {
+        /** 当前日期，格式如 "2020-01-01"，用于选择不同时间的历史影像 */
+        currentDate: string;
+        /** 图层叠加层级，数值越大显示越靠上 */
+        zIndex: number;
+        /** 影像显示的地理范围，格式为 [west, south, east, north] 经纬度数组 */
+        rectangle: import('../../..').ReactiveVariable<ESJVector4D>;
+        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;
+    private _esImageryLayer;
+    get esImageryLayer(): ESImageryLayer;
+    private _datesEvent;
+    get datesEvent(): Event<[string[] | undefined, ESViewer]>;
+    /**
+     * 创建一个 ESGeHistoryImagery 实例
+     * @param id - 可选的对象唯一标识符
+     */
+    constructor(id?: string);
+    /**
+     * 获取对象的 ES 属性列表
+     * @returns 包含 basic 分类下各属性的配置对象
+     */
+    getESProperties(): {
+        basic: import('../../..').Property[];
+        general: import('../../..').Property[];
+        more: import('../../..').Property[];
+        defaultMenu: string;
+        dataSource: import('../../..').Property[];
+        location: import('../../..').Property[];
+        coordinate: import('../../..').Property[];
+        style: import('../../..').Property[];
+    };
+}
+export interface ESGeHistoryImagery extends UniteChanged<ReturnType<typeof ESGeHistoryImagery.createDefaultProps>> {
+}

package/dist/types/ESObjects/general/ESGeHistoryImagery/type.d.ts

@@ -0,0 +1,14 @@
+import { ESViewer } from '../../../ESViewer';
+import { ESImageryLayer } from '../ESImageryLayer';
+import { Destroyable } from '../../../xbsj-base';
+import { ESGeHistoryImagery } from './index';
+/**
+ * 获取当前瓦片坐标的时间信息，并定期更新影像图层。
+ * 根据相机位置计算当前视口的瓦片坐标（X/Y/Z），
+ * 从服务端获取该瓦片对应的时间列表，
+ * 并通过定时器每隔 3 秒刷新一次，
+ * 同时监听当前日期变化更新影像图层的 URL。
+ */
+export declare class GetCurrentTileCoordinates extends Destroyable {
+    constructor(viewer: ESViewer, sceneObject: ESGeHistoryImagery, esImageryLayer: ESImageryLayer);
+}

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

@@ -0,0 +1,104 @@
+import { SceneObjectKey, UniteChanged, Listener } from '../../../xbsj-base';
+import { ESGeoVector } from '../../base';
+/** Czm 实现层注入的路径内部对象接口 */
+interface GeoPolylinePathLike {
+    geoPath: {
+        timePosRots: any;
+    };
+    ratio: number;
+    ratioChanged: Listener<[]>;
+}
+/** 贝塞尔曲线路径，支持动画播放 */
+export declare class ESGeoBezierPath extends ESGeoVector {
+    static readonly createDefaultProps: () => {
+        /** 是否显示当前点位标识 */
+        currentPoiShow: boolean;
+        /** 是否贴地
+         * @deprecated
+         */
+        ground: boolean;
+        /** 弧线类型：NONE(直线)、GEODESIC(地理直线)、RHUMB(地理恒向线) */
+        arcType: string;
+        /** 是否循环播放 */
+        loop: boolean;
+        /** 当前播放时间（毫秒） */
+        currentTime: number;
+        /** 单次播放总时长（毫秒） */
+        duration: number;
+        /** 播放速度倍率 */
+        speed: number;
+        /** 是否正在播放 */
+        playing: boolean;
+        /** 路径插值采样数，越高路径越平滑 */
+        resolution: number;
+        /** 曲线锐化程度，值越大拐角越尖锐 */
+        sharpness: number;
+        /** 是否开启深度检测 */
+        depthTest: boolean;
+        /** 折线超前显示时长（毫秒） */
+        leadTime: number;
+        /** 折线滞后显示时长（毫秒） */
+        trailTime: number;
+        /** 是否描边 */
+        stroked: boolean;
+        pointed: boolean;
+        pointStyle: import('../../..').ReactiveVariable<import('../../..').ESJPointStyle>;
+        strokeStyle: import('../../..').ReactiveVariable<import('../../..').ESJStrokeStyle>;
+        filled: boolean;
+        fillStyle: import('../../..').ReactiveVariable<import('../../..').ESJFillStyle>;
+        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;
+    updateEditing(): void;
+    _deprecated: string[];
+    private _deprecatedWarningFunc;
+    private _geoPolylinePath;
+    get geoPolylinePath(): GeoPolylinePathLike;
+    set geoPolylinePath(value: GeoPolylinePathLike);
+    get geoPath(): {
+        timePosRots: any;
+    };
+    get ratio(): number;
+    set ratio(value: number);
+    get ratioChanged(): Listener<[]>;
+    private _currentDistance;
+    get currentDistance(): number;
+    set currentDistance(value: number);
+    get currentDistanceChanged(): Listener<[number, number]>;
+    static supportEditingModes: string[];
+    /**
+     * 构造函数
+     * @param id 场景对象标识
+     */
+    constructor(id?: SceneObjectKey);
+    get timePosRots(): any;
+    /**
+     * 获取属性列表，用于在 UI 中展示和编辑
+     * @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 ESGeoBezierPath extends UniteChanged<ReturnType<typeof ESGeoBezierPath.createDefaultProps>> {
+}
+export {};

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

@@ -14,6 +14,7 @@ import { ESJColor, ESJVector4D } from '../../ESJTypes';
  * 特殊使用限制或潜在的副作用：
  * - 该类依赖于 ESObjectWithLocation 类，因此需要确保在使用 ESGeoDivTextPoi 之前已经正确引入并初始化了 ESObjectWithLocation。
  * - 文本编辑交互功能可能会影响性能，特别是在大量文本对象同时存在时。
+ * @remarks 地理标注文字POI
  */
 export declare class ESGeoDivTextPoi extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -17,6 +17,7 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  *
  * 特殊的使用限制或潜在的副作用：
  * - 无特殊使用限制或潜在的副作用。
+ * @remarks 拉伸多边形。
  */
 export declare class ESGeoExtrudedPolygon extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

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

@@ -0,0 +1,58 @@
+import { ESObjectWithLocation } from '../base';
+import { UniteChanged } from '../../xbsj-base';
+/**
+ * 地理图标 - 在场景中指定位置显示自定义图标图片的可视化对象。
+ * 通过设置 url、大小和可见缩放范围来控制图标的显示效果。
+ * @remarks 地理图标
+ */
+export declare class ESGeoIcon extends ESObjectWithLocation {
+    static readonly createDefaultProps: () => {
+        /** 图标图片的 URL */
+        url: string;
+        /** 图标大小（米），格式为 [width, height] */
+        size_m: number[];
+        /** 可见缩放范围，格式为 [minZoom, maxZoom] */
+        minmaxScale: number[];
+        pointed: boolean;
+        pointStyle: import('../..').ReactiveVariable<import('../..').ESJPointStyle>;
+        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;
+    static supportEditingModes: string[];
+    /** @override */
+    /** @returns 返回 ES 属性列表，包含 url、size_m 和 minmaxScale */
+    getESProperties(): {
+        basic: import('../..').Property[];
+        defaultMenu: string;
+        location: import('../..').Property[];
+        more: import('../..').Property[];
+        general: import('../..').Property[];
+        dataSource: import('../..').Property[];
+        coordinate: import('../..').Property[];
+        style: import('../..').Property[];
+    };
+    /**
+     * 创建 ESGeoIcon 实例
+     * @param id 可选的对象标识符
+     */
+    constructor(id?: string);
+}
+export interface ESGeoIcon extends UniteChanged<ReturnType<typeof ESGeoIcon.createDefaultProps>> {
+}

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

@@ -19,6 +19,7 @@ import { ESGeoVector } from '../base';
  *
  * 特殊的使用限制或潜在的副作用：
  * - 无特殊的使用限制或潜在的副作用。
+ * @remarks 地理折线
  */
 export declare class ESGeoLineString extends ESGeoVector {
     static readonly createDefaultProps: () => {

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

@@ -0,0 +1,58 @@
+import { BooleanProperty, ColorProperty, EnumProperty, ESJPointStyle, DivideProperty, NumberProperty } from '../../ESJTypes';
+import { UniteChanged } from '../../xbsj-base';
+import { ESObjectWithLocation } from '../base';
+/**
+ * 地理点对象，用于在地图中显示地理点标记的可视化对象，支持自定义点样式。
+ * 可通过 position 属性指定经纬度坐标，通过 pointStyle 自定义大小、颜色、材质等样式。
+ * @remarks 地理点
+ */
+export declare class ESGeoPoint extends ESObjectWithLocation {
+    static readonly createDefaultProps: () => {
+        /** 是否启用点标记（显示/隐藏地理点） */
+        pointed: boolean;
+        /** 点样式配置，包括大小、颜色、材质、轮廓等 */
+        pointStyle: import('../..').ReactiveVariable<ESJPointStyle>;
+        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;
+    static supportEditingModes: string[];
+    /**
+     * 获取可编辑属性列表，包括坐标属性、点样式属性和基本属性。
+     * 扩展自父类的属性，额外添加了 distance、pointed、pointSize、pointSizeType、pointColor、mode、radius 等属性。
+     * @returns 包含 coordinate、style、basic 三组可编辑属性的对象
+     */
+    getESProperties(): {
+        coordinate: import('../..').Property[];
+        style: (BooleanProperty | NumberProperty | ColorProperty | DivideProperty | EnumProperty<string>)[];
+        basic: import('../..').Property[];
+        defaultMenu: string;
+        location: import('../..').Property[];
+        more: import('../..').Property[];
+        general: import('../..').Property[];
+        dataSource: import('../..').Property[];
+    };
+    /**
+     * 创建一个 ESGeoPoint 实例。
+     * @param id - 可选的对象唯一标识符。
+     */
+    constructor(id?: string);
+}
+export interface ESGeoPoint extends UniteChanged<ReturnType<typeof ESGeoPoint.createDefaultProps>> {
+}

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

@@ -1,6 +1,10 @@
 import { SceneObjectKey, UniteChanged } from '../../../xbsj-base';
 import { ESGeoVector } from '../../base';
 import { ESJEditingBindModeType } from '../../../index';
+/**
+ * 用于在地图中可视化地理点集合的对象。
+ * @remarks 地理点集合
+ */
 export declare class ESGeoPoints extends ESGeoVector {
     static readonly createDefaultProps: () => {
         pointed: boolean;

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

@@ -23,6 +23,7 @@ import { ESJBuffer, ESJBufferMode } from '../../ESJTypes/properties/ESJBuffer';
  *
  * 特殊的使用限制或潜在的副作用：
  * - 无特殊的使用限制或潜在的副作用。
+ * @remarks 地理多边形
  */
 export declare class ESGeoPolygon extends ESGeoVector {
     static readonly createDefaultProps: () => {

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

@@ -16,6 +16,7 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  * 构造函数参数：
  * - 无特殊构造参数，使用默认构造函数
  * - 对象创建后可通过属性设置坐标和火焰参数
+ * @remarks 带火多边形
  */
 export declare class ESGeoPolygonWithFire extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

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

@@ -19,6 +19,7 @@ import { ESJEditingBindModeType, ESJFillStyle, ESJVector3DArray } from '../../ES
  * 特殊使用限制或潜在的副作用：
  * - 矩形的点数组长度必须大于等于 2 才能正确计算面积和周长。
  * - 矩形的编辑模式包括父类支持的编辑模式以及 DoublePointsAppend 和 DoublePointsModify 模式。
+ * @remarks 地理矩形
  */
 export declare class ESGeoRectangle extends ESGeoVector {
     static readonly createDefaultProps: () => {