Load & Resize Image (LoadAndResizeImage) - ComfyUI-KJNodes

Load & Resize Image 노드는 PIL 라이브러리를 기반으로 이미지를 처리하며, 일반적인 이미지 형식을 지원하고 EXIF 방향을 자동으로 보정합니다.

Load & Resize Image 노드는 강력한 이미지 로딩 및 전처리 도구입니다. 핵심 기능은 ComfyUI의 입력 디렉토리에서 이미지를 로드하고, 선택적으로 크기를 조정하고, 투명 채널을 처리하며, 마스크를 생성하여 후속 이미지 생성 또는 편집 워크플로를 준비하는 것입니다.

노드 기능

이 노드는 PIL 라이브러리를 기반으로 이미지를 처리하며, 일반적인 이미지 형식을 지원하고 EXIF 방향을 자동으로 보정합니다. 기술적 핵심은 사용자가 설정한 목표 크기와 비율 유지 옵션에 따라 이미지를 정확하게 스케일링하고 패딩할 수 있다는 점입니다. 또한 지정된 색상 채널(예: Alpha, 빨강, 초록, 파랑)을 마스크로 추출하거나, 지정된 배경색을 투명 영역에 채울 수 있습니다.

노드 파라미터 설명 - Load & Resize Image

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	설명
`image`	COMBO (이미지 목록)	예	ComfyUI의 입력 디렉토리에서 이미지를 선택합니다. 위젯은 사용 가능한 이미지 파일을 나열합니다.
`mask_channel`	COMBO	예	마스크 출력에 사용할 채널입니다. 옵션에는 Alpha, Red, Green, Blue, None이 있습니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	값 범위 / 옵션	설명
`resize`	BOOLEAN	예	False	-	이미지 크기 조정 기능을 활성화할지 여부입니다. `True`로 설정하면 후속 파라미터에 따라 이미지가 스케일링됩니다.
`width`	INT	예	512	0 – MAX_RESOLUTION (간격: 8)	크기 조정의 목표 너비입니다 (`resize` 활성화 시에만 사용됨).
`height`	INT	예	512	0 – MAX_RESOLUTION (간격: 8)	크기 조정의 목표 높이입니다 (`resize` 활성화 시에만 사용됨).
`repeat`	INT	예	1	1 – 4096 (간격: 1)	로드된 이미지를 배치 차원에서 반복할 횟수입니다.
`keep_proportion`	BOOLEAN	예	False	-	크기 조정 시 이미지의 원본 가로세로 비율을 유지할지 여부입니다.
`divisible_by`	INT	예	2	0 – 512 (간격: 1)	조정된 이미지 크기(너비와 높이)를 이 값의 정수 배수로 정렬합니다.
`background_color`	STRING	예	""	-	투명(Alpha) 영역을 지정된 색상으로 채웁니다. 16진수 색상(예: `#RRGGBB`) 또는 색상 이름을 허용합니다.

출력 (Outputs)

파라미터 이름	데이터 타입	설명
`image`	IMAGE	처리된 이미지 텐서입니다 (`background_color`가 지정된 경우 투명도가 채워짐).
`mask`	MASK	선택한 `mask_channel`에서 추출된 마스크입니다.
`width`	INT	출력 이미지의 실제 너비입니다 (크기 조정 또는 비율 조정 후).
`height`	INT	출력 이미지의 실제 높이입니다.
`image_path`	STRING	로드된 이미지의 파일 경로입니다.

사용 시나리오

이 노드는 이미지를 일괄 처리하거나 입력 이미지 크기를 통일해야 하는 워크플로에서 매우 유용합니다. 예를 들어, Stable Diffusion의 이미지 기반 이미지 생성 워크플로를 시작하기 전에 이 노드를 사용하여 참조 이미지를 로드하고, 모델이 요구하는 512x512 해상도로 정확하게 크기를 조정하며, 동시에 알파 채널을 마스크로 추출하여 재생성 시 특정 영역을 보호할 수 있습니다.

주의사항

keep_proportion (비율 유지)을 활성화하면, 출력되는 실제 크기는 설정한 width와 height와 완전히 일치하지 않을 수 있으며, 시스템은 원본 이미지 비율과 divisible_by 파라미터에 따라 조정합니다. 또한 background_color 파라미터는 특정 색상 문자열 형식(예: "#RRGGBB" 또는 색상 이름)을 입력해야 합니다.

Load & Resize Image 노드 소스 코드 링크

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

Load & Resize Image(LoadAndResizeImage)

Load And Resize Image