October 14, 2019                >>  home  >>  bermuda  >>  andrew  >>  projects  >>  panorama beek.info
beek.info
                   
3D View of Jobson's Cove and Warwick Long Bay

Bermuda (July 20, 2000 - 9:30 am)























Place mouse in window for instant viewer control or click and drag for more viewer control.
'A' or '+' zooms in and 'Z' or '-' zooms out.


The following panoramic image was used to generate the 3D effect. The panoramic image was created by stitching together 22 640x480 images.




PanPreviewer and PanViewer Java Applets Documentation

Introduction
The PanPreviewer (Version 4.1) and PanViewer (Version 2.2) Java applets, enables the previewing and viewing of panoramic image content within Java-enabled Web browsers without a plug-in (like the QuickTime VR plug-in or the LivePicture; Viewer plug-in). Java applets provide the key features demanded by Internet users viewing panoramic imagery and by Internet developers creating content utilizing panoramic imagery. Key features include a very small applet size for rapid download, an intuitive and simple user interface, and a configurable splash-screen. See examples HERE.

The Classes
The PanPreviewer Java class implements a PanImage pre-viewer providing users with a controllable thumbnail-sized view of panoramic imagery prior to launching a pan/tilt/zoom viewer. The PanViewer Java class implements a pan/tilt/zoom viewer.

Both applets display horizon-centered panoramic content and present a simple "no-click" view-controlling interface requiring no training or understanding of existing viewers. When the mouse is over the applet, views of the panoramic imagery change with the location of the mouse. Furthermore, both applets can begin actively panning the panoramic imagery when initialized in a Web browser.

The PanPreviewer, packaged as a 6Kb ZIP file, displays a view without perspective correction. Typically, the PanPreviewer presents a glimpse of what the user sees when opting to view a panorama. Viewing a panorama requires a longer download due to the PanImage size being many times larger. For example, the source PanImage supporting a 96x96 preview is 4-6Kb in size.

The PanViewer, packaged as a 14Kb ZIP file, is a fully capable pan/tilt/zoom viewer. In order to keep download time to a minimum, the applet does not provide support for hot spots and node connections. For most Internet panoramic presentations, hot spots are unnecessary.

PanPreviewer
Considerations

We recommend a square view for the PanPreviewer. Typically, we use view dimensions of 64x64 or 96x96 with respective PanImage dimensions of 232x64 or 384x96.

The PanPreviewer applet draws a single pixel border around the view. So, when specifying the size of the applet to the HTML APPLET tag, add two pixels to each dimension to the desired view size.

Applet Parameters

PanImage (required parameter)
Specifies the absolute or relative URL of the source panoramic image.

ActivateURL
The absolute or relative URL displayed using the showDocument() method of Java's AppletContext class for linking an HTML page to a mouse click inside the applet. Typically, this targets an HTML page with a full viewer such as the PanViewer.

See the Java documentation for more information about the showDocument() method of Java's AppletContext class.

ActivateTarget (default is "_top")
Indicates the target given to the showDocument() method of Java's AppletContext class when given an ActivateURL parameter.

See the Java documentation for more information about the showDocument() method of Java's AppletContext class.

AutoSpin (default is 1)
Specifies how fast the applet begins panning upon its initialization. Negative values will pan right to left and positive values will pan left to right.

InitialView (defaults to 0)
This sets offset, as a number of pixels, into the source image when initialized.

PanViewer

Considerations

The width of the view must be a multiple of 32 and the height of the view must be a multiple of 16. We recommend view dimensions of 352x244 and a 1392x384 PanImage.

Using more than one of these applets on a single HTML page can be a problem for some older Web browsers due to the memory requirements of the original PanImage. Newer browsers can handle extended memory demands better than older browsers can.

Placing the mouse over the applet takes control of the view. For more control, the user can click and drag the mouse like traditional viewers. To zoom in, use the 'a' or '+' key. To zoom out, use the 'z' or '-' key.

Parameters

PanImage (required parameter)
Specifies the absolute or relative URL of the source panoramic image.

PanImageWidth (required parameter)
Specifies the width in pixels of the PanImage.

PanImageHeight (required parameter)
Specifies the height in pixels of the PanImage.

AutoSpin (default value is 0)
Specifies how fast the applet begins panning upon its initialization. Negative values will pan right to left and positive values will pan left to right.

BackgroundImage
An image into which the view will be generated and then displayed. The ViewX, ViewY, ViewWidth, and ViewHeight parameters control the location of the view.

ViewWidth (defaults to applet width)
Specifies the width in pixels of the view. It must be a multiple of 16.

ViewHeight (defaults to applet height)
Specifies the height in pixels of the view. It must be a multiple of 32.

ViewX (defaults to 0)
The X dimension offset of the view into the background image that shifts the view to a specific location inside the background image.

ViewY (defaults to 0)
The X dimension offset of the view into the background image that shifts the view to a specific location inside the background image.

InitialView (defaults to 0.0, 180.0, 1.0)
The parameter specifies the initial view of the applet upon initialization. The first comma-separated entry is the vertical angle of view in degrees with the horizon view being 0.0. The second comma-separated entry is the horizontal angle of view in degrees with the left-most edge of the PanImage being 0.0. The third comma-separated entry is the zoom factor that typically ranges from 0.6 to 2.0.

elevUp (defaults to 50.0 degrees)
elevDn (defaults to -47.5 degrees)
These indicate the maximum and minimum elevations represented by the PanImage. If the number is between -1.0 and 1.0, then its assumed the elevations are being specified in radians.

LogoImage
The absolute or relative URL of a GIF image displayed on a white background at the center of the view for at least two seconds while the panoramic image is loading. Use of this parameter requires that a valid Be Here Logo Authorization Key be provided to the LogoKey parameter.

LogoKey
The 16 character Be Here Logo Authorization Key available from Be Here Corporation.



Copyright 2007 Andrew Beek  beek.info