Grow Mask With Blur (GrowMaskWithBlur) - ComfyUI-KJNodes

Grow Mask With Blur 노드는 Kornia 라이브러리의 형태학적 연산을 기반으로 마스크 확장을 구현하며, 단일 마스크 또는 마스크 배치 처리를 지원합니다.

GrowMaskWithBlur는 마스크를 처리하고 향상시키는 노드입니다. 핵심 기능은 입력된 마스크 영역을 확장하거나 축소하며, 블러 효과를 적용하여 부드럽거나 특정 형태 변화를 가진 마스크를 생성하는 것입니다.

노드 기능

이 노드는 Kornia 라이브러리의 형태학적 연산을 기반으로 마스크 확장을 구현하며, 단일 마스크 또는 마스크 배치 처리를 지원합니다. 핵심 메커니즘은 픽셀 경계를 조정하여 마스크 크기를 변경하고, 선택적으로 가우시안 블러를 적용하여 가장자리를 부드럽게 만들며, 시퀀스 프레임 간 전환을 처리하기 위한 보간 및 감쇠 인자를 제공합니다.

노드 파라미터 설명 - Grow Mask With Blur

연결 입력 (Inputs)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`mask`	MASK	예	-	-	입력 마스크 또는 마스크 배치.

컨트롤 파라미터 (Parameters)

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`expand`	INT	예	0	-MAX_RESOLUTION - MAX_RESOLUTION (단계: 1)	expand (입력 파라미터): 마스크 확장 또는 축소를 위한 픽셀 수를 제어합니다. 범위는 -MAX_RESOLUTION에서 MAX_RESOLUTION까지이며, 단계는 1입니다. 양수는 확장, 음수는 축소를 의미합니다.
`incremental_expandrate`	FLOAT	예	0.0	0.0 - 100.0 (단계: 0.1)	incremental_expandrate (입력 파라미터): 시퀀스의 각 프레임에 대해 이 비율로 확장량을 증가시킵니다. 범위는 0.0에서 100.0까지이며, 단계는 0.1입니다.
`tapered_corners`	BOOLEAN	예	True	-	tapered_corners (입력 파라미터): 활성화 시, 형태학적 연산에 테이퍼드(tapered) 코너를 사용하고, 그렇지 않으면 표준 직사각형을 사용합니다. 기본적으로 활성화되어 있습니다.
`flip_input`	BOOLEAN	예	False	-	flip_input (입력 파라미터): 활성화 시, 처리 전 입력 마스크를 반전시킵니다(검정색과 흰색 교환).
`blur_radius`	FLOAT	예	0.0	0.0 - 100 (단계: 0.1)	blur_radius (입력 파라미터): 처리된 마스크에 적용할 가우시안 블러의 반경입니다. 값이 0보다 클 때 적용되며, 범위는 0.0에서 100까지, 단계는 0.1입니다.
`lerp_alpha`	FLOAT	예	1.0	0.0 - 1.0 (단계: 0.01)	lerp_alpha (입력 파라미터): 프레임 간 선형 보간에 사용되는 Alpha 값입니다. 범위는 0.0에서 1.0까지이며, 단계는 0.01입니다.
`decay_factor`	FLOAT	예	1.0	0.0 - 1.0 (단계: 0.01)	decay_factor (입력 파라미터): 프레임 간 보간에 사용되는 감쇠 인자입니다. 범위는 0.0에서 1.0까지이며, 단계는 0.01입니다.
`fill_holes`	BOOLEAN	아니오	False	-	마스크의 구멍을 채웁니다(속도가 느림).

출력 (Outputs)

파라미터 이름	데이터 타입	설명
`mask`	MASK	mask (출력 파라미터): 처리된 최종 마스크를 출력합니다.
`mask_inverted`	MASK	mask_inverted (출력 파라미터): 처리된 마스크의 반전된 버전을 출력합니다.

사용 시나리오

이미지 생성 또는 비디오 처리 워크플로에서 이 노드는 매우 유용합니다. 예를 들어, 점차적으로 나타나는 애니메이션 효과를 만들 때 초기 객체 마스크를 이 노드에 연결하고, expand 값을 프레임마다 증가시키고 blur_radius와 함께 사용하여 객체 가장자리가 부드럽게 확산되는 애니메이션 마스크 시퀀스를 생성할 수 있습니다.

주의사항

fill_holes(구멍 채우기) 기능은 속도가 느린 작업으로 표시되어 있으므로, 고해상도 마스크 또는 대량의 데이터를 처리할 때는 워크플로 실행 효율에 영향을 미치지 않도록 주의해서 사용해야 합니다.

Grow Mask With Blur 노드 소스 코드 링크

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

Grow Mask With Blur(GrowMaskWithBlur)