This directory contains the following files:

for Tk8.0.5 (or any other patchlevel)
  patch.tk80		patch file

for Tk8.1
  patch.tk8		patch file

for TclX8.0.x and TclX8.1.x
  patch.tkx		patch file

This patch adds the following functionality to the photo widget:

- The internal representation for photo data is changed from three
  (rgb) to four (rgba) 'colors'. This is the Java default color
  model, and is also used internally in the PNG and TIFF
  libraries. It allows image files with transparency information
  (e.g. GIF or PNG) to be read, edited, and written without
  losing the transparency.
- The "-format" option is added to the "imageName put" command.
  This allows data in any format to be used as the 3th argument,
  as long as there is a handler for it.
- New command "imageName data", which is the reciprocal function
  of "imageName put". Using the "-format" option, the content of
  the photo can be returned in any format for which there exists
  a string write function.
- The "imageName data" and "imageName write" will have new options
  "-grayscale" and "-background <color>". The first one forces
  writing of a grayscale image even though the image is in color.
  The second one removes the transparency information, using
  <color> to fill in the missing pixels.
- Support for animated GIF's (not for perl yet). For example:
	image create photo -file <fileName> -format {gif -index 3}
  will extract the 4th image from <fileName> (start counting with 0!)
- Transformation of all image formats to the new Object API.
  This is neccessary to allow binary data to be used as value
  for the "-data" argument, or as argument in the "imagename put"
  command.

For "patch.tkx":
- This patch file takes care that all photo enhancements in the
  other patches are reflected in the TclX help system as well.

If you have difficulties applying the patch to Tk8.1,
collections of replacements files compatible with "patch.tk8"
(photo.n, tk.h, tkImage.c, tkImgBmap.c, tkImgGIF.c, tkImgPPM.c,
tkImgPhoto.c, tkTest.c, and tkWindow.c) are available, only not
distributed together with Img 1.2:
	patchtk8.tgz (for UNIX)
	patchtk8.zip (for Windows)
These files can be downloaded from:
	ftp://ftp.neosoft.com/pub/tcl/sorted/packages-8.0/graphics/Img/1.2
Just copy one of these files to the tk8.1 directory and extract
everything from there; The correct files will be placed in the
doc/, generic/ and test/ subdirectories.

Written by:
	Jan Nijtmans
	CMG (Computer Management Group) Arnhem B.V.
	email: Jan.Nijtmans@wxs.nl (private)
	       Jan.Nijtmans@cmg.nl (work)
	url:   http://home.wxs.nl/~nijtmans/
