Nodes

  1. Home
  2. Docs
  3. Nodes
  4. Audio Effects
  5. Pitch Shift Node

Pitch Shift Node

Applies a pitch change to the connected audio signal and outputs the result.

Note: this is an experimental Node, and its functionality may change. It may also cause glitching and high CPU use on some systems currently.

Inputs

AudioThe audio input to which the effect is applied.
Pitch ChangeControl input to automate the pitch change, in semitones, from -12 to +12 (supports non-integer values to apply a detune). This input can be toggled from node properties.

Settings

SemitonesPitch change in whole semitones, positive values increase pitch, negative values decrease pitch.
CentsAdditional pitch change in cents, positive values detune pitch upwards, negative values detune pitch downwards.
QualityFFT size, higher values increase harmonic quality, but result in more CPU use and latency (and may cause artifacts with percussive inputs).

Outputs

AudioThe Audio line with the pitch change applied.

Audio and Control lines (visualized with blue and orange, respectively) are both analogous to an analog signal. They can be used interchangeably, and, for example, an Audio output (blue) can be connected to a Control input (orange), or vice-versa.

Technical details

This Node uses a phase-vocoder algorithm (with identity phase-locking to reduce phasing and smearing artifacts). This is an expensive effect and incurs some processing latency, especially with a high Quality setting (meaning a high FFT size for the effect).

Depending on the input signal, you may need to experiment with different settings to achieve good results. Higher Quality settings often yield better results at maintaining harmonic relations, while medium/lower Quality settings reduce latency and processing cost (and may yield sharper results with percussive sources).

The Semitones and Cents settings are added together to form the actual pitch change, and are only shown as separate sliders for convenience. When Semitones automation is enabled, the Cents setting is disabled and hidden, because the automation input alone is responsible for controlling the pitch change.

Was this article helpful to you? Yes No