Back to files

!¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤!

!                                                  !
! TkImgMap           by AnkiF                      !
!                    ankif@mailoman.com            !
!                                                  !

!¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤¤!

1. INTRODUCTION

TkImgMap is a simple imagemap editor. It is intended to be used by people who write HTML with a text editor and allow them to draw the imagemaps instead of having to compute them.
It has some nifty features that make it rather useful anyway (can import imagemaps from HTML files, etc).

I'm not a Tcl/Tk guru, just a fan who finds Tcl/Tk appropriate for most of his needs. Some time ago, I was looking for a freeware application to make an imagemap, and found nothing satisfactory from my point of view. Then I said to myself that with the Tk canvas, such a tool seemed very easy to make.
TkImgMap allowed me to verify that assumption, and also to try some extensions or libraries found on the Net :

The valuable "Img" package made by Jan Nijtmans (http://purl.oclc.org/net/nijtmans/img.html)
the Balloon feature, by Daniel Roche (http://www.multimania.com/droche/tkballoon/index.html)

I want to thank them once more in these lines.

2. INSTALLATION

TkImgMap requires Tcl/Tk >= version 8.0. Also, people who still use Tcl/Tk 8.0.x are invited to read the additional instructions at the end of this section.

All versions

Vous need the following two archives :

TkImgMap-2.0.zip (or tar.gz)
AnkiConf-0.3.zip (or tar.gz)

If you have TkImgMap 1.x installed, you'd better delete it before proceeding or install the new version in another directory

If you have TkImgMap 2.0.x installed, you can simply install the new version in the same directory and let the new files overwrite the old ones.

Uncompress the TkImgMap-2.0.x.zip (or tar.gz) file anywhere. Beware ! that's the place where it will definitely reside.

The installation must have created a new directory "TkImgMap", containing two sub-directories :

icons : contains the GIF files of the icon bar buttons

     text          : contains the text of the application, in 
                     pure French and in AnkiF-English...

The main directory contains the following files :

     TkImgMap.ini  : the configuration file, inspired by the old
                     Windows 3.1 INI files 

     TkImgMap.tcl  : main script 

     TkIMHelp.tcl  : displays the help window (in a separate
                     script since it's never used :-))

     TkIMhtml.tcl  : simple subroutines to read from/write to HTML
                     files.

b) In the "TkImgMap" directory, uncompress the file AnkiConf-0.3.zip (or tar.gz).

A subdirectory AnkiConf0.3 is then created. It should contain two files: AnkiConf.tcl and pkgIndex.tcl.

Tcl/Tk 8.0.x

TkImgMap requires the package "msgcat" which is included in Tcl/Tk starting with version 8.1.

You need to get from my Web site the archive file msgcat-1.0.zip (or tar.gz) and install it in the TkImgMap directory or in the standard location for Tcl packages.

In any case, a subdirectory named "msgcat1.0" will be automatically created. It contains the two following files : msgcat.tcl and pkgIndex.tcl

Precision : to know the standard location for Tcl packages, run "wish" and type "puts $tcl_library". It's a good idea to install the packages there because they will be usable by every Tcl application and not only TkImgMap.

3. OPTIONAL PACKAGES

BALLOON

** Adds the ballon help feature **

you can find on my site a quick hack of balloon.tcl which has been made by Daniel Roche. He will eventually release a package'd version but I needed it now !
Like TkImgMap, it is available both as a zip and a tar.gz archive. Install the content of this archive in TkImgMap directory, or in the standard location for Tk packages.
In any case, a "Balloon1.0" directory is created. It should contain the following files : Balloon.tcl and pkgIndex.tcl

Precision : to know the standard location for Tk packages, run "wish" and type "puts $tk_library". It's a good idea to install the packages there because they will be usable by every Tk application and not only TkImgMap.

IMG

** Allows to read JPG and PNG images **

binaries are available on Jan Nijtmans' Web site, except for Linux but the generation procedures are standard. The installation process is automatic, let it do everything for you !

4. USAGE

UNIX : simply run TkImgMap.tcl as a shell script, or through

wish as you ... wish.

Windows : run "wish TkImgMap.tcl"

       If Tcl/Tk is installed correctly, this means simply
       double-clicking on the file.

The rest should be self-explanatory.

5. RIGHTS

The unavoidable legal terms are in the "COPYING.txt" file. In short, this software is freeware. You can use it without any authorization. If you happen to change something in it, I would be happy to know what.
And of course, if you like it, write me too !

6. KNOWN BUGS

With the Windows version, the "circle" shape is solid and hides the image. The reason is simple: the Windows version of Tk 8.0 doesn't handle the "-stipple" option for ovals (a fortiori circles)
Changing the current language is effective only at the next execution.
The menu items are not enabled/disabled as it would be expected.

7. WEAKNESSES

Read TODO.txt ...