# Annotate an Image

Roboflow 대시보드의 Assign 또는 Dataset 페이지에서 이미지를 선택하면 labeling interface에 액세스할 수 있습니다.

labeling interface의 오른쪽에는 toolbar가 있습니다. toolbar에는 이미지를 annotating하는 데 사용할 수 있는 다양한 기능이 있습니다.

이 문서에서는 다음 기능을 사용하는 방법을 설명합니다:

* Drag and select
* Bounding box annotation tool
* Polgyon annotation tool
* Smart polygon
* Label assist
* Zoom tool

### Drag and Select

손 아이콘으로 표시되는 이 기능을 사용하면 개별 annotation을 선택, 편집 및 드래그할 수 있습니다.

* **한 번 클릭하여** 기존 bounding box를 선택합니다. 선택한 후에는 모서리와 각 변에 나타나는 원형의 흰색 핸들을 사용해 bounding box의 크기를 변경할 수 있습니다. 또는 class editor를 사용해 box의 label을 변경할 수 있습니다.
* **box를 드래그하여** 이동합니다.
* **background를 드래그하여** 화면을 이동합니다.
* **background를 클릭하여** 모든 box의 선택을 해제합니다.

<div align="center"><figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-fa1f28bc3e8af8fde30737bf577b3ae2ee9ee91c%2Fimage.png?alt=media" alt=""><figcaption><p>Drag Tool (D) 선택</p></figcaption></figure></div>

### **Bounding Box Annotation Tool**

bounding box annotation tool(직사각형 box 아이콘으로 표시됨)을 사용하면 새 bounding-box annotation을 그릴 수 있습니다. 이 모드에서는 어디서 그리기를 시작할지 파악하는 데 도움이 되는 십자선이 표시됩니다.

이미지를 클릭하고 드래그하여 새 annotation을 만든 다음, Class Selector를 사용해 label을 선택합니다.

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-839e9a8de5a9155f4db78fccd61d1e032cbdd12d%2Fimage.png?alt=media" alt=""><figcaption><p>Bounding Box Tool (B) 선택</p></figcaption></figure>

### Polygon Annotation Tool

polygon annotation tool을 사용하면 [새 polygon annotation을 그릴 수 있습니다](https://blog.roboflow.com/polygon-annotation-labeling/). 이 모드에서는 어디서 그리기를 시작할지 파악하는 데 도움이 되는 십자선이 표시됩니다.

관심 있는 객체 주변의 이미지를 클릭하여 둘러싸인 polygon annotation을 만든 다음, Class Selector를 사용해 label을 선택합니다.

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-707258408089bf681cfdb74335a73c6bc05a717e%2Fimage.png?alt=media" alt=""><figcaption><p>Polygon Tool (P) 선택</p></figcaption></figure>

### Brush Annotation Tool

brush annotation tool을 사용하면 이미지의 관심 영역 위에 픽셀 단위로 정확한 mask annotation을 칠할 수 있습니다. 캔버스상의 brush control을 사용해 brush 크기를 조정하고 Add 및 Subtract 모드를 전환할 수 있으며, 각각 현재 mask에 추가하거나 현재 mask에서 지워집니다.

\
mask annotation은 객체를 윤곽선이나 box가 아니라 픽셀 단위 영역으로 표현합니다. 이를 통해 특히 불규칙하거나 세밀한 구조(예: 머리카락, 잎사귀, 또는 투명한 객체)를 더 정확하게 포착할 수 있으며, instance 또는 semantic segmentation 모델 학습에 이상적입니다. 각 mask에 대해 mask된 영역을 둘러싼 bounding box를 표시하므로, 객체의 전체 범위를 더 쉽게 확인하고 검토 및 편집 중에 상호작용할 수 있습니다.

\
이미지 위를 클릭하고 드래그하여 mask에 포함하거나 제외할 영역을 칠한 다음, Class Selector를 사용해 해당 mask 영역의 label을 지정하거나 변경합니다.

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2F7nZNSbSCVLzApnQOyXks%2FScreenshot%202025-11-25%20at%2009.40.10.png?alt=media&#x26;token=51002a32-52e5-420e-b852-ab9735851ed2" alt=""><figcaption><p>Brush Tool (U) 선택</p></figcaption></figure>

### Smart Polygon

**Smart Polygon** 새 Smart Polygon annotation을 그릴 수 있습니다.

이 모드에서는 새 관심 영역(새 label)을 선택할 때 초록색 점이 표시되고, 관심 영역에서 제거할 영역(라벨링/폴리곤으로 둘러싸고 싶지 않은 객체나 이미지의 일부)을 선택할 때는 빨간색 점이 표시됩니다. 또한 Convex Hull, Smooth, Complex 설정으로 polygon을 조정할 수 있는 옵션이 제공됩니다.

Smart Polygon은 특히 (Instance 및 Semantic) Segmentation 프로젝트에 유용하지만, [Object Detection 모델에서도 성능 향상을 볼 수 있습니다](https://blog.roboflow.com/polygons-object-detection/) Roboflow에서 Smart Polygon으로 라벨링할 때.

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-448764c9e4dda5fd5c29f7e80ae88bbf7ee0c12d%2Fimage.png?alt=media" alt=""><figcaption><p>Smart Polygon (S) Tool 선택</p></figcaption></figure>

### **Label Assist**

[**Label Assist**](https://docs.roboflow.com/roboflow/roboflow-ko/annotate/ai-labeling/model-assisted-labeling) 공개 모델 또는 버전의 예측을 사용하여 [Roboflow Train으로 학습된](https://docs.roboflow.com/roboflow/roboflow-ko/train/train) annotation을 추가하는 동안 bounding box label을 자동으로 제안합니다.

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2F1EgT6hilQ7UeeuTbVo8W%2Flabel-assist-img.png?alt=media&#x26;token=b8933ccc-83e8-414c-9c0b-d5234c75d765" alt="Label Assist Tool selection"><figcaption></figcaption></figure>

### **Mark Null**

Mark null(Null annotation)은 배경 또는 null 이미지의 "labeling"에 사용됩니다. 이 설정은 이미지에서 모든 annotation을 지우거나 이미지를 Unannotated로 표시하는 데에도 사용할 수 있습니다. null annotation에 대해 자세히 알아보려면 가이드 "[Missing과 Null Annotations의 차이점](https://blog.roboflow.com/missing-and-null-image-annotations/)".

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-54092b9e3c0db98fc51650f689190db4562f7a32%2Fimage.png?alt=media" alt=""><figcaption><p>Mark Null (N) Tool 선택</p></figcaption></figure>

### **Undo, Redo, and Repeat Annotations**

Bounding Box (B), Polygon (P), 또는 Smart Polygon (S) 모드에서:

* **Undo** 이전 작업을 되돌립니다.
* **Redo** 이전에 실행 취소한 작업을 다시 적용합니다.
* **Repeat Previous** 마지막으로 annotation된 이미지와 동일한 위치에 이미지의 label을 다시 적용합니다.

### Multi-Select and the Context Menu

여러 annotation을 한 번에 선택하고 context menu에서 일괄 작업을 적용할 수 있습니다. 여러 annotation을 선택하려면 **Shift** 를 누른 채 클릭하거나, 캔버스 위로 선택 사각형을 드래그하면 됩니다. 다중 선택이 활성화된 상태에서 마우스 오른쪽 버튼을 클릭하거나(또는 선택한 annotation의 세 점 메뉴를 열어) context menu를 엽니다.

context menu는 현재 선택한 모든 annotation에 작업을 적용하므로, 여러 annotation을 한 번에 변환, 재정렬 또는 결합할 수 있습니다.

#### 사용 가능한 작업

* **Convert to Box** — 선택한 모든 polygon 또는 mask를 bounding box로 변환합니다.
* **Convert to Polygon** — 선택한 모든 box 또는 mask를 polygon으로 변환합니다.
* **Convert to Mask** — 선택한 모든 box 또는 polygon을 픽셀 mask로 변환합니다.
* **Convert to Smart Mask** — 선택한 각 항목에 대해 Smart Polygon을 다시 실행하여 정제된 mask를 생성합니다.
* **Merge Masks** — 선택한 모든 mask annotation을 하나의 mask annotation으로 결합합니다. 병합된 mask는 선택된 모든 mask의 픽셀 합집합을 취하며, 기본 선택(primary selection)의 label과 색상을 상속합니다. 이는 예를 들어 가림물(occluder)로 인해 분리된 동일 객체의 두 부분처럼, 동일한 기본 객체를 나타내는 여러 개의 분리된 mask 영역을 합칠 때 유용합니다.
* **Bring to Front** / **Bring Forward** / **Send to Back** / **Send Backward** — 나머지 항목과의 상대적인 레이어 순서를 선택한 모든 annotation에 대해 재정렬합니다.

{% hint style="info" %}
**Merge Masks** 현재 선택한 모든 annotation이 mask인 경우에만 context menu에 표시됩니다. 선택한 annotation 중 하나라도 box 또는 polygon이면, 먼저 이를 mask로 변환한 뒤( **Convert to Mask**) 병합하세요.
{% endhint %}

### Class Selection

이미지를 선택하면 **Class Selector** 가 나타납니다. 여기에는 bounding box의 label을 선택하기 위한 다음 옵션이 포함됩니다:

![Class Selector](https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-4cbf1759872d620fb11069eab425cb95a2458a4f%2Fimage.png?alt=media)

* **Textfield** 새 class를 생성하거나 기존 class를 필터링합니다.
* **Buttons** 변경 사항을 저장하거나 취소합니다.
* **Class List** 기존 class 목록(dataset의 text field로 필터링되며 활성 옵션은 보라색으로 강조 표시됨)과, 입력한 텍스트가 기존 class와 일치하지 않을 경우 때때로 "Create class" 옵션이 표시됩니다.

### Zoom Tool

화면 왼쪽 아래에 있는 zoom tool입니다.

* 한 번에 화면에 더 많은 이미지를 맞추기 위해 확대 및 축소하거나, 더 세밀한 편집을 위해 더 가까이 볼 수 있습니다. 또한 zoom을 지정된 퍼센트로 "lock"하거나, Annotation Tool의 viewport 안에 이미지 전체가 들어오도록 zoom을 재설정하는 옵션도 있습니다.
* 만약 "*Zoom Lock*" 옵션을 선택하면 모든 이미지가 이 zoom 수준으로 표시됩니다. Zoom Lock을 제거하려면 선택을 해제하거나 lock을 해제하세요.

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-c2a10592c3b157feb582f82665e45437b3b74097%2Fimage.png?alt=media" alt=""><figcaption><p>Zoom Tool</p></figcaption></figure>

### Annotation List

Annotations(축약하여 *Annots* 대시보드에서)는 이미지에 어떤 class가 있고 없는지, box의 색상은 무엇인지, label의 레이어 순서는 어떤지를 보여줍니다. Annotations drawer에는 dataset의 이미지를 정리, 필터링 또는 정렬하는 데 도움이 되는 Tags가 포함되어 있습니다.

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-2fd8837a48f9fd4d165ce6af19eaa66aeab7e2bc%2Fannots-drawer.png?alt=media" alt="" width="324"><figcaption><p>Annotations (Annots) Sidebar</p></figcaption></figure>

### **Image Attributes**

Attributes는 이미지의 크기, 마지막 수정 시간, 그리고 해당 이미지가 이 dataset의 [training, validation, 또는 test set](https://blog.roboflow.com/train-test-split/).

<figure><img src="https://3958014485-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2Fgit-blob-3951578e294aecf642b3ef9fa98ac9d8eabf32af%2Fimage.png?alt=media" alt="" width="489"><figcaption><p>Attributes Sidebar</p></figcaption></figure>
