12.3. Debrief Properties
12.3.1. Introduction
Debrief uses a text file to store the Most Recently Used file list and an assortment of properties.
The file is named d2ksettings.prp, and is located in the directory from which Debrief is started. If such a file is not present in the startup directory, it will be created as the application exits.
The Most Recently Used file list stores itself into the properties file, appearing as a series of entries beginning with the letters MRU.
 | Note that when Debrief closes it over-writes the existing properties file (since it needs to add the new MRU items). So, if you want to make manual edits to the properties file, make sure you do it with Debrief closed. |
12.3.2. Definitions
Table 12-3. Debrief properties
Property |
Description |
Example | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
XML_Directory |
Default location to use for opening and saving Debrief Plot-Files | D\:\\Plots | ||||||||||||
|
REP_Directory |
Default location to use for importing Replay files | D\:\\Tracks | ||||||||||||
|
RANGE_Directory |
Default location to use for importing Range data files | D\:\\RANGE_DATA | ||||||||||||
|
ETOPO_Directory |
Optional property to specify the location of the ETOPO dataset (when not installed with Debrief) | ETOPO (relative references may be used, the path is produced relative to the Debrief installation directory). | ||||||||||||
|
VPF_DATABASE_DIR.x |
Multiple entries of this property (where x is an ascending integer counter) are specified to inform Debrief where the VPF datasets are located. |
C\:\\vpf\\SASAUS | ||||||||||||
|
WMF_Directory |
Default destination for Windows Metafile plots, and the destination for recorded video files | D\:\\Plots | ||||||||||||
|
STEP_THRESHOLD |
Period (in seconds) either side of current Tote time for which data points are visible in snail mode |
30 | ||||||||||||
|
RNG_UNITS |
The units to display when measuring range and bearing using the mouse. One of the following:
The units used for measurement of range (both using the range-bearing tool and for the ranges displayed in the Tote) may be edited within Debrief by double-clicking on the measured range/bearing value at the bottom left of the Tote. |
nm |
12.3.3. Syntax
The following paragraph is the technical description of this file, which provides background information regarding the formatting used in the file:
Reads a property list (key and element pairs) from the input stream.
A line that contains only whitespace or whose first non-whitespace character is an ASCII # or ! is ignored (thus, # or ! indicate comment lines).
Every line other than a blank line or a comment line describes one property to be added to the table (except that if a line ends with \, then the following line, if it exists, is treated as a continuation line, as described below). The key consists of all the characters in the line starting with the first non-whitespace character and up to, but not including, the first ASCII =, :, or whitespace character. All of the key termination characters may be included in the key by preceding them with a \. Any whitespace after the key is skipped; if the first non-whitespace character after the key is = or :, then it is ignored and any whitespace characters after it are also skipped. All remaining characters on the line become part of the associated element string. Within the element string, the ASCII escape sequences \t, \n, \r, \\, \", \', \ (a backslash and a space), and \\uxxxx are recognized and converted to single characters. Moreover, if the last character on the line is \, then the next line is treated as a continuation of the current line; the \ and line terminator are simply discarded, and any leading whitespace characters on the continuation line are also discarded and are not part of the element string.
As an example, each of the following three lines specifies the key "Truth" and the associated element value "Beauty":
Truth = Beauty
Truth:Beauty
Truth : Beauty
12.3.4. Example File
#d2ksettings.prp
#Thu Sep 21 12:55:40 GMT+01:00 2000
MRU.4=d\:\\single.dpl
REP_Directory=D\:\\medsaw
WMF_Directory=D\:\\
MRU.3=D\:\\short.dpl
MRU.2=D\:\\withCoast.dpl1
MRU.1=D\:\\coast2.dpl
MRU.0=D\:\\coast3.dpl
XML_Directory=D\:\\