tk::winphoto(3pm) [debian man page]

WinPhoto(3pm)						       perl/Tk Documentation						     WinPhoto(3pm)

NAME

       Tk::WinPhoto - Load a Photo image from a window

SYNOPSIS

	 use Tk;
	 use Tk::WinPhoto;

	 my $image = $mw->Photo(-format => 'Window', -data => oct($mw->id));
	 $image->write($path_name, -format => 'BMP|PPM|XPM');

DESCRIPTION

       This is an extension for Tk800.* which will load a Photo image from a snapshot of an X window specified by the -data option.

       The window must exist and be visible. Because the code allows you to capture windows not owned by Tk it does not attempt to enforce this.
       If you are capturing one of Tk's windows then use "$w->update".

       If window is mapped, but obscured by other windows then what is captured is the rectangle the window would occupy. This can be considered a
       feature.  For Tk-owned windows "$w->raise" can used to bring window forward.

       Once the Photo is loaded it can be saved using "$image->write(-format => ...)" using any of formats which support writing.

AUTHOR

       Nick Ing-Simmons <nick@ni-s.u-net.com>

Tk804.03							    2010-05-29							     WinPhoto(3pm)

img-window(n)															     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									1.3							     img-window(n)