ComfyUI Node: 📈 Beat Curve

Beat Curve [Dream]:

The Beat Curve [Dream] node is designed to generate animation curves that follow a rhythmic pattern based on musical beats per minute (BPM). This node is particularly useful for creating animations that sync with music or other rhythmic elements, providing a dynamic and visually appealing effect. By adjusting various parameters, you can control the intensity, timing, and shape of the curve, allowing for a high degree of customization. The node calculates the curve values based on the current frame, BPM, and other user-defined settings, making it a powerful tool for creating beat-synchronized animations.

Beat Curve [Dream] Input Parameters:

bpm

This parameter sets the beats per minute (BPM) for the curve. It determines the speed of the rhythm, with higher values resulting in faster beats. The default value is 100.0.

time_offset

This parameter allows you to offset the start time of the curve in seconds. It is useful for synchronizing the curve with other elements in your animation. The default value is 0.0.

measure_length

This parameter defines the number of beats in one measure. It controls the length of the rhythmic cycle. The default value is 4, with a minimum value of 1.

low_value

This parameter sets the minimum value of the curve. It defines the lowest point the curve can reach. The default value is 0.0.

high_value

This parameter sets the maximum value of the curve. It defines the highest point the curve can reach. The default value is 1.0.

invert

This parameter allows you to invert the curve values. If set to "yes," the curve values will be inverted. The available options are "no" and "yes."

power

This parameter controls the power of the curve, affecting its shape. Higher values result in a steeper curve. The default value is 2.0, with a minimum value of 0.25 and a maximum value of 4.

accent_1

This parameter sets the position of the first accent in the measure. Accents are emphasized beats that stand out in the rhythm. The default value is 1, with a minimum value of 1 and a maximum value of 24.

accent_2

This optional parameter sets the position of the second accent in the measure. The default value is 3, with a minimum value of 1 and a maximum value of 24.

accent_3

This optional parameter sets the position of the third accent in the measure. The default value is 0.

accent_4

This optional parameter sets the position of the fourth accent in the measure. The default value is 0.

Beat Curve [Dream] Output Parameters:

FLOAT

This output parameter provides the calculated curve value as a floating-point number. It represents the current value of the curve based on the input parameters and the current frame.

INT

This output parameter provides the calculated curve value as an integer. It is a rounded version of the FLOAT output, useful for scenarios where an integer value is required.

Beat Curve [Dream] Usage Tips:

• To create a smooth and visually appealing animation, experiment with different BPM values to match the tempo of your music or other rhythmic elements.
• Use the time_offset parameter to synchronize the curve with other elements in your animation, ensuring a cohesive visual experience.
• Adjust the power parameter to control the steepness of the curve, allowing for more dramatic or subtle effects depending on your needs.
• Utilize the accent parameters to emphasize specific beats in the measure, adding dynamic variations to your animation.

Beat Curve [Dream] Common Errors and Solutions:

Invalid BPM value

• Explanation: The BPM value provided is not a valid floating-point number.
• Solution: Ensure that the BPM value is a valid floating-point number and within a reasonable range for your animation.

Invalid measure_length value

• Explanation: The measure_length value is outside the allowed range.
• Solution: Ensure that the measure_length value is an integer greater than or equal to 1.

Invalid accent position

• Explanation: One or more accent positions are outside the allowed range.
• Solution: Ensure that all accent positions are integers within the range of 1 to 24 and appropriate for the measure length.

File not found for time_offset

• Explanation: The time_offset value is not a valid floating-point number.
• Solution: Ensure that the time_offset value is a valid floating-point number and within a reasonable range for your animation.