ol/source/GeoTIFF~GeoTIFFSource
import GeoTIFFSource from 'ol/source/GeoTIFF.js';
Источник для работы с данными GeoTIFF. Примечание для пользователей полной сборки: для работы источника GeoTIFF также необходимо загрузить библиотеку geotiff.js.
-
new GeoTIFFSource(options)
-
Имя Тип Описание attributionsAttributionLike | undefined Атрибуция.
sourcesArray<SourceInfo> Список сведений об источниках GeoTIFF. Несколько источников можно объединить, если их наборы разрешений совпадают после применения масштаба. Список источников задаёт соответствие между входными каналами, считываемыми из каждого GeoTIFF, и выходными каналами, предоставляемыми тайлами данных. Чтобы управлять тем, какие каналы считываются из каждого GeoTIFF, используйте свойство
bands. Например, если указать два источника: один с 3 каналами и настроенным свойствомnodata, а другой — с 1 каналом, результирующие тайлы данных будут содержать 5 каналов: 3 из первого источника, 1 альфа-канал из первого источника и 1 канал из второго источника.sourceOptionsGeoTIFFSourceOptions | undefined Дополнительные параметры, передаваемые методам
fromUrlилиfromUrlsбиблиотеки geotiff.js.convertToRGBtrue | false | 'auto' (по умолчанию false) По умолчанию каналы источников считываются без изменений. При чтении GeoTIFF для отображения в виде изображений RGB установка значения
trueпреобразует другие цветовые пространства (YCbCr, CMYK) в RGB. Установка значения'auto'приведёт к автоматическому преобразованию изображений CMYK, YCbCr, CIELab и ICCLab в RGB.normalizeboolean (по умолчанию true) По умолчанию данные источника нормализуются до значений от 0 до 1 с использованием коэффициентов масштабирования, рассчитанных на основе статистики растра или свойств
minиmaxкаждого источника. Если вместо этого вы хотите работать с исходными значениями в выражении стиля, задайте значениеfalse. Установка для этого параметра значенияfalseприведёт к игнорированию любых свойствminиmaxу источников.projectionProjectionLike | undefined Проекция источника. Если она не указана, сведения о проекции будут прочитаны из метаданных GeoTIFF.
loadMissingProjectionboolean (по умолчанию false) Следует ли пытаться загрузить отсутствующие определения проекций. Используется предварительно настроенная функция поиска проекций, которую можно изменить с помощью
setProjectionCodeLookup.transitionnumber (по умолчанию 250) Длительность перехода прозрачности при отрисовке. Чтобы отключить переход прозрачности, передайте
transition: 0.wrapXboolean (по умолчанию false) Отрисовывать тайлы за пределами области сетки тайлов.
interpolateboolean (по умолчанию true) Использовать интерполированные значения при передискретизации. По умолчанию для передискретизации данных используется линейная интерполяция. Если значение равно false, используется интерполяция методом ближайшего соседа.
Генерируемые события:
-
change(BaseEvent) — Общее событие изменения. Вызывается при увеличении счётчика ревизии. -
error(BaseEvent) — Общее событие ошибки. Вызывается при возникновении ошибки. -
propertychange(ObjectEvent) — Вызывается при изменении свойства. -
tileloadend(TileSourceEvent) — Вызывается при завершении загрузки тайла: после загрузки его данных или после отмены загрузки, если тайл больше не нужен. -
tileloaderror(TileSourceEvent) — Вызывается, если при загрузке тайла произошла ошибка. Обратите внимание: это неподходящее место для повторной загрузки тайлов. Подробнее см. в разделеload. -
tileloadstart(TileSourceEvent) — Вызывается при начале загрузки тайла.
-
Наследует
Методы
-
changed() унаследовано
-
Увеличивает счётчик ревизии и отправляет событие 'change'.
-
clear() унаследовано
-
Удаляет из источника все кэшированные перепроецированные тайлы. В следующем цикле отрисовки будут созданы новые тайлы.
-
dispatchEvent(event){boolean | undefined} унаследовано
-
Отправляет событие и вызывает все обработчики, подписанные на события этого типа. Параметр события может быть строкой или объектом со свойством
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} унаследовано
-
Возвращает сетку тайлов источника тайлов.
Возвращает:
Сетка тайлов.
-
getView(){Promise<ViewOptions>}
-
Возвращает промис со свойствами представления, определёнными на основе источника. Используйте результат этой функции как параметр
viewконструктора карты.const source = new GeoTIFF(options); const map = new Map({ target: 'map', layers: [ new TileLayer({ source: source, }), ], view: source.getView(), });Возвращает:
Промис со свойствами, относящимися к представлению.
-
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 Обновить без отправки события.
-
setTileGridForProjection(projection, tilegrid) унаследовано
-
Задаёт сетку тайлов, используемую при перепроецировании тайлов в указанную проекцию вместо сетки тайлов проекции по умолчанию.
Это может быть полезно, если сетку тайлов по умолчанию невозможно создать (например, для проекции не задана область охвата) или по причинам оптимизации (пользовательский размер тайла, разрешения и т. д.).
Имя Тип Описание projectionProjectionLike Проекция.
tilegridTileGrid Сетка тайлов для проекции.
-
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_GeoTIFF-GeoTIFFSource.html