ComfyUI Node
CV Detect Circle Grid
Detects a symmetric or asymmetric circle calibration target (cv2.findCirclesGrid). Pattern size is authored as a CV Size literal, so the same 'CV Size' node can feed this and other calibration detectors. Failure-tolerant: when the grid is not visible it returns found=false and an empty Nx1x2 centers array instead of raising.
CV Detect Circle Grid
- image
- found
- centers
◄pattern_size(4, 11)►
◄flagsCALIB_CB_SYMMETRIC_GRID►
Categoryimage/CV/features
Inputs (3)
| Name | Type | Default | Description |
|---|---|---|---|
| image | NPARRAY,IMAGE | Circle-grid photo or rendered target. It is converted to grayscale internally. Accepts a ComfyUI IMAGE/MASK directly (frame 0 of a batch) or an NPARRAY. Arithmetic ops (add, multiply, etc.) process the full IMAGE batch when both inputs have the same batch size. | |
| pattern_size | STRING | (4, 11) | Number of circle centers per row/column as a Size literal '(cols, rows)'. Use a 'CV Size' node to avoid typing the tuple. |
| flags | STRING | CALIB_CB_SYMMETRIC_GRID | Grid layout plus optional clustering. Symmetric and asymmetric are mutually exclusive; clustering helps with perspective distortion and clutter. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| found | BOOLEAN | — |
| centers | NPARRAY | Detected circle centers as Nx1x2 float32, empty when found=false. |