ComfyUI Node: Mask Equirectangular Rotation

Mask Equirectangular Rotation:

The Mask Equirectangular Rotation node is designed to facilitate the rotation of equirectangular masks, which are commonly used in 360-degree imaging and virtual reality applications. This node allows you to manipulate the orientation of a mask by adjusting its roll, horizontal, and vertical angles, providing a flexible tool for aligning and transforming masks to fit specific spatial requirements. By leveraging different interpolation methods, such as bilinear, bicubic, and nearest, the node ensures smooth transitions and accurate rotations, enhancing the visual quality of the output. This capability is particularly beneficial for artists and developers working with immersive environments, as it simplifies the process of adjusting masks to match the desired perspective or orientation.

Mask Equirectangular Rotation Input Parameters:

mask

The mask parameter represents the input equirectangular mask that you wish to rotate. It is a tensor with three dimensions, typically corresponding to the height, width, and channels of the mask. This parameter is crucial as it serves as the base image that will undergo rotation transformations. The default value is None, meaning you need to provide a valid mask for the node to function.

roll

The roll parameter specifies the degree of rotation around the z-axis of the mask. It is a floating-point value that determines how much the mask should be rotated horizontally. The default value is 0.0, indicating no rotation. Adjusting this parameter allows you to achieve the desired horizontal alignment of the mask.

h_deg

The h_deg parameter controls the horizontal rotation angle of the mask in degrees. It is a floating-point value that affects the mask's orientation along the horizontal plane. The default value is 0.0, meaning no horizontal rotation is applied. By modifying this parameter, you can adjust the mask's horizontal perspective to better fit your needs.

v_deg

The v_deg parameter defines the vertical rotation angle of the mask in degrees. It is a floating-point value that influences the mask's orientation along the vertical plane. The default value is 0.0, indicating no vertical rotation. This parameter is useful for adjusting the mask's vertical perspective to align with specific visual requirements.

padding_mode

The padding_mode parameter determines the interpolation method used during the rotation process. It offers three options: bilinear, bicubic, and nearest, with bilinear being the default. This parameter affects the smoothness and quality of the rotated mask, allowing you to choose the most suitable interpolation method for your project.

Mask Equirectangular Rotation Output Parameters:

Rotated Mask

The Rotated Mask is the output of the node, representing the equirectangular mask after the specified rotation transformations have been applied. This output is a tensor with the same dimensions as the input mask, but with its orientation adjusted according to the roll, horizontal, and vertical angles specified. The rotated mask is essential for integrating the adjusted mask into 360-degree environments or virtual reality applications, ensuring that it aligns correctly with other visual elements.

Mask Equirectangular Rotation Usage Tips:

• To achieve a smooth rotation effect, experiment with different padding_mode options to find the one that best suits your visual requirements.
• Use small increments for roll, h_deg, and v_deg to fine-tune the mask's orientation and achieve precise alignment with other elements in your scene.

Mask Equirectangular Rotation Common Errors and Solutions:

mask should have 3 dimensions, got ``

• Explanation: This error occurs when the input mask does not have the expected three dimensions, which are necessary for the node to process the mask correctly.
• Solution: Ensure that the input mask is a three-dimensional tensor, typically representing height, width, and channels. Verify the dimensions of your input before passing it to the node.