The hotspots are created locally and, when saved, are registered inside the scenes.
You can edit the hot spots created by a non-plugin and save their changes.
The plugin will only work with your krpano license.
You need to send me the email
that you used to register your krpano. It can be seen in "krpano Tools".
After that,
you will receive an email with a link to download the plugin and a key file with activation
instructions.
Put the folder "add_hotspot" in the root folder with the tour and write in the file
"tour.xml":
<krpano .... > <include url="add_hotspot/plugins_l/add_hotspot.xml" /> <include url="add_hotspot/plugins_l/editor/add_hotspot_2.xml" /> . . </krpano>
Warning!
The plugin works, when you open a tour in the Internet browser. Will not work when
opening
with "Krpano Tools".
When finished, in the file "tour.xml": delete the line:
<include url="add_hotspot/plugins_l/editor/add_hotspot_2.xml" />
Reload the tour - the editor panel will disappear.
When placing on the server or transferring the tour to the customer, delete the editor folder
"editor" which is located along the path add_hotspot/plugins_l.
For example, your main file is test.xml and you want to place the folder with
the
plugin in the skinfolder.
Put the "add_hotspot" folder in the skin folder and write it in the
"test.xml" file.
<krpano> <include url="%SWFPATH%/skin/add_hotspot/plugins_l/add_hotspot.xml" /> <include url="%SWFPATH%/skin/add_hotspot/plugins_l/editor/add_hotspot_2.xml" /> </krpano>
In the add_hotspot/plugins_l/plugin_a/style_addhs.xml file, write:
<addhs_settings FIRSTXML="test" path="%SWFPATH%/skin/" />
FIRSTXML - name of the main XML file.
path - path to the location of the plugin folder.
- Open the hotspot attribute settings panel.
- Open a window with the hotspot code.
- display the scene code in the window.
- display the entire xml file code in
the window.
Saving hot spots.
If backup is enabled, you will be prompted to save a copy first.
"tour.xml - backup-2021.12.14-12.20.52.xml" where the date and time will be
specified, followed by
you will be prompted to save "tour.xml" with created hotspots. Replace the existing
file
"tour.xml" to the proposed one. If the file name is different, then the one you want
will be substituted. specified
You can disable saving a
backup copy in a fileadd_hotspot/plugins_l/plugin_a/style_addon.xml by installing
backup="false"
- Selective copying of attributes.
-copy the attributes of the selected hotspot (Ctrl+C).
- paste the copied attributes (Ctrl+V).
Drag - blocking/unblocking the movement of an active hotspot.
Drag all - blocking/unblocking the movement of all created hot spots.
Title -if necessary, enter a description of the hotspot (by default the hotspot name is displayed). Click on the round button (or on the "Title"). It will turn green - the description will be appear when hovering the cursor over a hotspot.
Image icon - click on the icon to open a window to select the hotspot image. The images should be placed along the path "add_hotspot/picture".
- turn on/off the crosshair for easier
positioning of the hotspot being created.
- delete the selected hotspot.
The "Delete" hotkey.
- sets in hotspot enabled=false . The hotspot is disabled and does not respond to the
mouse.
If you collapse and expand the editing panel, enabled will be set to true and the text will
be editable again.
- block the hotspot from editing. The hotspot will not be dragged with the mouse. Changes
hotspot settings will be disabled.
- - temporarily disables the action of all hotspots (on over, on out, onclick, ondown, onup,
onhover), which will allow you to work with hotspots safely (for example, when you click it,
it will not send you to another scene). Does not disable attributes specified in the style
as
".addevent"
- creates a copy of the selected hotspot.
The "+" hotkey.
-enable/disable distortion.
- show/hide the joystick on the hotspot.
The joystick appears on the hotspot's nodal point. Click and move the cursor left/right -
rotation on the "x" axis (attribute "rx"). Offset cursor up/down - rotation along the "y"
axis (attribute "ry").
There is a z-axis rotation button under the joystick. To change it, click and move the
cursor left/right (the "rz" attribute).
Zoom button above the joystick - press and move the cursor left/right (the "scale"
attribute).
- selecting the attributes to insert.
Clicking this button opens a list of attributes. Enable/disable the necessary attributes for
copying.
By grabbing the triangle at the bottom right, you can expand the panel. Additional tabs will
open.
The tabs are in a collapsed state and are expanded by clicking on the triangle or the name
inside the tab.
Tabs are needed to assign an action when clicking on a hotspot and to create text, polygon,
and video hotspots. The tab is selected by pressing the corresponding round button, the
button will turn green. When you click on a hotspot, the corresponding tab becomes active.
By default, a hotspot image is created without assigning any actions to it. In the tab "Manual setings (direct input)" you can set its parameters manually.
How to change parameters:
Select a hotspot by clicking on it, name of edited
access point appears on first line. Edited hotspot is moved by mouse
and positioning coordinates are immediately displayed on corresponding buttons.
Clicking in an empty place on screen resets selection!
Changes to parameter are made by pressing left mouse button and moving it to the left
(decrease the parameter) and to the right
(parameter increase). Farther the mouse is moved away from click location, when faster
parameter changes.
The changes are directly applied to hotspots and you can be visually controlled result.
Parameters that have two states (on or off) switch by clicking on button.
Clicking on button highlights it with a green frame, direct keyboard input becomes available
- numbers (right on keyboard), percentage ("5" button of top row of keyboard).
Backspace clears the numeric value on the button.
Selected parameter is also displayed in the line above buttons, where you can edit/delete,
copy, paste. To enter, press "Enter" button.
You can also edit local hotspots. Make changes and open the active hotspot settings window.
Copy the changed parameters and paste into the hotspot.
Attribute window - open a window to display the parameters of the active hotspot.
Action list - open a window with a list of frequently used actions.
You can use it as a draft, you can copy ("Ctrl + C"), paste ("Ctrl + C") actions.
The list is along the way add_hotspot/plugins_l/actionSM.html - you can fill in
the required information.
Info "action" - opens the Krpano website with background information on actions and functions .
Info "hotspot" - opens the Krpano website with background information about settings of hotspot.
- Show 3D coordinates and invert control controls.
This tool should be used when working in a 3D model or with depth maps. When you launch
it, the model center view from the outside changes. The X Y Z coordinate axes are set.
When creating a hotspot in this mode, the following attribute values are set:
ath=0
atv=0
depth=0
distorted=true
Moving the hotspot with the mouse is blocked. The position of the hotspot in space
changes in the Cartesian coordinate system by changing the parameters tx ty tz. There
are round buttons on the axes. Click on the button and drag - the hotspot will move
along this axis.
Hotspots with 3d coordinates are created in the 3D model, in this case, the attribute
depth=0.
Dragging the hotspot with the mouse in the 3D model takes place according to the coordinates
tx ty tz, if depth=0.
ath - horizontal coordinate (-180...180).
atv - vertical coordinate (-90...90).
alpha - change alpha (0 - 1).
rotate - rotate (-360...360).
speed - changing speed of main parameters from 0 to 10.
rx
- rotation around its own x axis (in degrees).
ry - rotation around its own axis y (in degrees).
rz - rotation around its own axis z (in degrees).
ATTENTION!
parameters "rx", "ry", rz
" are changed only when the parameter "distorted" is enabled".
ox - offset along «x»-axis (in px).
oy - oy - offset along «y»-axis (in px).
width - width change (pixels.) The value of "prop" is proportional (by
default, pixels).
height - height change (pixels). The value "prop" is proportional (by
default "prop"). To enter the "prop" value, press the "p" key.
scale - changes scale of hotspots. Press and move mouse in the pressed
state to the left ( zoom out) or to the right (zoom in).
edge - positioning (9 variants).
zorder - display sequence number (visibility). A higher value brings to
the foreground (1-100).
capture - mouse capture. if the value is" false", clicking on the hot spot
and shifting to the side does not prevent moving the panorama (true/falce).
distorted - on/off distorted hotspot.
zoom - should the size of the hotspot image change together with the pano
when zooming.
flying - this setting interpolates automatically the ath/atv and scale
values to the current viewing values. The value range is from
0.0 to 1.0. At 1.0 the hotspot image will be locked always to the middle to screen and
it's size will be relative to 1000 pixel in screen height.
handcursor - show hand when hovering hotspot (true/falce).
enabled2 - all generated hotspots are global and the values "enabled" and
"visible" become active in the scene that is listed in the hotspot.
If enabled2="falce", then regardless of the prescribed scene hotspot will be turned off.
In edit mode enabled2="true" (true/falce).
visible2 - if visible2 = "falce", then regardless of the registered scene,
the hotspot will be invisible. In edit mode visible2="true" (true/falce).
depth - the internal 3D rendering depth - that's the distance of the 3D
object to the screen.
For 2D viewing this has no visible effect, but for stereo 3D/VR viewing this can be
important setting. E.g. use smaller values for a stronger 'pop-out' effect.
When a hotspot image should be infinity far away (like the pano image itself, e.g. to
pixel-perfectly match the pano-background) then an 'invalid' value
(e.g. a String like "off") should be used for the depth setting - e.g. depth="off".
url - the path/url to the hotspot image file.
html - the text (in the text of the hotspot).
tx - 3D x offsets (only available for distorted hotspots).
ty - 3D y offsets (only available for distorted hotspots).
tz - 3D z offsets (only available for distorted hotspots).
renderer - the visualization for the hotspot (webgl/css3d). By default -
"webgl"
torigin - the position of the access point.
world - the position of the hotspot is "global" / "world».
This means that the position will always be the same, regardless of the panorama or the
user's viewing position.
image - the position of the hotspot will be relative to the current position
of the
panoramic image.
view - the hotspot position will be relative to the current viewing
position.
By default - "world".
depthbuffer - when this option is enabled, hotspots can cross other
hotspots
(with deepbuffer = true) or depth map geometry in 3D space (true/falce).
alphachannel
- Setup the alpha-channel / transparency-channel usage and source.
For images and videos.
Usage case: there is currently no browser-support for transparent videos, so as
alternative a video with the alpha-channel as extra image on the right (Side-by-Side) or
at the bottom (Top-Bottom) can be used.
Example
chromakey -
With the chromakey setting a certain color in the hotspot image or video can be used as
alpha / transparency mask. The typical usage would be Greenscreen or Bluescreen videos.
Example.
Pressing "Backspace" button clears the digital value of the attribute on button.
More information on assignment of hotspot attributes can be obtained on website
krpano.
group - assign or change group of the
hotspot.
keep - make a hotspot local or global. When set to
"true", the hotspot will appear in the panorama where it is registered and will not
disappear when switching to other panoramas.
(HTML5)
<plugin name="soundinterface" keep="true" url="%FIRSTXML%/plugins/soundinterface.js" />
For example: play_soundSM(sound_hs_addhs, 'add_hotspot/sound/2.mp3',0.5, false);
<sound_hs sound_bar="true" volume_icon_right="true" speaker_icon="true" />
There are three ways to open a link:
To select, click on the selected option, indicator will turn green.
Choose a hotspot and enter address of site to open (or copy "Ctrl+C" and paste
into line "Ctrl+V"),
press "Enter".
You can try entering links here.
(HTML5)
This tab allows you to create and edit text hotspots. Detailed information about the
attributes of the text hot spot is
here .
All Windows with digital values allow you to enter parameters from the keyboard, insert,
copy. As you enter, press " Enter".
Clicking the button opens the color and transparency editing panel. Clicking on the hotspot displays its value in the upper right square, the color is displayed in the left square. Clicking on the right box returns to the original spot color.
This tab allows you to create and edit polygonal hotspots. Detailed information on the
assignment of polygonal hotspot attributes
here .
Create and edit - mode of creating and editing polygonal hotspots. Active
- red button.
To turn the mode on or off, press the button or the "E" key, start and finish drawing the
hotspot - press the "space bar",
to create a point - click with the left mouse button.
In the edit mode, click on the hotspot - there will be nodal points at the corners. Grabbing
the point, you can move the angle.
When you hover over a point, two buttons "+" (create point) and "x" (delete point)
appear.
There are two tabs in the panel Default settings and Hotspot.
Bookmark "Default settings"
Here you can configure the default settings (polygon hot spots style). These parameters will
be applied to newly created hotspots.
The following parameters have two States and are divided into two columns. The first
state is the default, the second state can be applied to
the hotspot when hovering, clicking etc. and therefore have the installation code
set_pol_1(); и set_pol_2();.
By default, the second parameters are set on mouse hover - onover="set_pol_2();"
and when the mouse is removed from the hot spot onout="set_pol_1();"
Settings 1 - the parameters of the hotspot 1. Installation code
set_pol_1();
When you click on the hotspot, it becomes active and the name of the selected hot spot is
displayed in the bookmark name.
Here you can configure the parameters of the created hotspot. These parameters will be
applied to the selected hotspot.
This tab has the same settings as Default settings,
with four more
buttons added on it.
This tab allows you to combine the hot spots into groups and create a code to show or hide the hotspots of this group.
- Open the panel for assigning a group to a hotspot.
If the hotspot already belongs to the group, then when you click on this hotspot, the group name is displayed in the line.
Expand the grouping tab by clicking on the triangle to the right in the tab.
The line below shows the code, which you can assign, for example, to click on a button.
The group name must not contain the name of another group!
gr_1...gr_12 - incorrect.
gr_01...gr_12 - right.
HideShowHotspot(); - toggles the visibility of all the hotspots created by the plugin. Set it to any button or other action.
FlyoutSM(); - smoothly displays the hotspot to the center of the screen without distortion. Set the action to a hotspot, for example - onclick="flyoutSM();"
Example:openFrameAdhs(html,get(data[data_html].content),400,300,true); - open HTML from data. Example.
Find out how to purchase the plugin by following the link
Plugin is provided "As Is" without warranty of any kind, either express or implied, including any warranty of quality, merchantability, or fitness for a particular purpose. In no event will author of plugin be liable for loss of data, costs of procurement of substitute goods or services or any special, consequential or incidental damages, under any cause of action and regardless of whether or not plugin author have been advised of possibility of such damage. This limitation will apply notwithstanding any failure of essential purpose of any limited remedy provided herein. In any event plugin author will have no liability arising out of this agreement.