Equirectangular Rotation:
The Equirectangular Rotation node is designed to manipulate equirectangular images, which are commonly used in 360-degree photography and virtual reality applications. This node allows you to rotate these images around three axes: roll, horizontal, and vertical. By adjusting these parameters, you can change the orientation of the image, which is particularly useful for aligning or reorienting panoramic images to achieve the desired perspective. The node supports different padding modes to handle the edges of the image during rotation, ensuring smooth transitions and minimizing distortion. This functionality is essential for artists and developers working with immersive media, as it provides a straightforward method to adjust the viewpoint of equirectangular images without complex manual editing.
Equirectangular Rotation Input Parameters:
e_img
This parameter represents the input equirectangular image that you want to rotate. It should be a 4-dimensional tensor, typically representing a batch of images with dimensions for batch size, channels, height, and width. The image serves as the base for all transformations applied by the node.
roll
The roll parameter specifies the degree of rotation around the image's central axis, akin to tilting your head sideways. It is a float value with a default of 0.0, allowing for fine-tuned adjustments to the image's orientation. This parameter is crucial for correcting or altering the image's tilt.
h_deg
This parameter controls the horizontal rotation of the image, measured in degrees. It allows you to rotate the image left or right, effectively changing the horizontal viewpoint. The default value is 0.0, and it can be adjusted to achieve the desired horizontal alignment.
v_deg
The vertical rotation parameter, v_deg, adjusts the image's rotation up or down, similar to nodding your head. This float value, with a default of 0.0, is essential for modifying the vertical perspective of the image, enabling you to focus on different parts of the scene.
padding_mode
This parameter determines how the edges of the image are handled during rotation. It offers three options: "bilinear," "bicubic," and "nearest," with "bilinear" as the default. Each mode provides a different method for interpolating pixel values at the image's borders, affecting the smoothness and quality of the rotated image.
Equirectangular Rotation Output Parameters:
Rotated Image
The output of this node is the "Rotated Image," which is the transformed version of the input equirectangular image after applying the specified rotations. This output maintains the same dimensions as the input image and reflects the adjustments made through the roll, horizontal, and vertical rotation parameters. The rotated image is ready for further processing or direct use in applications requiring specific orientations.
Equirectangular Rotation Usage Tips:
- Experiment with small increments in the roll, h_deg, and v_deg parameters to achieve precise control over the image orientation, especially when aligning images for VR or panoramic displays.
- Use the "bilinear" padding mode for smoother transitions at the image edges, which is particularly beneficial for high-resolution images where quality is paramount.
Equirectangular Rotation Common Errors and Solutions:
e_img should have 4 dimensions, got ``
- Explanation: This error occurs when the input image does not have the required 4 dimensions, which are necessary for batch processing.
- Solution: Ensure that your input image is formatted as a 4-dimensional tensor, typically with dimensions for batch size, channels, height, and width.
Invalid padding mode
- Explanation: This error indicates that the specified padding mode is not recognized by the node.
- Solution: Verify that the padding mode is set to one of the supported options: "bilinear," "bicubic," or "nearest."
