site/content/en/docs/annotation/manual-annotation/modes/3d-object-annotation.md
Use the 3D Annotation tool for labeling 3D objects and scenes, such as vehicles, buildings, landscapes, and others.
Check out:
The 3D annotation canvas looks like the following:
{{% alert title="Note" color="primary" %}} If you added contextual images to the dataset, the canvas will include them. For more information, consult {{< ilink "/docs/annotation/manual-annotation/utilities/contextual-images" "Contextual images" >}} {{% /alert %}}
For information on the available tools, consult {{< ilink "/docs/annotation/annotation-editor/controls-sidebar" "Controls sidebar" >}}.
You can navigate, using the mouse, or navigation keys:
You can also use keyboard shortcuts to navigate:
| Action | Keys |
|---|---|
| Camera rotation | Shift + Arrow (Up, Down, Left, Right) |
| Left/Right | Alt+J/ Alt+L |
| Up/down | Alt+U/ Alt+O |
| Zoom in/ou | Alt+K/ Alt+I |
There are two options available for 3D annotation:
To add a 3D shape:
On the objects pane, select Draw new cuboid > select the label from the drop-down list > Shape.
The cursor will be followed by a cuboid. Place the cuboid on the 3D scene.
Use projections to adjust the cuboid. Click and hold the left mouse button to edit the label shape on the projection.
(Optional) Move one of the four points to change the size of the cuboid.
(Optional) To rotate the cuboid, select the middle point and then drag the cuboid up/down or to left/right.
To track with cuboids:
On the objects pane, select Draw new cuboid > select the label from the drop-down list > Track.
The cursor will be followed by a cuboid. Place the cuboid on the 3D scene.
Use projections to adjust the cuboid. Select and hold the left mouse button to edit the label shape on the projection.
(Optional) Move one of the four points to change the size of the cuboid.
(Optional) To rotate the cuboid, click on the middle point and then drag the cuboid up/down or to left/right.
Move several frames forward. You will see the cuboid you've added in frame 1. Adjust it, if needed.
Repeat to the last frame with the presence of the object you are tracking.
For more information about tracking, consult {{< ilink "/docs/annotation/manual-annotation/shapes/track-mode-basics" "Track mode" >}}.
As well as 2D-task objects, 3D-task objects support the ability to change appearance, attributes, properties and have an action menu. Read more in {{< ilink "/docs/annotation/annotation-editor/objects-sidebar" "objects sidebar" >}} section.
If you hover the cursor over a cuboid and press Shift+N, the cuboid will be cut,
so you can paste it in other place (double-click to paste the cuboid).
As well as in 2D task you can copy and paste objects by Ctrl+C and Ctrl+V,
but unlike 2D tasks you have to place a copied object in a 3D space (double click to paste).
You can copy or save the projection-window image by left-clicking on it and selecting a "save image as" or "copy image".
The feature enables or disables the display of cuboid orientation arrows in the 3D space. It is controlled by a checkbox located in the appearance block. When enabled, arrows representing the cuboid's axis orientation (X - red, Y - green, Z - blue) are displayed, providing a visual reference for the cuboid's alignment within the 3D environment. This feature is useful for understanding the spatial orientation of the cuboid.
The size input feature allows users to manually specify the dimensions of a cuboid in the 3D space. This feature is accessible through the objects sidebar - details panel, where you can input precise values for the width, height, and length (X - width, Y - height, Z - length) of the cuboid. By entering these values, the cuboid's size is adjusted accordingly to its orientation, providing greater control and accuracy when annotating objects in 3D tasks.