Vortex
A vortex at rotates every point around the centre by an angle that depends on its radius, ; the inverse lookup rotates by . Because a rotation moves every point on a circle to another point on the same circle, the map is exactly area-preserving and can never fold, however large the angle. midi-sink ships two profiles.
Exponential (Jaffer)
Section titled “Exponential (Jaffer)”Shear concentrates near the centre and fades smoothly: diffuse, breath-like agitation. The default for the mod wheel, the Airwave dimensions and wind routing — “wind over the water”.
Rankine (rigid core)
Section titled “Rankine (rigid core)”The core rotates rigidly — zero interior shear, so whatever pattern sits inside spins as a solid disk and survives intact — while all the shear lands in the crease ring at (the kink is intentional) and the fall-off outside. Mechanical, tight: the gesture literally grabs a disk of water and turns it.
Invariants
Section titled “Invariants”- Exact at any angle. A finite rotation never folds, so neither profile is ever sub-stepped. Two passes of equal one pass of .
- Area-preserving by construction.
- Rankine’s interior is exactly zero-shear: a ring cluster inside comes out bitwise as it went in, rotated.
Ownership
Section titled “Ownership”- CC 1 (mod wheel), Airwave CC 20 (Raise) → global vortex strength, exponential profile, through the CC map; CC 21/22 drift its centre.
- Two-finger twist (tablets, Marble mode) and right-drag (desktop) → Rankine, with = half the finger separation and = the twist delta; the settings’ Vortex profile selects which profile the gesture uses.
- Not pen orientation. Every attempt to stir a vortex from stylus tilt or azimuth leaked a phantom vortex (absolute orientation is noisy and has no zero) and was removed — orientation only ever feeds the vibrato booster, as a decaying derivative.
Lineage
Section titled “Lineage”The exponential profile is the vortex of Mathematical Marbling (Lu, Jaffer, Jin, Zhao & Mao, 2012). Rankine’s combined vortex is from his Manual of Applied Mechanics (1858) — see the citations. The soft, viscous sibling of both is the Lamb–Oseen swirl.
midi-sink 2.0.0-rc.5 · AGPL-3.0 · source
