Применение
Элементы <layer> или <plugin> могут использоваться для включения изображений, логотипов, кнопок или динамических плагинов (например, плагинов krpano).
Для объединения, стека, подслоя нескольких элементов <layer> или <plugin> можно использовать либо родительский параметр, либо элементы child <layer> / <plugin> могут быть объявлены как дочерние элементы xml. В этом случае элемент parent и keep будут автоматически назначены родительскому элементу.
Примечание. Элементы <layer> или <plugin> являются внутренне точно такими же элементами, но только с разными именами! Рекомендуется использовать «layer» вместо «plugin», потому что он лучше описывает элемент. Имя «плагин» относится к более старым версиям krpano и только для обратной совместимости.
Список параметров слоя
<layer name=»…»
type=»image»
url=»…»
keep=»false»
parent=»»
visible=»true»
enabled=»true»
handcursor=»true»
maskchildren=»false»
scalechildren=»false»
zorder=»»
capture=»true»
children=»true»
preload=»false»
blendmode=»normal»
style=»»
align=»»
edge=»»
safearea=»true»
x=»»
y=»»
ox=»»
oy=»»
rotate=»0.0″
width=»»
height=»»
scale=»1.0″
pixelhittest=»false»
smoothing=»true»
accuracy=»0″
alpha=»1.0″
autoalpha=»false»
usecontentsize=»false»
scale9grid=»»
crop=»»
onovercrop=»»
ondowncrop=»»
mask=»»
effect=»»
bgcolor=»0x000000″
bgalpha=»0.0″
bgborder=»0″
bgroundedge=»0″
bgshadow=»»
bgcapture=»false»
onover=»»
onhover=»»
onout=»»
onclick=»»
ondown=»»
onup=»»
onloaded=»»
/>
layer.count
Количество всех элементов layer или plugin.
Тип: целочисленный
Значение по умолчанию: 0
layer.enabled
Включает или отключает весь слой (плагин) для получения событий мыши.
Тип: булевый
Значение по умолчанию: TRUE
layer.visible
Показывает или скрывает весь слой (плагин).
Тип: булевый
Значение по умолчанию: TRUE
layer.alpha
Управляет прозрачностью (альфами) всего слоя или плагина.
Тип: NUMBER
Значение по умолчанию: 1.0
layer.layer (Только для as3)
ActionScript 3 Объект Sprite слоя (плагина).
Тип: Sprite
name
Имя текущего элемента layer (plugin) (см. Примечания названия — https://krpano.com/docu/xml/#name-notes
Полное имя переменной: layer[name].name
Тип: String — строка
index — только для чтения
Индекс текущего слоя или элемента плагина.
Полное имя переменной: layer[name].index
Тип: int — целочисленный
type
Тип элемента layer или plugin.
Возможные настройки:
- image (Образ) — По умолчанию используется URL-адрес в качестве изображения.
- container (Контейнер) — Используйте этот слой / плагин как элемент контейнера для других элементов layer / plugin. Элемент layer / plugin должен иметь настройки ширины и высоты! Элемент контейнера может иметь фоновое изображение, которое может управляться параметрами bgcolor, bgalpha, bgborder, bgroundedge, bgshadow и bgcapture.
- text (текст) — Используйте этот слой / плагин как текстовое поле — https://krpano.com/plugins/textfield/#top
Полное имя переменной: layer[name].type
Тип: String — строковый
Значение по-умолчанию: «image»
url
Путь (url) к файлу изображения слоя (плагина). (см. также примечания к URL) — https://krpano.com/docu/xml/#url-notes
Поддерживаемые типы файлов: JPG, PNG, GIF и SWF (только для Flash).
Чтобы определить разные URL-адреса для Flash и HTML, следует использовать проверку устройств xml:
url.flash=»plugin.swf
url.html5=»plugin.js
Полное имя переменной: layer[name].url
Тип: String — строковый
keep
Если этот слой (плагин) сохраняться или удаляться при загрузке новой панорамы.
См. Также действие loadpano () — https://krpano.com/docu/actions/#loadpano
Полное имя переменной: layer[name].keep
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: false
visible
Влияет на видимость элемента layer или plugin.
Полное имя переменной: layer[name].visible
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: true
enabled
Позволяет элементу layer (plugin) получать события мыши. Когда установлено значение «false», события мыши будут перенаправлены на базовые элементы.
Полное имя переменной: layer[name].enabled
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: true
parent
handcursor
Показывает курсор мыши, когда мышь находится над элементом layer или plugin.
Полное имя переменной: layer[name].handcursor
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: true
maskchildren
Когда установлено значение true, все дочерние элементы, которые находятся вне родительского элемента, будут обрезаны или замаскированы.
Заметки HTML5 Safari / iOS — при использовании maskchildren = true в элементе контейнера с закругленными краями и тенями (с помощью настроек bgroundedge и bgshadow) дочерние элементы не будут обрезаны на закругленных краях. Это ошибка браузера Safari (Desktop и iOS), все остальные браузеры в порядке.
Полное имя переменной: layer[name].maskchildren
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: false
scalechildren
zorder
Глубокое или ‘Z’ упорядочение элементов слоя (плагина).
Это значение может быть любой строкой или числом. Все элементы layer / plugin с настройкой zorder будут отсортированы по заданному значению. Когда ничего не задано — порядок не определен и зависит от порядка загрузки / завершения браузера.
Примечание. Это важная настройка для перекрывающихся элементов!
Заметки HTML5 — zorder должен быть значением от 0 до 100, без отрицательных значений!
Полное имя переменной: layer[name].zorder
Тип: String — Строка
capture
Это дополнительная настройка для enabled настройки:
- Когда enabled = true и capture = true, события мыши будут отправляться только на этот слой (плагин), перемещение или управление панорамой невозможно.
- Когда enabled = true и capture = false, события мыши будут отправлены на слой (плагин), а также ко всем базовым элементам, управление панорамой будет по-прежнему возможно.
Полное имя переменной: layer[name].maskchildren
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: True
children
Включает дочерние элементы текущего элемента layer (plugin) для получения событий мыши.
Полное имя переменной:layer[name].children
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: True
preload
Предварительно загрузите URL-адрес слоя (плагина) перед загрузкой панели и перед выполнением любых действий. Это можно использовать, чтобы заставить какой-то элемент быть там и готов, прежде чем начнется все остальное.
Примечание. Событие onloaded не работает (не может использоваться), когда включена предварительная загрузка! — https://krpano.com/docu/xml/#plugin.onloaded
Полное имя переменной:layer[name].preload
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: false
blendmode
style
align
Выравнивание или исходное положение элемента layer на экране.
Возможные значения:
- lefttop,
- left,
- leftbottom,
- top,
- center,
- bottom,
- righttop,
- right,
- rightbottom
- — или — no value (empty or null)
Когда НЕ установлено (по умолчанию), никакое позиционирование не будет выполнено krpano (полезно или необходимо для некоторых плагинов flash / swf).
edge
Край (anchor-point) элемента layer (plugin).
Возможные значения: lefttop, left, leftbottom, top, center, bottom, righttop, right, rightbottom — или — no value (empty or null)
Когда НЕ установлен (по умолчанию), будет использоваться тот же параметр, что и в атрибуте align.
safearea
Если слой находится относительно безопасной области дисплея или области полного отображения.
Полное имя переменной: layer[name].safearea
Тип: Boolean — Правда или Ложь
Значение по-умолчанию: TRUE
x, y
Расстояние от точки align (выравнивания) до edge (граничной) точки.
Это может быть абсолютное значение пикселя или относительное (по отношению к ширине или высоте экрана) процентное значение.
Примечание. Для элементов с выравниванием справа или снизу это расстояние будет измеряться с правой или нижней стороны.
Полное имя переменной:
layer[name].x
layer[name].y
Тип: String — строка
ox
oy
rotate
width
height
scale
pixelhittest
smoothing
accuracy
alpha
autoalpha
usecontentsize
scale9grid
crop
onovercrop
ondowncrop
mask
effect
bgcolor
bgalpha
bgborder
bgroundedge
bgshadow
bgcapture
onover
onhover
onout
onclick
ondown
onup
onloaded