ComfyUI Node: Cubemap to Equirectangular

Cubemap to Equirectangular:

The Cubemap to Equirectangular node is designed to transform a cubemap image, which consists of six square faces representing the environment around a point, into an equirectangular image. This transformation is particularly useful in virtual reality and panoramic photography, where a single, continuous image is needed to represent a 360-degree view. The node leverages advanced interpolation techniques to ensure smooth transitions between the cubemap faces, providing a seamless and distortion-free equirectangular image. By converting cubemaps into equirectangular format, you can easily manipulate and display 360-degree content in a variety of applications, enhancing the immersive experience.

Cubemap to Equirectangular Input Parameters:

e_img

This parameter represents the input image in cubemap format, consisting of six faces. It is crucial for the transformation process as it provides the source data that will be converted into an equirectangular image. The input should have exactly six faces, each representing a different direction in the cubemap.

h

This parameter specifies the height of the resulting equirectangular image. If set to a value less than 1, the height will be automatically determined based on the input image dimensions. Adjusting this parameter allows you to control the vertical resolution of the output image.

w

This parameter defines the width of the resulting equirectangular image. Similar to the height parameter, if set to a value less than 1, the width will be automatically calculated. This parameter is essential for controlling the horizontal resolution of the output image.

padding_mode

This parameter determines the interpolation method used when sampling the input image. Options include bilinear, bicubic, and nearest, with bilinear as the default. The choice of padding mode affects the smoothness and quality of the transitions between cubemap faces in the equirectangular image.

cube_format

This parameter specifies the format of the input cubemap. Available options are stack, dice, horizon, list, and dict, with stack as the default. The format determines how the cubemap faces are arranged and interpreted during the conversion process.

Cubemap to Equirectangular Output Parameters:

Equirectangular Image

The output is an equirectangular image that represents the entire 360-degree view of the environment. This image is suitable for use in applications that require a panoramic view, such as virtual reality or 360-degree video players. The equirectangular format ensures that the image can be easily manipulated and displayed in a continuous, seamless manner.

Cubemap to Equirectangular Usage Tips:

• Ensure that the input image has exactly six faces to avoid errors during the conversion process.
• Experiment with different padding_mode settings to achieve the desired level of smoothness and quality in the output image.
• Use the cube_format parameter to match the arrangement of your input cubemap, ensuring accurate interpretation and conversion.

Cubemap to Equirectangular Common Errors and Solutions:

Input should have 6 faces, got <number_of_faces>

• Explanation: This error occurs when the input image does not have exactly six faces, which is required for a cubemap.
• Solution: Verify that your input image is a complete cubemap with six faces and adjust the input accordingly.

Invalid padding mode: <padding_mode>

• Explanation: This error indicates that the specified padding mode is not recognized or supported.
• Solution: Ensure that the padding_mode parameter is set to one of the supported options: bilinear, bicubic, or nearest.