Table of Contents
A map to all help pages for Pano2VR.
- What's New?
Here you'll find an ongoing list of new features, fixes, and changes added to each release.
- User Guide
Welcome to our User Guides where you'll find step-by-step instructions.
- Getting Started
The documents in this section outline the basic workflows, installation, and project set-ups.
- Installation
Installing requires downloading the software from ggnome.com and installing the program on to your desktop computer.
- Installation
- Importing Images
Import images by dragging them in, using an image sequence pattern, or capturing the images directly to Object2VR.
- Import Using the Light Table
Use the Light Table to bring images in the project.
- Capture Input
Capture images directly from the camera to Object2VR Studio.
- Import Using an Image Sequence
Importing your images as an image sequence is most convenient for projects with a large number of images.
- Image Sequence Pattern
The image sequence pattern is a way to describe your file naming convention to Object2VR in order for it to recognize your images as a sequence pattern.
- Import Using the Light Table
- Image Processing
The Image Processing Tools are found in Object2VR Pro and Studio and help to quickly clean up and mask images after capturing them.
- Convert Images
Use the Convert option to quickly create a new project using your newly processed images.
- Working with Hotspots
Hotspots are points or areas of interaction within the project. They can open other images, open websites, and pop up information boxes, images, and videos.
- Adding Point Hotspots
Point Hotspots are points of interactivity within the project. Learn how to add them to your project.
- Add a Polygon Hotspot
Polygon hotspots require you to draw a shape as opposed to creating a single point of interactivity.
- Create Tooltips
Tooltips are the bit of text that appears when a mouse enters an element or area that uses them. They are widely used for node type hotspots and show the title of the next node or as information pop-up texts. They can also be used to simply show information.
- Animated Hotspots
Learn how to create an animated point hotspot in the Skin Editor using a skin variable with a Timer.
- Custom Hotspot Images
Each hotspot can have its own image. The custom hotspot image can be added in the skin to affect all hotspots using hotspot templates. Or you can add a custom image to individual hotspots.
- Adding Point Hotspots
- Creating Popups
Learn how to create video and image pop-ups and more with hotspots and viewer elements.
- Built-in Popups
The simplest way to add popups to your project is to use the built-in skins or the the built-in components. Both require using Point Hotspots.
- Polygon Hotspot Activated Popups
Popups can be activated by Polygon Hotspots by using the Hotspot Proxy ID in the Skin Editor.
- Create a Website Popup
Learn how to create a popup up window using the URL type Point Hotspot and a Text Element in the skin.
- Built-in Popups
- Create a Multilingual Project
Learn how to create multilingual projects with the translation tools. in multiple languages.
- Translating Skins
Learn how to translate the skin in the Skin Editor.
- Translating Skins
- Creating Skins
Use the Skin Editor to create and design interactive overlays for your virtual tours.
- Using the Color Tool
The Color Tool, found in the Skin Editor, lets you quickly change the colors of a skin or a selection of elements.
- Creating and Using Components
Components are a group of skin elements that are saved as a single element in the Components Toolbox and can be reused.
- Scale an Element Based on Player Width
You can use logic blocks to create a responsive skin (where the skin elements scale to the player's width). This will require a logic block with multiple expressions.
- Auto-hide Skin Elements
Learn to use a Timer's logic block to hide elements, like a menu, during user interaction.
- Video Element Tips
Learn how to hide videos when they are not playing, how to fade videos in and out, and how to fill a video's container when there is an aspect ratio mismatch.
- Using Action Filters
Action filters let you define conditions for the execution of actions assigned to an element.
- Introduction to Using Variables
Variables are powerful tools that help simplify automation within a skin.
- Search in the Skin Editor
Use the Search tool in the Skin Editor to find elements and variables.
- Mapping Keys to the Skin
You can map keyboard keys to actions in the Skin Editor. This allows a user to use either the mouse or the keyboard to control and interact with the panorama or tour.
- Using Regular Expressions
Regular expressions let you address multiple elements within the Skin Editor with just one action. This will save time when setting up thumbnails or any other multiple element project.
- Collection of Components Tutorials
Use the Skin Editor to create and design interactive overlays.
- Styling with CSS
CSS or Cascading Style Sheets are what the web uses to style a web page. It is a rule-based language that specifies how elements should look or be presented in a web browser.
- Adding Google Fonts
Learn how to add Google Fonts to your project.
- Embedding Fonts
Fonts can be embedded in Pano2VRโs skin. This means that the fonts are served locally, rather than fetching them from third-party servers like Google Fonts.
- Create Animated Hotspot Icons
Learn how to create animated icons for point hotspots. This particular animated icon will consist of to rotating bars hinged at the center.
- Create Buttons Using Text Boxes
Learn how to use a couple of text boxes to create a 2-state button.
- Create a Popup Image with Scrolling Text
Learn how to create a custom image popup with a text box that expands to fit the amount of text.
- Adding Google Fonts
- Using the Color Tool
- Exporting
Once you're finished working on your project you can output it for a website, as a flat video, as a different projection, or for social media.
- Web Output
The web output exports all the files needed to add a project to a website for playback in any modern web browser.
- Garden Gnome Package
The Garden Gnome Package (GGPKG) is a package format for offline viewing and for content management systems to easily embed your projects into websites.
- Using CMS Plugins
The Garden Gnome Package (GGPKG) is a package that can be used for content management systems and lets you easily embed your projects into your website.
- WordPress Plugin
We provide a package format (GGPKG) to make it easy for you to embed your panoramas on your CMS site or blog. Below are the instructions for WordPress.
- Using the Package Viewer for Desktop
The Garden Gnome Package Viewer is a native desktop application that opens Pano2VR and Object2VR packages (GGPKG) for viewing content offline.
- Joomla Plugin
We provide a package format to make it easy for you to embed your panoramas on your CMS site or blog. Below are the instructions for Joomla.
- Using the Package Viewer for iOS and Android
The Package Viewer is a mobile app that lets you showcase your virtual tours and object movies without the need for an internet connection; making it ideal for showcasing to clients or at exhibitions.
- Drupal Plugin
We provide a package format to make it easy for you to embed your panoramas on your CMS site or blog. Below are the instructions for Drupal.
- Using CMS Plugins
- Upload to Gnome Cloud
Gnome Cloud is a service we provide that you can use to host your projects. Upload a project to the cloud from the Web Output.
- Garden Gnome Package
- Integrated Web Server
A local web server is built in to the software. It simulates an active web server so you can view your project locally (browsers restrict local viewing for security reasons).
- Using the Integrated Web Server
The integrated web server's default settings are set to be used when viewing the output within an HTML page. It was included to allow local viewing of the web output (something most browsers do not allow for security reasons).
- Using the Integrated Web Server
- Web Output
- Practical Tips
Practical tips, tricks, and how-tos for specific projects.
- Adding Custom Text Fields
Learn how to add more parameters or text fields to User Data and Hotspots.
- Adding Custom Text Fields
- Getting Started
- The Workspace
These pages detail the entire workspace and settings.
- Menu Bar
In the menu bar, you'll find more tools and shortcuts. The menu bar also changes for the Skin Editor.
- Toolbar
Use the Toolbar at the top of the main project window to show or hide panels.
- Properties
The Properties panel is where individual settings are found for various features within the program.
- Project Properties
The Project Properties contain settings for the entire project.
- User Data
Use the User Data panel to add information about an node or image.
- Viewing Parameters
The viewing parameters section lets you choose which image will be the first to be viewed and how the object movie will be controlled.
- Project Properties
- The Viewer
The center of Object2VR features the Viewer. This is where you add hotspots to the object. It also where you'll used some of the image processing tools, like crop and transformation.
- Viewer Modes
Viewer Modes are used to pin elements to the panorama in the Viewer.
- Image Processing Tools
Use the Image Processing Tools to make quick image adjustments. Avaliable in Object2VR Pro and Studio.
- Point Hotspot Properties
Point Hotspots are interactive points that open websites, PDFs, videos, informational texts, and more. This article covers all the properties of a point hotspots.
- Polygon Hotspot Properties
Here you'll find the properties for the polygon hotspots which are found in the Properties panel once a hotspot is added or selected.
- Image Processing Tools
- Output Panel
The Output panel is where you choose output formats for your project. There is also a button to open the Gnome Cloud Browser.
- Web Output Properties
The Web Output Properties open in the Properties panel. This is where set player-based parameters like the context menu, HTML file, and hotspot settings.
- HTML Templates
The Web Output exports an HTML file to play back the project in a browser. This is a template that can be edited to your project's needs.
- Normal Template
The normal HTML template is the default template that is used when exporting a web output. Use the template parameters to quickly configure it.
- Garden Gnome Package Template
Edit this Garden Gnome Package HTML template to create a custom GGPKG output or select for Droplet use.
- Normal Template
- Web Output Properties
- Capture Panel
Use the Capture panel to control both the camera and turntable.
- Capture Properties
Open the Capture Panel to access the capture properties.
- Capture Properties
- History Panel
The History panel shows you a list of all the actions you've done. And you can go back in history by clicking up the list (similar to Photoshop).
- Hotspot List
Hotspots in Object2VR are created in the Hotspot List.
- Overview
The Overview panel provides an overview of the entire project.
- The Light Table
The Light Table is used to import and organize the images that make up the object VR. It organizes the images into columns, rows and view states making it easy to rearrange or delete images within a series.
- Skin Editor
A skin, as a whole, is a graphical element (interface) that is layered over the panorama and can include images, maps, buttons, text, and sounds.
- Skin Editor Tree
The Tree supports a parent-child layering organization. An element treated as a parent will have a child or children that is/are "connected" to it, making it easier to group the elements and move them together in the canvas. The layering of the elements is like Photoshop; the top-most element is the front-most layer.
- Skin Editor Canvas
The Canvas is where all the elements (images, buttons, etc.) are placed and arranged. Consider it your workspace for designing your skin.
- Skin Editor Properties
The Properties section is where the settings for skins elements are located. It also holds the settings for the Canvas and the skin itself. All the properties are grouped in collapsable panels.
- Skin Editor Toolbar
The toolbar is found at the top of the skin editor window and holds all the tools needed for adding elements in the editor, zooming in to the canvas and accessing additional tools.
- Skin Editor Menu Bar
The menu bar is found at the top of the program's window in Windows and Linux or at the top of the screen in Mac OS. This is the menu bar for the Skin Editor only.
- The Color Tool
The Color Tool, found in the Skin Editor, lets you quickly change the colors of a skin or a selection of elements.
- Components Toolbox
The Components Toolbox holds a collection of predefined skin elements including icons and Lottie animations.
- Skin Elements
A skin element is any object added to the skin.
- Container
A container is an invisible element that allows you to group elements together in the tree or canvas.
- Rectangle
The rectangle element can be drawn to any size. Use it as a button or as a screen tint. Or even as a fix to create active areas in 3D distorted hotspot images.
- Text Box
Text Box are for adding text to the skin. You can use basic HTML tags to format the text, or use CSS.
- Image
The image element is used to add images to the skin. Once you click on the Canvas, you'll be instructed to selected an image.
- Button Element
The button element provides multiple states of a button. Each state can have a different image which provides visual indications of interaction.
- SVG
Click the *Add Scalable Vector Graphics* button in the Toolbar and then click in the Editor to choose a SVG file. Or, just drag the SVG in to the editor.
- Lottie Animation
Lottie files are small animations designed to work on all devices. Use them for buttons and hotspots.
- PDF
Use the PDF element to embed PDF documents in the skin.
- External Image
Use the external image to add images that need to be loaded externally rather than embedded in to the skin. This is especially useful if you have a lot of thumbnails in a tour and are not using the Node Image element.
- Scroll Area
A scroll area is a container that will add scrollbars around an element or group of elements, if necessary. It can also be used to clip content.
- Cloner Element
The cloner is a useful tool that's used to quickly build menus from hotspots, translations and more.
- Timer Element
The timer is a container that is useful for timing actions in the skin. For example, you can use a timer to hide a Welcome Screen (or splash screen) after 5 seconds.
- Hotspot Template
A hotspot template lets you add a custom image to a point hotspot.
- Video Element
Use this to add videos to your skin. You can use local files, URLs or YouTube and Vimeo IDs.
- Seekbar
Seekbars can be used to seek or move backwards and forwards in time for background sounds, all pinned sounds and videos of the project, as well as skin sounds and skin videos, and even 360ยฐ video panoramas (except embedded YouTube and Vimeo videos).
- Code Element
The code element is used to apply Javascript to the skin.
- Container
- Skin Actions and Modifiers
Actions are like a set of directions that are applied to any element added to the skin to create interactivity.
- Sources
In the actions section of the Actions/Modifiers tab in the Skin Editor, you'll find a column called Sources with a pop-up menu. These sources represent the triggers that cause the actions.
- Actions
Actions or a set of directions can be applied to any element added to the skin to create interactivity.
- Skin Modifiers
Use modifiers to affect a skin element's behavior. Open the Modifiers panel and double-click in the table or click the plus sign to the right to open the Modifier Settings.
- Skin Actions Examples
Here you'll find a few examples of common actions. You can assign actions to any element in the skin editor.
- Sources
- Logic Blocks and Action Filters
Logic blocks are a way of automatically altering values of skin elements, making it possible to react to certain circumstances using logic. Action Filters are applied to actions and define conditions for the execution of actions assigned to an element.
- Logic Block Triggers
Triggers are start of events for a condition of a logic block.
- Logic Block Triggers
- Skin Editor Tree
- Gnome Cloud Browser
The Gnome Cloud is a service we provide that you can use to host your projects. Use the Browser to view projects and data associated with them.
- Layout Customization
Pano2VR has a modular interface which allows for custom layouts.
- Object2VR Settings
Customize Object2VR's settings by changing the language, the theme, folder name defaults, and more.
- Menu Bar
- Reference
This is the reference section for APIs, Keyboard Shortcuts, and more.
- List of Placeholders
A placeholder is like a shortcut for using data or text from other sections of the software.
- Keyboard Shortcuts
A list of all keyboard shortcuts found in the main project window and the Skin Editor.
- JavaScript API
The player has an external API so it can be controlled with JavaScript.
- HTML Template
Use the Garden Gnome Template files as a basis for the HTML output.
- Creating a Support Package
The Support Package is available for you to collect all the project files our support team would need to help you. Learn how to create a pared-down version of your large project as a support package.
- List of Placeholders
- Glossary
A list of terms used throughout Pano2VR.
- Action
Actions are like a set of directions that are applied to any element added to the skin to create interactivity.
- Asset
Assets are media associated with a project.
- Container
A container is an invisible skin element used to group elements.
- Default View
The default view is the project's initial opening view or angle.
- Custom Property
Custom properties provide extra text input fields or properties that can be targeted by the skin.
- Element
Viewer elements include hotspots and pinned images, and Skin Elements include text boxes and hotspot templates.
- hotspot proxy ID
A hotspot proxy ID is used to make a link between hotspots and skin elements and their actions.
- Hotspot
Hotspots are definable, interactive areas within the panorama.
- Hotspot Template
A placeholder that links the Hotspot Image in the skin to the hotspot in the image.
- Loading Bar
A loading bar is a set of graphical elements (or a single element) that is used to illustrate how much of the panorama has loaded.
- Placeholder
A placeholder represents a value for content that will be filled in later.
- Skin
A skin is a collection of text and graphical elements overlaid on the image.
- SVG
Scalable Vector Graphics are an XML based 2D vector graphics format used in Pano2VR as skin elements.
- Component
A component is a pre-defined skin element or group of skin elements.
- Toggle
This is a command generally used in an action for a skin element to show and hide or play and pause, for example.
- View State
A view state is how the object appears at any time.
- Action
- Table of Contents
A map to all help pages for Pano2VR.
- Tags
A list of tags to help you better find what you're looking for.