---
name: "diag_captureFrame"
type: command
status: ok
groups: ["Diagnostic", "Performance Profiling"]
arma3_since: "1.00"
branch: "diag prof"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/diag_captureFrame
revid: 379089
updated: 2026-09-27T09:45:01Z
---

# diag_captureFrame

*Command · Diagnostic, Performance Profiling · Arma 3 v1.00 · introduced in Arma 2: Operation Arrowhead v1.63 · branch: diag prof*

## 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 captured data UI dialog appears, similar to [diag_captureSlowFrame](../commands/diag_captureSlowFrame.md). This can also be executed on a dedicated Server and because a Server has no UI it will behave like [diag_captureFrameToFile](../commands/diag_captureFrameToFile.md).

> [!IMPORTANT]
> BattlEye's RCON variant of this command is **#captureFrame**

## Syntax

```sqf
diag_captureFrame frame
```

**Parameters:**

- `frame`: [Number](../topics/Number.md) - next n-th frame to be captured

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
diag_captureFrame 1; // capture the first frame after command execution
```

### Example 2

```sqf
diag_captureFrame 24; // capture 24th frame after command execution
```

## See also

Arma 3: Diagnostics Exe · Performance Profiling · Arma 3: Cheats · Multiplayer Server Commands · [diag_captureFrameToFile](../commands/diag_captureFrameToFile.md) · [diag_captureSlowFrame](../commands/diag_captureSlowFrame.md) · diag logSlowFrame · [logEntities](../commands/logEntities.md) · [exportJIPMessages](../commands/exportJIPMessages.md)

<sub>Source: [BI Community Wiki — diag captureFrame](https://community.bistudio.com/wiki/diag_captureFrame) (revision 379089).</sub>