ComfyUI Node: GR Onomatopoeia

GR Onomatopoeia:

The GR Onomatopoeia node is designed to add dynamic and expressive text overlays to your images, simulating the sound effects often seen in comic books. This node allows you to overlay text such as "BANG," "BOOM," "CRASH," and many other onomatopoeic words onto your images, enhancing their visual impact and storytelling potential. It offers a variety of customization options, including text randomization, font selection, color choices, and alignment settings, making it a versatile tool for creating engaging and visually appealing artwork. By leveraging this node, you can easily add a layer of excitement and emotion to your images, making them more captivating and lively.

GR Onomatopoeia Input Parameters:

text

This parameter allows you to specify the text to be overlaid on the image. If left empty, the node will randomly select an onomatopoeic word from its predefined list. The default value is "Hello."

randomize

This boolean parameter determines whether the text should be randomized. When set to true, the characters in the specified text will be shuffled. The default value is false.

font

This parameter allows you to choose the font for the text overlay. The available fonts are populated from the system's font directories. If no fonts are found, "arial.ttf" is used as the default.

font_size

This integer parameter sets the size of the font. It ranges from a minimum of 1 to a maximum of 256, with a default value of 100.

vertical_alignment

This parameter specifies the vertical alignment of the text. The options are "top," "middle," and "bottom," with "middle" as the default.

horizontal_alignment

This parameter specifies the horizontal alignment of the text. The options are "left," "center," and "right," with "center" as the default.

justification

This parameter determines the justification of the text. The options are "left," "center," and "right," with "left" as the default.

padding

This integer parameter sets the padding around the text. It ranges from a minimum of 0 to a maximum of 128, with a default value of 0.

stroke_thickness

This integer parameter defines the thickness of the text stroke. It ranges from a minimum of 0 to a maximum of 10, with a default value of 5.

stroke_colour

This parameter allows you to select the color of the text stroke from a list of available colors. The default value is "red."

fill_colour

This parameter allows you to select the fill color of the text from a list of available colors. The default value is "purple."

bubble

This integer parameter sets the size of the speech bubble around the text. It ranges from a minimum of 0 to a maximum of 50, with a default value of 5.

bubble_distance

This integer parameter defines the distance of the speech bubble from the text. It ranges from a minimum of 0 to a maximum of 500, with a default value of 100.

bubble_colour

This parameter allows you to select the color of the speech bubble from a list of available colors. The default value is "maroon."

bubble_stroke_thickness

This integer parameter sets the thickness of the speech bubble stroke. It ranges from a minimum of 0 to a maximum of 20, with a default value of 10.

bubble_fill

This boolean parameter determines whether the speech bubble should be filled with color. The default value is true.

GR Onomatopoeia Output Parameters:

image_tensor_out

This output parameter provides the image tensor with the text overlay applied. It is a tensor representation of the image, normalized to a range of 0 to 1.

mask_tensor_out

This output parameter provides the mask tensor corresponding to the text overlay. It is a tensor representation of the mask, normalized to a range of 0 to 1.

GR Onomatopoeia Usage Tips:

• Experiment with different fonts and font sizes to achieve the desired visual effect for your text overlays.
• Use the randomize parameter to create unique and dynamic text arrangements, adding an element of surprise to your artwork.
• Adjust the padding and alignment settings to position the text precisely where you want it on the image.
• Utilize the bubble and bubble_distance parameters to create comic-style speech bubbles around your text, enhancing the storytelling aspect of your images.

GR Onomatopoeia Common Errors and Solutions:

"Font not found"

• Explanation: The specified font is not available in the system's font directories.
• Solution: Ensure that the font file is present in one of the system's font directories or select a different available font.

"Invalid color selection"

• Explanation: The specified color is not available in the list of predefined colors.
• Solution: Choose a color from the available list of colors provided by the node.

"Text exceeds image boundaries"

• Explanation: The text size or padding causes the text to extend beyond the image boundaries.
• Solution: Reduce the font size, padding, or adjust the alignment settings to fit the text within the image boundaries.