User manual

XCSoar User Manual
12.11 Flight logs
The software flight logger generates IGC files (extension .igc)
according to the long naming convention described in the FAI
document Technical Specification for IGC-Approved GNSS Flight
Recorders. These files can be imported into other programs for
analysis after flight.
The flight logs replay facility allows the files to include embedded
commands to control XCSoar as if the user was interacting with
the program. It does this by defining a special use for the general-
purpose ‘pilot event’ IGC sentence:
LPLT event=StatusMessage Hello everybody
This command will bring up a status message with the text “Hello
everybody” when the line is reached during replay.
A future version of the flight logger will allow all input events to
be stored in the IGC file in this fashion, thus replaying the flight
will give a very faithful reproduction of the actual flight and how
the software was used. This is expected to be useful for training
and coaching purposes.
The internal software logger has adjustable time steps, separate for
cruise and circling modes, via parameters in the configuration set-
tings. Typically the circling time step is set to a smaller value than
cruise in order to give good quality flight logs for replay purposes.
12.12 Input events
The input event file (extension .xci) is a plain text file designed
to control the input and events in your glide computer.
You do not require access to the source code or understanding of
programming to write your own input event files but you do re-
quire some advanced understanding of XCSoar and of gliding.
Some reasons why you might like to use xci:
• Modify the layout of button labels
• Support a new set or layout of buttons (organiser hardware
buttons)
• Support an external device such as a bluetooth keyboard or
gamepad
• Customise any button/key event
• Do multiple events from one key or glide computer triggered
process
157