Ask a Question
GoPro Support Hub Ask a question. Share an answer. Find a solution. Stay stoked.
Announcements
Is your GoPro gear up to date? Check to see If it is on our Update page.

Panotour Actions

by GoPro GoPro on ‎12-20-2019 01:00 AM

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:

 

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

 

 

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

 

  • 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

 

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

 

Zoom in

Apply a zoom to the scene. It can be a zoom step or a defined zoom value in degrees to reach.

 

Zoom out

Apply a zoom out to the scene. It can be a zoom out step or a defined zoom out value in degrees to reach.

 

Move up/down

Apply a pitch change to the scene. It can be a pitch step or a defined pitch value in degrees to reach.

 

Move left/right

Apply a yaw change to the scene. It can be a yaw step or a defined yaw value in degrees to reach.

 

Look to

Apply a camera change to the scene. You can define the Yaw and Pitch directions an the update degrees value. The Fov can be change also (value in degrees) and a motion type (Smooth, Linear, Tween) can be applied to change the animation.

 

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

 

Hide Hotspots

Switch off the display of the hotspots of the tour.

Menu window of «Hide Hotspots» action

 

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

 

Hide Map

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

Menu window of «Hide Map» action

 

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

 

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 NamePlugins that interact with
View Control > Enable gyroscopeGyroscope (iPhone 4 ou iPad 2)
View Control > Disable gyroscopeGyroscope (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

  • Picture/Panorama Properties.
  • Group Properties.
  • Project Properties.

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.

HELP ARTICLES
JOIN A GROUP