diff --git a/cvat/apps/documentation/static/documentation/images/CuboidDrawing1.gif b/cvat/apps/documentation/static/documentation/images/CuboidDrawing1.gif deleted file mode 100644 index 42b31b06e217..000000000000 Binary files a/cvat/apps/documentation/static/documentation/images/CuboidDrawing1.gif and /dev/null differ diff --git a/cvat/apps/documentation/static/documentation/images/CuboidDrawing2.gif b/cvat/apps/documentation/static/documentation/images/CuboidDrawing2.gif deleted file mode 100644 index 2cb55487ec4e..000000000000 Binary files a/cvat/apps/documentation/static/documentation/images/CuboidDrawing2.gif and /dev/null differ diff --git a/cvat/apps/documentation/static/documentation/images/CuboidDrawing3.gif b/cvat/apps/documentation/static/documentation/images/CuboidDrawing3.gif deleted file mode 100644 index 533a6ae02e68..000000000000 Binary files a/cvat/apps/documentation/static/documentation/images/CuboidDrawing3.gif and /dev/null differ diff --git a/cvat/apps/documentation/static/documentation/images/CuboidEditing1.gif b/cvat/apps/documentation/static/documentation/images/CuboidEditing1.gif deleted file mode 100644 index 6d241778b475..000000000000 Binary files a/cvat/apps/documentation/static/documentation/images/CuboidEditing1.gif and /dev/null differ diff --git a/cvat/apps/documentation/static/documentation/images/CuboidEditing2.gif b/cvat/apps/documentation/static/documentation/images/CuboidEditing2.gif deleted file mode 100644 index 13adf27a602e..000000000000 Binary files a/cvat/apps/documentation/static/documentation/images/CuboidEditing2.gif and /dev/null differ diff --git a/cvat/apps/documentation/static/documentation/images/EditingPerspective.gif b/cvat/apps/documentation/static/documentation/images/EditingPerspective.gif deleted file mode 100644 index d836019ad56a..000000000000 Binary files a/cvat/apps/documentation/static/documentation/images/EditingPerspective.gif and /dev/null differ diff --git a/cvat/apps/documentation/static/documentation/images/gif017_mapillary_vistas.gif b/cvat/apps/documentation/static/documentation/images/gif017_mapillary_vistas.gif new file mode 100644 index 000000000000..8412549dafc0 Binary files /dev/null and b/cvat/apps/documentation/static/documentation/images/gif017_mapillary_vistas.gif differ diff --git a/cvat/apps/documentation/static/documentation/images/gif018_mapillary_vistas.gif b/cvat/apps/documentation/static/documentation/images/gif018_mapillary_vistas.gif new file mode 100644 index 000000000000..38e1851b2756 Binary files /dev/null and b/cvat/apps/documentation/static/documentation/images/gif018_mapillary_vistas.gif differ diff --git a/cvat/apps/documentation/static/documentation/images/gif020_mapillary_vistas.gif b/cvat/apps/documentation/static/documentation/images/gif020_mapillary_vistas.gif new file mode 100644 index 000000000000..20f46a04a2dc Binary files /dev/null and b/cvat/apps/documentation/static/documentation/images/gif020_mapillary_vistas.gif differ diff --git a/cvat/apps/documentation/static/documentation/images/image091.jpg b/cvat/apps/documentation/static/documentation/images/image091.jpg index 2d04019aefea..90e7528ff2a7 100644 Binary files a/cvat/apps/documentation/static/documentation/images/image091.jpg and b/cvat/apps/documentation/static/documentation/images/image091.jpg differ diff --git a/cvat/apps/documentation/static/documentation/images/image177_mapillary_vistas.jpg b/cvat/apps/documentation/static/documentation/images/image177_mapillary_vistas.jpg new file mode 100644 index 000000000000..482d3c999e2f Binary files /dev/null and b/cvat/apps/documentation/static/documentation/images/image177_mapillary_vistas.jpg differ diff --git a/cvat/apps/documentation/static/documentation/images/image178_mapillary_vistas.jpg b/cvat/apps/documentation/static/documentation/images/image178_mapillary_vistas.jpg new file mode 100644 index 000000000000..22a169fa08fe Binary files /dev/null and b/cvat/apps/documentation/static/documentation/images/image178_mapillary_vistas.jpg differ diff --git a/cvat/apps/documentation/static/documentation/images/image179_mapillary_vistas.jpg b/cvat/apps/documentation/static/documentation/images/image179_mapillary_vistas.jpg new file mode 100644 index 000000000000..fe661a27d9ce Binary files /dev/null and b/cvat/apps/documentation/static/documentation/images/image179_mapillary_vistas.jpg differ diff --git a/cvat/apps/documentation/static/documentation/images/image180_mapillary_vistas.jpg b/cvat/apps/documentation/static/documentation/images/image180_mapillary_vistas.jpg new file mode 100644 index 000000000000..eced274d6a9c Binary files /dev/null and b/cvat/apps/documentation/static/documentation/images/image180_mapillary_vistas.jpg differ diff --git a/cvat/apps/documentation/static/documentation/images/image182_mapillary_vistas.jpg b/cvat/apps/documentation/static/documentation/images/image182_mapillary_vistas.jpg new file mode 100644 index 000000000000..1248ddc3ee59 Binary files /dev/null and b/cvat/apps/documentation/static/documentation/images/image182_mapillary_vistas.jpg differ diff --git a/cvat/apps/documentation/user_guide.md b/cvat/apps/documentation/user_guide.md index a1749cef4a80..ed58ea886a44 100644 --- a/cvat/apps/documentation/user_guide.md +++ b/cvat/apps/documentation/user_guide.md @@ -1110,58 +1110,74 @@ automatically. You can adjust the polyline after it has been drawn. ## Annotation with cuboids It is used to annotate 3 dimensional objects such as cars, boxes, etc... -Currently the feature supports one point perspective and has the contraint +Currently the feature supports one point perspective and has the constraint where the vertical edges are exactly parallel to the sides. ### Creating the cuboid -Before starting, you have to be sure that ``Cuboid`` is selected. +Before you start, you have to make sure that Cuboid is selected + and choose a drawing method ”from rectangle” or “by 4 points”. -Press ``N`` for entering drawing mode. There are many ways to draw a cuboid. -You may draw the cuboid by placing 4 points, after which the drawing completes automatically. -The first 3 points will represent a plane of the cuboid -while the last point represents the depth of that plane. -For the first 3 points, it is recomended to only draw the 2 closest side faces, -as well as the top and bottom face. +![](static/documentation/images/image091.jpg) + +#### Drawing cuboid by 4 points + +Choose a drawing method “by 4 points” and click Shape to enter the drawing mode. There are many ways to draw a cuboid. +You can draw the cuboid by placing 4 points, after that the drawing will be completed automatically. +The first 3 points determine the plane of the cuboid while the last point determines the depth of that plane. +For the first 3 points, it is recommended to only draw the 2 closest side faces, as well as the top and bottom face. A few examples: -![](static/documentation/images/CuboidDrawing1.gif) -![](static/documentation/images/CuboidDrawing2.gif) +![](static/documentation/images/image177_mapillary_vistas.jpg) + +### Drawing cuboid from rectangle + +Choose a drawing method “from rectangle” and click Shape to enter the drawing mode. +When you draw using the rectangle method, you must select the frontal plane of the object using the bounding box. +The depth and perspective of the resulting cuboid can be edited. -![](static/documentation/images/CuboidDrawing3.gif) +Example: + +![](static/documentation/images/image182_mapillary_vistas.jpg) ### Editing the cuboid -The cuboid can be edited in multiple ways, by dragging points or by dragging certain faces. -First notice that there is a face that is painted with pink lines only, let us call it the front face. +![](static/documentation/images/image178_mapillary_vistas.jpg) + +The cuboid can be edited in multiple ways: by dragging points, by dragging certain faces or by dragging planes. +First notice that there is a face that is painted with gray lines only, let us call it the front face. -The cuboid can be moved by simply dragging the shape as normal. +You can move the cuboid by simply dragging the shape behind the front face. The cuboid can be extended by dragging on the point in the middle of the edges. The cuboid can also be extended up and down by dragging the point at the vertices. -![](static/documentation/images/CuboidEditing1.gif) +![](static/documentation/images/gif017_mapillary_vistas.gif) -To draw with perpective effects it is assumed that the front face is the closest to the camera. -To begin simply drag the points on the vertices that are not on the pink/front face while holding ``Shift``. +To draw with perspective effects it should be assumed that the front face is the closest to the camera. +To begin simply drag the points on the vertices that are not on the gray/front face while holding ``Shift``. The cuboid can then be edited as usual. -![](static/documentation/images/EditingPerspective.gif) +![](static/documentation/images/gif018_mapillary_vistas.gif) -If you wish to reset perspective effects, you may right click on cuboid, -and select ``Reset Perspective`` to return to a regular cuboid. +If you wish to reset perspective effects, you may right click on the cuboid, +and select ``Reset perspective`` to return to a regular cuboid. -The location of the pink face can be swapped with the adjacent visible side face. -This is done by right clicking on the cuboid and selecting ``Switch Perspective Orientation``. +![](static/documentation/images/image180_mapillary_vistas.jpg) + +The location of the gray face can be swapped with the adjacent visible side face. +You can do it by right clicking on the cuboid and selecting ``Switch perspective orientation``. Note that this will also reset the perspective effects. -![](static/documentation/images/ResetPerspective.gif) +![](static/documentation/images/image179_mapillary_vistas.jpg) Certain faces of the cuboid can also be edited, -these faces are the left, right and dorsal faces, relative to the pink face. +these faces are: the left, right and dorsal faces, relative to the gray face. Simply drag the faces to move them independently from the rest of the cuboid. -![](static/documentation/images/CuboidEditing2.gif) +![](static/documentation/images/gif020_mapillary_vistas.gif) + +You can also use cuboids in track mode, similar to rectangles in track mode ([basics](#track-mode-basics) and [advanced](#track-mode-advanced)) ## Annotation with points