ComfyUI Node: Scheduled Shape Transform

Scheduled Shape Transform:

The SaltScheduledShapeTransformation node is designed to facilitate the dynamic transformation of shapes within an image over a scheduled period. This node allows you to animate various properties of a shape, such as its size, position, and rotation, according to predefined schedules. By leveraging this node, you can create complex animations and visual effects that evolve smoothly over time, enhancing the visual appeal and dynamism of your projects. The primary goal of this node is to provide a flexible and powerful tool for animating shapes in a controlled and predictable manner, making it an essential component for AI artists looking to add motion and transformation to their visual creations.

Scheduled Shape Transform Input Parameters:

max_frames

This parameter defines the total number of frames over which the transformation will occur. It determines the duration of the animation, with higher values resulting in longer animations. The minimum value is 1, and there is no explicit maximum value, but it should be set according to the desired length of the animation.

image_width

Specifies the width of the image in which the shape transformation will take place. This parameter is crucial for positioning and scaling the shape correctly within the image. The value should be a positive integer representing the width in pixels.

image_height

Specifies the height of the image in which the shape transformation will take place. Similar to image_width, this parameter ensures the shape is correctly positioned and scaled within the image. The value should be a positive integer representing the height in pixels.

initial_width

Defines the initial width of the shape before any transformation is applied. This parameter sets the starting point for the width schedule. The value should be a positive integer representing the width in pixels.

initial_height

Defines the initial height of the shape before any transformation is applied. This parameter sets the starting point for the height schedule. The value should be a positive integer representing the height in pixels.

initial_x_coord

Specifies the initial x-coordinate of the shape's position within the image. This parameter sets the starting point for the x-coordinate schedule. The value should be a positive integer representing the x-coordinate in pixels.

initial_y_coord

Specifies the initial y-coordinate of the shape's position within the image. This parameter sets the starting point for the y-coordinate schedule. The value should be a positive integer representing the y-coordinate in pixels.

initial_rotation

Defines the initial rotation angle of the shape before any transformation is applied. This parameter sets the starting point for the rotation schedule. The value should be a float representing the rotation angle in degrees.

shape_mode

Determines the mode or type of shape to be transformed. This parameter allows you to select from different shape types, such as rectangles, circles, or custom shapes. The exact options available depend on the implementation.

shape

An optional parameter that allows you to specify a custom shape for transformation. If provided, this shape will be used instead of the default shapes defined by shape_mode. The value should be a shape object or definition compatible with the node.

width_schedule

A list of float values representing the schedule for the shape's width transformation over time. Each value in the list corresponds to a frame, defining the width of the shape at that frame. The default value is [1.0], indicating no change in width.

height_schedule

A list of float values representing the schedule for the shape's height transformation over time. Each value in the list corresponds to a frame, defining the height of the shape at that frame. The default value is [1.0], indicating no change in height.

x_schedule

A list of float values representing the schedule for the shape's x-coordinate transformation over time. Each value in the list corresponds to a frame, defining the x-coordinate of the shape at that frame. The default value is [1.0], indicating no change in x-coordinate.

y_schedule

A list of float values representing the schedule for the shape's y-coordinate transformation over time. Each value in the list corresponds to a frame, defining the y-coordinate of the shape at that frame. The default value is [1.0], indicating no change in y-coordinate.

rotation_schedule

A list of float values representing the schedule for the shape's rotation transformation over time. Each value in the list corresponds to a frame, defining the rotation angle of the shape at that frame. The default value is [1.0], indicating no change in rotation.

Scheduled Shape Transform Output Parameters:

transformed_shape

The output parameter transformed_shape represents the shape after applying the scheduled transformations. This parameter provides the final state of the shape at each frame, including its size, position, and rotation. The output is typically used to render the animated shape within the image, allowing you to visualize the transformation over time.

Scheduled Shape Transform Usage Tips:

• To create smooth animations, ensure that the schedules for width, height, x-coordinate, y-coordinate, and rotation are well-defined and consistent across frames.
• Experiment with different shape_mode options to achieve various visual effects and transformations.
• Use the max_frames parameter to control the duration of the animation, adjusting it according to the desired length of the visual effect.

Scheduled Shape Transform Common Errors and Solutions:

"Invalid shape mode"

• Explanation: The shape_mode parameter is set to an unsupported or undefined value.
• Solution: Verify that the shape_mode parameter is set to a valid option as defined by the node's implementation.

"Schedule length mismatch"

• Explanation: The length of one or more schedule lists (e.g., width_schedule, height_schedule) does not match the max_frames value.
• Solution: Ensure that all schedule lists have the same number of elements as the max_frames parameter.

"Negative dimension value"

• Explanation: One of the initial dimensions (width or height) or a scheduled dimension value is negative.
• Solution: Check that all dimension values are positive integers and adjust any negative values accordingly.