Spot Range

 v1.0

Short overview of the main features can be found at the plugin page
If there's anything incorrect please let me know.

Plugin settings

Installation

Usage

Invisible hotspots ( _inv_ )

Active hotspots ( _act_ )

Advanced settings


Installation

The Spot Range plugin is made available as a zipped file. Before installation, remove any previous version of the plugin. Unzip the downloaded package to any temporary folder.

Place the alpo.spotrange-vX.X.X folder to:

  • Windows: C:\Users\MyName\Documents\Kolor\PanotourPro 2\plugins
  • Mac: /Users/MyName/Documents/Kolor/PanotourPro 2/plugins
  • Linux: /home/$USER/Documents/Kolor/PanotourPro 2/plugins
  • You will need to restart Panotour Pro to see the plugin!
  • To uninstall the plugin, delete the alpo.spotrange-vX.X.X directory and all of its contents.

    Usage

    After the installation completed, you can find the Spot Range plugin in the plugin library and double click on it. Then in the Spot Library select any of your point spot styles (only Point styles are supported) and add at the end of the style name _inv_ to apply Invisible behavior or _act_ to apply Active behavior. In the Spot Range plugin settings enable the appropriate behavior Use Invisible hotspots (_inv_), Use Active hotspots (_act_), this will also open the settings sections.

    See also this video overview

    Invisible hotspots ( _inv_ )

    Hides hotspots by default and use custom images to indicate when the view gets in/out of the spot range. Custom image gets onclick action from the current hotspot.

    Use Invisible hotspots ( _inv_ )
    • Enables Invisible behavior and opens the appropriate settings section.
    Image position for _inv_
    • Sets position of indication image (Inactive and Active states).
    Image (inactive state)
    • Settings for inactive image. This image is visible when the view is not in the range of the _inv_ hotspot.
    • Image
    • Choose an image file for inactive state.
    • Opacity
    • Opacity for inactive image.
    Image (active state)
    • Settings for active image. This image is visible when the view is in the range of the _inv_ hotspot.
    • Image
    • Choose an image file for active state.
    • Opacity
    • Opacity for active image.
    Change images (states)
    • Sets how to change images when the view gets in/out from the range of the _inv_ hotspot.
    • Effect
    • Sets effect to change image. Available values: Switch, Fade
    • Switch
    • Change image immediately.
    • Fade
    • Fadeout the current state and fade-in the next state in the same time. Displays additional setting Fade time.
    • Fade time
    • Sets the time in milliseconds to fade images.
    • Move effect for active state
    • Activates move effect to appear active state. Displays additional setting section Move settings.
    • Move Settings
    • From
    • Sets from which side to move active image.
    • Time
    • Sets the time in milliseconds to move image.
    • Tween type
    • Sets tween type of the move action. Visualization of tween types
    Additional settings
    • Additional settings for _inv_
    • Display hotspots
    • Enable to keep hotspots visible.
    • Show hotspots onover the image
    • The activated invisible hotspot will be displayed when mouse over the active image.
    • Display tooltip onhover the image
    • Enable to display tooltip on hovering the active image. Applies if the current hotspot (view in the range) has a tooltip text.
    • Autoload scene
    • Sets to automatically load the target scene when the view gets in the spot range, without clicking the active image. Use carefully, because if a pano default view has an invisible spot it may gets in the range after loading the pano, which results to load next pano immediately. And this can be repeated if the next pano also has the same setup, and so on.
      However, this makes possible to create some special tour behavior with a combination of autorotation.
    • Display VR settings
    • Opens VR settings section for _inv_ spots.
    VR settings
    • Due to the particular qualities of the VR mode, it's not possible to keep the same behavior. In VR mode, there are no active and inactive states and positioning. There is a custom image (hotspot). When the view gets in the hotspot range, the image will be displayed on the horizontal position of the invisible spot and will follow the view until the view gets out from the range. The image (hotspot) gets onclick action from the current invisible hotspot.
    • Image settings
    • Image
    • Choose image file.
    • Opacity
    • Sets image opacity.
    • Display image effect
    • Sets effect to display image. Available values: Switch, Fade.
    • Switch
    • Displays/Hides image immediately.
    • Fade
    • Fade-in/fade-out the image. Displays additional setting Fade time.
    • Fade time
    • Set the time in milliseconds to fade in / fade out the image.
    • VR timeout
    • Set the time in milliseconds to wait for click action when vrcursor over the image.
    • Depth
    • Sets the stereoscopic 3d depth for hotspots.

    Active hotspots ( _act_ )

    Enables a hotspot to perform some action when the view gets in/out the range of the hotspot.

    Use Active hotspots ( _act_ )
    • Enables Active behavior and opens the appropriate settings section.
    Start opacity
    • Sets default opacity for all _act_ hotspots which will be applied at the start.
    Change hotspot
    • Settings to change hotspots when the view gets-in the range. Available changes: Width, Height, Opacity, Image, Rotate.
    • Every changes section (except Change image) has an Effect setting, to switch or tween the changes. Tween setting displays additional section to set Tween time and Tween type, here is the Visualization of tween types for more info.
    • Every changes section has a Delay setting to set time in milliseconds to wait before making the change, to display it enable Display delay settings. It has two settings to delay the changes. The first used when the view gets in the spot range and the second used when the view gets out from the spot range.
    Additional settings
    • Additional settings for _act_.
    Keep active state
    • If enabled changed hotspot won't get back to its original state when the view get out from the hotspot range.
    • Only after click
    • If enabled changed hotspot won't get back to its original state only if it was clicked.
    • Keep
    • Sets how to keep the changed state. Available values: Always, Until the next pano
    • Always
    • Keep hotspot changed always e.g. when you load another pano and get back to the first one the changed hotspot will be changed.
    • Until the next pano
    • Keep hotspot changed only in the currently loaded pano. Once the hotspot is changed it will keep the state, but if leave and then return to the pano the hotspot will have the original state.
    • Display tooltip when active
    • Enable to display tooltip when the view gets in the range. The tooltip will be displayed in the same style as a Panotour permanent tooltip option, but visible only in the active state.
    • Tooltip offset
    • Sets offset for tooltip text from the hotspot, in pixels.
    • Tooltip position
    • Positioning of the tooltip text, on top or bottom the hotspot.
    Show image
    • Settings to display different images when hotspot activated or clicked. To display an image, in Panotour on the TOUR tab select _act_ spot and expand the Description section for this spot and enter the filename of the image to display. (for example: info1.png). Do not add extra whitespace or words, and do not use any styling. Open exported tour data directory, navigate the spotrange plugin directory (your_tourdata\graphics\alpo.spotrangeXXX) and create a new folder "images" and put your images there.
    • Show image when hotspot is:
    • Select to display image when hotspot is Clicked or Activated by range. This will show up some additional settings.
    • Image area
    • The area that will be filled with the image, dependently on the aspect ratio of the image.
    • Alignment
    • Alignment of an image according to the Screen or Hotspot if option Keep images position enabled.
    • Max size / Min size
    • Limit the image resizing. Set 0 to disable.
    • Offset
    • Sets offset for image from the original position, in pixels. Bottom, Right offset - positive values. Top, Left offset - negative values.
    • Keep images position
    • Disable to show images the usual way, when the image appears over the panorama and stays on the screen until we close it. If enabled - images appears as hotspots, they stay on its position and move with panorama rotation. This opens additional settings Keep image if new appear and Distort images
    • Keep image if a new appear
    • Only for enabled option: Keep images position. Sets to keep or hide opened image when a new image appears.
    • Distort images
    • Only for enabled option: Keep images position. Enable to distort image in the 3D space.
    • Close image when spot deactivated
    • Only for option: Show image when hotspot is ACTIVATED. Enable to close image everytime when the appropriate spot is deactivated (out from range). This option has priority over the Keep image if new appear and will close image anyway.
    • Click on image to execute hotspot actions
    • Only for option: Show image when hotspot is ACTIVATED. Enable to execute all the actions assigned to the appropriate hotspot by clicking on the image.
    • Close image on click
    • A click on the image will close it.
    • Use target pano thumbnail as image
    • Only for unchecked option: Disable load pano action. Enable to display thumbnail of the target panorama instead of your custom image.
    • Delay actions after show image
    • Only for option: Show image when hotspot is CLICKED. If you want to open an image on click a hotspot, that has additional actions, then all actions of the hotspot will be executed. The go to panorama action will start loading the next pano immediately, which do not allow your custom image to be displayed. Delay setting fixes this and display image first and then execute hotspot actions after certain delay.
    • Disable load pano action
    • Removes go to panorama action, but keeps other actions. This option may be useful if you want to display images in standard mode, but keep hotspots in VR mode, where you can also display images or load panoramas.
    Display VR settings
    • Enable to display additional VR settings of Active behavior.
    Display tooltip in VR mode.
    • Currently it's not possible to display text in VR mode, but it's possible to use images with text as a workaround. For this you need to prepare images with text for tooltips , this should be .png files and have its filename exactly as tooltip text. Be sure that there are no unsupported characters in the filename: < (less than), > (greater than), : (colon), " (double quote), / (forward slash), \ (backslash), | (vertical bar or pipe), ? (question mark), * (asterisk). Open exported tour data directory, navigate the spotrange plugin directory (your_tourdata\graphics\alpo.spotrangeXXX) and create a new folder "vrtooltips" and put your tooltips images there.
    • Tooltip offset
    • Sets offset for tooltip text from the hotspot, in pixels. Bottom, Right offset - positive values. Top, Left offset - negative values.
    • Tween time to show/hide tooltip
    • Tween time to show or hide the tooltip image in milliseconds.
    Show image in VR mode
    • To display an image in VR mode, in Panotour on the TOUR tab select _act_ spot and expand the Description section for this spot and enter the filename of the image to display. (for example: info1.png). Do not add extra whitespace or words, and do not use any styling. Open exported tour data directory, navigate the spotrange plugin directory (your_tourdata\graphics\alpo.spotrangeXXX) and create a new folder "vrimages" and put your images there.
    • Show image in VR mode when hotspot is:
    • Select to display image when hotspot is Clicked or Activated by range. This will show up some additional settings.
    • Image area
    • The area that will be filled with the image, dependently on the aspect ratio of the image.
    • Max size / Min size
    • Limit the image resizing. Set 0 to disable.
    • Offset
    • Sets offset for image from the hotspot, in pixels. Bottom, Right offset - positive values. Top, Left offset - negative values.
    • Close image when:
    • Select how to close image in VR mode. When hotspot is deactivated (out of range) or when vr cursor moves out of the image.
    • Add clickable icon over the image
    • Only for option: Show image in VR mode when hotspot is ACTIVATED. This option adds an ability to display clickable icon over the image and load panorama (of the appropriate hotspot) onclick. Enable to select an icon file.
    • Use target pano thumbnail as image
    • Only for unchecked option: Disable load pano action in VR mode. Enable to display thumbnail of the target panorama instead of your custom image.
    • Delay load pano action after show image
    • Only for option: Show image in VR mode when hotspot is CLICKED. If you want to open an image on click a hotspot, that has additional actions, then all actions of the hotspot will be executed. The go to panorama action will start loading the next pano immediately, which do not allow your custom image to be displayed. Delay setting fixes this and display image first and then execute hotspot actions after certain delay.
    Disable load pano action
    • If _act_ hotspots have no "go to panorama or group" action, Panotour hides them in VR mode. If you would like to display hotspots with images as tooltips in VR mode without any click action or to use option Show image onclick in VR mode, enable this setting and add "go to panorama or group" action to the _act_ style . This action won't be executed, but this helps to keep hotspots in VR mode.

    Advanced settings

    Additional settings that are applied to the plugin.

    Ranges
    • Sets ranges of hotspots. When the view gets in/out from this range some actions will be called.
    • Horizontal and Vertical ranges
    • Sets degrees of the pano view before and after hotspot. For instance, for horizontal range, if set 10°, the range starts at 10° before the hotspot and ends 10° after the hotspot. If the hotspot horizontal position is 50° its range is from 40° to 60° and equals to 20°. The same for vertical range, but in a different direction. If horizontal ranges of two hotspots of the same behavior overlap, then the space between hotspots will be halved for ranges. Ranges of Invisible and Active hotspots are disjoint and works separately.
    • Use different ranges for VR
    • Activates different range settings in VR mode.
    Devices
    • Select devices that use the plugin.
    Activate plugin in VR mode
    • Enable to use the plugin in VR mode.
    Mouse over behavior when active
    • Enable to use mouseover behavior (i.e. stop/start autorotation, other if exist) when the view is in the spot range.

    Display Spot Range info in the context menu

    If enabled, displays a tiny note "Spot Range plugin" in the context menu, and links to the Spot Range web page. It is enabled by default.
    I'd be very thankful if you'd leave this option enabled!



    Thank you so much for purchasing the plugin for Panotour Pro.
    If you have any questions relating to this plugin, I'll try my hardest to assist you.

    Alexander Popov


    Top