Difference between revisions of "BIS fnc unitCaptureSimple"

From Bohemia Interactive Community
Jump to navigation Jump to search
(username removed)
m (Generated by BIS_fnc_exportFunctionsToWiki)
 
m (Text replacement - "[[Script (Handle)|" to "[[Script Handle|")
(25 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{RV|type=function
  
{{Function|= Comments
+
|game1= arma2oa
____________________________________________________________________________________________
+
|version1= 1.50
  
| arma2oa |= Game name
+
|game2= tkoh
 +
|version2= 1.00
  
|1.00|= Game version
+
|game3= arma3
____________________________________________________________________________________________
+
|version3= 0.50
  
| <pre>
+
|gr1= Scenes
/*
 
File: fn_UnitCaptureSimple.sqf
 
  
Description:
+
|descr= Records movement data of input unit over a specified period of time. Simplified.
Records movement data of input unit over a specified period of time. Simplified.
+
Pressing the {{KeyboardShortcut|Esc}} key, the duration ending, or the unit dying ends the recording.<br>
Pressing the ESC key, the duration ending, or the unit dying ends
+
Copies to clipboard an [[Array]] in format [frameTime, unitPosition, unitDirection] for each frame.
the recording.
 
  
Parameters:
+
|s1= [unit, duration, FPS, firing, startTime] spawn [[BIS_fnc_unitCaptureSimple]]
Unit - Unit to capture movement data from
 
Duration - Duration to capture for
 
OPT:FPS - OPTIONAL: Frames recorded Per Second (default 20). Limit is 1 - 100
 
OPT:Firing - OPTIONAL: If true, will record the input unit's weapon fire data as well
 
OPT:StartTime - OPTIONAL: Starting time offset for the frame time
 
  
Copies to clipboard:
+
|p1= unit: [[Object]] - Unit to capture movement data from
Array in format [FrameTime, UnitPosition, UnitDirection] for each frame
 
 
Input Examples:
 
a) [BIS_Vehicle, 50, 30, true, 10] spawn BIS_fnc_UnitCapture;
 
Which would capture data from a unit named BIS_Vehicle, would capture for 50 seconds, would capture at 30 FPS,
 
and would also record the unit's weapon fire data as well. Frame time offset would be 10 seconds.
 
 
b) [BIS_Vehicle, 50] spawn BIS_fnc_UnitCapture;
 
Which would capture data from a unit named BIS_Vehicle, and would capture for 50 seconds.
 
  
Output Example:
+
|p2= duration: [[Array]] - Duration to capture for
a) [[0,[8208.26,1953.13,296.04],67],[1.021,[8208.26,1953.13,296.04],68]]
 
The above output has 2 frames.
 
 
b) [[0,[8208.26,1953.13,296.04],67]]
 
The above output has 1 frame.
 
*/
 
  
</pre><small>''(Placeholder description extracted from the function header by [[BIS_fnc_exportFunctionsToWiki]])''</small> |= Description
+
|p3= FPS: [[Number]] - (Optional, default 20) Frames recorded per second (default 20). Limit is 1 - 100
____________________________________________________________________________________________
 
  
| <!-- [] call [[BIS_fnc_UnitCaptureSimple]]; --> |= Syntax
+
|p4= Firing: [[Boolean]] - (Optional, default [[false]])  If [[true]], will record the input unit's weapon fire data as well
  
|p1= |= Parameter 1
+
|p5= startTime: [[Number]] - (Optional, default 0) Starting time offset for the frame time
  
| |= Return value
+
|r1= [[Script Handle|Script handle]]
____________________________________________________________________________________________
 
  
|x1= <code></code> |=
+
|exec= spawn
____________________________________________________________________________________________
 
  
| |= See also
+
|x1= <code>[BIS_Vehicle, 50, 30, true, 10] [[spawn]] [[BIS_fnc_unitCaptureSimple]];</code>
  
 +
|seealso= [[BIS_fnc_unitCaptureFiring]], [[BIS_fnc_unitPlaySimple]], [[BIS_fnc_unitPlayFiring]], [[BIS_fnc_unitCapture]], [[BIS_fnc_unitPlay]]
 
}}
 
}}
 
<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:Function Group: Scenes|{{uc:UnitCaptureSimple}}]]
 
[[Category:Functions|{{uc:UnitCaptureSimple}}]]
 
[[Category:{{Name|arma2oa}}: Functions|{{uc:UnitCaptureSimple}}]]
 
[[Category:{{Name|tkoh}}: Functions|{{uc:UnitCaptureSimple}}]]
 
[[Category:{{Name|arma3}}: Functions|{{uc:UnitCaptureSimple}}]]
 

Revision as of 19:10, 28 August 2021

Hover & click on the images for description

Description

Description:
Records movement data of input unit over a specified period of time. Simplified. Pressing the Esc key, the duration ending, or the unit dying ends the recording.
Copies to clipboard an Array in format [frameTime, unitPosition, unitDirection] for each frame.
Execution:
spawn
Groups:
Scenes

Syntax

Syntax:
[unit, duration, FPS, firing, startTime] spawn BIS_fnc_unitCaptureSimple
Parameters:
unit: Object - Unit to capture movement data from
duration: Array - Duration to capture for
FPS: Number - (Optional, default 20) Frames recorded per second (default 20). Limit is 1 - 100
Firing: Boolean - (Optional, default false) If true, will record the input unit's weapon fire data as well
startTime: Number - (Optional, default 0) Starting time offset for the frame time
Return Value:
Script handle

Examples

Example 1:
[BIS_Vehicle, 50, 30, true, 10] spawn BIS_fnc_unitCaptureSimple;

Additional Information

See also:
BIS_fnc_unitCaptureFiringBIS_fnc_unitPlaySimpleBIS_fnc_unitPlayFiringBIS_fnc_unitCaptureBIS_fnc_unitPlay

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