JSAPI Three API Reference
    正在准备搜索索引...

    类 XYZImageryTileProvider

    XYZ影像瓦片提供者，用于加载和渲染符合XYZ瓦片规范的影像瓦片数据。 支持Web墨卡托和地理坐标两种投影方式，兼容标准的XYZ瓦片服务。

    主要功能：

    • 支持标准XYZ瓦片服务
    • 支持Web墨卡托和地理坐标投影
    • 自动处理Y坐标反转（TMS vs Google瓦片规范）
    • 支持自定义瓦片URL模板
    // 创建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
    });

    层级 (查看层级一览)

    索引

    构造函数

    constructor

    属性

    isBaseImageryTileProvider isImageryTileProvider name visible

    方法

    doRequestImageTileData doRequestTileData errorFallback getTileURL onTileDispose shouldReproject

    访问器

    addDebugLabel colorTint maxLevel minLevel opacity randomColorTint sourceProjection targetProjection

    构造函数

    属性

    isBaseImageryTileProvider: true

    是否为基础影像瓦片提供者

    isImageryTileProvider: true

    是否为影像瓦片提供者

    name: "XYZImageryTileProvider" = 'XYZImageryTileProvider'

    瓦片提供者名称

    visible: boolean = true

    是否可见

    方法

    • 请求瓦片数据 加载影像瓦片纹理，并根据需要进行投影变换

      参数

      • tile: object

        瓦片对象

      • surfaceTile: object

        表面瓦片对象

      返回 Promise<Texture>

      瓦片纹理

    • 请求瓦片数据 子类需要重写doRequestImageTileData方法

      参数

      • tile: object

        瓦片对象

      • surfaceTile: object

        表面瓦片对象

      返回 Promise<Texture>

      瓦片纹理

    • 错误回退处理 当瓦片加载失败时返回透明纹理

      返回 DataTexture

      透明纹理

    • 获取瓦片URL 将URL模板中的占位符替换为实际的瓦片坐标

      参数

      • z: number

        缩放级别

      • x: number

        瓦片X坐标

      • y: number

        瓦片Y坐标

      • tile: object

        瓦片对象

      返回 string

      完整的瓦片URL

    • 瓦片销毁时的回调 释放瓦片纹理资源

      参数

      • tile: object

        瓦片对象

      返回 void

    • 判断是否需要进行投影变换 取中心点的像素坐标，计算变换后的像素坐标，判断是否有明显的偏移

      参数

      • sourceProjection: object

        源投影

      • targetProjection: object

        目标投影

      • tile: object

        瓦片对象

      • terrainTile: object

        地形瓦片对象

      返回 boolean

      是否需要重投影

    访问器

    • get addDebugLabel(): boolean

      获取是否绘制调试标签

      返回 boolean

    • set addDebugLabel(addDebugLabel: boolean): void

      设置是否绘制调试标签

      参数

      • addDebugLabel: boolean

        是否绘制调试标签

      返回 void

    • get colorTint(): number[]

      获取色彩调整值

      返回 number[]

    • set colorTint(colorTint: number[]): void

      设置色彩调整值

      参数

      • colorTint: number[]

        色彩调整值，RGB分量

      返回 void

    • get maxLevel(): number

      获取最大等级

      返回 number

    • get minLevel(): number

      获取最小等级

      返回 number

    • get opacity(): number

      获取不透明度

      返回 number

    • set opacity(opacity: number): void

      设置不透明度

      参数

      • opacity: number

        不透明度，取值范围0-1

      返回 void

    • get randomColorTint(): boolean

      获取是否使用随机色彩调整

      返回 boolean

    • set randomColorTint(randomColorTint: boolean): void

      设置是否使用随机色彩调整

      参数

      • randomColorTint: boolean

        是否使用随机色彩调整

      返回 void

    • get sourceProjection(): any

      获取源投影

      返回 any

    • get targetProjection(): any

      获取目标投影

      返回 any

    • set targetProjection(value: any): void

      设置目标投影

      参数

      • value: any

      返回 void

    显示设置

    成员可见性

    目录

    构造函数
    属性
    方法
    访问器