ComfyUI Node: Cross Dissolve with Overlap

Cross Dissolve with Overlap:

The CrossDissolveOverlap node is designed to seamlessly blend two sequences of images by applying a cross-dissolve effect with a specified overlap in frames. This node is particularly useful for creating smooth transitions between two sets of images, such as in video editing or animation sequences. By allowing you to define the number of overlapping frames and the type of dissolve curve, it provides flexibility in achieving the desired visual effect. The node also includes features like automatic overlap adjustment, edge feathering, and aspect ratio preservation to enhance the quality of the transition. These capabilities make it a powerful tool for AI artists looking to create professional-grade visual effects without needing deep technical expertise.

Cross Dissolve with Overlap Input Parameters:

images_a

images_a is the first batch of images to be used in the cross-dissolve process. It should be a tensor representing a sequence of frames, where each frame is an image. The number of frames in this batch will influence the length of the resulting sequence after the cross-dissolve operation.

images_b

images_b is the second batch of images that will be blended with images_a. Like images_a, it should be a tensor representing a sequence of frames. The number of frames in this batch, along with the overlap frames, will determine the final output sequence length.

overlap_frames

overlap_frames specifies the number of frames over which the two image sequences will be blended. This parameter is crucial as it defines the extent of the transition between the two sequences. The minimum value is 0, and the maximum is the smaller of the two batch sizes. If the overlap is too large, it will be automatically adjusted to fit the batch sizes.

dissolve_curve

dissolve_curve determines the type of curve used for the cross-dissolve effect. Common options include "linear" for a straightforward blend and other curves for more complex transitions. The choice of curve affects the visual smoothness and style of the transition.

auto_adjust_overlap

auto_adjust_overlap is a boolean parameter that, when enabled, automatically reduces the overlap frames if they exceed the size of the smaller batch. This ensures that the cross-dissolve operation can be performed without errors due to mismatched batch sizes.

feather_edges

feather_edges is a boolean parameter that, when enabled, applies edge feathering to the images. This helps to reduce visible seams at the transition points, resulting in a smoother blend between the two sequences.

preserve_aspect

preserve_aspect is a boolean parameter that ensures the aspect ratio of the images is maintained during the resizing process. This is important for preventing distortion in the final output, especially when the input sequences have different dimensions.

blend_mode

blend_mode specifies the blending mode used during the cross-dissolve operation. The default is "normal," but other modes can be used to achieve different visual effects. The choice of blend mode can significantly impact the appearance of the transition.

Cross Dissolve with Overlap Output Parameters:

result_sequence

result_sequence is the final output of the cross-dissolve operation, consisting of a sequence of frames that smoothly transition from images_a to images_b. The length of this sequence is determined by the sum of the input batch sizes minus the overlap frames.

output_length

output_length is an integer representing the total number of frames in the result_sequence. It provides a quick reference for understanding the size of the output sequence after the cross-dissolve operation.

error_message

error_message is a string that provides information about any errors encountered during the cross-dissolve process. If an error occurs, this message will describe the issue and indicate that a fallback result has been returned.

Cross Dissolve with Overlap Usage Tips:

• Ensure that the input image batches are tensors of the same dimensions to avoid resizing issues and maintain visual consistency.
• Use the auto_adjust_overlap feature to prevent errors when the overlap frames exceed the size of the smaller batch.
• Experiment with different dissolve_curve options to achieve the desired visual effect for your specific project.
• Enable feather_edges to minimize visible seams and create a more professional-looking transition.

Cross Dissolve with Overlap Common Errors and Solutions:

Cross Dissolve with Overlap failed: <error_message>

• Explanation: This error occurs when there is an issue with the input parameters or during the cross-dissolve operation. The error message provides specific details about the problem.
• Solution: Check the input shapes and ensure they are compatible. Verify that the overlap frames do not exceed the size of the smaller batch. Use the auto_adjust_overlap feature if necessary.

Input validation failed: <error_message>

• Explanation: This error indicates that the input parameters did not pass the validation checks, possibly due to incompatible shapes or invalid overlap frames.
• Solution: Review the input parameters and ensure they meet the requirements. Adjust the overlap frames to be within the valid range and ensure the input batches are tensors.