> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/roboflow/roboflow-ko/annotate/use-roboflow-annotate.md).

# 이미지 주석 달기

Roboflow dashboard의 Assign 또는 Dataset 페이지에서 이미지를 선택하면 labeling interface에 접근할 수 있습니다.

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

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

* 드래그하여 선택
* Bounding box annotation tool
* 폴리곤 annotation tool
* Smart polygon
* Label assist
* Zoom tool

### 드래그하여 선택

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

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

<div align="center"><figure><img src="/files/235cd426a57264a7c116b86889b490b79f86b942" 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="/files/2b75343423ce458c1720b7543b6c6a39a7457c06" alt=""><figcaption><p>Bounding Box Tool (B) 선택</p></figcaption></figure>

### Polygon Annotation Tool

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

관심 대상 주변의 이미지 위를 클릭하여 둘러싸는 폴리곤 annotation을 만든 다음, Class Selector를 사용해 label을 선택합니다.

<figure><img src="/files/5654463861df43cdb6b18f47ec005d1b756b3fab" alt=""><figcaption><p>Polygon Tool (P) 선택</p></figcaption></figure>

### Brush Annotation Tool

brush annotation tool을 사용하면 이미지의 관심 영역 위에 픽셀 단위로 정확한 mask annotation을 칠할 수 있습니다. 캔버스 위 브러시 컨트롤을 사용해 브러시 크기를 조정하고 Add 및 Subtract 모드 사이를 전환할 수 있습니다. Add는 현재 mask에 추가하고, Subtract는 현재 mask에서 지웁니다.

\
Mask annotation은 객체를 윤곽선이나 box가 아니라 픽셀 단위 영역으로 표현합니다. 이를 통해 특히 불규칙하거나 세밀한 구조(예: 머리카락, 잎사귀, 투명 객체)를 더 정확하게 캡처할 수 있으며, instance 또는 semantic segmentation 모델을 학습하는 데 이상적입니다. 기본적으로 각 masked region 주위에 bounding box가 표시되어 객체의 전체 범위를 더 쉽게 확인하고 검토 및 편집 중에 상호작용할 수 있습니다. 표시 옵션 패널의 "Mask Boxes" 스위치를 사용하면 이 기능을 끄고 mask 채움만 볼 수 있습니다.

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

<figure><img src="/files/4908f0e9d2d58ac594415eaf5e685b0f393dd0ef" alt=""><figcaption><p>Brush Tool (U) 선택</p></figcaption></figure>

### Smart Polygon

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

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

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

<figure><img src="/files/81dc62505089830241fc213d852c8ea60a1f8bd5" alt=""><figcaption><p>Smart Polygon (S) Tool 선택</p></figcaption></figure>

### **Label Assist**

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

<figure><img src="/files/22e8463a9654b7be92981b10a81875e135065894" alt="Label Assist Tool selection"><figcaption></figcaption></figure>

### **Null로 표시**

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

<figure><img src="/files/3058a027429882e7f5894d9b485ea54f753a8479" alt=""><figcaption><p>Mark Null (N) Tool 선택</p></figcaption></figure>

### **Annotation 실행 취소, 다시 실행, 반복**

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

* **실행 취소** 이전 작업을 되돌립니다.
* **다시 실행** 이전에 실행 취소한 작업을 다시 적용합니다.
* **이전 반복** 마지막으로 annotation한 이미지와 같은 위치에 이미지의 label을 다시 적용합니다

### 다중 선택 및 컨텍스트 메뉴

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

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

#### 사용 가능한 작업

* **Box로 변환** — 선택한 모든 polygon 또는 mask를 bounding box로 변환합니다.
* **Polygon으로 변환** — 선택한 모든 box 또는 mask를 polygon으로 변환합니다.
* **Mask로 변환** — 선택한 모든 box 또는 polygon을 픽셀 mask로 변환합니다.
* **Smart Mask로 변환** — 각 선택 항목에 대해 Smart Polygon을 다시 실행하여 정교한 mask를 생성합니다.
* **Mask 병합** — 선택한 모든 mask annotation을 하나의 mask annotation으로 결합합니다. 병합된 mask는 선택한 mask의 모든 픽셀의 합집합을 사용하며, 기본 선택의 label과 색상을 상속합니다. 이는 예를 들어 가림 물체에 의해 둘로 나뉜 하나의 객체처럼 같은 기반 객체를 나타내는 서로 떨어진 여러 mask 영역을 합치는 데 유용합니다.
* **맨 앞으로 가져오기** / **앞으로 가져오기** / **맨 뒤로 보내기** / **뒤로 보내기** — 선택한 모든 annotation의 레이어 순서를 나머지 항목에 대해 다시 정렬합니다.

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

### Class Selection

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

![Class Selector](/files/ef977d27fec23cb4ae51b2d7156d494d10f92787)

* **텍스트 필드** 새 class를 만들거나 기존 class를 필터링합니다.
* **버튼** 변경 사항을 저장하거나 취소합니다.
* **Class List** 데이터셋에 있는 기존 class 목록(텍스트 필드로 필터링되며 활성 옵션은 보라색으로 강조 표시됨)과, 때로는 입력한 텍스트가 기존 class와 일치하지 않을 경우 표시되는 "Create class" 옵션입니다.

### Zoom Tool

화면 왼쪽 하단에 있는 zoom tool입니다.

* 확대하거나 축소하여 한 번에 화면에 더 많은 이미지를 표시하거나 더 자세한 편집을 위해 더 가까이 볼 수 있습니다. 또한 zoom을 지정한 퍼센트로 "lock"하거나, zoom을 재설정하여 이미지 전체가 Annotation Tool의 뷰포트에 맞도록 할 수 있습니다.
* "*Zoom Lock*" 옵션을 선택하면 모든 이미지가 이 zoom 수준으로 표시됩니다. Zoom Lock을 제거하려면 선택을 해제하거나 잠금을 해제하세요.

<figure><img src="/files/ff3505416f34d89b40bb212c3bb892eb8be71484" alt=""><figcaption><p>Zoom Tool</p></figcaption></figure>

### Annotation List

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

<figure><img src="/files/143576cf59ab82f26d82b0a6a9fd48f91df447bf" alt="" width="324"><figcaption><p>Annotations(Annots) Sidebar</p></figcaption></figure>

### **Image Attributes**

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

<figure><img src="/files/702fa863ca8cd506a107ae4398a467d71e11327f" alt="" width="489"><figcaption><p>Attributes Sidebar</p></figcaption></figure>


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-ko/annotate/use-roboflow-annotate.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
