@baidumap/mapv-three 1.0.1 → 1.1.3

package/dist/types/threejs/objects/sphere/Pillar.d.ts

@@ -1,26 +1,56 @@
 /**
- * ![](media://pillar.png)
+ * 柱状体，支持柱形和锥形两种形状。
+ * 通过代理模式将属性和方法调用转发到内部对象，支持动态切换形状类型。
+ *
+ * @category Objects
+ * @example
+ * ```javascript
+ * // 创建柱形
+ * const pillar = engine.add(new mapvthree.Pillar({
+ *     shape: 'pillar',
+ *     color: 0xff0000,
+ *     height: 100,
+ *     radius: 10
+ * }));
+ *
+ * // 创建锥形
+ * const cone = engine.add(new mapvthree.Pillar({
+ *     shape: 'cone',
+ *     color: 0x00ff00,
+ *     height: 80,
+ *     radius: 15
+ * }));
+ * ```
  */
-export class Pillar extends GeoInstancedPointMesh {
-    constructor(parameters: any);
-    /** 整体透明度 */ opacity: any;
-    /** 柱体高度 */ height: any;
-    /** 柱体边数 */ radiusSegments: any;
-    /** 柱体半径 */ radius: any;
-    /** 颜色渐变 */ gradient: any;
-    /** 是否通过数据携带高度配置 */ vertexHeights: any;
-    /** 圆柱顶底是否打开 */ openEnded: any;
-    parameters: any;
-    computeInstanceMorphMatrix(scale: any): any;
+export class Pillar {
     /**
-     * @internal
-     * 计算高度拉升模型矩阵
+     * 构造函数
+     * @param {Object} parameters 配置参数
+     * @param {string} [parameters.shape='pillar'] 形状类型，支持'pillar'（柱形）和'cone'（锥形）
+     *
+     * @param {string} [parameters.color] 柱体颜色，支持十六进制颜色值或颜色名称，默认为[80, 20, 170, 0.8]
+     * @param {number} [parameters.opacity] 整体透明度，取值范围0-1，默认为1
+     * @param {number} [parameters.height] 柱体高度，默认为1
+     * @param {number} [parameters.radius] 柱体半径，默认为6
+     * @param {number} [parameters.radialSegments] 柱体边数，默认为4
+     * @param {number} [parameters.heightSegments] 柱体高度分段数，默认为1
+     * @param {boolean} [parameters.openEnded] 圆柱顶底是否打开，默认为true
+     * @param {boolean} [parameters.vertexHeights] 是否通过数据携带高度配置，默认为false
+     * @param {Object} [parameters.gradient] 颜色渐变配置对象
      */
-    getInstanceLocalMatrix: (coordinates: any, dataItem: any, index: any) => any;
-    /**
-     * @internal
-     * 计算最大高度
-     */
-    addCustomAttributes: () => number | undefined;
+    constructor(parameters: {
+        shape?: string | undefined;
+        color?: string | undefined;
+        opacity?: number | undefined;
+        height?: number | undefined;
+        radius?: number | undefined;
+        radialSegments?: number | undefined;
+        heightSegments?: number | undefined;
+        openEnded?: boolean | undefined;
+        vertexHeights?: boolean | undefined;
+        gradient?: Object | undefined;
+    });
+    /** @internal */ _object: PillarInternal | ConeInternal;
 }
-import { GeoInstancedPointMesh } from '../point/GeoInstancedPointMesh';
+import { PillarInternal } from './PillarInternal';
+import { ConeInternal } from './ConeInternal';

package/dist/types/threejs/objects/sphere/PillarInternal.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ![](media://pillar.png)
+ */
+export class PillarInternal extends GeoInstancedPointMesh {
+    constructor(parameters: any);
+    /** 整体透明度 */ opacity: any;
+    /** 柱体高度 */ height: any;
+    /** 柱体边数 */ radiusSegments: any;
+    /** 柱体半径 */ radius: any;
+    /** 颜色渐变 */ gradient: any;
+    /** 是否通过数据携带高度配置 */ vertexHeights: any;
+    /** 圆柱顶底是否打开 */ openEnded: any;
+    /**
+     * @internal
+     * 计算高度拉升模型矩阵
+     */
+    getInstanceLocalMatrix: (coordinates: any, dataItem: any, index: any) => any;
+    /**
+     * @internal
+     * 计算最大高度
+     */
+    addCustomAttributes: () => number | undefined;
+}
+import { GeoInstancedPointMesh } from '../point/GeoInstancedPointMesh';

package/dist/types/threejs/particles/Fireflies.d.ts

@@ -1,17 +1,37 @@
+/**
+ * 萤火虫粒子效果，创建跟随相机的萤火虫群效果。
+ *
+ * 萤火虫粒子会在相机周围随机分布，并具有自然的运动效果。
+ * 粒子系统会自动跟随相机位置，确保萤火虫始终在视野范围内。
+ *
+ * 注意：需要在引擎中启用动画循环 `rendering.enableAnimationLoop=true`
+ *
+ * @category Natural
+ * @example
+ * ```javascript
+ * // 创建萤火虫效果
+ * const fireflies = engine.add(new mapvthree.Fireflies({
+ *     color: new THREE.Color(0x0099aa),
+ *     size: 2,
+ *     countFactor: 0.6
+ * }));
+ * ```
+ */
 export class Fireflies {
     /**
-     * @param {{color?: string, size?: number, countFactor?: number}} options 参数对象
-     * @param {string} options.color 粒子颜色
-     * @param {number} options.size 萤火虫大小
-     * @param {number} options.countFactor 萤火虫数量因子，范围0~1
+     * 构造函数
+     * @param {Object} options 配置参数
+     * @param {string|THREE.Color} [options.color] 萤火虫颜色，支持十六进制颜色值或THREE.Color对象，默认为0x0099aa
+     * @param {number} [options.size] 萤火虫大小，默认为1
+     * @param {number} [options.countFactor] 萤火虫数量因子，范围0~1，控制活跃粒子数量，默认为0.5
      */
     constructor(options?: {
-        color?: string;
-        size?: number;
-        countFactor?: number;
+        color?: string | THREE.Color;
+        size?: number | undefined;
+        countFactor?: number | undefined;
     });
     /**
-     * 粒子数量的比例
+     * 粒子数量的比例因子
      * @private
      */
     private _countFactor;
@@ -22,34 +42,58 @@ export class Fireflies {
     /** @private */ private _system;
     /** @private */ private _options;
     /**
+     * 添加到引擎后的初始化
+     * @param {Engine} engine 引擎实例
      * @internal
      */
-    afterAddToEngine(engine: any): void;
+    afterAddToEngine(engine: Engine): void;
     /**
+     * 从引擎移除前的清理
      * @internal
      */
     beforeRemoveFromEngine(): void;
     /**
+     * 为材质添加自发光属性
+     * @param {Object} material 材质对象
      * @internal
      */
-    overrideMaterialWithEmissive(material: any): void;
+    overrideMaterialWithEmissive(material: Object): void;
     /**
+     * 渲染前的处理函数，更新萤火虫位置跟随相机
+     * @param {Engine} engine 引擎实例
      * @internal
      */
-    handleBeforeRender: (engine: any) => void;
+    handleBeforeRender: (engine: Engine) => void;
     /**
+     * 更新粒子系统
      * @internal
      */
     update: () => void;
     /**
+     * 创建粒子纹理
+     * @returns {THREE.Texture} 粒子纹理
      * @internal
      */
-    createSnow: () => any;
+    createSnow: () => THREE.Texture;
     /**
+     * 创建粒子发射器
+     * @returns {Emitter} 粒子发射器
      * @internal
      */
-    createEmitter: () => any;
+    createEmitter: () => Emitter;
+    /**
+     * 设置萤火虫数量因子
+     * @param {number} value 数量因子，范围0~1
+     */
     set countFactor(value: number);
+    /**
+     * 萤火虫数量因子
+     * @type {number}
+     */
     get countFactor(): number;
+    /**
+     * 释放资源
+     * 清理纹理和粒子系统
+     */
     dispose(): void;
 }

package/dist/types/threejs/utils/sprite.d.ts

@@ -1,3 +1,3 @@
 export function getFontSize(ctx: any, padding: any, text: any, width: any, height: any, lineNum?: number, fontSize?: number): any;
 export function createSprite(boxes: any, ctx: any, canvas: any, option?: {}): boolean;
-export function url2canvas(url: string | object, callback: Function): void;
+export function url2canvas(url: string | object, successCallback: Function, errorCallback: Function): void;

package/dist/types/threemap/3dtiles/HDMap/instanceConfig.d.ts

@@ -0,0 +1,166 @@
+export namespace fenceConfig {
+    namespace curb {
+        let enabled: boolean;
+        let instances: {
+            subtype: string;
+            modelPath: string;
+        }[];
+    }
+    namespace otherfence {
+        let enabled_1: boolean;
+        export { enabled_1 as enabled };
+        let instances_1: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_1 as instances };
+    }
+    namespace jersyfence {
+        let enabled_2: boolean;
+        export { enabled_2 as enabled };
+        let instances_2: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_2 as instances };
+    }
+    namespace wbeamfence {
+        let enabled_3: boolean;
+        export { enabled_3 as enabled };
+        let instances_3: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_3 as instances };
+    }
+    namespace bollard {
+        let enabled_4: boolean;
+        export { enabled_4 as enabled };
+        let instances_4: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_4 as instances };
+    }
+    namespace postbeamfence {
+        let enabled_5: boolean;
+        export { enabled_5 as enabled };
+        let instances_5: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_5 as instances };
+    }
+    namespace trafficcone {
+        let enabled_6: boolean;
+        export { enabled_6 as enabled };
+        let instances_6: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_6 as instances };
+    }
+    namespace hedgehog {
+        let enabled_7: boolean;
+        export { enabled_7 as enabled };
+        let instances_7: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_7 as instances };
+    }
+    namespace concretebarrier {
+        let enabled_8: boolean;
+        export { enabled_8 as enabled };
+        let instances_8: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_8 as instances };
+    }
+    namespace soundbarrier {
+        let enabled_9: boolean;
+        export { enabled_9 as enabled };
+        let instances_9: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_9 as instances };
+    }
+    namespace sunshadepanel {
+        let enabled_10: boolean;
+        export { enabled_10 as enabled };
+        let instances_10: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_10 as instances };
+    }
+    namespace antiglaremesh {
+        let enabled_11: boolean;
+        export { enabled_11 as enabled };
+        let instances_11: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_11 as instances };
+    }
+    namespace debrismesh {
+        let enabled_12: boolean;
+        export { enabled_12 as enabled };
+        let instances_12: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_12 as instances };
+    }
+    namespace wall {
+        let enabled_13: boolean;
+        export { enabled_13 as enabled };
+        let instances_13: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_13 as instances };
+    }
+    namespace ditch {
+        let enabled_14: boolean;
+        export { enabled_14 as enabled };
+        let instances_14: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_14 as instances };
+    }
+}
+export namespace bridgeConfig {
+    namespace bridge {
+        let enabled_15: boolean;
+        export { enabled_15 as enabled };
+        let instances_15: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_15 as instances };
+    }
+    namespace culvert {
+        let enabled_16: boolean;
+        export { enabled_16 as enabled };
+        let instances_16: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_16 as instances };
+    }
+}
+export namespace slopeConfig {
+    namespace slope {
+        let enabled_17: boolean;
+        export { enabled_17 as enabled };
+        let instances_17: {
+            subtype: string;
+            modelPath: string;
+        }[];
+        export { instances_17 as instances };
+    }
+}

package/dist/types/threemap/3dtiles/cesium/Cesium3DTileset.d.ts

@@ -112,12 +112,13 @@ export class Cesium3DTileset {
     deleteCamera(): void;
     getCamera(): any;
     handleBeforeRender: (engine: any) => void;
+    _isInstancedElement: (object: any) => boolean;
     getEntityByIntersection(intersection: any): {
+        _face: any;
+        _faceIndex: any;
         _content: any;
         _tile: any;
         _tileset: any;
-        _face: any;
-        _faceIndex: any;
         _batchId: number;
     } | null;
     updateInfo(): void;

package/dist/types/threemap/3dtiles/elements/TileInstancedElementManager.d.ts

@@ -5,7 +5,10 @@ export class TileInstancedElementManager {
     private _updateDelayTimerHander;
     /** @private */
     private _configVersion;
-    /** @private */
+    /**
+     * 由于可能有在地形上种树的情况，所以这个配置不放在HDMap3DTiles中，这样地形用Default3DTiles的时候也能配置显示种树
+     * @private
+     * */
     private _config;
     /** @private */
     private _labelEnabled;
@@ -35,10 +38,12 @@ export class TileInstancedElementManager {
             isBox: boolean;
             scaleByZ: boolean;
             instances: {
-                subtype: number;
-                modelPath: string;
-                itemScale: number;
-                zOffset: number;
+                subtype: string;
+                diffuseTexture: string;
+                normalDepthTexture: string;
+                ormTexture: string;
+                imposterScale: number;
+                uvOffset: number;
             }[];
         };
     });
@@ -49,10 +54,12 @@ export class TileInstancedElementManager {
             isBox: boolean;
             scaleByZ: boolean;
             instances: {
-                subtype: number;
-                modelPath: string;
-                itemScale: number;
-                zOffset: number;
+                subtype: string;
+                diffuseTexture: string;
+                normalDepthTexture: string;
+                ormTexture: string;
+                imposterScale: number;
+                uvOffset: number;
             }[];
         };
     };

package/dist/types/threemap/dataSource/DataSource.d.ts

@@ -77,6 +77,8 @@ export class DataSource {
     private _queuedData;
     /** @private 是否自动生成曲线数据，只有在线数据的时候会生效 */
     private _isCurve;
+    /** @private 过滤器 */
+    private _filter;
     _options: {
         id?: string | undefined;
         attributes?: object | undefined;
@@ -391,6 +393,11 @@ export class DataSource {
      * ```
      */
     clear(): void;
+    /**
+     * 设置过滤器，过滤器返回false的数据不会被添加到数据源中
+     * @param {Function} filter 过滤器
+     */
+    setFilter(filter: Function): void;
     /**
      * 清空数据后的回调函数，子类可覆盖此方法
      * @internal

package/dist/types/threemap/engine/rendering/Collision.d.ts

@@ -120,6 +120,21 @@ export class RenderingCollision {
      * @internal
      */
     _collisionTest(): false | undefined;
+    _getScreenPosition(position: any, matrix: any, width: any, height: any): any[];
+    _computeCharBoundingBoxes(chars: any, pixelSize: any, rotationMatrix: any, basePosition: any, camera: any, cameraOffset: any, matrix4: any, margin: any, tolerance: any, containerWidth: any, containerHeight: any): {
+        minX: number;
+        minY: number;
+        maxX: number;
+        maxY: number;
+    }[];
+    _computeObjectBoundingBox(result: any, px: any, py: any, margin: any, tolerance: any): {
+        minX: any;
+        minY: any;
+        maxX: any;
+        maxY: any;
+    } | null;
+    _insertAndCheckCollision(tree: any, boxes: any): boolean;
+    _updateCollisionDataForObjects(objectDataMap: any): void;
     /**
      * 碰撞方块的外边距，主要影响碰撞体积
      * @param {Array<number> | number} value x轴与y轴的边距

package/dist/types/threemap/model/AnimationModel.d.ts

@@ -1,14 +1,94 @@
+/**
+ * 动画模型，支持GLTF/GLB等格式的骨骼动画播放与控制。
+ * 继承自 {@link SimpleModel}，可用于加载带有动画的3D模型，并提供动画的播放、停止、速度、循环等控制接口。
+ *
+ * @category Model
+ * @example
+ * ```javascript
+ * // 加载带动画的模型
+ * let model = engine.add(new mapvthree.AnimationModel({
+ *   url: 'assets/models/animated.glb',
+ *   autoPlay: true
+ * }));
+ * // 播放第1个动画
+ * model.play(0);
+ * // 停止所有动画
+ * model.stopAll();
+ * // 设置动画速度为2倍
+ * model.setSpeed(2);
+ * ```
+ */
 export class AnimationModel extends SimpleModel {
-    constructor(params: any);
-    _updateData(gltf: any, model: any): void;
+    /**
+     * 构造函数
+     * @param {Object} params 配置参数，参考SimpleModel
+     */
+    constructor(params: Object);
+    /**
+     * 初始化动画数据，内部方法
+     * @param {Object} gltf GLTF加载结果
+     * @param {Object3D} model 模型对象
+     * @internal
+     */
+    _updateData(gltf: Object, model: Object3D): void;
     animations: any;
     mixer: any;
     animationActions: any;
-    play(actionIndex: any): void;
-    stop(actionIndex: any): void;
+    /**
+     * 播放指定索引的动画
+     * @param {number} [actionIndex=0] 动画索引，默认播放第一个
+     * @example
+     * ```javascript
+     * model.play(1); // 播放第2个动画
+     * ```
+     */
+    play(actionIndex?: number): void;
+    /**
+     * 停止指定索引的动画
+     * @param {number} [actionIndex=0] 动画索引，默认停止第一个
+     * @example
+     * ```javascript
+     * model.stop(0); // 停止第1个动画
+     * ```
+     */
+    stop(actionIndex?: number): void;
+    /**
+     * 播放所有动画
+     * @example
+     * ```javascript
+     * model.playAll();
+     * ```
+     */
     playAll(): void;
+    /**
+     * 停止所有动画
+     * @example
+     * ```javascript
+     * model.stopAll();
+     * ```
+     */
     stopAll(): void;
-    setSpeed(speed: any, actionIndex: any): void;
-    setLoop(loop: any, actionIndex: any): void;
+    /**
+     * 设置动画播放速度
+     * @param {number} speed 播放速度，1为正常速度
+     * @param {number} [actionIndex] 动画索引，若不传则设置所有动画
+     * @example
+     * ```javascript
+     * model.setSpeed(2); // 所有动画2倍速
+     * model.setSpeed(0.5, 0); // 第1个动画0.5倍速
+     * ```
+     */
+    setSpeed(speed: number, actionIndex?: number): void;
+    /**
+     * 设置动画循环模式
+     * @param {boolean} loop 是否循环，true为循环，false为只播放一次
+     * @param {number} [actionIndex] 动画索引，若不传则设置所有动画
+     * @example
+     * ```javascript
+     * model.setLoop(true); // 所有动画循环
+     * model.setLoop(false, 0); // 第1个动画只播放一次
+     * ```
+     */
+    setLoop(loop: boolean, actionIndex?: number): void;
 }
 import { SimpleModel } from './SimpleModel';

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

@@ -65,6 +65,98 @@ export class DynamicWeather {
     private _inTransition;
     /** @private */
     private _modifyCount;
+    _lightConfig: {
+        DefaultSky: {
+            clear: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            partlyCloudy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            cloudy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            overcast: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            foggy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            rainy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            snowy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+        };
+        DynamicSky: {
+            clear: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            partlyCloudy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            cloudy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            overcast: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            foggy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            rainy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            snowy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+        };
+        EmptySky: {
+            clear: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            partlyCloudy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            cloudy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            overcast: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            foggy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            rainy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+            snowy: {
+                sunLightIntensity: number;
+                skyLightIntensity: number;
+            };
+        };
+    };
     /**
      * 设置天气类型
      * @type {string}