{"name":"screenshot","operator":null,"title":"screenshot","type":"command","url":"https://community.bistudio.com/wiki/screenshot","revid":373186,"updated":"2025-04-11T09:26:12Z","groups":["System"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.60"}],"since":{"game":"arma3","name":"Arma 3","version":"1.60"},"arma3_since":"1.60","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"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 |  |\n| Resolution | ✓ |\n\nTakes a screenshot of the 3D scene and saves it to the provided filename.\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.\n\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","since":null,"effect":null,"exec":null,"params":[{"name":"filename","type":"String","optional":false,"default":null,"description":"**must** have `.png` extension; desired path and name relative to `<PROFILEDIR>\\Screenshots\\` (see Profile).\n\nIf empty string `\"\"` used, the filename will be autogenerated in format: `YYYY_MM_DD_hh_mm_ss.png`","types":["String"],"since":null,"text":"filename: String - **must** have `.png` extension; desired path and name relative to `<PROFILEDIR>\\Screenshots\\` (see Profile).\n\nIf empty string `\"\"` used, the filename will be autogenerated in format: `YYYY_MM_DD_hh_mm_ss.png`"}],"returns":{"type":"Boolean","types":["Boolean"],"description":"true if success","text":"Boolean - true if success"},"form":"unary","operator":null,"left":null,"right":{"text":"filename","types":["String"]}}],"examples":[{"text":"```sqf\nscreenshot \"\";\n```","code":["screenshot \"\";"]},{"text":"```sqf\nscreenshot \"testFile.png\";\n```","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\";"]}],"multiplayer":null,"problems":null,"aliases":[],"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."}],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: System","Introduced with Arma 3 version 1.60","Scripting Commands"]}