IMap Applet Usage Notes - Version 1.5

Installing
Use the following steps to install the applet:

  1. You will need these four files, if you are new to using Java applets you should place all four in the same directory on your server:

    • IMap.class
    • IMapArea.class
    • A .gif or .jpg image file for your image map.
    • An html page.

  2. Copy both executable files, IMap.class and IMapArea.class, to the your server directory. Make sure the files are named exactly as shown (Java is case-sensitive).

    If using FTP to copy the files to your server, be sure to specify binary as the transfer mode.

  3. Create an HTML page with the necessary <APPLET> and <PARAM> tags. The example below shows the tags and values used on the demonstration page:

    <applet code="IMap.class" width=500 height=300>
    <param name="mapimage" value="main.gif">
    <param name="fgcolor" value="#0000cc">
    <param name="bgcolor" value="#ffffcc">
    <param name="border" value="2,#990000">
    <param name="font" value="helvetica,bold,12">
    <param name="margins" value="15,15">
    <param name="outline" value="black">

    <param name="shape-1" value="rect,30,10,150,50">
    <param name="url-1" value="params.html">
    <param name="text-1-1" value="Click for a description of the">
    <param name="text-1-2" value="parameters used by this applet">
    <param name="text-1-3" value="along with the source code and">
    <param name="text-1-4" value="classes.">

    <param name="shape-2" value="ellipse,60,150,40,70">
    <param name="url-2" value="ellipse.html,msg">
    <param name="text-2-1" value="An example of an elliptical area.">
    <param name="text-2-2" value="">
    <param name="text-2-3" value="Format:">
    <param name="text-2-4" value="1|ellipse,x,y,a,b">

    <param name="shape-3" value="circle,155,210,35">
    <param name="url-3" value="circle.html,msg">
    <param name="text-3-1" value="An example of a circular area.">
    <param name="text-3-2" value="">
    <param name="text-3-3" value="Format:">
    <param name="text-3-4" value="1|circle,x,y,r">

    <param name="shape-4" value="rect,210,70,270,160">
    <param name="url-4" value="rectangle.html,msg">
    <param name="text-4-1" value="An example of a rectangular area.">
    <param name="text-4-2" value="">
    <param name="text-4-3" value="Format:">
    <param name="text-4-4" value="1|rect,x1,y1,x2,y2">

    <param name="shape-5" value="poly,230,200,320,220,380,150,450,280,310,260,220,290">
    <param name="url-5" value="polygon.html,msg">
    <param name="text-5-1" value="An example of a polygonal area.">
    <param name="text-5-2" value="">
    <param name="text-5-3" value="Format:">
    <param name="text-5-4" value="1|poly,x1,y1,x2,y2,...,xn,yn">

    <param name="shape-6" value="rect,350,90,420,120">
    <param name="text-6-1" value="This area has no hypertext link">
    <param name="text-6-2" value="associated with it but still displays">
    <param name="text-6-3" value="a text pop-up box when active. This">
    <param name="text-6-4" value="can be useful for adding help or tips">
    <param name="text-6-5" value="to your image map.">

    <param name="shape-7" value="poly,260,50,420,50,420,10">
    <param name="url-7" value="notext.html,msg">
    <param name="status-7" value="This link has no text pop-up but may still be clicked.">

    <param name="shape-8" value="poly,25,255,90,255,170,290,25,290">
    <param name="url-8" value="status.html,msg">
    <param name="status-8" value="This message replaces the link URL that is normally displayed.">
    <param name="text-8-1" value="You can also specify a message to display in">
    <param name="text-8-2" value="the status window when the link is active.">

    </applet>

    The WIDTH= and HEIGHT= attributes of the <:APPLET> tag should be set to the width and height of your map image. See the parameter descriptions for details.

  4. Copy your page and the map image to the server directory.

  5. Start your browser and enter the URL of your HTML page. The applet should load and run.
Troubleshooting
The applet does not load.

Make sure you have both .class files stored in the same directory as your HTML page and that they are named correctly. Also, the CODE= attribute in the <APPLET> tag should be set to "IMap.class".

The applet loads and starts but the map image never appears, it just says 'Loading image map...'

Make sure your image file is stored in the same directory as your HTML page and that the file name matches the value of the mapimage parameter (including upper- and lower-case characters). You can check this by entering the URL address directly in your browser. If the image does not appear in your browser window then the applet won't be able to access or display it either.

The applet runs but no text pops up.

Check your shape-i parameters. The first value should be the shape type followed by the correct number of coordinates. All values should be separated by commas with no spaces between values.

Some areas display the pop-up text but others don't, or some lines of text are missing.

Check the numbering of the shape-i and text-i-j parameters. The numbers should always start with 1 and run consecutively. This is because the applet looks for these parameters in numeric order, starting at one, then two, etc. It stops once a numbered parameter is not found.

I'm using frames. How do I make a link load in a particular frame?

Add the frame name to the value of the url-i parameter for the link, after the url and separated by a comma (see the example code above). Again, don't add any spaces between the values.