2004/12/16 [sheila] I've been attempting to produce minimal builds of TclMagick with support only for a bmp module. I'm going to collect thoughts here. I'm putting an outline here first. will flesh out more later.

----

'''Choose between GraphicsMagick and ImageMagick'''

In order to build TclMagick, you need to decide which libraries to use with it, ImageMagick or GraphicsMagick.  (insert comparison of features and what motivates one to choose one over the other -- GraphicsMagick has smaller footprint vs. ImageMagick has more functions).

'''Choose Custimization or Default'''

Do you want to take GraphicsMagick or ImageMagick as-is or do you want to customize modules? If you don't need to customize, the quickest course of action is to grab a prebuilt distribution and install. (Make sure there isn't a problem with it not updating your path -- happened to me in a Windows environment)

If you do want to customize, download (insert link here) or check-out the source (insert link here) and then make a build.

''A Digression on Building in Windows''

The VC++ VisualMagick stuff is way cool. Easy to use. (insert description of use). I haven't tried an alternate method. (insert how-to for alternate compilers). Do that, then tinker with the modules listed in the workspace. I deleted optional modules in the All project workspace, then went to sub-workspaces like CORE-magick and made sure to remove the correct dependiencies. (Insert note about editing magick config file when using the VisualMagick configure comamnd). I can't remember if I edited static.c and static.h in the CORE-magick project or not (I think I tried both -- double check and revise this later). At some point I also played around with editing configuration files (I got it to work when building with GraphicsMagick, but haven't successfully done this with ImageMagick. I'm still working on that).

''Mac OS X Digression''

I used apt-get or fink (can't remember) and installed ImageMagick.

'''Now on to Building TclMagick'''

Fairly simple. Get a zip of the source, or check-out from CVS (insert links). The source may have been included when you checked out or downloaded GraphicsMagick/ImageMagick. configure and build.

'''Building TclMagick in Windows with VC++'''

Edit the workspace to use the appropriate directories rather than the ones already there. (No script yet to do it for you. quick project for later). I hate the UI for doing that in VC++, and I usually edit the dsp files by hand. But make backups because once I screwed up something and VC++ didn't want to load them.

''Testing''

There are a few tests, but it would be nice to have more; so write them and contribute. I am too shy to contribute my tests yet, but I asked on the mailing list for permission. I wrote one for doing diffs of BMPs within epsilon of 0 using a nice fequal procedure I found on the wiki (go find the page and link here)

'''Building in OS X'''

(it worked, insert more later.)

----

(insert examples and tests)