> 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/workflows/ko/blocks/blocks/visualize-predictions/icon-visualization.md).
# 아이콘 시각화
이미지 위에 사용자 지정 아이콘 이미지를 고정 위치(정적 모드) 또는 감지된 객체 위에 동적으로 배치(동적 모드)하여, 워터마크, 라벨, 배지 또는 시각적 표시용으로 사용할 수 있습니다.
## 이 블록의 작동 방식
이 블록은 이미지를 입력받고, 선택적으로 탐지 예측값도 입력받아 이미지 위에 사용자 지정 아이콘 이미지를 배치합니다. 이 블록은 두 가지 모드를 지원합니다:
**정적 모드** (워터마크 및 고정 위치용):
1. 이미지와 아이콘 이미지를 입력으로 받음
2. 이미지의 고정된 x, y 좌표에 아이콘을 배치함
3. 오른쪽 또는 아래쪽 가장자리에서 기준을 잡기 위해 음수 좌표를 지원함
4. 지정된 정적 위치에 아이콘이 있는 주석이 추가된 이미지를 반환함
**동적 모드** (탐지 기반 배치용):
1. 이미지, 아이콘 이미지, 탐지 예측값을 입력으로 받음
2. 선택한 기준점(CENTER, 모서리, 가장자리, 또는 질량 중심)을 기준으로 각 탐지 객체 위에 아이콘을 배치함
3. 각 탐지 결과에 대해 같은 상대 위치에 아이콘을 배치함
4. 탐지된 객체 위에 아이콘이 오버레이된 주석이 추가된 이미지를 반환함
이 블록은 투명도(알파 채널)가 있는 PNG 이미지를 지원하여 아이콘이 배경과 자연스럽게 섞이도록 합니다. 아이콘은 원하는 폭과 높이로 조정할 수 있어, 작은 배지부터 큰 워터마크까지 다양한 용도에 적합합니다. 정적 모드에서는 아이콘이 고정 좌표에 배치되므로 워터마크나 브랜딩에 이상적입니다. 동적 모드에서는 아이콘이 탐지된 객체를 자동으로 따라가므로, 맞춤형 시각 표시로 탐지 항목에 라벨을 붙이거나 분류하거나 표시하는 데 유용합니다.
## 일반적인 사용 사례
* **워터마크 및 브랜딩**: 콘텐츠 보호, 저작권 표시 또는 브랜드 식별을 위해 이미지나 비디오의 고정 위치(정적 모드)에 로고, 워터마크 또는 브랜딩 요소를 배치
* **아이콘을 이용한 객체 라벨링**: 안전하지 않은 객체에는 경고 아이콘, 제품에는 카테고리 아이콘, 상태 배지 등과 같은 시각적 표시로 객체를 분류, 라벨링 또는 표시하기 위해 탐지된 객체 위에 사용자 지정 아이콘을 배치(동적 모드)
* **시각적 상태 표시기**: 분류 결과, 신뢰도 수준 또는 사용자 지정 로직에 따라 탐지된 객체 위에 상태 아이콘(예: 체크 표시, 경고 표지, 정보 배지)을 표시하여 빠른 시각적 피드백 제공
* **제품 표시 및 분류**: 소매, 전자상거래 또는 재고 관리 워크플로에서 탐지된 제품에 카테고리 아이콘, 제품 유형 표시기 또는 사용자 지정 마커를 배치
* **사용자 지정 주석 시스템**: 제조 또는 검사 워크플로에서 품질 관리, 결함 표시 또는 규정 준수 추적을 위한 특수 아이콘으로 사용자 지정 주석 워크플로를 생성
* **대화형 UI 요소**: 사용자 인터페이스, 대시보드 또는 대화형 애플리케이션을 위해 이미지나 비디오에 아이콘 기반 시각 요소를 추가하여 사용자에게 직관적인 시각적 단서를 제공
## 다른 블록과 연결하기
이 블록의 주석이 달린 이미지는 다음에 연결할 수 있습니다:
* **다른 시각화 블록** (예: 라벨 시각화, 바운딩 박스 시각화, 다각형 시각화) 아이콘 배치를 추가 주석과 결합하여 포괄적인 시각화를 구현
* **데이터 저장 블록** (예: 로컬 파일 싱크, CSV 포맷터, Roboflow 데이터셋 업로드) 문서화, 보고 또는 보관을 위해 아이콘이 있는 이미지를 저장
* **웹훅 블록** 아이콘이 포함된 시각화 결과를 외부 시스템, API 또는 웹 애플리케이션으로 보내 대시보드나 모니터링 도구에 표시
* **알림 블록** (예: 이메일 알림, Slack 알림) 경고나 보고서의 시각적 증거로 아이콘이 포함된 주석 이미지를 전송
* **비디오 출력 블록** 라이브 모니터링, 추적 시각화 또는 후처리 분석을 위해 아이콘이 포함된 주석 비디오 스트림 또는 녹화본을 생성
### 유형 식별자
step에서 다음 식별자를 사용하세요 `"type"` 필드: `roboflow_core/icon_visualization@v1` 를 워크플로에 단계로 추가합니다.
### 속성
| **이름** | **유형** | **설명** | 참조 |
| ------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
| `name` | `str` | 이 단계에 고유 식별자를 입력하세요.. | ❌ |
| `copy_image` | `bool` | 이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요.. | ✅ |
| `mode` | `str` | 아이콘 배치 모드입니다. 'static' 모드는 아이콘을 고정된 x,y 좌표에 배치합니다(워터마크 또는 고정 위치 요소에 유용). 'dynamic' 모드는 위치를 기준으로 탐지된 객체 위에 아이콘을 배치합니다(객체 라벨링 또는 분류에 유용).. | ✅ |
| `icon_width` | `int` | 아이콘의 픽셀 너비입니다. 높이도 지정된 경우 종횡비를 유지하면서 아이콘 이미지는 이 너비로 조정됩니다.. | ✅ |
| `icon_height` | `int` | 아이콘의 픽셀 높이입니다. 너비도 지정된 경우 종횡비를 유지하면서 아이콘 이미지는 이 높이로 조정됩니다.. | ✅ |
| `position` | `str` | 각 탐지의 바운딩 박스에 상대적인 아이콘 배치용 기준 위치(동적 모드에서만). 옵션에는 CENTER(박스 중앙), 모서리(TOP\_LEFT, TOP\_RIGHT, BOTTOM\_LEFT, BOTTOM\_RIGHT), 변의 중간점(TOP\_CENTER, CENTER\_LEFT, CENTER\_RIGHT, BOTTOM\_CENTER), 또는 CENTER\_OF\_MASS(객체의 질량 중심)가 포함됩니다.. | ✅ |
| `x_position` | `int` | 정적 모드 위치 지정용 X 좌표입니다. 양수 값은 이미지의 왼쪽 가장자리부터의 위치를 뜻합니다. 음수 값은 오른쪽 가장자리부터의 위치를 뜻합니다(예: -10은 아이콘을 오른쪽 가장자리에서 10픽셀 떨어진 위치에 배치함).. | ✅ |
| `y_position` | `int` | 정적 모드 위치 지정용 Y 좌표입니다. 양수 값은 이미지의 상단 가장자리부터의 위치를 뜻합니다. 음수 값은 하단 가장자리부터의 위치를 뜻합니다(예: -10은 아이콘을 하단 가장자리에서 10픽셀 떨어진 위치에 배치함).. | ✅ |
해당 **참조** 열은 워크플로 런타임에서 사용할 수 있는 동적 값으로 속성을 매개변수화할 수 있음을 나타냅니다. 자세한 내용은 `워크플로` 런타임. 자세한 내용은 *바인딩* 를 참조하세요.
### 입력 및 출력 바인딩
사용 가능한 연결은 바인딩 종류에 따라 달라집니다. 어떤 바인딩 종류가 있는지 확인하세요 `아이콘 시각화` 버전 `v1` 가 있습니다.
입력 및 출력 바인딩
* 입력
* `image` ([*`image`*](/workflows/ko/developer-guide/developer-guide/kinds/image.md)): 시각화에 사용할 이미지입니다..
* `copy_image` ([*`boolean`*](/workflows/ko/developer-guide/developer-guide/kinds/boolean.md)): 이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요..
* `icon` ([*`image`*](/workflows/ko/developer-guide/developer-guide/kinds/image.md)): 입력 이미지 위에 배치할 아이콘 이미지입니다. 최상의 결과를 위해 투명도(알파 채널)가 있는 PNG 형식을 권장합니다. 이렇게 하면 아이콘이 배경과 자연스럽게 섞입니다. 아이콘은 지정된 너비와 높이로 조정됩니다..
* `mode` ([*`문자열`*](/workflows/ko/developer-guide/developer-guide/kinds/string.md)): 아이콘 배치 모드입니다. 'static' 모드는 아이콘을 고정된 x,y 좌표에 배치합니다(워터마크 또는 고정 위치 요소에 유용). 'dynamic' 모드는 위치를 기준으로 탐지된 객체 위에 아이콘을 배치합니다(객체 라벨링 또는 분류에 유용)..
* `predictions` (*Union\[*[*`instance_segmentation_prediction`*](/workflows/ko/developer-guide/developer-guide/kinds/instance-segmentation-prediction.md)*,* [*`keypoint_detection_prediction`*](/workflows/ko/developer-guide/developer-guide/kinds/keypoint-detection-prediction.md)*,* [*`object_detection_prediction`*](/workflows/ko/developer-guide/developer-guide/kinds/object-detection-prediction.md)*,* [*`rle_instance_segmentation_prediction`*](/workflows/ko/developer-guide/developer-guide/kinds/rle-instance-segmentation-prediction.md)*]*): 모델 예측값을 기반으로 아이콘을 배치할 대상입니다(동적 모드에 필요). 선택한 위치 기준점에 따라 각 탐지 객체 위에 아이콘이 배치됩니다..
* `icon_width` ([*`정수`*](/workflows/ko/developer-guide/developer-guide/kinds/integer.md)): 아이콘의 픽셀 너비입니다. 높이도 지정된 경우 종횡비를 유지하면서 아이콘 이미지는 이 너비로 조정됩니다..
* `icon_height` ([*`정수`*](/workflows/ko/developer-guide/developer-guide/kinds/integer.md)): 아이콘의 픽셀 높이입니다. 너비도 지정된 경우 종횡비를 유지하면서 아이콘 이미지는 이 높이로 조정됩니다..
* `position` ([*`문자열`*](/workflows/ko/developer-guide/developer-guide/kinds/string.md)): 각 탐지의 바운딩 박스에 상대적인 아이콘 배치용 기준 위치(동적 모드에서만). 옵션에는 CENTER(박스 중앙), 모서리(TOP\_LEFT, TOP\_RIGHT, BOTTOM\_LEFT, BOTTOM\_RIGHT), 변의 중간점(TOP\_CENTER, CENTER\_LEFT, CENTER\_RIGHT, BOTTOM\_CENTER), 또는 CENTER\_OF\_MASS(객체의 질량 중심)가 포함됩니다..
* `x_position` ([*`정수`*](/workflows/ko/developer-guide/developer-guide/kinds/integer.md)): 정적 모드 위치 지정용 X 좌표입니다. 양수 값은 이미지의 왼쪽 가장자리부터의 위치를 뜻합니다. 음수 값은 오른쪽 가장자리부터의 위치를 뜻합니다(예: -10은 아이콘을 오른쪽 가장자리에서 10픽셀 떨어진 위치에 배치함)..
* `y_position` ([*`정수`*](/workflows/ko/developer-guide/developer-guide/kinds/integer.md)): 정적 모드 위치 지정용 Y 좌표입니다. 양수 값은 이미지의 상단 가장자리부터의 위치를 뜻합니다. 음수 값은 하단 가장자리부터의 위치를 뜻합니다(예: -10은 아이콘을 하단 가장자리에서 10픽셀 떨어진 위치에 배치함)..
* 출력
* `image` ([`image`](/workflows/ko/developer-guide/developer-guide/kinds/image.md)): 워크플로의 이미지.
예시 JSON 정의
```json
{
"name": "",
"type": "roboflow_core/icon_visualization@v1",
"image": "$inputs.image",
"copy_image": true,
"icon": "$inputs.icon",
"mode": "static",
"predictions": "$steps.object_detection_model.predictions",
"icon_width": 64,
"icon_height": 64,
"position": "TOP_CENTER",
"x_position": 10,
"y_position": 10
}
```