This directory contains the following files:

for Tk4.1 and Tk4.2 (as well as Itcl 2.1 and 2.2):
  patch.tk4		patch file
  tkphoto4.c		replacement for tkImgPhoto.c

for Tk8.0
  patch.tk8		patch file

for Tix4.1
  patch.tix		patch file

for perl/Tk 402.002
  patch.pl4		patch file

for TclX7.5.0, TclX7.6.x and TclX8.0.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!)

For "patch.tk8":
- 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.

For "patch.tix":
- The transition to Tcl_Obj's in Tk's "image" command influences
  the Compound and Xpm image types: They are forced to make the
  same transition.

If you have difficulties applying the patch, you can copy the
provided tkphoto4.c into the Tk 4.1 or 4.2 distribution (rename
it to tkImgPhoto.c). 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
as well, only not distributed together with Img 1.1p2:
	patchtk8.tgz (for UNIX)	        105548 bytes
	patchtk8.zip (for Windows)      113277 bytes
These files can be downloaded from:
	ftp://ftp.nici.kun.nl/pub/nici/software/tcltk/img/
Just copy one of these files to the tk8.0(p1) 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/
