ComfyUI Node: ASCII | GlitchNodes

ASCII | GlitchNodes:

The ASCII node is designed to transform images into captivating ASCII art, offering a unique blend of digital artistry and text-based creativity. This node allows you to convert any image into a representation composed of ASCII characters, providing a nostalgic and artistic effect reminiscent of early computer graphics. The node is highly customizable, enabling you to adjust font colors, character sets, and background effects to achieve the desired aesthetic. By leveraging gradient text coloring and optional background enhancements, the ASCII node provides a versatile tool for artists looking to explore the intersection of visual and textual art forms. Its primary goal is to offer a creative outlet for generating visually striking ASCII art, making it an essential tool for artists interested in glitch art and text-based imagery.

ASCII | GlitchNodes Input Parameters:

IMAGE

This parameter accepts the input image that you wish to convert into ASCII art. The image should be in a format compatible with the node, such as a tensor or a PIL image.

background

Defines the background color of the ASCII art. It accepts a string representing a color in hexadecimal format, with a default value of #080c37. This color serves as the canvas on which the ASCII characters are drawn.

bgGradient

A boolean parameter that determines whether a gradient effect is applied to the background. The default value is False. Enabling this option can add depth and visual interest to the ASCII art.

bgSaturation

Controls the saturation level of the background when a gradient is applied. It accepts an integer value ranging from 0 to 100, with a default of 60. Higher values result in more vibrant background colors.

fontColor

Specifies the primary font color for the ASCII characters. This is a string in hexadecimal format, with a default value of #c7205b. It defines the base color for the text in the ASCII art.

fontColor2

Defines the secondary font color used for gradient effects on the ASCII characters. Like fontColor, it is a hexadecimal string, with a default value of #00ff61. This color is blended with the primary font color to create a gradient effect.

fontSizeFactor

A float parameter that adjusts the size of the ASCII characters relative to the image resolution. It ranges from 0.1 to 10.0, with a default value of 3.0. Larger values increase the size of the characters, affecting the overall detail and readability of the ASCII art.

resolution

Determines the resolution of the ASCII art by specifying the number of characters per row. It accepts an integer value with a minimum of 1 and a default of 137. Higher resolutions result in more detailed ASCII art but may reduce character size.

threshold

Sets the luminance threshold for character rendering. It accepts an integer between 0 and 255, with a default of 0. Pixels with luminance below this threshold are not rendered, allowing for selective detail emphasis.

invert

A boolean parameter that inverts the luminance values of the image. The default value is True. Inverting the image can create a negative effect, altering the visual impact of the ASCII art.

randomness

Controls the randomness in character selection for the ASCII art. It accepts an integer from 0 to 100, with a default of 15. Higher values introduce more randomness, resulting in a more chaotic and abstract appearance.

textType

Specifies the type of text used for the ASCII characters. It offers two options: Random Text and Input Text. This choice affects the character set used in the ASCII art.

textInput

A string parameter that provides custom text input when textType is set to Input Text. The default value is pxlpshr. This text is used as the character set for rendering the ASCII art.

ASCII | GlitchNodes Output Parameters:

IMAGE

The output is an image rendered as ASCII art. This image retains the artistic qualities of the original while transforming it into a text-based representation. The output can be used for creative projects, digital art displays, or as a unique visual element in multimedia works.

ASCII | GlitchNodes Usage Tips:

• Experiment with different fontColor and fontColor2 combinations to create visually appealing gradients that enhance the depth of your ASCII art.
• Adjust the resolution parameter to balance detail and readability. Higher resolutions provide more detail but may require larger font sizes for clarity.
• Use the randomness parameter to introduce variability in character selection, adding an abstract and dynamic quality to your ASCII art.
• Consider enabling bgGradient for a more visually engaging background that complements the ASCII characters.

ASCII | GlitchNodes Common Errors and Solutions:

"Invalid image format"

• Explanation: The input image is not in a compatible format for conversion to ASCII art.
• Solution: Ensure the input image is a tensor or a PIL image. Convert other formats to a compatible type before using the node.

"Font size factor out of range"

• Explanation: The fontSizeFactor parameter is set outside the allowed range.
• Solution: Adjust the fontSizeFactor to be within the range of 0.1 to 10.0 to ensure proper character sizing.

"Resolution too low"

• Explanation: The resolution parameter is set too low, resulting in insufficient detail.
• Solution: Increase the resolution value to enhance the detail and clarity of the ASCII art.