readme

JavaMapper是一个免费的Java应用程序

JavaMapper
Copyright (c) 1999 Dan Steinman


Installing JavaMapper
---------------------

You must have the JDK 1.1.x or JDK 1.2.x (http://java.sun.com) and a ZIP file
extractor installed on your system.

Extract javamapper-0.1.zip into an appropriate directory.  The file will 
extract to a subdirectory called ./javamapper and will contain the following:

classes		- directory containing precompiled classes
example		- directory containing example imagemaps produced with JavaMapper
src		- directory containing the .java source files
ABOUT		- JavaMapper version and copyright information
LICENSE		- a copy of the GNU General Public License (GPL)
README		- instructions on using and installing JavaMapper (this file)
compile-jikes.sh	- unix shell script for compiling with IBM Jikes
compile-unix.sh	- unix shell script for compiling with Sun JDK
compile-win.bat	- windows batch script for compiling with Sun JDK
javamapper.bat	- windows batch script for running JavaMapper under Windows
javamapper.sh	- unix shell script for running JavaMapper under Unix

In order to use the scripts to compile and run JavaMapper you must edit the 
appropriate file so that it points to where you installed your JDK.  For 
example if you run Windows and your JDK is installed in C:\jdk\ you will 
edit "javamapper.bat" so that the "-classpath" parameter is set to 
"C:\jdk\lib\classes.zip;.\classes" before executing the script.

I highly recommend using IBM's Jikes Java compiler (http://www.alphaworks.ibm.com), 
it compiles JavaMapper in about half a second on my machine compared to 5-10 
seconds with Sun's JDK.


Using JavaMapper
----------------

JavaMapper is designed to quickly and easily create imagemaps for use in web 
pages.  It will be self-explainitory if you've made an imagemap before.

First start by opening up an existing image.

Trace shapes in your image using one of the shapes available (rectangle, 
circle, and polygon).  you select a different shape from the Tool menu.  The
rectangle and circle usage should be instinctive to you - just click somewhere
on your image, and while holding down the mouse drag over a certain amount to
draw your shape and then release your mouse to finalize the position, and to
draw the next shape.  For the polygon you must click down for each of your
points, for your final point you can double click to end the polygon shape.

The Select Tool is a pointer for for the shapes that you've drawn.  By 
moving your mouse across the shapes it will highlight the shape that will 
be activated when you click it - this is helpful if some of your shape 
areas overlap.  If you click on a shape you can then move it around or resize
it by moving the square nodes on the corners.  For the polygon, if you click
and hold onto one of the nodes for 1 second a popup will appear where you can
delete that point, or insert another point.

There are 3 windows that you can open up at any time to give you more
information about your imagemap:

Preview Client-Side Map:
   Will give you a preview of what will be the output if you save as a 
   client-side imagemap

Preview Server-Side Map:
   Will give you a preview of what will be the output if you save as a 
   server-side imagemap

Map Properties:
   this is where you'll set the url that the user will be taken to when 
   they click on an area.  You can also give a name to each of the areas 
   and save name along with the client-side map if you check the checkbox 
   at the bottom.

These windows will always be in synch with the main window so you can
see your changes immediately.

When your imagemap is complete save it either as a client-side or server-side 
map.  Client-side will output the HTML tags so that you can insert the imagemap 
in your webpage directly.  Server-side will output the server .map file that 
will reside on your server.


Possible Future Features
------------------------

When I get the time I plan to add:

- Swing (JDK 1.2) components for a nicer UI
- editing existing imagemaps
- zoomed view of image
- grid lines of some sort
- configurable tool colors
- manual editing of coordinates
- copy/paste shapes

Any comments, suggestions, and code improvements can be sent to:

Dan Steinman
[e-mail]
www.dansteinman.com


* Java, JDK, are trademarks of Sun Microsystems, Inc.
* Jikes is a trademark of IBM Corp.