ComfyUI Node: Animation Builder (mtb)

Animation Builder (mtb):

The Animation Builder node is designed to facilitate the creation of animations by managing frame sequences and scaling values over time. It is particularly useful for generating smooth transitions and looping animations, making it an essential tool for AI artists looking to add dynamic elements to their projects. By leveraging this node, you can easily queue a specified number of frames, apply scaling to normalized values, and manage looping behavior, all of which contribute to creating visually appealing animations. The node's primary goal is to simplify the animation process, allowing you to focus on the creative aspects rather than the technical details.

Animation Builder (mtb) Input Parameters:

total_frames

This parameter specifies the total number of frames to queue for the animation. It determines the length of the animation sequence. The minimum value is 0, and the default value is 100. Adjusting this parameter will directly impact the duration and smoothness of the animation.

scale_float

This parameter is a convenience input that scales the normalized current value, which is a float between 0 and 1 that interpolates over the current queue length. The minimum value is 0.0, and the default value is 1.0. This scaling factor allows you to control the intensity of the animation's effect.

loop_count

This parameter defines the number of loops to queue for the animation. The minimum value is 0, and the default value is 1. Increasing this value will cause the animation to repeat multiple times, creating a looping effect.

raw_iteration

This parameter represents the current iteration within the total frames. It is used internally to calculate the current frame and is typically set in the JavaScript code. The minimum value is 0, and the default value is 0.

raw_loop

This parameter indicates the current loop iteration. It is used internally to manage the looping behavior and is typically set in the JavaScript code. The minimum value is 0, and the default value is 0.

Animation Builder (mtb) Output Parameters:

frame

This output parameter represents the current frame number within the total frames. It is an integer value that ranges from 0 to `total_frames

• 1`. This value is essential for determining the current position in the animation sequence.

0-1 (scaled)

This output parameter is a float value between 0 and 1 that represents the scaled current value. It is calculated based on the scale_float parameter and the current frame. This value is useful for applying gradual changes over the animation sequence.

count

This output parameter indicates the current loop count. It is an integer value that helps track the number of completed loops in the animation.

loop_ended

This output parameter is a boolean value that indicates whether the current loop has ended. It returns True when the current frame reaches `total_frames

• 1`, signaling the end of a loop.

Animation Builder (mtb) Usage Tips:

• To create a smooth and continuous animation, ensure that the total_frames parameter is set to a sufficiently high value.
• Use the scale_float parameter to fine-tune the intensity of the animation effect, especially when working with subtle transitions.
• For looping animations, adjust the loop_count parameter to the desired number of repetitions to achieve the desired effect.

Animation Builder (mtb) Common Errors and Solutions:

Frame number out of range

• Explanation: This error occurs when the total_frames parameter is set to a value less than or equal to 0.
• Solution: Ensure that the total_frames parameter is set to a positive integer value.

Invalid scale value

• Explanation: This error occurs when the scale_float parameter is set to a negative value.
• Solution: Set the scale_float parameter to a value greater than or equal to 0.0.

Loop count not set

• Explanation: This error occurs when the loop_count parameter is not specified or set to a negative value.
• Solution: Ensure that the loop_count parameter is set to a non-negative integer value.