Image Concatenate (ImageConcanate) - ComfyUI-KJNodes

Image Concatenate 노드는 기술적으로 네 방향(오른쪽, 아래, 왼쪽, 위)으로 이미지를 연결(concatenate)하는 것을 지원합니다.

Image Concatenate 노드는 두 개의 입력(image1과 image2)을 지정된 방향으로 연결하여 새로운 출력물을 생성하는 것이 핵심 기능인 이미지 처리 노드입니다. 입력은 이미지 또는 마스크 모두 가능합니다. 시각적 요소를 조합하는 직관적인 방법을 제공하며, 복잡한 이미지 레이아웃을 구축하기 위한 기본 도구입니다.

노드 기능

이 노드는 기술적으로 네 방향(오른쪽, 아래, 왼쪽, 위)으로의 연결을 지원합니다. match_image_size 옵션이 활성화되면, 두 번째 이미지의 크기를 첫 번째 이미지의 연결 방향 기준 크기에 맞게 자동으로 조정하여 연결 가장자리가 깔끔하게 맞도록 합니다. 비활성화된 경우, 공유 축의 차원이 일치하지 않으면, 더 작은 이미지가 중앙에 배치되고 제로 패딩되며 오류가 발생하지 않습니다. 또한, image2가 image1과 다른 타입(이미지 vs 마스크)인 경우 자동으로 변환됩니다: 이미지 → 마스크 변환은 RGB 평균을 사용하고, 마스크 → 이미지 변환은 단일 채널을 RGB 채널에 복제합니다. 내부적으로 이 노드는 입력 이미지의 배치(batch) 크기가 일치하지 않는 경우 마지막 이미지를 반복하여 배치를 맞추고 출력의 안정성을 보장합니다.

노드 파라미터 설명 - Image Concatenate

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	값 범위/옵션	설명
`image1`	IMAGE / MASK	예	-	-	image1 (입력 파라미터): 연결 기준이 되는 첫 번째 입력(이미지 또는 마스크)입니다. 출력 타입은 이 입력의 타입과 같습니다.
`image2`	IMAGE / MASK	예	-	-	image2 (입력 파라미터): 첫 번째 입력에 연결될 두 번째 입력(이미지 또는 마스크)입니다. 타입이 image1과 다르면 자동 변환이 적용됩니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	값 범위/옵션	설명
`direction`	COMBO	예	right	"right", "down", "left", "up"	image2를 image1에 연결할 방향입니다.
`match_image_size`	BOOLEAN	예	True	-	match_image_size (입력 파라미터): 논리값(Boolean)으로, 기본값은 True입니다. 활성화되면 두 번째 이미지의 크기를 첫 번째 이미지의 연결 방향 기준 크기에 맞게 자동 조정합니다. 비활성화되면 차원이 일치하지 않을 경우 더 작은 이미지를 중앙에 배치하고 제로 패딩합니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
IMAGE / MASK	IMAGE / MASK (image1과 동일)	출력 (출력 파라미터): 연결 완료 후 생성된 새로운 이미지 또는 마스크입니다. 타입은 image1을 따릅니다.

사용 시나리오

구체적인 워크플로에서 이 노드는 주로 비교 이미지나 콜라주를 생성할 때 사용됩니다. 예를 들어, 이미지 생성이나 편집 과정에서 원본 이미지와 스타일화 처리된 이미지를 각각 입력한 후, "오른쪽"이나 "아래" 방향을 선택하여 연결하면 처리 전후의 효과를 나란히 배치하여 직관적으로 비교할 수 있습니다.

주의사항

연결 방향이 "왼쪽"이나 "위"인 경우, image2가 image1의 왼쪽이나 위쪽에 연결되므로 이미지의 순서가 최종 시각적 효과에 영향을 미친다는 점에 유의하세요. 또한 입력 이미지의 크기가 매우 다르고 크기 맞춤이 활성화되지 않은 경우, 더 작은 이미지는 중앙에 배치되고 제로 패딩되며 잘리지 않습니다. 마스크로 작업할 때 입력 타입(이미지 vs 마스크)이 다르면 자동 변환이 발생하므로 주의하세요.

Image Concatenate 노드 소스 코드 링크

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

Image Concatenate(ImageConcanate)

Image Concanate