ol/layer/BaseImage~БазовыйИзображениеСлои
import BaseImageLayer from 'ol/layer/BaseImage.js';
Изображения, отрисовываемые сервером, доступные для произвольных областей и разрешений. Обратите внимание, что любые свойства, заданные в опциях, устанавливаются как свойство BaseObject объекта слоя; например, установка title: 'My Title' в опциях означает, что title является наблюдаемым и имеет геттеры/сеттеры.
-
НовыйБазовыйИзображениеСлои(options)
-
Имя Тип Описание classNameстрока (по умолчанию 'ol-layer') Имя класса CSS, которое нужно установить для элемента слоя.
opacityчисло (по умолчанию 1) Непрозрачность (от 0 до 1).
visibleлогическое (по умолчанию true) Видимость.
extentОбласть | undefined Пределы отображения слоя. Слой не будет отображаться за пределами этой области.
zIndexчисло | undefined Индекс Z для отображения слоя. Во время отрисовки слои упорядочиваются сначала по индексу Z, а затем по порядку. Если
undefined, для слоёв, добавленных в коллекциюlayersкарты, предполагается индекс Z 0, илиInfinity, если использовался методsetMap()слоя.minResolutionчисло | undefined Минимальное разрешение (включительно), при котором этот слой будет отображаться.
maxResolutionчисло | undefined Максимальное разрешение (исключая), ниже которого этот слой не будет отображаться.
minZoomчисло | undefined Минимальный уровень масштаба просмотра (исключая), выше которого этот слой будет отображаться.
maxZoomчисло | undefined Максимальный уровень масштаба просмотра (включительно), при котором этот слой будет отображаться.
mapКарта | undefined Устанавливает слой как наложение на карту. Карта не будет управлять этим слоем в своей коллекции слоев, и слой будет отображаться поверх. Это полезно для временных слоев. Стандартный способ добавления слоя на карту и управления им картой — использование
map.addLayer().sourceИсточникИзображения | undefined Источник для этого слоя.
propertiesОбъект.<строка, *> | undefined Произвольные наблюдаемые свойства. Можно получить доступ с помощью
#get()и#set().События:
-
change(БазовоеСобытие) — Общее событие изменения. Срабатывает, когда счётчик ревизии увеличивается. -
change:extent(ОбъектноеСобытие) -
change:maxResolution(ОбъектноеСобытие) -
change:maxZoom(ОбъектноеСобытие) -
change:minResolution(ОбъектноеСобытие) -
change:minZoom(ОбъектноеСобытие) -
change:opacity(ОбъектноеСобытие) -
change:source(ОбъектноеСобытие) -
change:visible(ОбъектноеСобытие) -
change:zIndex(ОбъектноеСобытие) -
error(БазовоеСобытие) — Общее событие об ошибке. Срабатывает при возникновении ошибки. -
postrender(СобытиеОтрисовки) — Срабатывает после отрисовки слоя. -
prerender(СобытиеОтрисовки) — Срабатывает перед отрисовкой слоя. -
propertychange(ОбъектноеСобытие) — Срабатывает при изменении свойства. -
sourceready(БазовоеСобытие)
-
Подклассы
Расширяет
Наблюдаемые свойства
| Имя | Тип | Устанавливаемое | ОбъектноеСобытие тип | Описание |
|---|---|---|---|---|
extent | Область | undefined | да | change:extent | Область слоя. |
maxResolution | число | да | change:maxresolution | Максимальное разрешение слоя. |
maxZoom | число | да | change:maxzoom | Максимальный уровень масштаба слоя. |
minResolution | число | да | change:minresolution | Минимальное разрешение слоя. |
minZoom | число | да | change:minzoom | Минимальный уровень масштаба слоя. |
opacity | число | да | change:opacity | Непрозрачность слоя. |
source | ТипИсточника | null | да | change:source | Источник слоя (или |
visible | логическое | да | change:visible | Значение свойства |
zIndex | число | undefined | да | change:zindex | Индекс Z слоя. |
Методы
-
changed() inherited
-
Увеличивает счётчик ревизий и отправляет событие 'change'.
-
dispatchEvent(event){boolean | undefined} inherited
-
Отправляет событие и вызывает всех слушателей, подписных на события этого типа. Параметр event может быть строкой или объектом с свойством
type.Имя Тип Описание eventBaseEvent | string Объект события.
Возвращаемое значение:
false, если кто-то вызвал preventDefault на объекте события или если какой-либо из слушателей вернул false.
-
Получает значение.
Имя Тип Описание keystring Имя ключа.
Возвращаемое значение:
Значение.
-
getAttributions(view){Array.<string>} inherited
-
Получить атрибуты источника данного слоя для данного представления.
Имя Тип Описание viewView | ViewStateLayerStateExtent | undefined Представление или
FrameState. Необходимо только когда слой не добавлен в карту.Возвращаемое значение:
Атрибуты данного слоя для данного представления.
-
Возвращает
extentслоя илиundefined, если он будет виден независимо от области.Возвращаемое значение:
Область слоя.
-
Получить список имён свойств объекта.
Возвращаемое значение:
Список имён свойств.
-
getMaxResolution(){number} inherited
-
Возвращает максимальное разрешение слоя. Возвращает Infinity, если для слоя не установлено максимальное разрешение.
Возвращаемое значение:
Максимальное разрешение слоя.
-
getMaxZoom(){number} inherited
-
Возвращает максимальный уровень масштабирования слоя. Возвращает Infinity, если для слоя не установлен максимальный уровень масштабирования.
Возвращаемое значение:
Максимальный уровень масштабирования слоя.
-
getMinResolution(){number} inherited
-
Возвращает минимальное разрешение слоя. Возвращает 0, если для слоя не установлено минимальное разрешение.
Возвращаемое значение:
Минимальное разрешение слоя.
-
getMinZoom(){number} inherited
-
Возвращает минимальный уровень масштабирования слоя. Возвращает -Infinity, если для слоя не установлен минимальный уровень масштабирования.
Возвращаемое значение:
Минимальный уровень масштабирования слоя.
-
getOpacity(){number} inherited
-
Возвращает непрозрачность слоя (от 0 до 1).
Возвращаемое значение:
Непрозрачность слоя.
-
Получить объект со всеми именами и значениями свойств.
Возвращаемое значение:
Объект.
-
getRevision(){number} inherited
-
Получить номер версии для этого объекта. Каждый раз при изменении объекта его номер версии увеличивается.
Возвращаемое значение:
Номер ревизии.
-
getSource(){SourceType | null} inherited
-
Получить источник слоя.
Возвращаемое значение:
Источник слоя (илиnull, если он ещё не задан).
-
getVisible(){boolean} inherited
-
Возвращает значение свойства
visibleэтого слоя. Чтобы узнать, виден ли слой на карте, используйтеisVisible()вместо этого.Возвращает:
Значение свойстваvisibleслоя.
-
getZIndex(){number | undefined} inherited
-
Возвращает индекс Z слоя, используемый для упорядочивания слоёв перед отрисовкой. Возвращает undefined, если слой не управляется.
Возвращает:
Индекс Z слоя.
-
isVisible(view){boolean} inherited
-
Слой виден на представлении карты, т.е. находится в пределах минимальной/максимальной разрёшенности или масштаба и области, не задан
visible: false, и не находится внутри группы слоёв, которая установлена вvisible: false.Имя Тип Описание viewПредставление | ViewStateLayerStateExtent | undefined Представление или
FrameState. Требуется только тогда, когда слой не добавлен на карту.Возвращает:
Слой виден на представлении карты.
-
Прослушивает события определённого типа.
Имя Тип Описание typeстрока | Массив.<строка> Тип события или массив типов событий.
listenerфункция Функция обработчика.
Возвращает:
Уникальный ключ для обработчика. Если используется массив типов событий в качестве первого аргумента, возвращаемое значение будет массивом ключей.
-
Прослушивает событие определённого типа один раз.
Имя Тип Описание typeстрока | Массив.<строка> Тип события или массив типов событий.
listenerфункция Функция обработчика.
Возвращает:
Уникальный ключ для обработчика. Если используется массив типов событий в качестве первого аргумента, возвращаемое значение будет массивом ключей.
-
Устанавливает значение.
Имя Тип Описание keyстрока Имя ключа.
value* Значение.
silentboolean | undefined Обновить без срабатывания события.
-
setExtent(extent) inherited
-
Устанавливает область, в которой слой виден. Если
undefined, слой будет виден во всех областях.Имя Тип Описание extentОбласть | undefined Область слоя.
-
setMap(map) inherited
-
Устанавливает слой для отображения поверх других слоев на карте. Карта не будет управлять этим слоем в своём наборе слоёв. Это полезно для временных слоёв. Чтобы удалить неуправляемый слой с карты, используйте
#setMap(null).Чтобы добавить слой на карту и предоставить карту возможность его управления, используйте
addLayerвместо этого.Имя Тип Описание mapКарта | null Карта.
-
setMaxResolution(maxResolution) inherited
-
Устанавливает максимальную разрёшенность, при которой слой виден.
Имя Тип Описание maxResolutionчисло Максимальная разрёшенность слоя.
-
setMaxZoom(maxZoom) inherited
-
Устанавливает максимальный масштаб (исключительно), при котором слой виден. Обратите внимание, что уровни масштаба для видимости слоя основаны на уровне масштаба представления, который может отличаться от уровня масштаба источника тайлов.
Имя Тип Описание maxZoomчисло Максимальный масштаб слоя.
-
setMinResolution(minResolution) унаследованный
-
Установите минимальное разрешение, при котором слой отображается.
Имя Тип Описание minResolutionчисло Минимальное разрешение слоя.
-
setMinZoom(minZoom) унаследованный
-
Установите минимальный масштаб (включительно), при котором слой отображается. Обратите внимание, что уровни масштаба для видимости слоя основаны на уровне масштаба представления, который может отличаться от уровня масштаба источника плиток.
Имя Тип Описание minZoomчисло Минимальный масштаб слоя.
-
setOpacity(opacity) унаследованный
-
Установите непрозрачность слоя, допустимые значения находятся в диапазоне от 0 до 1.
Имя Тип Описание opacityчисло Непрозрачность слоя.
-
setProperties(values, silent) унаследованный
-
Устанавливает коллекцию пар "ключ-значение". Обратите внимание, что это изменяет все существующие свойства и добавляет новые (ни одно из существующих свойств не удаляется).
Имя Тип Описание valuesОбъект.<строка, *> Значения.
silentлогическое | undefined Обновить без срабатывания события.
-
setSource(source) унаследованный
-
Устанавливает источник слоя.
Имя Тип Описание sourceSourceType | null Источник слоя.
-
setVisible(visible) унаследованный
-
Установите видимость слоя (
trueилиfalse).Имя Тип Описание visibleлогическое Видимость слоя.
-
setZIndex(zindex) унаследованный
-
Установите индекс Z слоя, который используется для упорядочивания слоев перед отрисовкой. Значение по умолчанию для индекса Z — 0.
Имя Тип Описание zindexчисло Индекс Z слоя.
-
un(type, listener) унаследованный
-
Отписаться от события определённого типа.
Имя Тип Описание typeстрока | Массив.<строка> Тип события или массив типов событий.
listenerфункция Функция-обработчик.
-
unset(key, silent) унаследованный
-
Удаляет свойство.
Имя Тип Описание keyстрока Имя ключа.
silentлогическое | 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