ComfyUI Node: PanoImageAdjust

PanoImageAdjust:

The PanoImageAdjust node is designed to provide a comprehensive suite of image adjustment capabilities specifically tailored for panoramic images. This node allows you to manipulate and transform images using a variety of methods, such as scaling, padding, stretching, and cropping, to achieve the desired visual effects. It is particularly useful for artists working with panoramic or wide-angle images, as it offers precise control over the image dimensions and aspect ratios. By adjusting the image's proportions and applying transformations, you can enhance the visual appeal and composition of your panoramic artworks. The node's flexibility in handling different adjustment methods makes it a valuable tool for fine-tuning images to fit specific artistic visions or project requirements.

PanoImageAdjust Input Parameters:

method

The method parameter allows you to select the type of adjustment to apply to the image. Options include "none", "alpha_remove", "scale", "scale_height", "scale_width", "pad_height", "pad_width", "pad_edge", "stretch", "stretch_pano", "stretch_arc", "crop_edge", "crop_width", "crop_height", "crop_up_down", and "crop_left_right". Each method offers a different transformation, such as removing alpha channels, scaling dimensions, padding edges, stretching the image, or cropping specific areas. This parameter is crucial for defining the specific transformation you wish to apply to your image.

keep_size

The keep_size parameter is a boolean option that determines whether the original size of the image should be maintained after applying the transformation. When set to true, the node will attempt to preserve the original dimensions of the image, adjusting the transformation accordingly. This is useful when you want to apply transformations without altering the overall size of the image. The default value is false.

ratio_front

The ratio_front parameter is a float value that specifies the adjustment ratio for the front part of the image. It ranges from -1.0 to 1.0, with a default value of 0.0. This parameter allows you to fine-tune the transformation effect on the front section of the image, providing control over how much the image is stretched or compressed in this area.

ratio_right

The ratio_right parameter functions similarly to ratio_front, but it applies to the right side of the image. It allows you to adjust the transformation ratio for the right section, with values ranging from -1.0 to 1.0 and a default of 0.0. This parameter is useful for achieving asymmetrical transformations or emphasizing specific parts of the image.

ratio_back

The ratio_back parameter controls the adjustment ratio for the back part of the image. Like the other ratio parameters, it ranges from -1.0 to 1.0, with a default value of 0.0. This parameter is essential for managing the transformation effect on the back section, allowing for balanced or intentionally skewed image adjustments.

ratio_left

The ratio_left parameter is used to adjust the transformation ratio for the left side of the image. It provides a range from -1.0 to 1.0, with a default of 0.0, enabling you to control the degree of transformation applied to the left section. This parameter is particularly useful for creating dynamic compositions or correcting perspective distortions.

ratio_up

The ratio_up parameter specifies the adjustment ratio for the upper part of the image. With a range from -1.0 to 1.0 and a default value of 0.0, it allows you to fine-tune the transformation effect on the top section of the image. This parameter is beneficial for achieving vertical adjustments or enhancing the image's vertical composition.

PanoImageAdjust Output Parameters:

pano_pipe

The pano_pipe output is a data structure that encapsulates the transformation parameters and settings applied to the panoramic image. It serves as a reference for further processing or adjustments, ensuring consistency across different stages of your workflow. This output is essential for maintaining a record of the transformations applied to the image.

equ

The equ output represents the equidistant projection of the transformed panoramic image. This output is crucial for visualizing the final result of the adjustments, providing a clear view of how the image has been altered. It is particularly useful for evaluating the effectiveness of the transformations and making any necessary refinements.

mask

The mask output is a binary mask that indicates the areas of the image affected by the transformation. This output is valuable for identifying the regions that have been modified, allowing for precise control over the transformation process. It can be used to apply additional effects or corrections to specific parts of the image.

PanoImageAdjust Usage Tips:

• Experiment with different method options to find the best transformation for your image. Each method offers unique effects that can enhance your artwork.
• Use the keep_size parameter to maintain the original dimensions of your image when applying transformations, ensuring that the overall composition remains consistent.
• Adjust the ratio parameters to fine-tune the transformation effects on specific sections of the image, allowing for precise control over the final result.

PanoImageAdjust Common Errors and Solutions:

"Invalid method selected"

• Explanation: This error occurs when an unsupported method is chosen for the transformation.
• Solution: Ensure that the method parameter is set to one of the supported options listed in the input parameters.

"Ratio value out of range"

• Explanation: This error indicates that one of the ratio parameters has been set outside the allowed range of -1.0 to 1.0.
• Solution: Adjust the ratio parameters to fall within the specified range to avoid this error.

"Image size mismatch"

• Explanation: This error occurs when the keep_size parameter is set to true, but the transformation results in a size change.
• Solution: Review the transformation settings and adjust the method or ratio parameters to ensure the image size remains consistent.