...upon choosing this product. Not only will it improve your health, and enhance your general spirituality, it will also clean the bath, cook you breakfast, take care of the children, end armed conflict and invigorate the look of your web page.

You should be careful to check that your unzipping program has named the files correctly. Some DOS programs will name according to the old 8.3 format, rename .class files "*.cla".

There is NOTHING to pay. The applet is completely free. However, if you make a donation ($5 - $10?) to Ty Hafan, Children's Hospice of Wales, which is a charitable appeal formed to build, equip and run a Children's Hospice in Wales to provide care for terminally ill children, you can consider your applet well-and-truly registered. Click here for details on how to make a donation.

To include PoolMenu in a web page, you should copy the PoolMenu.class Pool.class ImageMap.class file into the same directory as the web page and then insert an <APPLET...> tag into the page, e.g.

  <APPLET CODE="PoolMenu" WIDTH=226 HEIGHT=125>
  <PARAM NAME=image VALUE="poolmenu.gif">
  Put something here for browsers that don't use Java.
  </APPLET>

Parameters that can be passed to PoolMenu

<applet code="PoolMenu" width=226 height=125>
<param name=image value=poolmenu.gif>
</applet>

<applet code="PoolMenu" width=226 height=125>
<param name=image value=poolmenu.gif>
<param name=href value=http://www.demon.co.uk/davidg/spigots.htm>
</applet>

<applet code="PoolMenu" width=226 height=125>
<param name=image value=poolmenu.gif>
<param name=href value="http://www.microsoft.com">
<param name=target value="newframe">
</applet>

<applet code="PoolMenu" width=226 height=125>
<param name=image value=poolmenu.gif>
<param name=map value="MenuMap">
<param name=target value="newframe">
</applet>

<MAP NAME="MenuMap">
<AREA SHAPE="RECT" COORDS="0, 0, 100, 129" 
href="http://www.demon.co.uk/davidg/spigots.htm"
	alt="Clicking on the left will open up the spigots page">

<AREA SHAPE="RECT" COORDS="101, 0, 250, 129" 
href="http://127.0.0.1/davidg/lake.htm"
	alt="Clicking on the right will open up the lake page">
</MAP>

I'd suggest you put the class file in the same directory as the page on which it will appear. If you want to move it elsewhere then use the "CODEBASE" option to point to the appropriate directory.

Some implementations of Java will not allow you to put the .class file in one subdirectory and the image file in another. If the try it might cause a security exception.

Why won't the applet work off my hard disk?

Some web browsers have trouble opening applets straight from a hard disk. I have noticed this happen with Internet Explorer 3 and Netscape 4. Once you have loaded the class file and the web page onto your web site you should find it works OK.

Why does my web page say "Class Format Error"?

Class files are binary files, just like image files are. Binary files contain more information than text (also known as ASCII) files do. If you transfer class files as if they were ASCII files then they will lose this extra information and will become corrupted. How do you transfer class files as binary files? You should transfer them in the same way that you transfer image files.

Why does my web page say "Class Not Found"?

This is a very common problem. It may be because of one of the following:

1. You have not put the class file onto the web site
2. You are not calling the file with the correct name (rename to use the same combination of upper- and lower-case letters as your class file)
3. Your transfer program has changed the name. This does happen. Some programs will shorten the ".class" extension to ".cla". Other will change the case of the letters to either all uppercase or all lowercase. See if you can change the options on the transfer program to stop it doing this.
4. You have include a "codebase=…" clause inside your <applet…> code in your web page. "codebase=…" tells the browser to look some place else for the class file.
5. Some other reason I haven't thought of :-)

If you use this applet then it would be nice if you gave me a link by copying the image:

(this is the file "dglogo.gif" in the .zip archive) into the same directory as your web page and then pasting the following into your page.

    <a href="http://www.demon.co.uk/davidg/spigots.htm" target="_top">
    <img src="dglogo.gif"
          width=88 height=31 border=0></a>

It will put a little button on your page that will link through to my Java Spigots page.

It is only a request: feel free to omit it.

Remember that if you are transferring the .class file to another machine with FTP, you should set the 'binary' mode on. Failure to do so will corrupt the file and give rise to a "Class Format" error.

If you still have trouble getting the applet to work and you have tried all of the possible solutions listed above, then feel to contact me, remembering to include:

These two pieces of information will make it a lot easier for me to solve the problem. I cannot guarantee that I will be able to respond to all messages (there's only so many hours in the day...) but sending the URL of a page that doesn't work will greatly increase the chances of getting an answer.

Remember to keep a look out at my web site for new applets.

David Griffiths,

11/04/1999