ComfyUI Node: 📈 Sine Curve

Sine Curve [Dream]:

The Sine Curve [Dream] node is designed to generate a smooth, oscillating sine wave that can be used in various animation and artistic projects. This node is particularly useful for creating rhythmic and periodic movements or effects, such as simulating natural phenomena like waves or oscillations. By leveraging the mathematical properties of the sine function, this node provides a continuous and smooth transition between values, making it ideal for animations that require fluid and natural motion. The main goal of the Sine Curve [Dream] node is to offer a versatile and easy-to-use tool for generating sine wave patterns, which can be customized through various input parameters to fit specific artistic needs.

Sine Curve [Dream] Input Parameters:

max_value

The max_value parameter defines the upper limit of the sine wave. This value determines the highest point that the sine wave will reach during its oscillation. The default value is 1.0, and it can be adjusted to any floating-point number to scale the amplitude of the wave. Increasing the max_value will make the peaks of the wave higher, while decreasing it will lower the peaks.

min_value

The min_value parameter sets the lower limit of the sine wave. This value determines the lowest point that the sine wave will reach during its oscillation. The default value is 0.0, and it can be adjusted to any floating-point number to scale the amplitude of the wave. Lowering the min_value will make the troughs of the wave deeper, while increasing it will raise the troughs.

periodicity_seconds

The periodicity_seconds parameter controls the period of the sine wave, which is the time it takes for the wave to complete one full cycle. The default value is 10.0 seconds, and it can be adjusted to any floating-point number greater than 0.01. A smaller value will result in a faster oscillation, while a larger value will slow down the oscillation.

phase

The phase parameter adjusts the horizontal shift of the sine wave. This value determines the starting point of the wave within its cycle. The default value is 0.0, and it can range from -1 to 1. Adjusting the phase can be useful for synchronizing the sine wave with other elements in your animation or for creating offset effects.

Sine Curve [Dream] Output Parameters:

FLOAT

The FLOAT output parameter represents the current value of the sine wave at a given point in time. This value is a floating-point number that oscillates smoothly between the min_value and max_value based on the specified periodicity_seconds and phase. This output can be used to drive various properties in your animation, such as position, opacity, or scale.

INT

The INT output parameter is the integer representation of the current value of the sine wave. This value is derived by rounding the FLOAT output to the nearest integer. It can be useful for scenarios where discrete values are needed, such as triggering events or controlling step-based animations.

Sine Curve [Dream] Usage Tips:

• To create a smooth and natural oscillation, ensure that the periodicity_seconds is set to a value that matches the desired speed of your animation.
• Use the phase parameter to synchronize the sine wave with other elements in your project, creating harmonious and coordinated movements.
• Experiment with different max_value and min_value settings to achieve the desired amplitude and range for your sine wave.

Sine Curve [Dream] Common Errors and Solutions:

"Invalid periodicity_seconds value"

• Explanation: The periodicity_seconds parameter must be greater than 0.01 to ensure a valid sine wave period.
• Solution: Ensure that the periodicity_seconds value is set to a number greater than 0.01.

"Invalid phase value"

• Explanation: The phase parameter must be within the range of -1 to 1. - Solution: Adjust the phase value to be within the valid range of -1 to 1.

"Invalid max_value or min_value"

• Explanation: The max_value and min_value parameters must be valid floating-point numbers.
• Solution: Ensure that both max_value and min_value are set to valid floating-point numbers and are not left empty or set to non-numeric values.