List of Placeholders

A placeholder is like a shortcut for using data or text from other sections of the software. For example, a text box in the skin may contain $(p) which will display the percentage of how much the image has loaded, while $(ut) will display the Title in the User Data.

Skin Editor

The following placeholders can be used in text fields, as variable values, and as logic block triggers and values.

Loading

  • $(b) = bytes loaded – (use in a text box)

  • $(t) = bytes total – (use in a text box)

  • $(B) = kilo bytes loaded – (use in a text box)

  • $(T) = kilo bytes total – (use in a text box)

  • $(p) = percentage loaded – (use in a text box)

  • $(n) = loading status 0.000 .. 1.000 – (use in a text box)

Position

  • $(ap) = current pan angle – (use in Open Next Panorama’s Expert Mode Pan/Tilt/FoV field and a text box)

  • $(an) = current pan angle with north setting applied – (use in Open Next Panorama’s Expert Mode Pan/Tilt/FoV field and a text box)

  • $(at) = current tilt angle – (use in Open Next Panorama’s Expert Mode Pan/Tilt/FoV field and a text box)

  • $(af) = current field of view – (use in Open Next Panorama’s Expert Mode Pan/Tilt/FoV field and a text box)

  • $(ao) = current projection

  • $(cur) = current pan/tilt/fov – (use in Open Next Panorama’s Expert Mode Pan/Tilt/FoV field)

  • $(fwd) = movement from current node to next will keep the same pan/tilt/fov values while correcting for North, so the direction is always looking forwards – (use in Open Next Panorama’s Expert Mode Pan/Tilt/FoV field)

  • $(bwd) = similar to $fwd but the direction looks backwards when moving from one node to another. – (use in Open Next Panorama’s Expert Mode Pan/Tilt/FoV field)

Hotspots

  • $(hs) = hotspot title – (use in a text box)

  • $(hu) = hotspot URL – (use in Open Next Panorama’s Expert Mode URL field)

  • $(r) = hotspot URL – (use in conjunction with $(hu): $(r)$(hu)) This placeholder was added to be used with $(hu) to fix an issue that was affecting images in WordPress.

  • $(ht) = hotspot target – (use in Open Next Panorama’s Expert Mode Pan/Tilt/FoV field)

  • $(hd) = hotspot description – (use in a text box)

  • $(hap) = hotspot pan value – use on a hotspot template along with $(hat) to move the view to the hotspot’s location. Add the value to a Move to View action in Expert mode. $(hap)/$(hat)/70

  • $(hat) = hotspot tilt value – use on a hotspot template along with $(hap) to move the view to the hotspot’s location. Add the value to a Move to View action in Expert mode. $(hap)/$(hat)/70

Distance

The following placeholders can be used in text fields to show distance:

  • $(hDm) distance in meters

  • $(hDk) distance in kilometers

  • $(hDf) distance in feet

  • $(hDmi) distance in miles

  • $(hDy) distance in yards

Precision of distances can be displayed by indicating the number of places using :x. For example, if you have a distance of 1.2345 meters, you can express it as the following:

  • $(hDm:2) → 1.23

  • $(hDm:0) → 1

  • $(hDm:4) → 1.2345

These placeholders can also be used as triggers in logic blocks.

Cloner (table-based)

These placeholders can be used to call tags and titles in a cloner that is using a table.

  • $(ctag) = the current tag in the cloner

  • $(ctitle) = the current node title in the cloner

  • $(cnodecount) = the number of nodes with the same tag

  • $(back) = node ID of the previously visited node – (use in Open Next Panorama’s Expert Mode with {})

  • $(prev) = node ID of the previous node based on the order of the tour browser – (use in Open Next Panorama’s Expert Mode with {})

  • $(next) = node ID of the next node based on the order of the tour browser – (use in Open Next Panorama’s Expert Mode with {})

User Data

All of the following can be used in a text box or as variable data in the Skin Editor.

  • $(ut) = user data title

  • $(ud) = user data description

  • $(ua) = user data author

  • $(ue) = user data date/time

  • $(uc) = user data copyright

  • $(us) = user data source

  • $(ui) = user data information

  • $(uo) = user data comment

  • $(lat) = user data latitude

  • $(lng) = user data longitude

  • $(unode) = user data node ID – when used in a cloner, this placeholder will hold the node ID of the cloned instance

  • $(ucnode) = user data custom node ID

  • $(t) = date/time of the input file

  • $(alt) = user data altitude, can also be used in Hotspot and User Data fields

  • $(hdg) = user data north

User Data Project

These are placeholders for the fields in the Master Node.

  • $(upt) = user data title

  • $(upd) = user data description

  • $(upa) = user data author

  • $(upe) = user data date/time

  • $(upc) = user data copyright

  • $(ups) = user data source

  • $(ui) = user data information

  • $(upo) = user data comment

File Names

The following placeholders can be used in the User Data and will extract data from the input file name.

Consider that the input file name is /User/Thomas/Photos/pano.jpg

  • $(ib) = image base name, pano

  • $(in) = image filename, pano.jpg

  • $(id) = image directory, Photos

  • $(if) = image absolute file name, /User/Thomas/Photos/pano.jpg

File Paths

All of the following can be used in the output file path. All file names are written without their extensions.

  • $(n) = input image name – (use in the file path when saving projects)

  • $(p) = project name – (use in the file path when saving projects)

  • $(d) = project directory – (use in the file path when saving projects)

  • $(i) = image directory – (use in the file path when saving projects)

  • $(f) = project directory & project name (legacy)

  • $(y) = node ID – (used in the tiles file path of multi-resolution, which will use the node’s ID rather than its filename)

Multi-resolution

All multi-resolution placeholders found in the Image panel in HTML5 output are used within the Filename field for naming conventions.

All lowercase letters will begin their number sequences with zero (0). All uppercase letters will begin their sequences with one (1).

The default naming convention is tiles/$n/cf_%C/l%L/%00Y_%00X.jpg.

Cube Faces

  • %c = 0, 1, 2, 3, 4, 5; cf_0, cf_1, etc.

  • %C = 1, 2, 3, 4, 5, 6; cf_1, cf_2, etc.

The 7th cube face (cf_7) in the multi-resolution output is the preview track and is a strip projection.

Multi-resolution Levels

  • %l = the lowest resolution level will begin with zero (0): l_0, l_1, l_2, etc.

  • %L = the lowest resolution level will begin with one (1): l_1, l_2, l_3, etc.

  • %r = the highest resolution level will begin with zero, thus reversing the order of the levels.

Tile Positions

  • %y = tile location on the y-axis

  • %x = tile location on the x-axis

  • %00Y = tile location on the y-axis beginning with one (1) and 2 places: 001-999.

  • %00X = tile location on the x-axis beginning with one (1) and 2 places: 001-999.

Patches

Legacy Placeholder
Pano2VR now stores the patch’s location in the XML.

The following placeholder is seen when you choose to include the patch’s location in the file name in the Preferences/Settings.

$c = the patch’s location (pan/tilt/fov values)

Google Street View

  • $(svl) = this is the URL Pano2VR receives once a panorama/tour is uploaded to Street View and accepted. The URL can be used, for example, in a skin element to open the panorama in Street View.

Master Node

  • $(yi)/$(yI) = node index. Add this placeholder to Custom Node ID in the Master Node to keep node IDs consistent. When nodes are added to the Tour Browser, they are assigned an internal node ID. The first one is always node1, the second one added is node2, etc. If node2 is removed from the Tour Browser, that ID is also removed. Use these placeholders to assign node IDs based on their arrangement in the Tour Browser. For example:
  • mynode$(yi) will count up starting from 0: mynode0, mynode1, mynode2, …
  • mynode$(yI) will count up starting from 1: mynode1, mynode2, mynode3, …

See also