DrawInstanceDiffusionTracking

DrawInstanceDiffusionTracking 노드는 이미지 배치와 TRACKING 유형의 트래킹 데이터를 입력으로 받습니다.

DrawInstanceDiffusionTracking 노드는 이미지 상에서 인스턴스 세그멘테이션 및 트래킹 결과를 시각화하는 데 사용됩니다. 이 노드의 핵심 기능은 CreateInstanceDiffusionTracking 노드에서 생성된 트래킹 데이터를 읽어 해당 데이터(객체의 바운딩 박스 및 카테고리 라벨 등)를 대응하는 이미지 위에 그려, 주석 정보가 포함된 시각화 이미지를 생성하는 것입니다.

노드 기능

이 노드는 이미지 배치와 TRACKING 유형의 트래킹 데이터를 입력으로 받습니다. 내부적으로 Matplotlib의 무지개 색상 맵을 사용하여 서로 다른 트래킹 카테고리에 색상을 할당하고, PIL 라이브러리의 드로잉 기능을 활용하여 각 이미지 프레임에서 감지된 객체의 바운딩 박스와 선택적인 카테고리 텍스트를 원본 이미지 위에 오버레이합니다. 사용자는 박스 선 너비, 글꼴 및 텍스트 표시와 같은 그리기 스타일을 사용자 정의할 수 있습니다.

노드 파라미터 설명 - DrawInstanceDiffusionTracking

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	값 범위/옵션	설명
`image`	IMAGE	예	-	-	트래킹 데이터를 그릴 입력 이미지 배치입니다.
`tracking`	TRACKING	예	-	-	CreateInstanceDiffusionTracking 노드로부터의 트래킹 데이터로, 카테고리 및 바운딩 박스 정보를 포함합니다.
`font`	COMBO	예	-	-	텍스트를 그리는 데 사용할 글꼴 이름입니다. 사용 가능한 글꼴 중에서 선택합니다.

제어 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	값 범위/옵션	설명
`box_line_width`	INT	예	2	1 - 10 (스텝: 1)	바운딩 박스를 그릴 선의 너비를 설정합니다. 값 범위는 1~10입니다.
`draw_text`	BOOLEAN	예	True	-	바운딩 박스 옆에 카테고리 라벨 텍스트를 그릴지 여부를 제어하는 논리값 전환입니다.
`font_size`	INT	예	20	-	텍스트를 그릴 글꼴 크기를 설정합니다.

출력

파라미터 이름	데이터 타입	설명
image	IMAGE	트래킹 박스와 라벨이 그려진 시각화 이미지를 출력합니다.

사용 시나리오

비디오 분석 또는 시퀀스 이미지 처리 워크플로에서 이 노드는 매우 유용합니다. 예를 들어, 비디오의 모든 프레임을 처리하여 객체 트래킹 데이터를 얻은 후, 이 노드를 사용하여 트래킹 박스와 ID 정보를 원본 비디오 이미지에 프레임별로 다시 그려 트래킹 궤적이 포함된 시각화된 비디오를 생성할 수 있습니다. 이를 통해 트래킹 알고리즘의 정확성과 안정성을 직관적으로 검사할 수 있습니다.

주의사항

입력 tracking 데이터는 반드시 CreateInstanceDiffusionTracking 노드에서 와야 하며, 그 구조는 입력된 이미지 배치와 시간 순서상 엄격하게 대응되어야 합니다. 트래킹 데이터의 프레임 인덱스가 이미지 배치의 범위를 벗어나는 경우 해당 그리기 작업은 건너뜁니다.