Skip to main content

Flash Output Settings (Pano2VR)

This is the documentation for Pano2VR 4. You can find the new documentation for Pano2VR 5 here.

Pano2VR - Help

Pano2VR gives you the added ability to convert panoramic images into Flash movies. Click here to see an example.

This article will walk you through all of the settings found in the output settings. Go here to learn more about the workflow.

Settings Tab[edit]

Flash Output Settings

Tile Settings[edit]

Cube Face Size: The size of a cube face, measured in pixels (height x width). Pano2VR will calculate the best output cube face size based on the original image. However, you can always change this value to what you like.

For example, you have an image that is 6000 pixels wide, each cube face will have a value of 1500 pixels (6000/4). To output a smaller file size, however, you can lower the cube face size. For instance, a 6000 pixel wide image could be reduced to a 750 cube face size (6000/8).

Image Quality: The overall quality of the image as defined in JPEG images. 90% is the default value, lowering the value below 90 will decrease the quality of the outputted image.

Tile Quality: Here you can set the image quality of the individual cube faces plus the preview image. For example, the zenith and nadir images could be lowered further if their information is not critical.

Individual tile settings

Sub Tiles: Sub Tiles allow you to choose the amount of tiles for each cube face. These determine how the image is downloaded. A setting of 1, the default, means that the cube face will download all at once and not progressively. A setting of 3, however, will allow for a progressive download of the cube faces and perhaps allowing for a faster download.

3x3 Subtiles
1x1 Subtiles

Externalize: Select, Panorama images, to keep the images out of the SWF and called externally from the Images folder. Once selected, the following options will be made available.

Image Names: To edit or change, first select, Panorama images. This creates a folder to hold the cube face images. Or you can choose your own folder or location by clicking, Open…. The default is images/$n_o.jpg. Images is what the folder will be named. $n is a placeholder that will be replaced by the image's name. o simply stands for output and can be removed or changed according to your needs.

Face Names: To edit or change, first select, Panorama images. Choose a naming convention for the cube faces. The naming convention will be appended to the file name displayed in the Image Names text field.

Outputted cube face images with naming convention


Window[edit]

Size: Adjust the width and height of the movie window.

Scaling: Scaling resizes the window in which the panorama will play. Here you can choose how the panorama will be resized when its window's proportions change.

FoV Mode: This setting ensures that image boundaries stay true to the image's window or scaling option. When the window size is changed, the image is scaled accordingly.


Auto Rotate[edit]

Enable auto rotation: When enabled, the panorama will begin to move (rotate) when the window is opened/loaded or when triggered by the mouse.

Pan Speed: Pan speed refers to how fast the panorama will rotate from left to right (positive number) or right to left (negative number).

Delay: The time it takes for the panorama to begin to rotate (in seconds) again after it has been manually moved by the user.

Return to Horizon: Brings the movie's center perspective (horizon) back into view after it has been manually moved upwards or downwards. A value of 0 will equate to no return, and an increase in the value will return the image to the horizon at a quicker speed.

Start after fully loaded: Enable this option if you want the movie to start rotating only after it has been fully loaded. If left disabled, the panorama will rotate while it is being downloaded.

Only in focus: When enabled, the panorama will only rotate when the mouse hovers over it.

Change Node: Pro – Set to automatically change the nodes in a tour, every n seconds. The panoramas will change according to their order in the Tour Browser, which you can change to suit the tour's story or flow.


Skin[edit]

Name: Here you can choose either one of the pre-installed skins or choose one that you have created. The file extension used for the skins is .ggsk (stands for Garden Gnome Skin).

Edit: Clicking this will bring you to the Skin Editor.

File: Click here to open a skin that is not located in the Garden Gnome Skins folder.

Externalize: Select, Skin Images, to have all the images used in the skin externally called so they are note embedded in the outputted SWF.

Image Output Path: This creates a folder to contain the images of the skin and by default is placed in the same location as the panorama. The default is the same folder as the default folder (images) that holds the cube face images. The name of this folder can be changed. Clicking Open… will let you choose a specific location.

Output[edit]

Output File: Change the name of the file (if you wish) and choose where to save the outputted image. The default is to output the file in the same folder as the original image. If no change is made here, this is where you will find your outputted image.

◊ NOTE: $n is a placeholder and will be replaced with the panorama's file name.


Visuals Tab[edit]

This tab was added in Pano2VR 3. Some options found here were originally located in the Settings Tab.

Visuals Tab

Download - Preview[edit]

Type: Choose the type of download preview image: Grayscale, Color or Sepia. When None is chosen, no preview image is used during download. Rather, only a background color is shown (color-picker).

Resolution: This represents how clear or blurry the download preview image will appear. This setting will effect the file size. The default setting is 1:4 which is a reasonably good setting. Setting it to 1:1, makes the downloading image as clear as the original image.

Download Order: The order of how the image is downloaded. Choose from:

Rendering[edit]

Frame Rate: Adjust the frame rate of the movie. ◊ TIP: A smaller frame rate can reduce the processing needed on the clients machine. This can be helpful if you have several panoramas on one page.

Change stage quality: Keep this option selected if the panoramic image does not include elements on the flash stage (i.e. vector based controller, your own loading bar, etc.). When this option is not selected it helps to eliminate the jagged lines that appear with elements in the image during movement.

Change bitmap filtering: Same as above but has an effect only on the panorama and not the whole stage.

Transitions[edit]

Select Enable transitions to add transitions.
◊ TIP: You only have to enable this setting in the first Pano2VR project file within the series.

Transition Type:

Transition Time: This determines how long it takes to change from one panorama to the next including the transition effects.

Effects:

Zoomed FoV: Set how far the transition effect zooms in and out.

Zoom Speed: this controls how fast the zoom in and out effect moves.


Advanced Settings Tab[edit]

Advanced Settings Tab

Control[edit]

Sensitivity: Set the movie's sensitivity to the movement of the mouse. A low sensitivity will cause the panorama to move slowly with the mouse's movement.

Movement: Control of the panorama.

Mouse: How the mouse will interact with the panorama.

Mouse Wheel: Mouse wheel controls.

Keyboard: Keyboard controls.

Local Security: When this is enabled, Flash will be able to communicate with another website, but will deny Flash's access to the local disk. When disabled, Flash can only access the local disk and will not have access to a network.


Context Menu[edit]

The following options are for the right-click context menu.

Add 'Fullscreen' item: Select this to add a Fullscreen option to the right-click context menu.

Hide 'About Pano2VR': Pro Select this option to hide the About Pano2VR menu option in the right-click context menu.

Link Text: Pro Enter text that will appear in the right-click context menu.

URL: Pro Enter the URL that is associated with the text from above.

Mouse Cursor[edit]

Custom Cursor: Mouse cursor controls.

Custom Cursor Image: Import your custom made cursor here. Check out information on cursors.

Hotspot Text Box[edit]

Here you can customize how the text boxes for the hotspots will look like.

Enabled: Select to enable the hotspot text box features.

Size: Set the size of the text for the hotspot.

Text: Customize the text.

Background: Choose Visible to show the background of the text box and choose a color for the background. When Visible is not checked, no background will be seen.

Border: Choose Visible to show the border of the text box and choose a color for the border. When Visible is not checked no border will be seen.

◊ TIP: If you do not want to have the boxes visible at all - only the text - be sure to deselect Visible from both Background and Border.

Polygon Hotspots[edit]

View Mode: Choose how the hotspots appear.

Locks[edit]

Enable domain lock: Enable this option when you wish to secure your panorama only to the specified domains.

Examples:
mydomain.com is entered in the domain lock:
mydomain.com = allowed
www.mydomain.com = allowed
www.mydomain.com is entered in the domain lock:
mydomain.com = not allowed
www.mydomain.com = allowed


Message: Insert a message that will appear if the panorama is displayed in a domain other than what is listed in Domain. HTML formatting can be used.

Enable expire date: Here you can add an expiration date of the visibility of the panorama.


Multiresolution Tab[edit]

This tab was added in Pano2VR 3.

Flash Multiresolution Tab

Basic Settings[edit]

Enabled: Select to enable multiresolution output. When selected, the cube face size in the Settings tab is ignored in favor to what is set in the Levels section. The Image Quality and Tile Quality settings will affect the sub tiles generated here. ◊ NOTE: Allow network access needs to be deselected when testing locally.

Level Tile Size: This determines the size of the sub tiles in pixels.
◊ TIP: For best results use settings between 250 to a 1000px.

Format: Choose the image format.

◊ NOTE: Flash best handles the Cubic format, giving optimum performance.

Filename: This determines the file location and naming convention of the generated sub tiles. You may change the name to suit your project, although the placeholders must be used so Pano2VR knows which tiles to use.

Generate Files: This option is selected by default to generate the multiresolution files. Once multiresolution is set up, you can deselect this option to keep Pano2VR from generating the tiles each time the project is outputted.

Advanced Settings[edit]

Video loading...

Watch this video on YouTube


Overlap: Keep selected to have the tiles overlap by one pixel to avoid visible seams in the image. If using tiles from a source other than Pano2VR, this option may need to be deselected for correct tile alignment.

Raw Image Memory: Set how much memory will be used by the host computer for downloading tiles. Leave at default if the host computer has limited memory.

Bitmap Memory: This sets how much memory will be used by the host computer to store the decoded bitmap tiles. Leave at default if the host computer has limited memory.

Switch Bias: Changing this setting will determine at which zoom levels the tiles will change. The higher the number, the sooner the tiles will change. If this is set too high it will require much more processing (downloading and decoding) for the host computer. A good compromise setting is between 0.4 and 0.5.

This all works by comparing screen and image pixels:

A negative setting will change the tiles when there are 4 image pixels to 1 screen pixel:
Bias = -1
Zooming in will cause the visible tiles to change just before there are 4 image pixels to 1 screen pixel. Zooming out, the tile will change just before there are 2 image pixels to 1 screen pixel.
A high bias number will change the tiles sooner and will produce aliasing, and will increase processing load:
Bias = 1
Zooming in will cause the visible tiles to change just before there is 1 image pixel to 1 screen pixel. Zooming out will change the tiles just before there is 0.5 image pixel to 1 screen pixel.
Bias = 0
Zooming in will cause the visible tiles to change just before there is 1 image pixel to 2 screen pixels. Zooming out will change the tiles just before there is 1 image pixel to 1 screen pixel.


Download Queue Size: This determines how many tiles are downloaded from the server at one time. Leave at default (20 tiles) for optimum performance.

Decode Queue Size: This determines how many tiles are decoded to bitmap at a time. Changing this setting may affect the performance of the host computer. Tile size affects this setting. If the host computer is stuttering when trying to show the tiles, try increasing the queue size if the tiles are small; or trying lowering if the tiles are large. Generally, the default should work well for most projects.

Levels[edit]

When you enable multiresolution, Pano2VR automatically sets three levels. The division of the levels is determined by the settings in the Pano2VR settings/preferences. They can be divided either by 4 or by Pi.

You can add more levels manually by choosing the Add. The pixel size can also be channged. To remove levels just click the red X to the right of the level you wish to remove.

Embed: Tick this box to determine which tile levels will be embedded in the swf file.

Load at Startup: This determines which level will be used when the player is first opened.

Decode at Startup: This determines which level will be decoded when the player is first opened.

◊ TIP: If making gigapixel panoramas set the Memory Hint in Pano2VR settings to at least half of your computer's RAM; this will speed up the process.
The default is 300MB, if you have 8GB of RAM, set it to 4000MB.


The HTML Tab[edit]

Use this tab to make a custom HTML page to add to your website that includes not only your panoramic movie but also audio. The video below shows you how:

Video loading...

Watch this video on YouTube


Information on the coding language used to create the HTML template can be found here.

The HTML Tab

Enable HTML File: Select to be able to edit the HTML template parameters.

Template: Here you can choose a pre-loaded template (fullscreen.ggt or normal.ggt). The normal template will give you the ability to add a table that shows the user data; whereas the fullscreen template will not.

Template Parameters[edit]

Text, Background Colors: Choose the color of your text and your page background.

Show User Data Table: Choose to show the user data table or not.

Table Bordor, Table Text, Table Background Colors: Use these color pickers to customize your table.

Embed Sound File: Choose "Open" to locate and choose your MP3 of choice.

Sound Title: The title of your audio (MP3) goes here.

Panorama Video File: Select the 360º video file for panoramic video output.

Direct node access: Pro Select to be able to directly link to a node in a tour via the URL. This eliminates the need to have an HTML page for every tour node.

Enable JavaScript Interface: Enable this to use JavaScript to externally control the panorama.

Template Output[edit]

Format: Choose between extensions, .html and .htm.

Output File: If you wish, change the name of the file and choose where to save the outputted HTML file. The default is to output the file in the same directory as the original image. If no change is made here, this is where you will find your outputted image. ◊ NOTE: $n will be replaced with the name of your original image.


See also[edit]

Flash Output (Pano2VR)
Multiresolution (Pano2VR)