The [curve] table
A parametric_curve preset picks its figure with one line:
system = "parametric_curve"
[curve]family = "superformula" # one of the five below; any other name is a load errorfamily is read once, at load, and is not bindable — the params animate the
figure, they do not choose it. A preset with no [curve] table draws the Maurer
rose.
The five families share one parameter surface, following
ADR-0180:
n, d and phase mean something different on each, and five further levers
are read by one family only and do nothing on the rest.
family | The figure | n | d | phase | Its own levers |
|---|---|---|---|---|---|
maurer_rose | r = sin(n θ + phase) + radial_offset, walked at a fixed step | petal frequency | the step between samples, in degrees | added inside the sine, in radians | radial_offset |
lissajous | x = sin(n t + phase), y = sin(d t) | x frequency | y frequency | offset between the axes, as a fraction of a turn | none |
hypotrochoid | a circle rolling inside the fixed one (outside, for a negative n), traced by a pen | signed radius ratio: positive rolls inside, negative draws the epicycloid | cusps walked | where the pen starts on the rolling circle, as a fraction of a turn | pen |
superformula | Gielis’ r = (|cos(m θ/4)|^n2 + |sin(m θ/4)|^n3)^(-1/n1) | inert | skew between the lobe exponents, n3 = lobe * d | inert | sym (m), sharpness (n1), lobe (n2) |
harmonograph | the Lissajous figure damped by exp(-decay t) over four turns, spiralling inward | x frequency | y frequency | offset between the axes, as a fraction of a turn | decay |
Three things about the table are worth saying out loud:
- Bind
nanddon every family but the rose. Their defaults,6and71, are the rose’s, and they read as face values elsewhere: an unbound Lissajous is a 6:71 figure, and an unbound superformula takesd = 71as its maximum skew. - Whole numbers close the figure. A Lissajous with whole
nandd, a harmonograph with those anddecay = 0, a hypotrochoid whosed / |n|is whole, and a superformula withd = 1or an evensymall come back to their start and are drawn as one unbroken loop. Anything else is an open trace, and it morphs continuously as an expression sweeps it. - The four new families are drawn as smooth arcs, not chords. The rose keeps its chord web at a
large step. The harmonograph falls back to chords only when a hard
decayhas collapsed its inner turns below what the fit can resolve.
The range that reads for each of these parameters on each family is printed in the
parametric_curve table of Parameter roster, which also marks every
family a parameter is inert on.
Built from 13c7582 at version 0.158.0. This site tracks main and is not versioned per release.