NAME

       img-window - Img, Tk Windows (window)

SYNOPSIS

       package require Tk

       package require img::window  ?1.3?

       image create photo ?name? ?options?

________________________________________________________________________________________________________________

DESCRIPTION

       The  package img::window is a sub-package of Img. It can be loaded as a part of the complete Img support,
       via package require Img, or on its own, via package require img::window.

       Like all packages of Img it does not provide new commands, but extends the  existing  Tk  command  image.
       More specifically img::window extends Tk's photo image type.

       The name of the new format handler is window.

       This  handler  does  not  provide  additional configuration options.  This handler is special. Instead of
       reading or writing image data from a file or string it allows the embedding of a Tk widget into the photo
       image. In other words, it takes a snapshot of the contents of a Tk window.

       All of the above means that in a call like

       image create photo ?name? ?options?

       [1]    Image  data in window format (option -data) is detected automatically. Image data is considered to
              be in the window format if the value given to option -data is the name of an existing Tk window.

              Note that the standard option -file is not supported by this handler.

       [2]    The format name window is recognized by the option -format.

SEE ALSO

       img-bmp, img-dted, img-gif, img-ico, img-intro, img-jpeg, img-pcx, img-pixmap, img-png, img-ppm,  img-ps,
       img-raw, img-sgi, img-sun, img-tga, img-tiff, img-window, img-xbm, img-xpm

KEYWORDS

       image handling, tk, window

COPYRIGHT

       Copyright (c) 1995-2003 Jan Nijtmans <nijtmans@users.sourceforge.net>