{"name":"BIS_fnc_unitCapture","operator":null,"title":"BIS fnc unitCapture","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_unitCapture","revid":347970,"updated":"2023-11-08T09:41:00Z","groups":["Scenes"],"status":"ok","replaced_by":[],"games":[{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":"spawn","description":"Records movement data of input unit over a specified period of time. Simplified.\nPressing the <kbd>Esc</kbd> key, the duration ending, or the unit dying ends the recording.\n\nCopies to clipboard an Array in format [frameTime, unitPosition, unitDirectionVector, unitUpVector, unitVelocity] for each frame.","syntaxes":[{"syntax":"[unit, duration, FPS, firing, startTime] spawn BIS_fnc_unitCapture","since":null,"effect":null,"exec":null,"params":[{"name":"unit","type":"Object","optional":false,"default":null,"description":"unit from which to capture movement data","types":["Object"],"since":null,"text":"unit: Object - unit from which to capture movement data"},{"name":"duration","type":"Number","optional":false,"default":null,"description":"capture's maximum duration","types":["Number"],"since":null,"text":"duration: Number - capture's maximum duration"},{"name":"FPS","type":"Number","optional":true,"default":"20","description":"frames recorded per second (default 20). Range is 1..100","types":["Number"],"since":null,"text":"FPS: Number - (Optional, default 20) frames recorded per second (default 20). Range is 1..100"},{"name":"firing","type":"Boolean","optional":true,"default":"false","description":"if set to true, will record the input unit's weapon fire data as well","types":["Boolean"],"since":null,"text":"firing: Boolean - (Optional, default false) if set to true, will record the input unit's weapon fire data as well"},{"name":"startTime","type":"Number","optional":true,"default":"0","description":"starting time offset for the frame time","types":["Number"],"since":null,"text":"startTime: Number - (Optional, default 0) starting time offset for the frame time"}],"returns":{"type":"Script Handle","types":["Script Handle"],"description":null,"text":"Script Handle"}}],"examples":[{"text":"```sqf\n[BIS_Vehicle, 50, 30, true, 10] spawn BIS_fnc_unitCapture;\n```","code":["[BIS_Vehicle, 50, 30, true, 10] spawn BIS_fnc_unitCapture;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["BIS_fnc_unitCaptureFiring","BIS_fnc_unitCaptureSimple","BIS_fnc_unitPlaySimple","BIS_fnc_unitPlayFiring","BIS_fnc_unitPlay","BIS_fnc_scriptedMove"],"notes":[{"user":"Benargee","date":"2014-09-29T21:31:00Z","text":"Video Tutorial by **[TheJserver](https://www.youtube.com/channel/UCY63DNbVREJIaANChQhYDTA)**\n\nArma 2: Operation Arrowhead v1.56 **Part 1:** <https://www.youtube.com/watch?v=ryB20wQhSr0>\n\nArma 2: Operation Arrowhead v1.56 **Part 2:** <https://www.youtube.com/watch?v=ePszdYfMRvc>\n\n*Works exactly the same in Arma 3 in my experience.*"}],"categories":["Arma 2: Operation Arrowhead: Functions","Arma 2: Operation Arrowhead: New Functions","Arma 3: Functions","Function Group: Scenes","Functions","Introduced with Arma 2: Operation Arrowhead version 1.50","Take On Helicopters: Functions"],"docblock":null,"filled_from_docblock":[]}