ol/source/IIIF~IIIF
import IIIF from 'ol/source/IIIF.js';
Источник слоя для сервисов IIIF Image API.
-
new IIIF(options)
-
Имя Тип Описание attributionsAttributionLike | undefined Атрибуция.
attributionsCollapsibleboolean (по умолчанию true) Атрибуция может быть свёрнута.
cacheSizenumber | undefined Устарело. Используйте параметр cacheSize слоя.
crossOriginnull | string | undefined Значение параметра crossOrigin запроса.
extentExtent (по умолчанию [0, -height, width, 0]) Экстент.
formatstring (по умолчанию 'jpg') Запрашиваемый формат изображения.
interpolateboolean (по умолчанию true) Использовать интерполированные значения при передискретизации. По умолчанию при передискретизации используется линейная интерполяция. Установите значение false, чтобы использовать метод ближайшего соседа.
projectionProjectionLike | undefined Проекция.
qualitystring | undefined Запрашиваемое качество изображения IIIF. По умолчанию для версии 1 используется 'native', для версий 2 и 3 — 'default'.
reprojectionErrorThresholdnumber (по умолчанию 0.5) Максимально допустимая погрешность перепроецирования (в пикселях). Более высокие значения могут повысить производительность перепроецирования, но снизить точность.
resolutionsArray.<number> | undefined Поддерживаемые разрешения, указанные в IIIF 'scaleFactors'
sizeSize Размер изображения [width, height].
sizesArray<Size> | undefined Поддерживаемые размеры масштабированных изображений. Содержимое свойства 'sizes' объекта IIIF info.json, представленное в виде массива объектов Size.
stateState | undefined Состояние источника.
supportsArray.<string> (по умолчанию []) Поддерживаемые возможности IIIF для вычисления области и размера.
tilePixelRationumber | undefined Пиксельный коэффициент тайла.
tileSizenumber | Size | undefined Размер тайла. Для всех уровней масштабирования используется один и тот же размер тайла. Если размер тайла задан числом, предполагается, что тайл квадратный. Если сервис изображений IIIF поддерживает произвольное разбиение на тайлы (поддерживаются sizeByH, sizeByW, sizeByWh или sizeByPct, а также regionByPx или regionByPct), размер тайла по умолчанию равен 256.
transitionnumber | undefined Переход.
urlstring | undefined Базовый URL сервиса IIIF Image. Он должен совпадать с идентификатором изображения IIIF.
versionVersions (по умолчанию Versions.VERSION2) Версия IIIF Image API сервиса.
zDirectionnumber | NearestDirectionFunction (по умолчанию 0) Выбор тайлов с более высоким или низким уровнем масштабирования при значениях масштаба между целыми числами. См.
getZForResolution.События:
-
change(BaseEvent) — Общее событие изменения. Вызывается при увеличении счётчика ревизий. -
error(BaseEvent) — Общее событие ошибки. Вызывается при возникновении ошибки. -
propertychange(ObjectEvent) — Вызывается при изменении свойства. -
tileloadend(TileSourceEvent) — Вызывается, когда загрузка тайла завершается: данные загружены или загрузка прервана, поскольку тайл больше не нужен. -
tileloaderror(TileSourceEvent) — Вызывается, если при загрузке тайла возникает ошибка. Обратите внимание: это событие не следует использовать для повторной загрузки тайлов. Подробнее см.load. -
tileloadstart(TileSourceEvent) — Вызывается при начале загрузки тайла.
-
Расширяет
Методы
-
changed() унаследовано
-
Увеличивает счётчик ревизий и отправляет событие «change».
-
clear() унаследовано
-
Удаляет все кэшированные перепроецированные тайлы из источника. При следующем цикле отображения будут созданы новые тайлы.
-
dispatchEvent(event){boolean | undefined} унаследовано
-
Отправляет событие и вызывает все обработчики, подписанные на события этого типа. Параметр event может быть строкой или объектом со свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-либо вызвал preventDefault для объекта события или если любой из обработчиков вернул false.
-
get(key){*} унаследовано
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getAttributions(){Attribution} унаследовано
-
Получает функцию атрибуции для источника.
Возвращает:
Функция атрибуции.
-
getAttributionsCollapsible(){boolean} унаследовано
-
Возвращает:
Атрибуции можно сворачивать.
-
getKeys(){Array.<string>} унаследовано
-
Получает список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getProjection(){Projection | null} унаследовано
-
Получает проекцию источника.
Возвращает:
Проекция.
-
getProperties(){NoInfer.<Properties>} унаследовано
-
Получает объект со всеми именами и значениями свойств.
Возвращает:
Объект.
-
getRevision(){number} унаследовано
-
Получает номер версии этого объекта. При каждом изменении объекта номер его версии увеличивается.
Возвращает:
Ревизия.
-
getState(){State} унаследовано
-
Получает состояние источника. Возможные состояния см. в
State.Возвращает:
Состояние.
-
getTileGrid(){TileGrid | null} унаследовано
-
Возвращает сетку тайлов источника.
Возвращает:
Сетка тайлов.
-
getTileLoadFunction(){LoadFunction} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает функцию загрузки тайлов источника.
Возвращает:
TileLoadFunction
-
getTileUrlFunction(){UrlFunction} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает функцию URL тайлов источника.
Возвращает:
TileUrlFunction
-
getUrls(){!Array.<string> | null} унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Возвращает URL-адреса, используемые для этого источника. Если вместо url или urls используется tileUrlFunction, будет возвращено значение null.
Возвращает:
URL-адреса.
-
on(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Подписывается на событие определённого типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.
-
once(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Однократно подписывается на событие определённого типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.
-
refresh() унаследовано
-
Обновляет источник. Источник будет очищен, а данные с сервера загружены повторно.
-
set(key, value, silent) унаследовано
-
Задаёт значение.
Имя Тип Описание keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновить без вызова события.
-
setAttributions(attributions) унаследовано
-
Задаёт атрибуции источника.
Имя Тип Описание attributionsAttributionLike | undefined Атрибуции. Можно передать как
string,Array<string>,Attributionилиundefined. -
setProperties(values, silent) унаследовано
-
Задаёт набор пар «ключ — значение». Обратите внимание: это изменяет существующие свойства и добавляет новые, но не удаляет существующие свойства.
Имя Тип Описание valuesPartial.<NoInfer.<Properties>> Значения.
silentboolean | undefined Обновить без вызова события.
-
setRenderReprojectionEdges(render) унаследовано
-
Задаёт, следует ли отображать границы перепроецирования (обычно используется для отладки).
Имя Тип Описание renderboolean Отображать границы.
-
setTileGridForProjection(projection, tilegrid) унаследовано
-
Задаёт сетку тайлов, которую следует использовать при перепроецировании тайлов в указанную проекцию вместо сетки тайлов, используемой для этой проекции по умолчанию.
Это может быть полезно, если сетку тайлов по умолчанию нельзя создать (например, для проекции не задана область охвата) или в целях оптимизации (пользовательский размер тайла, разрешения и т. д.).
Имя Тип Описание projectionProjectionLike Проекция.
tilegridTileGrid Сетка тайлов, используемая для проекции.
-
setTileLoadFunction(tileLoadFunction) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт функцию загрузки тайлов источника.
Имя Тип Описание tileLoadFunctionLoadFunction Функция загрузки тайлов.
-
setTileUrlFunction(tileUrlFunction, key) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт функцию URL тайлов источника.
Имя Тип Описание tileUrlFunctionUrlFunction Функция URL тайлов.
keystring | undefined Новый необязательный ключ тайла для источника.
-
setUrl(url) унаследовано
-
Задаёт URL-адрес для запросов.
Имя Тип Описание urlstring URL-адрес.
-
setUrls(urls) унаследовано
-
Устарело. Вместо этого используйте источник ImageTile. Задаёт URL-адреса для запросов.
Имя Тип Описание urlsArray.<string> URL-адреса.
-
un(type, listener) унаследовано
-
Отписывается от событий определённого типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
-
unset(key, silent) унаследовано
-
Удаляет свойство.
Имя Тип Описание keystring Имя ключа.
silentboolean | undefined Удалить без вызова события.
© 2005-present, OpenLayers Contributors All rights reserved.Licensed under the BSD 2-Clause License.
https://openlayers.org/en/latest/apidoc/module-ol_source_IIIF-IIIF.html