PTViewer image file format


About PTViewer
Creating a PTViewer panorama using the Wizard
Creating a PTViewer panorama using the Classic interface
Saving a PTViewer panorama
Capabilities of the PTViewer export filter
Importing a PTViewer panorama
Capabilities of the PTViewer import filter
Installing support for PTViewer on your computer
Note for users of V3
References



 

About PTViewer

NOTE: According to the PTViewer documentation [1], “PTViewer is an open and free Panorama viewer.”  However, the PTViewer is produced by Helmut Dersch. and is not a product of Smoky City Design, LLC.  When using this viewer, please be sure to comply with licensing requirements (if any) imposed by Helmut Dersch.

The PTViewer, from Prof. Helmut Dersch [1], is a Java viewer that is one of the best viewers available.  Prof. Dersch has given a great deal of attention to image quality issues in the PTViewer.  The viewer also provides a rich set of features.

A recently updated version published by Fulvio Senore [5] provides improved image quality through Lanczos2 interpolation and also corrects the problem described in “Trouble Report 273—Hotspots don't display properly in PTViewer.”

PTViewer displays a segment of a panoramic image, re-projecting the image to have conventional perspective.  By click-dragging on the image, you can look around as though you were standing in the middle of the scene.

Saving an image in PTViewer format actually creates two files: a JPEG image and a web page (HTML file).  It is not possible to create a PTViewer image without the web page.

PTViewer images can contain hotspots.  These are areas on the image that do something when you click on them.  For more information, see “Adding hotspots to your panoramas” in Chapter 7, “Making a virtual tour.”


top


 

Creating a PTViewer panorama using the Wizard

To make a PTViewer panorama using the Wizard, simply select PTViewer for the output format on Wizard step 5/9/ - Válassza ki a panoráma típusát / Select panorama type.


top


 

Creating a PTViewer panorama using the Classic interface

Follow these steps to make a PTViewer panorama:

1.       Create a panorama using the Tűzés / Stitch command or the Tűzés 360 / Stitch 360 command (Új kép / New image menu). Be sure to use the Tűzés 360 / Stitch 360 command if this is a full 360 degree panorama.  For best results, select Vetítés gömbfelületre / Spherical projection on the Kamera tulajdonságok / Camera properties dialog box before creating your stitched image.

2.       Crop the stitched image using the Körbevágás / Crop command (Új kép / New image menu). You may change the height of the cropping rectangle if you wish, but for best results do not change its angle or width.

3.       Resize, sharpen or otherwise enhance the image.

4.       Make sure the final image is displayed as the current image. If it is not, you should double-click its thumbnail to make it the current image.

5.       Select the Aktuális kép mentése... / Save current image as... command from the Fájl / File menu and then select PTViewer format from the the Save as type dropdown list of the Kép mentése másként / Save Image As dialog box.

See also Chapter 4, “Using the Classic interface, step by step.”


top


 

Saving a PTViewer panorama

To save your IVR panorama, select the Aktuális kép mentése... / Save current image as... command from the Fájl / File menu and then select PTViewer format from the the Save as type dropdown list of the Kép mentése másként / Save Image As dialog box.

NOTE: Use the Aktuális kép mentése... / Save current image as... command to save and name the current image. To save the entire Panorama Factory project, use the Projekt mentése / Save project command, Projekt mentése másként... / Save project as... command or Projekt archív mentése... / Save project archive as... command instead.

Choosing PTViewer enables other choices on the Kép mentése másként / Save Image As dialog box.  You may create a web page containing an PTviewer viewer, create a thumbnail image and view your web page in your computer's web browser.

You can also control attributes of the saved IVR image file by selecting the IVR beállítások... / settings... button to display the IVR beállítások / IVR settings dialog box.


top


 

Capabilities of the PTViewer export filter

The PTViewer export filter supports only a subset of the PTViewer format.  This section describes this subset and explains the relationship between Panorama Factory panoramas and hotspots and the PTViewer format.


top


 

Importing a PTViewer panorama

To import an PTViewer panorama, select the Képek importálása... / Import images... command from the Fájl / File menu and then select PTViewer format from the Files of type dropdown list of the Képek importálása / Import Images dialog box.

You must select an .HTML or .HTM file that contains a PTViewer image.  The Panorama Factory will import all PTViewer images that are referenced from the web page.


top


 

Capabilities of the PTViewer import filter

The PTViewer import filter supports only a subset of the PTViewer format.  This section describes this subset and explains the relationship between Panorama Factory panoramas and hotspots and the PTViewer format.


top


 

Installing support for PTViewer on your computer

NOTE: According to the PTViewer documentation [1], “PTViewer is an open and free Panorama viewer.”  However, the PTViewer is produced by Helmut Dersch. and is not a product of Smoky City Design, LLC.  When using this viewer, please be sure to comply with licensing requirements (if any) imposed by Helmut Dersch.

In order to view PTViewer images you must install the PTViewer Java viewer (for internet browsers).

We recommend the recently updated 2.8 version of PTViewer available from Fulvio Senore [5] at http://www.fsoft.it/panorama/ptviewer.htm.  PTViewer may also be available directly from Prof. Dersch's website [1] or one of the mirror sites [2,3,4].  As of this writing (June 2004), the most recent revision at the mirror sites appears to be identified as Version 2.5 for Java 1.0.4 or above.

The PTViewer ZIP file contains several different versions of ptviewer.jar.  The one supported by The Panorama Factory is identified as

Applet\ptviewer.jar in the 2.8 ZIP file
ptvj2.5\Applet\ptviewer.jar in the 2.5 ZIP file

After downloading the viewer, you should place the ptviewer.jar file into the folder on your computer that contains The Panorama Factory application.  This is normally:

C:\Program Files\Smoky City Design\The Panorama Factory

When The Panorama Factory exports an image for PTViewer, it tries to copy ptviewer.jar (and possibly also ptviewer.class) from its application folder to the folder into which you are exporting.  This enables your web browser to find the JAR file when you view a web page.

If you publish a web page containing the Java viewer, you must be sure to copy ptviewer.jar and ptviewer.class, if present, to your web site.


top


 

Note for users of V3

The Panorama Factory V3 required you to extract the ptviewer.class file from the ptviewer.jar file.  Starting in V4, The Panorama Factory performs this extraction when needed, so it is no longer necessary for you to do this.  Note that ptviewer.class is needed for PTViewer version 2.5, but not for PTViewer version 2.7L2 or version 2.8.


top


 

References

This section contains references to web pages at other web sites.

1.   Prof. Helmut Dersch's website, www.fh-furtwangen.de/~dersch/.

2.   Mirror site 1, http://www.path.unimelb.edu.au/~dersch/.

3.   Mirror site 2, http://www.all-in-one.ee/~dersch/.

4.   Mirror site 3, http://home.no.net/dmaurer/~dersch/Index.htm.

5.   PTViewer 2.8 from Fulvio Senore, http://www.fsoft.it/panorama/ptviewer.htm.

NOTE: There is no guarantee that these web addresses will remain valid over time.  If they are no longer valid, please visit this same web page at The Panorama Factory website to check for updates: www.panoramafactory.com/help_hun/hid_ptviewer.html.


top



© 1999-2007, Smoky City Design, LLC
Updated: April 6, 2007