@baidumap/mapv-three 1.1.3 → 1.2.1

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,9 +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 { 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";
@@ -22,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";
@@ -37,6 +38,9 @@ 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";
@@ -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";
@@ -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

@@ -14,12 +14,19 @@ 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";
@@ -63,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/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/point/Effect.d.ts

@@ -0,0 +1,13 @@
+export class InstancedEffectMaterial extends InstancedEffectPointMaterial {
+    constructor(parameters?: {});
+    name: string;
+    depthTest: boolean;
+    depthWrite: boolean;
+    transparent: boolean;
+    vertexShader: any;
+    fragmentShader: any;
+    isBreath: boolean;
+    noAnimation: boolean;
+    animationRotate: boolean;
+}
+import { InstancedEffectPointMaterial } from './EffectPoint';

package/dist/types/threejs/materials/sphere/PillarMaterial.d.ts

@@ -3,12 +3,16 @@ export class PillarMaterial extends InstancedEffectPointMaterial {
     isPillarMaterial: boolean;
     vertexShader: any;
     fragmentShader: any;
-    side: any;
     transparent: boolean;
     _cachedGradient: any;
+    _cachedBandColors: any;
+    _colorMode: any;
     createGradientMap(): void;
     _cachedGradientMap: any;
+    createBandMap(): void;
+    _cachedBandMap: any;
     updateGradientMap(): void;
+    updateBandMap(): void;
     dispose(): void;
 }
 import { InstancedEffectPointMaterial } from '../point/EffectPoint';

package/dist/types/threejs/objects/FadeData.d.ts

@@ -2,6 +2,7 @@
  * fadeOpacity: 0-1 淡入  3-2淡出，通过值可判断fade方向
  */
 export class FadeData {
+    constructor(options?: {});
     /** @private */
     private _fadeDuration;
     /** @private */

package/dist/types/threejs/objects/element/OctahedralImpostor.d.ts

@@ -1,37 +1,27 @@
-/**
- * 八面体替代渲染类
- */
 export class OctahedralImpostor extends GeoInstancedMesh {
-    static textureLoader: any;
+    static imageBitmapLoader: any;
     static defaultTextures: {
         diffuse: null;
         normalDepth: null;
         orm: null;
     };
-    /**
-     * 初始化默认纹理（如果尚未加载）
-     */
-    static initDefaultTextures(): void;
-    static createTextures(diffuseUrl: any, normalDepthUrl: any, ormUrl: any): {
+    static initDefaultTextures(): Promise<void>;
+    static createTextures(diffuseUrl: any, normalDepthUrl: any, ormUrl: any): Promise<{
         diffuseTexture: any;
         normalDepthTexture: any;
         ormTexture: any;
-    };
-    /**
-     * 构造函数
-     * @param {Object} parameters - 配置参数
-     */
-    constructor(parameters?: Object);
-    parameters: Object;
+    }>;
+    constructor(parameters?: {});
+    parameters: {};
     offsetZ: any;
     modelDistance: any;
     imposterScale: any;
     hasLastResult: boolean;
     lastCameraPosition: any;
-    /**
-     * 初始化纹理
-     */
-    initTextures(): void;
+    _texturesInitialized: boolean;
+    _geometryInitialized: boolean;
+    initialize(): Promise<void>;
+    initTextures(): Promise<void>;
     diffuseTexture: any;
     normalDepthTexture: any;
     ormTexture: any;

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

@@ -30,6 +30,8 @@ export class EffectModelPoint extends GeoObject {
      * @param {boolean} [parameters.animationJump=false] 是否启用跳跃动画
      * @param {number} [parameters.animationJumpPeriod=3000] 跳跃一次的时间周期，单位毫秒
      * @param {number} [parameters.animationJumpHeight=30] 跳跃高度
+     * @param {boolean} [parameters.vertexColors=false] 是否使用顶点颜色
+     * @param {boolean} [parameters.vertexSizes=false] 是否使用顶点大小
      */
     constructor(parameters: {
         normalize?: boolean | undefined;
@@ -40,6 +42,8 @@ export class EffectModelPoint extends GeoObject {
         animationJump?: boolean | undefined;
         animationJumpPeriod?: number | undefined;
         animationJumpHeight?: number | undefined;
+        vertexColors?: boolean | undefined;
+        vertexSizes?: boolean | undefined;
     });
     /** @private */ private _model;
     /** @private */ private _normalize;
@@ -68,6 +72,8 @@ export class EffectModelPoint extends GeoObject {
         animationJump?: boolean | undefined;
         animationJumpPeriod?: number | undefined;
         animationJumpHeight?: number | undefined;
+        vertexColors?: boolean | undefined;
+        vertexSizes?: boolean | undefined;
     };
     /**
      * 加载默认模型，多个实例共享一个模型模版

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

@@ -23,35 +23,48 @@
  * }));
  * ```
  */
-export class EffectPoint {
+export class EffectPoint extends GeoInstancedPointMesh {
     /**
      * 构造函数
-     * @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
+     * @param {{color?: string, size?: number, duration?: number, type?: string, keepSize?: boolean
+     * vertexColors?: boolean, vertexSizes?: boolean, segmentAngle?: number,
+     * sideColor?: string}} 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 是否通过数据携带尺寸配置
+     * @param {number} parameters.segmentAngle 雷达的扇形弧度值，仅在type为Radar时有效
+     * @param {string} parameters.sideColor 最外圈底色，仅在type为RadarLayered时有效
      */
     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;
+        color?: string;
+        size?: number;
+        duration?: number;
+        type?: string;
+        keepSize?: boolean;
+        vertexColors?: boolean;
+        vertexSizes?: boolean;
+        segmentAngle?: number;
+        sideColor?: string;
     });
-    /** @internal */ _object: BubblePoint | FanPoint;
+    /** 气泡颜色 */ color: any;
+    /** 气泡尺寸 */ size: any;
+    /** 气泡动画间隔时长 */ duration: any;
+    /** 气泡类型 */ type: any;
+    parameters: {
+        color?: string;
+        size?: number;
+        duration?: number;
+        type?: string;
+        keepSize?: boolean;
+        vertexColors?: boolean;
+        vertexSizes?: boolean;
+        segmentAngle?: number;
+        sideColor?: string;
+    };
+    clone(): any;
 }
-import { BubblePoint } from './BubblePoint';
-import { FanPoint } from './FanPoint';
+import { GeoInstancedPointMesh } from './GeoInstancedPointMesh';

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

@@ -201,6 +201,7 @@ export class Label extends GeoMesh {
         pixelOffset?: any[] | undefined;
         positionOffset?: any[] | undefined;
     });
+    isEventEntitySupported: boolean;
     /**
      * @type {LabelMeshParameters}
      */
@@ -427,6 +428,13 @@ export class Label extends GeoMesh {
     updateTextSprite(renderedData: any): Promise<void>;
     getTextureAndHash(data: any, texturePropName: any, width: any, height: any, isDataChanged: any): any;
     updateIconSprite(): Map<any, any>;
+    /** @protected */
+    protected getEntityByIndex(index: any): {
+        index: any;
+        value: any;
+        itemIndex: any;
+        pairs: {};
+    };
     updateTextTexture(characterSet: any): Promise<void>;
     _fontSettings: {
         fontSize: number;

package/dist/types/threejs/objects/polygon/Polygon.d.ts

@@ -1,88 +1,256 @@
+/**
+ * 填充多边形（不含描边），可沿Z轴拉伸高度成多边形柱状体
+ *
+ * 支持以下功能：
+ * - 基础多边形填充渲染
+ * - Z轴拉伸创建3D柱状体
+ * - 贴地渲染（Ground Primitive）
+ * - 纹理贴图支持
+ * - 顶点颜色和高度配置
+ *
+ * @category Objects
+ * @example
+ * ```javascript
+ * // 创建基础多边形
+ * const polygon = engine.add(new mapvthree.Polygon({
+ *     vertexColors: true,
+ *     extrude: true,
+ *     extrudeValue: 100,
+ * }));
+ *
+ * // 设置数据源
+ * let data = mapvthree.GeoJSONDataSource.fromGeoJSON(data);
+ * data.defineAttribute('color', 'color');
+ * polygon.dataSource = data;
+ * ```
+ *
+ * @example
+ * ```javascript
+ * // 创建贴地多边形
+ * const groundPolygon = engine.add(new mapvthree.Polygon({
+ *     isGroundPrimitive: true,
+ *     color: 'rgba(255, 0, 0, 0.5)',
+ *     opacity: 0.8
+ * }));
+ * ```
+ * ![](media://polygon.png)
+ */
 export class Polygon extends GeoMesh {
     /**
-     * 构造函数
-     * @param {{
-     * extrude?: boolean, extrudeValue?: number,
-     * color?: string, vertexColors?: boolean, opacity?: number, emissive?: string,
-     * mapSrc?: string, mapScale?:number
-     * }} parameters 传入参数对象
-     * @param {boolean} parameters.extrude 是否拉伸，默认否
-     * @param {number} parameters.extrudeValue 拉伸高度，默认100
-     * @param {boolean} parameters.vertexHeights 是否通过数据携带高度配置，默认否
-     * @param {boolean} parameters.enableBottomFace 是否封闭底面
-     * @param {string} parameters.color 填充颜色
-     * @param {boolean} parameters.vertexColors 是否通过数据携带颜色配置，默认否
-     * @param {string} parameters.emissive 自发光颜色
-     * @param {number} parameters.opacity 整体透明度系数，默认1
-     * @param {string} parameters.mapSrc 纹理贴图，默认''
-     * @param {number} parameters.mapScale 贴图的缩放大小，仅在使用纹理贴图时有效，默认1
-     * @param {number} parameters.zOffset 整体高度抬升
-     * @param {number} parameter.normalOffset 沿法线方向抬升
-     * @param {boolean} parameter.perPositionHeight 使用顶点高度，若不指定，则即使设置了高度也当0处理, 默认为true
+     * 创建多边形渲染对象
+     * @param {Object} parameters 传入参数对象
+     * @param {boolean} [parameters.extrude=false] 是否拉伸，默认否
+     * @param {number} [parameters.extrudeValue=100] 拉伸高度，默认100
+     * @param {boolean} [parameters.vertexHeights=false] 是否通过数据携带高度配置，默认否
+     * @param {boolean} [parameters.enableBottomFace=true] 是否封闭底面
+     * @param {string} [parameters.color='#ffffff'] 填充颜色
+     * @param {boolean} [parameters.vertexColors=false] 是否通过数据携带颜色配置，默认否
+     * @param {string} [parameters.emissive='#000000'] 自发光颜色
+     * @param {number} [parameters.opacity=1] 整体透明度系数，默认1
+     * @param {string} [parameters.mapSrc=''] 纹理贴图，默认''
+     * @param {number} [parameters.mapScale=1] 贴图的缩放大小，仅在使用纹理贴图时有效，默认1
+     * @param {number} [parameters.zOffset=0] 整体高度抬升
+     * @param {number} [parameters.normalOffset=0] 沿法线方向抬升
+     * @param {boolean} [parameters.perPositionHeight=true] 使用顶点高度，若不指定，则即使设置了高度也当0处理, 默认为true
+     * @param {boolean} [parameters.isGroundPrimitive=false] 是否为贴地渲染
+     * @param {boolean} [parameters.isDynamic=false] 是否需要动态调整数据源，贴地时使用
+     * @param {Array} [parameters.excludeElements=[]] 排除的元素列表
+     * @param {number} [parameters.renderOrder=0] 渲染顺序
+     * @param {number} [parameters.nearScale=5] 深度图near值缩放系数
+     * @example
+     * ```javascript
+     * const polygon = new mapvthree.Polygon({
+     *     extrude: true,
+     *     extrudeValue: 150,
+     *     color: 'rgba(255, 0, 0, 0.8)',
+     *     vertexColors: true,
+     *     opacity: 0.9
+     * });
+     * ```
      */
     constructor(parameters?: {
-        extrude?: boolean;
-        extrudeValue?: number;
-        color?: string;
-        vertexColors?: boolean;
-        opacity?: number;
-        emissive?: string;
-        mapSrc?: string;
-        mapScale?: number;
+        extrude?: boolean | undefined;
+        extrudeValue?: number | undefined;
+        vertexHeights?: boolean | undefined;
+        enableBottomFace?: boolean | undefined;
+        color?: string | undefined;
+        vertexColors?: boolean | undefined;
+        emissive?: string | undefined;
+        opacity?: number | undefined;
+        mapSrc?: string | undefined;
+        mapScale?: number | undefined;
+        zOffset?: number | undefined;
+        normalOffset?: number | undefined;
+        perPositionHeight?: boolean | undefined;
+        isGroundPrimitive?: boolean | undefined;
+        isDynamic?: boolean | undefined;
+        excludeElements?: any[] | undefined;
+        renderOrder?: number | undefined;
+        nearScale?: number | undefined;
     });
-    isEventEntitySupported: boolean;
+    /**
+     * 是否支持返回的事件参数中携带entity实体数据
+     * @type {boolean}
+     * @readonly
+     */
+    readonly isEventEntitySupported: boolean;
     /** @protected */ protected geometry: any;
     /** @protected */ protected material: any;
-    /** boolean，是否拉伸 */
-    extrude: any;
-    /** number，拉伸高度 */
-    extrudeValue: any;
-    /** string，填充颜色 */
-    color: any;
-    /** boolean，是否通过数据携带颜色配置 */
-    vertexColors: any;
-    /** string，自发光颜色 */
-    emissive: any;
-    /** number，整体透明度系数 */
-    opacity: any;
-    /** number，贴图的缩放大小，仅在使用纹理贴图时有效 */
-    mapScale: any;
+    /**
+     * 是否拉伸多边形
+     * @type {boolean}
+     * @example
+     * ```javascript
+     * polygon.extrude = true;
+     * ```
+     */
+    extrude: boolean;
+    /**
+     * 拉伸高度值
+     * @type {number}
+     * @example
+     * ```javascript
+     * polygon.extrudeValue = 200;
+     * ```
+     */
+    extrudeValue: number;
+    /**
+     * 填充颜色
+     * @type {string}
+     * @example
+     * ```javascript
+     * polygon.color = 'rgba(255, 0, 0, 0.8)';
+     * ```
+     */
+    color: string;
+    /**
+     * 是否通过数据携带颜色配置
+     * @type {boolean}
+     * @example
+     * ```javascript
+     * polygon.vertexColors = true;
+     * ```
+     */
+    vertexColors: boolean;
+    /**
+     * 自发光颜色
+     * @type {string}
+     * @example
+     * ```javascript
+     * polygon.emissive = 'rgba(0, 255, 0, 0.5)';
+     * ```
+     */
+    emissive: string;
+    /**
+     * 整体透明度系数
+     * @type {number}
+     * @example
+     * ```javascript
+     * polygon.opacity = 0.7;
+     * ```
+     */
+    opacity: number;
+    /**
+     * 贴图的缩放大小，仅在使用纹理贴图时有效
+     * @type {number}
+     * @example
+     * ```javascript
+     * polygon.mapScale = 2.0;
+     * ```
+     */
+    mapScale: number;
     isPolygon: boolean;
     parameters: {
-        extrude?: boolean;
-        extrudeValue?: number;
-        color?: string;
-        vertexColors?: boolean;
-        opacity?: number;
-        emissive?: string;
-        mapSrc?: string;
-        mapScale?: number;
+        extrude?: boolean | undefined;
+        extrudeValue?: number | undefined;
+        vertexHeights?: boolean | undefined;
+        enableBottomFace?: boolean | undefined;
+        color?: string | undefined;
+        vertexColors?: boolean | undefined;
+        emissive?: string | undefined;
+        opacity?: number | undefined;
+        mapSrc?: string | undefined;
+        mapScale?: number | undefined;
+        zOffset?: number | undefined;
+        normalOffset?: number | undefined;
+        perPositionHeight?: boolean | undefined;
+        isGroundPrimitive?: boolean | undefined;
+        isDynamic?: boolean | undefined;
+        excludeElements?: any[] | undefined;
+        renderOrder?: number | undefined;
+        nearScale?: number | undefined;
     };
-    _nearScale: any;
-    isGroundPrimitive: any;
-    isDynamic: any;
-    needReMapUv: any;
-    excludeElements: any;
+    _nearScale: number;
+    isGroundPrimitive: boolean | undefined;
+    isDynamic: boolean;
+    needReMapUv: boolean | undefined;
+    excludeElements: any[];
     _sharedResourcesId: string;
-    renderOrder: any;
+    renderOrder: number;
     depthRenderTarget: any;
-    onBeforeSceneRenderHook(engine: any, scene: any, camera: any, renderState: any): void;
-    computeRectangleBounds(): number[];
-    /** @protected */
+    /**
+     * 场景渲染前的钩子函数，用于生成深度图
+     * @param {Engine} engine 引擎实例
+     * @param {Scene} scene 场景对象
+     * @param {Camera} camera 相机对象
+     * @param {Object} renderState 渲染状态
+     * @protected
+     */
+    protected onBeforeSceneRenderHook(engine: Engine, scene: Scene, camera: Camera, renderState: Object): void;
+    /**
+     * 计算矩形边界
+     * @returns {Array<number>} 边界数组 [minX, minY, maxX, maxY]
+     * @private
+     */
+    private computeRectangleBounds;
+    /**
+     * 几何体更新后的处理
+     * @protected
+     */
     protected afterGeometryUpdate(): void;
-    /** @protected */
-    protected getEntityIndexByFace(faceIndex: any, pointIndex: any): any;
-    getSharedResourceFromExcludeElement(excludeElements: any): string;
-    set nearScale(value: any);
+    /**
+     * 根据面索引和点索引获取实体索引
+     * @param {number} faceIndex 面索引
+     * @param {number} pointIndex 点索引
+     * @returns {number} 实体索引
+     * @protected
+     */
+    protected getEntityIndexByFace(faceIndex: number, pointIndex: number): number;
+    /**
+     * 根据排除元素获取共享资源ID
+     * @param {Array} excludeElements 排除的元素列表
+     * @returns {string} 共享资源ID
+     * @private
+     */
+    private getSharedResourceFromExcludeElement;
+    /**
+     * 设置near缩放值
+     * @param {number} value near缩放值
+     */
+    set nearScale(value: number);
     /**
      * 控制near的值，默认5，在一些对深度要求比较高的场景需要调整near的值
+     * @type {number}
+     * @example
+     * ```javascript
+     * polygon.nearScale = 10; // 提高深度精度
+     * ```
+     */
+    get nearScale(): number;
+    /**
+     * 设置纹理贴图路径
+     * @param {string} value 纹理贴图路径
      */
-    get nearScale(): any;
-    set mapSrc(value: any);
+    set mapSrc(value: string);
     /**
      * 纹理贴图图片路径
+     * @type {string}
+     * @example
+     * ```javascript
+     * polygon.mapSrc = 'textures/ground.jpg';
+     * ```
      */
-    get mapSrc(): any;
+    get mapSrc(): string;
     raycast: any;
     _computeIntersections: any;
     getVertexPosition: any;