ComfyUI Node: PanoImageEqu2Equ

PanoImageEqu2Equ:

The PanoImageEqu2Equ node is designed to transform equirectangular images by applying specified rotations, allowing you to adjust the perspective of panoramic images. This node is particularly useful for AI artists who work with 360-degree images and need to manipulate the view direction without altering the image's overall structure. By using this node, you can achieve seamless rotations in both horizontal and vertical directions, making it an essential tool for creating immersive and dynamic visual experiences. The node leverages the py360 library to perform these transformations, ensuring high-quality results that maintain the integrity of the original image.

PanoImageEqu2Equ Input Parameters:

equ

The equ parameter represents the input equirectangular image that you wish to transform. This image is expected to be in a specific format where the channels are permuted to match the required input structure for processing. The equirectangular format is a common representation for 360-degree images, where the horizontal axis represents the full 360-degree view, and the vertical axis represents the 180-degree view from top to bottom.

u_deg

The u_deg parameter specifies the horizontal rotation angle in degrees. It allows you to rotate the image around the vertical axis, effectively changing the horizontal perspective of the image. The value can range from -180 to 180 degrees, with a default of 0.0 degrees, meaning no rotation. Adjusting this parameter can help you focus on different parts of the panoramic scene.

v_deg

The v_deg parameter controls the vertical rotation angle in degrees. This parameter rotates the image around the horizontal axis, altering the vertical perspective. The range for v_deg is from -90 to 90 degrees, with a default of 0.0 degrees. This is useful for looking up or down within the panoramic image, allowing for a more comprehensive exploration of the scene.

width

The width parameter defines the width of the output image. If set to 0, the width of the input image is used by default. This parameter allows you to specify the desired resolution of the output image, which can be important for maintaining image quality or meeting specific display requirements.

height

The height parameter sets the height of the output image. Similar to the width parameter, if the height is set to 0, the height of the input image is used. This parameter is crucial for ensuring that the output image has the correct aspect ratio and resolution for your needs.

PanoImageEqu2Equ Output Parameters:

equ

The equ output parameter is the transformed equirectangular image resulting from the specified rotations. This output maintains the same format as the input image, with the channels permuted back to their original order. The transformed image reflects the new perspective based on the u_deg and v_deg rotations, providing a fresh view of the panoramic scene.

PanoImageEqu2Equ Usage Tips:

• To achieve a smooth transition between different perspectives, experiment with small incremental changes to the u_deg and v_deg parameters.
• When working with high-resolution images, ensure that the width and height parameters are set to maintain the desired level of detail in the output.
• Use the default width and height settings (by setting them to 0) to preserve the original image dimensions if no resizing is needed.

PanoImageEqu2Equ Common Errors and Solutions:

Image format error

• Explanation: This error occurs if the input image is not in the expected equirectangular format or if the channels are not correctly permuted.
• Solution: Ensure that the input image is correctly formatted and that the channels are permuted to match the required input structure before processing.

Invalid rotation angle

• Explanation: This error arises when the u_deg or v_deg parameters are set outside their valid ranges.
• Solution: Verify that the u_deg is within -180 to 180 degrees and v_deg is within -90 to 90 degrees. Adjust the values accordingly to fall within these ranges.