circle
A circle centred at a position on a graph.


#Attributes
On any plane
radiusRadius, in data units.
Default
1colourColour.
paintAlso written:
colorDefault
purplefill-styleHow the inside is filled:
solid; hatched, ruled with diagonal lines over a pale wash of the colour; dotted, stippled with dots over the wash; or outlined, no fill, the edge alone.solidhatcheddottedoutlinedDefault
solidstroke-styleHow the edge is drawn:
solid, dashed or dotted. An outlined, dashed shape is the shape that is not there — where a figure was before it moved, a region a constraint rules out.soliddasheddottedDefault
solidopacityOpacity.
Default
1labelText drawn beside the element — rich text, so
$maths$ and inline formatting render. Fades and draws with the element.hiddenDeclared but not drawn. Animatable —
hidden: true !cue.to{false}(at: 2) reveals it — and unlike a cue, a hidden element still frames the plot, so the axes do not jump when it appears.Default
falselockKeeps the reader from editing this element on an
editable: graph. Nothing at all on a graph that is not editable.Also written:
lockedDefault
falsetext-sizeText size.
Default
20layerPaint order among the marks: a higher layer is drawn later, on top; equal or omitted, the marks stack in document order, later on top.
groupThe groups this mark belongs to, comma-separated:
group: Early sown, Projected. It is drawn in the colour of the first that has one and the style of the first the graph's key: gives one, unless it writes its own colour: or style, and the footer's key names every group.Only with
xyplanexX coordinate.
Can be written as shorthand:
circle:valueyY coordinate.
Only with
argandplanezOn the argand plane, the position as one complex number — a complex expression:
3 + 2i, (3 + 2i)^2, sqrt(13) * e^(i * a), with i the unit and parameters read as complex. Instead of re/im.reOn the argand plane, the real part of the position, a number; with
im. z: gives both at once.imOn the argand plane, the imaginary part of the position, a number; with
re. z: gives both at once.Only with
polarplanerOn the polar plane, the distance from the origin; with
theta.thetaOn the polar plane, the angle anticlockwise from the right, in radians —
60deg writes it in degrees; with r. On a categorical theta (theta format:), a name.#Derived attributes
Computed while the element renders — read one with #id.name in attribute position or {{#id.name}} in prose, never set.
areaThe shape's area in square data units, with
radius: as its radius; on the ordinary, argand and polar planes, and a dash where an axis is a log scale, names or dates, or radius: does not resolve.perimeterThe length of the shape's outline in data units, with
radius: as its radius; a dash where area is.#Allowed in
#Examples


graph{
circle(x: 0; y: 0; radius: 2)
}

graph{
circle(x: 2; y: 1; radius: 1.5; fill-style: outlined; colour: purple)
}#Notes
- One of seven shape marks —
circle,square,rectangle,triangle,star,diamond,hexagon— that differ only in the outline drawn.