ComfyUI Node: Match Dimensions (mtb)

Match Dimensions (mtb):

The Match Dimensions (mtb) node is designed to align the dimensions of one image to match those of another, while preserving the original aspect ratio. This is particularly useful when you need to ensure consistency in image sizes for various applications, such as creating uniform datasets or preparing images for further processing. By matching dimensions, you can avoid distortions and maintain the visual integrity of your images. The node offers flexibility by allowing you to choose whether to match the height or the width of the source image to the reference image, making it a versatile tool for image manipulation tasks.

Match Dimensions (mtb) Input Parameters:

source

The source parameter is the image whose dimensions you want to adjust. This image will be resized to match the dimensions of the reference image, either in height or width, depending on the setting of the match parameter. The source image should be provided in a compatible image format.

reference

The reference parameter is the image whose dimensions will be used as the reference for resizing the source image. The dimensions of this image will guide the resizing process to ensure that the source image matches either the height or the width of the reference image, as specified by the match parameter.

match

The match parameter determines which dimension of the source image will be adjusted to match the reference image. It accepts two options: height and width. If set to height, the source image's height will be adjusted to match the reference image's height, and the width will be scaled proportionally to maintain the aspect ratio. Conversely, if set to width, the source image's width will be adjusted to match the reference image's width, and the height will be scaled proportionally. The default value is height.

Match Dimensions (mtb) Output Parameters:

image

The image output is the resized version of the source image. This image will have its dimensions adjusted to match the specified dimension (height or width) of the reference image, while preserving the original aspect ratio.

new_width

The new_width output provides the new width of the resized source image. This value is calculated based on the aspect ratio and the specified dimension to match (height or width) of the reference image.

new_height

The new_height output provides the new height of the resized source image. This value is calculated based on the aspect ratio and the specified dimension to match (height or width) of the reference image.

Match Dimensions (mtb) Usage Tips:

• To maintain the visual quality of your images, always ensure that the aspect ratio is preserved by using the match parameter appropriately.
• Use the height option for the match parameter when you want to ensure that the heights of your images are consistent, which is useful for creating uniform rows of images.
• Use the width option for the match parameter when you want to ensure that the widths of your images are consistent, which is useful for creating uniform columns of images.

Match Dimensions (mtb) Common Errors and Solutions:

"All input tensors must have the same shape when on_mismatch is 'Error'."

• Explanation: This error occurs when the input tensors (images) do not have the same shape, and the on_mismatch parameter is set to Error.
• Solution: Ensure that all input images have the same shape or adjust the on_mismatch parameter to either Smallest or Largest to allow automatic resizing.

"Invalid match parameter value."

• Explanation: This error occurs when the match parameter is set to a value other than height or width.
• Solution: Set the match parameter to either height or width to specify the dimension to match.

"Reference image not provided."

• Explanation: This error occurs when the reference parameter is not provided.
• Solution: Ensure that a reference image is provided to guide the resizing process.

"Source image not provided."

• Explanation: This error occurs when the source parameter is not provided.
• Solution: Ensure that a source image is provided to be resized.