P E G H O L E

presents

ImageMapConverter



What is ImageMapConverter?

ImageMapConverter is an Apple Macintosh application to convert ImageMap files, used in World Wide Web documents, to and from different formats.
It is very useful for converting old Server Side Imagemaps into the new Client Side Imagemap format which is incorporated in the HTML-code without the need to recreate the hotspot-areas. To insure compatibility with older browsers ImageMapConverter can also convert Client Side Imagemaps (Usemaps) into Server Side Imagemaps.

Where do I get ImageMapConverter?

ImageMapConverter is available through all Info-Mac sites. You can follow this link to the INFO-Mac Hyperarchives to find it.. Or this one to the AMUG sites in Arizona. Or finally, get it in Rotterdam, The Netherlands. The filesize is aproximately 680 K.
If you pay the shareware fee you'll get info about updates, FAT and Powermac versions, and the URLs where you can download them.


What does ImageMapConverter require to run?

ImageMapConverter should run on any Macintosh running System 7.x.x. It has been tested on a PowerMac 8100/100, PowerMac 7600, Performa 630 and a Quadra 700 with the following systems: System 7.1.1, System 7.1.2, System 7.5.1, and System 7.5.3.
It requires at least 1500 K of free application memory although 4500 K is recommended.

Special Features of ImageMapConverter:

  • Intelligent format recognition
  • Conversion of multiple files or whole folders
  • Conversion of ovals into polygons
  • Fully configurable Image Tag creation

More about Imagemaps

Imagemaps are basically clickable pictures. When the user clicks on the picture, he will be linked to different pages depending on where on the picture he clicked.
There are two flavours of imagemaps: Server Side Imagemaps and Client Side Imagemaps.

Server Side Imagemaps
Server Side Imagemaps are the oldest form of Imagemaps. As their name implies they reside on the server. Apart from the HTML file that describes the page there is a map file that describes the hotspots. As the user clicks on an Imagemap, the webbrowser sends the coordinates of the position of the mouseclick to the server. These coordinates are then compared with the actual mapfile (usually this happens by means of a CGI-script). This mapfile resides somewhere on the server. It defines the hotspots and the URLs of the pages that are linked to those hotspots. If the user really clicked a hotspot the URL is passed to the browser. There are two formats of Server Side Imagemaps: the CERN format and the NCSA format. CERN is the institute which originally developed the WWW,and NCSA is the creator of Mosaic, the first graphical browser.

Client Side Imagemaps or Usemaps
Client Side Imagemaps don't have to reside on the server. The hotspot and URL information is included in the HTML-document. One big advantage of Client Side Imagemaps is that you can view (and test) them locally. Other advantages are its improved speed and the fact that you can actually see if a certain area of a picture is a hotspot because the cursor changes and the URL is displayed in the browser. To support older browsers though, it is wise to include both systems.


Conversion Formats

Currently the following conversions are supported: NCSA to Usemap, CERN to Usemap, Usemap to NCSA and Usemap to CERN (Usemap is another name for Client Side Imagemap). If you want to convert a CERN imagemap to the NCSA-format (or vice-versa) you can do so in two steps: Convert the NCSA to Usemap and then convert this Usemap to CERN.

The specifications of the different formats

NCSA:

  • Hotspots are ordered from front to back
  • Default link as last entry
  • Every hotspot entry consists of area-shape, URL and coordinates
  • Possible area shapes are rect, circle, polygon, oval and point.
  • Syntax:
    rect URL left-x,top-y right-x,bottom-y
    Specifies a rectangular region defined by the pixel coordinates of the upper-left and lower-right corners of the region.
    circle URL center-x,center-y radius-x
    Specifies a circular region defined by the pixel coordinates of the center point followed by the radius in number of pixels.
    poly URL x1,y1 x2,y2 x3,y3 ...,...
    An irregular region defined by a series of coordinate (x,y) pairs.
    oval URL left-x,top-y right-x,bottom-y
    Specifies an oval region defined by the pixel coordinates of the upper-left and lower-right corners of the rectangle which touches the ovals extremes.
    point URL x,y
    Specifies a point defined by the pixel coordinates of the point.
    All coordinates are relative to the top left corner of the picture.
    URL is mostly an absolute Http address but in some cases (dependig on server) it can be relative to the current page.

CERN:

  • Hotspots are ordered from front to back
  • Default link as first entry
  • Every hotspot entry consists of area-shape, URL and coordinates
  • Possible area shapes are rect, circle and polygon
  • Syntax:
    rect (left-x,top-y) (right-x,bottom-y) URL
    Specifies a rectangular region defined by the pixel coordinates of the upper-left and lower-right corners of the region.
    circle (center-x,center-y) radius-x URL
    Specifies a circular region defined by the pixel coordinates of the center point followed by the radius in number of pixels.
    poly URL (x1,y1) (x2,y2) (x3,y3) (...,...) URL
    An irregular region defined by a series of coordinate (x,y) pairs.
    All coordinates are relative to the top left corner of the picture.
    URL is mostly an absolute Http address but in some cases (dependig on server) it can be relative to the current page.

USEMAP

  • Hotspots are ordered from front to back
  • NOHREF parameter if no link is specified
  • Every hotspot entry consists of area-shape, URL and coordinates
  • Possible area shapes are rect, circle and polygon
  • Syntax:
    <AREA SHAPE="RECT" COORDS = "left-x, top-y , right-x, bottom-y" HREF = "URL">
    Specifies a rectangular region defined by the pixel coordinates of the upper-left and lower-right corners of the region.
    <AREA SHAPE="CIRCLE" COORDS = "center-x , center-y , radius-x" HREF = "URL">
    Specifies a circular region defined by the pixel coordinates of the center point followed by the radius in number of pixels.
    <AREA SHAPE="POLY" COORDS = "x1,y1 , x2,y2 , x3,y3 , ..." HREF = "URL">
    An irregular region defined by a series of coordinate (x,y) pairs.
    All coordinates are relative to the top left corner of the picture.
    URL can be relative to the current page.

How does ImageMapConverter work?

The usage of ImageMapconverter is fairly straightforward.
Just click one of the Convert buttons:
if you've pressed the Convert File(s) button you will see the following Dialog window:

File Dialog

Go to the location on your harddisk where your mapfiles reside and select one or more mapfiles (or HTML files containing imagemaps) by pressing the add button or by double-clicking them. Then press"Done" and ImageMapConverter will start converting your files.

If you've pressed the Convert Folder buttons you will see the following Dialog window:

Folder Dialog

Go to the location on your harddisk where your mapfiles reside and select a folder with mapfiles in it. Then press "Select ..." and ImageMapConverter will start converting all mapfiles or HTML files it finds in that particular folder. If the folder contains textfiles which aren't mapfiles or HTML-mapfiles a requester will pop up stating that the file couldn't be processed.
The program displays both visual and audio feedback on the progress of the conversion. Again, if a file already exists a Save dialog will be displayed so you can save it under another name and/or in a different folder.
Apart from being saved to disk every converted file is also copied to the clipboard and can be pasted directly into your HTML document. Of coarse this is only useful if you converted one single file.


Setting the Preferences

In the Preferences screen of ImageMapConverter you can set the following user configurable preferences:

Preferences Screen
(Click on this Imagemap to go directly to the related text.)

HTML Output Options

Make Image-tag for GIF or JPEG-image
If you check this checkbox ImageMapConverter will make an Image-tag for the mapimage.
Example:
<IMG SRC="image.gif" ALT="" BORDER=0 USEMAP="#image.gif_MAP">

[ Back to Prefs picture ]

Make Width and Height Tag
If you check this checkbox ImageMapConverter will add a WIDTH and HEIGHT parameter to the Image-tag. Standard the values for these parameters are set to 0 so you better fill in the actual dimensions of the image yourself otherwise it will be very tiny! Example:
<IMG SRC="image.gif" WIDTH=0 HEIGHT=0 ALT="" BORDER=0 USEMAP="#image.gif_MAP">

[ Back to Prefs picture ]

Make Low Source Tag
If you check this checkbox ImageMapConverter will add a LOW SRC parameter to the Image-tag. This is useful if you want to put up a smaller version of your mapimage so your viewers don¹t have to wait so long before they can click. By default it is filled with the same imagename as the normal source so it does no harm if you don't change it.
Example:
<IMG SRC="image.gif" LOW SRC="image.gif" ALT="" BORDER=0 USEMAP="#image.gif_MAP">

[ Back to Prefs picture ]

Make Target Tag
If you check this checkbox ImageMapConverter will add a TARGET parameter to the Image-tag. This is useful if you want your imagemap to target the updating of other frames. By default it is filled with "_self" as the TARGET destination, which is the actual window, so it does no harm if you don't change it.
Example:
<IMG SRC="image.gif" ALT="" BORDER=0 TARGET ="_self" USEMAP="#image.gif_MAP">

[ Back to Prefs picture ]

Make reference to Imagemap
If you check this checkbox ImageMapConverter will add a link-tag around the Image-tag which points to your Server Side Imagemap. This is useful if you want to serve your imagemap to users who don't use the latest browsers. You need to change the pathname though.
Example:
<A HREF="Put_path_to_server-side-map-file_here"><IMG SRC="image.gif" ALT="" BORDER=0 TARGET ="_self" USEMAP="#image.gif_MAP" ISMAP></A>

[ Back to Prefs picture ]

Creator Code of Output Files

Here you can choose the Creator codes of the TEXT files that ImageMapConverter generates, so they will be automatically opened by your favourite HTML-editor when you double click them. To do this press the "Same as..."-button and select a file that has the desired creator code e.g. a file that is saved by that particular application.

[ Back to Prefs picture ]

Save Converted Usemaps in...

Select the format in which ImageMapConverter will export your converted Client Side Image Maps. This can be either NCSA or CERN. You have to consult your Internetprovider or system operator to find out what format they use on their webserver.

[ Back to Prefs picture ]


Filenames

ImageMapconverter uses the following naming scheme for filenames:
  • Converted files are always saved in the same folder they came from. If the filename already exists you are presented with a Save Dialog where you can select a different name and/or a different location for the saved file.
  • Converted CERN or NCSA mapfiles get the extension ".html". The mapfiles that where named image.gif.map or image.jpg.map will be saved as respectively image.gif.html and image.jpg.html. Other filenames just get the extension ".html" after the original name. If the original name plus the ".html" extension is too long for the Mac to display the original name will be truncated. If the original GIF or JPEG is in the same file as the converted mapfile you can simply open the output file in your browser to check the results.
  • Converted Client Side Imagemaps get the extension ".map". If your HTML document contains more then one Client Side Imagemap the different imagemaps are saved as separate mapfiles.


Paths

Although ImageMapconverter tries to be as intelligent as possible in resolving filenames and paths, its output files aren't perfect and you need to fine-tune them. You probably need to change the paths to your images from relative to absolute or vice versa. And since ImageMapconverter doesn't know the location of the CGI-script you use to process your Server Side Image Maps you'll have to add this path as well.

How can I test ImageMapConverter

There are some mapfiles provided with this application to test it. They are in the "testmaps" folder. You can also test ImageMapconverter ability to process HTML files with this documentation file. And of course you can test it with you own mapfiles.

Does ImageMapConverter correct my mapfiles?

Unfortunately ImageMapConverter isn't an intelligent creature. If your mapfiles in one format won't work on the Internet, chances are high that the converted mapfiles won't work either. On top of that you probably need to add or adjust some pathnames, sizes and the like to make converted Imagemaps work.

How much does ImageMapConverter cost?

ImageMapConverter is shareware: if you like it and continue using it, you should pay for it.

The cost is $10 for a single-user license, $200 for a site license (unlimited use at a single site), and $1000 for a world-wide site license (unlimited use at as many sites as you need). All prices and options are shown in the 'Register ImageMapConverter' application.


How do I pay for ImageMapConverter?

To register, run the 'Register ImageMapConverter' application, included in this package (or contact me and I'll send it to you), to fill out the registration form. Once you've filled it out, you have 3 options for paying:

1) Print it and send it, together with your payment, to Kagi at:

Kagi
1442-A Walnut Street #392-NL
Berkeley, California 94709-1405
USA

This address is also on the registration form that the 'Register ImageMapConverter' application prints.

2) E-Mail it by clicking "Copy" in the 'Register ImageMapConverter' application and pasting it into the body of your e-mail message to:

sales@kagi.com

3) Fax the registration form to this number:

+1 510 652-6589.

If you have any questions, don't hesitate to contact me at mare@kagi.com.

The payment options are shown in the 'Register ImageMapConverter' application. You can pay with cash (in many currencies), check, credit card (VISA, MasterCard, or AmEx), or various other forms of payment (check out the 'Register ImageMapConverter' application for other forms of payment).

ImageMapConverter has no protection scheme but when you pay, we will send you a serial number which you can enter into ImageMapConverter's register screen.
If you do not have an email address, please enter your complete postal address. And remember: we do not know what country you live in, so please add that to the postal address as well.

If you do not have an email address you should consider selecting the Postcard Receipt so that Kagi can inform you of your registration code. Kagi transmits the registration codes via email and paid postcard receipt only.


Can I distribute ImageMapConverter?

Yes, please do! You may distribute this application any way you want to, as long as you include the documentation and 'Register ImageMapConverter' application and do not charge for it. Reasonable media and distribution costs excluded. I want as many people to get this as possible.

Aren't you afraid people will use ImageMapConverter and not pay for it?

No. Obviously, there's no way I can tell if you're using this application without paying for it nor would I want to know. I do not believe in copy protection in any form for a number of reasons but, most importantly because copy protection shows an unjustified distrust of the user. This is why there is no protection in this application or in any application I will write in the future. There are however some benefits if you do pay your shareware fee:
€ There will no longer be a text on top of the output files stating you should register.
€ You will be able to use ImageMapConverter forever without the annoying Shareware-notice at startup.
€ You'll receive info on upgrades (much faster FAT versions!) and support (Sorry, no marital counseling).
€ Your website will be my secret Cool Site of the Day for two months (more money, more months...).

What did you use to create ImageMapConverter?

ImageMapConverter was written in Lingo using Macromedia Director 5.0 and later ported to the Director 4.0 format because of size issues.
I used Director because I don't know any C but do know Lingo. Moreover it allows me to port this program to other platforms in the future. If there is a lot of interest in a Windows version of ImageMapConverter I will consider making it. To expand Director's capabilities I used Xcmds and Xobjects by Frédéric Rinaldi, John Sudderth, Paul Farry and Yair Shageev.

Are there any bugs in ImageMapConverter?

Yes, unfortunately there are some bugs/quirks I wasn't able to resolve:

  • Director doesn't make a "real" Apple menu so the only thing you can reach through the Apple menu is the About screen.
    Workaround: click on the desktop first.

  • If you selected multiple files and the last action you did was removing a file from the list, ImagemapConverter sometimes doesn't convert any file. This is due to an incompatibility of the Multiple file dialog with Easy Open.
    Workaround: none, just don't do it.

  • On certain machines with big monitors and a high Colordepth even the suggested memory size of 4500 K isn't enough.
    Workaround: increase the memorysize in the Info box.

If you find other bugs please sent a detailed bugreport to mare@kagi.com so I can fix them in future versions of ImageMapConverter.

Do you have anyone to thank?

In fact I have to thank a lot of people:
Pieter van Kemenade (for the inspiration and the original idea)
Rien van der Waa (for advice and inspiration)
Peter Weustink (for testing on his Macs)
Frédéric Rinaldi (for his set of freeware Xcmds)
John Sudderth (for his set of freeware Xcmds)
Paul Farry (for his freeware OSUtils Xobject)
Yair Shageev (for his freeware TextChruncher Xobject)


Why is your company called Peghole?

Originally I am an animator and I have adopted my logo from something you use in this noble art. My logo is not printed: it consists of a series of three holes punched in the paper of my business cards, stationery and even in the envelopes. These holes, two rectangular ones and a round one in the middle, are originally used to register the drawings of an animated cartoon. They fit precisely on a metal bar with similarly shaped pegs (right: a pegbar!) so every drawing in an animated sequence is exactly at the same place. Unfortunately I can't punch holes in your computerscreen (if interactive technology has developed a little further I will consider adding it as a new feature...) so I have used a graphic representation of my logo in ImageMapConverter. If you click on it you'll go to the about screen.
If you want to see my real logo you can commission me to make a cool Shockwave or something else and I'll sent you a bill with these holes in it!
So that's why Peghole is called Peghole. (And for those of you who have other thoughts when they hear that name, the answers are: yes, no, no, yes and no.)

What does Peghole do more?

Peghole occupies itself with (Click the links for examples on the Internet):

Animation, both on film or in digital form
Design and construction of Internetsites
Multimedia design and programming
Shockwave interactive animations and games design and programming.
Stereo photography (in conjunction with the Foundation for Remarkable Photography)


Where and how can I contact you?


If you like this program or even if you think it sucks, let me know. I always answer my mail so, if you don't get a response, I may not have received it and you should send it again.

For help or information about this application and/or Peghole, send mail to mare@kagi.com.
For information about Kagi and/or the Register application, send mail to sales@kagi.com.
Peghole / Mare Reijnders (mare@kagi.com)
© 1996 by Peghole / Mare Reijnders, All Rights Reserved.
This application is $10 shareware.


The Fine Print

PEGHOLE/MARE REIJNDERS DOES NOT AND CANNOT WARRANT THE PERFORMANCE OR RESULTS YOU MAY OBTAIN BY USING THE SOFTWARE OR DOCUMENTATION. THE FOREGOING STATES THE SOLE AND EXCLUSIVE REMEDIES PEGHOLE/MARE REIJNDERS WILL PROVIDE FOR BREACH OF WARRANTY. EXCEPT FOR THE FOREGOING LIMITED WARRANTY, PEGHOLE/MARE REIJNDERS MAKES NO WARRANTIES EXPRESS OR IMPLIED, AS TO NON-INFRINGEMENT OF THIRD PARTY RIGHTS, MERCHANTABILITY, OR FITNESS FOR ANY PARTICULAR PURPOSE. IN NO EVENT WILL PEGHOLE/MARE REIJNDERS BE LIABLE TO YOU FOR ANY CONSEQUENTIAL OR INCIDENTAL DAMAGES, INCLUDING ANY LOST PROFITS OR LOST SAVINGS, EVEN IF A PEGHOLE REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIMS BY ANY PARTY.

[Back to top]

Peghole / Mare Reijnders (mare@kagi.com)
© 1996 by Peghole / Mare Reijnders, All Rights Reserved.

visitors=