ComfyUI Node: MiniMax H3 Image • Advanced Resolution

MiniMax H3 Image • Advanced Resolution:

The H3ImageResolution node is an advanced tool designed to calculate optimal image resolutions while considering various factors such as aspect ratios, source image dimensions, and custom megapixel settings. It is particularly beneficial for AI artists who need to maintain the integrity of their images when resizing or adjusting canvas dimensions. This node supports explicit aspect ratios, source-image ratios, and custom dimensions, ensuring that the resulting image fits within H3's native pixel area if desired. By doing so, it helps prevent distortion and maintains the quality of the image. The node also provides flexibility by allowing users to specify custom megapixels, which can be particularly useful when working with high-resolution images. Overall, the H3ImageResolution node is a powerful tool for managing image resolutions in a way that balances quality and computational efficiency.

MiniMax H3 Image • Advanced Resolution Input Parameters:

aspect_ratio

This parameter defines the desired aspect ratio for the output image. It can be set to a specific ratio or derived from the source image. The aspect ratio influences the width and height calculations, ensuring that the image maintains its intended proportions. If set to "source image," the aspect ratio of the provided source image will be used.

resolution_profile

This parameter specifies the resolution profile to be used, which determines the target megapixels for the output image. It can be set to predefined profiles or "custom megapixels" for user-defined settings. The resolution profile impacts the overall size and quality of the output image.

source_image

An optional parameter that accepts a source image in the form of a torch.Tensor. This is required only when the aspect_ratio is set to "source image." The source image provides the reference dimensions for calculating the aspect ratio and can influence the final resolution.

custom_megapixels

This parameter allows users to define a custom megapixel value for the output image when the resolution_profile is set to "custom megapixels." It ranges from 0.10 to 64.0, with a default value of 2.0. This setting directly affects the size and detail of the output image.

limit_to_native_area

A boolean parameter that, when set to true, limits the output image resolution to approximately H3's native 768×1344 pixel area. This helps manage computational resources and ensures compatibility with H3's native resolution constraints.

MiniMax H3 Image • Advanced Resolution Output Parameters:

width

The calculated width of the output image, based on the specified aspect ratio and resolution profile. This value ensures that the image maintains its intended proportions and fits within any specified constraints.

height

The calculated height of the output image, determined alongside the width to preserve the aspect ratio. This value is crucial for ensuring that the image does not become distorted during resizing.

info

A string providing detailed information about the calculated resolution, including the dimensions, megapixels, source, resolution profile, and any size limitations. This output helps users understand the characteristics of the generated image and any constraints applied.

MiniMax H3 Image • Advanced Resolution Usage Tips:

• To maintain the original aspect ratio of an image, set the aspect_ratio parameter to "source image" and provide the source_image parameter.
• Use the custom_megapixels parameter to specify a precise resolution when working with unique or high-resolution projects, ensuring the resolution_profile is set to "custom megapixels."

MiniMax H3 Image • Advanced Resolution Common Errors and Solutions:

Unknown H3 image quality profile

• Explanation: This error occurs when an unsupported or incorrect resolution profile is specified.
• Solution: Ensure that the resolution_profile parameter is set to a valid profile or "custom megapixels" if using a custom setting.

Image dimensions exceed native area

• Explanation: This error arises when the calculated image dimensions exceed H3's native pixel area, especially when limit_to_native_area is set to true.
• Solution: Adjust the custom_megapixels or ensure that limit_to_native_area is set appropriately to fit within the native area constraints.