imagegrabscreen

(PHP 5 >= 5.2.2, PHP 7, PHP 8)

imagegrabscreenCaptures the whole screen

Description

imagegrabscreen(): GdImage|false

Grabs a screenshot of the whole screen.

Note:

This function is only available on Windows.

Parameters

This function has no parameters.

Return Values

Returns an image object on success, false on failure.

Changelog

Version Description
8.0.0 On success, this function returns a GDImage instance now; previously, a resource was returned.

Examples

Example #1 imagegrabscreen() example

This example demonstrates how to take a screenshot of the current screen and save it as a png image.

<?php
$im
= imagegrabscreen();
imagepng($im, "myscreenshot.png");
imagedestroy($im);
?>

See Also

add a note

User Contributed Notes 1 note

up
-1
Nitrogen
15 years ago
If you have multiple displays set up, this function will only grab the primary display; not all of them like you would with the 'Print Screen' key.

Also, this should be pretty obvious but I'll mention it anyway, if you're running GPU-intensive applications (not CPU), calling this function will cause quite some significant lag to your machine and server response until the request is complete.
To Top