@baidumap/mapv-three 1.0.0 → 1.1.3

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

@@ -1,25 +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;
+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/3dtiles/materials/HDMap3DTilesMaterialManagerV2.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 高清路网3dtiles材质管理器
+ */
+export class HDMap3DTilesMaterialManagerV2 extends Default3DTilesMaterialManager {
+    isHDMap3DTilesMaterialManagerV2: boolean;
+    addDefaultMaterials(): void;
+}
+import { Default3DTilesMaterialManager } from './Default3DTilesMaterialManager';

package/dist/types/threemap/controls/editors/CircleEditor.d.ts

@@ -19,11 +19,6 @@ export class CircleEditor extends Editor {
     private _virtualLineData;
     /** @private */
     private _helpersData;
-    /**
-     * @protected
-     * 是否允许编辑
-     */
-    protected _enableEdit: boolean;
     /** @private */ private _hasBeenMove;
     /** @private */ private _engine;
     /** @private */ private _options;
@@ -52,10 +47,6 @@ export class CircleEditor extends Editor {
     /** @private */
     private graphInfo;
     /** @private */
-    private _handleCompleteClick;
-    set vertex(value: any);
-    get vertex(): any;
-    /** @private */
     private _handleAddClick;
     /** @private */
     private _handleAddFinish;

package/dist/types/threemap/controls/editors/Editor.d.ts

@@ -14,6 +14,11 @@ export class Editor {
     /** @protected */ protected _completedElement: null;
     /** @protected */ protected _type: string;
     /** @private */ private _selectedIndex;
+    /**
+     * @protected
+     * 是否允许编辑
+     */
+    protected _enableEdit: boolean;
     /**
      * @private
      * 绘制状态，0：未开始、1：首次绘制中、2：绘制结束、3：编辑暂停、4：编辑中
@@ -49,7 +54,7 @@ export class Editor {
      * 重置绘制状态
      */
     reset(): void;
-    vertex: any[] | undefined;
+    vertex: any;
     /**
      * 清除所有图形
      */
@@ -62,6 +67,13 @@ export class Editor {
      * @private
      */
     private detachTransform;
+    /** @private */
+    private _handleCompleteClick;
+    private set stage(value);
+    /**
+     * @private
+     */
+    private get stage();
     /**
      * @protected
      */
@@ -95,11 +107,6 @@ export class Editor {
     /** @private */
     private deepClone;
     cancel(): void;
-    private set stage(value);
-    /**
-     * @private
-     */
-    private get stage();
     /** @private */
     private _handleNodeClick;
     /** @private */
@@ -156,5 +163,18 @@ export class Editor {
     private _getProperties;
     /** @private */
     private _handleCancelEdit;
+    /**
+     * 删除选中元素
+     */
+    delete(): void;
+    /**
+     * 设置是否允许编辑
+     * @param {boolean} value 是否允许编辑
+     */
+    set enableEdit(value: boolean);
+    /**
+     * 获取是否允许编辑
+     */
+    get enableEdit(): boolean;
 }
 import { DataItem } from '../../dataSource/DataItem';