Annotation user interface

Annotations are used to document key points, add commentary, drawings or insert reference images into the video. Certain tools can also be used to measure times, repetitions, angles or distances.

The following screenshot describes the parts of the interface used for annotating videos.

../_images/annotations-ui.jpg

Some annotation features are not immediately visible in the screenshot

Annotations can be saved and loaded using annotation files.

Certain external formats can be imported, see importing data.

Annotation toolbar

../_images/annotation-toolbar.png

The left part of the toolbar has the following general function buttons:

Hand

Manipulates drawings or pans the image.

KeyImage

Adds a key image at the current time.

Commentary

Toggles the annotation pane.

The rest of the toolbar has the drawing tools.

There are more tools than those immediately visible. Buttons with a small arrowhead in the top-left corner contain other tools that can be accessed by doing a right click or a long click (click and hold) on the button.

../_images/tools_notch.png

A flying menu opens with the extra tools available.

../_images/subtools.png

For a description of the individual drawing tools see General annotation tools, Posture annotation tools, Measuring time, Counting events and measuring cadence, Measuring angles, Measuring positions and distances.

To stop using a particular tool and come back to the hand tool you can also use the Escape key.

Tip

You can use the middle mouse button to directly manipulate drawings without switching to the hand tool.

List of key images

../_images/keyimagelist.png

The list of key images presents an overview of all added key images. It can be used to delete or move them in time using the context menu or dragging them to the timeline.

More about key images can be found in Key images.

Tip

You can close down this area by clicking the down arrow at the right of the annotation toolbar or by double-clicking the annotation toolbar.

Drawings

Drawings are vector-based, they can be manipulated and resized after they have been added to the video.

They have a context menu that can be used to access tool-specific functions, copy and paste, and deletion.

For a description of the individual drawing tools see General annotation tools, Posture annotation tools, Measuring time, Counting events and measuring cadence, Measuring angles, Measuring positions and distances.

For editing style and opacity options see Drawings properties.

The drawings can be attached to filmed objects even when the camera is moving, see Camera compensated annotations.

Warning

Drawings are created in key images. Deleting the key image deletes all the drawings in it.

Annotation pane

The annotation pane has tabs to edit key images and drawings.

../_images/annotation-pane-tabs.png

TabKF

Key images

TabDrawings

Drawings properties

TabTracking

/tracking/object_tracking

Other tools

Some tools are not part of the annotation toolbar and can be found in other places in the interface.

  • Trajectory objects are created by right clicking the video viewport and menu Track path

  • The coordinate system is available in the main menu Tools ‣ Coordinate System

  • The camera test grid is available in the main menu Tools ‣ Camera Test Grid

  • Inserting an image or SVG as a reference is done using the main menu Tools ‣ Import Image

Big pointers

For presentation purposes the hand tool can use a large image instead of the normal cursor. To enable this mode go to the main menu Options ‣ Pointers and select a pointer from there. This list of image-based pointers can be customized by adding new images to the “Pointers” directory under application data.

../_images/pointer-big-hand.jpg

Background layer

The background layer sits between the video image and the drawings. It can be used to make the drawings more visible against the video or, at full opacity, show only the annotations and trajectories on a plain background.

To change the background layer color and opacity right click in the background of the video and choose Background…. This option is also available in the main menu Tools ‣ Background…

../_images/background-opacity.jpg