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.
|Audio||The audio input to which the effect is applied.|
|Pitch Change||Control 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.|
|Semitones||Pitch change in whole semitones, positive values increase pitch, negative values decrease pitch.|
|Cents||Additional pitch change in cents, positive values detune pitch upwards, negative values detune pitch downwards.|
|Quality||FFT size, higher values increase harmonic quality, but result in more CPU use and latency (and may cause artifacts with percussive inputs).|
|Audio||The 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.
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.