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.

    Протестируйте плагин по этой ссылке. Для приобретения плагина напишите на почту novosibpano@ya.ru. Я вышлю на этот адрес ссылку на скачивание архива с файлами редактора хотспотов в течение 24 часов.
    Обновления плагина бесплатно!


    Также вы можете воспользоваться формой обратной связи (значок в левом нижнем углу сайта), либо оставить информацию в разделе "Комментарий".

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



    Примечание.

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





    Изменения.

    19.10.2017

    Версия 1.2

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

    09.10.2017

    Версия 1.1

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




    Комментарии.