---
name: "BIS_fnc_diagAAR"
type: function
status: ok
groups: ["Diagnostic"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_diagAAR
revid: 379560
updated: 2026-10-31T13:52:21Z
---

# BIS_fnc_diagAAR

*Function · Diagnostic · Arma 3 v1.00*

## Description

Opens an **AAR** (After Action Review) display and fills it with data and Event Handlers. The display replays recordings made by [BIS_fnc_diagAARrecord](../functions/BIS_fnc_diagAARrecord.md) (recording is enabled by `diagAAR = 1;` in the mission's [Description.ext](../topics/Description.ext.md)), which are stored in [profileNamespace](../commands/profileNamespace.md) in the variable "BIS_fnc_diagAAR_data".

> [!IMPORTANT]
> [BIS_fnc_diagAARrecord](../functions/BIS_fnc_diagAARrecord.md) **must** have been previously executed to have data to display. If there are no recordings for the current world, the display is closed and an error message is shown.

The display lists the recorded missions of the current world and their recordings:

- selecting a mission draws the player's path from all its recordings on the map, with start and end markers, death markers and circles where the player moved less than 5 m between two steps
- selecting a recording plays it back, one recorded step per second: units are drawn with their side colour (black when dead) and the player is highlighted; the player's deaths are marked in red on the timeline slider, which can be dragged to jump in time

Keys:

- <kbd>Space</kbd> - pause / resume the playback
- <kbd>I</kbd> - cycle unit labels: none, unit identifier, unit type, damage
- <kbd>Del</kbd> - delete the selected recording; <kbd>⇧ Shift</kbd> + <kbd>Del</kbd> - delete all recordings of the selected mission
- <kbd>Esc</kbd> - quit the display (after confirmation)

All modes except "Init" are used internally by the Event Handlers that "Init" adds to the display.

## Syntax

### Syntax 1

```sqf
[] call BIS_fnc_diagAAR
```

**Returns:** [Boolean](../topics/Boolean.md) - [true](../commands/true.md) if the AAR display ("RscDisplayAAR") was created, as returned by [createDialog](../commands/createDialog.md)

### Syntax 2

```sqf
[mode, arguments] call BIS_fnc_diagAAR
```

**Parameters:**

- `mode`: [String](../topics/String.md) - can be one of:

  - "Init" - Fill display with AAR data
  - "Init_List" - *internal function usage*
  - "Display_keydown" - *internal function usage*
  - "Timeline_sliderposchanged" - *internal function usage*
  - "ListMissions_lbselchanged" - *internal function usage*
  - "ListSessions_lbselchanged" - *internal function usage*; it plays the recording in a loop and must be [spawned](../commands/spawn.md)
  - "draw" - *internal function usage*
- `arguments`: [Array](../topics/Array.md)

  - "Init" arguments: [display]: [Display](../topics/Display.md)
  - "Init_List" arguments: [display]: [Display](../topics/Display.md)
  - "Display_keydown" arguments: see [onKeyDown](../topics/User_Interface_Event_Handlers.md#onkeydown) event
  - "Timeline_sliderposchanged" arguments: see [onSliderPosChanged](../topics/User_Interface_Event_Handlers.md#onsliderposchanged) event
  - "ListMissions_lbselchanged" arguments: see [onLBSelChanged](../topics/User_Interface_Event_Handlers.md#onlbselchanged) event
  - "ListSessions_lbselchanged" arguments: see [onLBSelChanged](../topics/User_Interface_Event_Handlers.md#onlbselchanged) event
  - "draw" arguments: see [onDraw](../topics/User_Interface_Event_Handlers.md#ondraw) event

**Returns:** [Boolean](../topics/Boolean.md) for "Display_keydown" ([true](../commands/true.md) for <kbd>Esc</kbd> and <kbd>Space</kbd>, which overrides the default action of these keys), [Nothing](../topics/Nothing.md) for the other modes

## Examples

### Example 1

```sqf
[] call BIS_fnc_diagAAR; // opens the AAR display
```

### Example 2

```sqf
["Init", [_anAARDisplay]] call BIS_fnc_diagAAR;
```

## See also

[BIS_fnc_diagAARrecord](../functions/BIS_fnc_diagAARrecord.md)

<sub>Source: [BI Community Wiki — BIS fnc diagAAR](https://community.bistudio.com/wiki/BIS_fnc_diagAAR) (revision 379560).</sub>