@baidumap/mapv-three 1.0.1 → 1.2.0

package/dist/types/threemap/mapView/tileProvider/imagery/BingImageryTileProvider.d.ts

@@ -6,21 +6,28 @@
  * - 支持Bing地图影像瓦片加载
  * - 支持Web墨卡托和地理坐标投影
  * - 支持瓦片URL的自动生成
+ * - 支持动态切换地图样式
  *
  * @category MapView
  * @example
  * ```javascript
  * // 创建Bing影像瓦片提供者
- * const provider = new BingImageryTileProvider({
- *     // 配置选项
+ * const provider = new mapvthree.BingImageryTileProvider({
+ *     style: mapvthree.mapViewConstants.BING_MAP_STYLE_AERIAL,
  * });
+ *
+ * // 动态切换地图样式
+ * provider.style = mapvthree.mapViewConstants.BING_MAP_STYLE_ROAD;
  * ```
  */
 export class BingImageryTileProvider extends ImageryTileProvider {
     /**
      * @param {object} options 配置选项
+     * @param {string} [options.style] 地图样式，支持 {@link mapViewConstants.BING_MAP_STYLE_AERIAL}、{@link mapViewConstants.BING_MAP_STYLE_AERIAL_WITH_LABELS}、{@link mapViewConstants.BING_MAP_STYLE_ROAD}，默认为 {@link mapViewConstants.BING_MAP_STYLE_AERIAL}
      */
-    constructor(options: object);
+    constructor(options?: {
+        style?: string | undefined;
+    });
     /**
      * 瓦片提供者名称
      * @readonly
@@ -41,6 +48,18 @@ export class BingImageryTileProvider extends ImageryTileProvider {
      * @private
      */
     private _defaultMaxLevel;
+    /**
+     * URL生成函数
+     * @private
+     */
+    private _urlGenerator;
+    _style: string;
+    set style(style: string);
+    /**
+     * 获取或设置地图样式
+     * @type {string}
+     */
+    get style(): string;
     /**
      * 获取瓦片URL
      * @internal

package/dist/types/threemap/mapView/tileProvider/imagery/GridCoordTileProvider.d.ts

@@ -1,4 +1,6 @@
 export class GridCoordProvider extends ImageryTileProvider {
+    constructor(options?: {});
+    name: string;
     ignoreLevelLimit: boolean;
     /** @private */
     private _supportedTargetProjectionNames;

package/dist/types/threemap/mapView/tileProvider/imagery/ImageryTileProvider.d.ts

@@ -4,33 +4,62 @@
  *
  * @category Internal
  */
-export class ImageryTileProvider extends TileProvider {
-    constructor(options?: {});
-    isImageryTileProvider: boolean;
-    _opacity: any;
-    _colorTint: any;
-    _randomColorTint: any;
-    getTileURL(z: any, x: any, y: any, tile: any): void;
-    /**
-     * 判断是否需要进行投影变换，取中心点的像素坐标，计算变换后的像素坐标，判断是否有明显的偏移
-     * @param {*} sourceProjection
-     * @param {*} targetProjection
-     * @param {*} tile
-     * @returns
-     */
-    shouldReproject(sourceProjection: any, targetProjection: any, tile: any): boolean;
+export class ImageryTileProvider extends BaseImageryTileProvider {
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "ImageryTileProvider";
+    /**
+     * 是否为影像瓦片提供者
+     * @readonly
+     */
+    readonly isImageryTileProvider: true;
+    /**
+     * 是否使用扩展目标边界框
+     * @private
+     */
+    private useExtendTargetBoundingBox;
+    /**
+     * 获取瓦片URL
+     * 子类必须重写此方法以提供具体的瓦片URL
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string} 瓦片URL
+     * @abstract
+     */
+    getTileURL(z: number, x: number, y: number, tile: object): string;
+    /**
+     * 判断是否需要进行投影变换
+     * 取中心点的像素坐标，计算变换后的像素坐标，判断是否有明显的偏移
+     * @param {object} sourceProjection 源投影
+     * @param {object} targetProjection 目标投影
+     * @param {object} tile 瓦片对象
+     * @param {object} terrainTile 地形瓦片对象
+     * @returns {boolean} 是否需要重投影
+     */
+    shouldReproject(sourceProjection: object, targetProjection: object, tile: object, terrainTile: object): boolean;
     /**
      * 请求瓦片数据
-     *
-     * @param {*} tile - 瓦片对象
-     */
-    doRequestTileData(tile: any): Promise<any>;
-    errorFeedback(): any;
-    set opacity(opacity: any);
-    get opacity(): any;
-    set colorTint(colorTint: any);
-    get colorTint(): any;
-    set randomColorTint(randomColorTint: any);
-    get randomColorTint(): any;
+     * 加载影像瓦片纹理，并根据需要进行投影变换
+     * @param {object} tile 瓦片对象
+     * @param {object} surfaceTile 表面瓦片对象
+     * @returns {Promise<Texture>} 瓦片纹理
+     */
+    doRequestImageTileData(tile: object, surfaceTile: object): Promise<Texture>;
+    /**
+     * 错误回退处理
+     * 当瓦片加载失败时返回透明纹理
+     * @returns {DataTexture} 透明纹理
+     */
+    errorFallback(): DataTexture;
+    /**
+     * 瓦片销毁时的回调
+     * 释放瓦片纹理资源
+     * @param {object} tile 瓦片对象
+     */
+    onTileDispose(tile: object): void;
 }
-import { TileProvider } from '../TileProvider';
+import { BaseImageryTileProvider } from '../BaseImageryTileProvider';

package/dist/types/threemap/mapView/tileProvider/imagery/OSMImageryTileProvider.d.ts

@@ -42,15 +42,5 @@ export class OSMImageryTileProvider extends ImageryTileProvider {
      * @private
      */
     private _defaultMaxLevel;
-    /**
-     * 获取瓦片URL
-     * @internal
-     * @param {number} z 缩放级别
-     * @param {number} x 瓦片X坐标
-     * @param {number} y 瓦片Y坐标
-     * @param {object} tile 瓦片对象
-     * @returns {string} 瓦片URL
-     */
-    getTileURL(z: number, x: number, y: number, tile: object): string;
 }
 import { ImageryTileProvider } from './ImageryTileProvider';

package/dist/types/threemap/mapView/tileProvider/imagery/StadiaImageryTileProvider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Stamen影像瓦片提供者，用于加载和渲染Stamen地图的影像瓦片数据。
+ * 支持Web墨卡托和地理坐标两种投影方式。
+ *
+ * 主要功能：
+ * - 支持Stamen地图影像瓦片加载
+ * - 支持Web墨卡托和地理坐标投影
+ * - 支持瓦片URL的自动生成
+ * - 支持动态切换地图样式
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建Stamen影像瓦片提供者
+ * const provider = new mapvthree.StadiaImageryTileProvider({
+ *     style: mapvthree.mapViewConstants.STADIA_MAP_STYLE_STAMEN_WATERCOLOR,
+ * });
+ *
+ * // 动态切换地图样式
+ * provider.style = mapvthree.mapViewConstants.STADIA_MAP_STYLE_STAMEN_TONER;
+ * ```
+ */
+export class StadiaImageryTileProvider extends ImageryTileProvider {
+    /**
+     * @param {object} options 配置选项
+     * @param {string} [options.style] 地图样式，支持 {@link mapViewConstants.STADIA_MAP_STYLE_STAMEN_WATERCOLOR}、{@link mapViewConstants.STADIA_MAP_STYLE_STAMEN_TONER}、{@link mapViewConstants.STADIA_MAP_STYLE_ALIDE_SMOOTH}、{@link mapViewConstants.STADIA_MAP_STYLE_ALIDE_SMOOTH_DARK}、{@link mapViewConstants.STADIA_MAP_STYLE_OUTDOORS}，默认为 {@link mapViewConstants.STADIA_MAP_STYLE_STAMEN_WATERCOLOR}
+     */
+    constructor(options?: {
+        style?: string | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "StadiaImageryTileProvider";
+    /**
+     * 支持的投影方式
+     * @private
+     */
+    private _supportedTargetProjectionNames;
+    /**
+     * 默认起始缩放级别
+     * @private
+     */
+    private _defaultStartLevel;
+    /**
+     * 默认最大缩放级别
+     * @private
+     */
+    private _defaultMaxLevel;
+    _style: string;
+    _replaceStr: {
+        x: string;
+        y: string;
+        z: string;
+        reverseY: string;
+    };
+    set style(style: string);
+    /**
+     * 获取或设置地图样式
+     * @type {string}
+     */
+    get style(): string;
+    /**
+     * 获取瓦片URL
+     * @internal
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string|boolean} 瓦片URL，如果缩放级别为0则返回false
+     */
+    getTileURL(z: number, x: number, y: number, tile: object): string | boolean;
+}
+import { ImageryTileProvider } from './ImageryTileProvider';

package/dist/types/threemap/mapView/tileProvider/imagery/WMSImageryTileProvider.d.ts

@@ -1,11 +1,43 @@
+/**
+ * WMS影像瓦片提供者，用于加载和渲染WMS服务的影像瓦片数据。
+ * 支持Web墨卡托和地理坐标两种投影方式。
+ *
+ * 主要功能：
+ * - 支持WMS 1.1.1和1.3.0版本
+ * - 支持多种投影系统
+ * - 自动处理BBOX坐标顺序
+ * - 支持透明度和样式设置
+ * - 支持不同服务器类型的HiDPI处理
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建WMS影像瓦片提供者
+ * const provider = new WMSImageryTileProvider({
+ *     url: 'https://example.com/geoserver/wms',
+ *     params: {
+ *         LAYERS: 'layer1,layer2',
+ *         SRS: 'EPSG:3857',
+ *         VERSION: '1.1.0',
+ *     },
+ * });
+ * ```
+ */
 export class WMSImageryTileProvider extends ImageryTileProvider {
-    constructor(options: any);
+    constructor(options?: {});
+    name: string;
     /** @private */
     private _supportedTargetProjectionNames;
     /** @private */
     private _defaultMaxLevel;
     /** @private */
     private _url;
+    /** @private */
+    private _serverType;
+    /** @private */
+    private _hidpi;
+    /** @private */
+    private _devicePixelRatio;
     _replaceStr: {
         x: string;
         y: string;
@@ -15,17 +47,78 @@ export class WMSImageryTileProvider extends ImageryTileProvider {
     };
     _baseUrl: any;
     _params: any;
-    getDefaultParmas(): {
-        SERVICE: string;
-        REQUEST: string;
-        VERSION: string;
-        FORMAT: string;
-        STYLES: string;
-        TRANSPARENT: boolean;
-        BBOX: string;
-    };
-    appendParams(uri: any, params: any): string;
-    getUrlParams(url: any): {};
-    getTileURL(z: any, x: any, y: any, tile: any): string;
+    /**
+     * 设置WMS参数
+     * @private
+     */
+    private _setWmsParams;
+    /**
+     * 获取HiDPI参数
+     * @private
+     */
+    private getHiDPIParams;
+    /**
+     * 获取大写键名的参数对象
+     * @param {Object} obj 参数对象
+     * @returns {Object} 大写键名的参数对象
+     * @private
+     */
+    private _getUppercaseKeys;
+    /**
+     * 标准化投影名称
+     * @param {string} projectionName 投影名称
+     * @returns {string} 标准化后的投影名称
+     * @private
+     */
+    private _normalizeProjectionName;
+    /**
+     * 比较版本号
+     * @param {string} version1 版本1
+     * @param {string} version2 版本2
+     * @returns {number} 比较结果：-1(version1<version2), 0(version1=version2), 1(version1>version2)
+     * @private
+     */
+    private _compareVersions;
+    /**
+     * 格式化BBOX字符串
+     * @param {Object} boundingBox 边界框对象
+     * @param {boolean} isGeo 是否为地理坐标
+     * @param {string} version WMS版本
+     * @returns {string} 格式化的BBOX字符串
+     * @private
+     */
+    private _formatBbox;
+    /**
+     * 拼接params到url
+     * @param {string} uri 基础URL
+     * @param {Object} params 参数对象
+     * @returns {string} 拼接后的URL
+     */
+    appendParams(uri: string, params: Object): string;
+    /**
+     * 解析URL参数
+     * @param {string} url URL字符串
+     * @returns {Object} 参数对象
+     */
+    getUrlParams(url: string): Object;
+    /**
+     * 获取瓦片URL
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {Object} tile 瓦片对象
+     * @returns {string} 瓦片URL
+     */
+    getTileURL(z: number, x: number, y: number, tile: Object): string;
+    /**
+     * 设置WMS参数
+     * @param {Object} params 新的参数对象
+     */
+    setParams(params: Object): void;
+    /**
+     * 获取当前WMS参数
+     * @returns {Object} 当前参数对象
+     */
+    getParams(): Object;
 }
 import { ImageryTileProvider } from './ImageryTileProvider';

package/dist/types/threemap/mapView/tileProvider/imagery/WMTSImageryTileProvider.d.ts

@@ -1,11 +1,66 @@
+/**
+ * WMTS影像瓦片提供者，用于加载和渲染WMTS服务的影像瓦片数据。
+ * 支持Web墨卡托和地理坐标两种投影方式。
+ *
+ * 主要功能：
+ * - 支持WMTS 1.0.0版本
+ * - 支持多种投影系统和TileMatrixSet
+ * - 自动处理瓦片坐标转换
+ * - 支持透明度和样式设置
+ * - 支持不同服务器类型的HiDPI处理
+ * - 支持RESTful和KVP两种请求方式
+ * - 支持自定义瓦片矩阵ID映射
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建WMTS影像瓦片提供者 - 使用默认TILEMATRIX模板
+ * const provider1 = new WMTSImageryTileProvider({
+ *     url: 'https://example.com/geoserver/gwc/service/wmts',
+ *     params: {
+ *         LAYER: 'layer1',
+ *         TILEMATRIXSET: 'EPSG:900913',
+ *         TILEMATRIX: 'EPSG:900913:{z}',
+ *         VERSION: '1.0.0',
+ *     },
+ * });
+ *
+ * // 创建WMTS影像瓦片提供者 - 使用自定义matrixIds
+ * const provider2 = new WMTSImageryTileProvider({
+ *     url: 'https://example.com/geoserver/gwc/service/wmts',
+ *     params: {
+ *         LAYER: 'layer1',
+ *         TILEMATRIXSET: 'EPSG:3857',
+ *         VERSION: '1.0.0',
+ *     },
+ *     matrixIds: ['EPSG:3857:0', 'EPSG:3857:1', 'EPSG:3857:2'],
+ * });
+ *
+ * // 创建WMTS影像瓦片提供者 - 使用REST请求方式
+ * const provider3 = new WMTSImageryTileProvider({
+ *     url: 'https://example.com/wmts/{layer}/{style}/{tilematrixset}/{tilematrix}/{tilerow}/{tilecol}.png',
+ *     params: {
+ *         LAYER: 'layer1',
+ *         STYLE: 'default',
+ *         TILEMATRIXSET: 'EPSG:3857',
+ *     },
+ *     requestEncoding: 'REST',
+ * });
+ * ```
+ */
 export class WMTSImageryTileProvider extends ImageryTileProvider {
-    constructor(options: any);
+    constructor(options?: {});
+    name: string;
     /** @private */
     private _supportedTargetProjectionNames;
     /** @private */
     private _defaultMaxLevel;
     /** @private */
     private _url;
+    /** @private */
+    private _requestEncoding;
+    /** @private */
+    private _matrixIds;
     _replaceStr: {
         x: string;
         y: string;
@@ -14,19 +69,63 @@ export class WMTSImageryTileProvider extends ImageryTileProvider {
     };
     _baseUrl: any;
     _params: any;
-    appendParams(uri: any, params: any): string;
-    getUrlParams(url: any): {};
-    getDefaultParmas(): {
-        SERVICE: string;
-        REQUEST: string;
-        VERSION: string;
-        FORMAT: string;
-        TILEMATRIX: string;
-        TILECOL: string;
-        TILEROW: string;
-        TILEMATRIXSET: string;
-    };
-    getEPSGCode(tileMatrixSet: any): any;
-    getTileURL(z: any, x: any, y: any, tile: any): string;
+    /**
+     * 设置WMTS参数
+     * @private
+     */
+    private _setWmtsParams;
+    /**
+     * 获取大写键名的参数对象
+     * @param {Object} obj 参数对象
+     * @returns {Object} 大写键名的参数对象
+     * @private
+     */
+    private _getUppercaseKeys;
+    /**
+     * 标准化投影名称
+     * @param {string} projectionName 投影名称
+     * @returns {string} 标准化后的投影名称
+     * @private
+     */
+    private _normalizeProjectionName;
+    /**
+     * 拼接params到url
+     * @param {string} uri 基础URL
+     * @param {Object} params 参数对象
+     * @returns {string} 拼接后的URL
+     */
+    appendParams(uri: string, params: Object): string;
+    /**
+     * 解析URL参数
+     * @param {string} url URL字符串
+     * @returns {Object} 参数对象
+     */
+    getUrlParams(url: string): Object;
+    /**
+     * 获取瓦片URL
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {Object} tile 瓦片对象
+     * @returns {string} 瓦片URL
+     */
+    getTileURL(z: number, x: number, y: number, tile: Object): string;
+    /**
+     * 获取TILEMATRIX值
+     * @param {number} z 缩放级别
+     * @returns {string|number} TILEMATRIX值
+     * @private
+     */
+    private _getTileMatrixValue;
+    /**
+     * 设置WMTS参数
+     * @param {Object} params 新的参数对象
+     */
+    setParams(params: Object): void;
+    /**
+     * 获取当前WMTS参数
+     * @returns {Object} 当前参数对象
+     */
+    getParams(): Object;
 }
 import { ImageryTileProvider } from './ImageryTileProvider';

package/dist/types/threemap/mapView/tileProvider/imagery/XYZImageryTileProvider.d.ts

@@ -1,16 +1,63 @@
+/**
+ * XYZ影像瓦片提供者，用于加载和渲染符合XYZ瓦片规范的影像瓦片数据。
+ * 支持Web墨卡托和地理坐标两种投影方式，兼容标准的XYZ瓦片服务。
+ *
+ * 主要功能：
+ * - 支持标准XYZ瓦片服务
+ * - 支持Web墨卡托和地理坐标投影
+ * - 自动处理Y坐标反转（TMS vs Google瓦片规范）
+ * - 支持自定义瓦片URL模板
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建XYZ影像瓦片提供者（Web墨卡托投影）
+ * const provider = new mapvthree.XYZImageryTileProvider({
+ *     url: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png',
+ *     projection: mapvthree.constants.PROJECTION_WEB_MERCATOR
+ * });
+ *
+ * // 创建XYZ影像瓦片提供者（地理坐标投影）
+ * const geoProvider = new mapvthree.XYZImageryTileProvider({
+ *     url: 'https://example.com/tiles/{z}/{x}/{y}.png',
+ *     projection: mapvthree.constants.PROJECTION_GEO
+ * });
+ * ```
+ */
 export class XYZImageryTileProvider extends ImageryTileProvider {
-    constructor(options: any);
-    /** @private */
+    /**
+      * @param {object} options 配置选项
+      * @param {string} options.url 瓦片URL模板，必须包含 {x}、{y}或{reverseY}、{z} 占位符
+      * @param {string} [options.projection] 投影方式，支持 {@link PROJECTION_WEB_MERCATOR} 和
+      * {@link PROJECTION_GEO}，默认为 {@link PROJECTION_WEB_MERCATOR}
+      * @param {number} [options.maxLevel] 最大缩放级别，默认为18
+      */
+    constructor(options: {
+        url: string;
+        projection?: string | undefined;
+        maxLevel?: number | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "XYZImageryTileProvider";
+    /**
+     * 支持的投影方式
+     * @private
+     */
     private _supportedTargetProjectionNames;
-    /** @private */
+    /**
+     * 瓦片URL模板
+     * @private
+     */
     private _url;
     _replaceStr: {
         x: string;
-        y: string;
         z: string;
+        y: string;
         reverseY: string;
     };
-    _defaultXYZProjectionName: any;
-    getTileURL(z: any, x: any, y: any, tile: any): any;
+    _defaultXYZProjectionName: string;
 }
 import { ImageryTileProvider } from './ImageryTileProvider';

package/dist/types/threemap/mapView/tileProvider/renderers/ImageTileLabelRenderer.d.ts

@@ -0,0 +1,4 @@
+export class ImageTileLabelRenderer {
+    static _initResource(): void;
+    static render(renderer: any, inputTexture: any, tile: any): any;
+}

package/dist/types/threemap/mapView/{geo → tileProvider/renderers}/ImageryReprojector.d.ts

@@ -21,4 +21,4 @@ export class ImageryReprojector {
 export namespace ImageryReprojector {
     let DEFAULT: ImageryReprojector;
 }
-import { ImageryReprojectMaterial } from '../material/ImageryReprojectMaterial';
+import { ImageryReprojectMaterial } from '../../material/ImageryReprojectMaterial';

package/dist/types/threemap/mapView/tileProvider/renderers/VectorTileImageRenderer.d.ts

@@ -0,0 +1,4 @@
+export class VectorTileImageRenderer {
+    static _initResource(): void;
+    static render(renderer: any, objects: any, tile: any, tileSize: any): any;
+}