diag captureFrame: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\[\[Category:[ _]?Scripting[ _]Commands[ _]Arma[ _]2(\|.*)\]\]" to "{{GameCategory|arma2|Scripting Commands}}")
m (Text replacement - "{{Feature|Important|" to "{{Feature|important|")
 
(20 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:diag_captureFrame}}
{{RV|type=command
{{Command|Comments=
____________________________________________________________________________________________


| arma2oa |Game name=
|game1= arma2oa
|version1= 1.63


|1.63|Game version=
|game2= arma3
|version2= 1.00


|gr1= Diagnosis |GROUP1=
|branch= diagnostic profiling


|gr2= Performance Logging|GROUP2=
|gr1= Diagnostic
____________________________________________________________________________________________


| This command starts counting frames from the moment it is executed and when the count reaches the number passed as param, the current frame is captured and captured data UI dialog appears, similar to [[diag_captureSlowFrame]].<br>
|gr2= Performance Profiling
This can also be executed on a dedicated Server and because a Server has no UI it will behave like [[diag_captureFrameToFile]].<br>
Special: BattlEye's RCON variant of this command is #captureFrame<br>
'''Note''': Only available in specific builds. See [[Performance Profiling]] for details. |DESCRIPTION=
____________________________________________________________________________________________


| '''diag_captureFrame''' frame|SYNTAX=
|descr= This command starts counting frames from the moment it is executed and when the count reaches the number passed as param, the current frame is captured and captured data UI dialog appears, similar to [[diag_captureSlowFrame]]. This can also be executed on a dedicated Server and because a Server has no UI it will behave like [[diag_captureFrameToFile]].
{{Feature|important|BattlEye's RCON variant of this command is '''#captureFrame'''}}


|p1= frame: [[Number]] - next n-th frame to be captured |PARAMETER1=
|s1= [[diag_captureFrame]] frame


| [[Nothing]] |RETURNVALUE=
|p1= frame: [[Number]] - next n-th frame to be captured
____________________________________________________________________________________________
 
|x1= <code>[[diag_captureFrame]] 1; //capture the first frame after command execution</code> |EXAMPLE1=
|x2= <code>[[diag_captureFrame]] 24; //capture 24th frame after command execution</code> |EXAMPLE2=
____________________________________________________________________________________________


| [[Performance Profiling]], [[diag_captureSlowFrame]], [[diag_logSlowFrame]], [[logEntities]], [[exportJIPMessages]], [[diag_captureFrameToFile]] |SEEALSO=
|r1= [[Nothing]]


}}
|x1= <sqf>diag_captureFrame 1; // capture the first frame after command execution</sqf>


<h3 style="display:none">Notes</h3>
|x2= <sqf>diag_captureFrame 24; // capture 24th frame after command execution</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>


<h3 style="display:none">Bottom Section</h3>
|seealso= [[Arma 3: Diagnostics Exe]] [[Performance Profiling]] [[diag_captureSlowFrame]] [[diag_logSlowFrame]] [[logEntities]] [[exportJIPMessages]] [[diag_captureFrameToFile]]
 
}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
{{GameCategory|arma2|Scripting Commands}}
{{GameCategory|arma3|Scripting Commands}}

Latest revision as of 00:24, 2 February 2024

Hover & click on the images for description
Only available in Diagnostic/Profiling branch(es).

Description

Description:
This command starts counting frames from the moment it is executed and when the count reaches the number passed as param, the current frame is captured and captured data UI dialog appears, similar to diag_captureSlowFrame. This can also be executed on a dedicated Server and because a Server has no UI it will behave like diag_captureFrameToFile.
BattlEye's RCON variant of this command is #captureFrame
Groups:
DiagnosticPerformance Profiling

Syntax

Syntax:
diag_captureFrame frame
Parameters:
frame: Number - next n-th frame to be captured
Return Value:
Nothing

Examples

Example 1:
diag_captureFrame 1; // capture the first frame after command execution
Example 2:
diag_captureFrame 24; // capture 24th frame after command execution

Additional Information

See also:
Arma 3: Diagnostics Exe Performance Profiling diag_captureSlowFrame diag_logSlowFrame logEntities exportJIPMessages diag_captureFrameToFile

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