diag captureFrameToFile: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|= Game name" to "|Game name=")
m (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
 
(29 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:diag_captureFrameToFile}}
{{RV|type=command
{{Command|Comments=
____________________________________________________________________________________________


| arma3 |Game name=
|game1= arma3


|1.16|Game version=
|branch= diag prof
____________________________________________________________________________________________


| 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  
|version1= 1.16
 
|gr1= Diagnostic
 
|gr2= Performance Profiling
 
|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  
written to a log file in the same directory as the [[Crash_Files|.rpt file]].<br>
written to a log file in the same directory as the [[Crash_Files|.rpt file]].<br>
The full Path to the log file is logged to simultaneously.<br>
The full Path to the log file is logged to simultaneously.<br>
The data in the log file can be copied and pasted into the [[diag_captureFrame]] UI dialog to get a visualisation later on.<br>
The data in the log file can be copied and pasted into the [[diag_captureFrame]] UI dialog to get a visualisation later on.
'''Note''': Only available in specific builds. See [[Performance Profiling]] for details. |DESCRIPTION=
____________________________________________________________________________________________


| '''diag_captureFrameToFile''' frame|SYNTAX=
|s1= [[diag_captureFrameToFile]]  frame


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


| [[Nothing]] |RETURNVALUE=
|r1= [[Nothing]]
____________________________________________________________________________________________
 
|x1= <code>[[diag_captureFrameToFile]] 1; //capture the first frame after command execution</code> |EXAMPLE1=
|x2= <code>[[diag_captureFrameToFile]] 24; //capture 24th frame after command execution</code> |EXAMPLE2=
____________________________________________________________________________________________


| [[Performance Profiling]], [[diag_captureSlowFrame]], [[diag_logSlowFrame]], [[diag_captureFrame]], [[logEntities]], [[exportJIPMessages]] |SEEALSO=
|x1= <sqf>diag_captureFrameToFile 1; //capture the first frame after command execution</sqf>


|x2= <sqf>diag_captureFrameToFile 24; //capture 24th frame after command execution</sqf>
|seealso= [[Performance Profiling]] [[diag_captureSlowFrame]] [[diag_logSlowFrame]] [[diag_captureFrame]] [[logEntities]] [[exportJIPMessages]]
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style="display:none">Bottom Section</h3>
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Command_Group:_Performance_Logging|{{uc:{{PAGENAME}}}}]]

Latest revision as of 10:21, 13 May 2022

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 written to a log file in the same directory as the .rpt file.
The full Path to the log file is logged to simultaneously.
The data in the log file can be copied and pasted into the diag_captureFrame UI dialog to get a visualisation later on.
Groups:
DiagnosticPerformance Profiling

Syntax

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

Examples

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

Additional Information

See also:
Performance Profiling diag_captureSlowFrame diag_logSlowFrame diag_captureFrame logEntities exportJIPMessages

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