Screenshot extension

This extension lets you save a screenshot of the running game in a specified folder.

Note: As of GDevelop 5.0.0-beta92 the screenshot action is no longer an extension. Just add an action and search for screenshot or go to Other Actions/Screenshot/Take screenshot.

Warning

Taking a screenshot only works when the game runs as a desktop app (Windows, Linux or macOS). It has no effect in the web browser preview, in web games or on mobile, because these platforms don't allow writing files to the computer.

Actions

Take screenshot

Use this action to save a screenshot of everything which is currently drawn on the game window into a png file.

Parameters:

Save path: The file path where the screenshot should be saved.

The save path needs to be an absolute path on the file system (Like "C:\MyFolder\MyScreenshot.png" on Windows)'

Relative paths are not supported.

If the path doesn't already end with .png, the .png suffix is added automatically. The image is written in the background, so it may take a brief moment before the file appears on disk.

Note

In order to create a game that runs on all supported platforms you should use the special folders from the file system extension in combination with the path separator. These determine the path to common folders like Pictures, Documents or Desktop automatically. You can read more about it in this article.

Example

This path:

<FileSystem::PicturesPath>() + <FileSystem::PathDelimiter>() + "my_screenshot.png"

This will save the screenshot to the Pictures folder on Windows, Linux and MacOS.

Reference

All actions, conditions and expressions are listed in the screenshot extension reference page.