ComfyUI Node: CR Cycle Text (Legacy)

CR Cycle Text (Legacy):

The CR Cycle Text node is designed to sequentially cycle through a list of text strings over a series of frames in an animation. This node is particularly useful for creating dynamic text effects in animations, where different text strings need to be displayed at specific intervals. By specifying a list of text strings and configuring the cycling parameters, you can control how and when each text string appears during the animation. This node supports both simple and complex text lists, allowing for flexible and customizable text cycling. The primary goal of this node is to automate the process of changing text in animations, making it easier to create engaging and dynamic visual content.

CR Cycle Text (Legacy) Input Parameters:

mode

The mode parameter determines the cycling method used for the text strings. The available option is "Sequential", which cycles through the text strings in the order they are provided. This parameter controls how the text strings are selected and displayed during the animation.

frame_interval

The frame_interval parameter specifies the number of frames between each text change. This parameter controls the speed of the text cycling, with a lower value resulting in faster changes and a higher value resulting in slower changes. The default value is typically set to 1, but it can be adjusted based on the desired animation speed.

loops

The loops parameter defines the number of times the entire text list should be repeated during the animation. This parameter allows you to control the overall duration of the text cycling effect. The default value is 1, but it can be increased to create longer animations with repeated text sequences.

current_frame

The current_frame parameter indicates the current frame number in the animation. This parameter is used to calculate which text string should be displayed at any given frame. It is typically provided by the animation system and is essential for synchronizing the text changes with the animation timeline.

text_1, text_2, text_3, text_4, text_5

These parameters allow you to specify up to five individual text strings to be included in the text list. Each parameter represents a separate text string, and they are combined to form the complete list of text strings to be cycled through. If a parameter is left empty, it will be ignored.

text_list_simple

The text_list_simple parameter allows you to provide a pre-defined list of text strings in a simple format. This parameter can be used as an alternative to specifying individual text strings through the text_1 to text_5 parameters. If provided, the text_list_simple will be combined with the individual text strings to form the complete text list.

CR Cycle Text (Legacy) Output Parameters:

STRING

The STRING output parameter provides the current text string to be displayed based on the cycling logic. This parameter is updated at each frame according to the specified cycling parameters, ensuring that the correct text string is shown at the right time in the animation.

show_text

The show_text output parameter provides a URL to the help documentation for the CR Cycle Text node. This URL directs you to a detailed guide on how to use the node, including examples and additional information. It is a useful resource for understanding the full capabilities of the node and troubleshooting any issues.

CR Cycle Text (Legacy) Usage Tips:

• To create a smooth text cycling effect, ensure that the frame_interval is set appropriately based on the animation speed and desired text change frequency.
• Use the loops parameter to extend the duration of the text cycling effect, especially for longer animations where repeated text sequences are needed.
• Combine individual text strings and the text_list_simple parameter to create complex and varied text lists for more dynamic animations.

CR Cycle Text (Legacy) Common Errors and Solutions:

"IndexError: list index out of range"

• Explanation: This error occurs when the current_frame value exceeds the length of the text list, resulting in an invalid index.
• Solution: Ensure that the loops parameter is set correctly to repeat the text list enough times to cover the entire animation duration. Additionally, verify that the frame_interval is set appropriately to avoid skipping frames.

"TypeError: 'NoneType' object is not iterable"

• Explanation: This error occurs when the text_list_simple parameter is not provided or is set to None, and the node attempts to iterate over it.
• Solution: Ensure that the text_list_simple parameter is either provided with a valid list of text strings or left empty. If using individual text strings, make sure at least one of the text_1 to text_5 parameters is filled.

"ValueError: invalid literal for int() with base 10"

• Explanation: This error occurs when a non-integer value is provided for the frame_interval or loops parameters.
• Solution: Verify that the frame_interval and loops parameters are set to valid integer values. Ensure that no non-numeric characters are included in these parameters.