Make your own free website on Tripod.com

Installation Guide for the Panorama Applet

Running the demonstration applet

Click on the file pan.zip. When the Winzip window appears click on the EXTRACT button. In the top left hand text field entitled Extract To: enter the directory where you want the Panorama files. Then click Extract on the top right hand corner. Inspect the directory to confirm the files have been extracted. The Winzip window can now be closed. To run the demonstration click on the file pan.htm and the applet will appear in your browser in a few seconds. The applet control buttons should be self explanatory.

Applet dimensions

The default dimensions of the applet are a WIDTH of 326 and a HEIGHT of 240. The HEIGHT of 240 includes 200 for the image height and 40 for the height of the control buttons. These values are set solely to fit the demonstration web page and can be adjusted to any size. However you will need to amend the HTML code for the layout of your text as necessary.

The dimensions of your image files

The width of the input image for each of the 4 scenes should be at least twice the value of the applet WIDTH parameter in order for effective scrolling to operate. The height of the image should be at least the height of the applet HEIGHT parameter. The demonstration version has a limit of 700 pixels on the total WIDTH of the images in any one scene. The registered version has no limit on the image dimensions. Secure online ordering is available from:

http://www.freezone.co.uk/philipmorgan/panorama/pan.htm or
http://bally.fortunecity.com/leitrim/13/SlideShow/SlideShow.htm

Creating panoramic images

For true panoramic scenes the extreme rightmost 326, or "applet width" number of, pixels of the image should duplicate the leftmost 326 pixels. When scrolling this will give the effect of a smooth continuously rotating image. If the applet width is different to the default value adjust the duplication as necessary.

An image editor will be required for cropping and resizing. Irfan View is an excellent freeware program which allows resizing to within a resolution of one pixel. It uses minimal space on a desktop so multiple copies can be run concurrently allowing inspection of several images at the same time.

An easy to use stitching facility is available in iPhoto Express. This allows you to join up your images seamlessly. This program is available from Ulead Systems.

Image compression

If you are uploading the applet to a web page it is important to keep the image byte sizes as small as possible. If they exceed, say, 100Kb in total your visitor may have to wait several minutes for them to download and may decide to leave your page. Image compression programs are widely available, many of them free. JPEG Imager is an excellent product and a free version is available from the following URL: http://www.geocities.com/vas_b/ji1rc.zip

Setting up the applet PARAMETERS

The VALUEs for the images are the names of your image files. They do not have to be named "image0.jpg" etc. as shown here. Acceptable image formats are JPG and GIF. The other basic PARAMETERS are:
  • speed - An unfortunate name! The higher the value the slower the scrolling will be. It actually refers to the wait interval in milliseconds between repaints of the image.
  • backgroundcolor - This uses the R(ed) G(reen) B(lue) hexidecimal coding for colours as used in HTML. ColorCode makes chosing colours for your web pages easy and may be downloaded from this site.

<APPLET CODE="pan.class" WIDTH=326 HEIGHT=240>
<PARAM NAME="image0" VALUE="image0.jpg">
<PARAM NAME="image1" VALUE="image1.jpg">
<PARAM NAME="image2" VALUE="image2.jpg">
<PARAM NAME="image3" VALUE="image3.jpg">
<PARAM NAME="speed" VALUE="50">
<PARAM NAME="backgroundcolor" VALUE="#FFFFFF">
</APPLET>

Additonal PARAMETERS

The following PARAMETERS allow you to turn off selected buttons in the control bar. Setting "showbuttons" to "no" will turn all the buttons off. If "numberbuttons" is set to "no" the buttons "1", "2", "3", and "4" are turned off. The remaining parameters refer to individual buttons.

<PARAM NAME="showbuttons" VALUE="on">
<PARAM NAME="numberbuttons" VALUE="no">
<PARAM NAME="firstbutton" VALUE="no">
<PARAM NAME="secondbutton" VALUE="no">
<PARAM NAME="thirdbutton" VALUE="no">
<PARAM NAME="forthbutton" VALUE="no">
<PARAM NAME="pausebutton" VALUE="no">
<PARAM NAME="slowbutton" VALUE="no">
<PARAM NAME="directionbutton" VALUE="no">
<PARAM NAME="fastbutton" VALUE="no">

Controlling Panorama from JavaScript

Using Javascript you can use buttons, textual descriptions or your own icons as interfaces to the applet. The registered version of Panorama includes full instructions and example HTML and JavaScript to enable the applet to be operated externally from Java.

Example Upload to a website

You will need an FTP program such as WS-FTP or Cute FTP. Trial or free versions of these programs can often be found on CDs provided with Internet monthlies. Windows 95/98 has an upload wizard which is quite easy to use. Upload the file pan.class, pan.htm and your image files to same directory on your website. In your homepage enter the following:
<A HREF="/directory_name/pan.htm">My Panorama Page</A>

Troubleshooting

When loading the applet it is recommended not to resize your browser until the applet and all images are loaded. There is the possibility of breaking the Java thread and disabling the scrolling function. If you have any problems with the Panorama applet send an email to: philipmorgan@freezone.co.uk and we will do our best to help. Thank you for downloading the Panorama applet.

Registration

The Panorama demonstration applet is fully functional and has no expiry date. There is a limit on the width of non demonstration images of 700 pixels. The registered version has no limits on image sizes and can be obtained from:

http://www.freezone.co.uk/philipmorgan/panorama/pan.htm or
http://bally.fortunecity.com/leitrim/13/SlideShow/SlideShow.htm

Last Updated: