Class: ImageTileSource

ol/source/ImageTile~ImageTileSource


import ImageTileSource from 'ol/source/ImageTile.js';

类型化数组数据瓦片的数据源。

new ImageTileSource(options)

Name Type Description
url UrlLike | undefined

图像 URL 模板。除了单个 URL 模板外,还可以提供 URL 模板数组或函数。如果提供函数,它将以 z、x、y 瓦片坐标和加载器选项调用,并应返回 URL。

loader Loader | undefined

数据加载器。使用 z、x 和 y 瓦片坐标调用。返回瓦片的 image 或其 Promise。Promise 应在图像加载完成之前不解析。如果提供了 url 选项,将创建一个加载器。

attributions AttributionLike | undefined

归属信息。

attributionsCollapsible boolean (defaults to true)

归属信息是否可折叠。

maxZoom number (defaults to 42)

可选的最大缩放级别。如果提供了 tileGrid 则不使用。

minZoom number (defaults to 0)

可选的最小缩放级别。如果提供了 tileGrid 则不使用。

tileSize number | Size (defaults to [256, 256])

源瓦片的像素宽度和高度。如果提供了 tileGrid,这可能与渲染的像素尺寸不同。

gutter number (defaults to 0)

数据瓦片周围要忽略的边距大小(像素)。这允许忽略瓦片边缘的渲染伪影。支持的数据应比瓦片尺寸宽和高 2 x gutter 值。

maxResolution number | undefined

可选的零级别瓦片网格分辨率。如果提供了 tileGrid 则不使用。

projection ProjectionLike (defaults to 'EPSG:3857')

瓦片投影。

tileGrid TileGrid | undefined

瓦片网格。

state State | undefined

数据源状态。

wrapX boolean (defaults to true)

渲染对趾线以外的瓦片。

transition number | undefined

淡入新瓦片的过渡时间(毫秒)。

interpolate boolean (defaults to true)

重采样时使用插值。

crossOrigin CrossOriginAttribute (defaults to 'anonymous')

传递给图像数据加载器的 crossOrigin 属性。

referrerPolicy ReferrerPolicy | undefined

已加载图像的 referrerPolicy 属性。

zDirection number | NearestDirection函数 (defaults to 0)

选择在整数缩放级别之间使用更高还是更低缩放级别的瓦片。参见 getZForResolution

触发事件:

Subclasses

Extends

Methods

增加修订计数器并分发 'change' 事件。

移除数据源中所有缓存的重投影瓦片。下一个渲染周期将创建新的瓦片。

dispatchEvent(event){boolean | undefined} inherited

分发事件并调用所有监听此类型事件的监听器。事件参数可以是一个字符串或一个 具有 type 属性的对象。

Name Type Description
event BaseEvent | string

事件对象。

返回值:
如果有人在事件对象上调用了 preventDefault 或任何监听器返回 false,则返回 false

获取一个值。

Name Type Description
key string

键名。

返回值:
值。

获取数据源的归属函数。

返回值:
Attribution function.

getAttributionsCollapsible(){boolean} inherited

返回值:
归属信息是否可折叠。

getKeys(){Array.<string>} inherited

获取对象属性名列表。

返回值:
属性名列表。

getProjection(){Projection | null} inherited

获取数据源的投影。

返回值:
投影。

getProperties(){NoInfer.<Properties>} inherited

获取包含所有属性名和值的对象。

返回值:
对象。

getRevision(){number} inherited

获取此对象的版本号。 每次对象被修改时,其版本号将递增。

返回值:
版本号。

获取数据源的状态,可能的状态参见 State。

返回值:
状态。

getTileGrid(){TileGrid | null} inherited

返回瓦片数据源的瓦片网格。

返回值:
瓦片网格。

on(type, listener){EventsKey | Array<EventsKey>} inherited

监听特定类型的事件。

Name Type Description
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数。

返回值:
监听器的唯一键。如果第一个参数是事件类型数组,则返回键的数组。

once(type, listener){EventsKey | Array<EventsKey>} inherited

仅监听一次特定类型的事件。

Name Type Description
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数。

返回值:
监听器的唯一键。如果第一个参数是事件类型数组,则返回键的数组。

set(key, value, silent) inherited

设置一个值。

Name Type Description
key string

键名。

value *

值。

silent boolean | undefined

更新但不触发事件。

setAttributions(attributions) inherited

设置数据源的归属信息。

Name Type Description
attributions AttributionLike | undefined

归属信息。可以作为字符串、Array<string>、Attribution 或 undefined 传入。

setProperties(values, silent) inherited

设置一组键值对。 注意,这会更改任何现有属性并添加新属性(不会移除任何现有属性)。

Name Type Description
values Partial.<NoInfer.<Properties>>

值。

silent boolean | undefined

更新但不触发事件。

setTileGridForProjection(projection, tilegrid) inherited

设置在将瓦片重投影到给定投影时使用的瓦片网格, 而不是默认的瓦片网格rojection.

当无法创建默认瓦片网格(例如投影未定义范围)或出于优化原因(自定义瓦片尺寸、分辨率等)时,这可能很有用。

Name Type Description
projection ProjectionLike

投影。

tilegrid TileGrid

用于投影的瓦片网格。

Name Type Description
url UrlLike

新 URL。

un(type, listener) inherited

取消监听特定类型的事件。

Name Type Description
type string | Array.<string>

事件类型或事件类型数组。

listener function

监听器函数。

unset(key, silent) inherited

取消设置一个属性。

Name Type Description
key string

键名。

silent boolean | undefined

取消设置但不触发事件。