ComfyUI Node: PanoImagePic2Equ

PanoImagePic2Equ:

The PanoImagePic2Equ node is designed to convert panoramic images from a perspective view to an equirectangular format. This transformation is particularly useful for applications that require a 360-degree view, such as virtual reality environments or panoramic photography. By converting images to an equirectangular format, you can achieve a seamless and continuous panoramic view, which is essential for creating immersive experiences. The node allows you to adjust the horizontal and vertical fields of view, as well as the orientation of the image, providing flexibility in how the final output is rendered. This capability is beneficial for artists and developers who need to manipulate panoramic images for various creative and technical purposes.

PanoImagePic2Equ Input Parameters:

image

The image parameter represents the input panoramic image that you want to convert to an equirectangular format. This image should be in a perspective view, and the node will process it to produce the desired output. The input image is expected to be in a format that the node can interpret and manipulate.

hfov

The hfov parameter stands for horizontal field of view. It determines the extent of the scene that is visible horizontally in the output image. The value is specified in degrees, with a default of 60.0, a minimum of 0.0, and a maximum of 180.0. Adjusting this parameter allows you to control how much of the scene is captured in the horizontal direction.

u_deg

The u_deg parameter specifies the horizontal rotation angle in degrees. It allows you to rotate the image horizontally, which can be useful for aligning the image with a specific orientation. The default value is 0.0, with a range from -180.0 to 180.0. This parameter helps in adjusting the horizontal perspective of the image.

v_deg

The v_deg parameter indicates the vertical rotation angle in degrees. Similar to u_deg, it allows you to rotate the image vertically to achieve the desired orientation. The default value is 0.0, with a range from -90.0 to 90.0. This parameter is essential for adjusting the vertical perspective of the image.

roll

The roll parameter controls the roll angle of the image, which is the rotation around the camera's forward axis. This can be used to correct or introduce a tilt in the image. The default value is 0.0, with a range from -180.0 to 180.0. Adjusting the roll can help in achieving a balanced and level image.

PanoImagePic2Equ Output Parameters:

images

The images output parameter represents the converted equirectangular image. This is the final result of the node's processing, providing a seamless panoramic view that can be used in various applications. The output image retains the adjustments made through the input parameters, such as field of view and orientation, ensuring that the final product meets the desired specifications.

PanoImagePic2Equ Usage Tips:

• To achieve a more immersive panoramic view, experiment with different hfov values to find the optimal horizontal field of view for your specific application.
• Use the u_deg and v_deg parameters to fine-tune the orientation of your image, ensuring that important elements are centered and aligned correctly in the final output.

PanoImagePic2Equ Common Errors and Solutions:

Image format not supported

• Explanation: The input image is not in a format that the node can process.
• Solution: Ensure that the input image is in a compatible format, such as a standard image file type that the node can interpret.

Invalid field of view value

• Explanation: The hfov value is set outside the allowed range.
• Solution: Adjust the hfov value to be within the range of 0.0 to 180.0 degrees.

Rotation angle out of bounds

• Explanation: The u_deg or v_deg values are set outside their respective ranges.
• Solution: Ensure that u_deg is within -180.0 to 180.0 degrees and v_deg is within -90.0 to 90.0 degrees. Adjust the values accordingly.