ComfyUI Node: 🕹️PixelArt Detector (+Save)

🕹️PixelArt Detector (+Save):

PixelArtDetectorSave is a node designed to detect and process pixel art images, optimizing them for various uses by reducing their size and color palette. This node is particularly useful for AI artists who work with pixel art and need to ensure their images maintain a consistent and high-quality appearance. The node automatically detects the optimal 1:1 pixel scale of the input image, reduces the image size accordingly, and can also reduce the color palette to a specified number of colors. This process helps in maintaining the visual integrity of pixel art while optimizing it for different applications. Additionally, the node provides options to resize the image to specific dimensions, ensuring flexibility and control over the final output.

🕹️PixelArt Detector (+Save) Input Parameters:

image

The input image to be processed by the PixelArtDetectorSave node. This parameter accepts an image in a compatible format and serves as the primary source for pixel art detection and processing.

reduce_palette

A boolean parameter that determines whether the color palette of the image should be reduced. When set to true, the node will reduce the number of colors in the image to the specified maximum, helping to maintain the pixel art style. Default value is false.

reduce_palette_max_colors

An integer parameter specifying the maximum number of colors to which the image's palette should be reduced. This parameter is only relevant if reduce_palette is set to true. The value should be chosen based on the desired level of color detail in the final image. Minimum value is 2, and there is no explicit maximum value, but it should be reasonable for the image's context.

resize_w

An integer parameter specifying the width to which the image should be resized. This parameter is optional and should be used when a specific output width is required. The value must be greater than or equal to the minimum resize threshold defined in the settings.

resize_h

An integer parameter specifying the height to which the image should be resized. Similar to resize_w, this parameter is optional and should be used when a specific output height is required. The value must be greater than or equal to the minimum resize threshold defined in the settings.

🕹️PixelArt Detector (+Save) Output Parameters:

processed_image

The output parameter that provides the processed image after pixel art detection, size reduction, and optional palette reduction. This image is optimized for maintaining the pixel art style and is ready for further use or saving.

🕹️PixelArt Detector (+Save) Usage Tips:

• To maintain the visual integrity of your pixel art, ensure that the reduce_palette_max_colors parameter is set to a value that preserves the essential colors of your image.
• Use the resize_w and resize_h parameters to fit your image into specific dimensions without losing the pixel art quality. Ensure the values are above the minimum resize threshold.
• Enable the reduce_palette option if you need to limit the number of colors in your image, which can be particularly useful for creating a more retro or simplified look.

🕹️PixelArt Detector (+Save) Common Errors and Solutions:

"Image size too small for resizing"

• Explanation: The specified width or height for resizing is below the minimum threshold.
• Solution: Ensure that the resize_w and resize_h parameters are set to values greater than or equal to the minimum resize threshold defined in the settings.

"Invalid number of colors for palette reduction"

• Explanation: The reduce_palette_max_colors parameter is set to a value less than 2. - Solution: Set the reduce_palette_max_colors parameter to a value of 2 or higher to ensure a valid color palette reduction.

"Image format not supported"

• Explanation: The input image is in a format that is not compatible with the node.
• Solution: Convert the input image to a supported format, such as PNG or JPEG, before processing it with the PixelArtDetectorSave node.