screenshot: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\{\{GameCategory\|(arma[0123])\|[ _]?New[ _]Scripting[ _]Commands[ _]List\}\}" to "{{GameCategory|$1|New Scripting Commands}}")
m (Text replacement - "Nelis.75733126" to "Nelis75733126")
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Command|Comments=
{{RV|type=command
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3
|1.60|Game version=
|version1= 1.60


|gr1= System |GROUP1=
|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|SYNTAX=
|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> |PARAMETER1=
|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 |RETURNVALUE=
|r1= [[Boolean]] - [[true]] if success
____________________________________________________________________________________________
|x1= <code>[[screenshot]] "";</code>|EXAMPLE1=


|x2= <code>[[screenshot]] "testFile.png";</code>|EXAMPLE2=
|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>|EXAMPLE3=


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


<h3 style='display:none'>Bottom Section</h3>
{{Note
{{GameCategory|arma3|Scripting Commands}}
|user= Nelis75733126
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
|timestamp= 20160718183100
{{GameCategory|arma3|New Scripting Commands}}
|text= This command only captures the rendered picture (including ppEffects). GUI nor the mouse are visible on the screenshot. '''(Arma 3 1.62.137494)'''
 
}}
<h3 style='display:none'>Notes</h3>
<dl class="command_description">
<!-- BEGIN Note Section -->
<!-- END Note Section -->
</dl>


<h3 style="display:none">Bottom Section</h3>
{{Note
 
|user= POLPOX
<!-- CONTINUE Notes -->
|timestamp= 20171203084200
<dl class="command_description">
|text= Change Sampling on Video Options to make bigger picture than your screen.<br>
<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>
</dl>
<!-- DISCONTINUE Notes -->
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on December 3, 2017 - 08:42 (UTC)</dd>
<dt class="note">[[User:POLPOX|POLPOX]]</dt>
<dd class="note">
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>
}}
</dl>
<!-- DISCONTINUE Notes -->


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

Latest revision as of 15:38, 29 June 2024

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
Nelis75733126 - 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