# 이미지에 주석 달기

Roboflow 대시보드의 Assign 또는 Dataset 페이지에서 이미지를 선택하면 라벨링 인터페이스에 접근할 수 있습니다.

라벨링 인터페이스의 오른쪽에는 툴바가 있습니다. 툴바에는 이미지를 주석 처리하는 데 사용할 수 있는 다양한 기능이 있습니다.

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

* 드래그 및 선택
* 바운딩 박스 주석 도구
* 폴리곤 주석 도구
* Smart Polygon
* Label assist
* 확대/축소 도구

### 드래그 및 선택

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

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

<div align="center"><figure><img src="/files/235cd426a57264a7c116b86889b490b79f86b942" alt=""><figcaption><p>드래그 도구(D) 선택</p></figcaption></figure></div>

### **바운딩 박스 주석 도구**

바운딩 박스 주석 도구(직사각형 박스 아이콘으로 표시됨)를 사용하면 새로운 바운딩 박스 주석을 그릴 수 있습니다. 이 모드에서는 어디서 그리기를 시작할지 결정하는 데 도움이 되는 십자선이 표시됩니다.

이미지에서 클릭하고 드래그하여 새 주석을 만든 다음, Class Selector를 사용해 레이블을 선택합니다.

<figure><img src="/files/2b75343423ce458c1720b7543b6c6a39a7457c06" alt=""><figcaption><p>바운딩 박스 도구(B) 선택</p></figcaption></figure>

### 폴리곤 주석 도구

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

관심 객체 주변의 이미지 위를 클릭하여 닫힌 폴리곤 주석을 만든 다음, Class Selector를 사용해 레이블을 선택합니다.

<figure><img src="/files/5654463861df43cdb6b18f47ec005d1b756b3fab" alt=""><figcaption><p>폴리곤 도구(P) 선택</p></figcaption></figure>

### 브러시 주석 도구

브러시 주석 도구를 사용하면 이미지의 관심 영역 위에 픽셀 단위로 정확한 마스크 주석을 칠할 수 있습니다. 캔버스의 브러시 컨트롤을 사용해 브러시 크기를 조정하고 Add 및 Subtract 모드 사이를 전환할 수 있습니다. 각각 현재 마스크에 추가하거나 마스크에서 지우는 역할을 합니다.

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

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

<figure><img src="/files/4908f0e9d2d58ac594415eaf5e685b0f393dd0ef" alt=""><figcaption><p>브러시 도구(U) 선택</p></figcaption></figure>

### Smart Polygon

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

이 모드에서는 새로운 관심 영역(새 레이블)을 선택할 때 녹색 점이 표시되고, 관심 영역에서 제거할 영역(폴리곤으로 레이블/포함하고 싶지 않은 객체 또는 이미지의 일부)을 선택할 때 빨간색 점이 표시됩니다. 또한 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) 도구 선택</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) 주석을 달면서 바운딩 박스 레이블을 자동으로 제안합니다.

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

### **Mark Null**

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

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

### **주석 실행 취소, 다시 실행, 반복**

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

* **실행 취소** 이전 작업을 되돌립니다.
* **다시 실행** 이전에 실행 취소한 작업을 다시 적용합니다.
* **이전 항목 반복** 마지막으로 주석이 달린 이미지와 같은 위치에 이미지의 레이블을 다시 적용합니다.

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

여러 주석을 한 번에 선택하고 컨텍스트 메뉴에서 일괄 작업을 적용할 수 있습니다. 다음을 누른 상태에서 여러 주석을 선택합니다. **Shift** 를 누른 채 클릭하거나, 캔버스 위에서 선택 사각형을 드래그합니다. 다중 선택이 활성화된 상태에서 우클릭(또는 선택한 주석에서 점 3개 메뉴 열기)하면 컨텍스트 메뉴가 열립니다.

컨텍스트 메뉴는 현재 선택된 모든 주석에 대해 동작을 적용하므로, 여러 주석을 한 번에 변환, 재정렬 또는 결합할 수 있습니다.

#### 사용 가능한 작업

* **박스로 변환** — 선택한 모든 폴리곤 또는 마스크를 바운딩 박스로 변환합니다.
* **폴리곤으로 변환** — 선택한 모든 박스 또는 마스크를 폴리곤으로 변환합니다.
* **마스크로 변환** — 선택한 모든 박스 또는 폴리곤을 픽셀 마스크로 변환합니다.
* **Smart Mask로 변환** — 각 선택 항목에 대해 Smart Polygon을 다시 실행하여 정제된 마스크를 생성합니다.
* **마스크 병합** — 선택한 모든 마스크 주석을 하나의 마스크 주석으로 결합합니다. 병합된 마스크는 선택된 마스크의 모든 픽셀의 합집합을 사용하며, 기본 선택의 레이블과 색상을 상속합니다. 이는 예를 들어 가려개체에 의해 분할된 객체의 두 부분처럼, 동일한 기반 객체를 나타내는 여러 개의 분리된 마스크 영역을 연결할 때 유용합니다.
* **맨 앞으로 가져오기** / **앞으로 가져오기** / **맨 뒤로 보내기** / **뒤로 보내기** — 나머지 항목과의 상대적 레이어 순서를 선택한 모든 주석에 대해 재정렬합니다.

{% hint style="info" %}
**마스크 병합** 현재 선택된 모든 주석이 마스크일 때만 컨텍스트 메뉴에 표시됩니다. 선택한 주석 중 하나라도 박스나 폴리곤이면 먼저 이를 마스크로 변환한 다음( **마스크로 변환**) 병합하십시오.
{% endhint %}

### 클래스 선택

이미지가 선택되면 **Class Selector** 가 표시됩니다. 여기에는 바운딩 박스의 레이블을 선택하기 위한 다음 옵션이 포함되어 있습니다:

![Class Selector](/files/ef977d27fec23cb4ae51b2d7156d494d10f92787)

* **텍스트 필드** 를 사용해 새 클래스를 생성하거나 기존 클래스를 필터링합니다.
* **버튼** 를 사용해 변경 사항을 저장하거나 취소합니다.
* **클래스 목록** 기존 클래스 목록(텍스트 필드로 필터링되며 활성 옵션은 보라색으로 강조 표시됨)과, 입력한 텍스트가 기존 클래스와 일치하지 않을 경우 때때로 "클래스 생성" 옵션이 표시됩니다.

### 확대/축소 도구

화면 왼쪽 하단에 있는 확대/축소 도구입니다.

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

<figure><img src="/files/ff3505416f34d89b40bb212c3bb892eb8be71484" alt=""><figcaption><p>확대/축소 도구</p></figcaption></figure>

### 주석 목록

주석(대시보드에서 축약해 *Annots* 라고 표시됨)은 이미지에 어떤 클래스가 포함되어 있고 포함되어 있지 않은지, 박스의 색상이 무엇인지, 레이블의 레이어 순서가 어떤지 보여줍니다. Annotations 서랍에는 데이터셋의 이미지를 정리, 필터링 또는 정렬하는 데 도움이 되는 태그가 포함되어 있습니다.

<figure><img src="/files/143576cf59ab82f26d82b0a6a9fd48f91df447bf" alt="" width="324"><figcaption><p>주석(Annots) 사이드바</p></figcaption></figure>

### **이미지 속성**

속성은 이미지의 크기, 마지막 수정 시간, 그리고 이 데이터셋의 [학습, 검증 또는 테스트 세트](https://blog.roboflow.com/train-test-split/).

<figure><img src="/files/702fa863ca8cd506a107ae4398a467d71e11327f" alt="" width="489"><figcaption><p>에 속하는지 여부를 포함한 정보를 나타냅니다. 속성 사이드바</p></figcaption></figure>


---

# Agent Instructions: 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:

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

The question should be specific, self-contained, and written in natural language.
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.
