ComfyUI Node: 🐯 YFG Text Mask Overlay

🐯 YFG Text Mask Overlay:

The textMaskOverlay_node is a versatile tool designed to overlay text onto a mask, transforming it into an image with the text embedded. This node is particularly useful for AI artists who want to add textual elements to their visual creations seamlessly. By leveraging different font sources and sizes, the node ensures that the text fits perfectly within the contours of the mask, providing a polished and professional look. The primary goal of this node is to enhance image manipulation capabilities by integrating text overlays, making it an essential tool for creating unique and customized visual effects.

🐯 YFG Text Mask Overlay Input Parameters:

font_source

This parameter determines the source of the font to be used for the text overlay. You can choose from "System", "Node Folder", or "Directory". Each option allows you to select fonts from different locations, providing flexibility in font selection. The choice of font source impacts the appearance of the text and can be tailored to match the desired style of the image.

system_font

Specifies the font to be used when the font_source is set to "System". The default value is "impact.ttf". This parameter allows you to select a specific system font, ensuring that the text overlay matches your design requirements.

node_font

Specifies the font to be used when the font_source is set to "Node Folder". The default value is "malgunbd.ttf". This parameter allows you to select a specific font from the node's folder, providing additional customization options for the text overlay.

usr_font_dir

This parameter is a string that specifies the directory path where user fonts are stored. It is used when the font_source is set to "Directory". The default value is the user's directory. This parameter allows you to use custom fonts stored in a specific directory, offering greater flexibility in font selection.

directory_font

Specifies the font to be used when the font_source is set to "Directory". The default value is the first font in the directory, if available. This parameter allows you to select a specific font from the user-specified directory, ensuring that the text overlay matches your design requirements.

text

This parameter is a string that contains the text to be overlaid on the mask. The default value is "TEXT". This parameter allows you to specify the exact text to be added to the image, providing a way to customize the content of the text overlay.

mask

This parameter is the mask onto which the text will be overlaid. It is a required input and serves as the base for the text overlay process. The mask defines the area where the text will be placed, ensuring that the text fits within the specified contours.

🐯 YFG Text Mask Overlay Output Parameters:

mask

The mask output is the processed mask with the text overlay applied. This output retains the original mask's structure but includes the added text, making it ready for further image manipulation or use in other nodes.

image

The image output is the final image with the text overlay. This output converts the processed mask into an image format, providing a visual representation of the text overlay. It is useful for previewing the final result or for use in other image processing tasks.

🐯 YFG Text Mask Overlay Usage Tips:

• Ensure that the font_source is correctly set to match the location of your desired font. This will ensure that the text overlay appears as intended.
• Adjust the text parameter to fit within the contours of the mask. Experiment with different text lengths and font sizes to achieve the best visual effect.
• Use high-contrast colors for the text to ensure that it stands out against the mask background, enhancing readability and visual impact.

🐯 YFG Text Mask Overlay Common Errors and Solutions:

"Font not found"

• Explanation: The specified font could not be located in the selected font source.
• Solution: Verify that the font file exists in the specified location and that the font_source parameter is correctly set.

"Text exceeds mask boundaries"

• Explanation: The specified text is too long to fit within the contours of the mask.
• Solution: Reduce the length of the text or adjust the font size to ensure that the text fits within the mask boundaries.

"Invalid mask input"

• Explanation: The provided mask input is not in the correct format or is missing.
• Solution: Ensure that the mask input is correctly specified and is in the required format. Verify that the mask is properly loaded before running the node.