Jump to: navigation, search

Panotour - Style - Actions

Contents

Introduction

Panotour Pro actions are events that are triggered by user click. Actions define interaction behaviors between the main interface tools (Go to, Move, Autorotation, etc) and plugins.



Actions triggered on click

You can add multiple actions to plugins. However, it is recommended not to add to many actions once because it may be obtrusive for the user.

How to assign actions to a user click



Basic

None

No action is set to the plugin.


Go to a panorama or a group

Load a specific panorama or the first panorama of a specific group.

Menu window of «Go to a panorama or a group» action




Action Parameters

  • A Panorama: Select the target panorama you wish to link.
  • A Group: Select the target group you wish to link.


Target View

This section is available only when «A panorama» is selected.

  • Default Target view: The target view is applied when your visitor land on the target picture/panorama.
  • Custom View: You can specify a target view position on the target picture/panorama by dragging it to the position you wish in the preview window.


Note: Default View and Custom View are overridden on mobile if using the Gyroscope.


Source Transition

  • None: On click, go directly to the target.
  • Zoom Out: Add a «zoom out» effect and then go to the target.


Target Transition

When checked, target transition uses the following parameters.

  • None: Landing on the target, no action is run on the target panorama.
  • Custom View To Panorama View: Go to the target with custom view first and pan to the panorama view (defined in the target panorama).
  • Load Custom View: Go to the target custom view.
  • Load Panorama View: Go to the target panorama view (defined in the target panorama).
  • Panorama View To Custom View: Go to the target with panorama view first (defined in the target panorama) and pan to the custom view.


Note: Default View and Custom View are overridden on mobile if using the Gyroscope.


Display an image

Display a image or a Flash file (*.swf) in a modal box (lightbox type window).


Menu window of «Display an image» action




Position and offset

  • Square with dots: Sets the position where you wish the image to be displayed. Available positions are top left, top center, top right, middle right, bottom right, bottom center, bottom left, middle left and center.
  • Offset: X values adjust horizontal offset and y values adjust vertical offset based on the position you set.


File

Select the image file you wish to display by clicking on select button button. Supported files types are *.jpg, *.jpeg, *.png, *.gif and Flash files *.swf.


Size

  • Width: Set the image width in pixels or percentage. If set to 0, image width is sized to its native resolution.
  • Height: Set the image height in pixels or percentage. If set to 0, image height is sized to its native resolution.


Add a background overlay

When this checkbox is checked

  • Overlay color: You can select the overlay color and opacity with the built-in color picker or select a project color in the dropdown menu. Project background color is defined in Project Properties > Color


Advanced

  • Pause autorotation when opened: Checkbox to pause or not autorotation when action is triggered.
  • Zoom Effect when Opening the Image: Checkbox to enable or not a zoom effect when the user clicks. Works only if width and height are set.



Logo-panotour-pro-150px.png Display a video

Display Video on iPhone On iPhones only, videos will be displayed in fullscreen mode


Display a video file in a modal box (lightbox type window).

Menu window of «Display a video» action




Position and offset

  • Square with dots: Sets the position where you wish the video to be displayed. Available positions are top left, top center, top right, middle right, bottom right, bottom center, bottom left, middle left and center.
  • Offset: X values adjust horizontal offset and y values adjust vertical offset based on the position you set.


File

Select the video file you wish to display by clicking on select button button. Supported files types are *.mp4, *.m4v, *.flv, *.webm, *.ogv, *.ogg.

    • Note: .flv is a Flash-only format
    • Note: .mov format is unsupported.


Size

  • Width: Set the video width in pixels or percentage.
  • Height: Set the video height in pixels or percentage.


Loop

Checkbox to loop or not your video.


Advanced

  • Pause autorotation when opened: Checkbox to pause or not autorotation when action is triggered.
  • Paused on Start (on desktop computer): Checkbox to pause or not the video at start. This feature works only on desktop computers. On mobiles and tablets, the video is always paused on start.
  • Pause other sounds when video is playing: Checkbox to pause or not other sounds while the video is playing. It mutes background sounds and all other sounds to let only the video sound playing.



Logo-panotour-pro-150px.png Display a web video

Display a hosted web video (YouTube and Vimeo) in a modal box (lightbox type window).

Menu window of «Display a web video» action


Position and offset

  • Square with dots: Sets the position where you wish the video to be displayed. Available positions are top left, top center, top right, middle right, bottom right, bottom center, bottom left, middle left and center.
  • Offset: X values adjust horizontal offset and y values adjust vertical offset based on the position you set.


Web Video Source

Select the video hosting service you wish to use. Compatible video hosting are:

  • YouTube
  • Vimeo


Web Video ID

In this field, enter only the ID of the video. For example:

  • For a YouTube URL http://www.youtube.com/watch?v=xxHkVSGjBbM enter xxHkVSGjBbM
  • For a Vimeo URL http://vimeo.com/110690554 enter 110690554


Size

  • Width: Set the video width in pixels or percentage.
  • Height: Set the video height in pixels or percentage.

Note that YouTube video size will render


Video Overlay

An opacity adjustable colored layer between your web video player container and the tour.

  • Overlay Color: You can select the overlay color and opacity with the built-in color picker or select a project color in the drop-down menu. Project colors are defined in Project Properties > Color.


Loop when Reaching the End

Checkbox to loop or not the video when it reaches the end.


Advanced

  • Pause autorotation when opened: Checkbox to pause or not autorotation when action is triggered.
  • Paused on Start (on desktop computer): Checkbox to pause or not the video at start. This feature works only on desktop computers. On mobiles and tablets, the video is always paused on start.
  • Pause other sounds when video is playing: Checkbox to pause or not other sounds while the video is playing. It mutes background sounds and all other sounds to let only the video sound playing.



Load next panorama

Loads next panorama based on the order of the Project Properties > Order.

Menu window of «Load next panorama» action


logo YouTube Watch on YouTube



Load previous panorama

Loads previous panorama based on the order of the Project Properties > Order.

Menu window of «Load previous panorama» action





Load next group

Loads next group based on the order of the Project Properties > Order.

Menu window of «Load next group» action



Load previous group

Loads previous group based on the order of the Project Properties > Order.

Menu window of «Load previous group» action



Play a Sound

This action plays a sound on user click. Only mp3 files are supported.

Play sound action


logo YouTube Watch on YouTube


  • File: Select the mp3 sound file to play on user click.
  • Endless Sound: Checkbox to loop infinitely the mp3 sound. If not checked, you can specify the number of loops.
  • Pause other Sounds when is Playing: When played, the sound file pauses all others sounds played (like background sounds for example).



Play a Directional 3D Sound (Flash Only)

This action plays a directional sound on user click. Only mp3 files are supported. The directional sound can only be applied on spots and is available only into the Flash Player. On HTML5 player or plugin, the sound will be played as a standard sound.


Play 3D sound action




  • Directional Sound Range: Enter the sound field angle you wish in degrees. 90° by default, recommended because it matches the human vision field of view. The more you enter a low value, the more you get a directional sound. When user drags the sphere with a sound hotspot into the zone, a realistic volume and stereo effect is heard according to the user movements, as it would be in a real situation. This feature is checked by default.
  • Endless Sound: Checkbox to loop infinitely the mp3 sound. If not checked, you can specify the number of loops.
  • Pause other Sounds when is Playing: When played, the sound file pauses all others sounds played (like background sounds for example).


Logo-panotour-pro-150px.png Open a website

This actions behaves like a link you can open in your current browser window or in a new window.

Menu window of «Open a website» action


logo YouTube Watch on YouTube


Website URL

Enter the URL you wish to link.


Target Window

Dropdown menu to choose how you wish to open the link.

  • Open in a new window (_blank).
  • Open in the current window (_self).
  • Open in the parent frame (_parent).
  • Open in the top-level frame in the current window (_top).




Logo-panotour-pro-150px.png Animation

Start Autorotation

Triggers start autorotation of the current view based on settings in Project Properties > Autorotation.

Menu window of «Start Autorotation» action




Stop Autorotation

Triggers stop autorotation of the current view. Autorotation settings are set in Project Properties > Autorotation.

Menu window of «Stop Autorotation» action




Pause Autorotation

Pauses autorotation of the current view. Autorotation settings are set in Project Properties > Autorotation.

Menu window of «Pause Autorotation» action


Resume Autorotation

Resume the automatic rotation of the view after a pause. Autorotation settings are set in Project Properties > Autorotation.

Menu window of «Resume Autorotation» action


Logo-panotour-pro-150px.png Start Autotour

Start automatic tour based on settings in Project Properties > Autotour.

Menu window of «Start Autotour» action


Logo-panotour-pro-150px.png Stop Autotour

Stop automatic tour. Autotour settings are available in Project Properties > Autotour.

Menu window of «Stop Autotour» action



Logo-panotour-pro-150px.png View Control

Enter WebVR

Allows to enter the VR Mode. Works with the WebVR Button Plugin. No other properties for the moment.

Menu window of «Enter WebVR» action


Enter fullscreen mode

Triggers fullscreen mode display.

Menu window of «Enter fullscreen mode» action




Exit fullscreen mode

Exit fullscreen mode display.

Menu window of «Exit fullscreen mode» action




Switch fullscreen mode

Toggles between windowed display and fullscreen mode display.

Menu window of «Switch fullscreen mode» action




Enable gyroscope

Activate gyroscope. This function works only if a hardware gyroscope device is detected.

Menu window of «Enable gyroscope» action


Disable gyroscope

Deactivate gyroscope.

Menu window of «Disable gyroscope» action


Set «Move To» control mode

In this mode, the mouse pointer indicates the direction to move to.

Menu window of «Set Move To control mode» action


Set «Drag To» control mode

In this mode, the mouse pointer drags the tour.

Menu window of «Set Drag To control mode» action




Set normal projection

Set normal projection mode.

Menu window of «Set normal projection» action


Set fisheye projection

Set fisheye projection mode.

Menu window of «Set fisheye projection» action




Set architectural projection

Set architectural projection mode.

Menu window of «Set architectural projection» action




Set stereographic projection

Set stereographic projection mode.

Menu window of «Set stereographic projection» action




Set pannini projection

Set pannini projection mode.

Menu window of «Set pannini projection» action




Set Little Planet projection

Set Little Planet projection mode.

Menu window of «Set Little Planet projection» action




Set fisheye ball projection

Set fisheye ball projection mode.

Menu window of «Set fisheye ball projection» action





Logo-panotour-pro-150px.png Interface Control

Show Hotspots

Switch on the display of the hotspots of the tour.

Menu window of «Show Hotspots» action


logo YouTube Watch on YouTube


Hide Hotspots

Switch off the display of the hotspots of the tour.

Menu window of «Hide Hotspots» action


logo YouTube Watch on YouTube


Show Tour Controls

Switch on the display of the tour controls.

Menu window of «Show Tour Controls» action




Hide Tour Controls

Switch off the display of the tour controls.

Menu window of «Hide Tour Controls» action




Show Tour Thumbnails

Switch on the display of the tour thumbnails. Works only when a Thumbnails plugin is added to the tour.

Menu window of «Show Tour Thumbnails» action




Hide Tour Thumbnails

Switch off the display of the tour thumbnails. Works only when a Thumbnails plugin is added to the tour.

Menu window of «Hide Tour Thumbnails» action




Display tour information

Switch on the display of tour information. This action is compatible only with plugins that receive its triggering like Description plugin. For example, you can assign Project Description / Group Description or Panorama Description field display.

Menu window of «Display tour information» action




Hide tour information

Switch off the display of tour information.

Menu window of «Hide tour information» action




Show Map

Switch on the display of tour map. Works only with PanotourMaps Plugin.

Menu window of «Show Map» action


logo YouTube Watch on YouTube


Hide Map

Switch off the display of tour map. Works only with PanotourMaps Plugin.

Menu window of «Hide Map» action


logo YouTube Watch on YouTube


Show Floor Plan

Switch on the display of floor plan. Works only with the Floor Plan Plugin.

Menu window of «Show Floor Plan» action




Hide Floor Plan

Switch off the display of floor plan. Works only with the Floor Plan Plugin.

Menu window of «Hide Floor Plan» action




Share tour

Triggers opening of the sharing tool (lightbox). Works with the Social Share Plugin.

Menu window of «Share Tour» action


logo YouTube Watch on YouTube


Play tour sounds

Enable tour sounds. Tour sounds includes every sound of your tour excepting external embedded medias like YouTube or any other.

Menu window of «Play tour sounds» action




Stop tour sounds

Disable/Mute tour sounds. Tour sounds includes every sound of your tour excepting external embedded medias like YouTube or any other.

Menu window of «Stop tour sounds» action




Set volume of tour sounds

Set the master level (0-100) of all tour sounds.

Menu window of «Set volume of tour sounds» action





Logo-panotour-pro-150px.png Advanced

These are advanced actions. As well as the default actions, any custom actions added to your User Directory will be added to Advanced section.


Call a JavaScript Function

Enter the call to the JS function you wish to use on the click.

Menu window of «Call a JavaScript Function» action


Change Tour Language

This action allows to change the current tour language to the desired language.
Just enter the target language code into the input field. See how to add and edit language files.

Menu window of «Change Tour Language» action


Actions and Plugins Connection Table

Actions in Panotour Pro are events that are assigned to any function in the plugins and the basic tools of the interface (Go to, Zoom, Move, Autorotation, etc). Most of actions parameters are set from «Actions triggered on click» menu but some actions may be adjusted in their target plugin. Here is the list of actions that are directly in relation with the included plugins.


Action Type > Action Name Plugins that interact with
View Control > Enable gyroscope Gyroscope (iPhone 4 ou iPad 2)
View Control > Disable gyroscope Gyroscope (iPhone 4 ou iPad 2)
Interface Control > Show Tour Thumbnails
  • Classic Thumbnails Bar
  • Simple Thumbnails Bar
  • Thumbnails Stack
Interface Control > Hide Tour Thumbnails
  • Classic Thumbnails Bar
  • Simple Thumbnails Bar
  • Thumbnails Stack
Interface Control > Display Tour Information

Description

Interface Control > Hide Tour Information

Description

Interface Control > Show Map

PanotourMaps

Interface Control > Hide Map

PanotourMaps

Interface Control > Show Floor Plan

Floor Plan

Interface Control > Hide Floor Plan

Floor Plan

Interface Control > Share Tour

Social Share



Logo-panotour-pro-150px.png Plugin Specific Actions Sets [Plugin] «Plugin Name»

List of Plugin specific actions sets

Depending on plugins you add to your tour, you may see contextual actions sets appear in the Actions list. Here is the list of these actions directly linked to their plugin, each action type starts with «[Plugin]»


[Plugin] Gallery

«Gallery» Plugin

Action set related to the Gallery Plugin.


Open The Gallery

Triggers the opening of the Gallery Plugin.

Menu window of «Open The Gallery» action


Open The Gallery on a Specific Image

Triggers the opening of the Gallery Plugin and displays a specific image you select.

Menu window of «Open The Gallery on a Specific Image» action


[Plugin] Floor Plan

«Floor Plan» Plugin

Action set related to the Floor Plan Plugin.


Open the Floor Plan

Triggers the opening of the Floor Plan Plugin.

Menu window of «Open the Floor Plan» action


Close the Floor Plan

Triggers the closing of the Floor Plan Plugin.

Menu window of «Close the Floor Plan» action


Toggle Open and Close The Floor Plan

Toggles open and close the Floor Plan Plugin.

Menu window of «Toggle Open and Close The Floor Plan» action


[Plugin] PanotourMaps

«PanotourMaps» Plugin

Action set related to the PanotourMaps Plugin.


Open the Map

Triggers the opening of the PanotourMaps Plugin.

Menu window of «Open the Map» action


Close the Map

Triggers the closing of the PanotourMaps Plugin.

Menu window of «Close the Map» action


Toggle Open and Close The Map

Toggles open and close the PanotourMaps Plugin.

Menu window of «Toggle Open and Close The Map» action


[Plugin] Description

«Description» Plugin

Action set related to the Description Plugin.


Display a Description

Triggers the opening of the Description Plugin in which description field is displayed. A description is one of the fields of

Menu window of «Description» action


Display Current Spot Description

This action can only be assigned to an hotspot. It triggers the opening of the Description Plugin in which the description of the hotspot is displayed. Learn more about Hotspots.

Menu window of «Display Current Spot Description» action


[Plugin] PDF Box

«PDF Box» Plugin

Action set related to the PDF Box Plugin.


Display a PDF File

Triggers the opening of the PDF Box Plugin that will display a PDF file over your tour.

Menu window of «Display a PDF File» action

  • File: Select the PDF file to display. Note that the local PDF file you select will be copied in the tour resources.
  • Title: Enter a title for the PDF file document that will be displayed at the top of the of the modal lightbox window. Note that this function will be available only if «Show title» is enabled in PDF Box Plugin parameters.


[Plugin] Social Share

«Social Share» Plugin

Action set related to the Social Share Plugin.


Open the Social Share plugin

Triggers the opening of the Social Share window.

Menu window of Open the Social Share plugin action


Toggle open and close of the Social Share plugin

Triggers the two state action of opening and closing of the Social Share window.

Menu window of Toggle open and close of the Social Share plugin


Close the Social Share plugin

Triggers the closing of the Social Share window.

Menu window of Close the Social Share plugin action


[Plugin] Web Video Box

«Web Video Box» Plugin

Action set related to Web Video Box Plugin.


Display a Video

Triggers the opening of the Web Video Box Plugin that displays a video over your tour.

Menu window of «Display a Video» action

  • URL: Enter the URL of the page containing the video. Do not enter the direct URL of the video (will not work) but use the url found in the embed code or iFrame instead. Video hosting website supported:
    • YouTube
    • Vimeo
    • DailyMotion
    • Wistia
    • Viddler
    • SoundCloud
  • Title: Enter a title for the modal lightbox window that will be displayed. Note that this function will be available only if «Show title» is enabled in Web Video Box Plugin parameters.


[Plugin] Website Box

«Website Box» Plugin

Action set related to the Website Box Plugin.


Display a Website

Triggers the opening of the Website Box Plugin that displays a website or HTML page over your tour.

Menu window of «Display a Website» action

  • URL: Enter the URL of the website page or path to your HTML file*.
  • Title: Enter a title for the modal lightbox window that will be displayed. Note that this function will be available only if «Show title» is enabled in Website Box Plugin parameters.


* To link to a custom HTML file you can use a relative path such as:

  • If they are in same directory as the tour's HTML file, the url would be like this : ./myHtmlFile.html
  • If they are in a sub directory as the tour's HTML file, the url would be like this : ./mySubDir/myHtmlFile.html
  • If you want to put your HTML files elsewhere, in a upper directory, you should use double dots : ../mydirectoryOverTheDirectoryOfthetour/myHtmlFile.html


Note: You will have to add the html file to your tour's data manually, if you create a PTV it will also have to be added by hand.











BACK TO: Documentation / Panotour Documentation