Class BackgroundLoader

地图背景加载器

为瓦片提供纯色背景材质。不下载任何影像数据，仅根据 BackgroundSource 配置的颜色创建 MeshBasicMaterial。适用于地图无数据区域或作为底图色填充。

Hierarchy

TileMaterialLoader
- BackgroundLoader

Index

Constructors

Properties

Accessors

Methods

createMaterial doLoad load

Constructors

constructor

new BackgroundLoader(): BackgroundLoader
Returns BackgroundLoader
Inherited from TileMaterialLoader.constructor

Properties

`Readonly`dataType

dataType: "background"

`Readonly`info

info: { description: string; version: string } = ...

Accessors

material

get material(): ITileMaterial
获取默认材质

Returns ITileMaterial
Inherited from TileMaterialLoader.material
- Defined in packages/lib/dist/index.d.ts:1479
set material(value: ITileMaterial): void
设置默认材质（自动释放旧材质）
Parameters
- value: ITileMaterial
Returns void
Inherited from TileMaterialLoader.material
- Defined in packages/lib/dist/index.d.ts:1481

Methods

createMaterial

createMaterial(
params: TileSourceLoadParamsType<BackgroundSource>,
): ITileMaterial
创建瓦片材质实例
Parameters
- params: TileSourceLoadParamsType<BackgroundSource>
Returns ITileMaterial
瓦片材质
Overrides TileMaterialLoader.createMaterial
- Defined in packages/plugin/src/backgroundLoader/BackgroundLoader.ts:25

`Protected`doLoad

doLoad(
_url: string,
_params: TileLoadClipParamsType,
): Promise<Texture<unknown> | null | undefined>
下载影像数据，由子类实现
Parameters
- _url: string
  数据URL
- _params: TileLoadClipParamsType
  加载参数（包含裁剪边界）
Returns Promise<Texture<unknown> | null | undefined>
纹理对象
Inherited from TileMaterialLoader.doLoad
- Defined in packages/lib/dist/index.d.ts:1500

load

load(params: TileSourceLoadParamsType): Promise<ITileMaterial>
从数据源加载瓦片材质
Parameters
- params: TileSourceLoadParamsType
  瓦片加载参数（数据源、坐标、范围等）
Returns Promise<ITileMaterial>
瓦片材质
Inherited from TileMaterialLoader.load
- Defined in packages/lib/dist/index.d.ts:1487