Create Text Mask (CreateTextMask) - ComfyUI-KJNodes

Create Text Mask 노드는 Pillow 이미지 라이브러리를 기반으로 캔버스를 생성하고 텍스트를 렌더링합니다.

Create Text Mask 노드는 지정된 텍스트를 포함하는 이미지와 그에 대응하는 마스크를 생성하는 데 사용됩니다. 사용자가 텍스트 내용, 글꼴, 색상, 위치 및 크기를 사용자 정의할 수 있으며, 투명 배경의 텍스트 레이어와 후속 이미지 처리 워크플로에 사용 가능한 마스크를 출력합니다.

노드 기능

이 노드는 Pillow 이미지 라이브러리를 기반으로 캔버스를 생성하고 텍스트를 렌더링합니다. 특정 폴더에서 TrueType 글꼴 파일을 로드하는 것을 지원하며, 단일 프레임 이미지를 생성하거나 시작 및 종료 회전 각도를 설정하여 다중 프레임의 회전 애니메이션 시퀀스를 생성할 수 있습니다. 출력되는 이미지와 마스크 형식은 ComfyUI의 표준 IMAGE 및 MASK 데이터 타입과 호환됩니다.

노드 파라미터 설명 - Create Text Mask

Inputs

파라미터 이름	데이터 타입	필수	기본값	범위/옵션	설명
`font`	COMBO	예	-	-	지정된 글꼴 폴더에서 사용할 글꼴 파일을 선택합니다.
`invert`	BOOLEAN	예	False	-	마스크 영역을 반전시켜 텍스트 영역과 배경 영역의 마스크 값을 서로 바꿉니다.
`frames`	INT	예	1	1 - 4096 (스텝: 1)	생성할 이미지 또는 애니메이션의 프레임 수를 지정합니다.
`text_x`	INT	예	0	0 - 4096 (스텝: 1)	텍스트가 캔버스에서 시작하는 수평 위치(X 좌표)를 설정합니다.
`text_y`	INT	예	0	0 - 4096 (스텝: 1)	텍스트가 캔버스에서 시작하는 수직 위치(Y 좌표)를 설정합니다.
`font_size`	INT	예	32	8 - 4096 (스텝: 1)	텍스트의 글꼴 크기를 설정합니다.
`font_color`	STRING	예	white	-	텍스트의 색상을 설정합니다. 색상 이름(예: "white") 또는 16진수 값(예: "#FFFFFF")으로 표시합니다.
`text`	STRING	예	HELLO!	-	렌더링할 텍스트 내용을 입력합니다. 여러 줄의 텍스트를 지원합니다.
`width`	INT	예	512	16 - 4096 (스텝: 1)	생성할 이미지의 너비를 설정합니다.
`height`	INT	예	512	16 - 4096 (스텝: 1)	생성할 이미지의 높이를 설정합니다.
`start_rotation`	INT	예	0	0 - 359 (스텝: 1)	텍스트의 시작 회전 각도(첫 번째 프레임만)를 설정합니다.
`end_rotation`	INT	예	0	-359 - 359 (스텝: 1)	텍스트의 종료 회전 각도(마지막 프레임)를 설정합니다.

출력

파라미터 이름	데이터 타입	설명
IMAGE	IMAGE	렌더링된 텍스트 이미지를 출력하며, 배경은 투명합니다.
MASK	MASK	텍스트 이미지에 대응하는 흑백 마스크를 출력합니다.

사용 시나리오

텍스트 타이틀 제작, 이미지에 워터마크 추가 또는 텍스트 형태의 마스크가 필요한 지역적 리페인팅 워크플로를 생성할 때 이 노드는 매우 유용합니다. 예를 들어, 먼저 텍스트 마스크를 생성한 다음 이를 "VAE Encode" 또는 "Image Composite" 노드에 연결하여 텍스트 기반 이미지 생성 또는 지역적 인페인팅의 정확한 영역을 제어할 수 있습니다.

주의사항

글꼴 파일은 노드가 정상적으로 인식하고 로드할 수 있도록 ComfyUI/custom_nodes/ComfyUI-KJNodes/fonts 디렉토리에 미리 배치되어야 합니다. 생성되는 이미지 크기는 width 및 height 파라미터에 의해 제한되며, 최대 4096x4096입니다.

Create Text Mask 노드 소스 코드 링크

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

Create Text Mask(CreateTextMask)

Create Text Mask