ComfyUI Node: Batch Slowdown

Batch Slowdown:

The BatchSlowdown node is designed to manipulate the playback speed of a batch of data, such as images, masks, or latent representations, by duplicating frames to achieve a slower playback effect. This node is particularly useful for AI artists who want to create slow-motion effects in their animations or video sequences. By adjusting the playback speed, you can enhance the visual storytelling of your projects, allowing for more dramatic or detailed presentations. The node provides flexibility in how the slowdown is applied, offering different modes and distribution methods to tailor the effect to your specific needs. Whether you're working with images, masks, or latent data, BatchSlowdown helps you achieve the desired temporal effect with ease.

Batch Slowdown Input Parameters:

data_type

This parameter specifies the type of data you are processing, such as IMAGE, MASK, or LATENT. It determines how the node will handle the input data and apply the slowdown effect. The default value is IMAGE.

mode

The mode parameter defines how the slowdown amount is specified. It can be set to different modes, such as multiplier, which affects how the frames are duplicated to achieve the slowdown effect. The default mode is multiplier.

distribution

This parameter controls how extra frames are distributed when using decimal multipliers. It affects the smoothness and consistency of the slowdown effect across the sequence. The default distribution method is spread.

images

This optional parameter is a batch of images to be slowed down. It is represented as a tensor and is only required if you are processing image data.

mask

This optional parameter is a batch of masks to be slowed down. It is represented as a tensor and is only required if you are processing mask data.

latent

This optional parameter is a batch of latent representations to be slowed down. It is a dictionary and is only required if you are processing latent data.

multiplier

The slowdown multiplier determines how much slower the output will be compared to the input. A value of 2.0 means the output will be twice as slow, while 0.5 means it will be twice as fast. The default value is 2.0, with a range from 0.1 to 10.0.

target_frames

This parameter specifies the target number of frames for the output sequence. It allows you to control the length of the slowed-down sequence. The default value is 60, with a range from 1 to 10000.

source_fps

The source frames per second (FPS) is the frame rate of the input video or sequence. It is used in fps_convert mode to calculate the slowdown effect. The default value is 24.0, with a range from 1.0 to 240.0.

target_fps

The target frames per second (FPS) is the desired frame rate for the output video or sequence. It is used in fps_convert mode to achieve the desired slowdown effect. The default value is 60.0, with a range from 1.0 to 240.0.

enable_speedup

This boolean parameter allows you to enable or disable the speedup feature. When enabled, it allows for faster playback instead of slowdown. The default value is False.

Batch Slowdown Output Parameters:

out_images

This output parameter contains the slowed-down batch of images, with frames duplicated according to the specified slowdown settings. It provides the final visual output for image data.

out_mask

This output parameter contains the slowed-down batch of masks, with frames duplicated according to the specified slowdown settings. It provides the final visual output for mask data.

out_latent

This output parameter contains the slowed-down batch of latent representations, processed according to the specified slowdown settings. It provides the final output for latent data.

info

This output parameter provides detailed information about the slowdown process, including the data type, mode, distribution, original and new frame counts, effective multiplier, and whether speedup was applied. It helps you understand the changes made to the input data.

Batch Slowdown Usage Tips:

• Experiment with different multiplier values to achieve the desired slowdown effect, keeping in mind that higher values result in slower playback.
• Use the distribution parameter to control how frames are spread across the sequence, which can affect the smoothness of the slowdown effect.
• Adjust the target_frames parameter to control the length of the output sequence, ensuring it fits your project's requirements.
• Consider enabling enable_speedup if you want to create faster playback effects instead of slowing down the sequence.

Batch Slowdown Common Errors and Solutions:

"Invalid data type"

• Explanation: This error occurs when an unsupported data type is provided to the node.
• Solution: Ensure that the data_type parameter is set to one of the supported types: IMAGE, MASK, or LATENT.

"Multiplier out of range"

• Explanation: This error indicates that the multiplier value is outside the allowed range.
• Solution: Adjust the multiplier value to be within the range of 0.1 to 10.0.

"Target frames not achievable"

• Explanation: This error occurs when the specified target_frames cannot be achieved with the given settings.
• Solution: Re-evaluate the multiplier, source_fps, and target_fps settings to ensure they align with the desired target_frames.