ComfyUI Node: Create Pole Mask

Create Pole Mask:

The Create Pole Mask node is designed to generate a mask specifically for inpainting tasks on equirectangular images, which are commonly used in 360-degree photography and virtual reality applications. This node is particularly useful for addressing the distortion and artifacts that can occur at the poles of equirectangular images. By creating a mask that targets these areas, you can apply inpainting techniques to seamlessly blend and correct the image, enhancing the overall visual quality. The node offers flexibility in defining the mask's size and shape, allowing you to customize the mask according to the specific requirements of your project. This capability is essential for artists and developers working with immersive media, as it helps maintain the integrity and realism of the visual content.

Create Pole Mask Input Parameters:

image

This parameter represents the input image on which the pole mask will be applied. It is essential for the node to function, as the mask is generated based on the characteristics of this image. The default value is None, indicating that an image must be provided for the node to operate.

circle_radius

This parameter defines the radius of the circular mask as a fraction of the image's dimensions. It allows you to control the size of the mask relative to the image, providing flexibility in how much of the pole area is covered. The default value is 0.10, meaning the mask will cover 10% of the image's radius. This parameter is ignored if pixel_radius is set to a value greater than 0.

pixel_radius

This parameter specifies the radius of the mask in pixels. It provides a more precise control over the mask size, allowing you to define the exact number of pixels to be covered. If this value is greater than 0, it takes precedence over circle_radius. The default value is 0, which means the circle_radius will be used unless overridden.

feather

This parameter determines the amount of feathering applied to the edges of the mask. Feathering creates a smooth transition between the masked and unmasked areas, which can help blend the inpainted regions more naturally with the rest of the image. The default value is 0, indicating no feathering, but you can increase this value to achieve a softer edge.

mode

This parameter allows you to choose between two modes: face and equirectangular. The face mode is typically used for standard images, while the equirectangular mode is specifically designed for 360-degree images. The default mode is face, but selecting equirectangular ensures that the mask is appropriately applied to equirectangular images, addressing the unique challenges posed by their geometry.

Create Pole Mask Output Parameters:

Pole Mask

The output of this node is a mask, referred to as the "Pole Mask." This mask highlights the areas of the input image that require inpainting, particularly around the poles of equirectangular images. The mask is crucial for guiding inpainting algorithms to focus on the specified regions, ensuring that any distortions or artifacts are effectively corrected. By using this mask, you can achieve a more polished and visually appealing result in your 360-degree images.

Create Pole Mask Usage Tips:

• To achieve the best results when working with equirectangular images, ensure that you select the equirectangular mode. This will tailor the mask to the specific geometry of 360-degree images.
• If you need precise control over the mask size, use the pixel_radius parameter to define the mask's radius in pixels. This can be particularly useful when working with high-resolution images where fractional radii may not provide the desired accuracy.
• Experiment with the feather parameter to create smoother transitions between masked and unmasked areas. This can help blend the inpainted regions more naturally with the rest of the image.

Create Pole Mask Common Errors and Solutions:

Image not provided

• Explanation: The node requires an input image to generate the pole mask, but no image was supplied.
• Solution: Ensure that you provide a valid image as input to the node before executing it.

Invalid mode selection

• Explanation: The mode parameter was set to a value other than face or equirectangular.
• Solution: Verify that the mode parameter is set to either face or equirectangular to ensure proper mask generation.

Conflicting radius parameters

• Explanation: Both circle_radius and pixel_radius are set, but pixel_radius is not greater than 0, causing confusion in mask size determination.
• Solution: If you intend to use pixel_radius, ensure it is set to a value greater than 0. Otherwise, rely on circle_radius for mask sizing.