아이콘 시각화
특정 고정 좌표 또는 감지 결과를 바탕으로 동적으로 이미지에 아이콘을 그립니다.
이미지 위에 사용자 지정 아이콘 이미지를 고정 위치(정적 모드) 또는 감지된 객체 위에 동적으로 배치(동적 모드)하여, 워터마크, 라벨, 배지 또는 시각적 표시용으로 사용할 수 있습니다.
이 블록의 작동 방식
이 블록은 이미지를 입력받고, 선택적으로 탐지 예측값도 입력받아 이미지 위에 사용자 지정 아이콘 이미지를 배치합니다. 이 블록은 두 가지 모드를 지원합니다:
정적 모드 (워터마크 및 고정 위치용):
이미지와 아이콘 이미지를 입력으로 받음
이미지의 고정된 x, y 좌표에 아이콘을 배치함
오른쪽 또는 아래쪽 가장자리에서 기준을 잡기 위해 음수 좌표를 지원함
지정된 정적 위치에 아이콘이 있는 주석이 추가된 이미지를 반환함
동적 모드 (탐지 기반 배치용):
이미지, 아이콘 이미지, 탐지 예측값을 입력으로 받음
선택한 기준점(CENTER, 모서리, 가장자리, 또는 질량 중심)을 기준으로 각 탐지 객체 위에 아이콘을 배치함
각 탐지 결과에 대해 같은 상대 위치에 아이콘을 배치함
탐지된 객체 위에 아이콘이 오버레이된 주석이 추가된 이미지를 반환함
이 블록은 투명도(알파 채널)가 있는 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): 시각화에 사용할 이미지입니다..copy_image(boolean): 이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요..icon(image): 입력 이미지 위에 배치할 아이콘 이미지입니다. 최상의 결과를 위해 투명도(알파 채널)가 있는 PNG 형식을 권장합니다. 이렇게 하면 아이콘이 배경과 자연스럽게 섞입니다. 아이콘은 지정된 너비와 높이로 조정됩니다..mode(문자열): 아이콘 배치 모드입니다. 'static' 모드는 아이콘을 고정된 x,y 좌표에 배치합니다(워터마크 또는 고정 위치 요소에 유용). 'dynamic' 모드는 위치를 기준으로 탐지된 객체 위에 아이콘을 배치합니다(객체 라벨링 또는 분류에 유용)..predictions(Union[instance_segmentation_prediction,keypoint_detection_prediction,object_detection_prediction,rle_instance_segmentation_prediction]): 모델 예측값을 기반으로 아이콘을 배치할 대상입니다(동적 모드에 필요). 선택한 위치 기준점에 따라 각 탐지 객체 위에 아이콘이 배치됩니다..icon_width(정수): 아이콘의 픽셀 너비입니다. 높이도 지정된 경우 종횡비를 유지하면서 아이콘 이미지는 이 너비로 조정됩니다..icon_height(정수): 아이콘의 픽셀 높이입니다. 너비도 지정된 경우 종횡비를 유지하면서 아이콘 이미지는 이 높이로 조정됩니다..position(문자열): 각 탐지의 바운딩 박스에 상대적인 아이콘 배치용 기준 위치(동적 모드에서만). 옵션에는 CENTER(박스 중앙), 모서리(TOP_LEFT, TOP_RIGHT, BOTTOM_LEFT, BOTTOM_RIGHT), 변의 중간점(TOP_CENTER, CENTER_LEFT, CENTER_RIGHT, BOTTOM_CENTER), 또는 CENTER_OF_MASS(객체의 질량 중심)가 포함됩니다..x_position(정수): 정적 모드 위치 지정용 X 좌표입니다. 양수 값은 이미지의 왼쪽 가장자리부터의 위치를 뜻합니다. 음수 값은 오른쪽 가장자리부터의 위치를 뜻합니다(예: -10은 아이콘을 오른쪽 가장자리에서 10픽셀 떨어진 위치에 배치함)..y_position(정수): 정적 모드 위치 지정용 Y 좌표입니다. 양수 값은 이미지의 상단 가장자리부터의 위치를 뜻합니다. 음수 값은 하단 가장자리부터의 위치를 뜻합니다(예: -10은 아이콘을 하단 가장자리에서 10픽셀 떨어진 위치에 배치함)..
출력
image(image): 워크플로의 이미지.
마지막 업데이트
도움이 되었나요?