This applet may not be distributed for profit or on CD without the express written consent of the copyright holder. The applet and documentation are Copyright 1998-1999 Lithic Software Corporation, all rights reserved.  For updates go to:
http://www.lithic.com/java/java.html
 
This readme covers the following topics:
Using Mesaverde
Parameters
License
Help/Consulting

Using Mesaverde:

If the applets and images are located in a different directory than the web page, you will need to include a codebase modifier. The size (width and height) of the applet should match the size of the image you are using for the background.  The image should be in the codebase.

When you upload this or any applet, you need to use binary mode rather than ASCII mode.  Binary mode is the default mode for a lot of FTP clients, so generally just upload as normal.  The parameters are discussed below.  An example file is included.  If you are going to use Appletviewer, you should remove the ARCHIVE reference in the applet tag (appletviewer seems to have a problem with jar files).

Parameters:

Software which makes the task of creating the tag easier will available from a link on http://www.lithic.com/java/mesaverdeaid.html
when it is completed.  A client side image map editor can be used to map out hotspots in a similar format to the ones used by Mesaverde.

There are two categories of parameters, those that let the end user control the drawing of the map, and those that control the hot spot coordinates/size and the items shown in the floating menu.

<APPLET CODE="mesaverde120.class" ARCHIVE= "mesaverde120.jar" width=397 height=393>
The height and width should match the height and width of the image you are using.

Rendering the Map
<PARAM NAME=loading VALUE="Loading Image...">
This prints while the image is being loaded, included to support languages other than English.

<PARAM NAME=map VALUE="canyon.gif">
This is the image that is used as the background.  You can use any image you want, but the width and height of the image and the width and height of the applet should match.

<PARAM NAME=background VALUE="FFFFFF">
<PARAM NAME=canvas VALUE="FFFFFF">
<PARAM NAME=menu VALUE="">
<PARAM NAME=text VALUE="000000">
<PARAM NAME=link VALUE="0000FF">
<PARAM NAME=menuborder VALUE="000000">
All of these are hex colors.  The first two affect the canvas on which the map is drawn, the others control the colors used to render the menu.

Hotspots and Floating Menus
<PARAM NAME=1 VALUE="RECT 0000FF FF0000 171,258,17,29">
<PARAM NAME=1-1 VALUE="Lithic Software Corporation http://www.lithic.com/">
<PARAM NAME=1-2 VALUE="Incubator Services .">

<PARAM NAME=2 VALUE="POLY 0000FF FF0000 20,82,20,82,18,83,17,83,15,84,14,85,12,86,11,87,10,88,9,89,9,91,8,92,8,94,8,95,8,96,8,98,8,100,8,102,8,103,8,109,9,111,10,113,10,119,12,121,13,123,15,125,17,127,19,129,21,130,27,131,29,132,30,133,32,134,33,135,34,136,35,136,37,137,39,138,40,138,41,139,43,139,45,140,47,141,49,141,50,142,51,142,52,142,53,142,54,142,55,142,56,142,58,142,60,142,61,142,62,141,64,140,65,139,67,139,69,138,70,137,72,136,73,135,74,133,75,132,75,131,75,130,75,129,75,128,76,126,76,125,76,123,76,122,76,121,76,120,76,118,76,117,75,111,74,110,73,104,73,104,20,82">
<PARAM NAME=2-1 VALUE="Connected Lakes State Park http://www.lithic.com/">
<PARAM NAME=2-2 VALUE="Colorado Park Service .">

The hotspots must be numbered sequentially starting from 1.  The three options are RECT, POLY, and CIRCLE.  The format for the values of the three different options are as follows:
RECT COLOR COLOROVER TOP,LEFT,WIDTH,HEIGHT
CIRCLE COLOR COLOROVER CENTERX,CENTERY,RADIUS
POLY COLOR COLOROVER VERTEX1X,VERTEX1Y,VERTEX2X,VERTEX2Y,.....VERTEX1X,VERTEX1Y
Note that commas without a space coordinates.  The polygon should be closed. The colors can be any hex value that is legal for a color (00000 through FFFFFF).

The options that appear in the floating menu when you go over a hotspot are listed sequentially under that hotspot.  The values for the options begin with the descriptive text, and end with the URL.  If there is no URL, use a "."

If you do not want to outline a hotspot, use a "0" for the COLOR, COLOROVER, or both.

If you want to imbed one hotspot within another, the one that is surrounded should be listed in the parameter list earlier that the surrounding hotspot.
 

License:
This applet is free for use on personal sites.  The binary code may not be modified or decompiled.

The Mesaverde applet may not be distributed as part of a collection of applets without a license agreement from the copyright holder.

The Mesaverde applet may not be used on commercial sites (here defined as sites that are used for financial gain) without authorization from the copyright holder.

For information on licensing and customization, please contact java@lithic.com

Help/Consulting
Consulting, help with the parameters, customizing, and programming are available for a fee from Lithic Software Corporation.  To contact Lithic Software, email to consulting@lithic.com

If you have a bug to report, please send it to John Keogh at keo@lithic.com.