---
name: "screenshot"
type: command
status: ok
groups: ["System"]
arma3_since: "1.60"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/screenshot
revid: 373186
updated: 2025-04-11T09:26:12Z
---

# screenshot

*Command · System · Arma 3 v1.60*

## Description

| Post-Process Effect | Active in<br>screenshot |
|---|---|
| ColorInversion | ✗ |
| FilmGrain | ✗ |
| ColorCorrections | ✗ |
| DynamicBlur | ✓ |
| WetDistortion | ✓ |
| ChromaticAberration | ✓ |
| RadialBlur | ✓ |
| SSAO |  |
| Resolution | ✓ |

Takes a screenshot of the 3D scene and saves it to the provided filename.
- Only the 3D scene is captured, no GUI/cursor
- Sampling is taken in consideration: a 200% sampling value on a 1920x1080 resolution takes a 3840x2160 screenshot
- PNG is the only available format

The file is saved in the *Screenshots* folder in the Profile directory. The folder is by default limited to **250 MB** to prevent abuse.

To increase the limit, add the following line at the end of the profile file:

```cpp
maxScreenShotFolderSizeMB = 2000; // 2 GB
```

## Syntax

```sqf
screenshot filename
```

**Parameters:**

- `filename`: [String](../topics/String.md) - **must** have `.png` extension; desired path and name relative to `<PROFILEDIR>\Screenshots\` (see Profile).

  If empty string `""` used, the filename will be autogenerated in format: `YYYY_MM_DD_hh_mm_ss.png`

**Returns:** [Boolean](../topics/Boolean.md) - [true](../commands/true.md) if success

## Examples

### Example 1

```sqf
screenshot "";
```

### Example 2

```sqf
screenshot "testFile.png";
```

### Example 3

The following code will result in the screenshot being placed in `\Documents\Arma 3\Screenshots\**any\where\you\want.png**`:

```sqf
screenshot "any\where\you\want.png";
```

## See also

[BIS_fnc_exportEditorPreviews](../functions/BIS_fnc_exportEditorPreviews.md) · Eden Editor: Configuring Asset Previews

## Community notes

**Komachi** — 2018-03-20

The command will silently fail if your profiles folder is configured to be somewhere else (`-profiles` parameter), or if your HDR setting is below 16 (configurable in arma3.cfg or medium and above in in-game settings)

For full reference on recommended settings consult Eden Editor: Configuring Asset Previews.

<sub>Source: [BI Community Wiki — screenshot](https://community.bistudio.com/wiki/screenshot) (revision 373186).</sub>