CIRCLE - Circle
Plain English
Draws a circle. (x,y) anchors the upper-left corner of the bounding box — not the centre — so the rendered centre lands at (x + diameter/2, y + diameter/2). Per TSPL2 PG §CIRCLE (p41).
When to use
When you need a round outline on the label — logos, status dots, registration marks. For filled circles, set thickness ≥ radius; the renderer fills the shape.
Syntax
CIRCLE x,y,diameter,thickness
Parameters
| Parameter | Description |
|---|---|
x | Upper-left X coordinate of the bounding box in dots (NOT the centre) |
y | Upper-left Y coordinate of the bounding box in dots (NOT the centre) |
diameter | Diameter of the circle in dots |
thickness | Stroke thickness in dots; when ≥ radius the circle fills |
Example
CIRCLE 250,20,100,1
Draw a 100-dot-diameter circle anchored at (250,20) with a 1-dot outline (PG example)