CurrentScreenImage

CurrentScreenImage[]

returns an image captured from all current display screens on your computer.

CurrentScreenImage[n]

returns an image captured from display screen n.

CurrentScreenImage[{{xmin,ymin},{xmax,ymax}}]

returns the specified rectangle from the image of all current display screens.

Details and Options

  • The primary display monitor is typically numbered 1, and the image from it can be captured with CurrentScreenImage[1].
  • The list of all display screens is given by SystemInformation["Devices","ScreenInformation"].
  • CurrentScreenImage returns an image that contains a faithful representation of pixels on your display screen.
  • In the form CurrentScreenImage[{{xmin,ymin},{xmax,ymax}}], the coordinates are measured from the bottom left of the complete area of all current display screens.
  • CurrentScreenImage always shows a rectangular display area. Any pixels that lie outside the display areas for any screen are assigned a color specified by the setting for the option Background.

Examples

open allclose all

Basic Examples  (4)

Capturing a screenshot:

Capture an image of the main monitor:

Capture screenshots of all current monitors:

Capture a screenshot of the lower left-hand corner of the screen:

Options  (1)

Background  (1)

Capturing a screenshot with multiple monitors attached may display black areas where no physical monitors exist:

The background color in this case can be changed with the option Background:

Properties & Relations  (2)

CurrentScreenImage uses the standard image coordinate system used in standard image processing functions like ImageTrim:

Using CurrentScreenImage of a rectangle is faster than trimming the full image after taking it:

Interactive Examples  (2)

Display a dynamic image of the full screen:

Make a dynamic image of a rectangle around the current mouse position:

Introduced in 2017
 (11.2)