List of Placeholders

A placeholder is like a shortcut for using data or text from other sections of the software.

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.

For each input field in Pano2VR that has a corresponding placeholder, you will see a tooltip of its placeholder when the mouse hovers over the field.

Skin Editor

The following placeholders can be used in text fields, as variable values, and as logic block triggers and values. Some fields throughout the skin will have a button to expand the text box. In the expanded text box, there will be a placeholders button, where you can choose the placeholder you need.

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

  • $(hid) = hotspot ID

  • $(hSid) = hotspot Skin ID

  • $(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

  • $(cdesc) = the description in the cloner

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

  • $(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 in Meters, can also be used in Hotspot and User Data fields, as well in Text Boxes in the skin

  • $(altf) = user data altitude in Feet, can also be used in Hotspot and User Data fields as well in Text Boxes in the skin Precision of altitude can be displayed by indicating the number of places using :x. For example, if you have an altitude of 1.2345 meters, you can express it as the following:

    • $(alt:2) → 1.23

    • $(alt:0) → 1

    • $(alt:4) → 1.2345

  • $(hdg) = user data north

Project User Data

These placeholders represent the content added to the Project User Data fields. Along with placeholders above, they are also found as triggers for (Logic Blocks)(../../create-skin/skin-logic/skin-logic-triggers/)

  • $(upt) = project user data title

  • $(upd) = project user data description

  • $(upa) = project user data author

  • $(upe) = project user data date/time

  • $(upc) = project user data copyright

  • $(ups) = project user data source

  • $(ui) = project user data information

  • $(upo) = project 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 web 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.

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. Using the Go To URL action, enter this placeholder in the URL field.

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