@baidumap/mapv-three 1.0.1 → 1.2.0

package/dist/types/Internal.d.ts

@@ -16,5 +16,3 @@ 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/index.d.ts

@@ -9,10 +9,9 @@ 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";
+export { DefaultQuadMapMaterialManager } from "./threemap/mapView/materialManager/DefaultQuadMapMaterialManager";
+export { DarkMVTMaterialManager } from "./threemap/mapView/materialManager/DarkMVTMaterialManager";
+export { CustomMVTMaterialManager } from "./threemap/mapView/materialManager/CustomMVTMaterialManager";
 export { MapView } from "./threemap/mapView/map/MapView";
 export * as mapViewConstants from "./threemap/mapView/constants";
 export { RasterSurface } from "./threemap/mapView/surface/RasterSurface";
@@ -23,6 +22,7 @@ export { TileProvider } from "./threemap/mapView/tileProvider/TileProvider";
 export { ImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/ImageryTileProvider";
 export { TerrainTileProvider } from "./threemap/mapView/tileProvider/terrain/TerrainTileProvider";
 export { VectorTileProvider } from "./threemap/mapView/tileProvider/vector/VectorTileProvider";
+export { StadiaImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/StadiaImageryTileProvider";
 export { BingImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/BingImageryTileProvider";
 export { OSMImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/OSMImageryTileProvider";
 export { TiandituImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/TiandituImageryTileProvider";
@@ -38,10 +38,14 @@ export { GeoJSONVectorTileProvider } from "./threemap/mapView/tileProvider/vecto
 export { BaiduTrafficTileProvider } from "./threemap/mapView/tileProvider/vector/BaiduTrafficTileProvider";
 export { MapboxVectorTileProvider } from "./threemap/mapView/tileProvider/vector/MapboxVectorTileProvider";
 export { HDTrafficTileProvider } from "./threemap/mapView/tileProvider/vector/HDTrafficTileProvider";
+export { GenericDefinedProjection } from "./threemap/projections/GenericDefinedProjection";
+export { projectionDefs } from "./threemap/projections/projections";
+export { CoordTransformer } from "./threemap/projections/CoordTransformer";
 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";
@@ -76,7 +80,6 @@ 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";
@@ -118,8 +121,8 @@ 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";
@@ -140,8 +143,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";
@@ -175,4 +178,5 @@ export * from "./threemap/constants";
 export { BingImageryMap, OSMImageryMap, XYZImageryMap, BaiduImageryMap, OGCMap, MVTMap, BaiduVectorMap, BaiduTrafficVectorMap, HDTrafficMap, CesiumTerrain } from "./threemap/mapView/map/QuadMap";
 export { BaiduMapConfig, CesiumConfig, MapboxConfig, TiandituConfig } from "./threemap/mapView/configs";
 export { TileLightManager, LampRequest, DefaultLampRequest } from "./threejs/objects/element/TileLightManager";
+export { EditorManager, EditorStyle } from "./threemap/controls/editors/EditorManager";
 export { MeshFeaturesMaterial, MeshFeaturesMaterialMixin } from "./threejs/loaders/gltf/MeshFeaturesMaterial";

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";
@@ -13,13 +14,21 @@ export { TileProvider } from "./threemap/mapView/tileProvider/TileProvider";
 export { ImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/ImageryTileProvider";
 export { TerrainTileProvider } from "./threemap/mapView/tileProvider/terrain/TerrainTileProvider";
 export { VectorTileProvider } from "./threemap/mapView/tileProvider/vector/VectorTileProvider";
+export { StadiaImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/StadiaImageryTileProvider";
 export { BingImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/BingImageryTileProvider";
 export { OSMImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/OSMImageryTileProvider";
 export { TiandituImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/TiandituImageryTileProvider";
+export { XYZImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/XYZImageryTileProvider";
+export { Baidu09ImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/Baidu09ImageryTileProvider";
+export { WMSImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/WMSImageryTileProvider";
+export { WMTSImageryTileProvider } from "./threemap/mapView/tileProvider/imagery/WMTSImageryTileProvider";
 export { PlaneTerrainTileProvider } from "./threemap/mapView/tileProvider/terrain/PlaneTerrainTileProvider";
 export { CesiumTerrainTileProvider } from "./threemap/mapView/tileProvider/terrain/CesiumTerrainTileProvider";
 export { BaiduVectorTileProvider } from "./threemap/mapView/tileProvider/vector/BaiduVectorTileProvider";
+export { BaiduTrafficTileProvider } from "./threemap/mapView/tileProvider/vector/BaiduTrafficTileProvider";
+export { MapboxVectorTileProvider } from "./threemap/mapView/tileProvider/vector/MapboxVectorTileProvider";
 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 +41,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 { 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";
@@ -53,4 +70,4 @@ export * as modelUtils from "./threejs/utils/model";
 export * as requestUtils from "./util/request";
 export * as objectUtils from "./util/object";
 export * from "./threemap/constants";
-export { BaiduMapConfig, CesiumConfig, TiandituConfig } from "./threemap/mapView/configs";
+export { BaiduMapConfig, CesiumConfig, MapboxConfig, TiandituConfig } from "./threemap/mapView/configs";

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

@@ -28,7 +28,6 @@ export class MapControl3D {
     enableInertia: boolean;
     minPitch: number;
     maxPitch: number;
-    nearMaxPitch: number;
     zoomSpeed: number;
     headingSpeed: number;
     pitchSpeed: number;
@@ -141,6 +140,7 @@ export class MapControl3D {
     getNdc(px: any, py: any, target: any): void;
     makeHeadingSafe: (heading: any) => any;
     makePitchSafe: (pitch: any) => any;
+    getElasticPitch: (deltaY: any) => any;
     /**
      * 计算弹性值，当原始值超过最大或最小值时
      * @private

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/PillarGeometry.d.ts

@@ -1,6 +1,10 @@
 export class PillarGeometry extends BasePillarGeometry {
     type: string;
+    isCone(): boolean;
+    addRadiusFunc(v: any): number;
     generateTorso(indices: any, vertices: any, normals: any, uvs: any, colors: any, helperVar: any): void;
     generateCap(top: any, indices: any, vertices: any, normals: any, uvs: any, colors: any, helperVar: any): void;
+    generateTopSphere(indices: any, vertices: any, normals: any, uvs: any, colors: any, helperVar: any): void;
+    addCustomGeometry(indices: any, vertices: any, normals: any, uvs: any, colors: any, helperVar: any): void;
 }
 import { BasePillarGeometry } from './BasePillarGeometry';

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;