Class TileImageLoader

瓦片影像加载器

加载标准XYZ瓦片图像，处理超过数据源最大级别时的父瓦片裁剪逻辑，最终生成带有 sRGB 色彩空间的 Three.js 纹理。

Hierarchy (View Summary)

TileMaterialLoader
- TileImageLoader

Index

Constructors

Properties

Accessors

Methods

createMaterial doLoad load

Constructors

constructor

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

Properties

`Readonly`dataType

dataType: "image"

数据类型标识

`Readonly`info

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

加载器信息

Accessors

material

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

Returns ITileMaterial
Inherited from TileMaterialLoader.material
- Defined in packages/lib/src/loader/TileMaterialLoader.ts:25
set material(value: ITileMaterial): void
设置默认材质（自动释放旧材质）
Parameters
- value: ITileMaterial
Returns void
Inherited from TileMaterialLoader.material
- Defined in packages/lib/src/loader/TileMaterialLoader.ts:29

Methods

createMaterial

createMaterial(_params: TileSourceLoadParamsType): ITileMaterial
创建瓦片材质实例
Parameters
- _params: TileSourceLoadParamsType
  瓦片加载参数
Returns ITileMaterial
瓦片材质
Inherited from TileMaterialLoader.createMaterial
- Defined in packages/lib/src/loader/TileMaterialLoader.ts:75

`Protected`doLoad

doLoad(url: string, params: TileLoadClipParamsType): Promise<Texture<unknown>>
加载瓦片图像并转换为纹理

当请求级别超过数据源最大级别时，从最大级别的父瓦片中裁剪出对应区域，以保证纹理内容正确。
Parameters
- url: string
  图像资源URL
- params: TileLoadClipParamsType
  加载参数，包含瓦片坐标和裁剪边界
Returns Promise<Texture<unknown>>
带 sRGB 色彩空间的纹理对象
Overrides TileMaterialLoader.doLoad
- Defined in packages/lib/src/loader/tileImageLoader/TileImageLoader.ts:39

load

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