ComfyUI Node: Panorama Seam Prep

Panorama Seam Prep:

The PanoramaSeamPrep node is designed to prepare equirectangular projection (ERP) images for seam-focused inpainting, a technique often used in panoramic image editing. This node is particularly useful for artists and designers who work with panoramic images and need to ensure seamless transitions across image boundaries. By focusing on the seams, this node helps in creating a more cohesive and visually appealing panoramic image. It achieves this by manipulating the image data to align and blend the seams effectively, ensuring that any inpainting or editing done on the image maintains the integrity of the panoramic view. This node is essential for tasks that require precise control over the seam areas of panoramic images, providing a robust solution for enhancing the quality and continuity of panoramic artworks.

Panorama Seam Prep Input Parameters:

image

This parameter expects an ERP image input in the form of a float tensor with the shape [B, H, W, C], where B is the batch size, H is the height, W is the width, and C is the number of channels. The image should have pixel values ranging from 0 to 1. This input serves as the base image that will be prepared for seam-focused inpainting, ensuring that the seams are aligned and ready for further processing.

seam_width_px

This integer parameter defines the width of the seam area in pixels. It determines how wide the seam band will be, which is crucial for ensuring that the seam is adequately covered during inpainting. The minimum value is 1, the maximum is 2048, and the default is 64. Adjusting this parameter allows you to control the extent of the seam area that will be processed, which can be useful for different image resolutions and seam complexities.

seam_center_offset_px

This integer parameter specifies the offset of the seam center from the midpoint of the image. Positive values move the seam band to the right, while negative values move it to the left. The range is from -2048 to 2048, with a default value of 0. This parameter is essential for aligning the seam band with specific areas of interest in the image, allowing for precise control over the seam's position.

mask_blur_px

This integer parameter controls the amount of blur applied to the mask, measured in pixels. The blur helps in smoothing the transitions around the seam area, ensuring a more natural blend. The minimum value is 0, the maximum is 256, and the default is 10. Adjusting this parameter can help in achieving the desired level of smoothness in the seam transitions, which is particularly useful for creating seamless panoramic images.

Panorama Seam Prep Output Parameters:

image

The output image is a float tensor with the shape [B, H, W, C], representing the prepared ERP image ready for seam-focused inpainting. This output maintains the original image's dimensions and channels, ensuring that it is compatible with further processing steps. The prepared image has its seams aligned and ready for editing, making it an essential output for seamless panoramic image creation.

mask

The mask output is a float tensor with the shape [B, H, W], representing the areas of the image that are targeted for inpainting. This mask highlights the seam areas, providing a guide for where inpainting should be focused. It is crucial for ensuring that the inpainting process is applied precisely to the seam areas, enhancing the overall quality of the panoramic image.

mask_blurred

The mask_blurred output is a float tensor with the shape [B, H, W], similar to the mask output but with an applied blur. This blurred mask helps in creating smooth transitions around the seam areas, ensuring that the inpainting blends naturally with the surrounding image. It is an important output for achieving seamless integration of the inpainted areas with the rest of the image.

Panorama Seam Prep Usage Tips:

• Adjust the seam_width_px parameter based on the resolution of your image to ensure that the seam area is adequately covered for inpainting.
• Use the seam_center_offset_px to align the seam band with specific features in your image that require precise seam handling.
• Experiment with the mask_blur_px setting to achieve the desired level of smoothness in the seam transitions, which can enhance the natural appearance of the panoramic image.

Panorama Seam Prep Common Errors and Solutions:

ValueError: Panorama Seam Prep expects IMAGE input shaped [B,H,W,C].

• Explanation: This error occurs when the input image does not have the expected shape of [B, H, W, C].
• Solution: Ensure that your input image is a float tensor with the correct dimensions and channels. Check that the image is properly formatted before passing it to the node.

Empty image or mask output

• Explanation: This issue arises when the input image has a width or height less than 1, resulting in empty outputs.
• Solution: Verify that your input image has valid dimensions with a width and height greater than zero. Adjust the image size if necessary before processing.