Pano2VR 7.1 beta Docs / Placeholders

List of Placeholders

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

Placeholders get replaced by the content they represent. 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 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

Use the following placeholders in a text box to display the placeholder’s value.

Placeholder Description
$(b) bytes loaded
$(t) bytes total
$(B) kilobytes loaded
$(T) kilobytes total
$(p) percentage loaded

Position

You can either display the placeholders’s value in a text box or use the placeholder in an actionlike in Open Next Panorama’s Expert Mode.

Placeholder Description Text Box Action
$(ap) current pan angle
$(an) current pan angle with north setting applied
$(at) current tilt angle
$(af) current field of view
$(ao) current projection
$(cur) current pan/tilt/fov/projection
$(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
$(bwd) similar to $fwd but the direction looks backwards when moving from one node to another.

Hotspots

Placeholder Description Text Box Action
$(hs) hotspot title
$(hd) hotspot description
$(hu) hotspot URL
$(ht) hotspot target
$(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
$(hc) custom image url
$(hid) hotspot ID
$(hSid) hotspot skin ID
$(r) hotspot URL – (use in conjunction with $(hu): $(r)$(hu)) Add $(r) to files, images, and PDF hotspot templates when the output will be embedded in a WordPress page as a Garden Gnome Package format. This placeholder is not needed for YouTube and Vimeo hotspot types. $(r) will be replaced by the player’s base path.

Distance

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

Placeholder Description
$(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

These placeholders can be used to call tags/IDs and titles in child elements of cloner types table, hotspots, floor plans, and translations.

Placeholder Description
$(ctag) The current tag/ID in the cloner. For a table cloner, this is the tag from the table.
$(ctitle) The current title in the cloner. For a table cloner, this is the title from the table. For a hotspots cloner, this is the hotspot title. For a translations cloner, this is the language name. For a floor plans cloner, this is the floor plan title.
$(cnodecount) The number of nodes with the same tag.
$(cdesc) The description in the Table cloner.

Node

Use these placeholders in the Open Next Panorama action. They will be listed as an option for URL. When adding to the expert field, surround the placeholder with {}: {$(start)}.

Placeholder Description
$(start) node ID of the start node of the tour
$(back) node ID of the previously visited node
$(prev) node ID of the previous node based on the order of the tour browser
$(next) node ID of the next node based on the order of the tour browser

User Data

Use the following in a text box or as variable in the Skin Editor.

Placeholder Description
$(ut) user data title
$(ud) user data description
$(ua) user data author
$(ue) user data date/time
$(us) user data source
$(ui) user data information
$(u0) user data comment
$(lat) user data latitude
$(lng) user data longitude
$(unode) user data node ID – Use in a text box in a cloner to show the node ID of the cloned instance
$(ucnode) user data custom node ID
$(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

Use the following placeholders in the User Data fields:

  • $(t) = Use in User Data fields to display the date and time of the input file
  • $(n) = Use in User Data fields (i.e. Title field) to display the input image file name

Project User Data

These placeholders represent the content added to the Project User Data fields. Along with the placeholders above, they are also found as Triggers for Logic Blocks.

Placeholder Description
$(upt) project user data title
$(upd) project user data description
$(upa) project user data author
$(upc) project user data copyright
$(upo) project user data comment

File Names

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

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

Placeholder Description
$(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.

Placeholder Description
$(n) input image name
$(p) project name
$(d) project directory
$(i) image directory
$(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 and organization is tiles/$n/cf_%C/l%L/%00Y_%00X.jpg.

Cube Faces

Placeholder Description
%c 0, 1, 2, 3, 4, 5; cf_0, cf_1, etc.
%C 1, 2, 3, 4, 5, 6; cf_1, cf_2, etc.

Multi-resolution Levels

Placeholder Description
%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

Placeholder Description
%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…

Last modified: Feb 12, 2024