3.3. Adding drawing features

3.3.1. Label
3.3.2. Ellipse
3.3.3. Polygon
3.3.4. Rectangle, Circle, Line, Arc
3.3.5. General

The Drawing toolbar and menu are used to place geographic features on the plot; features which are geographically fixed. In general, when you create them, their corners must be specified by copying a location from the plot and posting it into the property of the relevant corner.

Figure 3.13. Drawing toolbar

Drawing toolbar


By default, new drawing features are placed in the Misc layer, from where they can be moved to other layers as required. If you're creating lots of drawing features, and want to place them directly into target layers, select on Manually select target layer from the top of the Drawing menu. When this setting is ticked, Debrief will prompt you to select a target layer for each new drawing feature added to the plot. Clear the ticked setting to return the target layer to the Misc layer.

3.3.1. Label

The Label drawing item allows you to place a labelled symbol on the plot. Typically this may be used to annotate events on the plot, or to add an extra feature which did not warrant its own Debrief REP entry. Like all annotations Labels have time start and end properties. Because of this they can be placed on the Tote (see Section 4.1.1, “Tote area”) and used in analysis, as you will learn later.


A custom editor is supplied (see below) for editing locations of data items, it is used frequently in Debrief. Clicking on the expand button will let you edit individual lat/long fields (shown in figure Figure 3.15, “Location Editor (expanded view)”). Alternatively, you may set the location to a specific point on the plot. Right-click on the plot and select Copy cursor location. Then click once on the location editor to reveal the Paste button (shown in Figure 3.16, “Location Editor (paste view)”), and click it to paste the cursor location.

Figure 3.14. Location Editor (initial view)

Location Editor (initial view)

Figure 3.15. Location Editor (expanded view)

Location Editor (expanded view)

Figure 3.16. Location Editor (paste view)

Location Editor (paste view)


Note that the text for the label itself can be a multi-line piece of text. When in the text-editor box for the label, just press the return key on your keyboard to move to the next line. The multi-line piece of text will be centre formatted on screen according to the Label Location property. The multi-line label is also available for all labels on the Debrief plot. Note that when the label is stored to disk in the Debrief plot-file format, the '\n' character used internally to represent the new line is converted to a '\\n' string to allow its easy storage.

3.3.2. Ellipse

The Ellipse shape works in much the same way as a Label, except an ellipse is drawn on the plot instead of the labelled symbol. The size of the ellipse is dictated by the Maxima and Minima values which specify the lengths of its semi-major and semi-minor axes, expressed in user-selectable distance units. These values are the distances from the centre of the ellipse to the furthest and closest points on its perimeter, respectively. The direction of the ellipse is specified by the orientation, expressed in degrees. Debrief does not check that the maxima is larger that the minima, it merely plots an ellipse oriented about the semi-major axis.

3.3.3. Polygon

The Polygon drawing feature allows more varied shapes to be plotted within Debrief. A series of points (called a Path) are added to a Shape which are the connected up to create a Polygon. The points in the path may be typed in, double-clicked, or dragged to produce the correct polygon.

When a new polygon is created, its editor panel will open as shown below:

Figure 3.17. Initial view of polygon

Initial view of polygon

The properties shown are similar to those shown for most other shapes, with the exception of the actual locations of the polygon. Change the location of the nodes that form the polygon by selecting them in the Outline View then editing them the Properties View (see Figure 3.1, “Properties view”). New nodes are created by right-clicking on the Polygon (in the Outline View or on the Plot), and selecting Add Node.

3.3.4. Rectangle, Circle, Line, Arc

The Rectangle, Circle and Line shapes work in the same way as the others described here, the Location Editor described above being used to set the corners, centre, or ends as required.


Some of the more basic drawing items have a single DTG parameter instead of TimeStart and Time_End properties. Where there is a single time, the time-analytical features of Debrief (such as Snail mode) treat the feature as alive for three minutes either side of the time value.


To draw a line created from an origin with values of range and bearing, first create the line, and put the start point of the line at the origin. Now switch the mouse mode to Range/Bearing ( ). Now click on the button labelled Select Point for LineStart, and drag the mouse out from the origin point. The current range and bearing will be displayed at the bottom-left of the screen. When the mouse is at the desired range and bearing right-click and copy the position onto the clipboard. Next, paste that location into the LineEnd value.


In Summer 2013 the Line Shape annotation received some love and gained new capabilities. One is the ability to have an arrow displayed at one end. This is useful in indicating the direction of travel, or in highlighting a particular location. The second capability is Show Auto Calc - this displays the calculated range and bearing 1/2 way along the line. Unfortunately this label is only visible on screen - the structure Windows Metafile format doesn't allow us to copy the rotated text across the clipboard to copy it into MS Word. So, you'll only get this rotated text in MS Word is you capture a screenshot, using software such as SnagIt or Hypercam. If you do want to include such a label in your analysis report, and you wish to copy/paste the image via the clipboard, then you can always manually put the range/bearing into the line label, and specify that the label be shown 1/2 way along the line.

Figure 3.18. Calculated Label

Calculated Label

3.3.5. General

To edit any existing annotation, double on it on the plot or the Outline View to select it - its attributes will then be available from the Properties View. Alternatively, right-click on an item on the Plot or Outline View, and editable attributes are available from the object's drop-down list. Only boolean (true/false) and list-related (top/bottom/left/right etc) are editable from the right-click menu.