> 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 대시보드의 Assign 또는 Dataset 페이지에서 이미지를 선택하면 라벨링 인터페이스에 액세스할 수 있습니다.

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

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

* 드래그하여 선택
* 바운딩 박스 주석 도구
* 폴리곤 주석 도구
* Smart Polygon
* Label assist
* 줌 도구

### 드래그하여 선택

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

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

<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 모드를 전환하세요. 각 모드는 현재 마스크에 추가하거나 현재 마스크에서 지웁니다.

\
마스크 주석은 객체를 윤곽선이나 박스가 아닌 픽셀 단위 영역으로 표현합니다. 이를 통해 특히 불규칙하거나 세밀한 구조(예: 머리카락, 잎사귀, 투명 객체)의 형태를 더 정확하게 캡처할 수 있으며, 인스턴스 또는 시맨틱 세그멘테이션 모델을 학습하는 데 이상적입니다. 기본적으로 각 마스크 영역 주위에 바운딩 박스가 표시되어 객체의 전체 범위를 더 쉽게 확인하고 검토 및 편집 중에 상호작용할 수 있습니다. 마스크 채우기만 보길 원한다면 Display Options 패널의 "Mask Boxes" 스위치를 사용해 이 기능을 끌 수 있습니다.

\
이미지 위를 클릭하고 드래그하여 마스크에 포함하거나 제외할 영역을 칠한 다음, 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 주석에 대해 자세히 알아보려면 가이드를 확인하세요 "[Missing Annotations와 Null Annotations의 차이](https://blog.roboflow.com/missing-and-null-image-annotations/)".

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

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

바운딩 박스(B), 폴리곤(P), 또는 Smart Polygon(S) 모드에서:

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

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

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

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

#### 사용 가능한 작업

* **박스로 변환** — 선택한 모든 폴리곤 또는 마스크를 바운딩 박스로 변환합니다.
* **폴리곤으로 변환** — 선택한 모든 박스 또는 마스크를 폴리곤으로 변환합니다.
* **마스크로 변환** — 선택한 모든 박스 또는 폴리곤을 픽셀 마스크로 변환합니다.
* **스마트 마스크로 변환** — 각 선택 항목에 대해 Smart Polygon을 다시 실행하여 더 정교한 마스크를 생성합니다.
* **마스크 병합** — 선택한 모든 마스크 주석을 하나의 마스크 주석으로 결합합니다. 병합된 마스크는 선택한 마스크에 있는 모든 픽셀의 합집합을 취하고, 기본 선택의 라벨과 색상을 상속합니다. 이는 차단물에 의해 나뉜 객체의 두 부분처럼, 같은 실제 객체를 나타내는 여러 개의 분리된 마스크 영역을 하나로 합칠 때 유용합니다.
* **맨 앞으로 가져오기** / **앞으로 가져오기** / **맨 뒤로 보내기** / **뒤로 보내기** — 선택한 모든 주석의 레이어 순서를 나머지 항목과 상대적으로 재정렬합니다.

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

### Class Selection

이미지가 선택되면 **Class Selector** 가 나타납니다. 여기에는 바운딩 박스의 라벨을 선택하기 위한 다음 옵션이 포함됩니다:

![Class Selector](/files/ef977d27fec23cb4ae51b2d7156d494d10f92787)

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

### 줌 도구

화면 왼쪽 아래에 있는 줌 도구입니다.

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

<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>
