ol/layer/BaseImage~BaseImageLayer
import BaseImageLayer from 'ol/layer/BaseImage.js';
Изображения, создаваемые на сервере и доступные для произвольных экстентов и разрешений. Обратите внимание: любое свойство, заданное в параметрах, устанавливается как свойство BaseObject объекта слоя; например, задание title: 'My Title' в параметрах означает, что title является наблюдаемым свойством и имеет методы доступа get/set.
-
new BaseImageLayer(options)
-
Имя Тип Описание classNamestring (по умолчанию 'ol-layer') Имя класса CSS, задаваемое элементу слоя.
opacitynumber (по умолчанию 1) Непрозрачность (0, 1).
visibleboolean (по умолчанию true) Видимость.
extentExtent | undefined Ограничивающий экстент для отрисовки слоя. За пределами этого экстента слой не отображается.
zIndexnumber | undefined Z-индекс для отрисовки слоя. При отрисовке слои упорядочиваются сначала по Z-индексу, а затем по позиции. Если задано
undefined, для слоёв, добавленных в коллекциюlayersкарты, предполагается значениеzIndex, равное 0, а для слоёв, у которых был вызван методsetMap(), предполагается значениеInfinity.minResolutionnumber | undefined Минимальное разрешение (включительно), при котором этот слой будет виден.
maxResolutionnumber | undefined Максимальное разрешение (не включительно), ниже которого этот слой будет виден.
minZoomnumber | undefined Минимальный уровень масштабирования вида (не включительно), выше которого этот слой будет виден.
maxZoomnumber | undefined Максимальный уровень масштабирования вида (включительно), при котором этот слой будет виден.
mapMap | undefined Устанавливает слой как наложение на карту. Карта не будет управлять этим слоем в своей коллекции слоёв, и слой будет отрисовываться поверх остальных. Это полезно для временных слоёв. Стандартный способ добавить слой на карту, чтобы она управляла им, — использовать
map.addLayer().sourceImageSource | undefined Источник данных для этого слоя.
backgroundBackgroundColor | undefined Цвет фона слоя. Если он не задан, фон не отрисовывается.
propertiesObject.<string, *> | undefined Произвольные наблюдаемые свойства. К ним можно обращаться с помощью
#get()и#set().События:
-
change(BaseEvent) — общее событие изменения. Вызывается при увеличении счётчика ревизий. -
change:extent(ObjectEvent) -
change:maxResolution(ObjectEvent) -
change:maxZoom(ObjectEvent) -
change:minResolution(ObjectEvent) -
change:minZoom(ObjectEvent) -
change:opacity(ObjectEvent) -
change:source(ObjectEvent) -
change:visible(ObjectEvent) -
change:zIndex(ObjectEvent) -
error(BaseEvent) — общее событие ошибки. Вызывается при возникновении ошибки. -
postrender(RenderEvent) — вызывается после отрисовки слоя. -
prerender(RenderEvent) — вызывается перед отрисовкой слоя. -
propertychange(ObjectEvent) — вызывается при изменении свойства. -
sourceready(BaseEvent)
-
Подклассы
Расширяет
Наблюдаемые свойства
| Имя | Тип | Можно задать | Тип события ObjectEvent | Описание |
|---|---|---|---|---|
extent | Extent | undefined | да | change:extent | Экстент слоя. |
maxResolution | number | да | change:maxresolution | Максимальное разрешение слоя. |
maxZoom | number | да | change:maxzoom | Максимальный уровень масштабирования слоя. |
minResolution | number | да | change:minresolution | Минимальное разрешение слоя. |
minZoom | number | да | change:minzoom | Минимальный уровень масштабирования слоя. |
opacity | number | да | change:opacity | Непрозрачность слоя. |
source | SourceType | null | да | change:source | Источник слоя (или |
visible | boolean | да | change:visible | Значение свойства |
zIndex | number | undefined | да | change:zindex | Z-индекс слоя. |
Методы
-
changed() унаследовано
-
Увеличивает счётчик ревизий и отправляет событие 'change'.
-
dispatchEvent(event){boolean | undefined} унаследовано
-
Отправляет событие и вызывает все обработчики, ожидающие события этого типа. Параметр события может быть строкой или объектом Object со свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращает:
false, если кто-либо вызвал preventDefault для объекта события или если какой-либо из обработчиков вернул false.
-
get(key){*} унаследовано
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращает:
Значение.
-
getAttributions(view){Array.<string>} унаследовано
-
Получает атрибуции источника этого слоя для указанного представления.
Имя Тип Описание viewView | ViewStateLayerStateExtent | undefined Представление или
FrameState. Требуется только в том случае, если слой не добавлен на карту.Возвращает:
Атрибуции для этого слоя в указанном представлении.
-
getExtent(){Extent | undefined} унаследовано
-
Возвращает
extentслоя илиundefined, если слой будет видим независимо от экстента.Возвращает:
Экстент слоя.
-
getKeys(){Array.<string>} унаследовано
-
Получает список имён свойств объекта.
Возвращает:
Список имён свойств.
-
getMaxResolution(){number} унаследовано
-
Возвращает максимальное разрешение слоя. Возвращает Infinity, если для слоя не задано максимальное разрешение.
Возвращает:
Максимальное разрешение слоя.
-
getMaxZoom(){number} унаследовано
-
Возвращает максимальный уровень масштабирования слоя. Возвращает Infinity, если для слоя не задан максимальный уровень масштабирования.
Возвращает:
Максимальный уровень масштабирования слоя.
-
getMinResolution(){number} унаследовано
-
Возвращает минимальное разрешение слоя. Возвращает 0, если для слоя не задано минимальное разрешение.
Возвращает:
Минимальное разрешение слоя.
-
getMinZoom(){number} унаследовано
-
Возвращает минимальный уровень масштабирования слоя. Возвращает -Infinity, если для слоя не задан минимальный уровень масштабирования.
Возвращает:
Минимальный уровень масштабирования слоя.
-
getOpacity(){number} унаследовано
-
Возвращает непрозрачность слоя (от 0 до 1).
Возвращает:
Непрозрачность слоя.
-
getProperties(){NoInfer.<Properties>} унаследовано
-
Получает объект со всеми именами свойств и их значениями.
Возвращает:
Объект.
-
getRevision(){number} унаследовано
-
Получает номер версии этого объекта. При каждом изменении объекта номер его версии увеличивается.
Возвращает:
Ревизия.
-
getSource(){SourceType | null} унаследовано
-
Получает источник слоя.
Возвращает:
Источник слоя (илиnull, если ещё не задан).
-
getVisible(){boolean} унаследовано
-
Возвращает значение свойства
visibleэтого слоя. Чтобы определить, виден ли слой на карте, используйте вместо этогоisVisible().Возвращает:
Значение свойстваvisibleслоя.
-
getZIndex(){number | undefined} унаследовано
-
Возвращает Z-индекс слоя, используемый для упорядочивания слоёв перед отображением. Возвращает undefined, если слой не управляется.
Возвращает:
Z-индекс слоя.
-
isVisible(view){boolean} унаследовано
-
Слой виден в представлении карты, то есть находится в пределах минимального и максимального разрешения или масштаба и экстента, не имеет значение
visible: falseи не находится внутри группы слоёв со значениемvisible: false.Имя Тип Описание viewView | ViewStateLayerStateExtent | undefined Представление или
FrameState. Требуется только в том случае, если слой не добавлен на карту.Возвращает:
Слой виден в представлении карты.
-
on(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Ожидает событие указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.
-
once(type, listener){EventsKey | Array<EventsKey>} унаследовано
-
Однократно ожидает событие указанного типа.
Имя Тип Описание typestring | Array.<string> Тип события или массив типов событий.
listenerfunction Функция-обработчик.
Возвращает:
Уникальный ключ обработчика. Если первым аргументом передан массив типов событий, возвращается массив ключей.
-
set(key, value, silent) унаследовано
-
Задаёт значение.
Имя Тип Описание keystring Имя ключа.
value* Значение.
silentboolean | undefined Обновить без вызова события.
-
setExtent(extent) унаследовано
-
Задаёт экстент, в пределах которого виден слой. Если
undefined, слой будет виден при любом экстенте.Имя Тип Описание extentExtent | undefined Экстент слоя.
-
setMap(map) унаследовано
-
Задаёт слой для отображения поверх других слоёв на карте. Карта не будет управлять этим слоем в своей коллекции слоёв. Это полезно для временных слоёв. Чтобы удалить неуправляемый слой с карты, используйте
#setMap(null).Чтобы добавить слой на карту и передать его под управление карты, используйте вместо этого
addLayer.Имя Тип Описание mapMap | null Карта.
-
setMaxResolution(maxResolution) унаследовано
-
Задаёт максимальное разрешение, при котором виден слой.
Имя Тип Описание maxResolutionnumber Максимальное разрешение слоя.
-
setMaxZoom(maxZoom) унаследовано
-
Задаёт максимальный уровень масштабирования (не включая его), при котором виден слой. Обратите внимание: уровни масштабирования для видимости слоя определяются уровнем масштабирования представления, который может отличаться от уровня масштабирования источника тайлов.
Имя Тип Описание maxZoomnumber Максимальный уровень масштабирования слоя.
-
setMinResolution(minResolution) унаследовано
-
Задаёт минимальное разрешение, при котором виден слой.
Имя Тип Описание minResolutionnumber Минимальное разрешение слоя.
-
setMinZoom(minZoom) унаследовано
-
Задаёт минимальный уровень масштабирования (включая его), при котором виден слой. Обратите внимание: уровни масштабирования для видимости слоя определяются уровнем масштабирования представления, который может отличаться от уровня масштабирования источника тайлов.
Имя Тип Описание minZoomnumber Минимальный уровень масштабирования слоя.
-
setOpacity(opacity) унаследовано
-
Задаёт непрозрачность слоя; допустимый диапазон значений — от 0 до 1.
Имя Тип Описание opacitynumber Непрозрачность слоя.
-
setProperties(values, silent) унаследовано
-
Задаёт набор пар «ключ — значение». Обратите внимание: это изменяет существующие свойства и добавляет новые, но не удаляет уже имеющиеся.
Имя Тип Описание valuesPartial.<NoInfer.<Properties>> Значения.
silentboolean | undefined Обновить без вызова события.
-
setSource(source) унаследовано
-
Задаёт источник слоя.
Имя Тип Описание sourceSourceType | null Источник слоя.
-
setVisible(visible) унаследовано
-
Задаёт видимость слоя (
trueилиfalse).Имя Тип Описание visibleboolean Видимость слоя.
-
setZIndex(zindex) унаследовано
-
Задаёт Z-индекс слоя, используемый для упорядочивания слоёв перед отображением. По умолчанию Z-индекс равен 0.
Имя Тип Описание zindexnumber Z-индекс слоя.
-
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_layer_BaseImage-BaseImageLayer.html