@baidumap/mapv-three 1.0.0 → 1.1.3

package/dist/types/Internal.d.ts

@@ -16,3 +16,5 @@ export { WebMercatorProjection } from "./threemap/projections/WebMercatorProject
 export { ECEFProjection } from "./threemap/projections/ECEFProjection";
 export { GeoProjection } from "./threemap/projections/GeoProjection";
 export { BaiduMercatorProjection } from "./threemap/projections/BaiduMercatorProjection";
+export { UTMProjection } from "./threemap/projections/UTMProjection";
+export { EqualEarthProjection } from "./threemap/projections/EqualEarthProjection";

package/dist/types/addons/traffic/handler/ModelCreator.d.ts

@@ -11,7 +11,6 @@ export class ModelCreator {
     _engine: any;
     _setModelMaterialMap: {};
     _bindClick: any;
-    _projection: any;
     /**
      * 更新_modelIdMap，genMeshParams和addMesh方法依赖_modelIdMap数据。initModels会自动调用该方法
      * @param modelList

package/dist/types/index.d.ts

@@ -9,7 +9,6 @@ export { VerticalGradientSky } from "./threemap/natural/VerticalGradientSky";
 export { DynamicWeather } from "./threemap/natural/DynamicWeather";
 export { SkyAtmosphere } from "./threejs/objects/natural/SkyAtmosphere";
 export { VolumetricClouds } from "./threejs/objects/natural/VolumetricClouds";
-export { BillboardTree } from "./threejs/objects/natural/BillboardTree";
 export { DefaultQuadMapMaterialManager } from "./threemap/mapView/materials/DefaultQuadMapMaterialManager";
 export { DarkMVTMaterialManager } from "./threemap/mapView/materials/DarkMVTMaterialManager";
 export { CustomMVTMaterialManager } from "./threemap/mapView/materials/CustomMVTMaterialManager";
@@ -42,6 +41,7 @@ export { SimpleModel } from "./threemap/model/SimpleModel";
 export { AnimationModel } from "./threemap/model/AnimationModel";
 export { LODModel } from "./threemap/model/LODModel";
 export { GLTFScene } from "./threemap/model/GLTFScene";
+export { BillboardTree } from "./threejs/objects/natural/BillboardTree";
 export { Default3DTiles } from "./threemap/3dtiles/Default3DTiles";
 export { Default3DTilesGroup } from "./threemap/3dtiles/Default3DTilesGroup";
 export { HDMap3DTiles } from "./threemap/3dtiles/HDMap3DTiles";
@@ -59,6 +59,7 @@ export { Building3DTilesMaterialManager } from "./threemap/3dtiles/materials/Bui
 export { HDRoad3DTilesMaterialManager } from "./threemap/3dtiles/materials/HDRoad3DTilesMaterialManager";
 export { Terrain3DTilesMaterialManager } from "./threemap/3dtiles/materials/Terrain3DTilesMaterialManager";
 export { HDMap3DTilesMaterialManager } from "./threemap/3dtiles/materials/HDMap3DTilesMaterialManager";
+export { HDMap3DTilesMaterialManagerV2 } from "./threemap/3dtiles/materials/HDMap3DTilesMaterialManagerV2";
 export { DataSource } from "./threemap/dataSource/DataSource";
 export { DataItem } from "./threemap/dataSource/DataItem";
 export { GeoJSONDataSource } from "./threemap/dataSource/GeoJSONDataSource";
@@ -75,6 +76,7 @@ export { PointEditor } from "./threemap/controls/editors/PointEditor";
 export { CircleEditor } from "./threemap/controls/editors/CircleEditor";
 export { RectEditor } from "./threemap/controls/editors/RectEditor";
 export { PolygonEditor } from "./threemap/controls/editors/PolygonEditor";
+export { EditorManager } from "./threemap/controls/editors/EditorManager";
 export { Measure } from "./threemap/controls/measure/Measure";
 export { LengthMeasure } from "./threemap/controls/measure/LengthMeasure";
 export { AreaMeasure } from "./threemap/controls/measure/AreaMeasure";
@@ -116,12 +118,12 @@ export { LODDynamicInstancedMesh } from "./threejs/objects/instance/LODDynamicIn
 export { GridLODInstancedMesh } from "./threejs/objects/instance/GridLODInstancedMesh";
 export { LineInstancedMesh } from "./threejs/objects/instance/LineInstancedMesh";
 export { SimplePoint } from "./threejs/objects/point/SimplePoint";
-export { FanPoint } from "./threejs/objects/point/FanPoint";
-export { BubblePoint } from "./threejs/objects/point/BubblePoint";
+export { EffectPoint } from "./threejs/objects/point/EffectPoint";
+export { BallonPoint } from "./threejs/objects/point/BallonPoint";
 export { ActiveMesh } from "./threejs/objects/point/ActiveMesh";
 export { IconPoint } from "./threejs/objects/point/IconPoint";
 export { Icon } from "./threejs/objects/point/Icon";
-export { DomPoints } from "./threejs/objects/point/DomPoint";
+export { DOMPoint } from "./threejs/objects/point/DOMPoint";
 export { ClusterPoint } from "./threejs/objects/point/ClusterPoint";
 export { EffectModelPoint } from "./threejs/objects/point/EffectModelPoint";
 export { PointGroup } from "./threejs/objects/point/PointGroup";
@@ -138,8 +140,8 @@ export { TwinLabel } from "./threejs/objects/point/TwinLabel";
 export { SDFText } from "./threejs/objects/text/SDFText";
 export { Spark } from "./threejs/objects/point/Spark";
 export { SimpleLine } from "./threejs/objects/line/SimpleLine";
-export { FatLine } from "./threejs/objects/line/FatLine";
 export { Polyline } from "./threejs/objects/line/Polyline";
+export { FatLine } from "./threejs/objects/line/FatLine";
 export { Wall } from "./threejs/objects/line/Wall";
 export { Polygon } from "./threejs/objects/polygon/Polygon";
 export { Fireflies } from "./threejs/particles/Fireflies";

package/dist/types/index.open.d.ts

@@ -2,6 +2,7 @@ export { Engine } from "./threemap/Engine";
 export { EmptySky } from "./threemap/natural/EmptySky";
 export { DynamicSky } from "./threemap/natural/DynamicSky";
 export { DefaultSky } from "./threemap/natural/DefaultSky";
+export { StaticSky } from "./threemap/natural/StaticSky";
 export { DynamicWeather } from "./threemap/natural/DynamicWeather";
 export { MapView } from "./threemap/mapView/map/MapView";
 export * as mapViewConstants from "./threemap/mapView/constants";
@@ -20,6 +21,7 @@ export { PlaneTerrainTileProvider } from "./threemap/mapView/tileProvider/terrai
 export { CesiumTerrainTileProvider } from "./threemap/mapView/tileProvider/terrain/CesiumTerrainTileProvider";
 export { BaiduVectorTileProvider } from "./threemap/mapView/tileProvider/vector/BaiduVectorTileProvider";
 export { SimpleModel } from "./threemap/model/SimpleModel";
+export { AnimationModel } from "./threemap/model/AnimationModel";
 export { LODModel } from "./threemap/model/LODModel";
 export { Default3DTiles } from "./threemap/3dtiles/Default3DTiles";
 export { DataSource } from "./threemap/dataSource/DataSource";
@@ -32,20 +34,28 @@ export { Popup } from "./threemap/overlay/Popup";
 export { Marker } from "./threemap/overlay/Marker";
 export { GeoInstancedMesh } from "./threejs/objects/GeoInstancedMesh";
 export { SimplePoint } from "./threejs/objects/point/SimplePoint";
+export { EffectPoint } from "./threejs/objects/point/EffectPoint";
+export { BallonPoint } from "./threejs/objects/point/BallonPoint";
 export { Icon } from "./threejs/objects/point/Icon";
-export { DomPoints } from "./threejs/objects/point/DomPoint";
+export { DOMPoint } from "./threejs/objects/point/DOMPoint";
 export { ClusterPoint } from "./threejs/objects/point/ClusterPoint";
+export { EffectModelPoint } from "./threejs/objects/point/EffectModelPoint";
 export { Circle } from "./threejs/objects/point/Circle";
 export { Label } from "./threejs/objects/point/Label";
+export { Pillar } from "./threejs/objects/sphere/Pillar";
 export { Heatmap } from "./threejs/objects/heatmap/Heatmap";
+export { Heatmap3D } from "./threejs/objects/heatmap/Heatmap3D";
 export { Text } from "./threejs/objects/point/Text";
 export { SDFText } from "./threejs/objects/text/SDFText";
+export { Spark } from "./threejs/objects/point/Spark";
 export { SimpleLine } from "./threejs/objects/line/SimpleLine";
 export { FatLine } from "./threejs/objects/line/FatLine";
+export { Polyline } from "./threejs/objects/line/Polyline";
 export { Wall } from "./threejs/objects/line/Wall";
 export { Polygon } from "./threejs/objects/polygon/Polygon";
 export { GLTFLoader } from "./threejs/loaders/GLTFLoader";
 export { gltfLoader } from "./threejs/loaders/globals";
+export { WaterMaterial } from "./threejs/materials/natural/WaterMaterial";
 export * as urlUtils from "./util/urlUtils";
 export * as geojsonUtils from "./util/geojsonUtils";
 export * as colorUtils from "./util/colorUtils";

package/dist/types/threejs/controls/DraggingMovementAggregator.d.ts

@@ -0,0 +1,23 @@
+export class DraggingMovementAggregator {
+    constructor(options?: {});
+    /** @private */
+    private _lastTime;
+    _dragEndTime: number;
+    /** @private */
+    private _inertiaPosition;
+    _diffX: number;
+    _diffY: number;
+    _dir: any;
+    _dragPoint: any;
+    _lastDragPoint: any;
+    _velocity: number;
+    _lastDiffDistance: number;
+    _amplitudeX: number;
+    _amplitudeY: number;
+    _targetX: number;
+    _targetY: number;
+    start(x: any, y: any, time: any): void;
+    update(x: any, y: any, time: any): void;
+    startInertia(isOperateRotation?: boolean): void;
+    getInertiaPosition(time: any): any[];
+}

package/dist/types/threejs/controls/MapControl3D.d.ts

@@ -2,6 +2,7 @@ export class MapControl3D {
     constructor(map: any);
     map: any;
     currentAction: number;
+    isPointerDown: boolean;
     startX: any;
     startY: any;
     startCenterX: any;
@@ -21,6 +22,7 @@ export class MapControl3D {
     startScaleY: number;
     startBoundX: any;
     startBoundY: any;
+    startProjectionCenter: any;
     /** @private */
     private _enabled;
     enableInertia: boolean;
@@ -72,9 +74,10 @@ export class MapControl3D {
     private _clickPixelTolerance;
     /** @private */
     private _holdPixelTolerance;
+    lastMoveDistance: number;
     set enabled(enabled: any);
     _eventThrottle: EventThrottle;
-    _draggingMovementAggregator: PointerMovementAggregator;
+    _draggingMovementAggregator: DraggingMovementAggregator;
     _zoomMovementAggregator: PointerMovementAggregator;
     init: () => void;
     handlePointerDownWithThrottle: (e: any) => void;
@@ -108,6 +111,7 @@ export class MapControl3D {
     } | undefined;
     handlePointerUp: (e: any) => Promise<void>;
     _startInertiaAnimation: () => void;
+    _inInertia: boolean | undefined;
     _inertiaAnimationHanlder: number | undefined;
     handleMouseUp: (e: any) => Promise<void>;
     waitSecondClick: boolean | undefined;
@@ -117,6 +121,15 @@ export class MapControl3D {
     _startZoomInertiaAnimation: (pixelX: any, pixelY: any) => void;
     _zoomInertiaAnimationHandler: number | undefined;
     handleWheel: (e: any) => Promise<void>;
+    /**
+     * 计算视图距离
+     * @private
+     * @param {number} viewHeight 视图高度
+     * @param {number} pitch 俯仰角
+     * @param {number} fov 视场角
+     * @return {Object} 视图距离对象，包含中心到近端距离、中心到远端距离、相机到远端距离、是否超过最大俯仰角
+     */
+    private _calculateViewDistance;
     handlePan: (x: any, y: any) => Promise<void>;
     handleRotate: (x: any, y: any) => Promise<void>;
     handleZoom: (zoomOptions: any) => Promise<void>;
@@ -127,8 +140,21 @@ export class MapControl3D {
     getNdc(px: any, py: any, target: any): void;
     makeHeadingSafe: (heading: any) => any;
     makePitchSafe: (pitch: any) => any;
+    getElasticPitch: (deltaY: any) => any;
+    /**
+     * 计算弹性值，当原始值超过最大或最小值时
+     * @private
+     * @param {number} origin 原始值
+     * @param {number} minLimit 允许的最小值
+     * @param {number} maxLimit 允许的最大值
+     * @param {number} elasticValue 弹性系数
+     * @return {number} 经过弹性处理的值
+     */
+    private _getElasticValue;
+    _tiltBounceBack: () => void;
     _pickPosition(mouse: any): Promise<any>;
     dispose: () => void;
 }
 import { EventThrottle } from '../../threemap/engine/event/EventThrottle';
+import { DraggingMovementAggregator } from './DraggingMovementAggregator';
 import { PointerMovementAggregator } from './PointerMovementAggregator';

package/dist/types/threejs/geometries/line/FatLineGeometry.d.ts

@@ -6,6 +6,7 @@ export class FatLineGeometry extends ShadowVolumeLineGeometry {
     _needsUpdate: boolean;
     _needsCounter: boolean;
     _height: any;
+    _isCurve: any;
     _flags: {
         lastFlip: number;
         started: boolean;
@@ -44,5 +45,13 @@ export class FatLineGeometry extends ShadowVolumeLineGeometry {
     _flipedUV(uvs: any, distance: any, flip: any, bevel: any): void;
     set needsUpdate(value: boolean);
     get needsUpdate(): boolean;
+    set isCurve(value: boolean);
+    /**
+     * 是否自动生成贝塞尔曲线数据，线坐标中除了首尾点之外的点会失效，只取线数据的首尾点生成3D贝塞尔曲线
+     * @internal
+     * @deprecated
+     * @type {boolean}
+     */
+    get isCurve(): boolean;
 }
 import { ShadowVolumeLineGeometry } from '../ShadowVolumLineGeometry';

package/dist/types/threejs/geometries/line/PolylineGeometry.d.ts

@@ -6,6 +6,7 @@ export class PolylineGeometry {
     _needsUpdate: boolean;
     _needsCounter: boolean;
     _height: any;
+    _isCurve: any;
     _flags: {
         lastFlip: number;
         started: boolean;

package/dist/types/threejs/geometries/sphere/BasePillarGeometry.d.ts

@@ -1,4 +1,4 @@
-export class BasePillarGeometry extends CustomInstancedBufferGeometry {
+export class BasePillarGeometry {
     constructor(parameters: any);
     /** @private */
     private _needsUpdate;
@@ -41,4 +41,3 @@ export class BasePillarGeometry extends CustomInstancedBufferGeometry {
     set needsUpdate(value: boolean);
     get needsUpdate(): boolean;
 }
-import { CustomInstancedBufferGeometry } from '../../core/CustomInstancedBufferGeometry';

package/dist/types/threejs/loaders/gltf/metadata/PropertyTable.d.ts

@@ -17,7 +17,7 @@ export default PropertyTable;
  * </p>
  */
 declare class PropertyTable {
-    constructor(options?: any);
+    constructor(options?: Readonly<{}>);
     _name: any;
     _id: any;
     _count: any;

package/dist/types/threejs/materials/effects/ScanMaterial.d.ts

@@ -1,77 +1,88 @@
 /**
- * 扫描特效动画材质，由一个扫描动画和一个纹理动画组成，可通过配置动画的参数和纹理动画的参数来实现不同的效果
- * @example 普通扫描特效动画材质
- * ```
- * var material = new mapvthree.ScanMaterial({
- *      color: new THREE.Color(0x66aadd),
- *      size: [100, 40],
- *      speed: 500,
- *      direction: mapvthree.ScanMaterial.DIRECTION_VERTICAL,
- *      emissive: new THREE.Color(0x001144),
+ * 扫描特效动画材质，创建一个动态扫描线效果。
+ *
+ * 扫描特效由扫描动画和可选的纹理动画组成，支持垂直和水平两种扫描方向。
+ * 可以通过配置动画参数和纹理参数来实现不同的视觉效果，如雷达扫描、进度条等。
+ *
+ * @category Materials
+ * @example
+ * ```javascript
+ * // 普通扫描特效动画材质
+ * const material = new mapvthree.ScanMaterial({
+ *     color: new THREE.Color(0x66aadd),
+ *     size: [100, 40],
+ *     speed: 500,
+ *     direction: mapvthree.ScanMaterial.DIRECTION_VERTICAL,
+ *     emissive: new THREE.Color(0x001144),
  * });
  * ```
- * @example 带纹理打底的扫描特效动画材质
- * ```
- * var material = new mapvthree.ScanMaterial({
- *      mapSrc: 'website_assets/floor/radar.png',
- *      mapSize: [5, 10],
- *      mapSpeed: 40,
- *      color: new THREE.Color('#fff'),
- *      size: [36, 36],
- *      sizeRatio: 0.7,
- *      speed: 80,
- *      direction: mapvthree.ScanMaterial.DIRECTION_VERTICAL,
- *      emissive: new THREE.Color(0x002288),
+ * @example
+ * ```javascript
+ * // 带纹理打底的扫描特效动画材质
+ * const material = new mapvthree.ScanMaterial({
+ *     mapSrc: 'website_assets/floor/radar.png',
+ *     mapSize: [5, 10],
+ *     mapSpeed: 40,
+ *     color: new THREE.Color('#fff'),
+ *     size: [36, 36],
+ *     sizeRatio: 0.7,
+ *     speed: 80,
+ *     direction: mapvthree.ScanMaterial.DIRECTION_VERTICAL,
+ *     emissive: new THREE.Color(0x002288),
  * });
  * ```
- * @example 带纹理遮罩的扫描特效动画材质
- * ```
- * var material = new mapvthree.ScanMaterial({
- *      maskMap: new THREE.TextureLoader().load('website_assets/floor/mask.png'),
- *      color: new THREE.Color('#fff'),
- *      size: [1, 0.05],
- *      speed: 0.1,
- *      emissive: new THREE.Color(0x001155),
+ * @example
+ * ```javascript
+ * // 带纹理遮罩的扫描特效动画材质
+ * const material = new mapvthree.ScanMaterial({
+ *     maskMap: new THREE.TextureLoader().load('website_assets/floor/mask.png'),
+ *     color: new THREE.Color('#fff'),
+ *     size: [1, 0.05],
+ *     speed: 0.1,
+ *     emissive: new THREE.Color(0x001155),
  * });
  * ```
  */
 export class ScanMaterial extends EffectCommonMaterial {
+    /**
+     * 垂直扫描方向
+     * @type {number}
+     */
     static DIRECTION_VERTICAL: number;
+    /**
+     * 水平扫描方向
+     * @type {number}
+     */
     static DIRECTION_HORIZONTAL: number;
     /**
      * 构造函数
-     * @param {{
-    * direction?: number, speed?: number, size?: Array<number>, sizeRatio?: number,
-    * color?: string | number | THREE.Color, opacity?: number, emissive?: string | number | THREE.Color,
-    * mapSrc?: string, mapColor?: Array<number>, mapSpeed?: number, mapSize?: Array<number>,
-    * maskMap?: THREE.Texture
-    * }} parameters 材质参数，所有被Material类及其子类接受的参数。
-    * @param {number} parameters.direction 扫描动画方向，可选值有`ScanMaterial.DIRECTION_VERTICAL`和`ScanMaterial.DIRECTION_HORIZONTAL`
-    * @param {number} parameters.speed 扫描动画速度，默认值为1
-    * @param {Array<number>} parameters.size 整体效果尺寸大小，默认值为[1, 1]，单位为米
-    * @param {number} parameters.sizeRatio 扫描动画部分占整体的比例值，默认1填满，比如0.5表示特效占整体的1/2
-    * @param {string | number | THREE.Color} parameters.color 动画效果颜色，默认值为0xffffff
-    * @param {number} parameters.opacity 整体效果透明度，默认值为1
-    * @param {string | number | THREE.Color} parameters.emissive 自发光颜色，默认值为0x000000，即不发光
-    * @param {string} parameters.mapSrc 纹理动画的纹理图片地址，如果不设置则没有纹理动画
-    * @param {Array<number>} parameters.mapColor 纹理动画的颜色，默认值为[1, 1, 1]
-    * @param {number} parameters.mapSpeed 纹理动画的速度，默认值为1
-    * @param {Array<number>} parameters.mapSize 纹理动画的尺寸，默认值为[1, 1]，单位为米
-    * @param {THREE.Texture} parameters.maskMap 动画的遮罩图层，预期传入一张透明遮罩纹理，透明部分为不显示的部分，不透明部分为显示的部分，不设置则没有遮罩效果
-    */
+     * @param {Object} parameters 材质参数
+     * @param {number} [parameters.direction] 扫描动画方向，可选值有`ScanMaterial.DIRECTION_VERTICAL`和`ScanMaterial.DIRECTION_HORIZONTAL`，默认为1
+     * @param {number} [parameters.speed] 扫描动画速度，默认为1
+     * @param {Array<number>} [parameters.size] 整体效果尺寸大小，默认为[1, 1]，单位为米
+     * @param {number} [parameters.sizeRatio] 扫描动画部分占整体的比例值，默认为1（填满），0.5表示特效占整体的1/2
+     * @param {string|number|THREE.Color} [parameters.color] 动画效果颜色，默认为0xffffff
+     * @param {number} [parameters.opacity] 整体效果透明度，默认为1
+     * @param {string|number|THREE.Color} [parameters.emissive] 自发光颜色，默认为0x000000（不发光）
+     * @param {string} [parameters.mapSrc] 纹理动画的纹理图片地址，不设置则没有纹理动画
+     * @param {Array<number>} [parameters.mapColor] 纹理动画的颜色，默认为[1, 1, 1]
+     * @param {number} [parameters.mapSpeed] 纹理动画的速度，默认为1
+     * @param {Array<number>} [parameters.mapSize] 纹理动画的尺寸，默认为[1, 1]，单位为米
+     * @param {THREE.Texture} [parameters.maskMap] 动画的遮罩图层，透明部分不显示，不透明部分显示，不设置则没有遮罩效果
+     */
     constructor(parameters: {
-        direction?: number;
-        speed?: number;
-        size?: Array<number>;
-        sizeRatio?: number;
+        direction?: number | undefined;
+        speed?: number | undefined;
+        size?: number[] | undefined;
+        sizeRatio?: number | undefined;
         color?: string | number | THREE.Color;
-        opacity?: number;
+        opacity?: number | undefined;
         emissive?: string | number | THREE.Color;
-        mapSrc?: string;
-        mapColor?: Array<number>;
-        mapSpeed?: number;
-        mapSize?: Array<number>;
-        maskMap?: THREE.Texture;
+        mapSrc?: string | undefined;
+        mapColor?: number[] | undefined;
+        mapSpeed?: number | undefined;
+        mapSize?: number[] | undefined;
+        maskMap?: any;
     });
     name: string;
     transparent: boolean;

package/dist/types/threejs/materials/effects/TwinkleMaterial.d.ts

@@ -1,61 +1,74 @@
 /**
- * 闪烁特效动画材质，可以通过设置effectType属性，实现方块闪烁效果和波纹闪烁效果
- * @example 方块闪烁特效动画材质
- * ```
- * var material = new mapvthree.TwinkleMaterial({
- *      mapSrc: 'website_assets/floor/texture.png',
- *      color: new THREE.Color('#fff'),
- *      opacity: 0.5,
- *      size: [50, 20],
- *      speed: 1,
- *      effectType: mapvthree.TwinkleMaterial.TYPE_BLINK,
- *      emissive: new THREE.Color(0x001155),
+ * 闪烁特效动画材质，创建动态闪烁效果。
+ *
+ * 支持两种闪烁类型：方块闪烁和波纹闪烁。方块闪烁创建简单的明暗交替效果，
+ * 波纹闪烁创建从中心向外扩散的波纹效果。可以通过配置动画参数和纹理参数
+ * 来实现不同的视觉效果。
+ *
+ * @category Materials
+ * @example
+ * ```javascript
+ * // 方块闪烁特效动画材质
+ * const material = new mapvthree.TwinkleMaterial({
+ *     mapSrc: 'website_assets/floor/texture.png',
+ *     color: new THREE.Color('#fff'),
+ *     opacity: 0.5,
+ *     size: [50, 20],
+ *     speed: 1,
+ *     effectType: mapvthree.TwinkleMaterial.TYPE_BLINK,
+ *     emissive: new THREE.Color(0x001155),
  * });
  * ```
- * @example 波纹闪烁特效动画材质
- * ```
- * var material = new mapvthree.TwinkleMaterial({
- *      mapSrc: 'website_assets/floor/texture.png',
- *      color: new THREE.Color('#fff'),
- *      opacity: 0.5,
- *      size: [50, 20],
- *      spreadSize: 1,
- *      spreadColor: new THREE.Color('#fff'),
- *      speed: 1,
- *      effectType: mapvthree.TwinkleMaterial.TYPE_RIPPLE,
- *      emissive: new THREE.Color(0x001155),
+ * @example
+ * ```javascript
+ * // 波纹闪烁特效动画材质
+ * const material = new mapvthree.TwinkleMaterial({
+ *     mapSrc: 'website_assets/floor/texture.png',
+ *     color: new THREE.Color('#fff'),
+ *     opacity: 0.5,
+ *     size: [50, 20],
+ *     spreadSize: 1,
+ *     spreadColor: new THREE.Color('#fff'),
+ *     speed: 1,
+ *     effectType: mapvthree.TwinkleMaterial.TYPE_RIPPLE,
+ *     emissive: new THREE.Color(0x001155),
  * });
  * ```
  */
 export class TwinkleMaterial extends EffectCommonMaterial {
+    /**
+     * 方块闪烁类型
+     * @type {number}
+     */
     static TYPE_BLINK: number;
+    /**
+     * 波纹闪烁类型
+     * @type {number}
+     */
     static TYPE_RIPPLE: number;
     /**
      * 构造函数
-     * @param {{
-    * speed?: number, size?: Array<number>,
-    * color?: string | number | THREE.Color, opacity?: number, emissive?: string | number | THREE.Color,
-    * mapSrc?: string, spreadColor?: string | number | THREE.Color, spreadSize?: number
-    * }} parameters 材质参数，所有被Material类及其子类接受的参数。
-    * @param {number} parameters.effectType 闪烁动画类型，可选值有`TwinkleMaterial.TYPE_BLINK`和`TwinkleMaterial.TYPE_RIPPLE`
-    * @param {number} parameters.speed 闪烁动画速度，默认值为1
-    * @param {Array<number>} parameters.size 整体效果尺寸大小，默认值为[1, 1]，单位为米
-    * @param {string | number | THREE.Color} parameters.color 动画效果颜色，默认值为0xffffff
-    * @param {number} parameters.opacity 整体效果透明度，默认值为1
-    * @param {string | number | THREE.Color} parameters.emissive 自发光颜色，默认值为0x000000，即不发光
-    * @param {string} parameters.mapSrc 打底纹理的图片地址，如果不设置则没有纹理打底
-    * @param {string | number | THREE.Color} parameters.spreadColor 仅当`effectType`为`TwinkleMaterial.TYPE_RIPPLE`时有效，表示波纹的颜色，默认值为0xffffff
-    * @param {number} parameters.spreadSize 仅当`effectType`为`TwinkleMaterial.TYPE_RIPPLE`时有效，表示波纹的扩散大小，默认值为1
-    */
+     * @param {Object} parameters 材质参数
+     * @param {number} [parameters.effectType] 闪烁动画类型，可选值有`TwinkleMaterial.TYPE_BLINK`和`TwinkleMaterial.TYPE_RIPPLE`，默认为1
+     * @param {number} [parameters.speed] 闪烁动画速度，默认为1
+     * @param {Array<number>} [parameters.size] 整体效果尺寸大小，默认为[1, 1]，单位为米
+     * @param {string|number|THREE.Color} [parameters.color] 动画效果颜色，默认为0xffffff
+     * @param {number} [parameters.opacity] 整体效果透明度，默认为1
+     * @param {string|number|THREE.Color} [parameters.emissive] 自发光颜色，默认为0x000000（不发光）
+     * @param {string} [parameters.mapSrc] 打底纹理的图片地址，不设置则没有纹理打底
+     * @param {string|number|THREE.Color} [parameters.spreadColor] 仅当`effectType`为`TwinkleMaterial.TYPE_RIPPLE`时有效，表示波纹的颜色，默认为0xffffff
+     * @param {number} [parameters.spreadSize] 仅当`effectType`为`TwinkleMaterial.TYPE_RIPPLE`时有效，表示波纹的扩散大小，默认为1
+     */
     constructor(parameters: {
-        speed?: number;
-        size?: Array<number>;
+        effectType?: number | undefined;
+        speed?: number | undefined;
+        size?: number[] | undefined;
         color?: string | number | THREE.Color;
-        opacity?: number;
+        opacity?: number | undefined;
         emissive?: string | number | THREE.Color;
-        mapSrc?: string;
+        mapSrc?: string | undefined;
         spreadColor?: string | number | THREE.Color;
-        spreadSize?: number;
+        spreadSize?: number | undefined;
     });
     name: string;
     transparent: boolean;

package/dist/types/threejs/materials/effects/WindowMaterial.d.ts

@@ -1,40 +1,51 @@
 /**
- * 窗户特效动画材质
- * ```
- * var material = new mapvthree.WindowMaterial({
- *    color: new THREE.Color(0xffffff),
- *    size: [1, 1],
- *    effectSize: [1, 1],
- *    speed: 1,
- *    emissive: new THREE.Color(0x001155),
- *    direction: mapvthree.WindowMaterial.DIRECTION_VERTICAL
+ * 窗户特效动画材质，创建动态窗户效果。
+ *
+ * 窗户特效模拟窗户的开关动画，支持垂直和水平两种开关方向。
+ * 可以通过配置动画参数来实现不同的视觉效果，如门窗开关、遮罩动画等。
+ *
+ * @category Materials
+ * @example
+ * ```javascript
+ * const material = new mapvthree.WindowMaterial({
+ *     color: new THREE.Color(0xffffff),
+ *     size: [1, 1],
+ *     effectSize: [1, 1],
+ *     speed: 1,
+ *     emissive: new THREE.Color(0x001155),
+ *     direction: mapvthree.WindowMaterial.DIRECTION_VERTICAL
  * });
  * ```
  */
 export class WindowMaterial extends EffectCommonMaterial {
+    /**
+     * 垂直开关方向
+     * @type {number}
+     */
     static DIRECTION_VERTICAL: number;
+    /**
+     * 水平开关方向
+     * @type {number}
+     */
     static DIRECTION_HORIZONTAL: number;
     /**
      * 构造函数
-     * @param {{
-    * direction?: number, speed?: number, effectSize?: Array<number>, size?: Array<number>,
-    * color?: string | number | THREE.Color, opacity?: number, emissive?: string | number | THREE.Color
-    * }} parameters 材质参数，所有被Material类及其子类接受的参数。
-    * @param {number} parameters.direction 窗户动画方向，可选值有`WindowMaterial.DIRECTION_VERTICAL`和`WindowMaterial.DIRECTION_HORIZONTAL`
-    * @param {number} parameters.speed 窗户动画速度，默认值为1
-    * @param {Array<number>} parameters.size 整体效果尺寸大小，默认值为[1, 1]，单位为米
-    * @param {Array<number>} parameters.effectSize 窗户动画效果大小，默认值为[0.5, 0.5]，单位为米
-    * @param {string | number | THREE.Color} parameters.color 动画效果颜色，默认值为0xffffff
-    * @param {number} parameters.opacity 整体效果透明度，默认值为1
-    * @param {string | number | THREE.Color} parameters.emissive 自发光颜色，默认值为0x000000，即不发光
-    */
+     * @param {Object} parameters 材质参数
+     * @param {number} [parameters.direction] 窗户动画方向，可选值有`WindowMaterial.DIRECTION_VERTICAL`和`WindowMaterial.DIRECTION_HORIZONTAL`，默认为1
+     * @param {number} [parameters.speed] 窗户动画速度，默认为1
+     * @param {Array<number>} [parameters.size] 整体效果尺寸大小，默认为[1, 1]，单位为米
+     * @param {Array<number>} [parameters.effectSize] 窗户动画效果大小，默认为[0.5, 0.5]，单位为米
+     * @param {string|number|THREE.Color} [parameters.color] 动画效果颜色，默认为0xffffff
+     * @param {number} [parameters.opacity] 整体效果透明度，默认为1
+     * @param {string|number|THREE.Color} [parameters.emissive] 自发光颜色，默认为0x000000（不发光）
+     */
     constructor(parameters: {
-        direction?: number;
-        speed?: number;
-        effectSize?: Array<number>;
-        size?: Array<number>;
+        direction?: number | undefined;
+        speed?: number | undefined;
+        size?: number[] | undefined;
+        effectSize?: number[] | undefined;
         color?: string | number | THREE.Color;
-        opacity?: number;
+        opacity?: number | undefined;
         emissive?: string | number | THREE.Color;
     });
     name: string;

package/dist/types/threejs/materials/heatmap/Heatmap3D.d.ts

@@ -3,6 +3,8 @@ export class Heatmap3DMaterial extends CommonShaderMaterial {
     isHeatmapMaterial: boolean;
     fog: boolean;
     lights: boolean;
+    side: any;
+    forceSinglePass: boolean;
     transparent: boolean;
     depthWrite: boolean;
     depthTest: boolean;