ComfyUI Node: PanoImageEqu2Pic

PanoImageEqu2Pic:

The PanoImageEqu2Pic node is designed to transform equirectangular images into perspective images, allowing you to view a specific portion of a panoramic scene as if you were looking through a camera lens. This node is particularly useful for AI artists who want to extract and manipulate specific views from a 360-degree image. By adjusting the horizontal and vertical angles, as well as the field of view, you can control the exact perspective and framing of the output image. This capability is essential for creating immersive visual experiences and for integrating panoramic content into traditional image formats.

PanoImageEqu2Pic Input Parameters:

equ

The equ parameter represents the input equirectangular image that you wish to convert. This image should be in a format that supports panoramic views, typically with a 2:1 aspect ratio. The equirectangular format is a common way to represent 360-degree images, and this parameter is crucial as it serves as the source for the perspective transformation.

u_deg

The u_deg parameter specifies the horizontal rotation angle in degrees. It determines the horizontal direction you are looking at within the panoramic image. The value can range from -180 to 180 degrees, with a default of 0.0 degrees. Adjusting this parameter allows you to pan left or right across the panorama.

v_deg

The v_deg parameter controls the vertical rotation angle in degrees, allowing you to tilt your view up or down within the panoramic image. The range is from -90 to 90 degrees, with a default of 0.0 degrees. This parameter is essential for adjusting the vertical perspective of the output image.

hfov

The hfov parameter stands for horizontal field of view, measured in degrees. It defines the width of the viewable area in the output image. The range is from 0 to 180 degrees, with a default of 90.0 degrees. A larger field of view captures more of the scene, while a smaller field of view provides a more zoomed-in perspective.

width

The width parameter sets the width of the output image in pixels. It must be a positive integer, with a default value of 512 pixels. This parameter, along with the height, determines the resolution of the resulting perspective image.

height

The height parameter specifies the height of the output image in pixels. Like the width, it must be a positive integer, and it works in conjunction with the width to define the resolution of the output. The default value is not explicitly provided, but it should match the intended aspect ratio of the output image.

PanoImageEqu2Pic Output Parameters:

IMAGE

The IMAGE output is the transformed perspective image derived from the input equirectangular image. This output reflects the specified horizontal and vertical angles, field of view, and resolution, providing a view as if captured by a camera at the specified orientation and zoom level. It is the primary result of the node's transformation process.

PanoImageEqu2Pic Usage Tips:

• To achieve a specific view, experiment with the u_deg and v_deg parameters to pan and tilt the perspective until you find the desired framing.
• Adjust the hfov parameter to control the zoom level; a smaller field of view will give a more focused and detailed image, while a larger field of view will capture more of the scene.
• Ensure that the width and height parameters are set to match the desired resolution and aspect ratio of your final image output.

PanoImageEqu2Pic Common Errors and Solutions:

Invalid image format

• Explanation: The input image is not in the correct equirectangular format.
• Solution: Ensure that the input image has a 2:1 aspect ratio and is properly formatted as an equirectangular image.

Out of range angle values

• Explanation: The u_deg or v_deg values are set outside their allowable ranges.
• Solution: Check that u_deg is between -180 and 180 degrees and v_deg is between -90 and 90 degrees.

Field of view too narrow or wide

• Explanation: The hfov value is set too low or too high, resulting in an unusable image.
• Solution: Adjust the hfov to be within the 0 to 180-degree range to ensure a valid perspective transformation.