dwww Home | Manual pages | Find package

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.036                          2025-04-13                     WinPhoto(3pm)

Generated by dwww version 1.16 on Sat Oct 3 06:47:58 CEST 2026.