ComfyUI Node: Text Loader

Text Loader:

The Zuellni Text Loader is a versatile node designed to handle and manipulate text data within the ComfyUI framework. This node is particularly useful for AI artists who need to format, print, or conditionally process text inputs in their workflows. By providing a range of text operations, the Zuellni Text Loader helps streamline text handling tasks, making it easier to integrate textual elements into your AI art projects. Whether you need to replace variables within a text string, print formatted messages, or perform conditional checks, this node offers a comprehensive set of tools to enhance your text processing capabilities.

Text Loader Input Parameters:

text

This parameter accepts a string input that can be multiline. It serves as the main text body that will be processed by the node. The default value is an empty string. This parameter is essential for any text manipulation tasks you wish to perform.

var_1

This optional parameter accepts a string input and is used as a variable that can be replaced within the main text. The default value is an empty string. It allows for dynamic text manipulation by substituting this variable with a specific value.

var_2

Similar to var_1, this optional parameter accepts a string input and is used as another variable for text replacement. The default value is an empty string. It provides additional flexibility for more complex text manipulations.

var_3

This optional parameter accepts a string input and serves as an additional variable for text replacement. The default value is an empty string. It is useful for scenarios where multiple text substitutions are required.

var_4

This optional parameter accepts a string input and is used as yet another variable for text replacement. The default value is an empty string. It allows for even more complex text manipulations by providing another layer of substitution.

var_5

This optional parameter accepts a string input and serves as an additional variable for text replacement. The default value is an empty string. It is useful for scenarios where multiple text substitutions are required.

prefix

This parameter accepts a string input and is used as a prefix for the text when printing. The default value is an empty string. It helps in categorizing or labeling the printed text for better readability.

condition

This parameter accepts a string input that specifies the condition to be checked. It can be one of the following: ==, !=, <, <=, >, >=, contains, starts with, ends with. This parameter is crucial for conditional text processing.

interrupt

This parameter accepts a boolean value and determines whether the process should be interrupted if the condition is not met. It is useful for controlling the flow of text processing based on specific conditions.

images

This optional parameter accepts a list of images and is used in conjunction with conditional processing. It allows for the inclusion of images in the output if the specified condition is met.

latents

This optional parameter accepts a list of latent variables and is used in conjunction with conditional processing. It allows for the inclusion of latent variables in the output if the specified condition is met.

masks

This optional parameter accepts a list of masks and is used in conjunction with conditional processing. It allows for the inclusion of masks in the output if the specified condition is met.

Text Loader Output Parameters:

STRING

This output parameter returns the processed text as a string. It reflects the modifications made based on the input parameters, such as variable replacements or conditional checks. This output is essential for further text-based operations in your workflow.

None

This output parameter is used when the node is configured to print text. It does not return any value but performs the action of printing the formatted text to the console. This is useful for debugging or logging purposes.

true/false

This output parameter returns a string indicating whether the specified condition was met (true) or not (false). It is useful for controlling the flow of subsequent nodes based on conditional checks.

Text Loader Usage Tips:

• Use the text parameter to input the main body of text you wish to manipulate. This is the foundation for all text operations within the node.
• Utilize the var_1 to var_5 parameters for dynamic text replacements. This allows you to create flexible and reusable text templates.
• Leverage the condition and interrupt parameters to control the flow of text processing based on specific conditions. This is particularly useful for conditional logic in your workflows.
• Use the prefix parameter to categorize or label printed text, making it easier to identify different types of messages in the console.

Text Loader Common Errors and Solutions:

Invalid condition specified

• Explanation: The condition parameter contains an invalid value that is not recognized by the node.
• Solution: Ensure that the condition parameter is set to one of the following valid values: ==, !=, <, <=, >, >=, contains, starts with, ends with.

Variable replacement not working

• Explanation: The text does not contain the specified variable(s) for replacement.
• Solution: Check that the text includes the exact variable names (e.g., var_1, var_2) and that the variables are correctly defined in the input parameters.

Process interrupted unexpectedly

• Explanation: The interrupt parameter is set to true, causing the process to stop when the condition is not met.
• Solution: Review the condition and interrupt parameters to ensure they are set correctly for your intended workflow. Adjust the interrupt parameter if necessary.

Text not printed

• Explanation: The node is configured to print text, but the prefix or text parameters are empty.
• Solution: Ensure that both the prefix and text parameters are correctly set with the desired values before executing the node.