Panorado Applet 2.2
- Technical Reference
The <applet> element and its attributes
Within a document's HTML source code, the Panorado applet is represented by a
These are the attributes of the
Remarks about the example:
If this file is not in the same folder as the refering HTML document, you have to
specify a relative or absolute path to it using a
The Panorado applet interprets these parameters, using a
The applet's methods
Remarks about the example:
The applet's name is "Viewer".
Returns version, licensing and environment information.
Returns a 2-dimensional text array with parameter informations. This is only supported by Mozilla browsers and some HTML generators.
Opens the panorado.com website in a new window.
Loads a new source image.
Loads a new source image.
returns the user-friendly image description.
returns the image's projection mode: "fast", "flat", or "spherical".
Returns the source image's horizontal FOV (in degrees).
Returns the source image's vertical FOV (in degrees).
Returns the source image's width (in pixels).
Returns the source image's height (in pixels).
Returns the visible image's horizontal FOV (in degrees).
Returns the visible image's vertical FOV (in degrees).
Returns the visible image's width (in pixels).
Returns the visible image's height (in pixels).
Resets the image to the initial direction, speed, and scale values.
Resets the image. Unlike
Changes the viewing direction by the specified values (degrees).
Sets the viewing direction to the specified values (degrees).
Changes the current scale by multiplying it with the specified value.
Sets the scale to the specified value (1=100%).
Sets the scale to the specified value (1=100%) while retaining the current cursor position.
Returns the current scale.
Sets the viewing direction degrees) and the scale to the specified values.
Returns the current horizontal viewing angle (0...360 degrees; left edge=0).
Returns the current vertical viewig angle (-90...+90 degrees; horizon=0).
Returns the current horizontal position of the mouse cursor (0...360 degrees; left edge=0).
Returns the current vertical position of the mouse cursor (-90...+90 degrees; horizon=0).
Sets the horizontal and vertical speed to the specified values.
Returns the current horizontal speed.
Returns the current vertical speed.
Enables or disables mouse and keyboard interaction (true=enabled, false=disabled)
Returns if mouse and keyboard interaction is currently enabled.
Sets the current mouse mode (true="grab", false="pan")
Returns the current mouse mode.
Shows or hides the compass scale (true="show", false="hide").
Returns if the compass scale is visible.
Deletes all existing track steps.
Creates a new track step.
Starts execution of the track list which has been previously set up from addTrack calls.
Defines if tracks are used, and if they are to be repeated. Options: "no", "once" oder "repeat".
Returns the way how tracks are to be used: "no", "once" oder "repeat".
Deletes all existing hotspots.
Creates a new hotspot.
Simulates clicking the specified index. i is a 0-based index.
Sets a custom hotspot image path, relative to the document path.
Shows or hides hotspots. (true="show", false="hide").
Returns if hotspots are visible.
Java and browser specifics
The applet version presented here has been tested on various versions of Microsoft Internet Explorer, Netscape, Mozilla Firefox, and Opera, using Java v1.4+ runtime environments.
We found out that the Netscape, Firefox, and Opera browsers were not able to handle resizing the height of applets at runtime correctly. If you want to use this feature on the other browsers, you should make a programmatic distinction to set the window parameters. This is illustrated for the sample page below.
The applet has some restrictions on Java runtime environments prior to v1.4 (which are getting rare). We recommend to inform visitors about the possibility of a free Java update.
The Java VM's default settings allow each VM instance to use a maximum of 64MB.
This is sufficient for images up to 3000x1500px with a color depth of 24 bits.
Sun Java v.1.6.0_10 (available since Oct. 2008) introduced a new parameter which enables applets
to request more meomory.
Thus, for displaying larger images, we recommend to insert a new element within the
Information about Java applet security is available on the Sun Developer Network website.
Some popup blockers can prevent the applet from opening a hotspot link in a new window. You can avoid this only by disabling the popup blocker temporarily or permanently, or by implementing the popup as an IFRAME element.
We like to present three sample HTML pages for illustrating how the applet can be integrated.
Please start with opening the first page. Here the applet is right in the middle of a page, surrounded by text
elements. The applet is intended to show only one single image. As you will learn later, this
requires a simple
Calling the second page from a link on the first page will require some
indicating which image is to appear in that page's popup window. The second page receives the
The third page demonstrates the use of hotspots.
Source code - first sample page:
Please skip the
There you'll find the
There are many more parameters for the applet than those used here. The applet will use default values if parameters are not specified.
The next element is a
If you click on the links at the bottom of the page, this will activate the second
sample page in a popup window. Since we want to determine the window's appearance in some
detail, we don't just use a
This function's code is in the header section of the page. It computes some window parameters which depend on the screen size and the kind of browser used, and then opens a popup window showing the second sample page. Please note that a question mark and the name of the image file is appended to the page's URL. This is the usual way to pass parameters to a HTML document.
Source code - second sample page:
This page basically contains a viewer applet and some buttons, much like on the first
sample page. But strange enough, the
The image will be loaded as soon as the whole page is loaded. This is signaled by an
That's all. Almost. We still like to notify you about the width and height attributes
Source code - third sample page:
The hotspots inside the image are intended to provide textual information. When a hotspot which is assigned a link is clicked, this link will be executed.
Unlike on the other sample pages, the elements for switching hotspots on and off are
This page also demonstrates the use of an event handler function:
When the user clicks on a hotspot symbol, this can launch different activities:
Mouse and keyboard interaction
Clicking on the applet moves the input focus to it. This allows you to control the viewer...
...using the mouse:
...using the keyboard: