Provided by: libtk-img-doc_1.4.2+dfsg-2_all bug

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>