Add Label (AddLabel) - ComfyUI-KJNodes

기술 구현 측면에서 Add Label 노드는 PIL 라이브러리를 사용하여 이미지 처리와 텍스트 렌더링을 수행합니다.

Add Label 노드는 입력된 이미지 위에 사용자 정의 텍스트가 포함된 레이블 바를 추가할 수 있는 이미지 주석 도구입니다. 이 노드의 핵심 기능은 텍스트가 있는 배경 영역을 생성하고 이를 원본 이미지와 결합하거나 겹쳐서 이미지에 설명 텍스트를 추가하는 것입니다.

노드 기능

기술 구현 측면에서 이 노드는 PIL 라이브러리를 사용하여 이미지 처리와 텍스트 렌더링을 수행합니다. 레이블 바를 이미지 가장자리에 "위, 아래, 왼쪽, 오른쪽" 방향으로 결합하거나 "오버레이" 모드로 이미지 위에 직접 겹쳐 놓는 것을 지원합니다. 노드는 지정된 폰트 폴더(일반적으로 ComfyUI/custom_nodes/ComfyUI-KJNodes/fonts)에서 폰트 파일을 로드하며, 사용자가 색상 문자열(예: "white", "#FF0000")을 통해 텍스트와 레이블 배경의 색상을 정의할 수 있도록 합니다.

노드 파라미터 설명 - Add Label

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	값 범위/옵션	설명
`image`	IMAGE	예	-	-	image (입력 파라미터): 레이블을 추가할 원본 이미지를 입력합니다.
`font`	COMBO	예	-	(사용 가능한 폰트 목록)	font (입력 파라미터): 텍스트 렌더링에 사용할 폰트 파일을 선택합니다. 폰트 파일은 지정된 `kjnodes_fonts` 디렉토리에 위치해야 합니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	값 범위/옵션	설명
`direction`	COMBO	예	up	"up", "down", "left", "right", "overlay"	레이블 바를 이미지에 추가할 방향을 설정합니다. `up`(위쪽), `down`(아래쪽), `left`(왼쪽), `right`(오른쪽) 또는 `overlay`(이미지 위에 직접 겹침) 중 선택할 수 있습니다.
`text_x`	INT	예	10	0 - 4096 (스텝: 1)	text_x (입력 파라미터): 레이블 바 내에서 텍스트의 수평 시작 위치(X 좌표)를 설정합니다. 값 범위는 0부터 4096까지입니다.
`text_y`	INT	예	2	0 - 4096 (스텝: 1)	text_y (입력 파라미터): 레이블 바 내에서 텍스트의 수직 시작 위치(Y 좌표)를 설정합니다. 값 범위는 0부터 4096까지입니다.
`height`	INT	예	48	-1 - 4096 (스텝: 1)	height (입력 파라미터): 레이블 바의 높이를 설정합니다(방향이 left 또는 right일 경우 이 파라미터는 너비를 제어합니다). 값이 -1이면 높이가 폰트 크기에 자동으로 맞춰집니다.
`font_size`	INT	예	32	0 - 4096 (스텝: 1)	font_size (입력 파라미터): 레이블 텍스트의 폰트 크기를 설정합니다. 값 범위는 0부터 4096까지입니다.
`font_color`	STRING	예	white	-	font_color (입력 파라미터): 레이블 텍스트의 색상을 정의합니다. 색상 이름(예: "white") 또는 16진수 색상 코드(예: "#FF0000")를 지원합니다.
`label_color`	STRING	예	black	-	label_color (입력 파라미터): 레이블 바 배경의 색상을 정의합니다. 색상 이름(예: "black") 또는 16진수 색상 코드를 지원합니다.
`text`	STRING	예	Text	-	text (입력 파라미터): 레이블 바에 표시할 텍스트 내용을 입력합니다.
`caption`	STRING	아니오	""	-	caption (입력 파라미터): 선택적 추가 캡션 텍스트입니다.

출력

파라미터 이름	데이터 타입	설명
IMAGE	IMAGE	IMAGE (출력 파라미터): 텍스트 레이블이 추가된 이미지를 출력합니다.

사용 시나리오

이 노드는 이미지 배치 처리나 생성 워크플로에서 매우 유용합니다. 예를 들어, 일련의 스타일 테스트 이미지를 생성한 후, 이 노드를 사용하여 각 이미지에 사용된 파라미터(예: 모델 이름, 샘플링 스텝 수)를 설명하는 레이블을 자동으로 추가하여 후속 비교와 선별을 용이하게 할 수 있습니다. 또한 만화 컷이나 스토리보드 이미지에 대화 텍스트나 번호를 추가하는 데에도 사용할 수 있습니다.

주의사항

"위, 아래, 왼쪽, 오른쪽" 방향을 선택할 경우, 이 작업은 출력 이미지의 크기(높이 또는 너비)를 변경한다는 점에 유의해야 합니다. 또한, 폰트 색상과 레이블 배경 색상은 여러 형식을 지원하지만, 입력된 문자열이 올바르게 RGB 색상 값으로 해석될 수 있도록 해야 합니다.

Add Label 노드 소스 코드 링크

Add Label 노드는 ComfyUI-KJNodes 노드 패키지에서 제공됩니다.

Add Label(AddLabel)

Add Label