@baidumap/mapv-three 1.0.1 → 1.1.3

package/dist/types/threejs/objects/line/PolylineInternal.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 有宽度的线，可设置拐角、端头，可实现虚线，可实现线动画
+ * ```js
+ * const line = engine.add(new mapvthree.Polyline());
+ * let data = mapvthree.GeoJSONDataSource.fromGeoJSON(data);
+ * line.dataSource = data;
+ * ```
+ */
+export class PolylineInternal extends GeoMesh {
+    /**
+     * 构造函数
+     * @param {{
+     * color?: string, vertexColors?: boolean, emissive?: string, map?: string,
+     * opacity?: number, alphaTest?: number,
+     * dashed?: boolean, dashArray?: number, dashOffset?: number, dashRatio?: number,
+     * }} parameters 传入参数对象
+     * @param {number} parameters.lineWidth 线的宽度，默认是4
+     * @param {number} parameters.height 线的高度
+     * @param {string} parameters.color 线的颜色
+     * @param {boolean} parameters.vertexColors 是否通过数据携带颜色配置
+     * @param {string} parameters.emissive 自发光的颜色
+     * @param {number} parameters.opacity 线的整体透明系数，默认为1
+     * @param {number} parameters.alphaTest 开启透明剔除，透明度小于该值的部分都不渲染，默认为0
+     * @param {boolean} parameters.dashed 是否渲染虚线
+     * @param {number} parameters.dashArray 每段虚线（实心加空心部分）的长度
+     * @param {number} parameters.dashOffset 虚线起始绘制部分的偏移
+     * @param {number} parameters.dashRatio 实心部分占每段长度的占比
+     */
+    constructor(parameters: {
+        color?: string;
+        vertexColors?: boolean;
+        emissive?: string;
+        map?: string;
+        opacity?: number;
+        alphaTest?: number;
+        dashed?: boolean;
+        dashArray?: number;
+        dashOffset?: number;
+        dashRatio?: number;
+    });
+    isEventEntitySupported: boolean;
+    /** @private */
+    private _resolution;
+    /** @protected */ protected geometry: any;
+    /** @protected */ protected material: any;
+    /** 线的颜色 */ color: any;
+    /** 是否通过数据携带颜色配置 */ vertexColors: any;
+    /** 自发光的颜色 */ emissive: any;
+    /** 纹理贴图的路径 */ map: any;
+    /** 线的整体透明系数 */ opacity: any;
+    /** 开启透明剔除，透明度小于该值的部分都不渲染，默认为0 */ alphaTest: any;
+    /** 是否渲染虚线 */ dashed: any;
+    /** 每段虚线（实心加空心部分）的长度 */ dashArray: any;
+    /** 虚线起始绘制部分的偏移 */ dashOffset: any;
+    /** 实心部分占每段长度的占比 */ dashRatio: any;
+    parameters: {
+        color?: string;
+        vertexColors?: boolean;
+        emissive?: string;
+        map?: string;
+        opacity?: number;
+        alphaTest?: number;
+        dashed?: boolean;
+        dashArray?: number;
+        dashOffset?: number;
+        dashRatio?: number;
+    };
+    /** @internal */
+    getDefaultParams(): {
+        lineWidth: number;
+    };
+    computeViewportOrthographicTransform(viewport: any, near: any, far: any, matrix: any): any;
+    computeViewportTransformation(viewport: any, near: any, far: any, matrix: any): any;
+    onBeforeScenePrepareRenderHook(): void;
+    _cameraNear: any;
+    _cameraFar: any;
+    afterGeometryUpdate(): void;
+    makeGeometryOffsetPosition: (geometry: any) => void;
+    set lineWidth(value: any);
+    /**
+     * 线的宽度
+     */
+    get lineWidth(): any;
+}
+import { GeoMesh } from '../GeoMesh';

package/dist/types/threejs/objects/line/SimpleLine.d.ts

@@ -1,5 +1,5 @@
 /**
- * 简单线条渲染对象，相比{@link FatLine}，SimpleLine 提供了更基础的线条渲染功能，可用于绘制1px宽度的线条
+ * 简单线条渲染对象，相比{@link Polyline}，SimpleLine 提供了更基础的线条渲染功能，可用于绘制1px宽度的线条
  *
  * @category Objects
  * @example

package/dist/types/threejs/objects/line/TrafficLink.d.ts

@@ -1,3 +1,3 @@
-export class TrafficLink extends FatLine {
+export class TrafficLink extends FatLineInternal {
 }
-import { FatLine } from './FatLine';
+import { FatLineInternal } from './FatLineInternal';

package/dist/types/threejs/objects/natural/BillboardTree.d.ts

@@ -2,6 +2,7 @@ export class BillboardTree extends GeoInstancedPointMesh {
     constructor(parameters?: {});
     /** @protected */ protected geometry: InstancedBillboardBufferGeometry;
     /** @protected */ protected material: BillboardTreeMaterial;
+    parameters: {};
     getInstanceLocalMatrix: (coordinates: any, dataItem: any, i: any, userData: any) => any;
 }
 import { GeoInstancedPointMesh } from '../point/GeoInstancedPointMesh';

package/dist/types/threejs/objects/point/ActiveMesh.d.ts

@@ -1,5 +1,4 @@
 export class ActiveMesh extends GeoInstancedPointMesh {
     constructor(parameters: any);
-    parameters: any;
 }
 import { GeoInstancedPointMesh } from './GeoInstancedPointMesh';

package/dist/types/threejs/objects/point/BallonPoint.d.ts

@@ -1,13 +1,60 @@
 /**
- * 坏的，暂不可用
+ * 气球点，用于显示气球样式的点数据可视化，支持实例化渲染，适合大量点数据的展示。
+ *
+ * @category Objects
+ * @example
+ * ```javascript
+ * // 创建气球点
+ * const ballonPoint = engine.add(new mapvthree.BallonPoint({
+ *     color: 0xff0000,
+ *     size: 20,
+ *     height: 100,
+ *     iconSrc: 'car'
+ * }));
+ * ```
  */
 export class BallonPoint extends GeoInstancedMesh {
-    constructor(parameters: any);
-    parameters: any;
-    /** @internal */
-    getDefaultParams(): {
-        iconSrc: string;
+    /**
+     * 构造函数
+     * @param {Object} parameters 配置参数
+     * @param {string} [parameters.iconSrc='car'] 气球图标源
+     * @param {number} [parameters.color] 气球颜色
+     * @param {number} [parameters.size] 气球大小
+     * @param {Array<number>} [parameters.size3] 气球三维大小
+     * @param {number} [parameters.height] 气球高度
+     * @param {number} [parameters.opacity] 透明度
+     * @param {boolean} [parameters.dashed] 是否使用虚线样式
+     */
+    constructor(parameters: {
+        iconSrc?: string | undefined;
+        color?: number | undefined;
+        size?: number | undefined;
+        size3?: number[] | undefined;
+        height?: number | undefined;
+        opacity?: number | undefined;
+        dashed?: boolean | undefined;
+    });
+    parameters: {
+        iconSrc?: string | undefined;
+        color?: number | undefined;
+        size?: number | undefined;
+        size3?: number[] | undefined;
+        height?: number | undefined;
+        opacity?: number | undefined;
+        dashed?: boolean | undefined;
     };
-    getBallonIconSrc: (iconSrc: any) => any;
+    /**
+     * 获取默认参数
+     * @returns {Object} 默认参数对象
+     * @internal
+     */
+    getDefaultParams(): Object;
+    /**
+     * 获取气球图标源
+     * @param {string} iconSrc 图标源
+     * @returns {string} 处理后的图标源
+     * @private
+     */
+    private getBallonIconSrc;
 }
 import { GeoInstancedMesh } from '../GeoInstancedMesh';

package/dist/types/threejs/objects/point/BubblePoint.d.ts

@@ -15,12 +15,15 @@
 export class BubblePoint extends GeoInstancedPointMesh {
     /**
      * 构造函数
-     * @param {{color?: string, size?: number, duration?: number, type?: number, keepSize?: boolean}} parameters 传入参数对象
+     * @param {{color?: string, size?: number, duration?: number, type?: number, keepSize?: boolean
+     * vertexColors?: boolean, vertexSizes?: boolean}} parameters 传入参数对象
      * @param {string} parameters.color 气泡颜色
      * @param {number} parameters.size 气泡尺寸
      * @param {number} parameters.duration 气泡动画间隔时长
      * @param {string} parameters.type 气泡类型
      * @param {number} parameters.keepSize 是否保持大小
+     * @param {boolean} parameters.vertexColors 是否通过数据携带颜色配置
+     * @param {boolean} parameters.vertexSizes 是否通过数据携带尺寸配置
      */
     constructor(parameters: {
         color?: string;
@@ -28,6 +31,8 @@ export class BubblePoint extends GeoInstancedPointMesh {
         duration?: number;
         type?: number;
         keepSize?: boolean;
+        vertexColors?: boolean;
+        vertexSizes?: boolean;
     });
     /** 气泡颜色 */ color: any;
     /** 气泡尺寸 */ size: any;
@@ -39,6 +44,8 @@ export class BubblePoint extends GeoInstancedPointMesh {
         duration?: number;
         type?: number;
         keepSize?: boolean;
+        vertexColors?: boolean;
+        vertexSizes?: boolean;
     };
     clone(): any;
 }

package/dist/types/threejs/objects/point/Circle.d.ts

@@ -98,14 +98,5 @@ export class Circle extends GeoInstancedPointMesh {
         width: number;
         height: number;
     };
-    /**
-     * @internal
-     * 获取实例的本地变换矩阵
-     * @param {Array} coordinates 坐标数据
-     * @param {Object} dataItem 数据项
-     * @param {number} index 实例索引
-     * @returns {Matrix4|null} 变换矩阵，如果不需要特殊变换则返回null
-    */
-    getInstanceLocalMatrix: (coordinates: any[], dataItem: Object, index: number) => Matrix4 | null;
 }
 import { GeoInstancedPointMesh } from './GeoInstancedPointMesh';

package/dist/types/threejs/objects/point/DOMPoint.d.ts

@@ -5,12 +5,12 @@
  * @example
  * ```javascript
  * // 创建一个基础的DomPoints
- * const domPoints = engine.add(new mapvthree.DOMPoint({
+ * const domPoint = engine.add(new mapvthree.DOMPoint({
  *     offset: [-270, -200]
  * }));
  *
  * // 自定义渲染函数, 创建dom元素
- * domPoints.renderItem = (value) => {
+ * domPoint.renderItem = (value) => {
  *     const node = document.createElement('div');
  *     node.className = 'custom-point';
  *     node.innerHTML = `
@@ -34,7 +34,7 @@
  *         }
  *     }
  * ]);
- * domPoints.dataSource = data;
+ * domPoint.dataSource = data;
  * ```
  */
 export class DOMPoint extends GeoObject {
@@ -59,7 +59,7 @@ export class DOMPoint extends GeoObject {
      * @param {Object} value 数据源中的数据项
      * @example
      * ```javascript
-     * domPoints.renderItem = (value) => {
+     * domPoint.renderItem = (value) => {
      *     const node = document.createElement('div');
      *     node.className = 'custom-point';
      *     node.innerHTML = `

package/dist/types/threejs/objects/point/EffectModelPoint.d.ts

@@ -1,8 +1,11 @@
 /**
- * EffectModelPoint类继承自GeoObject类，支持加载自定义模型作为点类数据可视化，
- * 并提供一些大小和动画配置参数，以实现理想的动画效果。
- * 注意：动画效果需要在处理画引擎时设置rendering.enableAnimationLoop为true
- * ```js
+ * 特效模型点，支持加载自定义模型作为点类数据可视化，提供大小和动画配置参数，以实现理想的动画效果。
+ *
+ * 注意：动画效果需要在处理画引擎时设置`rendering.enableAnimationLoop=true`
+ *
+ * @category Objects
+ * @example
+ * ```javascript
  * const effectModelPoint = engine.add(new mapvthree.EffectModelPoint({
  *     normalize: true,
  *     rotateToZUp: true,
@@ -11,35 +14,32 @@
  *     animationJump: true,
  *     animationJumpHeight: 100
  * }));
- * effetcModelPoint.model = gltf.scene;
- * effetcModelPoint.size = 30;
+ * effectModelPoint.model = gltf.scene;
+ * effectModelPoint.size = 30;
  * ```
- * ![](media://effectmodel_point.png)
  */
 export class EffectModelPoint extends GeoObject {
     /**
      * 构造函数
-     * @param {{normalize?: boolean, rotateToZUp?: boolean, keepSize?: boolean,
-     * animationRotate?: boolean, animationJump?: boolean, animationRotatePeriod?: number,
-     * animationJumpPeriod?: number, animationJumpHeight?: number}} parameters 传入参数对象
-     * @param {string} parameters.normalize 是否归一化模型大小
-     * @param {number} parameters.rotateToZUp 将模型调整至z轴朝上
-     * @param {number} parameters.keepSize 是否保持大小
-     * @param {number} parameters.animationRotate 是否旋转
-     * @param {number} parameters.animationRotatePeriod 旋转一周的时间
-     * @param {number} parameters.animationJump 是否跳跃
-     * @param {number} parameters.animationJumpPeriod 跳跃一次的时间周期
-     * @param {number} parameters.animationJumpHeight 跳跃高度
+     * @param {Object} parameters 传入参数对象
+     * @param {boolean} [parameters.normalize=true] 是否归一化模型大小
+     * @param {boolean} [parameters.rotateToZUp=true] 将模型调整至z轴朝上
+     * @param {boolean} [parameters.keepSize=true] 是否保持大小
+     * @param {boolean} [parameters.animationRotate=false] 是否启用旋转动画
+     * @param {number} [parameters.animationRotatePeriod=3000] 旋转一周的时间，单位毫秒
+     * @param {boolean} [parameters.animationJump=false] 是否启用跳跃动画
+     * @param {number} [parameters.animationJumpPeriod=3000] 跳跃一次的时间周期，单位毫秒
+     * @param {number} [parameters.animationJumpHeight=30] 跳跃高度
      */
     constructor(parameters: {
-        normalize?: boolean;
-        rotateToZUp?: boolean;
-        keepSize?: boolean;
-        animationRotate?: boolean;
-        animationJump?: boolean;
-        animationRotatePeriod?: number;
-        animationJumpPeriod?: number;
-        animationJumpHeight?: number;
+        normalize?: boolean | undefined;
+        rotateToZUp?: boolean | undefined;
+        keepSize?: boolean | undefined;
+        animationRotate?: boolean | undefined;
+        animationRotatePeriod?: number | undefined;
+        animationJump?: boolean | undefined;
+        animationJumpPeriod?: number | undefined;
+        animationJumpHeight?: number | undefined;
     });
     /** @private */ private _model;
     /** @private */ private _normalize;
@@ -54,8 +54,30 @@ export class EffectModelPoint extends GeoObject {
     /** @private */ private _animationJump;
     /** @private */ private _animationJumpPeriod;
     /** @private */ private _animationJumpHeight;
+    /**
+     * 是否支持事件实体
+     * @type {boolean}
+     */
     isEventEntitySupported: boolean;
-    /** @private */
+    parameters: {
+        normalize?: boolean | undefined;
+        rotateToZUp?: boolean | undefined;
+        keepSize?: boolean | undefined;
+        animationRotate?: boolean | undefined;
+        animationRotatePeriod?: number | undefined;
+        animationJump?: boolean | undefined;
+        animationJumpPeriod?: number | undefined;
+        animationJumpHeight?: number | undefined;
+    };
+    /**
+     * 加载默认模型，多个实例共享一个模型模版
+     * @private
+     */
+    private _initDefaultModel;
+    /**
+     * 更新模型
+     * @private
+     */
     private _updateModel;
     /** @private */
     private _cleanOldMesh;

package/dist/types/threejs/objects/point/EffectPoint.d.ts

@@ -0,0 +1,57 @@
+/**
+ * 特效点，根据类型自动创建对应的特效对象。
+ *
+ * 支持扇形雷达、气泡等特效类型，通过type字段自动创建对应的特效对象，包括`Fan`、`Bubble`、`Wave`、`Breath`、`Radar`、`RadarLayered`、`RadarSpread`类型。
+ *
+ * 注意：动画效果需要在处理画引擎时设置`rendering.enableAnimationLoop=true`
+ *
+ * @category Objects
+ * @example
+ * ```javascript
+ * // 创建扇形雷达特效
+ * const effectPoint = engine.add(new mapvthree.EffectPoint({
+ *     type: 'Fan',
+ *     color: 0xff0000,
+ *     size: 50
+ * }));
+ *
+ * // 创建气泡特效
+ * const bubblePoint = engine.add(new mapvthree.EffectPoint({
+ *     type: 'Bubble',
+ *     color: 0x00ff00,
+ *     size: 30
+ * }));
+ * ```
+ */
+export class EffectPoint {
+    /**
+     * 构造函数
+     * @param {Object} parameters 配置参数
+     * @param {string} parameters.type 特效类型，支持`Fan`、`Radar`、`RadarLayered`、`RadarSpread`、`Bubble`、`Wave`、`Breath`等类型
+     *
+     * @param {string} [parameters.color] 特效颜色，支持十六进制颜色值或颜色名称
+     * @param {number} [parameters.size] 特效大小，控制特效的显示尺寸
+     * @param {number} [parameters.opacity] 透明度，取值范围0-1，默认为1
+     * @param {boolean} [parameters.vertexColors] 是否使用顶点颜色，当为true时可通过数据源设置每个点的颜色
+     * @param {string} [parameters.emissive] 自发光颜色，支持十六进制颜色值
+     * @param {number} [parameters.emissiveIntensity] 自发光强度，默认为1
+     * @param {string} [parameters.map] 纹理贴图路径，支持图片文件路径
+     * @param {number} [parameters.alphaTest] 透明度测试阈值，小于该值的像素将被剔除，默认为0
+     * @param {boolean} [parameters.keepSize] 是否保持像素大小，默认为true
+     */
+    constructor(parameters: {
+        type: string;
+        color?: string | undefined;
+        size?: number | undefined;
+        opacity?: number | undefined;
+        vertexColors?: boolean | undefined;
+        emissive?: string | undefined;
+        emissiveIntensity?: number | undefined;
+        map?: string | undefined;
+        alphaTest?: number | undefined;
+        keepSize?: boolean | undefined;
+    });
+    /** @internal */ _object: BubblePoint | FanPoint;
+}
+import { BubblePoint } from './BubblePoint';
+import { FanPoint } from './FanPoint';

package/dist/types/threejs/objects/point/GeoInstancedPointMesh.d.ts

@@ -1,4 +1,14 @@
 export class GeoInstancedPointMesh extends GeoInstancedMesh {
     isInstancedPointMesh: boolean;
+    computeInstanceMorphMatrix(scale: any): any;
+    /**
+     * @internal
+     * 获取实例的本地变换矩阵
+     * @param {Array} coordinates 坐标数据
+     * @param {Object} dataItem 数据项
+     * @param {number} index 实例索引
+     * @returns {Matrix4|null} 变换矩阵，如果不需要特殊变换则返回null
+    */
+    getInstanceLocalMatrix: (coordinates: any[], dataItem: Object, index: number) => Matrix4 | null;
 }
 import { GeoInstancedMesh } from '../GeoInstancedMesh';

package/dist/types/threejs/objects/point/Icon.d.ts

@@ -46,7 +46,7 @@ export class Icon extends GeoMesh {
      * @param {number} [parameters.jumpHeight=20] 跳动高度, 默认20
      * @param {number} [parameters.jumpSpeed=1] 跳动速度, 默认1
      */
-    constructor(parameters: {
+    constructor(parameters?: {
         mapSrc?: string | undefined;
         vertexIcons?: boolean | undefined;
         vertexColors?: boolean | undefined;