screenshot: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<dl class="command_description"> <dd class="notedate">" to "<dl class="command_description"> <dt></dt> <dd class="notedate">")
m (Some wiki formatting)
(15 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma3
|game1= arma3
|1.60
|version1= 1.60


|gr1= System
|gr1= System


| Captures a screenshot and stores it to given filename. <u>PNG is the only available format</u> and the file must have .png extension.  
|descr= Captures a screenshot and stores it to given filename. <u>PNG is the only available format</u> and the file must have .png extension.<br><br>
<br><br>
The file is saved into ''Screenshots'' folder in the [[Profile]] directory. The folder is by default limited to 250 MB to prevent abuse.<br>
The file is saved into ''Screenshots'' folder in the [[Profile]] directory. The folder is by default limited to 250 MB to prevent abuse.
<br>
To increase the limit, add the following line at the end of the profile file:
To increase the limit, add the following line at the end of the profile file:
<code>maxScreenShotFolderSizeMB <nowiki>=</nowiki> 2000;</code>
<syntaxhighlight lang="cpp">maxScreenShotFolderSizeMB = 2000; // 2 GB</syntaxhighlight>
2000 can be replaced by any value in MB.


| [[screenshot]] filename
|s1= [[screenshot]] filename


|p1= filename: [[String]] - desired path and name relative <tt><USERDIR>\Screenshot\</tt>. If empty string "" used, the filename will be autogenerated in format: <tt>YYYY_MM_DD_hh_mm_ss.png</tt>
|p1= filename: [[String]] - desired path and name relative to {{hl|&lt;PROFILEDIR&gt;\Screenshots\}} (see [[Profile]]).<br>
If empty string "" used, the filename will be autogenerated in format: {{hl|YYYY_MM_DD_hh_mm_ss.png}}


| [[Boolean]] - [[true]] if success
|r1= [[Boolean]] - [[true]] if success
|x1= <code>[[screenshot]] "";</code>


|x2= <code>[[screenshot]] "testFile.png";</code>
|x1= <sqf>screenshot "";</sqf>


|x3= The following code will result in the screenshot being placed in \Documents\Arma 3\Screenshots\any\where\you\want.png
|x2= <sqf>screenshot "testFile.png";</sqf>
<code>[[screenshot]] "any\where\you\want.png";</code>


| [[BIS_fnc_exportEditorPreview]], [[Eden_Editor:_Configuring_Asset_Previews|Configuring Asset Previews]]
|x3= The following code will result in the screenshot being placed in {{hl|\Documents\Arma 3\Screenshots\'''any\where\you\want.png'''}}
|
<sqf>screenshot "any\where\you\want.png";</sqf>
 
|seealso= [[BIS_fnc_exportEditorPreviews]] [[Eden_Editor:_Configuring_Asset_Previews|Configuring Asset Previews]]
}}
}}


{{GameCategory|arma3|Scripting Commands}}
{{Note
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
|user= IT07
{{GameCategory|arma3|New Scripting Commands}}
|timestamp= 20160718183100
 
|text= This command only captures the rendered picture (including ppEffects). GUI nor the mouse are visible on the screenshot. '''(Arma 3 1.62.137494)'''
 
}}
<!-- CONTINUE Notes -->
<dl class="command_description">
<dt></dt>
<dd class="notedate">Posted on July 18, 2016 - 18:31 (UTC)</dd>
<dt class="note">[[User:IT07|IT07]]</dt>
<dd class="note">
This command only captures the rendered picture (including ppEffects). GUI nor the mouse are visible on the screenshot. '''(Arma 3 1.62.137494)'''
</dd>


<dd class="notedate">Posted on December 3, 2017 - 08:42 (UTC)</dd>
{{Note
<dt class="note">[[User:POLPOX|POLPOX]]</dt>
|user= POLPOX
<dd class="note">
|timestamp= 20171203084200
Change Sampling on Video Options to make bigger picture than your screen.<br>
|text= Change Sampling on Video Options to make bigger picture than your screen.<br>
For example, 200% sampling on 1920x1080 screen and take screenshot via this command, it will generate a 3840x2160 picture.
For example, 200% sampling on 1920x1080 screen and take screenshot via this command, it will generate a 3840x2160 picture.
</dd>
}}


<dd class="notedate">Posted on March 20, 2018 - 15:29 (UTC)</dd>
{{Note
<dt class="note">[[User:Komachi|Komachi]]</dt>
|user= Komachi
<dd class="note">
|timestamp= 20180320152900
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)
|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)


For full reference on recommended settings consult [[Eden Editor: Configuring Asset Previews]]
For full reference on recommended settings consult [[Eden Editor: Configuring Asset Previews]]
</dd>
}}
</dl>
<!-- DISCONTINUE Notes -->

Revision as of 21:06, 18 April 2022

Hover & click on the images for description

Description

Description:
Captures a screenshot and stores it to given filename. PNG is the only available format and the file must have .png extension.

The file is saved into 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:
maxScreenShotFolderSizeMB = 2000; // 2 GB
Groups:
System

Syntax

Syntax:
screenshot filename
Parameters:
filename: String - 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
Return Value:
Boolean - true if success

Examples

Example 1:
screenshot "";
Example 2:
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
screenshot "any\where\you\want.png";

Additional Information

See also:
BIS_fnc_exportEditorPreviews Configuring Asset Previews

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
IT07 - c
Posted on Jul 18, 2016 - 18:31 (UTC)
This command only captures the rendered picture (including ppEffects). GUI nor the mouse are visible on the screenshot. (Arma 3 1.62.137494)
POLPOX - c
Posted on Dec 03, 2017 - 08:42 (UTC)
Change Sampling on Video Options to make bigger picture than your screen.
For example, 200% sampling on 1920x1080 screen and take screenshot via this command, it will generate a 3840x2160 picture.
Komachi - c
Posted on Mar 20, 2018 - 15:29 (UTC)
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