earthsdk3 3.11.0 → 3.11.1

package/dist/types/ESJTypes/ScreenManager/index.d.ts

@@ -1,7 +1,6 @@
 import { ESJVector3D } from '../properties';
 import { ESEntityClusterStyle } from '../../ESObjects';
 import { SceneObjectKey } from '../../xbsj-base';
-import * as Cesium from "cesium";
 export type ESJScreenLayerInfo = {
     layer: string;
     id: SceneObjectKey;
@@ -9,7 +8,7 @@ export type ESJScreenLayerInfo = {
 };
 export type ESJScreenObjectInfo = {
     index?: number | string;
-    position: ESJVector3D | Cesium.Cartesian3;
+    position: ESJVector3D;
     name?: string;
     zOrder?: number;
     properties?: any;

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

@@ -289,6 +289,28 @@ export declare class ESObjectsManager extends Destroyable {
      * @returns 切换后的视口。
      */
     switchToCesiumViewer<T extends ESViewer>(container: HTMLDivElement | string, viewSync?: boolean, attributeSync?: boolean, destroy?: boolean, id?: string): T;
+    /**
+     * 切换到 OpenLayers 视口。
+     * @param options - 切换选项，可以是对象或具体参数。
+     * @returns 切换后的视口。
+     */
+    switchToOpenLayersViewer<T extends ESViewer>(options: {
+        container: HTMLDivElement | string;
+        viewSync?: boolean;
+        attributeSync?: boolean;
+        destroy?: boolean;
+        id?: string;
+    }): T;
+    /**
+     * 切换到 OpenLayers 视口。
+     * @param container - 视口容器，可以是 HTML 元素或字符串。
+     * @param viewSync - 是否同步视角，默认 true。
+     * @param attributeSync - 是否同步属性，默认 true。
+     * @param destroy - 是否销毁旧视口，默认 true。
+     * @param id - 视口的 ID。
+     * @returns 切换后的视口。
+     */
+    switchToOpenLayersViewer<T extends ESViewer>(container: HTMLDivElement | string, viewSync?: boolean, attributeSync?: boolean, destroy?: boolean, id?: string): T;
     /**
      * 切换到 UE 视口。
      * @param options - 切换选项，可以是对象或具体参数。

package/dist/types/ESObjects/base/ESTestObject.d.ts

@@ -1,15 +1,66 @@
 import { BooleanProperty, ColorProperty, DashPatternProperty, DateProperty, DatesProperty, DivideProperty, EnumProperty, ESJColor, ESJVector2D, ESJVector3D, ESJVector4D, EvalStringProperty, GetSetProperty, JsonArrayProperty, JsonProperty, LongStringProperty, MethodProperty, Number2Property, Number3Property, Number4Property, NumberProperty, StringProperty } from '../../index';
-import { UniteChanged } from '../../xbsj-base';
+import { Event, UniteChanged } from '../../xbsj-base';
 import { ESSceneObject } from './ESSceneObject';
+/**
+ * ESTestObject —— earthsdk3 场景对象的【规范示例】。
+ *
+ * 本文件演示一个标准场景对象应具备的全部要素，可作为新建对象的模板：
+ * 1. **注册元数据**：`register(className, ctor, { chsName, tags, description })`，
+ *    `description` 用模板字面量写一句中文说明 + `对象json示例: { ... }`，供 AI 检索与文档生成。
+ * 2. **响应式属性**：在 `createDefaultProps` 中声明，复杂/数组类型用 `reactArray` / `reactJson` /
+ *    `reactPositions` 等包装；每个属性上方写 JSDoc，含 `@type` 与 `@default`（文档生成器优先取这两项）。
+ * 3. **业务事件**：私有 `_xxxEvent = this.dv(new Event<[...]>())` + 公开 `get xxxEvent()`，
+ *    方法内通过 `this._xxxEvent.emit(...)` 触发；属性变化事件由 `extendClassProps` 自动生成 `xxxChanged`。
+ * 4. **公开方法**：上方写 JSDoc，含 `@param` / `@returns`。
+ * 5. **属性面板**：`getESProperties()` 返回分区属性描述器，供 UI 面板与编辑器使用。
+ *
+ * 继承链：`Destroyable -> ESSceneObject -> ESTestObject`。
+ */
 export declare class ESTestObject extends ESSceneObject {
+    /**
+     * 默认属性。每个属性上方的 JSDoc 会被 `generate-docs.mjs` 解析为文档的"属性"表。
+     * `...ESSceneObject.createDefaultProps()` 继承基类属性（show/name/ref/extras 等）。
+     */
     static readonly createDefaultProps: () => {
+        /**
+         * 是否显示对象
+         * @defaultValue true
+         */
         show: boolean;
+        /**
+         * 模型/数据服务地址
+         * @defaultValue http://localhost:8080/earthsdk3/earthsdk3.gltf
+         */
         url: string;
+        /**
+         * 高度（米）
+         * @defaultValue 100
+         */
         height: number;
+        /**
+         * 位置 [经度, 纬度, 高度]
+         * @defaultValue [116.39, 39.9, 100]
+         */
         position: import('../../xbsj-base').ReactiveVariable<ESJVector3D>;
+        /**
+         * 姿态 [航向, 俯仰, 翻滚]（度）
+         * @defaultValue [0, -90, 0]
+         */
         rotation: import('../../xbsj-base').ReactiveVariable<ESJVector3D>;
+        /**
+         * 点坐标数组 [经,纬,高][]
+         * @defaultValue []
+         */
         points: import('../../xbsj-base').ReactiveVariable<[number, number, number][] | undefined>;
+        /**
+         * 颜色 [红, 绿, 蓝, 透明度]，取值 0~1
+         * @defaultValue [1, 0, 0, 1]
+         */
         color: import('../../xbsj-base').ReactiveVariable<ESJColor>;
+        /**
+         * 线样式参数：{ width, widthType, color, material, materialParams, ground }
+         * @defaultValue {"width":1,"widthType":"screen","color":[1,1,1,1],"material":"","materialParams":{},"ground":false}
+         */
         strokeStyle: import('../../xbsj-base').ReactiveVariable<{
             width: number;
             widthType: string;
@@ -18,14 +69,50 @@ export declare class ESTestObject extends ESSceneObject {
             materialParams: {};
             ground: false;
         }>;
+        /**
+         * 参数类型：'screen'（屏幕像素）或 'world'（世界坐标）
+         * @defaultValue screen
+         */
         paramType: string;
+        /**
+         * 文本内容
+         * @defaultValue 默认
+         */
         text: string;
+        /**
+         * 可执行的 JS 代码字符串
+         * @defaultValue console.log("hello world")
+         */
         code: string;
+        /**
+         * 虚线图案，0~255 的位掩码
+         * @defaultValue 255
+         */
         dashPattern: number;
+        /**
+         * 开始时间（毫秒时间戳）
+         * @defaultValue Date.now()
+         */
         startTime: number;
+        /**
+         * 时间组（毫秒时间戳数组）
+         * @defaultValue []
+         */
         times: import('../../xbsj-base').ReactiveVariable<number[]>;
+        /**
+         * 像素偏移 [x, y]
+         * @defaultValue [10, 0]
+         */
         offset: import('../../xbsj-base').ReactiveVariable<ESJVector2D>;
+        /**
+         * 位置偏移 [x, y, z]
+         * @defaultValue [0, 2, 0]
+         */
         positionOffset: import('../../xbsj-base').ReactiveVariable<ESJVector3D>;
+        /**
+         * 内边距 [上, 右, 下, 左]
+         * @defaultValue [0, 2, 0, 2]
+         */
         padding: import('../../xbsj-base').ReactiveVariable<ESJVector4D>;
         name: string;
         ref: string | undefined;
@@ -35,10 +122,49 @@ export declare class ESTestObject extends ESSceneObject {
         updateFuncStr: string | undefined;
         toDestroyFuncStr: string | undefined;
     };
+    /**
+     * 注册到对象上下文。元数据是 AI 检索与文档生成的单一事实来源：
+     * - `chsName`：中文名；`tags`：分类标签（base 表示基类，`_ES_Impl_Cesium`/`_ES_Impl_UE`/`_ES_Impl_OL` 声明引擎实现）；
+     * - `description`：一句中文说明 + `对象json示例: { ... }`，用模板字面量，避免在其中使用反引号。
+     */
     static readonly type: string;
+    /**
+     * 构造函数。
+     * @param id - 实例唯一标识符，省略则自动生成。
+     */
     constructor(id?: string);
+    /**
+     * 测试事件。演示业务事件的标准声明模式：
+     * 私有字段 `this.dv(new Event<[...]>())` + 公开 getter + 方法内 `emit`。
+     * `this.dv` 将事件纳入对象生命周期，对象销毁时自动解绑。
+     */
+    private _testEvent;
+    /**
+     * 获取测试事件，外部用 `obj.testEvent.don(handler)` 订阅。
+     */
+    get testEvent(): Event<[type: string[], isMsg: boolean]>;
+    /**
+     * 测试方法：按指令打印对象 JSON 并触发 testEvent。
+     * @param type - 指令数组，含 'completeJson' 则打印完整 JSON，含 'json' 则打印精简 JSON。
+     * @param isMsg - 是否打印方法调用提示，默认 true。
+     */
     func(type: string[], isMsg?: boolean): void;
+    /**
+     * 测试方法（无默认参数版）。行为同 {@link func}。
+     * @param type - 指令数组。
+     * @param isMsg - 是否打印方法调用提示。
+     */
     func1(type: string[], isMsg: boolean): void;
+    /**
+     * 获取对象的 padding 属性值。
+     * @returns 内边距 [上, 右, 下, 左]。
+     */
+    getPadding(): ESJVector4D;
+    /**
+     * 配置对象的 UI 层属性面板。
+     * 返回按分区组织的属性描述器数组，供属性面板/编辑器渲染；`MethodProperty` 暴露为可调用方法按钮。
+     * @returns 属性面板分区配置。
+     */
     getESProperties(): {
         defaultMenu: string;
         basic: (StringProperty | GetSetProperty | JsonProperty<{}>)[];

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

@@ -1,17 +1,9 @@
 import { JsonValue, ESJColor, ESJEnvironmentMapManagerType, ESJMaterialType, ESJResource, ESJsonObjectType, ESJVector2D, ESJVector3D, ESJVector4D, ESJSplitDirectionType, ESVisualObject, Event } from '../../../index';
 import { SceneObjectKey, UniteChanged } from '../../../xbsj-base';
 import { ESJFeatureStyleType, FeatureColorJsonType, FeatureVisableJsonType } from './type';
-/**
- * https://www.wolai.com/earthsdk/scb9Mm6X1zR4GypJQreRvK
- * https://c0yh9tnn0na.feishu.cn/wiki/F5bDwHVrOiHHI3kk6QjcZF6engc
- *
- * ES3DTileset 类，继承自 ESVisualObject，用于处理 3D Tileset 数据。
- */
 /**
  * ES3DTileset 类用于管理和操作 3D Tileset 数据。
  * 该类继承自 ESVisualObject，提供了对 3D Tileset 的各种操作和事件处理功能。
- * https://www.wolai.com/earthsdk/scb9Mm6X1zR4GypJQreRvK
- * https://c0yh9tnn0na.feishu.cn/wiki/F5bDwHVrOiHHI3kk6QjcZF6engc
  * 主要功能包括：
  * - 注册和获取类型信息
  * - 支持编辑模式（平移和旋转）
@@ -35,6 +27,8 @@ import { ESJFeatureStyleType, FeatureColorJsonType, FeatureVisableJsonType } fro
  * 特殊使用限制或潜在的副作用：
  * - 在设置特征样式和颜色时，需要确保提供的 JSON 格式正确，否则可能会引发错误。
  * - 设置裁剪平面 ID 和挖坑 ID 时，需要确保 ID 的有效性和正确性。
+ *
+ * @remarks 3DTileset 数据加载与管理
  */
 export declare class ES3DTileset extends ESVisualObject {
     static readonly createDefaultProps: () => {

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

@@ -1,5 +1,4 @@
 import { ESJColor } from '../../../ESJTypes';
-import * as Cesium from 'cesium';
 /**
  * 特征颜色的JSON类型定义。
  * 用于根据属性值范围或特定值设置特征的颜色。
@@ -57,7 +56,7 @@ export type ES3DTilesCustomShaderClassType = {
     /**
      * 获取自定义着色器的属性。
      */
-    get customShader(): Cesium.CustomShader;
+    get customShader(): any;
 };
 /**
  * 数值条件项的类型定义。

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

@@ -18,6 +18,7 @@ import { ESObjectWithLocation } from '../base';
  * 特殊使用限制或潜在的副作用：
  * - 在创建飞行进入效果时，需要确保报警对象的位置和编辑状态已正确设置。
  * - 该类的使用可能依赖于特定的场景和上下文，例如 Cesium 或 Unreal Engine。
+ * @remarks 报警警示范围
  */
 export declare class ESAlarm extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -16,6 +16,7 @@ import { ESObjectWithLocation } from '../base';
  *
  * 特殊使用限制或潜在的副作用：
  * - 该类禁用了碰撞检测，因此不会与其他对象发生碰撞。
+ * @remarks 光圈效果
  */
 export declare class ESApertureEffect extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -18,6 +18,7 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  *
  * 特殊使用限制或潜在的副作用：
  * - 无特殊使用限制或潜在的副作用。
+ * @remarks 面积测量
  */
 export declare class ESAreaMeasurement extends ESGeoPolygon {
     static readonly createDefaultProps: () => {

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

@@ -20,6 +20,7 @@ import { ESGeoPolygon } from './ESGeoPolygon';
  * arrow.points = [[116.39, 39.9, 0], [116.45, 39.95, 0], [116.50, 40.0, 0]];
  * // 内部自动计算箭头多边形并通过 ESGeoPolygon 渲染
  * ```
+ * @remarks 攻击箭头
  */
 export declare class ESAttackArrow extends ESGeoLineString {
     static readonly createDefaultProps: () => {

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

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

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

@@ -19,6 +19,7 @@ import { ESObjectWithLocation } from '../base';
  * 特殊使用限制或潜在的副作用：
  * - 在设置裁剪盒体的尺寸和位置时，需要确保参数的有效性和合理性，避免出现异常裁剪效果。
  * - 指定目标 ID 时，需要确保该 ID 对应的 ES3DTileset 已存在且可用，否则裁剪效果可能无法应用。
+ * @remarks 盒子裁剪
  */
 export declare class ESBoxClipping extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -18,6 +18,7 @@ import { ESObjectWithLocation } from '../base';
  *
  * 特殊的使用限制或潜在的副作用：
  * - 无特殊限制或副作用。
+ * @remarks 相机视角
  */
 export declare class ESCameraView extends ESObjectWithLocation {
     /**

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

@@ -17,6 +17,8 @@ import { ESObjectWithLocation } from '../base';
  *
  * 特殊使用限制或潜在的副作用：
  * - 无特殊使用限制或潜在的副作用。
+ *
+ * @remarks 相机可视范围。
  */
 export declare class ESCameraVisibleRange extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

@@ -18,6 +18,7 @@ import { ESObjectWithLocation } from '../base';
  *
  * 特殊使用限制或潜在的副作用：
  * - 无特殊使用限制或潜在的副作用。
+ * @remarks 车辆对象
  */
 export declare class ESCar extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

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

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

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

@@ -22,6 +22,7 @@ import { ESGeoVector } from '../base';
  * - 重写了支持的编辑模式，增加了 CircularAppend、CircularInsert 和 HeightModify 模式。
  * - 重写了默认值，包含填充样式和填充状态的默认值。
  * - 在获取 ES 属性和属性列表时，添加了高度、面积和周长的属性。
+ * @remarks 分类
  */
 export declare class ESClassification extends ESGeoVector {
     static readonly createDefaultProps: () => {

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

@@ -16,6 +16,7 @@ import { ESObjectWithLocation } from '../base';
  * 特殊使用限制或潜在的副作用：
  * - 该类依赖于 ESObjectWithLocation 类，因此需要确保 ESObjectWithLocation 已被正确导入和使用。
  * - 在设置裁剪平面的属性时，需要确保属性值的有效性，以避免出现不可预期的行为。
+ * @remarks 裁剪平面
  */
 export declare class ESClippingPlane extends ESObjectWithLocation {
     static readonly createDefaultProps: () => {

package/dist/types/ESObjects/general/ESCustomPrimitive/_types.d.ts

@@ -0,0 +1,44 @@
+export type CzmPassType = 'ENVIRONMENT' | 'COMPUTE' | 'GLOBE' | 'TERRAIN_CLASSIFICATION' | 'CESIUM_3D_TILE' | 'CESIUM_3D_TILE_CLASSIFICATION' | 'CESIUM_3D_TILE_CLASSIFICATION_IGNORE_SHOW' | 'OPAQUE' | 'TRANSLUCENT' | 'OVERLAY' | 'NUMBER_OF_PASSES';
+export type CzmPrimitiveType = 'POINTS' | 'LINES' | 'LINE_LOOP' | 'LINE_STRIP' | 'TRIANGLES' | 'TRIANGLE_STRIP' | 'TRIANGLE_FAN';
+export declare const primitiveTypeEnums: [string, string][];
+export declare const passEnums: [string, string][];
+export type CzmCustomPrimitiveUniformMapType = {
+    [uniformName: string]: {
+        type: string;
+        [k: string]: any;
+    } | number | number[];
+};
+export type BoundingVolumeJsonType = {
+    type: string;
+    data: {
+        center?: [number, number, number];
+        radius?: number;
+        min?: [number, number, number];
+        max?: [number, number, number];
+    };
+};
+export interface CzmAttributeType {
+    typedArray: Float32Array | Float64Array | Int8Array | Uint8Array | Int16Array | Uint16Array | Int32Array | Uint32Array;
+    componentsPerAttribute: 1 | 2 | 3 | 4;
+    usage?: any;
+    normalize?: boolean;
+}
+export type CzmAttributesType = {
+    [k: string]: CzmAttributeType;
+};
+export type CzmIndexType = Uint8Array | Uint16Array | Uint32Array;
+export type AttributesJsonType = {
+    [k: string]: {
+        typedArray: {
+            type: string;
+            array: number[];
+        };
+        componentsPerAttribute: 1 | 2 | 3 | 4;
+        usage?: any;
+        normalize?: boolean;
+    };
+};
+export type IndexJsonType = {
+    type: string;
+    array: number[];
+};

package/dist/types/ESObjects/general/ESCustomPrimitive/defaults.d.ts

@@ -0,0 +1,26 @@
+import { CzmAttributesType, BoundingVolumeJsonType, CzmCustomPrimitiveUniformMapType } from './_types';
+export declare const defaultVertexShaderSource = "in vec3 position;\nin vec3 normal;\nin vec2 st;\nout vec3 v_normalEC;\nout vec2 v_st;\nvoid main()\n{\n    v_normalEC = czm_normal * normal; \n    v_st = st;\n    gl_Position = czm_modelViewProjection * vec4(position, 1.0);\n}\n";
+export declare const defaultFragmentShaderSource = "in 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";
+export declare const defaultBoundingVolume: BoundingVolumeJsonType;
+export declare const defaultRenderState: {
+    depthTest: {
+        enabled: boolean;
+    };
+    cull: {
+        enabled: boolean;
+        face: number;
+    };
+    depthMask: boolean;
+    blending: {
+        enabled: boolean;
+        equationRgb: number;
+        equationAlpha: number;
+        functionSourceRgb: number;
+        functionSourceAlpha: number;
+        functionDestinationRgb: number;
+        functionDestinationAlpha: number;
+    };
+};
+export declare const defaultUniformMap: CzmCustomPrimitiveUniformMapType;
+export declare const defaultAttribute: CzmAttributesType;
+export declare const defaultIndexTypedArray: Uint16Array<ArrayBuffer>;

package/dist/types/ESObjects/general/ESCustomPrimitive/funcs.d.ts

@@ -0,0 +1,5 @@
+import { CzmAttributesType, CzmIndexType, AttributesJsonType, IndexJsonType } from './_types';
+export declare function attributesToAttributesJson(attributes: CzmAttributesType): AttributesJsonType;
+export declare function attributesJsonToAttributes(attributesJson: AttributesJsonType): CzmAttributesType;
+export declare function indexToIndexJson(indexTypedArray: CzmIndexType): IndexJsonType;
+export declare function indexJsonToIndex(indexJson: IndexJsonType): any;

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

@@ -0,0 +1,188 @@
+import { ESJNativeNumber16 } from '../../../ESJTypes';
+import { getMinMaxPosition, JsonValue, SceneObjectKey, UniteChanged } from '../../../xbsj-base';
+import { ESObjectWithLocation } from '../../base';
+import { CzmAttributesType, CzmIndexType, AttributesJsonType, BoundingVolumeJsonType, CzmCustomPrimitiveUniformMapType, CzmPassType, CzmPrimitiveType, IndexJsonType } from './_types';
+/**
+ * 自定义图元，支持着色器。
+ * 用于在场景中创建自定义渲染图元，支持自定义顶点/片元着色器、顶点属性、包围盒和渲染状态。
+ *
+ * https://www.wolai.com/earthsdk/o97QLCu4MuaXekD4B5DZ9r
+ */
+export declare class ESCustomPrimitive extends ESObjectWithLocation {
+    static readonly createDefaultProps: () => {
+        /** 最大缩放值（屏幕像素模式下有效），用于限制图元在屏幕上的最大像素尺寸。 */
+        maximumScale: number | undefined;
+        /** 最小缩放值（屏幕像素模式下有效），用于限制图元在屏幕上的最小像素尺寸。 */
+        minimumScale: number | undefined;
+        /** 屏幕像素大小，设置图元在屏幕上显示的像素尺寸。 */
+        pixelSize: number | undefined;
+        /** 是否显示场景缩放值，控制是否按照场景距离缩放图元。 */
+        showSceneScale: boolean | undefined;
+        /** 模型矩阵，用于对图元施加自定义的模型变换。 */
+        modelMatrix: import('../../..').ReactiveVariable<ESJNativeNumber16 | undefined>;
+        /** 是否进行拣选（cull），控制是否对图元进行视锥体裁剪。 */
+        cull: import('../../..').ReactiveVariable<boolean | undefined>;
+        /** 包围体（bounding volume），用于视锥体裁剪和渲染排序。 */
+        boundingVolume: import('../../..').ReactiveVariable<BoundingVolumeJsonType | undefined>;
+        /** 渲染状态，包括深度测试、混合模式、面剔除等渲染管线状态。 */
+        renderState: import('../../..').ReactiveVariable<JsonValue>;
+        /** 图元类型，如 TRIANGLES、LINES、POINTS 等。 */
+        primitiveType: CzmPrimitiveType | undefined;
+        /** 渲染顺序（pass），控制图元在场景中的渲染阶段，如 OPAQUE、TRANSLUCENT 等。 */
+        pass: CzmPassType | undefined;
+        /** 顶点着色器源代码，自定义顶点处理逻辑。 */
+        vertexShaderSource: string | undefined;
+        /** 片元着色器源代码，自定义像素着色逻辑。 */
+        fragmentShaderSource: string | undefined;
+        /** 一致性变量（uniform）映射表，向着色器传递 uniform 数据。 */
+        uniformMap: import('../../..').ReactiveVariable<CzmCustomPrimitiveUniformMapType | undefined>;
+        /** 本地偏移位置，相对于图元所在位置的局部坐标偏移。 */
+        localPosition: import('../../..').ReactiveVariable<[number, number, number] | undefined>;
+        /** 本地旋转（姿态），定义图元的局部旋转欧拉角。 */
+        localRotation: import('../../..').ReactiveVariable<[number, number, number] | undefined>;
+        /** 本地缩放，定义图元在三个轴向上的局部缩放值。 */
+        localScale: import('../../..').ReactiveVariable<[number, number, number] | undefined>;
+        /** 本地模型矩阵，直接设置图元的局部变换矩阵（覆盖 position/rotation/scale）。 */
+        localModelMatrix: import('../../..').ReactiveVariable<ESJNativeNumber16 | undefined>;
+        /** 是否进行遮挡剔除（occlude），控制图元是否被其它物体遮挡时剔除。 */
+        occlude: boolean | undefined;
+        /** 顶点计数（count），指定绘制时的顶点数量。 */
+        count: number | undefined;
+        /** 顶点偏移（offset），指定绘制时从第几个顶点开始。 */
+        offset: number | undefined;
+        /** 实例计数（instanceCount），指定实例化绘制的实例数量。 */
+        instanceCount: number | undefined;
+        /** 是否投射阴影，控制图元是否向场景中投射阴影。 */
+        castShadows: boolean | undefined;
+        /** 是否接收阴影，控制图元是否接收来自其它物体的阴影。 */
+        receiveShadows: boolean | undefined;
+        /** 是否在最近视锥中执行绘制，用于多视锥场景下的优化。 */
+        executeInClosestFrustum: boolean | undefined;
+        /** 调试时显示包围盒，辅助调试包围体是否准确。 */
+        debugShowBoundingVolume: boolean | undefined;
+        /** 调试时显示重叠视锥数量，辅助调试视锥体裁剪。 */
+        debugOverlappingFrustums: number | undefined;
+        /** 仅用于拾取（pickOnly），开启后图元只参与拾取而不渲染。 */
+        pickOnly: boolean | undefined;
+        /** 半透明分类深度（depth for translucent classification），控制半透明物体的深度写入行为。 */
+        depthForTranslucentClassification: boolean | undefined;
+        /** 可视距离范围 [近裁剪距离, 近过渡距离, 远过渡距离, 远裁剪距离]，控制图元在远近处的淡入淡出。 */
+        viewDistanceRange: import('../../..').ReactiveVariable<[number, number, number, number] | undefined>;
+        /** 是否开启可视距离调试，辅助调试可视距离的裁剪效果。 */
+        viewDistanceDebug: boolean;
+        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<JsonValue>;
+        devTags: import('../../..').ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+    static readonly type: string;
+    static readonly defaultRenderState: {
+        depthTest: {
+            enabled: boolean;
+        };
+        cull: {
+            enabled: boolean;
+            face: number;
+        };
+        depthMask: boolean;
+        blending: {
+            enabled: boolean;
+            equationRgb: number;
+            equationAlpha: number;
+            functionSourceRgb: number;
+            functionSourceAlpha: number;
+            functionDestinationRgb: number;
+            functionDestinationAlpha: number;
+        };
+    };
+    static readonly defaultVertexShaderSource = "in vec3 position;\nin vec3 normal;\nin vec2 st;\nout vec3 v_normalEC;\nout vec2 v_st;\nvoid main()\n{\n    v_normalEC = czm_normal * normal; \n    v_st = st;\n    gl_Position = czm_modelViewProjection * vec4(position, 1.0);\n}\n";
+    static readonly defaultFragmentShaderSource = "in 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";
+    static readonly defaultUniformMap: CzmCustomPrimitiveUniformMapType;
+    static readonly defaultBoundingVolume: BoundingVolumeJsonType;
+    static readonly defaultAttribute: CzmAttributesType;
+    static readonly defaultIndexTypedArray: Uint16Array<ArrayBuffer>;
+    get attributesJson(): AttributesJsonType | undefined;
+    set attributesJson(value: AttributesJsonType | undefined);
+    get attributesJsonChanged(): import('../../..').Listener<[CzmAttributesType | undefined, CzmAttributesType | undefined]>;
+    get indexTypedArrayJson(): IndexJsonType | undefined;
+    set indexTypedArrayJson(value: IndexJsonType | undefined);
+    get indexTypedArrayJsonChanged(): import('../../..').Listener<[CzmIndexType | undefined, CzmIndexType | undefined]>;
+    private _attributes;
+    get attributes(): CzmAttributesType | undefined;
+    set attributes(value: CzmAttributesType | undefined);
+    get attributesChanged(): import('../../..').Listener<[CzmAttributesType | undefined, CzmAttributesType | undefined]>;
+    private _indexTypedArray;
+    get indexTypedArray(): CzmIndexType | undefined;
+    set indexTypedArray(value: CzmIndexType | undefined);
+    get indexTypedArrayChanged(): import('../../..').Listener<[CzmIndexType | undefined, CzmIndexType | undefined]>;
+    /**
+     * 构造一个 ESCustomPrimitive 实例。
+     * @param id 场景对象键值，可选。
+     */
+    constructor(id?: SceneObjectKey);
+    /**
+     * 设置 uniform 映射表，合并到当前 uniformMap 中。
+     * 注意：如果 value 中存在值为 null 的条目，则整个操作被忽略，不会执行合并。
+     * @param value 要合并的 uniform 映射表，键为 uniform 名称，值为对应的 uniform 对象。
+     */
+    setUniformMap(value: CzmCustomPrimitiveUniformMapType): void;
+    /**
+     * 设置局部包围球（LocalBoundingSphere）作为该图元的包围体。
+     * 用于视锥体裁剪和渲染排序优化。半径必须为正有限数，否则操作被忽略并输出警告。
+     * @param radius 包围球的半径，必须为正有限数（> 0）。
+     * @param center 包围球的球心坐标，默认为 [0, 0, 0]。
+     */
+    setLocalBoundingSphere(radius: number, center?: [number, number, number]): void;
+    /**
+     * 设置局部轴对齐包围盒（LocalAxisedBoundingBox）作为该图元的包围体。
+     * 用于视锥体裁剪和渲染排序优化。所有坐标值必须为有限数，否则操作被忽略并输出警告。
+     * @param min 包围盒最小顶点坐标，即三个轴向上的最小值 [xMin, yMin, zMin]。
+     * @param max 包围盒最大顶点坐标，即三个轴向上的最大值 [xMax, yMax, zMax]。
+     */
+    setLocalAxisedBoundingBox(min: [number, number, number], max: [number, number, number]): void;
+    static getMinMaxPosition: typeof getMinMaxPosition;
+    /**
+     * 从指定顶点属性的位置数据自动计算局部轴对齐包围盒（LocalAxisedBoundingBox）的最小/最大坐标。
+     * 属性数据必须是 Float32Array 类型且每个顶点包含 3 个分量（x, y, z）。
+     * 计算失败时返回 undefined 并输出警告。
+     * @param attributeName 顶点属性名称，默认为 'a_position'。
+     * @returns 包含 min 和 max 的包围盒对象，若计算失败则返回 undefined。
+     */
+    computeLocalAxisedBoundingBoxFromAttribute(attributeName?: string): {
+        min: [number, number, number];
+        max: [number, number, number];
+    } | undefined;
+    /**
+     * 获取该图元的属性列表，包含通用属性、屏幕像素控制、图元属性（着色器、渲染状态等）、
+     * 本地变换以及调试等各分组属性。
+     * @returns 包含分组后的属性列表对象。
+     */
+    getESProperties(): {
+        more: import('../../..').Property[];
+        defaultMenu: string;
+        location: import('../../..').Property[];
+        general: import('../../..').Property[];
+        basic: import('../../..').Property[];
+        dataSource: import('../../..').Property[];
+        coordinate: import('../../..').Property[];
+        style: import('../../..').Property[];
+    };
+}
+export interface ESCustomPrimitive extends UniteChanged<ReturnType<typeof ESCustomPrimitive.createDefaultProps>> {
+}

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

@@ -0,0 +1 @@
+export declare const attributesReadMe = "### \u9ED8\u8BA4\u7684\u9876\u70B9\u5C5E\u6027\n```\n{\n    position: {\n        typedArray: new Float32Array([0, 0, 0, 0, -1, 0, 1, -1, 0, 0, 0, 0, 1, -1, 0, 1, 0, 0]),\n        componentsPerAttribute: 3,\n    },\n    normal: {\n        typedArray: new Float32Array([0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1, 0, 0, 1]),\n        componentsPerAttribute: 3,\n    },\n    textureCoordinates: {\n        typedArray: new Float32Array([0, 1, 0, 0, 1, 0, 0, 1, 1, 0, 1, 1]),\n        componentsPerAttribute: 2,\n    }\n}\n```\n\n### Attributes\u7C7B\u578B\u89C4\u683C\n```\nexport type AttributeJsonType = {\n    typedArray: {\n        type: 'Float32Array' | 'Float64Array' | 'Int8Array' | 'Uint8Array' | 'Int16Array' | 'Uint16Array' | 'Int32Array' | 'Uint32Array';\n        array: number[];\n    };\n    componentsPerAttribute: 1 | 2 | 3 | 4;\n    usage?: Cesium.BufferUsage;\n    normalize?: boolean;\n}\n\nexport type AttributesJsonType = {\n    [k: string]: AttributeJsonType;\n}\n```\n";

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

@@ -0,0 +1 @@
+export declare const boundingVolumeReadMe = "### \u9ED8\u8BA4\u7684BoundingVolume\n```\ntype: 'LocalAxisedBoundingBox',\ndata: {\n    min: [0, -1, 0],\n    max: [1, 0, 0],\n}\n```\n\n### BoundingVolume\u7C7B\u578B\u89C4\u683C\n```\nexport type BoundingVolumeJsonType = {\n    type: 'BoundingSphere'; // BoundingSphere\u8868\u793A\u4E16\u754C\u5750\u6807\u7CFB\u4E0B\u7684\u5305\u56F4\u7403, center\u4E3A[\u7ECF\u5EA6, \u7EAC\u5EA6, \u9AD8\u5EA6], radius\u5355\u4F4D\u4E3A\u7C73\n    data: { center: [number, number, number], radius: number };\n} | {\n    type: 'LocalBoundingSphere'; // LocalBoundingSphere\u8868\u793A\u672C\u5730\u5750\u6807\u7CFB\u4E0B\u7684\u5305\u56F4\u7403, center\u672C\u5730\u5750\u6807\u7CFB\u4E0B\u7684[x, y, z]\uFF0C\u5355\u4F4D\u662F\u7C73, radius\u5355\u4F4D\u4E3A\u7C73\n    data: { center: [number, number, number], radius: number };\n} | {\n    type: 'BoundingRectangle'; // \u6307\u5B9A\u5730\u7403\u4E0A\u7684\u77E9\u5F62\u533A\u57DF\uFF0C\u5206\u522B\u7528\u6700\u897F\u4FA7\u7ECF\u5EA6\u3001\u6700\u5357\u4FA7\u7EAC\u5EA6\u3001\u6700\u4E1C\u4FA7\u7ECF\u5EA6\u3001\u6700\u5317\u4FA7\u7EAC\u5EA6\u6765\u8868\u793A\u4E00\u4E2A\u77E9\u5F62\u8303\u56F4\n    data: [west: number, south: number, east: number, north: number];\n} | {\n    type: 'LocalAxisedBoundingBox'; // \u672C\u5730\u5750\u6807\u7CFB\u4E0B\uFF0Cmin\u4E3A\u6700\u5C0F\u89D2\u70B9\uFF0Cmax\u4E3A\u6700\u5927\u89D2\u70B9\uFF0C\u63A8\u8350\u4F7F\u7528\u6B64\u79CD\u65B9\u5F0F\uFF01\n    data: {\n        min: [number, number, number];\n        max: [number, number, number];\n    };\n};\n```\n";