---
name: "BIS_fnc_unitCaptureSimple"
type: function
status: ok
groups: ["Scenes"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_unitCaptureSimple
revid: 347971
updated: 2023-11-08T09:42:41Z
---

# BIS_fnc_unitCaptureSimple

*Function · Scenes · Arma 3 v0.50 · introduced in Arma 2: Operation Arrowhead v1.50*

Locality: executed with **spawn**

## Description

Records movement data of input unit over a specified period of time. Simplified.
Pressing the <kbd>Esc</kbd> key, the duration ending, or the unit dying ends the recording.

## Syntax

```sqf
[unit, duration, FPS, firing, startTime] spawn BIS_fnc_unitCaptureSimple
```

**Parameters:**

- `unit`: [Object](../topics/Object.md) - unit to capture movement data from
- `duration`: [Array](../topics/Array.md) - duration to capture for
- `FPS`: [Number](../topics/Number.md) - (Optional, default 20) frames recorded per second (default 20). Limit is 1 - 100
- `firing`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md))  if [true](../commands/true.md), will record the input unit's weapon fire data as well
- `startTime`: [Number](../topics/Number.md) - (Optional, default 0) starting time offset for the frame time

**Returns:** [Script Handle](../topics/Script_Handle.md)

> [!NOTE]
> [Copies to clipboard](../commands/copyToClipboard.md) an [Array](../topics/Array.md) of [Array](../topics/Array.md)s in format [frameTime, unitPosition, unitDirection] for each frame.

## Examples

### Example 1

```sqf
[BIS_Vehicle, 50, 30, true, 10] spawn BIS_fnc_unitCaptureSimple;
```

## See also

[BIS_fnc_unitCaptureFiring](../functions/BIS_fnc_unitCaptureFiring.md) · [BIS_fnc_unitPlaySimple](../functions/BIS_fnc_unitPlaySimple.md) · [BIS_fnc_unitPlayFiring](../functions/BIS_fnc_unitPlayFiring.md) · [BIS_fnc_unitCapture](../functions/BIS_fnc_unitCapture.md) · [BIS_fnc_unitPlay](../functions/BIS_fnc_unitPlay.md)

<sub>Source: [BI Community Wiki — BIS fnc unitCaptureSimple](https://community.bistudio.com/wiki/BIS_fnc_unitCaptureSimple) (revision 347971).</sub>