ComfyUI Node: Roll Image Axes

Roll Image Axes:

The Roll Image Axes node is designed to facilitate the manipulation of image orientation by rolling or shifting the image along its axes. This node is particularly useful for tasks that require the adjustment of image alignment, such as removing or accessing seams in images, especially in equirectangular projections. By allowing you to roll the image horizontally or vertically, this node provides a straightforward method to reposition image content, making it easier to work with specific areas of an image. The node's functionality is especially beneficial in scenarios where precise image alignment is crucial, such as in panoramic or 360-degree image editing.

Roll Image Axes Input Parameters:

image

The image parameter is the input image that you want to roll. It should be provided as a tensor with four dimensions, typically representing a batch of images. This parameter is essential as it serves as the base upon which the rolling operations will be performed.

roll_x

The roll_x parameter specifies the number of pixels to shift the image horizontally. A positive value rolls the image to the right, while a negative value rolls it to the left. The default value is 0, meaning no horizontal shift. This parameter allows you to control the horizontal alignment of the image content.

roll_y

The roll_y parameter determines the number of pixels to shift the image vertically. A positive value rolls the image downward, and a negative value rolls it upward. The default value is 0, indicating no vertical shift. This parameter is useful for adjusting the vertical positioning of the image content.

roll_x_by_50_percent

The roll_x_by_50_percent parameter is a boolean option that, when set to true, overrides the roll_x and roll_y parameters to shift the image horizontally by 50% of its width. This is particularly useful for quickly achieving a 180-degree rotation effect on equirectangular images. The default value is false, meaning this automatic shift is not applied unless explicitly enabled.

Roll Image Axes Output Parameters:

Rolled Image

The Rolled Image output is the result of applying the specified rolling transformations to the input image. This output is a tensor with the same dimensions as the input image, but with its content shifted according to the roll_x, roll_y, and roll_x_by_50_percent parameters. The rolled image allows you to view and work with the adjusted orientation, facilitating tasks that require specific image alignments.

Roll Image Axes Usage Tips:

• To achieve a quick 180-degree rotation on an equirectangular image, enable the roll_x_by_50_percent parameter. This will automatically shift the image horizontally by half its width.
• Use the roll_x and roll_y parameters to fine-tune the alignment of specific image areas, which can be particularly useful when working with panoramic images or when trying to align features across image seams.

Roll Image Axes Common Errors and Solutions:

AssertionError: image should have 4 dimensions, got <number>

• Explanation: This error occurs when the input image does not have the required four dimensions, which are typically expected for a batch of images.
• Solution: Ensure that the input image is correctly formatted as a four-dimensional tensor. If you are working with a single image, you may need to add additional dimensions to match the expected input format.

Unexpected behavior when roll_x_by_50_percent is enabled

• Explanation: Enabling roll_x_by_50_percent overrides the roll_x and roll_y parameters, which might lead to unexpected results if not intended.
• Solution: Double-check your parameter settings to ensure that roll_x_by_50_percent is only enabled when you want to shift the image by 50%. If you need specific control over the rolling, disable this parameter and use roll_x and roll_y instead.