segment

A straight line between two points: segment(start: (0, 0); end: (2, 1)). start is the implicit attribute. Unlike a line, it stops at its endpoints rather than running on to the frame.

segmentNode
Two line segments, one rising from the origin and one grey segment falling across it.Two line segments, one rising from the origin and one grey segment falling across it.

A segment takes ticks, the congruence hatches across its middle: two sides marked ticks: 1 are the same length, which is how a construction says so — the notation an angle already has in arcs. Like every outline it takes dashed, for the line that is not there: where a side was before it moved, or a construction that explains the drawing without being part of it.

#Attributes

startRequiredImplicitAnimatable
One endpoint, as a coordinate: start: (2, 1). Animatable as a whole, so !cue.to{(4, 3)} moves the end in a straight line.
parametised-coordinate-list
Also written: fromCan be written as shorthand: segment:value
endRequiredAnimatable
The other endpoint, e.g. end: (6, 9).
parametised-coordinate-list
Also written: to
colourAnimatable
Colour.
bluelight-bluedark-blueredlight-reddark-redorangelight-orangedark-orangeyellowlight-yellowdark-yellowteallight-tealdark-tealgreenlight-greendark-greenpinklight-pinkdark-pinkpurplelight-purpledark-purplegreylight-greydark-greyneutralhex(…)rgb(…)
Also written: color
Defaultgrey
widthAnimatable
Stroke width.
number
Default2
opacityAnimatable
Opacity.
number
Default1
dashedAnimatable
Dashed stroke.
boolean
Defaultfalse
ticksAnimatable
Congruence hatches across the middle of the segment: one tick, two, three. Two sides carrying the same number of ticks are the same length, which is how a construction says so — the notation angle's arcs already has for angles. A count rather than a flag, because the second pair in a figure needs a second mark.
number
Default0
label
Text drawn beside the element — rich text, so $maths$ and inline formatting render. Fades and draws with the element.
rich-text
hiddenAnimatable
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.
boolean
Defaultfalse
lock
Keeps the reader from editing this element on an editable: graph. Nothing at all on a graph that is not editable.
boolean
Also written: locked
Defaultfalse
text-sizeAnimatable
Text size.
number
Default20
layerAnimatable
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.
parametised-number

#Allowed in

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

#Examples

A line segment from the origin to (2, 1).A line segment from the origin to (2, 1).
canvas.graph{
    segment(start: (0, 0); end: (2, 1))
}(
    x-domain: [-1, 3]
    y-domain: [-1, 2]
)
A grey line segment falling from (−2, 1) to (1, −1).A grey line segment falling from (−2, 1) to (1, −1).
canvas.graph{
    segment(start: (-2, 1); end: (1, -1); colour: grey)
}(
    x-domain: [-3, 2]
    y-domain: [-2, 2]
)

Last updated