ComfyUI Node: Non-Square Pixels V1

Non-Square Pixels V1:

The NonSquarePixelsV1 node is designed to transform images by altering their pixel aspect ratios, allowing you to simulate the appearance of non-square pixels commonly found in various video formats. This node is particularly useful for artists and designers who want to create visuals that mimic the look of older television standards or achieve specific artistic effects. By adjusting the pixel aspect ratio, you can stretch or compress the width of the image while maintaining its height, giving you creative control over the final appearance. The node offers flexibility through preset options for common video standards like PAL and NTSC, as well as a custom aspect ratio setting for more tailored adjustments. Additionally, you have the option to preserve the original image dimensions, ensuring that the transformation fits seamlessly into your existing workflow.

Non-Square Pixels V1 Input Parameters:

images

This parameter accepts a batch of images that you want to process. The images should be provided in a format compatible with the node, typically as a tensor or array. The node will apply the pixel aspect ratio transformation to each image in the batch.

preset

The preset parameter allows you to select from predefined pixel aspect ratios that correspond to common video standards. Options include "CUSTOM", "PAL (4:3)", "PAL WIDESCREEN (16:9)", "NTSC (4:3)", and "NTSC WIDESCREEN (16:9)". The default value is "CUSTOM", which means you can specify a custom aspect ratio using the custom_pixel_aspect_ratio parameter. Choosing a preset automatically sets the aspect ratio to match the selected video standard.

custom_pixel_aspect_ratio

This parameter lets you define a custom pixel aspect ratio when the preset is set to "CUSTOM". It is a floating-point value with a default of 1.0667, which corresponds to the PAL 4:3 standard. The value can range from 0.5 to 2.0, allowing for a wide variety of aspect ratio adjustments. This flexibility enables you to achieve specific visual effects that are not covered by the standard presets.

preserve_original_size

The preserve_original_size parameter determines whether the processed images should retain their original dimensions. It has two options: "enable" and "disable", with "enable" as the default. When enabled, the node will resize the transformed images back to their original width and height, ensuring that the overall image size remains unchanged. This is useful if you want to apply the aspect ratio effect without altering the image's dimensions.

Non-Square Pixels V1 Output Parameters:

IMAGE

The output of the NonSquarePixelsV1 node is a batch of images that have been processed to reflect the specified pixel aspect ratio. These images are returned as a tensor, ready for further processing or use in your projects. The transformation applied to the images can create unique visual effects, making this output valuable for artistic and design purposes.

Non-Square Pixels V1 Usage Tips:

• To achieve a classic television look, use the preset options like "PAL (4:3)" or "NTSC (4:3)" to automatically apply the correct pixel aspect ratio for those standards.
• If you want to experiment with unique visual effects, set the preset to "CUSTOM" and adjust the custom_pixel_aspect_ratio to see how different aspect ratios impact the image's appearance.
• When working with images that need to maintain their original dimensions, ensure that preserve_original_size is set to "enable" to avoid any unintended resizing.

Non-Square Pixels V1 Common Errors and Solutions:

Error: "Invalid image format"

• Explanation: This error occurs when the input images are not in a compatible format for processing.
• Solution: Ensure that the images are provided as a tensor or array that the node can process. Convert the images to the appropriate format if necessary.

Error: "Aspect ratio out of range"

• Explanation: This error indicates that the custom_pixel_aspect_ratio value is outside the allowed range.
• Solution: Adjust the custom_pixel_aspect_ratio to be within the range of 0.5 to 2.0. Double-check the value to ensure it falls within these limits.

Error: "Preset not recognized"

• Explanation: This error occurs when an invalid preset option is selected.
• Solution: Verify that the preset parameter is set to one of the available options: "CUSTOM", "PAL (4:3)", "PAL WIDESCREEN (16:9)", "NTSC (4:3)", or "NTSC WIDESCREEN (16:9)".