@three-tile/plugin
    Preparing search index...

    Class BackgroundSource

    背景色数据源

    为瓦片地图提供纯色背景材质，常用于底图填充或数据源缺失区域的备用显示。 不发起网络请求，仅返回指定颜色的 Material。

    Hierarchy

    • TileSource
      • BackgroundSource

    Indexable

    • [key: string]: unknown

      扩展属性

    Index

    Constructors

    constructor

    Properties

    _projectionBounds attribution bounds? color dataType isTMS maxLevel minLevel opacity projectionID subdomains transparent url

    Methods

    getBBox getUrl create

    Constructors

    Properties

    _projectionBounds

    _projectionBounds: BoundsType

    投影后的数据范围

    attribution: string

    版权信息，默认为 "ThreeTile"

    bounds?: BoundsType

    数据范围 [最小经度, 最小纬度, 最大经度, 最大纬度]

    color: ColorRepresentation = 0x112233

    填充颜色

    dataType: "background"

    数据类型，默认为 "image"

    isTMS: boolean

    是否使用 TMS 坐标系，默认为 false（使用 XYZ）

    maxLevel: number

    最大缩放级别，默认为 18

    minLevel: number

    最小缩放级别，默认为 0

    opacity: number

    材质透明度，默认为 1.0（不透明）

    projectionID: ProjectionType

    投影类型，默认为 "3857" 墨卡托投影

    subdomains: string | string[]

    子域名列表，用于负载均衡，但使用sbudomains后，浏览器缓存机制会失效，请谨慎使用

    transparent: boolean

    材质是否透明，默认为 true

    url: string

    URL 模板

    Methods

    • 根据投影类型计算瓦片的边界框

      • EPSG:3857 返回 Web Mercator 米单位
      • EPSG:4326 返回经纬度

      Parameters

      • x: number

        瓦片 x 坐标

      • y: number

        瓦片 y 坐标

      • z: number

        瓦片 z 坐标

      Returns string

      边界框字符串 "minX,minY,maxX,maxY"

    • 根据瓦片坐标获取 URL 可重写此方法自定义 URL 生成逻辑

      Parameters

      • x: number

        瓦片 x 坐标

      • y: number

        瓦片 y 坐标

      • z: number

        瓦片 z 坐标

      • Optionalobj: Record<string, unknown>

        额外参数，会合并到模板替换数据中

      Returns string | undefined

      瓦片 URL

    • 工厂方法：创建数据源实例

      Parameters

      • options: SourceOptions

        数据源配置项

      • Optionalextra: Record<string, unknown>

        附加属性，会合并到 options 中（同名覆盖 options）

      Returns TileSource

      数据源实例

    Settings

    Member Visibility

    On This Page

    Constructors
    Properties
    Methods