BIS_fnc_diagAAR

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".

Important

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.

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:

• Space - pause / resume the playback
• I - cycle unit labels: none, unit identifier, unit type, damage
• Del - delete the selected recording; ⇧ Shift + Del - delete all recordings of the selected mission
• Esc - 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

[] call BIS_fnc_diagAAR

Returns: Boolean - true if the AAR display ("RscDisplayAAR") was created, as returned by createDialog

Syntax 2

[mode, arguments] call BIS_fnc_diagAAR

Parameters:

• mode: String - 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
  • "draw" - internal function usage

• arguments: Array

  • "Init" arguments: [display]: Display
  • "Init_List" arguments: [display]: Display
  • "Display_keydown" arguments: see onKeyDown event
  • "Timeline_sliderposchanged" arguments: see onSliderPosChanged event
  • "ListMissions_lbselchanged" arguments: see onLBSelChanged event
  • "ListSessions_lbselchanged" arguments: see onLBSelChanged event
  • "draw" arguments: see onDraw event

Returns: Boolean for "Display_keydown" (true for Esc and Space, which overrides the default action of these keys), Nothing for the other modes

Examples

Example 1

[] call BIS_fnc_diagAAR; // opens the AAR display

Example 2

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

See also

BIS_fnc_diagAARrecord