ImageShow 1.07a
© Created by RJHM van den Bergh
My Server http://alpha.comweb.nl
Homepage http://alpha.comweb.nl/~rvdb
All Rights reserved

Introduction:
This applet fades a series of Images.
All images can be linked with an url.
Images supported are jpg and non animated gifs
The applet was originaly written in 1997 and had a revision in June 2000.

Disclaimer:
The use of this applet is at your own risk.

Installation:
1: Upload the three class files to your providers computer
(ImageShow.class , MyObserver.class , FadeFilter.class)
You must upload them as binairy files otherwise they could get currupted
2: Upload your images also to your providers computer
(only jpg and gif are supported)
3: Insert the applet tags in your html page and edit them.
The applet tags are described below.
4: Upload your edited html page to your providers computer
Note:You must place all in the same directory


Installation:
First of all here is an example of all the tags.
You should insert them between the <body> and the </body> tag
<APPLET CODE="ImageShow.class" WIDTH="230" HEIGHT="182">
<PARAM NAME="image_1" VALUE="welcome.gif">
<PARAM NAME="image_2" VALUE="ImShow2.gif">
<PARAM NAME="image_3" VALUE="ImShow3.gif">
<PARAM NAME="image_4" VALUE="ImShow4.gif">
<PARAM NAME="image_5" VALUE="ImShow5.gif">
<PARAM NAME="bgcolor" VALUE="#00000">
<PARAM NAME="fade_color" VALUE="#000000">
<PARAM NAME="text" VALUE="#FFFFFF">
<PARAM NAME="barcolor" VALUE="#FF0000">
<PARAM NAME="border_outside" VALUE="#FF">
<PARAM NAME="border_inside" VALUE="#00">
<PARAM NAME="frames" VALUE="15">
<PARAM NAME="frame_delay" VALUE="50">
<PARAM NAME="showtime" VALUE="5000">
<PARAM NAME="hidetime" VALUE="1000">
<PARAM NAME="bordersize" VALUE="25">
<PARAM NAME="loop" VALUE="true">
<PARAM NAME="url_1" VALUE="http://www.comweb.nl/~rvdb">
<PARAM NAME="target_1" VALUE="_blanc">
<PARAM NAME="url_5" VALUE="mailto:sales@comweb.nl">
</APPLET>

<APPLET CODE="ImageShow.class" WIDTH="230" HEIGHT="182">
This is the applet starting tag
It tells the browser the applet size.
Also it tells the applet program name in this case ImageShow.class
. (Don't set a path at the CODE attribute)
(It only is only used to tell the browser the class file name not a path).

<PARAM NAME="image_1" VALUE="welcome.gif">
<PARAM NAME="image_2" VALUE="ImShow2.gif">
<PARAM NAME="image_3" VALUE="ImShow3.gif">
<PARAM NAME="image_4" VALUE="ImShow4.gif">
<PARAM NAME="image_5" VALUE="ImShow5.gif">
Well here you tell the browser which images to use
They are expected to be in the same directory as the html page
Only gif and jpg are supported
You can use as many as you want as long as you start counting with 1

<PARAM NAME="bgcolor" VALUE="#000000">
The background color of the applet
This is an RGB color notation
(Note that it starts with a # sign)
I'll Explain the RGB color natations after the applet tags

<PARAM NAME="fade_color" VALUE="#000000">
This is the color the pictures fade to
I'll Explain the RGB color natations after the applet tags
(Note that it starts with a # sign)

<PARAM NAME="text" VALUE="#FFFFFF">
This is the Color of the text that shows up when the applet is loading.
If you don't want it to show up equal it to the bgcolor parameter.
I'll Explain the RGB color natations after the applet tags
(Note that it starts with a # sign)

<PARAM NAME="barcolor" VALUE="#FF0000">
When loading the applet is showing a loading bar.
You can use this parameter to give it a color.
I'll Explain the RGB color natations after the applet tags
(Note that it starts with a # sign)

<PARAM NAME="bordersize" VALUE="25">
<PARAM NAME="border_outside" VALUE="#0000FF">
<PARAM NAME="border_inside" VALUE="#000000">
As option you can use a border
Parameter bordersize should be obvious.
This applet supports multi colored borders
The colors slowly fade from the inside color to the outside color
I'll Explain the RGB color natations after the applet tags
(Note that they starts with a # sign)

<PARAM NAME="frames" VALUE="15">
<PARAM NAME="frame_delay" VALUE="50">
Well the picture are drawn in a number of frames.
Parameter frames determines the number of frames used.
Paramter frame_delay is a delay time in miliseconds between each frame draw
My advise is not to set it below 10 ms.

<PARAM NAME="showtime" VALUE="5000">
<PARAM NAME="hidetime" VALUE="1000">
Well you don't want a finished picture just to disappear directly
People should admire your picture first before it disappears
You can use the paramter showtime for that (miliseconds).
Also when its disapeared you set a delay time before it starts appearing again
This is where the parameter hidetime is for

<PARAM NAME="loop" VALUE="true">
Well simple you want the images to play once or loop infinite

<PARAM NAME="url_1" VALUE="http://www.comweb.nl/~rvdb">
<PARAM NAME="target_1" VALUE="_blanc">
<PARAM NAME="url_5" VALUE="mailto:sales@comweb.nl">
You can link each picture to a web page or email address
Also you can give use it with html frames
Set the html frame name with the target_x paramater
(x is here of course your picture number).

</APPLET>
Don't forget this one
Its the applet ending tag


The RGB color notation:
This applet uses the RGB color notation.
It doesn't suport color names.
Simply because that will be a lot of names.
(remember that your computer supports more than a miljoen colors).
An RGB color notation starts with a # sign (otherwise its a decimal number).
The advantage is that you can mix colors with it.
The first two digits are the color red.
The middle two the color green.
The right most two the color blue.
As you perhaps have seen it uses some strange digits like F,E, etceteras.
Wel this is because these number are haxadecimal numbers not decimal numbers.
(The reason computers can only count to one remember :-) )
Well decimal numbers hava a range of [ 0,1,2,3,4,5,6,7,8,9 ]
When quite simply hexadecimal numbers have a range of [ 0,1,2,3,4,5,6,7,8,9,A,B,C,D,E,F ]
The more you add the lighter the color wil be
For example #FFFFFF = white and #000000 equals black
Some more examples
#AAAAAA = some gray value
#999999 = some darker gray
#FF0000 = red
#5A0000 = some darker red
#00EE00 = some green color
#789A00 = some mixture of red and green
RGB color notations are also used with the BGCOLOR attribute of the <body> tag
So a good html book will explain them also

History:
- Version 1.01 some synchronization problem solved.
- Version 1.02 some synchronization problem solved.
- Version 1.03 synchronization with the system improved.
A repaint called by the system caused an ArrayIndexOutOfBoundsException.
Also a small increase in performance was obtained.
- Version 1.04 the synchronization problem solved in Version 1.03 still existed in the Netscape Communicator 4.03
Possible because this browser uses a different allogritme as Version 4.0 betta.
The synchronization has been further improved no synchronization errors where encountered anymore.
- Version 1.05 NullpointerException reported.
After close examination of the code the cause was revieled.
fixed.
Another bug was found also
Netscape does have the nasty habit of calling the stop() and start() methode after a window redraw.
This did cause the applet to restart at picture 1.
A program monitor was added for this.
Now after html page redraw the applet more or less continues where it was left.
- Version 1.06 not a bugfix but the possibelity to add a link on each picture is added.
People now can click on an picture to let the browser go to another url.
Also html frames supported was added
You will have to use a seperate applet tag for that
See applet parameter target
- Version 1.07a The applet is now updated.
A long time nothing was done with this applet.
Improvements are:
-- Upgraded to Java 1.1.x Event handling model.
Disadvantage the very very old applets do only support Java 1.02
But Less than 1% still uses these very old browsers
The event model of Java 1.02 is depriciated and there is a good change it will not be supported in the future.
-- A great performance gain was added on startup.
An empty while loop was discovered end eliminated.
(Used for waiting on an event.)
Due to beter knowledge of the Java threading system also some more improvements where added.

Report bugs.
Well if you found one please report it.
We can't test all browsers and configuration
It also can be that you did something wrong
Anyway if you think its a bug please report it !
Please use our bug form at http://alpha.comweb.nl/others/debugForm.html


Also graphical design © Copyright by Comweb , All Rights Reserved.
Chamber of Commerce 09107249
Tax number NL 163775874B01
Aldenhof 67-24 , 6537 DC Nijmegen , Netherlands
Tel/Fax +31 (0)243447541
PostBank Account 8359163 , swiftcode INGBNL2A
sales@comweb.nl