ComfyUI Node: Create Seam Mask

Create Seam Mask:

The Create Seam Mask node is designed to generate a seam mask specifically for inpainting tasks on equirectangular images. This type of image is commonly used in 360-degree photography and virtual reality applications, where seamless transitions are crucial. The node's primary function is to create a mask that identifies and isolates the seams in these images, allowing for precise inpainting and editing. By doing so, it helps maintain the visual continuity and integrity of the image, ensuring that any modifications blend seamlessly with the surrounding areas. This node is particularly beneficial for artists and developers working with immersive media, as it simplifies the process of handling seams in equirectangular projections.

Create Seam Mask Input Parameters:

image

This parameter represents the input image on which the seam mask will be created. It is essential for the node's operation as it provides the base data from which the mask is generated. The default value is None, indicating that an image must be provided for the node to function.

frac_width

This parameter specifies the fractional width of the seam relative to the image's total width. It is a floating-point value with a default of 0.10, meaning the seam will cover 10% of the image's width by default. This parameter is ignored if pixel_width is set to a value greater than zero.

pixel_width

This integer parameter defines the width of the seam in pixels. If set to a value greater than zero, it overrides the frac_width parameter. This allows for precise control over the seam's width, which can be crucial for specific inpainting tasks. The default value is 0.

feather

The feather parameter determines the pixel size of the feathering applied to the seam edges. Feathering helps to soften the transition between the seam and the surrounding areas, creating a more natural blend. The default value is 0, indicating no feathering.

roll_x_by_50_percent

This boolean parameter, when set to True, shifts the output mask horizontally by 50%, effectively rotating the equirectangular image by 180 degrees. This can be useful for aligning the seam with specific features in the image. The default value is False.

Create Seam Mask Output Parameters:

Seam Mask

The output of this node is a Seam Mask, which is a binary mask highlighting the seam areas in the input equirectangular image. This mask is crucial for inpainting tasks, as it allows for targeted editing of the seam regions, ensuring that any modifications blend seamlessly with the rest of the image. The mask can be used in conjunction with other image processing tools to achieve the desired visual effects.

Create Seam Mask Usage Tips:

• To achieve a seamless blend in your equirectangular images, adjust the frac_width or pixel_width to match the specific requirements of your project. A larger seam width may be necessary for images with more complex features.
• Utilize the feather parameter to soften the edges of the seam mask, which can help in creating a more natural transition between the seam and the surrounding areas.
• If your image requires alignment adjustments, consider using the roll_x_by_50_percent option to rotate the mask and better align it with the image's features.

Create Seam Mask Common Errors and Solutions:

Image not provided

• Explanation: The node requires an input image to generate a seam mask, but none was provided.
• Solution: Ensure that you supply a valid equirectangular image to the image parameter before executing the node.

Invalid pixel width

• Explanation: The pixel_width parameter is set to a negative value, which is not allowed.
• Solution: Set the pixel_width to a non-negative integer to specify the desired seam width in pixels.

Feathering value too high

• Explanation: The feather parameter is set to a value that exceeds the image's dimensions, causing unexpected results.
• Solution: Adjust the feather value to be within a reasonable range relative to the image size to ensure proper feathering effects.