Image Grab PIL (ImageGrabPIL) - ComfyUI-KJNodes

Image Grab PIL 노드는 컴퓨터 화면에서 직접 지정한 사각형 영역을 캡처할 수 있는 화면 캡처 도구입니다. 핵심 기능은 화면 내용을 실시간으로 가져와 ComfyUI 워크플로에서 처리할 수 있는 이미지 데이터로 변환하는 것입니다. 이를 통해 화면상의 모든 시각적 요소를 AI 이미지 처리 파이프라인으로 빠르게 가져올 수 있습니다.

노드 기능

이 노드는 Python의 PIL(Pillow) 라이브러리의 ImageGrab.grab 메서드를 기반으로 구현되었으며, 화면 좌표의 바운딩 박스를 정의하여 픽셀을 캡처합니다. 캡처된 이미지 데이터는 자동으로 PyTorch 텐서 형식으로 변환되고, ComfyUI의 표준 IMAGE 타입에 맞게 [0, 1] 범위의 플로팅 포인트 값으로 정규화됩니다. 또한, 이 노드는 연속적으로 여러 프레임을 캡처할 수 있으며, 프레임 사이에 구성 가능한 지연 시간을 지원하여 동적이거나 변화하는 화면 콘텐츠를 캡처하는 기반을 제공합니다.

노드 파라미터 설명 - Image Grab PIL

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`x`	INT	예	0	0 - 4096 (스텝: 1)	x (입력 파라미터): 캡처 영역의 왼쪽 상단 모서리의 수평 좌표를 정의합니다(단위: 픽셀). 범위는 0부터 4096까지, 스텝은 1입니다.
`y`	INT	예	0	0 - 4096 (스텝: 1)	y (입력 파라미터): 캡처 영역의 왼쪽 상단 모서리의 수직 좌표를 정의합니다(단위: 픽셀). 범위는 0부터 4096까지, 스텝은 1입니다.
`width`	INT	예	512	0 - 4096 (스텝: 1)	width (입력 파라미터): 캡처 영역의 너비를 정의합니다(단위: 픽셀). 범위는 0부터 4096까지, 스텝은 1입니다.
`height`	INT	예	512	0 - 4096 (스텝: 1)	height (입력 파라미터): 캡처 영역의 높이를 정의합니다(단위: 픽셀). 범위는 0부터 4096까지, 스텝은 1입니다.
`num_frames`	INT	예	1	1 - 255 (스텝: 1)	num_frames (입력 파라미터): 연속적으로 캡처할 프레임 수를 설정합니다. 범위는 1부터 255까지, 스텝은 1입니다.
`delay`	FLOAT	예	0.1	0.0 - 10.0 (스텝: 0.01)	delay (입력 파라미터): 여러 프레임을 연속 캡처할 때, 각 프레임 사이의 대기 시간을 설정합니다(단위: 초). 범위는 0.0부터 10.0까지, 스텝은 0.01입니다.

출력

파라미터 이름	데이터 타입	설명
image	IMAGE	image (출력 파라미터): 캡처된 화면 이미지를 출력하며, 형식은 ComfyUI 표준 IMAGE 타입(텐서)입니다.

사용 사례

이 노드는 실시간 이미지 생성 또는 스타일 전이 워크플로에서 매우 유용합니다. 예를 들어, KSampler 노드와 연결하여 "실시간 디퓨전" 루프를 생성할 수 있습니다: 먼저 화면의 그림이나 디자인 스케치를 캡처한 다음, Stable Diffusion 모델이 이를 즉시 다시 그리거나 스타일화하도록 하고, 결과를 다시 화면에 출력하여 상호작용적인 창작 루프를 형성합니다. 자동 실행 대기열 기능과 결합하면 거의 실시간의 연속 처리를 구현할 수 있습니다.

주의사항

이 노드의 캡처 범위는 실제 화면 해상도의 제한을 받습니다. 파라미터 상한이 4096으로 설정되어 있지만, 유효 영역은 사용자의 모니터 경계를 벗어나서는 안 됩니다. 여러 프레임을 캡처할 때, 짧은 지연 시간과 높은 프레임 수는 시스템 부하를 증가시킬 수 있습니다. 이 노드는 화면에 보이는 콘텐츠만 캡처할 수 있으며, 다른 창에 가려지거나 최소화된 영역은 캡처할 수 없습니다.

Image Grab PIL 노드 소스 코드 링크

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

Image Grab PIL(ImageGrabPIL)

Image Grab PIL