ComfyUI Node: Batch Merge (mtb)

Batch Merge (mtb):

The Batch Merge (mtb) node is designed to combine multiple image batches that may have different frame counts into a single cohesive batch. This node is particularly useful for AI artists who work with animations or sequences of images, as it ensures that all image batches are synchronized to the same frame count before merging. By adjusting the frame counts through either head or tail filling, the node ensures consistency across batches. The merging process can be customized using different fusion modes such as addition, multiplication, or averaging, allowing for creative flexibility in how the final merged image is produced. This node simplifies the process of batch merging, making it accessible even to those without a deep technical background.

Batch Merge (mtb) Input Parameters:

fusion_mode

The fusion_mode parameter determines how the images in the batches will be combined. It offers three options: "add", "multiply", and "average". The "add" mode sums the pixel values of corresponding frames, the "multiply" mode multiplies the pixel values, and the "average" mode calculates the average of the pixel values. The default value is "average". This parameter significantly impacts the visual outcome of the merged image, with each mode providing a different blending effect.

fill

The fill parameter specifies how to handle batches with fewer frames than the maximum frame count. It has two options: "head" and "tail". If "head" is selected, the first frame of the shorter batch is repeated to match the frame count. If "tail" is selected, the last frame is repeated. The default value is "tail". This parameter ensures that all batches are aligned in terms of frame count before merging, which is crucial for maintaining the integrity of the animation or sequence.

Batch Merge (mtb) Output Parameters:

IMAGE

The output parameter IMAGE represents the final merged image batch. This batch has a consistent frame count across all images, achieved by filling and merging according to the specified parameters. The resulting image batch can be used in further processing or as a final output, providing a seamless and cohesive visual sequence.

Batch Merge (mtb) Usage Tips:

• To achieve a smooth blending effect, use the "average" fusion mode, which evenly combines the pixel values of corresponding frames.
• When working with animations where the beginning frames are more critical, use the "head" fill option to ensure the initial frames are preserved and repeated as needed.
• For more dynamic and high-contrast results, experiment with the "add" or "multiply" fusion modes, which can create unique visual effects by combining pixel values in different ways.

Batch Merge (mtb) Common Errors and Solutions:

"Input batches have incompatible dimensions"

• Explanation: This error occurs when the input image batches have different dimensions (height, width, or channels).
• Solution: Ensure that all input batches have the same dimensions before merging. You may need to resize or crop the images to match.

"Invalid fusion mode selected"

• Explanation: This error happens when an unsupported fusion mode is specified.
• Solution: Check the fusion_mode parameter and ensure it is set to one of the supported options: "add", "multiply", or "average".

"Invalid fill option selected"

• Explanation: This error occurs when an unsupported fill option is specified.
• Solution: Verify that the fill parameter is set to either "head" or "tail".