Revision 3
General:

Copyright: Gabriel (txwudi@mbox2.singnet.com.sg)

ImageGallery Version 1.27

ImageGallery.html is included for testing of outlook. No pictures are
attached.

Two class files: ImageGallery.class and GalleryCanvas.class

Pictures are now drawn to the applet only when the pictures have completed
downloading, this give a better outlook.

-----------------------------------------------------------------------------
Starting up:

An applet which retrieved pictures and displayed on the applet's canvas.
Save the trouble of going from one page to another.

The html tag for the applet is:

<applet code="ImageGallery.class" width=?? height=??>
<param name=number value=??>
<param name=thename value="??">
<param name=format value="??">
</applet>

Do not specify GalleryCanvas.class, the ImageGallery.class will search for
the class itself

All the parameters above must be specified.
'number' is the number of files to be retreived.
'thename' is the files' names
'format' is the file format (jpg or gif)

Example 1: Files are pic1.gif, pic2.gif, pic3.gif and pic4.gif

<param name=number value=4>
<param name=thename value="pic">
<param name=format value="gif">
Note: first file must start with the number 1 not 0.

Example 2: Files are picture1.jpg, picture2.jpg, picture3.jpg, picture4.jpg 
and picture5.jpg

<param name=number value=5>
<param name=thename value="picture">
<param name=format value="jpg">

-----------------------------------------------------------------------------

Features:

Can have as many pictures as you like, and don't worry. The files are
retrieved in intervals of 10 seconds or you can specify yourself by using
this parameter <param name=delay value=??>. Value must be in terms of seconds
default is 10 sec.

-----------------------------------------------------------------------------

Images are now not resize to the applet's size.
EG: If image 1 has the longest width of 350, the applet's width will be 360
and if image 1 does not has the longest height but image 2 has the longest
height of 450, the applet's height will be 490. Therefore the applet size is
360x490. Your html tag is:
<applet code="ImageGallery.class width=360 height=490>

-----------------------------------------------------------------------------
Color:

12 default colors are available for you

To set the canvas background, where the image is drawn:
<param name=canvasbg value="blue">

to set the background where the controls are:
<param name=controlsbg value="#feee40">

to set border color for the canvas:
<param name=canvasborder value="magenta">

to set main border color
<param name=border value="lightgray">

Values accepted are:
Black, blue, cyan, darkgray, gray, green, lightgray, magenta, orange, pink,
red, white and yellow.

Values are not case-sensitive.

You can also use hex values for colors, format is
<param name=bkcolor value="#ff0000">
'#' is to tell the applet to treat the following value as hex values.
This values are similar to HTML color coding

-----------------------------------------------------------------------------

New feature (Suggested by : Melissa Saenz, saenz@beat.ugcs.caltech.edu)
You can have title for each image. Just add in this tag to activate.
<param name=imgtitle value="true">
then,
<param name=title1 value="Good Image">
<param name=title2 value="Bad Image">
up till where the number of images to be displayed

(Thanx to Melissa for indirectly brainstorming me)
However, if your title is displayed in terms of numbers
include this parameter first:
<param name=titleinnumber value="true">
then add in this title parameter:
<param name=numbertitle value="Image">
this is to give a title for each image, which will be appended by the image
number.

Orientation and color:
To display the title on the top:
<param name=toptitle value="true"> (default)
on the bottom:
<param name=toptitle value="false">

To display title within image:
<param name=titleinimage value="true">
outside the image:
<param name=titleinimage value="false"> (default)

To have color:
<param name=titlecolor value="white">
same as the color definition

-----------------------------------------------------------------------------

Programmer: Gabriel
Home page: http://web.singnet.com.sg/~txwudi
Geocities: http://www.geocities.com/SiliconValley/Way/8870/

P.S: Applets has been tested on Windows 95, for other platforms' users,
please do the testing of size yourself.