novosibpano@yandex.ru  

Плагин "Hotspot Editor" v1.2 для krpano.


Возможности редактора хотспота.

  • Изменение основных параметров позиционирования хотспота.
  • Возможность визуально контролировать результат во время изменений. Изменяемые параметры сразу передаются хотспоту.
  • Хотспот можно перетаскивать мышкой.
  • Оригинальная система изменения параметров, нет нагромождения кнопок.
  • Возможность ввода параметров с клавиатуры.
  • Возможность редактировать хотспоты с одинаковыми именами в разных сценах
  • Вывод параметров в консоль с возможностью копирования.
  • Возможность сохранить изменения без редактирования файлов xml.




Примеры.

Пример на YouTube



Пример в 3D туре
Раскрыть на полный экран.





Панель управления.

Редактор представляет из себя панель с расположенными внутри кнопками для изменения параметров хотспота. Для удобства работы панель перемещается мышкой внутри окна просмотра.По щелчку на верхней части панели(с треугольничком) она сворачивается. Возможность редактировать хотспоты с изображениями, фреймами, видеохотспоты.



Настраиваемые параметры

Подчеркнутые параметры со ссылкой к документации на сайте krpano.

  • on-off - отключение-включение режима редактирования.
  • scale - изменение масштаба.
  • width - изменение ширины (в пикс.).
  • height - изменение высоты (в пикс.).
  • alpha - изменение прозрачности (от 0 до 1)
  • rotate - вращение(в градусах).
  • ath - горизонтальные координаты (в градусах).
  • atv - вертикальные координаты (в градусах).
  • edge - позиционирование точки привязки в хотспоте. (9 вариантов).
  • rx - вращение вокруг собственной оси x. (в градусах).
  • ry - вращение вокруг собственной оси y. (в градусах).
  • rz - вращение вокруг собственной оси z. (в градусах).
  • ox - смещение по оси х. (в пикс.).
  • oy - смещение по оси y. . (в пикс.).
  • depth - Внутренняя глубина 3D-рендеринга - это расстояние 3D-объекта до экрана. Для 2D-просмотра это не имеет видимого эффекта, но для просмотра стерео 3D / VR это может быть важная настройка.
  • Speed - изменение скорости регулировки основных параметров от 0 до 10.
  • Copy settings - открыть окно с текущими параметрами хотспота для копирования.
  • Save XML - сохранить изменения в файл param_set_hs.xml



Как подключить

После подключения редактора и запуске тура все хотспоты становятся доступны для редактирования.
Для подключения редактора поместить папку "edit_hotspot" в корневую папку с туром и прописать в основном файле xml:


    <krpano .... >
    <include url="edit_hotspot /edit_hotspot.xml" />
    .
    .
    </krpano>
	

Если вы будете сохранять без редактирования файлов xml, то нужно дополнительно прописать:


    <include url="edit_hotspot /param_set_hs.xml" />
	
Важно!
Чтобы в консоли отобразились последние измененные параметры, нужно нажать на соответствующий хотспот.
Для редактирования параметров "rx" "ry" "rz" параметр хотспота "distorted" должен быть включен distorted="true".




Работа с редактором

Как редактировать хотспот.

Выбраь хотспот нажав на него, сверху в панели появится имя редактируемого хотспота. Редактируемый хотспот перемещается мышкой и координаты позиционирования сразу отображаются на соответствующих кнопках.
Изменения параметра происходит путем нажатия левой клавиши мыши и смещения в нажатом состоянии влево(уменьшение параметра), вправо (увеличение параметра). Чем дальше отводится мышь от места нажатия , тем быстреее изменяется параметр.
Изменения сразу применяются к хотспоту и визуально можно контролировать результат.
Щелчек по кнопке выделяет ее зеленой рамкой и тогда доступен ввод параметра с клавиатуры (цифры с правой стороны на клавиатуре). Доступны все цифры, процент(кнопка "5" верхнего ряда клавиатуры), буквы A,B,C,D,E для ввода значения цвета в шеснатеричной системе и ввод "prop"(пропорционально). После набора параметра для ввода нажать "Enter", при ошибке ввода клавиша "Delete" очищает кнопку.

Сохранение измененных параметров.

Три варианта сохранения измененных параметров (редакция от 9.10.17г)

1. Копирование из консоли.
Открыть консоль (клавиша "О"). Нажать на отредактированный хотспот - в консоли отобразятся текущие параметры хотспота.



Выделить мышкой необходимые параметры, скопировать и заменить измененные параметры хотспота на скопированные в файле tour.xml.

2. Копирование из модального окна.
Нажать кнопку "Copy settings" - откроется модальное окно в котором отобразятся текущие параметры хотспота. Текст выделен и можно скопировать комбинацией клавиш "Ctrl+C" и заменить измененные параметры хотспота на скопированные в файле tour.xml.



3. Сохранение без редактирования файлов xml.
Подключите в основном файле XML файл "param_set_hs.xml"
После редактирования хотспотов нажать кнопку в панели "Save XML".



Откроется окно проводника, в котором нужно указать папку "edit_hotspot" для сохранения файла "param_set_hs.xml".
Выбираем в окне файл "param_set_hs.xml", нажимаем "сохранить" и подтверждаем "заменить файл".



окно браузера Перезагружаем! окно браузера - изменения приняты.




Важно!

  • В файле "param_set_hs.xml" хранятся параметры измененных хотспотов. При старте из этого файла устанавливаются новые значения хотспотов, основной "tour.xml" не изменяется. Обновляются все параметры, которые регулируются в редакторе даже если они не редактировались. Остальные параметры хотспота ("enabled", "keep", "handcursor" и т.д.) не затрагиваются и редактируются в файле "tour.xml"
    Хотспоты отредактированные в файле "tour.xml" при старте изменятся на установки из файла "param_set_hs.xml" !

    Если удалить файл "param_set_hs.xml", то хотспоты примут значения из файла "tour.xml".
  • Важно сохранить настройки перед выходом из сцены, иначе настройки не сохранятся.
  • Если использовался фйл "param_set_hs.xml" то по завершению работы над хотспотами его нужно оставить вместе с папкой "edit_hotspot".
  • Нужно проверить параметры сохранения браузера, по умолчанию сохранение может быть в папку "download". Измените настройки.

    Пример:
    браузер"chrome"






  • Преобрести плагин редактора хотспотов.

    Стоимость плагина 25 EUR.

    Потестируйте плагин по этой ссылке. Если вам понравился редактор хотспотов, Вы можете преобрести его оплатив через PayPal (кнопка Pay Nov).
    Не забудьте указать адрес электронной почты. После оплаты я вышлю на этот адрес ссылку на скачивание архива с файлами редактора хотспотов в течении одного дня.
    Обновления плагина бесплатно!

    Редактор хотспотов 25 EUR.

    Архив включает в себя:
    • Рабочий пример использования.
    • В примере папка ""edit_hotspot"" с файлами галереи в которой:
    • edit_hotspot.xml (Исполняющий файл. закрытый код)
    • Param_set.xml (Для сохранения параметров)
    • triangle_ar.jpg (иконка)



    Лицензия

    Этот плагин предлагается как коммерческий плагин. Он предоставляется «как есть» без каких-либо гарантий, явных или подразумеваемых, включая любую гарантию качества, товарности или пригодности для определенной цели. Ни в коем случае автор плагина не несет ответственности за потерю данных, стоимость закупки замещающих товаров или услуг или любых особых, косвенных или случайных убытков по любой причине и независимо от того, или нет, автор плагина был уведомлен о возможности такого ущерба.
      Это ограничение будет применяться независимо от любого отказа основной цели любого ограниченного средства правовой защиты, предусмотренного в настоящем документе. В любом случае автор плагина не будет нести ответственности, вытекающей из этого соглашения.





    Изменения

    19.10.2017

    Версия 1.2

    Изменение метода подключения. Не нужно в каждый хотспот прописывать действия для редактирования. После подключения плагина все хотспоты автоматически становятся доступными для редактирования. Добавлена кнопка в панели "on-off" - отключает-включает режим редактирования.

    09.10.2017

    Версия 1.1

    Изменение метода сохранения. Добавилось сохранение без редактирования файлов xml. Исправлены ошибки с редактированием хотспотов с одинаковыми именами в разных сценах .