Go to Index
Pano2VR 8.1 Docs / Patch Properties
This is beta documentation. View the latest stable documentation.

Patch Properties

After adding a patch to the Viewer, the Properties panel will open with settings that all patch types share. The default patch type is Image.

Switch to Master Node – This button appears at the top of the panel when the selected patch is inherited from the Master Node while another node is open. Click it to switch to the Master Node where the patch can be edited.

The following parameters are used by all Patch types:

Position – Select Lock to keep the patch from being moved by accident. Locking disables the Pan, Tilt, Roll, FoV, and Aspect Ratio fields.

Pan – This is the position of the patch on the horizontal axis.

Tilt – This is the position of the patch on the vertical axis.

Roll – The rotation of the patch around its center, from -180° to 180°. You can also drag the red, circular arrow in the center of the patch in the Viewer.

To change Pan and Tilt, you can also drag the patch in the Viewer.

Patches with Roll (roll value other than 0) cannot be converted to a Point Hotspot.

FoV – The area the patch covers, from 1° to 179°. You can also change the FoV by dragging the corner handles of the patch in the Viewer.

Aspect Ratio – Enter the desired aspect ratio (0.1 to 10.0) to change the dimensions of the patch. The default is 1:1 (1.00).

Apply After Levelling – When the down or up faces are not located at -90° or 90° after leveling (for example with drone shots or one-shot cameras not on a tripod), select this setting to make sure that your logo patch stays on the down or up face even after leveling is applied. This is also used for Droplets and the Master Node.

Type – Choose the type of patch to be used:

  • Image (default)
  • Mirror Ball
  • Angular Map
  • Sphere
  • Blurred Circle
  • Blurred Square
  • Blurred Cover

The blurred patches are useful for images submitted to Google Street View, for blurring faces and license plates, and for covering the tripod. When you choose Blurred Circle or Blurred Square, an Intensity slider appears. Use it to adjust the amount of blur.

You can choose the patch type directly when you create a patch in the Viewer:

  • Blurred Circle – Shift-double-click.
  • Blurred Square – Shift-Command-double-click on macOS, Ctrl+Shift+double-click on Windows.
  • Blurred Cover – Option-Shift-double-click on macOS, Alt+Shift+double-click on Windows.

Apply – Shown for all patch types except Image. Click to apply the patch to the panorama image. Applying also locks the patch’s position.

The following parameters are for Image type only:

Format – Available when Type is set to Image. Choose the file format of the patch image. The menu lists the image formats Pano2VR supports, for example PSD, TIFF, PNG, JPEG, WebP, and OpenEXR. Right-click a format and choose Set as Default to use it for new patches.

Image Quality – The JPEG quality of the image (1 to 100). This setting is only enabled when Format is set to JPEG.

File – Name the patch here or open a new version of a patch. If you enter a file name without an extension, .psd is used. If the selected image file contains patch position data in its metadata, Pano2VR asks whether to use this position for the current patch. The Extract, Generate, and Open buttons appear as soon as a file name is entered.

Extract – Click to extract the patch. The patch will open in your default photo editor. Extracting also locks the patch’s position. On the Master Node of a tour, the file name must contain placeholders, and you will be asked whether to extract the patch for all nodes.

Generate – Click to use AI to generate the patch for you. Generating requires a gnome.cloud login and only works with a 1:1 aspect ratio. If no mask is set, a Circle mask (Radius 70%, Feather 10%) is applied automatically, and the patch’s position is locked afterwards. Generations require tokens which can be purchased through your gnome.cloud account. Every Pano2VR 7 license holder is given 250 tokens for free to start. Each generation costs 1 token. Press and hold the Generate button and choose Generate with Settings to open a dialog where you can select the generation engine and enter your own prompt and, if the engine supports it, a negative prompt. On the Master Node of a tour, you will be asked whether to generate patches for all nodes.

Open – Click to open the patch image in the default program you’ve set for image files. Option-click (macOS) or Alt+click (Windows) to save a remapped version of the patch image to a file instead.

Convert – Click one of the three buttons to convert the patch into a point hotspot, a pinned image, or a pinned video at the same position. A point hotspot allows effects like a roll-over that shows a door closed and opened. A pinned video is useful for embedding video in a panorama, and a pinned image can be quicker than a skin element for showing or hiding parts of the scene. If the patch’s file format isn’t suitable for browsers, Pano2VR asks whether to convert the file automatically or to pick a different file. Patches with a roll value other than 0 can’t be converted to a point hotspot. See Converting Patches to Point Hotspots for roll-over effects.

Mask

Use a mask to better blend the Image patch. The mask is represented by the green circle or rectangle inside the patch outline. Use the green dot handle to change the mask’s size or shape.

Type – Choose the mask type: None (default), Rectangle, or Circle

A Rectangle mask shows:

  • Top
  • Bottom
  • Left
  • Right

Each is the distance of that mask edge from the patch edge, in percent.

A Circle mask shows:

  • Radius – how much of the patch the mask fills

Feather – The amount of feathering at the edge of the mask, which blends the patch into the panorama.

See also…

Last modified: Sep 23, 2026