{"name":"diag_captureFrameToFile","operator":null,"title":"diag captureFrameToFile","type":"command","url":"https://community.bistudio.com/wiki/diag_captureFrameToFile","revid":318853,"updated":"2022-05-13T09:21:56Z","groups":["Diagnostic","Performance Profiling"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.16"}],"since":{"game":"arma3","name":"Arma 3","version":"1.16"},"arma3_since":"1.16","branch":"diag prof","locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"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\nwritten to a log file in the same directory as the .rpt file.\n\nThe full Path to the log file is logged to simultaneously.\n\nThe data in the log file can be copied and pasted into the diag_captureFrame UI dialog to get a visualisation later on.","syntaxes":[{"syntax":"diag_captureFrameToFile frame","since":null,"effect":null,"exec":null,"params":[{"name":"frame","type":"Number","optional":false,"default":null,"description":"next n-th frame to be captured","types":["Number"],"since":null,"text":"frame: Number - next n-th frame to be captured"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"unary","operator":null,"left":null,"right":{"text":"frame","types":["Number"]}}],"examples":[{"text":"```sqf\ndiag_captureFrameToFile 1; //capture the first frame after command execution\n```","code":["diag_captureFrameToFile 1; //capture the first frame after command execution"]},{"text":"```sqf\ndiag_captureFrameToFile 24; //capture 24th frame after command execution\n```","code":["diag_captureFrameToFile 24; //capture 24th frame after command execution"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["Performance Profiling","diag_captureSlowFrame","diag logSlowFrame","diag_captureFrame","logEntities","exportJIPMessages"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Arma 3: Scripting Commands: Diagnostic Branch","Arma 3: Scripting Commands: Profiling Branch","Command Group: Diagnostic","Command Group: Performance Profiling","Introduced with Arma 3 version 1.16","Scripting Commands"]}