ComfyUI Node: Keyframe Scheduler

Keyframe Scheduler:

The SaltKeyframeScheduler is a powerful node designed to generate and manage keyframe schedules for various animation and motion graphics tasks. This node allows you to create smooth transitions and animations by interpolating between keyframes using different easing functions. By leveraging the SaltKeyframeScheduler, you can achieve precise control over the timing and progression of your animations, making it an essential tool for AI artists looking to add dynamic motion to their projects. The node's primary function is to take a list of keyframes and apply an easing mode to generate a detailed schedule that can be used for iterative execution in animations. This capability is particularly useful for creating complex animations with varying speeds and smooth transitions, enhancing the overall visual appeal of your work.

Keyframe Scheduler Input Parameters:

keyframe_schedule

This parameter accepts a string that represents the keyframe schedule. The keyframe schedule is a list of keyframes that define the values at specific points in time. This input is crucial as it forms the basis of the schedule that will be generated. The keyframe schedule should be formatted correctly to ensure accurate results.

easing_mode

This parameter allows you to select the easing function to be applied to the keyframe schedule. Easing functions control the rate of change of the animation, providing various effects such as ease-in, ease-out, and ease-in-out. The available options include a list of predefined easing functions, with "None" as the default option if no easing is desired.

end_frame

This optional parameter specifies the frame at which the schedule should end. It accepts an integer value with a minimum of 0. If not provided, the schedule will continue until the last keyframe. This parameter helps in defining the duration of the animation.

ndigits

This optional parameter determines the number of decimal places to round the generated schedule values. It accepts an integer value between 1 and 12, with a default value of 5. This parameter is useful for controlling the precision of the schedule values.

a, b, c, d, e, f, g, h

These optional parameters allow you to pass custom variables that can be used within the keyframe schedule. Each parameter can accept a variety of data types, including int, float, boolean, or list. These variables provide additional flexibility and customization options for your keyframe schedules.

Keyframe Scheduler Output Parameters:

schedule_list

The output of the SaltKeyframeScheduler is a list that represents the generated schedule. This list contains the interpolated values between the keyframes, adjusted according to the selected easing mode. The schedule list is essential for driving animations and ensuring smooth transitions between keyframes. It provides a detailed and precise sequence of values that can be used for iterative execution in various animation tasks.

Keyframe Scheduler Usage Tips:

• Ensure your keyframe schedule is correctly formatted to avoid errors and achieve accurate results.
• Experiment with different easing modes to find the one that best suits your animation needs.
• Use the end_frame parameter to control the duration of your animation and ensure it aligns with your project's timeline.
• Adjust the ndigits parameter to balance between precision and performance, especially for complex animations.
• Utilize the custom variables (a, b, c, etc.) to add more flexibility and control to your keyframe schedules.

Keyframe Scheduler Common Errors and Solutions:

ValueError: 'a' is not a valid int, float, boolean, or schedule_list

• Explanation: This error occurs when the parameter a is provided with an invalid data type.
• Solution: Ensure that a is an int, float, boolean, or list. Double-check the data type before passing it to the node.

ValueError: 'b' is not a valid int, float, boolean, or schedule_list

• Explanation: This error occurs when the parameter b is provided with an invalid data type.
• Solution: Ensure that b is an int, float, boolean, or list. Double-check the data type before passing it to the node.

Invalid keyframe schedule format

• Explanation: This error occurs when the keyframe schedule string is not correctly formatted.
• Solution: Verify the format of your keyframe schedule string and ensure it follows the required structure.

Easing function not recognized

• Explanation: This error occurs when an unrecognized easing function is selected.
• Solution: Choose an easing function from the provided list of options. If you are unsure, start with "None" and experiment with other functions.

End frame must be a non-negative integer

• Explanation: This error occurs when the end_frame parameter is set to a negative value.
• Solution: Ensure that the end_frame parameter is a non-negative integer. Adjust the value accordingly.