novosibpano@yandex.ru  

Add hotspot v1.0.


  • только HTML5. krpano-1.19-pr16.



  • Возможности.

    • Создание хотспотов в окне браузера.
    • Возможность создавать, удалять, копировать хотспоты.
    • Позиционирование хотспота мышкой, выбор изображения хотспота в открывающемся окне проводника.
    • Ввод названия хотспота, появляется при наведении мыши на хотспот.
    • Расширенные настройки - возможность изменять масштаб, прозрачность, повороты по осям x,y,z, вносить свои действия в onover, onhover, onclick, onout.
    • Назначение хотспоту открытия ссылки URL в новом окне, в текущем, во фрейме.
    • Создание списка url ссылок на определенные места в туре с заданным углом обзора. Дает возможность перехода на конкретное место в туре с внешних ресурсов
    • Назначение хотспоту открытия фотографии.
    • Назначение хотспоту открытия видеофайла.
    • Назначение хотспоту открытия youtube.
    • Открытие редактора по введению пин кода дает возможность редактирования на удаленном сервере(сервере заказчика).
    • Наличие в редакторе выпадающего списка созданных хотспотов, клик по названию открывает вид с этим хотспотом.
    • Наличие строки поиска хотспота по его названию.
    • Легкое подключение.
    • Редактирование и сохранение без правки кода в файле xml.






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

    Поместите папку "add_hotspot" в корневую папку с туром и пропишите в файле "tour.xml":

    
        <krpano .... >
        <include url="add_hotspot/plugins_l/add_hotspot.xml" />    
        .
        .
        </krpano>
    	



    PIN код.

    После подключения плагина при первом старте нажмите комбинацию клавиш "E+L", откроется строка для ввода 4-х значного пин кода.
    Введите код и нажмите "Enter" (Учитываются заглавные буквы), появится свернутая панель плагина. Раскройте панель и нажмите "Save", Откроется окно проводника, укажите путь для сохранения "add_hotspot/save_hotspot.xml"
    При повторном открытии тура панель плагина будет доступна, ввод пин кода не требуется.

    По завершении работ нажмите клавишу "Delete PIN" И пересохраните файл "save_hotspot.xml" Перезагрузите браузер - для открытия плагина опять потребуется ввод пин кода.
    Ввод пин кода позволит оставить плагин в туре и даст возможность редактирования хотспотов прямо на сервере заказчика. Изменения нельзя сохранить на сервере, файл с изменениями вы сохраняете у себя и передаете заказчику для размещения этого файла на его сервере.



    Панель для создания хотспотов.


  • Для удобства работы панель перемещается мышкой. Щелчок по треугольной кнопке сворачивает и разворачивает панель Ухватившись за треугольник справа внизу, можно расширить панель, откроются дополнительные вкладки. Вкладки находятся в свернутом состоянии и раскрываются по щелчку на треугольнике внутри вкладки справа.
    Вкладки нужны для назначения действия при щелчке по хотспоту. Выбор вкладки происходит путем нажатия соответствующей круглой кнопки, кнопка станет зеленого цвета.
  • Как изменять параметры.

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

    • Name - Введите название хотспота, появляется над хотспотом при наведении мышки.
    • drag on - Кнопка блокировки-разблокировки перемещения хотспотов.
    • Select image - Щелчек по имени или иконке откроет окно проводника для выбора изображения хотспота. Предварительно загрузите изображения в папку "add_hotspot/picture"
    • Перекрестие - Включает-выключает перекрестие для удобства позиционирования создаваемого хотспота
    • Copy "+" - Создает копию выделенного хотспота.Горячая клавиша "+". В название автоматически подставляется имя хотспота.
    • Scale - Изменяет масштаб хотспота. Нажмите и смещайте мышку в нажатом состоянии влево (уменьшение масштаба), вправо (увеличение масштаба).
    • Distorted - Включает-выключает искажение хотспота.
    • Add hotspot - Создать хотспот.
    • "Delete" - Удалить выделенный хотспот. Горячая клавиша "Delete".
    • Save - Сохранение всех созданных хотспотов и изменений в файл save_hotspot.xml.
    • Откроется окно проводника, укажите путь для сохранения "add_hotspot/save_hotspot.xml"
    • Поиск - Строка поиска хотспота. Введите название и нажмите "Enter".
    • List of hotspots - Раскрывающийся список названий созданных хотспотов. Клик по названию в списке переводит взгляд на этот хотспот.

    Раздвинув панель по ширине появятся дополнительные кнопки:


  • Drag on - Отключает перемещение каждого хотспота по отдельности. При выделении хотспота индикатор оповещает состояние
  • "Delete PIN" - Удаление пин кода и сохранение проекта.






  • Расширенные параметры.

    Более подробную информацию о назначении атрибутов хотспота можно получит на сайте

  • krpano

    Нажмите на "Onclick (direct input)", индикатор станет зеленого цвета. Станет доступен прямой ввод значения атрибута onclick . Остальные параметры хотспота в этой вкладке доступны при активности любой вкладки.

    Изменения параметра происходит путем нажатия левой клавиши мыши на кнопке и смещения в нажатом состоянии влево (уменьшение параметра), вправо (увеличение параметра). Чем дальше отводится мышь от места нажатия , тем быстреее изменяется параметр.
    Изменения сразу применяются к хотспоту и визуально можно контролировать результат.
    Параметры, имеющие два состояния (вкл. выкл) переключаются щелчком по кнопке.
    Щелчек по кнопке выделяет ее зеленой рамкой , становится доступен прямой ввод с клавиатуры - цифры (справа на клавиатуре), процент (кнопка "5" верхнего ряда клавиатуры).
    Клавиша "Backspace" очищает цифровое значение на кнопке.
    Выбранный параметр так же отображается в строке над кнопками, в которой доступно редактирование - удаление, копирование, вставка. Для ввода нужно нажать "Enter".

  • alpha - изменение прозрачности (0 - 1)/
  • rotate - вращение (-360...360)/
  • ath - горизонтальные координаты (-180...180)/
  • atv - вертикальные координаты (-90...90)/
  • rx - вращение вокруг собственной оси x. (в градусах).
  • ry - вращение вокруг собственной оси y. (в градусах).
  • rz - вращение вокруг собственной оси z. (в градусах).
  • rz - вращение вокруг собственной оси z. (в градусах).
  • Внимание!
    параметры "rx","ry",rz" изменяются только при включенном параметре "distorted".

  • Speed - изменение скорости регулировки основных параметров от 0 до 10..
  • ox - смещение по оси "x". (в пикселях).
  • oy - смещение по оси "y". (в пикселях).
  • edge - позиционирование (9 вариантов).
  • Нажатие на перечисленные ниже кнопки активирует окно со строкой ввода, в которой можно прописать или отредактировать действия или функции.

    действия / функции, которые будут вызываться когда...
    • onover - пользователь навел курсор мыши.
    • onhover - пользователь навел курсор мыши, вызываются 15 раз в секунду пока курсор над хотспотом.
    • onout - пользователь убрал курсор с хотспота.
    • onclick - пользователь щелкнул по хотспоту.
  • width - изменение ширины. (пиксели). Значение "prop" - пропорционально.
  • height - изменение высоты. (пиксели). Значение "prop" - пропорционально.
  • Для ввода значения "prop" нажмите клавишу "p"
  • zorder - слой (1-100).
  • capture - захват мыши (true/falce).
  • handcursor - показ руки при наведении мыши на хотспот (true/falce).
  • Нажатие клавиши "Backspace" очищает цифровое значение атрибута на кнопке.



    Назначение хотспоту открытия ссылки URL.


    Есть три варианта открытия ссылки:

    • New window - открыть ссылку в новом окне
    • Here - открыть ссылку в этом окне.
    • In frame - открыть ссылку во фрейме (окно в окне).
    Для выбора нажмите на нужный вариант, индикатор станет зеленого цвета.
    Выберите хотспот и введите в строку адрес открываемого сайта(или скопироуйте "Ctrl+C" и вставьте в строку "Ctrl+V") , нажмите Enter".
    Старайтесь сокращать длинные ссылки, не все ссылки могут быть открыты "In frame". Вы можете попробовать вводить ссылки здесь.



    Создание списка url ссылок на определенные места в туре.


    Эта вкладка создает ссылки такого типа:

  • http://novosibpano.ru/VT/Kotlovan/?startscene=0&startactions=lookat(-21.93,37.18,118.11);
    Она открывает виртуальный тур на выбранной сцене с выбранным местом в сцене и заданным углом обзора.
    Нужно проверить работоспособность созданной вами ссылки на сервере заказчика. Разместить, например, тестовый тур на сервере заказчика.
    Активируйте вкладку, установите нужный вид и угол обзора в сцене, задайте название виду, создайте в этом месте хотспот.
    В данном случае хотспот является ориентиром созданного вида и он становится невидимым, когда отключен режим редактирования или свернута панель. При необходимости поменяйте угол обзора - выберите хотспот и щелкните по кнопке "Save curent fov""
    Введите в строку "URL 3D tour" адрес виртуального тура. Этот адрес применим ко всем хотспотам созданным в этой вкладке. Раскрывающийся список"List of url links to hotspot" содержит названия всех созданных видов. Кнопка "Save list" сохраняет список ссылок в файл List of external links.xml в открывшемся проводнике укажите место сохранения.




  • Открыть фотографию.

    Предварительно поместите фотографии в папку add_hotspot/photo/.
    Создайте и настройте хотспот. Активируйте вкладку, нажав Open photo.
    Нажмите на миниатюру и в открывшемся окне проводника выберите изображение из папки add_hotspot/photo/.
    Щелчек по созданному хотспоту откроет выбранную фотографию.
    "Caotion on af photo" - Введите подпись к фотографии, отображается под открытой фотографией.
    Стиль текста подписи можно настроить в файле "add_hotspot/plugins_l/style_ed_L.xml"




    Открыть видео файл.

    Предварительно поместите видеофайл в папку add_hotspot/video/.
    Создайте и настройте хотспот. Активируйте вкладку, нажав Open video.
    Нажмите на миниатюру "Play" и в открывшемся окне проводника выберите видео файл из папки "add_hotspot/video/".

  • "Volume at start" - Установите необходимую громкость видеоролика при воспроизведении с помощью бегунка или введя числовое значение от 0(min) до 1(max). По умолчанию - 0.5.
  • "loop" - Выберите режим воспроизведения . Зеленый индикатор - зацикленный, серый - воспроизведение один раз.
  • "Select a poster image" - изображения (типичный снимок экрана первого видеокадра), который должен отображаться до тех пор, пока видео не будет загружено и не будет готово к воспроизведению.
    Очень рекомендуется добавление постера! Изображение постера должно иметь тот же размер пикселя, что и сам видеоролик!
  • Все выставляемые параметры локальные и привязаны к редактируемому хотспоту. Для другого хотспота установите свои настройки. Щелчек по созданному хотспоту откроет выбранный видео файл.
    Для воспроизведения видео используется видеоплеер krpano videoplayer.




    Открыть youtube.

    Создайте и настройте хотспот. Активируйте вкладку, нажав Open youtube.
    Выберите ролик на youtube и нажмите "поделиться". Появится ссылка, например https://youtu.be/mMpWL8XM2-k.
    Скопируйте код после слеша mMpWL8XM2-k и вставьте в строку, нажмите "Enter"
    По нажатию на хотспот откроется окно с роликом с youtube.






    Получить плагин создания хотспотов.

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

    Внести пожертвование 34 EUR.


    Архив включает в себя:
    • Рабочий пример использования.
    • В примере папка с плагином "add_hotspot"





    Примечание

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