@baidumap/mapv-three 1.0.0

package/dist/types/threemap/natural/EmptySky.d.ts

@@ -0,0 +1,292 @@
+/**
+ * 空白天空，仅提供基本的天空和光照系统，包含日光、环境光和太阳位置控制，不包含天空背景的渲染。
+ * 可以通过设置时间来改变光照方向和强度，模拟一天中不同时间的光照效果。
+ *
+ * 如果想要使用背景效果更好的天空，可以使用{@link DefaultSky}或者{@link DynamicSky}
+ *
+ * @category Natural
+ * @example
+ * ```javascript
+ * // 创建空白天空
+ * const sky = engine.add(new mapvthree.EmptySky());
+ *
+ * // 设置时间为中午12点
+ * sky.time = 3600 * 12;
+ * ```
+ */
+export class EmptySky {
+    /**
+     * 创建一个空白天空实例
+     * 初始化光照系统，包括太阳光源和环境
+     * @param {object} options
+     * @param {number} options.time 初始时间， 单位秒。例如：3600 * 15.5代表15点30分
+     */
+    constructor(options?: {
+        time: number;
+    });
+    /**
+     * 标识为EmptySky对象
+     * @type {boolean}
+     * @readonly
+     */
+    readonly isEmptySky: boolean;
+    /** @private */ private _addDefaultEnvMap;
+    /** @private */ private _time;
+    /** @private */ private _timeRatio;
+    /** @private */ private _startTimestamp;
+    /** @private */ private _timeAnimation;
+    /** @private */ private _timeAnimationSpeed;
+    /** @private */ private _skyLightIntensity;
+    /** @private */ private _sunLightIntensity;
+    /** @private */ private _skyLightAttenuationRatio;
+    /** @private */ private _sunIntensityBias;
+    /** @private */ private _sunIntensityScale;
+    /** @private */ private _envLightIntensity;
+    /** @private */ private _weather;
+    /** @private */ private _timeChangedListeners;
+    /** @private */ private _sunDirection;
+    /** @private */ private _localSunDirection;
+    /** @private */ private _sunLightColorDay;
+    /** @private */ private _sunLightColorSunset;
+    /** @private */ private _sunLightColorCurrent;
+    /** @private */ private _sunRadian;
+    /** @private */ private _skyLightColorDay;
+    /** @private */ private _skyLightColorNight;
+    /** @private */ private _groundLightColorDay;
+    /** @private */ private _groundLightColorNight;
+    /** @private */ private _lightNeedsUpdate;
+    /** @private */ private _sunNeedsUpdate;
+    /** @private */
+    private _affectWorld;
+    sunLight: any;
+    skyLight: any;
+    renderOrder: number;
+    _sunLightGradientColorLerp: GradientColorLerp;
+    /**
+     * 设置环境光强度
+     * @type {number}
+     * @internal
+     */
+    set envLightIntensity(value: number);
+    /**
+     * 环境光强度
+     * @type {number}
+     * @internal
+     */
+    get envLightIntensity(): number;
+    /**
+     * 添加到引擎后的初始化
+     * @protected
+     * @param {Engine} engine 引擎实例
+     */
+    protected afterAddToEngine(engine: Engine): void;
+    engine: any;
+    /**
+     * 设置时间，更新太阳光源位置与光照强度，单位是秒<br />
+     * 通常可以设置成小时*3600，比如 12 * 3600 表示中午12点
+     * @type {number}
+     * @example
+     * ```javascript
+     * // 设置时间为早上8点
+     * sky.time = 3600 * 8;
+     *
+     * // 设置时间为下午6点
+     * sky.time = 3600 * 18;
+     * ```
+     */
+    set time(time: number);
+    /**
+     * 获取当前设置的时间
+     * @type {number}
+     */
+    get time(): number;
+    /**
+     * 从引擎移除前的清理
+     * @protected
+     * @param {Engine} engine 引擎实例
+     */
+    protected beforeRemoveFromEngine(engine: Engine): void;
+    /**
+     * 更新时间
+     * @protected
+     */
+    protected tickTime(): void;
+    /**
+     * 每次渲染时，更新时间和光照
+     * @protected
+     */
+    protected onBeforeScenePrepareRender(): void;
+    _timeChanged: boolean | undefined;
+    /**
+     * 根据太阳光的高度来更新太阳光和天空光的光照强度和颜色
+     * @protected
+     */
+    protected updateLight(): void;
+    /**
+     * 更新太阳阴影
+     * @protected
+     */
+    protected updateSunLightShadowCamera: () => void;
+    /**
+     * 添加时间变化后需要执行的监听函数listener
+     * @param {Function} listener
+     */
+    addTimeChangedListener(listener: Function): void;
+    /**
+     * 从时间变化后需要执行的监听函数的列表中移除listener
+     * @param {Function} listener
+     */
+    removeTimeChangedListener(listener: Function): void;
+    /**
+     * 时间变化后的回调函数
+     * @param {number} time 时间，单位ms
+     * @internal
+     */
+    onTimeChanged(time: number): void;
+    /**
+     * 天气变化后的回调函数
+     * @param {string} weather 天气
+     * @internal
+     */
+    onWeatherChanged(weather: string): void;
+    /**
+     * 释放资源
+     */
+    dispose(): void;
+    /**
+     * 设置当前天气
+     * @type {string}
+     * @internal
+     */
+    set weather(weather: string);
+    /**
+     * 获取当前天气设置
+     * @type {string}
+     * @internal
+     */
+    get weather(): string;
+    /**
+     * 设置是否自动更新时间
+     * @type {boolean}
+     * @internal
+     * @example
+     * ```javascript
+     * // 启用自动时间更新
+     * sky.timeAnimation = true;
+     *
+     * // 禁用自动时间更新
+     * sky.timeAnimation = false;
+     * ```
+     */
+    set timeAnimation(timeAnimation: boolean);
+    get timeAnimation(): boolean;
+    /**
+     * 自动更新时间的速度，代表1毫秒等于实际的多少秒
+     * @type {number}
+     * @internal
+     * @example
+     * ```javascript
+     * // 设置1毫秒等于实际1秒
+     * sky.timeAnimationSpeed = 1;
+     *
+     * // 设置1毫秒等于实际0.5秒
+     * sky.timeAnimationSpeed = 0.5;
+     * ```
+     */
+    set timeAnimationSpeed(timeAnimationSpeed: number);
+    get timeAnimationSpeed(): number;
+    /**
+     * 太阳光的强度偏移，在计算太阳光强度时添加该偏移量的大小
+     * @type {number}
+     * @internal
+     * @example
+     * ```javascript
+     * // 增加太阳光强度
+     * sky.sunIntensityBias = 0.5;
+     *
+     * // 减少太阳光强度
+     * sky.sunIntensityBias = -0.5;
+     * ```
+     */
+    set sunIntensityBias(value: number);
+    get sunIntensityBias(): number;
+    /**
+     * 太阳光强度的缩放值
+     * @type {number}
+     * @internal
+     * @example
+     * ```javascript
+     * // 增加太阳光强度
+     * sky.sunIntensityScale = 1.2;
+     *
+     * // 减少太阳光强度
+     * sky.sunIntensityScale = 0.8;
+     * ```
+     */
+    set sunIntensityScale(value: number);
+    get sunIntensityScale(): number;
+    /**
+     * 太阳光强度
+     * @type {number}
+     * @internal
+     * @example
+     * ```javascript
+     * // 设置强光照
+     * sky.sunLightIntensity = 5.5;
+     *
+     * // 设置弱光照
+     * sky.sunLightIntensity = 2.0;
+     * ```
+     */
+    set sunLightIntensity(value: number);
+    get sunLightIntensity(): number;
+    /**
+     * 天光强度
+     * @type {number}
+     * @internal
+     * @example
+     * ```javascript
+     * // 设置强环境光
+     * sky.skyLightIntensity = 0.5;
+     *
+     * // 设置弱环境光
+     * sky.skyLightIntensity = 0.1;
+     * ```
+     */
+    set skyLightIntensity(value: number);
+    get skyLightIntensity(): number;
+    /**
+     * 天空光衰减比，该值用于定义天空光最小的衰减值
+     * @type {number}
+     * @internal
+     * @example
+     * ```javascript
+     * // 设置较大的衰减比
+     * sky.skyLightAttenuationRatio = 0.5;
+     *
+     * // 设置较小的衰减比
+     * sky.skyLightAttenuationRatio = 0.1;
+     * ```
+     */
+    set skyLightAttenuationRatio(value: number);
+    get skyLightAttenuationRatio(): number;
+    /**
+     * 太阳光的位置
+     * @type {Vector3}
+     * @internal
+     */
+    get sunDirection(): Vector3;
+    /**
+     * 太阳光的位置
+     * @type {Vector3}
+     * @internal
+     */
+    get localSunDirection(): Vector3;
+    /**
+     * 天空颜色是否影响场景颜色
+     * @type {boolean}
+     * @internal
+     */
+    get affectWorld(): boolean;
+}
+import { GradientColorLerp } from '../../util/GradientColorLerp';

package/dist/types/threemap/natural/Rain.d.ts

@@ -0,0 +1,10 @@
+export class Rain {
+    constructor(renderer: any, camera: any);
+    _clock: any;
+    _system: any;
+    _emitter: any;
+    update: () => void;
+    createRain: () => any;
+    createEmitter: () => any;
+    dispose(): void;
+}

package/dist/types/threemap/natural/Snow.d.ts

@@ -0,0 +1,12 @@
+export class Snow {
+    constructor(renderer: any, camera: any);
+    _renderer: any;
+    _camera: any;
+    _clock: any;
+    _system: any;
+    _emitter: any;
+    update: () => void;
+    createSnow: () => any;
+    createEmitter: () => any;
+    dispose(): void;
+}

package/dist/types/threemap/natural/SphereSky.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 球体天空盒
+ */
+export class SphereSky extends EmptySky {
+    constructor(options?: {});
+    isSphereSky: boolean;
+    /**
+     * @internal
+     * cube cubeuv
+     */
+    _textureIsCube: boolean;
+    /** @internal */ _textureIsHDR: boolean;
+    /** @internal */ _textureURL: null;
+    /**
+     * @internal
+     * 仅立方体贴图使用
+     */
+    _textureNames: null;
+    /** @internal */ _isVerticalTexture: null;
+    /** @internal */ _mesh: null;
+    /** @internal */ _material: null;
+    /** @internal */ _sphereGeometry: null;
+    /** @internal */ _engine: null;
+    /** @protected */
+    protected afterAddToEngine(engine: any): void;
+    createMaterial(): any;
+    /** @protected */
+    protected onBeforeScenePrepareRender(engine: any, scene: any, camera: any): void;
+}
+import { EmptySky } from './EmptySky';

package/dist/types/threemap/natural/StaticSky.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 静态天空，预置了常见的天气状态和时段状态
+ * ![](media://static_sky.png)
+ */
+export class StaticSky extends CustomStaticSky {
+    isStaticSky: boolean;
+    /** @internal */ _phase: string;
+    /** @internal */ _lastPhase: null;
+    /** @internal */ _lastWeather: null;
+    /** @internal */ _nightStartTime: number;
+    /** @internal */ _nightEndTime: number;
+    /** @internal */ _afternoonTime: number;
+    /** @internal */ _duskTime: number;
+    /**
+     * 天气变化时加载不同的纹理贴图用于天空
+     */
+    onWeatherChanged(weather: any): void;
+    /**
+     * 加载纹理用于天空，加载的纹理由天气和时间决定
+     */
+    loadSkyTexture(): void;
+}
+import { CustomStaticSky } from './CustomStaticSky';

package/dist/types/threemap/natural/VerticalGradientSky.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ![](media://vertical_gradient.png)
+ */
+export class VerticalGradientSky extends SphereSky {
+    createMaterial(): VerticalGradientSkyMaterial;
+    set gradients(gradients: any);
+    /**
+     * 垂直天空颜色渐变
+     */
+    get gradients(): any;
+}
+import { SphereSky } from './SphereSky';
+import { VerticalGradientSkyMaterial } from '../../threejs/materials/natural/VerticalGradientSkyMaterial';

package/dist/types/threemap/overlay/DOMOverlay.d.ts

@@ -0,0 +1,199 @@
+/**
+ * DOM覆盖物基类，用于在地图上添加HTML元素。支持自定义位置、偏移和拖拽功能。
+ *
+ * @category Objects
+ * @example
+ * ```javascript
+ * // 创建一个基础DOM覆盖物
+ * const overlay = engine.add(new mapvthree.DOMOverlay({
+ *     point: [116.404, 39.915, 0],
+ *     dom: document.createElement('div'),
+ *     offset: [0, 0],
+ *     enableDragging: true
+ * }));
+ *
+ * // 创建一个HTML字符串的覆盖物
+ * const htmlOverlay = engine.add(new mapvthree.DOMOverlay({
+ *     point: [116.404, 39.915, 0],
+ *     dom: '<div class="custom-overlay">Hello World</div>'
+ * }));
+ * ```
+ */
+export class DOMOverlay {
+    /**
+     * 创建DOM覆盖物
+     * @param {Object} parameters 配置参数
+     * @param {HTMLElement|string} parameters.dom DOM元素或HTML字符串
+     * @param {Array<number>} [parameters.point] 位置坐标 [经度,纬度,高度]
+     * @param {Array<number>} [parameters.offset=[0,0]] 像素偏移量, 默认值：[0, 0]
+     * @param {boolean} [parameters.visible=true] 是否可见，默认值：true
+     * @param {boolean} [parameters.enableDragging=false] 是否可拖拽，默认值：false
+     * @param {string} [parameters.className] CSS类名
+     */
+    constructor(parameters?: {
+        dom: HTMLElement | string;
+        point?: number[] | undefined;
+        offset?: number[] | undefined;
+        visible?: boolean | undefined;
+        enableDragging?: boolean | undefined;
+        className?: string | undefined;
+    });
+    /** @private */ private _container;
+    /** @private */ private _point;
+    /** @private */ private _dom;
+    /** @private */ private _div;
+    /** @private */ private _visible;
+    /** @private */ private _offset;
+    /** @private */ private _stopPropagation;
+    /** @private */ private _enableDragging;
+    isDOMOverlay: boolean;
+    parameters: {
+        dom: HTMLElement | string;
+        point?: number[] | undefined;
+        offset?: number[] | undefined;
+        visible?: boolean | undefined;
+        enableDragging?: boolean | undefined;
+        className?: string | undefined;
+    };
+    /**
+     * @internal
+     * 添加overlay Dom
+     * 1.maptype 为bmapgl时，container.children为undefined;2.maptype 为mapbox时，存在overlay Dom，但层级为最底层
+     */
+    afterAddToEngine(engine: any): void;
+    engine: any;
+    /**
+     * 设置DOM元素
+     * @param {HTMLElement|string} value DOM元素或HTML字符串
+     * @example
+     * ```javascript
+     * const dom = document.createElement('div');
+     * dom.className = 'custom-overlay';
+     * dom.innerHTML = 'Hello World';
+     * overlay.dom = dom;
+     * ```
+     * @example
+     * ```javascript
+     * const domString = `
+     *     <div class="dom-overlay-custom">
+     *         <div class="overlay-body">
+     *             <div class="overlay-title">Hello World</div>
+     *         </div>
+     *      </div>
+     * `
+     * overlay.dom = domString
+     * ```
+     */
+    set dom(value: HTMLElement | string);
+    /**
+     * 获取DOM元素
+     * @type {HTMLElement}
+    */
+    get dom(): HTMLElement;
+    /**
+     * 设置坐标位置
+     * @param {Array<number>} value 坐标位置 [经度, 纬度, 高度]
+     * @example
+     * ```javascript
+     * overlay.point = [116.404, 39.915, 0];
+     * ```
+     */
+    set point(value: Array<number>);
+    /**
+     * 坐标位置 [经度, 纬度, 高度]
+     * @type {Array<number>}
+     */
+    get point(): Array<number>;
+    /**
+     * 设置像素偏移量
+     * @param {Array<number>} value 像素偏移量 [x, y]
+     * @example
+     * ```javascript
+     * overlay.offset = [10, 10];
+     * ```
+     */
+    set offset(value: Array<number>);
+    /**
+     * 像素偏移量 [x, y]，默认值：[0, 0]
+     * @type {Array<number>}
+     */
+    get offset(): Array<number>;
+    /**
+     * 设置CSS类名
+     * @param {string} className CSS类名
+     * @example
+     * ```javascript
+     * overlay.className = 'custom-overlay';
+     * ```
+     */
+    set className(className: string);
+    /**
+     * CSS类名
+     * @type {string}
+     */
+    get className(): string;
+    /**
+     * 设置是否启用拖拽
+     * @param {boolean} value 是否启用拖拽
+     * @example
+     * ```javascript
+     * overlay.enableDragging = true;
+     * ```
+     */
+    set enableDragging(value: boolean);
+    /**
+     * 是否启用拖拽，默认值：false
+     * @type {boolean}
+     */
+    get enableDragging(): boolean;
+    /**
+     * 设置是否可见
+     * @param {boolean} value 是否可见
+     * @example
+     * ```javascript
+     * overlay.visible = false;
+     * ```
+     */
+    set visible(value: boolean);
+    /**
+     * 是否可见，默认值：true
+     * @type {boolean}
+     */
+    get visible(): boolean;
+    beforeRemoveFromEngine(engine: any): void;
+    /**
+     * @internal
+     * 初始化dom
+     */
+    initDom(): string | HTMLElement | undefined;
+    afterInit(): void;
+    onBeforeScenePrepareRender(engine: any, scene: any, camera: any): void;
+    camera: any;
+    renderer: any;
+    _screenPos: any;
+    onDispose(): void;
+    /**
+     * 内存释放
+     */
+    dispose(): void;
+    /**
+     * 设置是否阻止事件冒泡
+     * @param {boolean} value 是否阻止事件冒泡
+     * @example
+     * ```javascript
+     * overlay.stopPropagation = true;
+     * ```
+     */
+    set stopPropagation(value: boolean);
+    /**
+     * 是否阻止事件冒泡，默认值：false
+     * @type {boolean}
+     */
+    get stopPropagation(): boolean;
+    _className: any;
+    handleMouseDown: (e: any) => void;
+    _sub: any;
+    handleMouseUp: (e: any) => void;
+    handleMouseMove: (e: any) => void;
+    handleWheel: (e: any) => void;
+}

package/dist/types/threemap/overlay/Marker.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 图片标注覆盖物，用于在地图上添加图片标记。继承自{@link DOMOverlay}。
+ *
+ * @category Objects
+ * @example
+ * ```javascript
+ * // 创建一个图片标注
+ * const marker = engine.add(new mapvthree.Marker({
+ *     point: [116.404, 39.915, 0],
+ *     icon: 'path/to/icon.png',
+ *     width: 32,
+ *     height: 32,
+ *     offset: [0, -16]  // 将锚点设置到图片底部中心
+ * }));
+ * ```
+ */
+export class Marker extends DOMOverlay {
+    /**
+     * 创建图片标注
+     * @param {Object} parameters 配置参数
+     * @param {string} [parameters.icon='https://webmap0.bdimg.com/image/api/marker_red.png'] 图标URL
+     * @param {number} [parameters.width=25] 图标宽度, 默认值：25
+     * @param {number} [parameters.height=25] 图标高度, 默认值：25
+     * @param {Array<number>} [parameters.point] 位置坐标 [经度,纬度,高度], 默认值：[0,0,0]
+     * @param {Array<number>} [parameters.offset=[0,0]] 像素偏移量, 默认值：[0,0]
+     * @param {boolean} [parameters.enableDragging=false] 是否可拖拽, 默认值：false
+     */
+    constructor(parameters?: {
+        icon?: string | undefined;
+        width?: number | undefined;
+        height?: number | undefined;
+        point?: number[] | undefined;
+        offset?: number[] | undefined;
+        enableDragging?: boolean | undefined;
+    });
+    /** @private */ private _icon;
+    /** @private */ private _width;
+    /** @private */ private _height;
+    isMarker: boolean;
+    initDom(): HTMLImageElement;
+    /**
+     * 设置图片路径
+     * @param {string} value 图片路径
+     * @example
+     * ```javascript
+     * marker.icon = 'path/to/icon.png';
+     * ```
+     */
+    set icon(value: string);
+    /**
+     * 获取图片路径
+     * @returns {string} 图片路径
+     */
+    get icon(): string;
+    /**
+     * 设置图片宽度
+     * @param {number} value 图片宽度
+     */
+    set width(value: number);
+    /**
+     * 获取图片宽度
+     * @returns {number} 图片宽度
+     */
+    get width(): number;
+    /**
+     * 设置图片高度
+     * @param {number} value 图片高度
+     */
+    set height(value: number);
+    /**
+     * 获取图片高度
+     * @returns {number} 图片高度
+     */
+    get height(): number;
+}
+import { DOMOverlay } from './DOMOverlay';