{"name":"screenshot","title":"screenshot","type":"command","url":"https://community.bistudio.com/wiki/screenshot","revid":373186,"updated":"2025-04-11T09:26:12Z","groups":["System"],"status":"ok","games":{"arma3":"1.60"},"since":"arma3 1.60","arma3_since":"1.60","description":"| Post-Process Effect | Active in<br>screenshot |\n|---|---|\n| ColorInversion | ✗ |\n| FilmGrain | ✗ |\n| ColorCorrections | ✗ |\n| DynamicBlur | ✓ |\n| WetDistortion | ✓ |\n| ChromaticAberration | ✓ |\n| RadialBlur | ✓ |\n| SSAO | Unknown |\n| Resolution | ✓ |\n\nTakes a screenshot of the 3D scene and saves it to the provided filename.\n\n- Only the 3D scene is captured, no GUI/cursor\n- Sampling is taken in consideration: a 200% sampling value on a 1920x1080 resolution takes a 3840x2160 screenshot\n- PNG is the only available format\n\nThe file is saved in the *Screenshots* folder in the Profile directory. The folder is by default limited to **250 MB** to prevent abuse.\nTo increase the limit, add the following line at the end of the profile file:\n\n```cpp\nmaxScreenShotFolderSizeMB = 2000; // 2 GB\n```","syntaxes":[{"syntax":"screenshot filename","params":[{"name":"filename","type":"String","description":"**must** have `.png` extension; desired path and name relative to `<PROFILEDIR>\\Screenshots\\` (see Profile).\nIf empty string `\"\"` used, the filename will be autogenerated in format: `YYYY_MM_DD_hh_mm_ss.png`","type_expr":"String"}],"returns":{"type":"Boolean","type_expr":"Boolean","description":"true if success"},"form":"unary","right":{"text":"filename"}}],"examples":[{"code":["screenshot \"\";"]},{"code":["screenshot \"testFile.png\";"]},{"text":"The following code will result in the screenshot being placed in `\\Documents\\Arma 3\\Screenshots\\any\\where\\you\\want.png`:\n\n```sqf\nscreenshot \"any\\where\\you\\want.png\";\n```","code":["screenshot \"any\\where\\you\\want.png\";"]}],"see_also":["BIS_fnc_exportEditorPreviews","Eden Editor: Configuring Asset Previews"],"notes":[{"user":"Komachi","date":"2018-03-20T15:29:00Z","text":"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)\n\nFor full reference on recommended settings consult Eden Editor: Configuring Asset Previews."}]}