ComfyUI Node
CV Draw Labels
Debug helper: writes a text label next to each point. Feed the 'landmarks' + 'keypoint_names' of 'CV MediaPipe Hand Pose' to name every keypoint, or any per-point string/number array. When 'labels' is left unconnected each point is labelled with its own index (0, 1, 2, ...). None/empty points pass the image through unchanged (count=0).
CV Draw Labels
- source
- points
- labels
- image
- count
◄font_scale0.4►
◄color(0, 255, 255)►
◄thickness1►
◄offset_x4►
◄offset_y-4►
◄outlinetrue►
Categoryimage/CV/points
Inputs (9)
| Name | Type | Default | Description |
|---|---|---|---|
| source | COMFY_MATCHTYPE_V3 | Image or mask to draw on (a copy is made). 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. | |
| points | NPARRAY | Nx1x2 points to label (or None -> passthrough). | |
| font_scale | FLOAT | 0.40.1–8 | cv2 text scale; shrink it for dense point sets. |
| color | STRING | (0, 255, 255) | Color as a single value (broadcast to all channels) or BGR tuple, e.g. '255' or '(0, 255, 255)'. Shorter tuples are zero-padded; longer tuples are truncated. |
| thickness | INT | 11–32 | Text stroke width in pixels. |
| labelsopt | NPARRAY | (N,) ARRAY of strings or numbers, one per point - not a comma-separated string. Type them with 'CV Text To Array' (one per line), or wire an array that already exists: a QR/barcode detector's 'texts', 'CV Load Labels'.labels_array, a classifier's 'labels_out', or any numeric array via 'CV Numbers To Array'. Leave it unwired to caption each point with its INDEX, which is also what a point whose position is NaN keeps - blanked points are skipped without renumbering the rest. | |
| offset_xopt | INT | 4-4096–4096 | Horizontal pixel offset of the text from its point. |
| offset_yopt | INT | -4-4096–4096 | Vertical pixel offset of the text from its point. |
| outlineopt | BOOLEAN | true | Draw a contrasting halo behind each label (black behind a light 'color', white behind a dark one). These labels land on whatever the image happens to show, so a single flat colour at font_scale 0.4 is often unreadable without it. |
Outputs (2)
| Name | Type | Description |
|---|---|---|
| image | COMFY_MATCHTYPE_V3 | Same format as the image input. |
| count | INT | How many labels were drawn. |