earthsdk3 3.3.0-beta.10 → 3.3.0-beta.12

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

@@ -0,0 +1,215 @@
+import { UniteChanged } from "xbsj-base";
+import { BooleanProperty, ColorProperty, EnumProperty, GroupProperty, NumberProperty } from "../../ESJTypes";
+import { ESGeoPolygon } from "./ESGeoPolygon";
+/**
+ * 定义ESJTexture类型，用于描述纹理信息。
+ * @typedef {Object} ESJTexture
+ * @property {string} url - 纹理图片的URL地址。
+ * @property {number} uDis - 纹理在u方向上的距离。
+ * @property {number} vDis - 纹理在v方向上的距离。
+ */
+export type ESJTexture = {
+    url: string;
+    uDis: number;
+    vDis: number;
+};
+/**
+ * ESPit 坑对象类
+ *
+ * 这个类用于创建和管理三维场景中的坑洞对象，继承自ESGeoPolygon。
+ * 坑对象具有深度、侧面纹理、底面纹理等属性，可以模拟真实世界中的坑洞效果。
+ *
+ * 核心功能：
+ * - 创建具有深度的多边形坑洞
+ * - 支持自定义坑的深度和插值距离
+ * - 可配置侧面和底面的纹理贴图
+ * - 支持透明度和样式设置
+ * - 默认关闭碰撞检测和拾取功能
+ *
+ * 使用示例：
+ *
+ * 构造函数参数：
+ * @param id - 可选的对象唯一标识符，用于在场景中识别和管理该坑对象
+ *
+ * 注意事项：
+ * - 该对象默认关闭碰撞检测和拾取功能，适用于视觉展示场景
+ * - 坑的深度和插值距离会影响渲染性能，建议根据实际需求合理设置
+ * - 纹理图片路径依赖于环境变量配置，请确保资源路径正确
+ */
+export declare class ESPit extends ESGeoPolygon {
+    /**
+     * 静态属性，用于注册类的类型信息。
+     *
+     * @readonly
+     * @type {any}
+     */
+    static readonly type: string;
+    /**
+     * 获取对象的类型名称。
+     * @override
+     * @returns {string} - 对象的类型名称。
+     */
+    get typeName(): string;
+    /**
+     * 获取对象的默认属性。
+     * @override
+     * @returns {any} - 对象的默认属性。
+     */
+    get defaultProps(): {
+        /**
+         * 坑深度（米） 默认10
+         */
+        depth: number;
+        /**
+         * 侧面图片纹理
+         * @type {ESJTexture}
+         */
+        sideImage: import("xbsj-base").ReactiveVariable<ESJTexture>;
+        /**
+         * 底面图片纹理
+         * @type {ESJTexture}
+         */
+        bottomImage: import("xbsj-base").ReactiveVariable<ESJTexture>;
+        /**
+         * 透明度 默认1
+         */
+        opacity: number;
+        /**
+         * 插值距离（米） 默认50
+         */
+        interpolation: number;
+        pointed: boolean;
+        pointStyle: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJPointStyle>;
+        stroked: boolean;
+        strokeStyle: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJStrokeStyle>;
+        filled: boolean;
+        fillStyle: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJFillStyle>;
+        points: import("xbsj-base").ReactiveVariable<[number, number, number][] | undefined>;
+        show: boolean;
+        collision: boolean;
+        allowPicking: boolean;
+        flyToParam: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJFlyToParam | undefined>;
+        flyInParam: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJFlyInParam | undefined>;
+        name: string;
+        ref: string | undefined;
+        extras: import("xbsj-base").ReactiveVariable<import("xbsj-base").JsonValue>;
+        devTags: import("xbsj-base").ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+    /**
+     * 构造函数，初始化ESPit对象。
+     * @param {string} [id] - 对象的ID，可选参数。
+     */
+    constructor(id?: string);
+    /**
+     * 静态属性，定义ESPit对象的默认参数。
+     *
+     * @override
+     * @type {Object}
+     * @property {number} depth - 坑的深度，单位为米，默认值为100。
+     * @property {ESJTexture} sideImage - 坑侧面的图片信息，包括URL和uv距离。
+     * @property {ESJTexture} bottomImage - 坑底面的图片信息，包括URL和uv距离。
+     * @property {number} opacity - 坑的透明度，默认值为1。
+     * @property {number} interpolation - 插值距离，单位为米，默认值为50。
+     */
+    static defaults: {
+        depth: number;
+        sideImage: ESJTexture;
+        bottomImage: ESJTexture;
+        opacity: number;
+        interpolation: number;
+        fillStyle: import("../../ESJTypes").ESJFillStyle;
+        strokeStyle: import("../../ESJTypes").ESJStrokeStyle;
+        filled: boolean;
+        stroked: boolean;
+        collision: boolean;
+        points: import("../../ESJTypes").ESJVector3DArray;
+        pointStyle: import("../../ESJTypes").ESJPointStyle;
+        pointed: boolean;
+        show: boolean;
+        allowPicking: boolean;
+        flyToParam: import("../../ESJTypes").ESJFlyToParam;
+        flyInParam: import("../../ESJTypes").ESJFlyInParam;
+    };
+    /**
+     * 获取ES属性信息。
+     * @override
+     * @returns {Object} - ES属性信息。
+     */
+    getESProperties(): {
+        basic: import("../../ESJTypes").Property[];
+        style: (BooleanProperty | NumberProperty | ColorProperty | GroupProperty | EnumProperty<string>)[];
+        coordinate: import("../../ESJTypes").Property[];
+        defaultMenu: string;
+        general: import("../../ESJTypes").Property[];
+        dataSource: import("../../ESJTypes").Property[];
+        location: import("../../ESJTypes").Property[];
+    };
+    /**
+     * 获取对象的属性信息。
+     * @override
+     * @param {string} language - 语言信息。
+     * @returns {any[]} - 对象的属性信息数组。
+     */
+    getProperties(language: string): import("../../ESJTypes").Property[];
+}
+/**
+ * ESPit类的命名空间，包含创建默认属性的方法。
+ */
+export declare namespace ESPit {
+    /**
+     * 创建ESPit对象的默认属性。
+     * @returns {Object} - ESPit对象的默认属性。
+     */
+    const createDefaultProps: () => {
+        /**
+         * 坑深度（米） 默认10
+         */
+        depth: number;
+        /**
+         * 侧面图片纹理
+         * @type {ESJTexture}
+         */
+        sideImage: import("xbsj-base").ReactiveVariable<ESJTexture>;
+        /**
+         * 底面图片纹理
+         * @type {ESJTexture}
+         */
+        bottomImage: import("xbsj-base").ReactiveVariable<ESJTexture>;
+        /**
+         * 透明度 默认1
+         */
+        opacity: number;
+        /**
+         * 插值距离（米） 默认50
+         */
+        interpolation: number;
+        pointed: boolean;
+        pointStyle: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJPointStyle>;
+        stroked: boolean;
+        strokeStyle: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJStrokeStyle>;
+        filled: boolean;
+        fillStyle: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJFillStyle>;
+        points: import("xbsj-base").ReactiveVariable<[number, number, number][] | undefined>;
+        show: boolean;
+        collision: boolean;
+        allowPicking: boolean;
+        flyToParam: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJFlyToParam | undefined>;
+        flyInParam: import("xbsj-base").ReactiveVariable<import("../../ESJTypes").ESJFlyInParam | undefined>;
+        name: string;
+        ref: string | undefined;
+        extras: import("xbsj-base").ReactiveVariable<import("xbsj-base").JsonValue>;
+        devTags: import("xbsj-base").ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+}
+/**
+ * 定义ESPit类的扩展接口，继承自UniteChanged。
+ */
+export interface ESPit extends UniteChanged<ReturnType<typeof ESPit.createDefaultProps>> {
+}
+//# sourceMappingURL=ESPit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ESPit.d.ts","sourceRoot":"","sources":["../../../../src/ESObjects/general/ESPit.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,YAAY,EAAE,MAAM,WAAW,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAgB,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE3H,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,KAAM,SAAQ,YAAY;IACnC;;;;;OAKG;IACH,gBAAyB,IAAI,SAA2H;IAExJ;;;;OAIG;IACH,IAAa,QAAQ,WAAsB;IAE3C;;;;OAIG;IACH,IAAa,YAAY;QAuGrB;;WAEG;;QAEH;;;WAGG;;QAEH;;;WAGG;;QAEH;;WAEG;;QAEH;;WAEG;;;;;;;;;;;;;;;;;;;;;MA3H2D;IAElE;;;OAGG;gBACS,EAAE,CAAC,EAAE,MAAM;IAUvB;;;;;;;;;;OAUG;IACH,OAAgB,QAAQ;;mBAGuH,UAAU;qBACN,UAAU;;;;;;;;;;;;;;;MAG5J;IAED;;;;OAIG;IACM,eAAe;;;;;;;;;IAgCxB;;;;;OAKG;IACM,aAAa,CAAC,QAAQ,EAAE,MAAM;CAY1C;AAED;;GAEG;AACH,yBAAiB,KAAK,CAAC;IACnB;;;OAGG;IACI,MAAM,kBAAkB;QAE3B;;WAEG;;QAEH;;;WAGG;;QAEH;;;WAGG;;QAEH;;WAEG;;QAEH;;WAEG;;;;;;;;;;;;;;;;;;;;;KAEL,CAAA;CACL;AAKD;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,KAAK,CAAC,kBAAkB,CAAC,CAAC;CAAI"}

package/dist/types/ESObjects/general/ESPlayer/AbsolutePlayer.d.ts

@@ -0,0 +1,88 @@
+import { Destroyable, UniteChanged } from "xbsj-base";
+import { Player } from "../../../utils";
+/**
+ * AbsolutePlayer 绝对播放器类，类用于管理和控制一个播放器实例，提供绝对时间控制功能。
+ * 该类继承自 Destroyable 类，确保资源可以被正确释放。
+ *
+ * 核心功能包括：
+ * - 管理播放器实例的生命周期。
+ * - 提供播放比例的获取和设置。
+ * - 监听和更新播放器的持续时间。
+ * - 绑定播放器的 playing、loop 和 speed 属性到当前实例的对应属性。
+ * - 同步播放器的当前时间与实例的当前时间。
+ *
+ * 使用示例：
+ *
+ * 构造函数参数：
+ * 无特殊参数，构造函数用于初始化 AbsolutePlayer 实例。
+ *
+ * 特殊使用限制或潜在的副作用：
+ * - 在使用过程中，需要确保正确管理资源，避免内存泄漏。
+ * - 播放器的持续时间会根据 startTime 和 stopTime 动态更新，确保这两个属性的正确设置。
+ */
+export declare class AbsolutePlayer extends Destroyable {
+    /**
+     * 私有播放器实例，使用 disposeVar 方法进行管理，确保在销毁时正确处理。
+     */
+    private _player;
+    /**
+     * 获取播放器实例。
+     * @returns 播放器实例。
+     */
+    get player(): Player;
+    /**
+     * 获取播放比例。
+     * @returns 播放比例。
+     */
+    get ratio(): number;
+    /**
+     * 获取播放比例变化的事件。
+     * @returns 播放比例变化的事件。
+     */
+    get ratioChanged(): import("xbsj-base").Listener<[number, number]>;
+    /**
+     * 设置播放比例。
+     * @param value - 要设置的播放比例值。
+     */
+    set ratio(value: number);
+    /**
+     * 构造函数，初始化绝对播放器。
+     */
+    constructor();
+}
+/**
+ * 绝对播放器的命名空间，包含创建默认属性的方法。
+ */
+export declare namespace AbsolutePlayer {
+    /**
+     * 创建绝对播放器的默认属性。
+     * @returns 包含默认属性的对象。
+     */
+    const createDefaultProps: () => {
+        /**当前时间 */
+        currentTime: number | undefined;
+        /**开始时间 */
+        startTime: number | undefined;
+        /**结束时间 */
+        stopTime: number | undefined;
+        /** 是否正在播放 */
+        playing: boolean | undefined;
+        /** 是否循环播放 */
+        loop: boolean | undefined;
+        /** 播放速度 */
+        speed: number | undefined;
+        name: string;
+        ref: string | undefined;
+        extras: import("xbsj-base").ReactiveVariable<import("xbsj-base").JsonValue>;
+        devTags: import("xbsj-base").ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+}
+/**
+ * 扩展 AbsolutePlayer 接口，使其包含 UniteChanged 类型，返回值为 createDefaultProps 方法的返回类型。
+ */
+export interface AbsolutePlayer extends UniteChanged<ReturnType<typeof AbsolutePlayer.createDefaultProps>> {
+}
+//# sourceMappingURL=AbsolutePlayer.d.ts.map

package/dist/types/ESObjects/general/ESPlayer/AbsolutePlayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbsolutePlayer.d.ts","sourceRoot":"","sources":["../../../../../src/ESObjects/general/ESPlayer/AbsolutePlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,WAAW,EAAoB,YAAY,EAAE,MAAM,WAAW,CAAC;AAErF,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC3C;;OAEG;IACH,OAAO,CAAC,OAAO,CAAiC;IAEhD;;;OAGG;IACH,IAAI,MAAM,WAA2B;IAErC;;;OAGG;IACH,IAAI,KAAK,IAYQ,MAAM,CAZmB;IAE1C;;;OAGG;IACH,IAAI,YAAY,mDAAwC;IAExD;;;OAGG;IACH,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAAiC;IAExD;;OAEG;;CA0CN;AAED;;GAEG;AACH,yBAAiB,cAAc,CAAC;IAC5B;;;OAGG;IACI,MAAM,kBAAkB;QAE3B,UAAU;qBACgB,MAAM,GAAG,SAAS;QAC5C,UAAU;mBACc,MAAM,GAAG,SAAS;QAC1C,UAAU;kBACa,MAAM,GAAG,SAAS;QACzC,aAAa;iBACS,OAAO,GAAG,SAAS;QACzC,aAAa;cACM,OAAO,GAAG,SAAS;QACtC,WAAW;eACS,MAAM,GAAG,SAAS;;;;;;;;KACxC,CAAC;CACN;AAKD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,kBAAkB,CAAC,CAAC;CAAI"}

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

@@ -0,0 +1,135 @@
+import { UniteChanged } from "xbsj-base";
+import { ESSceneObject } from "../../base";
+import { AbsolutePlayer } from "./AbsolutePlayer";
+/**
+ * ESPlayer 类继承自 ESSceneObject，用于表示和控制一个播放器对象。
+ * 该类提供了播放器的核心功能，如播放、暂停、循环播放、设置播放速度等。
+ * 通过 AbsolutePlayer 实例来实现播放器的具体功能，并与 ESPlayer 的属性进行同步。
+ *
+ * 核心功能包括：
+ * - 获取和设置播放进度比例（ratio）
+ * - 获取播放进度比例变化的事件（ratioChanged）
+ * - 获取和设置播放器的各种属性，如 currentTime、startTime、stopTime、playing、loop、speed
+ * - 通过 getProperties 方法获取播放器相关的属性数组
+ *
+ * 使用示例：
+ *
+ * 构造函数参数：
+ * @param id - 可选的实例 ID，用于唯一标识一个 ESPlayer 对象。
+ *
+ * 特殊使用限制或潜在的副作用：
+ * - 在设置播放进度比例时，如果设置的值超出播放范围，可能会产生未定义的行为。
+ * - 在绑定属性时，确保 AbsolutePlayer 的属性与 ESPlayer 的属性同步，以避免数据不一致。
+ */
+export declare class ESPlayer extends ESSceneObject {
+    /**
+     * 静态属性，用于注册 ESPlayer 类型，包含中文名称、标签和描述信息。
+     */
+    static readonly type: string;
+    /**
+     * 获取类型名称，固定返回 'ESPlayer'。
+     */
+    get typeName(): string;
+    /**
+     * 重写默认属性，返回 ESPlayer 创建的默认属性。
+     */
+    get defaultProps(): {
+        /**当前时间*/
+        currentTime: number;
+        /**开始时间*/
+        startTime: number;
+        /**结束时间*/
+        stopTime: number;
+        /**是否播放*/
+        playing: boolean;
+        /**是否循环*/
+        loop: boolean;
+        /**播放速度*/
+        speed: number;
+        name: string;
+        ref: string | undefined;
+        extras: import("xbsj-base").ReactiveVariable<import("xbsj-base").JsonValue>;
+        devTags: import("xbsj-base").ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+    /**
+     * 静态默认属性，包含播放器的初始状态和时间信息。
+     */
+    static defaults: {
+        currentTime: number;
+        startTime: number;
+        stopTime: number;
+        playing: boolean;
+        loop: boolean;
+        speed: number;
+    };
+    /**
+     * 私有属性，存储一个 AbsolutePlayer 实例。
+     */
+    private _absolutePlayer;
+    /**
+     * 获取 AbsolutePlayer 实例。
+     */
+    get absolutePlayer(): AbsolutePlayer;
+    /**
+     * 获取播放进度比例。
+     */
+    get ratio(): number;
+    /**
+     * 获取播放进度比例变化的事件。
+     */
+    get ratioChanged(): import("xbsj-base").Listener<[number, number]>;
+    /**
+     * 设置播放进度比例。
+     * @param value - 要设置的播放进度比例值。
+     */
+    set ratio(value: number);
+    /**
+     * 构造函数，初始化 ESPlayer 实例。
+     * @param id - 可选的实例 ID。
+     */
+    constructor(id?: string);
+    /**
+     * 重写获取属性的方法，返回包含播放器相关属性的数组。
+     * @param language - 可选的语言参数。
+     */
+    getProperties(language?: string): import("../../../ESJTypes").Property[];
+}
+/**
+ * ESPlayer 命名空间，包含创建默认属性的方法。
+ */
+export declare namespace ESPlayer {
+    /**
+     * 创建 ESPlayer 的默认属性。
+     * @returns 包含默认属性的对象。
+     */
+    const createDefaultProps: () => {
+        /**当前时间*/
+        currentTime: number;
+        /**开始时间*/
+        startTime: number;
+        /**结束时间*/
+        stopTime: number;
+        /**是否播放*/
+        playing: boolean;
+        /**是否循环*/
+        loop: boolean;
+        /**播放速度*/
+        speed: number;
+        name: string;
+        ref: string | undefined;
+        extras: import("xbsj-base").ReactiveVariable<import("xbsj-base").JsonValue>;
+        devTags: import("xbsj-base").ReactiveVariable<string[] | undefined>;
+        execOnceFuncStr: string | undefined;
+        updateFuncStr: string | undefined;
+        toDestroyFuncStr: string | undefined;
+    };
+}
+/**
+ * 扩展 ESPlayer 接口，使其包含默认属性变化的类型。
+ */
+export interface ESPlayer extends UniteChanged<ReturnType<typeof ESPlayer.createDefaultProps>> {
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/ESObjects/general/ESPlayer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ESObjects/general/ESPlayer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,YAAY,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAS,SAAQ,aAAa;IACvC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,SAAyH;IAE7I;;OAEG;IACH,IAAI,QAAQ,WAAyB;IAErC;;OAEG;IACH,IAAa,YAAY;QAyFrB,SAAS;;QAET,SAAS;;QAET,SAAS;;QAET,SAAS;;QAET,SAAS;;QAET,SAAS;;;;;;;;;MAnGwD;IAErE;;OAEG;IACH,OAAgB,QAAQ;;;;;;;MAQtB;IAEF;;OAEG;IACH,OAAO,CAAC,eAAe,CAAiC;IAExD;;OAEG;IACH,IAAI,cAAc,mBAAmC;IAErD;;OAEG;IACH,IAAI,KAAK,IAWQ,MAAM,CAX2B;IAElD;;OAEG;IACH,IAAI,YAAY,mDAAgD;IAEhE;;;OAGG;IACH,IAAI,KAAK,CAAC,KAAK,EAAE,MAAM,EAAyC;IAEhE;;;OAGG;gBACS,EAAE,CAAC,EAAE,MAAM;IAcvB;;;OAGG;IACM,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM;CAc3C;AAED;;GAEG;AACH,yBAAiB,QAAQ,CAAC;IACtB;;;OAGG;IACI,MAAM,kBAAkB;QAE3B,SAAS;;QAET,SAAS;;QAET,SAAS;;QAET,SAAS;;QAET,SAAS;;QAET,SAAS;;;;;;;;;KAEX,CAAC;CACN;AAKD;;GAEG;AACH,MAAM,WAAW,QAAS,SAAQ,YAAY,CAAC,UAAU,CAAC,OAAO,QAAQ,CAAC,kBAAkB,CAAC,CAAC;CAAI"}