Annotation

There are two types of instances in the Video Editor: Bounding Boxes and Events. Use Bounding Boxes to annotate objects and Events to annotate conditions such as weather or noise.

Bounding box

Create bounding box

To annotate with a Bounding Box:

  1. In the left panel, select the Bounding Box tool or press X on the keyboard.
  2. Click on the image and drag the cursor to draw a Bounding Box.
  3. Let go of the click.

When you add a Bounding Box, it will be added to the frame where you created it and the following frames.

To limit a Bounding Box between two timeframes:

  1. Create a Bounding Box. The instance will be stretched till the end of the video.
  2. Pause the video where you want your instance to end.
  3. In the right panel, turn off the interpolation toggle that corresponds to the instance.

📘

A white icon appears on the timeline whenever you change the location of an instance. The icon is located at the point in time where you made the change.

Interpolate Bounding Box

What is Bounding Box interpolation?

Bounding Box interpolation is the process of changing the location or size (or both) of a Bounding Box between two different timeframes without having to make the changes on every frame.

Let's say you want to move a Bounding Box between Point A (timestamp: 00:00:10.539) and Point B (timestamp: 00:00:19.482). Instead of making the changes on every frame between Point A and Point B, you make the changes only on the main frames interpolate the modifications between the main frames.

Here's an example:

Suppose you want to annotate a car that goes from Point A (timestamp: 00:00:10.539) to Point B (timestamp: 00:00:19.482). You do that by adding a Bounding Box on Point A and change the location and the size of the Bounding Box (if needed) on the main frames (not every single frame) until you reach Point B. With interpolation, the location and size of the Bounding Box will be modified between the main frames that you annotated, saving you time and resources.

To interpolate a Bounding Box:

  1. Create a Bounding Box. Let’s call the location of the Bounding Box Point A.
  2. Go to the timeframe where you want to change the location of the Bounding Box.
  3. Change the location of the Bounding Box. Let’s call this location Point B.
  4. Go back to the previous timeframe and play the video. The Bounding Box now moves between Point A and Point B.

Copy Bounding Box

To copy a Bounding Box:

  1. Select the instance.
  2. Press Ctrl+C on the keyboard to copy the instance.
  3. Press Ctrl+V on the keyboard to paste the instance.

Delete Bounding Box

To delete a Bounding Box:

  1. Select the instance.
  2. Press the Backspace or the Delete keys on the keyboard.

📘

To delete all the instances in a video:

  1. In the right panel, click the delete button.
  2. In the popup, choose Yes.

Point label

Add point label

To add a point label:

  1. Select a Bounding Box.
  2. Right-click on a point.
  3. Type a name.
  4. Click the checkmark.

📘

A white icon appears on the timeline whenever you add a point label to an instance. The icon is located at the point in time where you added the point label.

Delete point label

There are 2 ways to delete a point label:

Method 1:

  1. Select an instance.
  2. Right-click on a point.
  3. Click the delete button.

Method 2:

  1. Find the instance in the right panel and expand it.
  2. Click Point labels.
  3. Delete the point label(s) you want.

Event

Use Events when you want to detect a condition, not an object, such as weather. For example, you can’t use Bounding Boxes to classify snow, rain, or fog. That’s a case where you need to use Events.

You can also use Events when the location of your object isn’t necessary. For instance, if you need to indicate that there are people in a room, but you don’t want to track them, you can use Events instead of Bounding Boxes.

Create Event

To create an Event:

  1. In the left panel, click Event or press E on the keyboard.
  2. Hover over the timeline and place the cursor where you want the Event to start.
  3. Click on the + button. The Event will be interpolated (stretched) till the end of the video.
  4. Hover over the timeline and place the cursor where you want the Event to end.
  5. Click the checkmark button.
    OR
    On the timeline, click where you want the Event to end. Next, turn off the interpolation toggle that corresponds to the Event in the right panel.
    OR
    Pause the video where you want the Event to end and press the Delete key on the keyboard.

View Events

To view all the Events:

  1. Hover over any Event on the timeline.
  2. Click All Events.

The list shows all the Events that appear at the mentioned time. In the image above, the Event that appears in the list is “Sunny weather” because it is the only Event that is present at 00:00:14.417.

🚧

When you click All Events, you’ll be able to see all the Events on the timeline in addition to the Bounding Boxes.

Edit Event

To edit an Event:

  1. Right-click on the Event.
  2. Edit the class/attribute(s).

Delete Event

To delete an Event:

  1. In the right panel, find the Event.
  2. Click its corresponding delete button.

To delete the Events that have the same class:

  1. In the right panel, find the class whose Events you want to delete.
  2. Click the delete button next to the class.

To delete all the Events:

  1. At the top of the right panel, click the delete button.
  2. In the popup, choose Yes.

Stretch instance

To stretch a Bounding Box or Event on the timeline:

  1. Select an instance in the right panel or double-click on the instance in the timeline.
  2. Hover over the first or last keyframe of any instance.
  3. Drag the keyframe to the left or the right to resize the instance.

❗️

You can’t drag a keyframe over another keyframe.

🚧

You can drag a keyframe inside an instance to change its timestamp.

Keyframes

Jump between the keyframes of an instance

To jump between the keyframes of an instance:

  1. Select an instance.
  2. Press Shift+Right arrow on the keyboard to go to the next keyframe and Shift+Left arrow to go to the previous keyframe.

❗️

The shortcut doesn’t work if the instance is hidden.

Delete keyframe

To delete a keyframe:

  1. Select a keyframe.
  2. Press the Delete or the Backspace keys on the keyboard.

❗️

  • You can’t delete the first and last keyframes of an instance.
  • A keyframe indicates a modification has been made to the instance. This modification can be adding an attribute or multiple attributes, changing the location of the instance, and changing the size of the instance. So when you delete a keyframe, the changes will be deleted, too.

Zoom in/out video timeline

To zoom in the timeline, place your cursor on the timeline and scroll up your mouse wheel or swipe up on your touchpad.

To zoom out the timeline, place your cursor on the timeline and scroll down your mouse wheel or swipe down on your touchpad.

Custom time length to jump forward and backward

To adjust the time length to jump forward or backward:

  1. In the top panel of the Video Editor, click the settings button.
  2. Type a number in the boxes corresponding to Jump forward and Jump backward. You can type decimals.
  3. Click outside the dropdown menu to apply the changes.

Did this page help you?