ComfyUI Node: ImageDrawEllipse

ImageDrawEllipse:

The ImageDrawEllipse node is designed to facilitate the drawing of ellipses on an image canvas. This node is particularly useful for AI artists who want to add elliptical shapes to their digital artwork. By leveraging this node, you can specify the dimensions, position, and colors of the ellipse, both for its outline and fill. The node also supports anti-aliasing through Supersample Anti-Aliasing (SSAA) and allows you to choose the resampling method for resizing the image. This flexibility makes it a powerful tool for creating smooth and visually appealing ellipses in your images.

ImageDrawEllipse Input Parameters:

container

The container parameter represents the image canvas on which the ellipse will be drawn. It is a multi-dimensional array that holds the pixel data of the image. The dimensions of the container determine the size of the canvas.

start_x

The start_x parameter specifies the x-coordinate of the starting point of the ellipse's bounding box. This value is relative to the width of the container. It determines the horizontal position where the ellipse begins.

start_y

The start_y parameter specifies the y-coordinate of the starting point of the ellipse's bounding box. This value is relative to the height of the container. It determines the vertical position where the ellipse begins.

end_x

The end_x parameter specifies the x-coordinate of the ending point of the ellipse's bounding box. This value is relative to the width of the container. It determines the horizontal position where the ellipse ends.

end_y

The end_y parameter specifies the y-coordinate of the ending point of the ellipse's bounding box. This value is relative to the height of the container. It determines the vertical position where the ellipse ends.

outline_size

The outline_size parameter defines the thickness of the ellipse's outline. A larger value results in a thicker outline, while a smaller value results in a thinner outline.

outline_red

The outline_red parameter specifies the red component of the ellipse's outline color. The value ranges from 0 to 255.

outline_green

The outline_green parameter specifies the green component of the ellipse's outline color. The value ranges from 0 to 255.

outline_blue

The outline_blue parameter specifies the blue component of the ellipse's outline color. The value ranges from 0 to 255.

outline_alpha

The outline_alpha parameter specifies the alpha (transparency) component of the ellipse's outline color. The value ranges from 0.0 (completely transparent) to 1.0 (completely opaque).

fill_red

The fill_red parameter specifies the red component of the ellipse's fill color. The value ranges from 0 to 255.

fill_green

The fill_green parameter specifies the green component of the ellipse's fill color. The value ranges from 0 to 255.

fill_blue

The fill_blue parameter specifies the blue component of the ellipse's fill color. The value ranges from 0 to 255.

fill_alpha

The fill_alpha parameter specifies the alpha (transparency) component of the ellipse's fill color. The value ranges from 0.0 (completely transparent) to 1.0 (completely opaque).

SSAA

The SSAA parameter stands for Supersample Anti-Aliasing. It determines the level of anti-aliasing applied to the ellipse. Higher values result in smoother edges but require more computational resources.

method

The method parameter specifies the resampling method used when resizing the image. Common methods include "nearest", "bilinear", and "bicubic". This affects the quality of the final image.

ImageDrawEllipse Output Parameters:

IMAGE

The IMAGE output parameter is the resulting image with the drawn ellipse. This image is returned as a tensor, which can be further processed or saved. The output image retains the dimensions of the original container but includes the newly drawn ellipse.

ImageDrawEllipse Usage Tips:

• To create a perfectly circular ellipse, ensure that the width and height of the bounding box are equal by setting end_x - start_x equal to end_y - start_y.
• Use higher SSAA values for smoother edges, especially when working with high-resolution images.
• Experiment with different method values to find the best resampling quality for your specific use case.

ImageDrawEllipse Common Errors and Solutions:

"Invalid container dimensions"

• Explanation: The container parameter does not have the expected dimensions.
• Solution: Ensure that the container is a multi-dimensional array with appropriate dimensions for an image.

"Outline or fill color values out of range"

• Explanation: One or more color component values are outside the acceptable range.
• Solution: Verify that all color component values (red, green, blue) are between 0 and 255, and alpha values are between 0.0 and 1.0.

"SSAA value too high"

• Explanation: The SSAA value is set too high, causing excessive computational load.
• Solution: Reduce the SSAA value to a more manageable level to balance quality and performance.