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