polygon

polygonNode

A closed shape whose outline is its x: and y: vertex series, paired by position. The named shapes take a position and a size; a polygon takes its outline directly.

Only withxyargandpolarplane

#Attributes

On any plane

period
reference
Also written: atLong-format data: one row per x per period, this naming the period column, sliced at the environment's parameter.time.
fillAnimatable
boolean
Also written: filledFill polygon.
Defaulttrue
colourAnimatable
neutralredorangeyellowgreentealbluepurplepinkgreywhiteblack
Also written: colorColour.
Defaultteal
opacityAnimatable
number
Opacity.
Default1
dashedAnimatable
boolean
Draws the outline dashed. What it is for is the shape that is not there: where a figure was before it moved, a region a constraint rules out, a construction that explains the drawing without being part of it.
Defaultfalse
interpolateAnimatable
linearbezier
Also written: interpolationHow the outline gets from one vertex to the next: linear for straight sides, bezier for a closed round outline, on the same midpoint handles as the line’s. No step — a staircase is a reading against x, and a closed outline is not one.
Defaultlinear
label
rich-text
Text drawn beside the element — rich text, so $maths$ and inline formatting render. Fades and draws with the element.
hiddenAnimatable
boolean
Declared 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.
Defaultfalse
lock
boolean
Also written: lockedKeeps the reader from editing this element on an editable: graph. Nothing at all on a graph that is not editable.
Defaultfalse
text-sizeAnimatable
number
Text size.
Default20
layerAnimatable
parametised-number
Paint order among the marks: a higher layer is drawn later, on top; equal or omitted, the marks stack in document order (later on top). Written z: before the argand plane took that letter for its coordinate.
Only withxyplane
xImplicitAnimatable
series
The vertices' x coordinates, e.g. 0, 2, 1. Numbers or a dataset column; entries may be expressions of parameters.Can be written as shorthand: polygon:value
yAnimatable
series
The vertices' y coordinates, paired with x by position.
Only withargandplane
zAnimatable
complex-series
On the argand plane, the readings as complex numbers: written out (1 + i, 2 - i, -3i, a bare number a real), or a column of complex literals bound whole (#roots.z). Instead of re/im.
reAnimatable
series
On the argand plane, the readings' real parts, one per reading — numbers written out or a column — paired with im by position.
imAnimatable
series
On the argand plane, the readings' imaginary parts, paired with re by position.
Only withpolarplane
rAnimatable
series
On the polar plane, the readings' distances from the origin, paired with theta by position.
thetaAnimatable
series
On the polar plane, the readings' angles in radians (60deg for degrees), paired with r by position; names on a categorical theta.

#Allowed in

canvas.graph { }cue { }cue.draw { }cue.trace { }cue.highlight { }cue.spotlight { }

#Examples

polygon(x: 0, 2, 1; y: 0, 0, 2)
polygon(x: -1, 1, 0; y: -1, -1, 1; fill: false; colour: teal)