                                  ttkdraw
                               (Tom's TkDraw)
                         Version 1.0, Beta Release

What is it?
-----------
ttkdraw is a fairly powerful drawing program built entirely on tcl/Tk's
canvas widget.  It saves and loads files in Tcl script format.  It has
been tested on a Unix system.  It could probably be made to work on
Windows or Mac, as I MOSTLY made sure to avoid UNIX-specific stuff.

This is a beta release.  It's very stable for me, but a few of the features
(like handling of images, and nailing down/prying up) are very new and
haven't been tested much even by me.  I have no idea how it will perform
out there in the real world.

Help
----
help is builtin to ttkdraw.  Use the help menu on the right side of the
menubar.


INSTALLATION
------------

0.  wish8.x is REQUIRED

1.  unpack the tar file

2.  Move things around to where you want them.
    a) the "tkdraw" directory contains bitmaps used for interface buttons
    b) the "grey" directory contains bitmaps used for doing stippling
    c) the "lib" directory contains some required packages

3.  Edit the first few lines of the program, "draw", to point to the
    locations of the various stuff in step 2.
    a) APPMAPDIR points to the location of the tkdraw directory
    b) GREYMAPDIR points to the location of the "grey" directory
    c) auto_path is a list of all places searched for packages,
       the "lib" directory should be added to this path unless you
       installed the lib files into a standard tcl/Tk directory.
    d) the very first line of the program needs to be changed to
       the location of your wish (8.0 or higher) executable.

For example, if I unpack the tar file into /zippy/fun, then the
first four non-blank lines might look something like this
(without the ">" characters):

>#!/usr/bin/wish8 -f
>
>set APPMAPDIR /zippy/fun/ttkdraw1.0-beta/tkdraw
>
>set GREYMAPDIR /zippy/fun/ttkdraw1.0-beta/grey
>
>lappend auto_path /zippy/fun/ttkdraw1.0-beta/lib

4.  Install the "draw" program into a directoy in your path.
    Don't forget to "rehash".

5.  (re)index the "lib" directory:
    unix_prompt: tclsh8.0
    % pkg_mkIndex /path/to/the/lib/directory
    % exit

6.  Run "draw"

7.  Have fun.
    Bug Reports to fine@head-cfa.harvard.edu
    Yes, I know the scrollbar doesn't work.  Window resizing does!
    The choices of some of the keyboard specifcations are probably
    sun-specific right now.


Future Plans
------------
The user interface is not that user-friendly.  There are some glaring
inconsistencies in the operation of some commands.  The mouse button
choices may not be considered ideal by most.  The code itself is fairly
disorganized, having grown bit by tiny bit over a very long period of time.

There are lots of ideas I've had.  I tend to add notes to the comments
at the beginning of the draw program, although they may not make much
sense to you.

Please feel free to send me your own ideas, or better yet, working code:
  fine@head-cfa.harvard.edu

