Jump to: navigation, search

Difference between revisions of "Panotour - Notions - Deep Linking"

m
m
Line 1: Line 1:
 
<div class="alert btn-default disabled">
 
<div class="alert btn-default disabled">
 
[[File:Logo-Panotour-Pro-2010.png|30px]] '''Panotour Pro only''' &nbsp;&nbsp;  This feature is available only in the pro version of Panotour.</div>
 
[[File:Logo-Panotour-Pro-2010.png|30px]] '''Panotour Pro only''' &nbsp;&nbsp;  This feature is available only in the pro version of Panotour.</div>
 +
 +
<br>
 
===Intro===
 
===Intro===
 
Deep linking allows you to go directly to the panorama view and zoom of your choice, among other things. You can achieve this by adding some variables to the URL.  This page will explain those different variables.
 
Deep linking allows you to go directly to the panorama view and zoom of your choice, among other things. You can achieve this by adding some variables to the URL.  This page will explain those different variables.
Line 9: Line 11:
 
* Deep-linking starts with '''<span style="color:#ff0000">?</span>''' at the end of your URL, then your variable (see example below).
 
* Deep-linking starts with '''<span style="color:#ff0000">?</span>''' at the end of your URL, then your variable (see example below).
 
* To use several variables in the same link, use the '''<span style="color:#ff0000">&</span>''' between variables (see example below).
 
* To use several variables in the same link, use the '''<span style="color:#ff0000">&</span>''' between variables (see example below).
* '''startscene''' or '''s''' is the panorama identifier name.[[Image:Ptp2 Tour Main Workspace Panorama Properties Informations.jpg|thumb|Panorama Information - PanoID]]
 
**The variable «s» can be retrieved in [[Panotour_-_Tour_-_Picture/panorama_properties#Name|'''Picture/Panorama Properties > Name''']], click on  [[Image:Info.png|info]] icon and get the panorama ID. In this example, panorama ID is «pano425».<br>
 
  
  
 
<br>
 
<br>
===What other variables can I use===
+
===What variables can I use===
Additional parameters you can use:
+
* '''startscene''' or '''s''' with the panorama id.[[Image:Ptp2 Tour Main Workspace Panorama Properties Informations.jpg|thumb|Panorama Information - PanoID]]
 +
**The variable «s» can be retrieved in [[Panotour_-_Tour_-_Picture/panorama_properties#Name|'''Picture/Panorama Properties > Name''']], click on  [[Image:Info.png|info]] icon and get the panorama ID. In this example, panorama ID is «pano425».<br>
 
* '''h''' is the horizontal looking direction (-180 to +180).
 
* '''h''' is the horizontal looking direction (-180 to +180).
 
* '''v''' is the vertical looking direction (-90 to +90).
 
* '''v''' is the vertical looking direction (-90 to +90).
Line 36: Line 37:
 
Add '''?html5=VALUE''' at the end of URL where VALUE is:
 
Add '''?html5=VALUE''' at the end of URL where VALUE is:
 
* '''auto''' for automatic selection of the viewer  
 
* '''auto''' for automatic selection of the viewer  
** For example <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''?html5=auto''' or <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''?html5=auto'''
+
** For example <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''<span style="color:#ff0000">?</span>html5=auto''' or <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''<span style="color:#ff0000">?</span>html5=auto'''
 
* '''never''' for the Flash viewer to be used.
 
* '''never''' for the Flash viewer to be used.
** For example <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''?html5=never''' or <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''?html5=never'''
+
** For example <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''<span style="color:#ff0000">?</span>html5=never''' or <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''<span style="color:#ff0000">?</span>html5=never'''
 
* '''prefer''' for the HTML5 viewer when possible.
 
* '''prefer''' for the HTML5 viewer when possible.
** For example <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''?html5=prefer''' or <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''?html5=prefer'''
+
** For example <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''<span style="color:#ff0000">?</span>html5=prefer''' or <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''<span style="color:#ff0000">?</span>html5=prefer'''
 
** This is the default mode of all tours using Panotour 2.5+
 
** This is the default mode of all tours using Panotour 2.5+
 
* '''only''' to enforce the HTML5 viewer.
 
* '''only''' to enforce the HTML5 viewer.
** For example <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''?html5=only''' or <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''?html5=only'''
+
** For example <span style="color:#999999"><nowiki>http://www.yoururl.com/</nowiki></span>'''<span style="color:#ff0000">?</span>html5=only''' or <span style="color:#999999"><nowiki>http://www.yoururl.com/mytour.html</nowiki></span>'''<span style="color:#ff0000">?</span>html5=only'''
* The same values can be used with '''?flash=VALUE''' at the end of your URL instead.
+
* The same values can be used with '''<span style="color:#ff0000">?</span>flash=VALUE''' at the end of your URL instead.
  
  
 
VALUE prefer and only also support the add of +css3d for the CSS3D player or +webgl for the WebGL player.<br>
 
VALUE prefer and only also support the add of +css3d for the CSS3D player or +webgl for the WebGL player.<br>
 
See [http://krpano.com/docu/html/#html5 KrPano's documentation]
 
See [http://krpano.com/docu/html/#html5 KrPano's documentation]
 +
  
 
<br>
 
<br>
 +
=== Is it possible to add my own variables?===
 +
Of course, but this requires that you edit the xml or add a piece of code.<br>
  
 +
Here are some custom variables have been posted by users on the [http://www.kolor.com/forum/ '''forum''']:
 +
* Hide controls on start: http://www.kolor.com/forum/viewtopic.php?f=91&t=34108#p191307
 +
* Show Floorplan on start : http://www.kolor.com/forum/viewtopic.php?f=116&t=32987#p187234
 +
* Hide Panorama Menu on start: http://www.kolor.com/forum/viewtopic.php?f=91&t=34746#p193528
 +
 +
 +
<br>
 
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
 
<br/><br/><br/><br/><br/><br/><br/><br/><br/><br/>
 
'''BACK TO:'''  [[Documentation]] / [[Panotour Documentation]]
 
'''BACK TO:'''  [[Documentation]] / [[Panotour Documentation]]

Revision as of 10:51, 15 June 2017

Logo-Panotour-Pro-2010.png Panotour Pro only    This feature is available only in the pro version of Panotour.


Intro

Deep linking allows you to go directly to the panorama view and zoom of your choice, among other things. You can achieve this by adding some variables to the URL. This page will explain those different variables.



How does Deep Linking Work

  • Deep-linking starts with ? at the end of your URL, then your variable (see example below).
  • To use several variables in the same link, use the & between variables (see example below).



What variables can I use

  • startscene or s with the panorama id.
    Panorama Information - PanoID
  • h is the horizontal looking direction (-180 to +180).
  • v is the vertical looking direction (-90 to +90).
  • f is the current field of view in degrees (0.0 to 179.0). Depending on its value, this variable may have no effect if Limit to image resolution checkbox is checked.
  • skipintro is an option to skip the little planet effect and/or the splash screen introduction.
  • norotation is an option to stop autorotation. Useful if your tour is build with autorotation on startup.
  • tour_soundson=false is an option to start out the tour with the sounds turned off.
  • tour_displaythumbnails=false is an option to start out the tour with the tour thumbnails hidden.
  • vr to start the tour directly on the VR Mode start screen (can be combined with startscene variable).


For example your final deep linked URL could look like:

- http://www.yoururl.com/?html5=only&s=pano425&h=-104&v=-9&f=67
- http://www.yoururl.com/mytour.html?s=pano425&h=-104&v=-9&f=67&skipintro=true&norotation=true
- http://www.yoururl.com/mytour.html?vr&s=pano425



How to force the display of the tour using the Flash or HTML5 player ?

Add ?html5=VALUE at the end of URL where VALUE is:

  • auto for automatic selection of the viewer
    • For example http://www.yoururl.com/?html5=auto or http://www.yoururl.com/mytour.html?html5=auto
  • never for the Flash viewer to be used.
    • For example http://www.yoururl.com/?html5=never or http://www.yoururl.com/mytour.html?html5=never
  • prefer for the HTML5 viewer when possible.
    • For example http://www.yoururl.com/?html5=prefer or http://www.yoururl.com/mytour.html?html5=prefer
    • This is the default mode of all tours using Panotour 2.5+
  • only to enforce the HTML5 viewer.
    • For example http://www.yoururl.com/?html5=only or http://www.yoururl.com/mytour.html?html5=only
  • The same values can be used with ?flash=VALUE at the end of your URL instead.


VALUE prefer and only also support the add of +css3d for the CSS3D player or +webgl for the WebGL player.
See KrPano's documentation



Is it possible to add my own variables?

Of course, but this requires that you edit the xml or add a piece of code.

Here are some custom variables have been posted by users on the forum:













BACK TO: Documentation / Panotour Documentation