DragonFly On-Line Manual Pages

img-window(n)                         Img                        img-window(n)

______________________________________________________________________________

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>

img-window                            1.3                        img-window(n)