Class TileCalculator

constructor

• new TileCalculator(
      tileSize?: number,
      minZoom?: number,
      maxZoom?: number,
      baseWorldUnits?: number,
  ): TileCalculator

  构造函数

  Parameters

  • tileSize: number = 256

    瓦片像素尺寸，默认256

  • minZoom: number = 0

    最小缩放级别，默认0

  • maxZoom: number = 20

    最大缩放级别，默认20

  • baseWorldUnits: number = 256

    基础世界单位，默认256（即zoom=1时，1像素=1世界单位）

  Returns TileCalculator

Static ReadonlyMAX_TILES_MULTIPLIER

tileSize

• get tileSize(): number

  获取瓦片尺寸

  Returns number

minZoom

• get minZoom(): number

  获取最小缩放级别

  Returns number

maxZoom

• get maxZoom(): number

  获取最大缩放级别

  Returns number

calculateZoomLevel

• calculateZoomLevel(zoom: number): number

  根据当前zoom值计算离散的缩放级别

  Parameters

  • zoom: number

    当前缩放比例（像素/世界单位）

  Returns number

  缩放级别（整数，可以是负数）

getWorldUnitsPerTile

• getWorldUnitsPerTile(zoomLevel: number): number

  计算指定缩放级别下每个瓦片代表的世界单位

  Parameters

  • zoomLevel: number

    缩放级别

  Returns number

  每个瓦片的世界单位尺寸

worldToTile

• worldToTile(worldX: number, worldY: number, zoomLevel: number): TileCoord

  世界坐标转换为瓦片坐标 以(0,0)为中心，支持负数索引

  Parameters

  • worldX: number

    世界坐标X

  • worldY: number

    世界坐标Y

  • zoomLevel: number

    缩放级别

  Returns TileCoord

  瓦片坐标

tileToWorldBounds

• tileToWorldBounds(coord: TileCoord): BoundingBox

  瓦片坐标转换为世界边界

  Parameters

  • coord: TileCoord

    瓦片坐标

  Returns BoundingBox

  世界坐标边界框

getVisibleTiles

• getVisibleTiles(
      viewBounds: BoundingBox,
      zoomLevel: number,
      buffer?: number,
  ): TileCoord[]

  计算当前视图需要的所有瓦片

  Parameters

  • viewBounds: BoundingBox

    视图边界（WCS世界坐标）

  • zoomLevel: number

    缩放级别

  • buffer: number = 1

    预加载缓冲区（瓦片数），默认1

  Returns TileCoord[]

  需要加载的瓦片坐标数组

getTileDistanceToCenter

• getTileDistanceToCenter(coord: TileCoord, viewCenter: Point2D): number

  计算瓦片到视图中心的距离（用于优先级排序）

  Parameters

  • coord: TileCoord

    瓦片坐标

  • viewCenter: Point2D

    视图中心（WCS）

  Returns number

  距离（瓦片单位）

sortTilesByDistance

• sortTilesByDistance(tiles: TileCoord[], viewCenter: Point2D): TileCoord[]

  按距离视图中心排序瓦片（近的在前）

  Parameters

  • tiles: TileCoord[]

    瓦片坐标数组

  • viewCenter: Point2D

    视图中心（WCS）

  Returns TileCoord[]

  排序后的瓦片坐标数组

isTileInView

• isTileInView(
      coord: TileCoord,
      viewBounds: BoundingBox,
      buffer?: number,
  ): boolean

  判断瓦片是否在视图范围内

  Parameters

  • coord: TileCoord

    瓦片坐标

  • viewBounds: BoundingBox

    视图边界（WCS）

  • buffer: number = 0

    缓冲区（瓦片数），默认0

  Returns boolean

  是否在范围内

StatictileKey

• tileKey(coord: TileCoord): string

  生成瓦片唯一key

  Parameters

  • coord: TileCoord

  Returns string