{"name":"BIS_fnc_diagAAR","title":"BIS fnc diagAAR","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_diagAAR","revid":379560,"updated":"2026-10-31T13:52:21Z","groups":["Diagnostic"],"status":"ok","games":{"arma3":"1.00"},"since":"arma3 1.00","arma3_since":"1.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 (recording is enabled by `diagAAR = 1;` in the mission's Description.ext), which are stored in profileNamespace in the variable \"BIS_fnc_diagAAR_data\".\n\n> [!IMPORTANT]\n> BIS_fnc_diagAARrecord **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.\n\nThe display lists the recorded missions of the current world and their recordings:\n\n- 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\n- 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\n\nKeys:\n\n- <kbd>Space</kbd> - pause / resume the playback\n- <kbd>I</kbd> - cycle unit labels: none, unit identifier, unit type, damage\n- <kbd>Del</kbd> - delete the selected recording; <kbd>⇧ Shift</kbd> + <kbd>Del</kbd> - delete all recordings of the selected mission\n- <kbd>Esc</kbd> - quit the display (after confirmation)\n\nAll modes except \"Init\" are used internally by the Event Handlers that \"Init\" adds to the display.","syntaxes":[{"syntax":"[] call BIS_fnc_diagAAR","params":[],"returns":{"type":"Boolean","type_expr":"Boolean","description":"true if the AAR display (\"RscDisplayAAR\") was created, as returned by createDialog"}},{"syntax":"[mode, arguments] call BIS_fnc_diagAAR","params":[{"name":"mode","type":"String","description":"can be one of:\n\n- \"Init\" - Fill display with AAR data\n- \"Init_List\" - *internal function usage*\n- \"Display_keydown\" - *internal function usage*\n- \"Timeline_sliderposchanged\" - *internal function usage*\n- \"ListMissions_lbselchanged\" - *internal function usage*\n- \"ListSessions_lbselchanged\" - *internal function usage*; it plays the recording in a loop and must be spawned\n- \"draw\" - *internal function usage*","type_expr":"String"},{"name":"arguments","type":"Array","description":"Array\n\n- \"Init\" arguments: [display]: Display\n- \"Init_List\" arguments: [display]: Display\n- \"Display_keydown\" arguments: see onKeyDown event\n- \"Timeline_sliderposchanged\" arguments: see onSliderPosChanged event\n- \"ListMissions_lbselchanged\" arguments: see onLBSelChanged event\n- \"ListSessions_lbselchanged\" arguments: see onLBSelChanged event\n- \"draw\" arguments: see onDraw event","type_expr":"Array","text":"arguments: Array\n\n- \"Init\" arguments: [display]: Display\n- \"Init_List\" arguments: [display]: Display\n- \"Display_keydown\" arguments: see onKeyDown event\n- \"Timeline_sliderposchanged\" arguments: see onSliderPosChanged event\n- \"ListMissions_lbselchanged\" arguments: see onLBSelChanged event\n- \"ListSessions_lbselchanged\" arguments: see onLBSelChanged event\n- \"draw\" arguments: see onDraw event"}],"returns":{"type":"Boolean","type_expr":"Boolean","description":"for \"Display_keydown\" (true for Esc and Space, which overrides the default action of these keys), Nothing for the other modes","text":"Boolean for \"Display_keydown\" (true for <kbd>Esc</kbd> and <kbd>Space</kbd>, which overrides the default action of these keys), Nothing for the other modes"}}],"examples":[{"code":["[] call BIS_fnc_diagAAR; // opens the AAR display"]},{"code":["[\"Init\", [_anAARDisplay]] call BIS_fnc_diagAAR;"]}],"see_also":["BIS_fnc_diagAARrecord"]}