ComfyUI Node: Textbox

Textbox:

The Textbox node is designed to handle and manipulate text input within your AI art projects. It allows you to input text strings, which can be either single-line or multi-line, and provides options to control how the text is processed and displayed. This node is particularly useful for scenarios where you need to input or modify text dynamically, offering flexibility with its passthrough feature. The main goal of the Textbox node is to facilitate text handling in a user-friendly manner, making it easier for you to integrate text into your creative workflows.

Textbox Input Parameters:

text

This parameter accepts a string input, which can be either single-line or multi-line. It is the primary text that you want to input or manipulate. The default value is an empty string. The multiline option allows you to input text that spans multiple lines, making it suitable for longer text entries. The forceInput option, when set to False, means that this input is not mandatory. The print_to_screen option, when set to True, will display the text on the screen.

passthrough

This optional parameter also accepts a string input, which can be either single-line or multi-line. It is used to override the primary text input if provided. The default value is an empty string. The multiline option allows for multi-line text input, and the forceInput option, when set to True, makes this input mandatory if used.

Textbox Output Parameters:

text

This output parameter returns the processed text string. If the passthrough parameter is provided and not empty, it will override the primary text input and be returned as the output. Otherwise, the primary text input is returned. This output is crucial for further text processing or display in your AI art projects.

Textbox Usage Tips:

• Use the multiline option for the text parameter when you need to input longer text entries that span multiple lines.
• Utilize the passthrough parameter to dynamically override the primary text input, which can be useful for testing or conditional text changes.
• Enable the print_to_screen option to visualize the text input directly on the screen, aiding in debugging and ensuring the correct text is being processed.

Textbox Common Errors and Solutions:

"Text input is required"

• Explanation: This error occurs when the text parameter is left empty, and no passthrough value is provided.
• Solution: Ensure that either the text or passthrough parameter is filled with the desired text input.

"Passthrough input is required"

• Explanation: This error occurs when the passthrough parameter is set to mandatory (forceInput is True) but is left empty.
• Solution: Provide a valid string input for the passthrough parameter or set forceInput to False if the passthrough input is not necessary.

"Invalid text format"

• Explanation: This error occurs when the text input does not meet the expected format, such as containing unsupported characters.
• Solution: Check the text input for any unsupported characters or formatting issues and correct them before inputting the text.