ComfyUI Node: iTools Add Text Overlay

iTools Add Text Overlay:

The iToolsAddOverlay node is designed to enhance your images by adding a customizable text overlay or underlay. This node is particularly useful for artists and designers who want to annotate their images with additional information, such as titles, descriptions, or any other text. The overlay is added as a bar at the bottom of the image, and you can customize the text, font size, and background color to suit your needs. This feature allows you to maintain a consistent style across your images while providing essential information directly on the image itself. The node's flexibility in terms of overlay positioning and customization makes it a valuable tool for creating visually appealing and informative images.

iTools Add Text Overlay Input Parameters:

image

The image parameter is the primary input for this node, representing the image to which you want to add the text overlay. This parameter is crucial as it serves as the canvas for the overlay operation. The image should be in a compatible format that the node can process.

text

The text parameter allows you to specify the string of text that will be displayed on the overlay bar. This text can be anything you want to convey on the image, such as a description or title. The default value is 'img info:', and it is not multiline, meaning it should be a single line of text.

background_color

The background_color parameter lets you define the color of the overlay bar's background. It accepts a string representing a color in hexadecimal format, with the default being '#000000AA', which is a semi-transparent black. This parameter allows you to ensure that the text is readable against the image.

font_size

The font_size parameter determines the size of the text on the overlay bar. It is an integer value with a default of 40, and it can range from a minimum of 10 to a maximum of 1000. Adjusting the font size can help you achieve the desired emphasis and readability for your text.

overlay_mode

The overlay_mode parameter is a boolean that decides whether the text bar is added as an overlay or an underlay. When set to True, the text bar is placed over the image, while False places it below the image. This option provides flexibility in how the text is integrated with the image.

iTools Add Text Overlay Output Parameters:

image

The output image parameter is the modified image with the text overlay or underlay applied. This output is crucial as it represents the final product of the node's operation, ready for further processing or display. The overlay enhances the image by adding informative text in a visually appealing manner.

iTools Add Text Overlay Usage Tips:

• Experiment with different background_color values to ensure the text is legible against various image backgrounds.
• Use the font_size parameter to adjust the prominence of the text, especially if the image contains intricate details that might be obscured by larger text.
• Toggle the overlay_mode to see which positioning best suits your image's composition and the information you want to convey.

iTools Add Text Overlay Common Errors and Solutions:

Invalid position value. Use 'overlay' or 'underlay'.

• Explanation: This error occurs when an invalid value is provided for the overlay_mode parameter.
• Solution: Ensure that the overlay_mode parameter is set to either True for overlay or False for underlay.

Unknown color specifier

• Explanation: This error happens when the background_color parameter is set to an unrecognized color format.
• Solution: Use a valid hexadecimal color code for the background_color parameter, such as '#RRGGBBAA'.