BANNER DISPLAY

What does it do?

The BannerDisplay applet reads a list of image locations from a text file or parameters in the HTML page, and displays images (either .jpg or .gif files) in one of four ways:
1. randomloop: loops continuously loading random images.
2. random: loads one random image and displays it.
3. orderloop: loops continuously loading images in order of list.
4. order: loads images one by one in order of the list, once only.

An image is loaded, then a pause before loading next image can be set. Next image loads in background while previous image remains visable, no pre-loading.

Each separate image can be set with URL link and configurable target frame. Applet background color is also configurable. The image displayed is automatically centered.

THE CODE...
=============

The following code can be cut and pasted into an HTML document. Make
sure that the BannerDisplay.jar file is placed within the same
directory as the HTML document that contains this code.


<APPLET CODE="BannerDisplay.class"
ARCHIVE="BannerDisplay.jar"
WIDTH="468"
HEIGHT="60">
<PARAM NAME="textfile" VALUE="text.txt">
<PARAM NAME="bgcolor" VALUE="000000">
<PARAM NAME="pause" VALUE="4000">
<PARAM NAME="style" VALUE="orderloop">
</APPLET>

NOTE:
=====

You can have the jar file installed in only one directory, so that
other pages that use the same applet won't have to load a separate
jar file per page.
Just add the "CODEBASE" attribute to the APPLET tag, and point it
to the directory containing the jar file...

<APPLET CODE="BannerDisplay.class"
ARCHIVE="BannerDisplay.jar"
CODEBASE="http://www.pikeus.co.uk/banners/"
WIDTH="468"
HEIGHT="60">

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


CONFIGURATION:
==============

Width and Height can be set to desired specification.


Text file layout...

The values for each list item are set out as:
"Location of image | URL | TARGET FRAME", and should all be
entered on a single line per image.

The "|" character (press "shift"+"\"), is used to separate
each item value:

http://www.pikeus.co.uk/banners/elk.gif|http://www.pikeus.co.uk|_blank
Local_file.gif|index.html|_self

NOTE: For unlinked images, specify URL as "nolink"...

banner.gif|nolink|_blank

NOTE: image location must always be followed by a URL and frame
target!

Blank lines are not allowed.

The following values set the target frame to load the specified
URL into:
"_self" - loads into current window.
"_parent" - loads into full current window if frames are used.
"_blank" - loads into a new window.
"framename" - loads into the name of the frame you specify.
If this parameter is left out then a default of "_self" will be used.


NOTE:
=====
When adding text within the applet parameters in the HTML page,
add the "^" character (press "shift"+"6") to the end of each
line. This means that you can't use the "^" character within the
text you wish to display. E.g.

<PARAM NAME="text" VALUE="
parameters.gif|parameters.txt|_blank^
pikeus.gif|http://www.pikeus.co.uk|_blank^
mailpikeus.gif|mailto:c@pikeus.freeserve.co.uk|_self^
unlinked.gif|nolink|_blank^">


Parameters include...

<PARAM NAME="bgcolor" VALUE="ff0000">
This sets the background color, and should be entered as a hexadecimal
value. If this parameter is left out then a default color of black
will be used.

<PARAM NAME="textfile" VALUE="test.txt">
Specifies the location and name of the text file to read information
from.
If this parameter is left out then the applet will not function.
If the value is set to "off" then it will force the applet to read
the text line from the "text" parameter.

<PARAM NAME="text" VALUE="Text lines go here...">
When the "textfile" parameter is set to a value of "off" then the
applet reads from the "text" parameter.

<PARAM NAME="pause" VALUE="4000">
Time in milliseconds (1000=1 second) to display freshly loaded
image before loading next image.

<PARAM NAME="style" VALUE="randomloop">
Sets the style of image display routine...
"randomloop" loops continuously loading random images.
"random" loads one random image and displays it.
"orderloop" loops continuously loading images in order of list.
"order" loads images one by one in order of the list, once only.