krpano | XML элемент Layer

Применение

Элементы <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

 

Поделись страницей. Расскажи обо мне.