ComfyUI Node: Create Circle Mask

Create Circle Mask:

The CreateCircleMask node is designed to generate a circular mask on a specified canvas size. This node is particularly useful for creating custom circular shapes, including donut-like circles, which can be used in various AI art projects. By leveraging this node, you can easily define the position, size, and type of circles to be drawn on the canvas. The node provides flexibility by allowing you to either use predefined circle parameters or override them with custom settings. This makes it a versatile tool for artists looking to add precise circular elements to their compositions.

Create Circle Mask Input Parameters:

Width

The width of the canvas on which the circles will be drawn. This parameter defines the horizontal dimension of the canvas. The default value is 576, with a minimum value of 16. The width should be set according to the desired size of the output image.

Height

The height of the canvas on which the circles will be drawn. This parameter defines the vertical dimension of the canvas. The default value is 1024, with a minimum value of 16. The height should be set according to the desired size of the output image.

opt_circle

An optional input parameter that allows you to provide custom circle information to override the current settings. This parameter should be connected to a node that supplies circle data, such as the Circle Creator. It is essential to connect at least one optional input (either opt_circle or circles_provider) for the node to function correctly.

circles_provider

Another optional input parameter that connects to a node providing a list of circles, such as the Circles Random Generator. This parameter supplies the circle data to be drawn on the canvas. Similar to opt_circle, it is crucial to connect at least one optional input for the node to work.

Create Circle Mask Output Parameters:

PngImage

This output provides a preview image of the canvas with the drawn circles. It is an RGBA image that visually represents the circles based on the provided or overridden parameters.

Mask

This output is the actual mask generated from the circles drawn on the canvas. The mask is a binary image where the circular areas are highlighted, and it can be used for further processing or as a mask in other nodes.

Debug

This output provides a string containing debug information. It includes details about the number of circles drawn and their specific parameters, which can be useful for troubleshooting and fine-tuning the node's settings.

Create Circle Mask Usage Tips:

• Ensure that you connect at least one optional input (opt_circle or circles_provider) to avoid errors and ensure the node functions correctly.
• Adjust the Width and Height parameters according to the desired size of your output image to get the best results.
• Use the Circle Creator node to provide custom circle parameters if you need precise control over the circle's position, size, and type.
• Utilize the Debug output to understand the parameters being used and to troubleshoot any issues with the circle drawing process.

Create Circle Mask Common Errors and Solutions:

Mira:Connect at least ONE opt node

• Explanation: This error occurs when neither opt_circle nor circles_provider is connected, meaning the node does not have any circle data to work with.
• Solution: Ensure that you connect at least one of the optional inputs (opt_circle or circles_provider) to provide the necessary circle data for the node to function.

Invalid canvas size

• Explanation: This error might occur if the Width or Height parameters are set below the minimum value of 16.
• Solution: Adjust the Width and Height parameters to be at least 16 or higher to ensure a valid canvas size for drawing the circles.