Blockify Mask (BlockifyMask) - ComfyUI-KJNodes

Blockify Mask 노드는 하나 이상의 MASK 타입 입력을 받아 CPU 또는 GPU 장치에서 처리합니다.

Blockify Mask 노드는 마스크를 처리하는 도구로, 입력된 연속적인 마스크를 블록으로 구성된 형태로 변환합니다. 핵심 기능은 마스크의 경계 상자(bounding box)를 지정된 크기의 그리드로 나누고, 원본 마스크 픽셀이 포함된 그리드 블록을 유효 영역으로 채워 픽셀화된 마스크 효과를 생성하는 것입니다.

노드 기능

이 노드는 하나 이상의 MASK 타입 입력을 받아 CPU 또는 GPU 장치에서 처리합니다. 기술적 구현은 다음과 같습니다: 먼저 각 입력 마스크에 대해 유효 픽셀의 경계 상자를 계산한 후, 이 경계 상자 영역을 사용자가 지정한 block_size에 따라 그리드로 분할합니다. 각 그리드 블록에 원본 마스크의 픽셀이 하나라도 포함되어 있으면, 해당 블록 전체가 유효 영역으로 표시(채워짐)됩니다. 최종적으로 입력과 동일한 형태를 가지지만 내용이 블록화된 새로운 마스크를 출력합니다.

노드 파라미터 설명 - Blockify Mask

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`masks`	MASK	예	-	-	masks (입력 파라미터): 블록 효과로 변환될 원본 마스크를 입력합니다. 타입은 MASK입니다.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`block_size`	INT	예	32	8 - 512 (스텝: 1)	블록 크기. 값이 작을수록 블록이 더 조밀해집니다.
`device`	COMBO	아니오	cpu	"cpu", "gpu"	처리 장치를 선택합니다.

출력 (Output)

파라미터 이름	데이터 타입	설명
mask	MASK	mask (출력 파라미터): 출력되는 블록화된 마스크입니다. 타입은 MASK입니다.

사용 시나리오

이미지 생성 또는 편집 워크플로에서 이 노드는 스타일화된 선택 영역을 생성하는 데 사용할 수 있습니다. 예를 들어, 모자이크 또는 픽셀 아트 스타일 효과를 가진 이미지를 생성하고자 할 때, SAM 같은 노드를 사용하여 정밀한 객체 마스크를 먼저 생성한 후, 이 노드를 통해 블록화할 수 있습니다. 이후 이 블록화된 마스크를 리페인팅 또는 이미지 합성 노드에 입력하여 특수 효과의 적용 범위를 제한할 수 있습니다.

주의사항

블록화의 정밀도는 전적으로 block_size 파라미터에 의해 제어됩니다. 값이 작을수록 더 정밀한 블록이 생성되지만, 원본 마스크의 매끄러운 가장자리는 복원되지 않습니다. 이 처리는 주로 마스크의 경계 상자 영역에 적용되며, 완전히 빈 마스크는 변경되지 않습니다.

Blockify Mask 노드 소스 코드 링크

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

Blockify Mask(BlockifyMask)

Blockify Mask