> For the complete documentation index, see [llms.txt](https://docs.imerit.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imerit.net/labeling/labeling-tools/tools/polyline.md).

# Polyline

Overview of the Polyline labeling tool in Ango Hub

The polyline labeling tool allows you to draw a line on an image.

{% hint style="info" %}
The Polyline tool is supported across the Image, Video, DICOM, and Medical labeling editors.
{% endhint %}

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2Fq21ni0jBHooC19cLwzDK%2Fimage.png?alt=media&amp;token=c315337a-10e2-450e-85be-c37df41958d9" alt=""><figcaption></figcaption></figure>

## The Polyline Labeling Tool in Ango Hub <a href="#how-to-add-a-polyline-tool-to-your-project" id="how-to-add-a-polyline-tool-to-your-project"></a>

### How to add a Polyline tool to your project <a href="#how-to-add-a-polyline-tool-to-your-project" id="how-to-add-a-polyline-tool-to-your-project"></a>

From the project’s *Settings* tab, enter the *Label Set* section.

Click on *Add Category*. From the list that appears, click on *Polyline*.

A new row will appear named *Polyline*. Click on it to expand it.

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2FfsnNlEQLWXjOAde2IaR3%2Fimage.png?alt=media&amp;token=39108624-0bf8-4505-be30-e8b45ba72e02" alt=""><figcaption></figcaption></figure>

Give your polyline tool a title and description.

Enable the *Required* toggle if you want to force labelers to create a polyline on every asset. When the toggle is disabled, labelers will be able to save and move to the next asset without creating a polyline label using this class.

If you would like to ask labelers further questions, for example, if you want to show a further *radio* after drawing the polyline, click on *Add Classification* and add a further question. More[ on nested questions here](/labeling/labeling-tools/tools/nested-classifications.md).

### How to Draw a Polyline <a href="#how-to-draw-a-polyline" id="how-to-draw-a-polyline"></a>

Click on the image where you’d like the first point of the polyline to be. Click again where you’d like the second point to be, and so on. When you are done, press *N* on your keyboard to finish the polyline.

While drawing, you may click anywhere with the right mouse button to delete the last point you have placed.

To edit a polyline's points, select it by clicking on it, then drag the polyline itself or one of its points.

On images and videos, right-click a point on a selected polyline to remove it. A polyline must keep at least two points.

### Measuring pixel distances

On images and videos, a polyline with exactly two points shows the distance between them in pixels. Place the two points, press *N* to finish the polyline, then hover over or select it to see the length in the object details overlay.

In the editor settings, enable *Show Object Details on Hover* and leave *Hide Object Dimensions* unchecked to see the measurement. The length updates as you drag either endpoint.

Polylines with three or more points do not show a length. On DICOM images, use the existing line measurement tool instead.

### Snapping to an angle

On images and videos, hold *Alt* (⌥ on macOS) while drawing a polyline segment or dragging one of its points to snap the segment to 15-degree increments, such as 0°, 15°, 30°, or 45°.

## Edge Sharing

While drawing a polyline, if you press E, Hub will highlight the points of other polygons, polylines, and points. By clicking on the other object's points, you can snap your current polyline's points to them:

<figure><img src="https://3895963154-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FTcOUG6rfWxqGM0N4db2P%2Fuploads%2Fv57mMLDkYTeCnxZy4nJa%2Fpoly-line.gif?alt=media&amp;token=1b7cb25c-ca52-492e-8e5e-a89ed09ae819" alt=""><figcaption></figcaption></figure>

By snapping at least two points to the existing polygon and holding Alt (⌥ on macOS) + clicking, you can quickly anchor a series of points to the existing object, as shown in the GIF above.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.imerit.net/labeling/labeling-tools/tools/polyline.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
