6.2. Signal kinds and units

Signal kind describes what a cable carries; unit and range describe its numerical meaning. See Read what a cable carries for the practical checks.

6.2.1. Socket shapes and colours

Each socket's shape and colour show its kind. The names beside these icons name the signals they carry. On the canvas, pause the pointer on a socket. Help opens as a tooltip beside the pointer and shows the socket's signal.

Audio socket: filled circleAudioFull-band audio signal
Control socket: filled circleControlNormalized control/CV signal for parameter modulation
String socket: tall rectangleStringString-backed enum value
Gate socket: filled circleGateGate signal (0/1)
Clock socket: diamondClockMusical phase clock signal
Time Signature socket: diamondTime SignatureMusical meter carried as numerator and denominator
Trigger socket: filled circleTriggerTrigger pulse
MIDI socket: diamondMIDIMIDI note/CC data
Scale socket: diamondScaleMusical key and scale selection
Number socket: filled circleNumberControl/parameter value
Event socket: filled circleEventDiscrete pulse/clock/gate
Sequence socket: diamondSequenceTimed step sequence with values and durations
Boolean socket: hollow circleBooleanBoolean/toggle
Buffer Audio socket: filled circleBuffer AudioAudio buffer
Buffer FFT socket: filled circleBuffer FFTFFT buffer
Unknown socket: hollow circleUnknownUnconnected wildcard input; adopts the connected signal type

6.2.2. Signal type reference

Every signal kind that can flow between sockets, with its normalised range and unit hint. This table comes from the same vocabulary as the editor's socket details.

Name Range Meaning
Audio -1 to 1 Full-band audio signal
Control 0 to 1 normalized Normalized control/CV signal for parameter modulation
String catalog-defined String-backed enum value
Gate 0 or 1 Gate signal (0/1)
Clock beats from clock origin Musical phase clock signal
Time Signature positive numerator / power-of-two denominator Musical meter carried as numerator and denominator
Trigger 0 or 1 Trigger pulse
MIDI 0-127 MIDI note/CC data
Scale catalog-defined Musical key and scale selection
Number 0-1 (unipolar) Control/parameter value
Event 0 or 1 Discrete pulse/clock/gate
Sequence varies Timed step sequence with values and durations
Boolean true/false Boolean/toggle
Buffer Audio n samples Audio buffer
Buffer FFT spectrum FFT buffer
Unknown varies Unconnected wildcard input; adopts the connected signal type

Units

Control signals share one kind but carry different meanings depending on their unit:

HertzFrequency in cycles per second
KilohertzFrequency in thousands of cycles per second
CentsPitch offset — 100 cents per semitone
SemitonesPitch offset in semitone steps
OctavesPitch offset in octaves
MIDI NoteMIDI note number (0–127, 69 = A4)
MIDI VelocityMIDI note velocity (0–127)
MIDI ChannelMIDI channel number (0 = All, 1–16 = one channel)
MIDI CCMIDI continuous-controller value (0–127)
Volts per OctavePitch CV — one unit per octave
BPMTempo in beats per minute
BeatsMusical position or offset measured in quarter-note beats
MillisecondsTime in thousandths of a second
SecondsTime in seconds
SamplesTime in audio samples
DecibelsLevel in decibels
NormalizedUnitless value in a shared normalized range
Gain (0–1)Linear level from 0 (silent) to 1 (unity)
Phase (0–1)Normalized phase across one cycle
PanStereo position from left (−1) to right (+1)
DegreesAngle in degrees
QFilter resonance / quality factor
RatioDimensionless ratio between two quantities
PercentProportion expressed from 0 to 100
Mix (0–1)Dry/wet blend from 0 (dry) to 1 (wet)
BitsResolution in bits
Grains per SecondGranular density in grains per second
CountInteger count of discrete items
DivisionMusical time division (e.g. 1/4, 1/8)

6.2.3. Conversion reference

How Throughline treats mismatched sockets

Each input declares how it accepts other kinds. A connection is one of:

  • Direct: the kinds already match.
  • Implicit: Throughline converts the signal on the cable. MIDI into a control, gate or trigger input works this way.
  • Risky: allowed with a warning badge, because the conversion can lose meaning.
  • Forbidden: refused.

Implicit pitch and control conversions happen on the cable, so a direct connection can do the job. Add a conversion node when you want the conversion visible, reusable or shared by two or more destinations:

To do this Use
Turn MIDI into pitch, gate, velocity, bend MIDI Decode
Read a MIDI controller as a 0–1 value CC Extractor
Switch between Note, Hz and V/Oct pitch Convert
Turn pitch and gate back into MIDI MIDI Encode
Move a signal into another range Map Range, Clamp
Turn a continuous signal into a gate or event Compare
Scale an audio level Gain, VCA

MIDI Input into a CC Extractor, mapped through Map Range into an Oscillator’s Pitch.

A MIDI controller made audible: CC Extractor reads the controller as 0–1, and Map Range turns it into a pitch range.

Normalised ranges

A normalised range is a shared expected range, not a safety limit. Audio uses a −1 to +1 range by convention, and modulation uses a 0 to 1 or −1 to +1 range. A normalised signal still clips if you amplify it, and Mix adds signals without limiting the result.

Named modes

Mode settings take named values instead of numbers, such as Oscillator Waveform and Filter Filter Type. Choose them on the node. Numbers and control signals do not convert into named modes.

Gates and triggers

A gate is a held on/off state, such as a held key. A trigger is a one-moment event, such as the Trigger output of MIDI Decode or the Reset input of a Clock. Use a gate for anything that lasts and a trigger for anything that happens once.