Imager::Search::Screenshot - An image captured from the screen


Imager::Search::Screenshot is a Imager::Search::Image subclass that allows you to capture images from the screen.

This provides a convenient mechanism to source the target images for applications that need to (visually) monitor an existing graphical system.



  my $image = Imager::Search::Screenshot->new(
      [ id => 0 ],
      driver => 'BMP24',

The new constructor initates a screen capture and returns the image.

In addition to params inherited from Imager::Search::Image it additionally can take as the first parameter a reference to an ARRAY.

It provided, the contents of the ARRAY are passed through to the underlying Imager::Screenshot screenshot method, which is used to do the actual image capture.

Returns a new Imager::Search::Screenshot object, or dies on error.


See the SUPPORT section of the main Imager::Search module.


Adam Kennedy <>


Copyright 2007 - 2011 Adam Kennedy.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

The full text of the license can be found in the LICENSE file included with this module.