Transpose

Shift note numbers by semitones and octaves, clamped to the MIDI range.

MIDI
Since 0.2.0
midi
transpose
pitch
octave

Transpose as the Patch draws it, at default values: inlets on the left, outlets on the right.

Transpose shifts note numbers by semitones and octaves, clamped to the MIDI range.

What it does#

Every note is moved by Semitones plus twelve times Octaves. Results are clamped to the MIDI range of 0 to 127 instead of wrapping. Notes are shifted on both note-on and note-off so they release correctly. Other messages are unchanged.

When to use it#

Use it to move a keyboard into a comfortable range, to transpose a live controller without changing its settings, or to stack with a second copy for fifths and octaves.

Ports#

Port	Direction	Signal	Lanes
`midi`	Input	MIDI	16 MIDI channels
`midi`	Output	MIDI	16 MIDI channels

Parameters#

Parameter	Label	Range	Default	Unit	Scale	Notes
`semitones`	Semitones	-48 to 48	0	st	linear	Semitone shift applied to every note.
`octaves`	Octaves	-4 to 4	0	oct	linear	Octave shift added to the semitones.

Semitones (`semitones`)#

The shift in semitones, -48 to 48.

Octaves (`octaves`)#

An extra shift in octaves, -4 to 4, added to the semitones.

Tips#

Twelve semitones equals one octave; use whichever is clearer.
Heavy downward shifts can push notes past the bottom of the range, where they clamp at 0.

Help patches

Each help patch is an ordinary Toy that teaches one idea. The diagram shows the Patch; the preview shows its Frame. Open it in TuneToys to play and edit it.

1. Shift the keyboard by semitones and octaves

beginner Teaches: semitones, octaves

Keyboard notes are transposed before they reach the instrument.

Patch: Keyboard midi output connected to Transpose midi input. Transpose midi output connected to Polyphonic instrument midi input. Polyphonic instrument audio output connected to Patch outputs audio input.

Connections as text

Keyboard midi output connected to Transpose midi input
Transpose midi output connected to Polyphonic instrument midi input
Polyphonic instrument audio output connected to Patch outputs audio input

Semitones and Octaves add together.
Play a key while moving the knobs to hear the same key sound higher or lower.

Frame preview (static). Controls show their default values.

Open in TuneToys

Velocity Scale, offset, floor or fix note-on velocities.
MIDI channel Pass every channel, keep one channel, or move everything onto one channel.
Polyphonic instrument Eight owned, velocity-sensitive oscillator voices with ADSR, sustain and MPE, played from a MIDI cable in the Toy's tuning.