({{, (RefLink[CurrentScreenImage, paclet:ref/CurrentScreenImage])[] 
returns an image captured from all current display screens on your computer. }, {, (RefLink[CurrentScreenImage, paclet:ref/CurrentScreenImage])[n]
returns an image captured from display screen n.}, {, (RefLink[CurrentScreenImage, paclet:ref/CurrentScreenImage])[{{(Subscript[x, min]),(Subscript[y, min])},{(Subscript[x, max]),(Subscript[y, max])}}] 
returns the specified rectangle from the image of all current display screens.}})

OpenersNotesSection(Spacer1)Details and Options

The primary display monitor is typically numbered 1, and the image from it can be captured with (RefLink[CurrentScreenImage, paclet:ref/CurrentScreenImage])[1].

The list of all display screens is given by (RefLink[SystemInformation, paclet:ref/SystemInformation])["Devices","ScreenInformation"].

(RefLink[CurrentScreenImage, paclet:ref/CurrentScreenImage]) returns an image that contains a faithful representation of pixels on your display screen.

In the form (RefLink[CurrentScreenImage, paclet:ref/CurrentScreenImage])[{{(Subscript[x, min]),(Subscript[y, min])},{(Subscript[x, max]),(Subscript[y, max])}}], the coordinates are measured from the bottom left of the complete area of all current display screens.

(RefLink[CurrentScreenImage, paclet:ref/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 (RefLink[Background, paclet:ref/Background]).

OpenersPrimaryExamplesSection(Spacer1)Examples  (9)

OpenersExampleSection0(Spacer1)Basic Examples  (4)

Capturing a screenshot:

CurrentScreenImage[]

Capture an image of the main monitor:

CurrentScreenImage[1]

Capture screenshots of all current monitors:

CurrentScreenImage/@Range[Length[SystemInformation["Devices","ScreenInformation"]]]

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

CurrentScreenImage[{{0,0},{100,100}}]

OpenersExampleSection1(Spacer1)Options  (1)

OpenersExampleSubsection0(Spacer1)Background  (1)

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

CurrentScreenImage[]

The background color in this case can be changed with the option (RefLink[Background, paclet:ref/Background]):

CurrentScreenImage[Background->White]

OpenersExampleSection2(Spacer1)Properties & Relations  (2)

(RefLink[CurrentScreenImage, paclet:ref/CurrentScreenImage]) uses the standard image coordinate system used in standard image processing functions like (RefLink[ImageTrim, paclet:ref/ImageTrim]):

CurrentScreenImage[{{0,0},{100,100}}]

ImageTrim[CurrentScreenImage[],{{0,0},{100,100}}]

Using (RefLink[CurrentScreenImage, paclet:ref/CurrentScreenImage]) of a rectangle is faster than trimming the full image after taking it:

AbsoluteTiming[CurrentScreenImage[{{0,0},{100,100}}]]

AbsoluteTiming[ImageTrim[CurrentScreenImage[],{{0,0},{100,100}}]]

OpenersExampleSection3(Spacer1)Interactive Examples  (2)

Display a dynamic image of the full screen:

Dynamic[Show[CurrentScreenImage[],ImageSize->Full]]

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

Framed[Dynamic[With[{mouse=MousePosition[]},CurrentScreenImage@Round@{{mouse[[1]]-50,mouse[[2]]-50},{mouse[[1]]+50,mouse[[2]]+50}}]]]

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[CurrentNotebookImage, paclet:ref/CurrentNotebookImage])  ▪  (RefLink[CurrentImage, paclet:ref/CurrentImage])  ▪  (RefLink[Rasterize, paclet:ref/Rasterize])  ▪  (RefLink[WindowMargins, paclet:ref/WindowMargins])  ▪  (RefLink[Import, paclet:ref/Import])  ▪  (RefLink[WebImage, paclet:ref/WebImage])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Tuning & Debugging, paclet:guide/TuningAndDebugging])}, {▪(RefLinkPlain[Creating & Importing Images, paclet:guide/CreatingAndImportingImages])}, {▪(RefLinkPlain[Web Browser Automation, paclet:guide/WebBrowserAutomation])}, {▪(RefLinkPlain[Using Connected Devices, paclet:guide/UsingConnectedDevices])}})}})