@baidumap/mapv-three 1.1.3 → 1.2.0

package/dist/types/threemap/mapView/grid/BaiduVectorOnlineGrid.d.ts

@@ -6,6 +6,7 @@ export class BaiduVectorOnlineGrid extends BaiduImageryGrid {
     name: string;
     /** @private */
     private _levels;
+    supportLevelReuse: boolean;
     _coordLevelTileCounts: {
         0: number;
         1: number;
@@ -16,5 +17,14 @@ export class BaiduVectorOnlineGrid extends BaiduImageryGrid {
         baseZ: any;
         startZ: any;
     };
+    /**
+     * 获取有层级复用的瓦片配置，外部传入的是根据标准四叉树计算出来的瓦片坐标，需要转换成层级复用的瓦片配置
+     * 如5-19-10实际使用的是5-10-5瓦片的四分之一
+     * @param {*} z
+     * @param {*} x
+     * @param {*} y
+     * @returns
+     */
+    getResuedTileConfig(z: any, x: any, y: any): any[] | null;
 }
 import { BaiduImageryGrid } from './BaiduImageryGrid';

package/dist/types/threemap/mapView/grid/Grid.d.ts

@@ -17,7 +17,17 @@ export class Grid {
     _engine: any;
     _sourceProjection: any;
     _targetProjection: any;
+    initFromTileProvider(tileProvider: any): void;
+    _sourceCoordType: any;
+    _targetCoordType: any;
+    _shouldConvertCoord: boolean | undefined;
+    useExtendTargetBoundingBox: any;
     getRootTiles(): never[];
+    /**
+     * 获取可用的根瓦片, 剔除超出目标投影范围的瓦片
+     * @returns {Array<MapTile>} 返回包含所有可用根瓦片的数组
+     */
+    getAvailableRootTiles(): Array<MapTile>;
     getRootBoundingBox(): null;
     getPixelSizeByLevel(level: any): any;
     getNextLevel(z: any): any;
@@ -31,6 +41,7 @@ export class Grid {
      * @returns {Array<MapTile>} 返回包含所有子瓦片的数组
      */
     createTileChildren(tile: MapTile): Array<MapTile>;
+    createSubTile(sourceTile: any, offsetX: any, offsetY: any, width: any, height: any): MapTile;
     isTileInBoundingRange(tile: any): boolean;
     getTileSizeAtLevel(level: any): void;
     getTileCoordX(x: any, tileSize: any, clampToEdge?: boolean): void;
@@ -51,6 +62,9 @@ export class Grid {
     get useGeoSubdivision(): boolean;
     get sourceProjection(): any;
     get targetProjection(): any;
+    get sourceCoordType(): any;
+    get targetCoordType(): any;
+    get shouldConvertCoord(): boolean | undefined;
     get zeroLevelPixelSize(): number;
     _zeroLevelPixelSize: number | undefined;
 }

package/dist/types/threemap/mapView/map/MapView.d.ts

@@ -160,16 +160,6 @@ export class MapView {
     _sseDenominator: number | undefined;
     _pitchRatio: any;
     getKeyByValue: (obj: any, value: any) => string | null;
-    /**
-     * @internal
-     * 当瓦片加载完成后，若为分层地图，保存其层级信息z
-     * @param {Event} e
-     */
-    handleTileLoaded: (e: Event) => void;
-    /**
-     * @protected
-     */
-    protected handleTileDispose: (e: any) => void;
     /**
      * @protected
      */

package/dist/types/threemap/mapView/mapbox/executer/fill.d.ts

@@ -75,6 +75,8 @@ export default class FillExecuter {
     };
     _getStyleValue(type: any, property: any): any;
     _getFillColor(): void;
+    _getFillTranslate(): void;
+    _translate: any;
     _loadGeometry(layerIndex: any): void;
     _getOutLineColor(): void;
     _getFillPattern(): void;

package/dist/types/threemap/mapView/surface/MapSurface.d.ts

@@ -37,6 +37,7 @@ export class MapSurface {
     private _selectedTilesLastFrame;
     /** @private */
     private _showGroundWireframe;
+    _pendingRequests: Map<any, any>;
     _id: number;
     _quadtree: TileQuadtree | null;
     _placeholder: Placeholder | null;
@@ -68,7 +69,7 @@ export class MapSurface {
      */
     get strategy(): any;
     _getCurrentGrid(): void;
-    computeDistanceToTile(tile: any, cameraPosition: any, mode: any, mapProjection: any, ellipsoid: any): any;
+    computeDistanceToTile(tile: any, cameraPosition: any, renderState: any, mode: any, mapProjection: any, ellipsoid: any): any;
     refresh(): void;
     clearTilesInView(): void;
     /**
@@ -83,21 +84,22 @@ export class MapSurface {
     _getDebugLabelId(surfaceTile: any): string;
     _onBeforeSceneRender(engine: any, scene: any, camera: any, renderState: any): void;
     _groundSceneRenderer: GroundSceneRenderer | undefined;
+    _cancelTileInArray(cancelTiles: any): void;
     _requestTilesInArray(tiles: any, number: any, onlyRequestGeometry?: boolean): void;
+    _collectionCancelTiles(requestTiles: any): any[];
     _selectCurrentFrameRequestTiles(tiles: any, number: any): any;
     beginFrame(renderState: any): void;
+    updatePendingRequest(renderState: any): void;
     endFrame(renderState: any): void;
     _computeOccludeePoint(tile: any, occluder: any): any;
     _computeOccludeePoint2(tile: any, occluder: any): any;
-    updateTileBoundingRegion(tile: any, tileProvider: any, renderState: any): void;
+    updateTileBoundingRegion(tile: any, renderState: any): void;
     screenSpaceError(tile: any): number;
     reverseScreenSpaceErrorZ(tile: any): number;
     projectBoundingBoxToNdc(tile: any): any[][];
     _computeTileVisibility(frustum: any, tile: any): any;
     _computeTileVisibility3D(frustum: any, boundingVolume: any): number;
     _naturalOrderChildTiles(tiles: any, cameraPosition: any): any[];
-    _createRootTiles(): void;
-    _rootTiles: any;
     /**
      * @internal
      * 显示一帧的加载日志
@@ -156,6 +158,7 @@ export class MapSurface {
      * 获取细节层次缩放因子
      */
     get lodScaleFactor(): number;
+    get computedLodScaleFactor(): number;
     set showGroundWireframe(value: boolean);
     get showGroundWireframe(): boolean;
     _groundWireframeMaterial: any;

package/dist/types/threemap/mapView/surface/Placeholder.d.ts

@@ -1,5 +1,5 @@
 export class Placeholder {
-    constructor(options?: {});
+    constructor(options: {} | undefined, placeholderColor: any);
     /** @private */
     private _maxCacheSize;
     _cache: LRUCache;

package/dist/types/threemap/mapView/surface/VectorSurface.d.ts

@@ -30,6 +30,7 @@ export class VectorSurface extends MapSurface {
      */
     beginFrame(renderState: any): false | undefined;
     _shouldRenderPlaceholder: any;
+    _placeholderColor: any;
     /**
      * 设置矢量提供者
      */

package/dist/types/threemap/mapView/surface/strategy/FastTileLoaderStrategy.d.ts

@@ -45,7 +45,7 @@ export class FastTileLoaderStrategy extends Strategy {
      * @returns {boolean} 是否是子瓦片
      */
     _isAncestorTile: (currentTile: MapTile, ancestorTile: MapTile) => boolean;
-    _preserveLastFrameChildrenTiles: (tile: any, renderedTiles: any) => number;
+    _preserveLastFrameChildrenTiles: (tile: any, renderedTiles: any, renderState: any) => number;
     _isTileRenderedInLastFrame: (tile: any) => boolean;
     _isTileAncestorRenderedInLastFrame: (tile: any) => true | undefined;
     _hideChildrenTiles: (renderedTiles: any, placeholderTiles: any, tile: any) => number;
@@ -82,8 +82,8 @@ export class FastTileLoaderStrategy extends Strategy {
      * @param {Array} tiles 瓦片数组
      * @param {Array} viewportTiles 主视野内的瓦片数组
      */
-    _traverseViewportTiles: (projectionBounds: Box3, frustum: Frustum, cameraPosition: Vector3, tiles: any[], viewportTiles: any[]) => void;
-    _computeIntersectTiles(frustum: any, cameraPosition: any, tile: any, renderedTiles: any, requestTiles: any, placeholderTiles: any, maxZLevel: any): MapTileRenderState;
+    _traverseViewportTiles: (projectionBounds: Box3, frustum: Frustum, cameraPosition: Vector3, tiles: any[], viewportTiles: any[], renderState: any) => void;
+    _computeIntersectTiles(frustum: any, cameraPosition: any, tile: any, renderedTiles: any, requestTiles: any, placeholderTiles: any, maxZLevel: any, renderState: any): MapTileRenderState;
     getPolygonArea(vertices: any): number;
     set showDebug(value: boolean);
     get showDebug(): boolean;

package/dist/types/threemap/mapView/surface/strategy/HierarchicalTileLoaderStrategy.d.ts

@@ -5,7 +5,6 @@ export class HierarchicalTileLoaderStrategy extends Strategy {
         requestTilesQueue: any[][];
         placeholderTiles: never[];
     };
-    queueTileLoaded(tile: any, requestTiles: any): void;
     /**
      * @param {*} cameraPosition
      * @param {*} frustum

package/dist/types/threemap/mapView/tileManager/RasterSurfaceTileManager.d.ts

@@ -1,11 +1,11 @@
 export class RasterSurfaceTileManager extends SurfaceTileManager {
     /** @private */
     private _tiles;
+    _layersKey: string;
     forceUpdateTileState(tile: any): void;
-    isTileNeedsLoading(tile: any): true | undefined;
-    isTileComputable(tile: any): any;
-    isTileRenderable(tile: any): boolean;
-    isTileStable(tile: any): boolean;
+    isTileComputable(tile: any, renderState: any): any;
+    isTileRenderable(tile: any, renderState: any): boolean;
+    isTileStable(tile: any, renderState: any): boolean;
     markTileUsed(tile: any): null | undefined;
     getSurfaceTile(tile: any, renderState: any): any;
     _updateSurfaceTileData(data: any): void;

package/dist/types/threemap/mapView/tileManager/SurfaceTileManager.d.ts

@@ -8,8 +8,11 @@ export class SurfaceTileManager {
     /** @private */
     private _surface;
     _pendingCount: number;
-    getSurfaceTile(tile: any): void;
+    beginFrame(renderState: any): void;
+    endFrame(renderState: any): void;
+    getSurfaceTile(tile: any, renderState: any): void;
     requestSurfaceTile(tile: any): void;
+    cancelSurfaceTiles(tile: any): void;
     dispose(): void;
     get pendingCount(): number;
 }

package/dist/types/threemap/mapView/tileManager/VectorSurfaceTileManager.d.ts

@@ -1,18 +1,17 @@
 export class VectorSurfaceTileManager extends SurfaceTileManager {
     /** @private */
     private _tiles;
-    isTileRenderable(tile: any): boolean;
+    isTileRenderable(tile: any, renderState: any): boolean;
     markTileUsed(tile: any): null | undefined;
-    isTileNeedsLoading(tile: any): boolean;
-    isTileComputable(tile: any): any;
-    isTileStable(tile: any): boolean;
+    isTileComputable(tile: any, renderState: any): any;
+    isTileStable(tile: any, renderState: any): boolean;
     /**
      * 更新图形对象
      *
      * @param data 数据信息，包含需要更新的图形对象数据及其状态等信息。
      */
     _updateSurfaceTileData(data: any): void;
-    getSurfaceTile(tile: any): any;
+    getSurfaceTile(tile: any, renderState: any): any;
     _onlyRequestTileContents(data: any): void;
     clear(): void;
 }

package/dist/types/threemap/mapView/tileProvider/AsyncCesiumTerrainDataLoader.d.ts

@@ -27,4 +27,4 @@ export class AsyncCesiumTerrainDataLoader {
     postMessageToAll(message: any, transferableData: any): void;
 }
 import { WorkerTaskScheduler } from '../../../util/WorkerTaskScheduler';
-import { QuantizedMeshTerrainData } from '../terrainData/QuantizedMeshTerrainData';
+import { QuantizedMeshTerrainData } from '../geo/terrainData/QuantizedMeshTerrainData';

package/dist/types/threemap/mapView/tileProvider/AsyncDataTileLoader.d.ts

@@ -15,6 +15,7 @@ export class AsyncDataTileLoader {
      */
     requestTile(tile: Tile): Promise<void>;
     refreshTile(tile: any): Promise<any>;
+    cancelTiles(tiles: any): void;
     /**
      * 向所有 worker 发送消息。
      *

package/dist/types/threemap/mapView/tileProvider/BaseImageryTileProvider.d.ts

@@ -0,0 +1,103 @@
+/**
+ * 基础影像图层，提供影像图层的基础功能
+ */
+export class BaseImageryTileProvider extends TileProvider {
+    /**
+     * @param {object} options 配置选项
+     * @param {number} [options.opacity] 不透明度，取值范围0-1，默认为1
+     * @param {number[]} [options.colorTint] 色彩调整值，RGB分量，默认为[1, 1, 1]
+     * @param {boolean} [options.randomColorTint] 是否使用随机色彩调整，默认为false
+     * @param {Color} [options.placeholderColor] 占位符颜色
+     */
+    constructor(options?: {
+        opacity?: number | undefined;
+        colorTint?: number[] | undefined;
+        randomColorTint?: boolean | undefined;
+        placeholderColor?: any;
+    });
+    /**
+     * 是否为基础影像瓦片提供者
+     * @readonly
+     */
+    readonly isBaseImageryTileProvider: true;
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "BaseImageryTileProvider";
+    /**
+     * @private
+     * @type {number}
+     * 不透明度，取值范围0-1
+     */
+    private _opacity;
+    /**
+     * @private
+     * @type {number[]}
+     * 色彩调整值，RGB分量
+     */
+    private _colorTint;
+    /**
+     * @private
+     * @type {boolean}
+     * 是否使用随机色彩调整
+     */
+    private _randomColorTint;
+    /**
+     * @private
+     * @type {boolean}
+     * 是否绘制调试标签
+     */
+    private _addDebugLabel;
+    _placeholderColor: any;
+    /**
+     * 请求瓦片数据
+     * 子类需要重写doRequestImageTileData方法
+     * @param {object} tile 瓦片对象
+     * @param {object} surfaceTile 表面瓦片对象
+     * @returns {Promise<Texture>} 瓦片纹理
+     * @abstract
+     */
+    doRequestTileData(tile: object, surfaceTile: object): Promise<Texture>;
+    /**
+     * 设置不透明度
+     * @param {number} opacity 不透明度，取值范围0-1
+     */
+    set opacity(opacity: number);
+    /**
+     * 获取不透明度
+     * @type {number}
+     */
+    get opacity(): number;
+    /**
+     * 设置色彩调整值
+     * @param {number[]} colorTint 色彩调整值，RGB分量
+     */
+    set colorTint(colorTint: number[]);
+    /**
+     * 获取色彩调整值
+     * @type {number[]}
+     */
+    get colorTint(): number[];
+    /**
+     * 设置是否使用随机色彩调整
+     * @param {boolean} randomColorTint 是否使用随机色彩调整
+     */
+    set randomColorTint(randomColorTint: boolean);
+    /**
+     * 获取是否使用随机色彩调整
+     * @type {boolean}
+     */
+    get randomColorTint(): boolean;
+    /**
+     * 设置是否绘制调试标签
+     * @param {boolean} addDebugLabel 是否绘制调试标签
+     */
+    set addDebugLabel(addDebugLabel: boolean);
+    /**
+     * 获取是否绘制调试标签
+     * @type {boolean}
+     */
+    get addDebugLabel(): boolean;
+}
+import { TileProvider } from './TileProvider';

package/dist/types/threemap/mapView/tileProvider/TileProvider.d.ts

@@ -25,6 +25,10 @@ export class TileProvider {
         maxCacheSize: number;
     });
     name: string;
+    /**
+     * 是否可见
+     */
+    visible: boolean;
     /**
      * @private
     */
@@ -75,9 +79,9 @@ export class TileProvider {
      */
     private _desiredUpperSampleLevel;
     /**
-       * @private
-       * 期望层级的瓦片加载过程中向上采样级数
-       */
+     * @private
+     * 期望层级的瓦片加载过程中向上采样级数
+     */
     private _loadingUpperSampleLevel;
     /**
      * @private
@@ -146,10 +150,21 @@ export class TileProvider {
     private _useWebMeractorProjectionAndGrid;
     /**
      * @private
-     * 数据版本
+     * 标记请求的数据版本，数据在请求过程中，provider的配置如果已经变更，数据返回时需校验
+     */
+    private _requestDataVersion;
+    /**
+     * @private
+     * 标记是否要清空缓存
+     */
+    private _needsClearCache;
+    /**
+     * @private
+     * 标记是否要更新瓦片版本，更新瓦片版本会让surface重新计算瓦片依赖关系
      */
-    private _dataVersion;
-    _needFeedback: any;
+    private _needsIncreTilesEpoch;
+    _id: number;
+    _needFallback: any;
     statistics: {
         loading: number;
         cached: number;
@@ -165,7 +180,6 @@ export class TileProvider {
     beginFrame(renderState: any): void;
     _usedTilesNum: number | undefined;
     _usedTiles: {} | undefined;
-    _needsClearCache: boolean | undefined;
     endFrame(renderState: any): void;
     isReady(): boolean;
     onTileDispose(tile: any): void;
@@ -176,11 +190,13 @@ export class TileProvider {
     _initOrUpdateTileStateListeners: (tile: any, listenrObject: any) => void;
     requestTileData(tile: any, stateListenerObject: any): Promise<void>;
     getGroundTileData(tile: any): null;
-    getTile(z: any, x: any, y: any, targetTile: any, stateListenerObject: any): any;
+    getTile(z: any, x: any, y: any, targetTile: any, surfaceTile: any): any;
     markTileUsed(tile: any): void;
     _tileLevelInRange(level: any): boolean;
     computeCoverageTilesCoord(targetTile: any): any;
-    clearCache(): void;
+    _clearCache(): void;
+    _increTilesEpoch(): void;
+    get id(): number;
     set maxCacheSize(value: number);
     get maxCacheSize(): number;
     set desiredUpperSampleLevel(value: number);

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

@@ -1,14 +1,78 @@
+/**
+ * 百度09影像瓦片提供者，用于加载和渲染百度地图的影像瓦片数据。
+ * 支持Web墨卡托和地理坐标两种投影方式，提供卫星影像和普通影像两种类型。
+ *
+ * 主要功能：
+ * - 支持百度地图影像瓦片加载
+ * - 支持Web墨卡托和地理坐标投影
+ * - 支持卫星影像和普通影像切换
+ * - 自动处理百度地图坐标转换
+ *
+ * @category MapView
+ * @example
+ * ```javascript
+ * // 创建百度09影像瓦片提供者（普通影像）
+ * const provider = new mapvthree.Baidu09ImageryTileProvider({
+ *     ak: 'your_baidu_ak',
+ *     type: 'normal'
+ * });
+ *
+ * // 创建百度09影像瓦片提供者（卫星影像）
+ * const satelliteProvider = new mapvthree.Baidu09ImageryTileProvider({
+ *     ak: 'your_baidu_ak',
+ *     type: 'satellite'
+ * });
+ * ```
+ */
 export class Baidu09ImageryTileProvider extends ImageryTileProvider {
-    constructor(options: any);
-    isBaiduProvider: boolean;
-    /** @private */
+    /**
+     * @param {object} options 配置选项
+     * @param {string} [options.ak] 百度地图API密钥，如果不提供则使用全局配置
+     * @param {string} [options.type] 影像类型，支持 'satellite'（卫星影像）和 'normal'（普通影像），默认为 'normal'
+     */
+    constructor(options: {
+        ak?: string | undefined;
+        type?: string | undefined;
+    });
+    /**
+     * 瓦片提供者名称
+     * @readonly
+     */
+    readonly name: "Baidu09ImageryTileProvider";
+    /**
+     * 是否为百度地图提供者
+     * @readonly
+     */
+    readonly isBaiduProvider: true;
+    /**
+     * 支持的投影方式
+     * @private
+     */
     private _supportedTargetProjectionNames;
-    /** @private */
+    /**
+     * 默认起始缩放级别
+     * @private
+     */
     private _defaultStartLevel;
-    /** @private */
+    /**
+     * 默认最大缩放级别
+     * @private
+     */
     private _defaultMaxLevel;
-    /** @private */
+    /**
+     * 影像类型（satellite或normal）
+     * @private
+     */
     private _type;
-    getTileURL(z: any, x: any, y: any, tile: any): string | false;
+    _ak: string | null;
+    /**
+     * 获取瓦片URL
+     * @param {number} z 缩放级别
+     * @param {number} x 瓦片X坐标
+     * @param {number} y 瓦片Y坐标
+     * @param {object} tile 瓦片对象
+     * @returns {string|boolean} 瓦片URL或false（如果缩放级别小于3）
+     */
+    getTileURL(z: number, x: number, y: number, tile: object): string | boolean;
 }
 import { ImageryTileProvider } from './ImageryTileProvider';

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';