Polygon

Polygon

* Available on image and video items

The polygon annotation tool can be used where complex polygons are needed, rather than rectangles, to define the shape and location of the object in a more precise way.

{
	"type": "segment",
	"label": "cat",
	"attributes": [],
	"coordinates": [
		[
			{
				"x": 229.19232006582056,
				"y": 232.74690570519736
			},
			{
				"x": 201.16548780201249,
				"y": 204.70182873323399
			},
			{
				"x": 211.1104927988476,
				"y": 190.22695029609157
			},
			{
				"x": 176.75502099159895,
				"y": 118.75723801270104
			},
			{
				"x": 121.60544782733136,
				"y": 129.61339684055785
			},
			{
				"x": 199.35730507531518,
				"y": 228.22350619359038
			}
		]
	]
}

Create a Polygon Annotation

1. Go into the annotation studio.
2. Select the Polygon tool .
3. Draw the polygon on the canvas:
   A. Straight lines – click multiple points on the canvas to create a polygon around your target object/item.
   B. Free-hand – click the mouse and keep the button pressed. A polygon vertex will be drawn as you move your mouse. Delete free-hand dots by holding shift and dragging the mouse cursor.
4. Close the polygon to finish its creation phase:
   A. Right-click anywhere to have the last drawn point connected with the first.
   B. Click back on the first point of the polygon to have it closed.
   C. Press ENTER to close the polygon.
   D. Press ESC to cancel polygon creation.

Clip to pixel

Since pixels are enlarged when zooming in, it creates an impression as if a polygon point can be placed anywhere over it. However this is not the case, a single pixel is the highest possible resolution, and there's no real option beyond that, despite the impression created during zoom-in.
To prevent this false inpression, the Dataloop system clips polygon points onto pixels starting from a certain high zoom level. This makes certain polygons to look rectangular and not curved as it might seem to be possible, but this feature is there to enforce the reality derived from the pixels themselves.

Polygon Editing

1. The Polygon tool must be selected to edit polygon annotations.
2. Click on a polygon to have it selected.
3. Drag and drop a polygon to move it on the canvas.
4. Hold SHIFT+Arrow-key to make fine position adjustments to the polygon position.
5. Double click on a polygon to put it in editing mode.
6. Hold any of the polygon's points and drag and drop to change the polygon's shape.
7. Draw a freehand line (click and hold the mouse button and move the mouse to draw).
   A. Draw a line that starts outside the polygon, goes through the polygon, and ends outside the polygon, e.g., cutting a slice of the polygon, to have that slice/part removed.
   B. Draw a line that starts inside the polygon, goes out of it, and then comes back into it, e.g., adding a slice to the polygon, to have the polygon extended to include the additional part.

Polygon Related Features

Polygons can be used with several related features that convert the polygons into other shapes/tools.

Polygon to Mask

Convert a polygon to a semantic segmentation mask. After converting the polygon to a semantic segmentation mask, you can continue editing the semantic annotation by switching to the semantic segmentation tool.

The action can be reverted using the Mask-to-polygon feature.

NOTE: When converting a polygon to a mask, each pixel of the polygon is filled (painted).

Since pixels are square, this results in the round/circular outline of the polygon (where pixels were partly painted) becoming jagged. This is more apparent in low resolution and when zooming in.

Polygon before conversion to mask:

Polygon after conversion to mask:

4-Points to Polygon Magic Tool

Automatically convert a 4-point polygon to a more accurate, tight contour polygon around an object by using the Polygon to Polygon 4-Points tool.

Place a point at each end of the object – top, left, bottom, right – to create a closed quadrilateral polygon. Activate the feature and create the polygon around the object’s edges. You can adjust and edit this polygon using the polygon edit mode.

4-Points to Mask Magic Tool

Automatically convert a 4-point polygon into a semantic layer over the object by using the 4-Points-To-Mask tool.

Place a point at each end of the object – top, left, bottom, right – to create a closed quadrilateral polygon. Activate the feature to create the semantic mask.

Arrowhead on Polygon

Enable this feature in the recipe to have an arrowhead drawn on the polygon, serving as an indication of direction when annotating in tasks requiring this feature.

Polygon Edge Sharing

The Polygon tool now lets you interactively create a polygon that shares its edges with other Polygons, so there will be no overlap between them.
To enable this option:

Click on the Polygon tool > select "Edge Sharing"
Once you finish drawing a polygon that overlaps with other polygons, it will be updated automatically to share the edges of the overlapped polygon.

Reminder: You can draw polygon lines starting inside other polygons by holding the Shift key down.