라인 카운터 시각화
이미지의 선 영역 위에 마스크를 적용합니다.
이미지에 선 영역을 그려 개수 경계를 시각화하고, 지정한 선을 가로지르는 객체를 추적하는 선 카운터 워크플로를 위해 in/out 개수 레이블이 있는 색상 선 오버레이를 표시합니다.
이 블록의 작동 방식
이 블록은 이미지와 선 영역 좌표(선을 정의하는 두 점)를 받아 카운트 통계가 포함된 카운팅 선의 시각적 표현을 그립니다. 이 블록은:
이미지와 선 영역 좌표(두 점: [x1, y1] 및 [x2, y2])를 입력으로 받습니다
지정된 색상과 두께를 사용해 영역 좌표로부터 선 마스크를 생성합니다
지정된 불투명도로 선을 이미지 위에 오버레이하여 반투명한 선 시각화를 만듭니다
count_in(영역 안으로 들어온 객체)과 count_out(영역 밖으로 나간 객체) 값을 보여주는 텍스트 레이블을 표시합니다
사용자 지정 가능한 텍스트 스타일로 선의 시작점(x1, y1)에 카운트 텍스트를 배치합니다
원본 이미지 위에 선 영역과 카운트 통계가 오버레이된 주석 이미지가 반환됩니다
이 블록은 정의된 경계선을 가로지르는 객체의 이동을 추적하는 데 사용되는 선 카운팅 영역을 시각화합니다. 선은 지정된 두 점 사이에 사용자 지정 가능한 색상, 두께, 불투명도로 그려집니다. 카운트 통계(in 및 out)는 텍스트 레이블로 표시되며, 일반적으로 객체의 경계 통과를 추적하는 Line Counter 블록에서 연결됩니다. 이 시각화는 사용자가 카운팅 경계를 확인하고 카운트 결과를 실시간으로 모니터링하는 데 도움이 됩니다. 참고: 이 블록은 선 영역이 객체 탐지 시각화를 위한 배경 기준 레이어를 제공하므로, 일반적으로 워크플로에서 다른 시각화 블록보다 앞에 배치해야 합니다.
일반적인 사용 사례
라인 카운터 시각화: 사람 계수, 차량 계수 또는 객체가 정의된 선 경계를 가로지르는 객체 추적 워크플로에서 선 카운팅 영역을 시각화하고, 카운팅 선과 in/out 통계를 표시합니다
교통 및 이동 모니터링: 교통 모니터링, 보행자 흐름 분석 또는 입/출입 추적 애플리케이션에서 카운팅 선을 표시하여 카운팅 경계와 현재 카운트를 시각화합니다
검문소 및 출입 통제: 보안 또는 출입 통제 워크플로에서 검문소, 게이트 또는 출입 지점의 카운팅 선을 시각화하여 모니터링 경계와 입/출입 카운트를 추적합니다
소매 및 비즈니스 분석: 소매, 호텔, 또는 비즈니스 인텔리전스 애플리케이션에서 보행자 유동 분석, 고객 흐름 모니터링 또는 점유율 추적을 위해 카운팅 선을 표시합니다
군중 관리 및 안전: 경계선을 가로지르는 객체 이동 추적이 중요한 군중 관리, 수용 인원 모니터링 또는 안전 워크플로를 위해 카운팅 선을 시각화합니다
실시간 카운팅 대시보드: 카운팅 선과 통계를 명확히 표시해야 하는 실시간 카운팅 대시보드, 모니터링 인터페이스 또는 라이브 비디오 피드를 위한 시각적 오버레이를 만듭니다
다른 블록에 연결하기
이 블록의 주석이 추가된 이미지는 다음과 연결할 수 있습니다:
Line Counter 블록 시각화에 표시되는 count_in 및 count_out 값을 받기 위해
기타 시각화 블록 (예: Bounding Box Visualization, Label Visualization, Polygon Visualization) 선 영역 시각화 위에 객체 탐지 주석을 추가하기 위해
데이터 저장 블록 (예: Local File Sink, CSV Formatter, Roboflow Dataset Upload) 문서화, 보고 또는 분석을 위해 선 영역 시각화가 포함된 이미지를 저장하기 위해
웹훅 블록 대시보드나 모니터링 도구에 표시할 수 있도록 선 영역이 포함된 시각화 결과를 외부 시스템, API 또는 웹 애플리케이션으로 보내기 위해
알림 블록 (예: Email Notification, Slack Notification) 경고나 보고서에서 시각적 증거로 사용할 선 영역이 포함된 주석 이미지를 전송하기 위해
비디오 출력 블록 라이브 모니터링, 카운팅 시각화 또는 후처리 분석을 위해 선 영역 시각화가 포함된 주석 비디오 스트림 또는 녹화본을 만들기 위해
유형 식별자
단계에서 다음 식별자를 사용하세요 "type" 필드: roboflow_core/line_counter_visualization@v1 워크플로우에 이 블록을 단계로 추가하려면.
속성
이름
유형
설명
참조
name
str
이 단계에 대한 고유 식별자를 입력하세요..
❌
copy_image
bool
이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요..
✅
zone
List[Any]
카운팅 선을 정의하는 정확히 두 점으로 구성된 [[x1, y1], [x2, y2]] 형식의 선 영역 좌표입니다. 선은 이 두 점 사이에 그려지며, 이 선을 통과하는 객체가 카운트됩니다. 일반적으로 Line Counter 블록의 zone 출력에 연결됩니다..
✅
color
str
선 영역의 색상입니다. 색상 이름(예: 'WHITE', 'RED'), 16진수 색상 코드(예: '#5bb573', '#FFFFFF') 또는 RGB 형식(예: 'rgb(255, 255, 255)')으로 지정할 수 있습니다. 선은 지정된 불투명도로 이 색상으로 그려집니다..
✅
두께
정수
픽셀 단위의 선 영역 두께입니다. 카운팅 선이 얼마나 두껍게 보일지 제어합니다. 값이 높을수록 더 두껍고 눈에 잘 띄는 선이 만들어지고, 값이 낮을수록 더 얇은 선이 만들어집니다. 일반적인 값 범위는 1~10픽셀입니다..
✅
text_thickness
정수
픽셀 단위의 카운트 텍스트 레이블 두께입니다. 텍스트가 얼마나 굵게 보일지(텍스트 문자의 선 두께)를 제어합니다. 값이 높을수록 더 두껍고 굵은 텍스트가 만들어지고, 값이 낮을수록 더 얇은 텍스트가 만들어집니다. 일반적인 값 범위는 1~3입니다..
✅
text_scale
float
카운트 텍스트 레이블의 배율입니다. count_in 및 count_out 값을 표시하는 텍스트 크기를 제어합니다. 1.0보다 큰 값은 텍스트를 더 크게 만들고, 1.0보다 작은 값은 텍스트를 더 작게 만듭니다. 일반적인 값 범위는 0.5~2.0입니다..
✅
count_in
정수
선 영역 안으로 들어온 객체 수입니다('in' 방향으로 한쪽에서 다른 쪽으로 경계를 통과). 일반적으로 Line Counter 블록의 count_in 출력(예: '$steps.line_counter.count_in')에 연결됩니다. 이 값은 시각화 텍스트 레이블에 표시됩니다..
✅
count_out
정수
선 영역 밖으로 나간 객체 수입니다('out' 방향으로 한쪽에서 다른 쪽으로 경계를 통과). 일반적으로 Line Counter 블록의 count_out 출력(예: '$steps.line_counter.count_out')에 연결됩니다. 이 값은 시각화 텍스트 레이블에 표시됩니다..
✅
opacity
float
선 영역 오버레이의 불투명도로, 0.0(완전히 투명)에서 1.0(완전히 불투명)까지의 범위를 가집니다. 카운팅 선이 이미지 위에서 얼마나 투명하게 보일지 제어합니다. 값이 낮을수록 배경과 섞이는 더 투명한 선이 만들어지고, 값이 높을수록 더 불투명하고 눈에 띄는 선이 만들어집니다. 균형 잡힌 가시성을 위해 일반적인 값 범위는 0.2~0.5입니다..
✅
이 참조 열은 워크플로우 런타임에서 사용 가능한 동적 값으로 속성을 매개변수화할 수 있는 가능성을 나타냅니다 워크플로우 런타임입니다. 자세한 내용은 바인딩 을 참조하세요.
입력 및 출력 바인딩
사용 가능한 연결은 바인딩 유형에 따라 달라집니다. 어떤 바인딩 유형인지 확인하세요 라인 카운터 시각화 버전 v1 을 가지고 있는지.
입력 및 출력 바인딩
입력
이미지(이미지): 시각화할 이미지..copy_image(boolean): 이 옵션을 활성화하면 시각화를 위해 입력 이미지의 복사본을 만들어 원본을 보존합니다. 여러 시각화를 겹쳐 사용할 때 이 옵션을 사용하세요..zone(list_of_values): 카운팅 선을 정의하는 정확히 두 점으로 구성된 [[x1, y1], [x2, y2]] 형식의 선 영역 좌표입니다. 선은 이 두 점 사이에 그려지며, 이 선을 통과하는 객체가 카운트됩니다. 일반적으로 Line Counter 블록의 zone 출력에 연결됩니다..color(string): 선 영역의 색상입니다. 색상 이름(예: 'WHITE', 'RED'), 16진수 색상 코드(예: '#5bb573', '#FFFFFF') 또는 RGB 형식(예: 'rgb(255, 255, 255)')으로 지정할 수 있습니다. 선은 지정된 불투명도로 이 색상으로 그려집니다..두께(정수): 픽셀 단위의 선 영역 두께입니다. 카운팅 선이 얼마나 두껍게 보일지 제어합니다. 값이 높을수록 더 두껍고 눈에 잘 띄는 선이 만들어지고, 값이 낮을수록 더 얇은 선이 만들어집니다. 일반적인 값 범위는 1~10픽셀입니다..text_thickness(정수): 픽셀 단위의 카운트 텍스트 레이블 두께입니다. 텍스트가 얼마나 굵게 보일지(텍스트 문자의 선 두께)를 제어합니다. 값이 높을수록 더 두껍고 굵은 텍스트가 만들어지고, 값이 낮을수록 더 얇은 텍스트가 만들어집니다. 일반적인 값 범위는 1~3입니다..text_scale(float): 카운트 텍스트 레이블의 배율입니다. count_in 및 count_out 값을 표시하는 텍스트 크기를 제어합니다. 1.0보다 큰 값은 텍스트를 더 크게 만들고, 1.0보다 작은 값은 텍스트를 더 작게 만듭니다. 일반적인 값 범위는 0.5~2.0입니다..count_in(정수): 선 영역 안으로 들어온 객체 수입니다('in' 방향으로 한쪽에서 다른 쪽으로 경계를 통과). 일반적으로 Line Counter 블록의 count_in 출력(예: '$steps.line_counter.count_in')에 연결됩니다. 이 값은 시각화 텍스트 레이블에 표시됩니다..count_out(정수): 선 영역 밖으로 나간 객체 수입니다('out' 방향으로 한쪽에서 다른 쪽으로 경계를 통과). 일반적으로 Line Counter 블록의 count_out 출력(예: '$steps.line_counter.count_out')에 연결됩니다. 이 값은 시각화 텍스트 레이블에 표시됩니다..opacity(0에서 1 사이의 실수): 선 영역 오버레이의 불투명도로, 0.0(완전히 투명)에서 1.0(완전히 불투명)까지의 범위를 가집니다. 카운팅 선이 이미지 위에서 얼마나 투명하게 보일지 제어합니다. 값이 낮을수록 배경과 섞이는 더 투명한 선이 만들어지고, 값이 높을수록 더 불투명하고 눈에 띄는 선이 만들어집니다. 균형 잡힌 가시성을 위해 일반적인 값 범위는 0.2~0.5입니다..
출력
이미지(이미지): 워크플로의 이미지입니다.
마지막 업데이트
도움이 되었나요?