| ActiveTcl User Guide |

[ Main table Of Contents | Img Table Of Contents | Img Index ]

# img-window(n) 1.3 "Img"

## Name

img-window - Img, Tk Windows (window)

## Table Of Contents

## 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 © 1995-2003 Jan Nijtmans <nijtmans@users.sourceforge.net>

#### Copyright © 2015 for compilation: ActiveState