Exporting for VR

Pano2VR projects can be viewed in a head mounted display or VR headset either with through WebXR, Cardboard, or VRTourviewer.

In Pano2VR version 7, all Point Hotspots are supported except for PDF, URL, and YouTube/Vimeo hotspots. If a skin isn’t used, tour node hotspots will be visible as spinning 3D globes but can be changed using custom hotspot images.

For white label and offline app creation, we recommend using VR Tourviewer. Alternatively, you can use the Package Viewer app for offline WebXR viewing.

To enter VR, you will need a button. All built-in skins have an Enter VR button. New in version 7 is the use of a separate skin for VR.

★ The project must be hosted on a secure server (HTTPS) in order to use the phone’s gyroscope which is needed for viewing.

Use the Built-in Skins

  1. Create a project.

  2. Add a Web Output.

  3. Add a built-in skin. For example, feather_orb.ggsk.

  4. In the Output Settings, find the VR pane. Select Enabled.

  5. Choose one of the built-in skins (feather_vr.ggsk or venis_vr.ggsk).

  6. Generate the Output. (You may have to save the project first.)

The output will work for Cardboard, Oculus, and other headsets with browsers that support WebXR.

Update a Skin with Enter VR

  1. Open the skin.

  2. Add the Enter VR component from the Components Toolbox. These buttons will be from version 6 skins silhouette and simplex. If you’d like to use the buttons from the version 7 skins, you can create a component from their EnterVR buttons. Or make your own by adding the Enter VR action to your button (Mouse Click > Fullscreen/VR > Enter VR).

  3. Save the skin.

  4. In the Web output settings, check that Enabled is selected in the VR pane.

  5. Add a VR skin while you’re at it.

  6. Save and output the project. The VR button you’ve added to the skin will only be visible on WebXR supported browsers.

Working with Stereo Panoramas

Pano2VR natively supports stereo images and videos.

Importing

  1. Drag a stereo pair as a top/bottom or strip format into the Viewer or the Tour Browser. ★ If the image is a strip, change the Type to Strip VR.
  2. In the Properties, define the pair as Left/Right or Right/Left for Stereo Pair.

Tour Building

The tour building workflow is the same as with monoscopic images. Link the panoramas in any way. You can also mix stereo and mono images in the same tour.

Output as Web and add a skin that has an Enter VR button.

Custom Hotspot Images

Version 7 supports VR specific skins, so any image can be used for point hotspots (all point hotspots are )

Add a custom hotspot image for hotpots in VR. The default node hotspot image is a spinning 3D globe. If you’d like to use your own image, instead of the globes, then you can add one in the point hotspot properties:

  1. Select a tour node point hotspot in the Viewer (or in List View).

  2. For Custom Image, click the folder to open an image for the hotspot.

  3. Choose to resize the image or to have it 3D Distorted which will pin the image to the panorama. You can then set the field of view to make the image appear smaller or larger.

  4. Set the image’s distance from the center using the Distance setting. Leave at Auto which is based on location data or deselect auto and set the distance manually. This option is only available if the hotspot type is Tour Node.

★ The custom image, like the spinning globes, will expand when the pointer is over it and contract when it leaves. However, using 3D distortion will image will make the hotspot static, staying at the size (file) that’s been chosen in step 4 above.

Patching

You can use the patch tool to quickly fix movements between the images, nadir, zenith, etc.

  1. Add a patch over the area to fix.

  2. Extract. This will open an extracted version of both sides in your default image editor. The left side will be the extracted patch.

  3. In the photo editor, if using the Clone tool, clone the right side and stamp on the left. So that the left side is being cloned by the right side.

Updating a project from WebVR to WebXR

To update your projects to use WebXR, please re-output your projects.

If you no longer have the project available or need a quicker solution than re-outputting, you can replace the player and edit the HTML page:

  1. Build a new project with Pano2VR 6.1.6 or later and output the project to generate a new webxr folder in the output.
  2. In the project to be updated, replace the webvr folder with the new webxr folder.
  3. Copy the new pano2vr_player.js file from the Pano2VR 6.1.6 output and replace the file in old project folder.
  4. Open the HTML page in a text editor and search for webvr and replace with webxr.
  5. Test on your favorite HMD.

See also