Skip to main content

retune​

retune(
    @pitchgrid 0
    @threshold 0
    @ambiencethreshold 0.3
    @amount 100
    @bypass 100
    @quality 'basic'
) -> llll

Generates an audio process operation for applying autotune-like pitch retuning to a buffer.

Arguments​

  • @pitchgrid [int/float/list]: pitch grid to retune to, as a list of pitch classes. (default: 0).
  • @threshold [int/float]: correction threshold. (default: 0).
  • @ambiencethreshold [int/float]: correction ambience threshold, between -10 and 10. (default: 0.3).
  • @amount [int/float]: pitch correction amount. (default: 100).
  • @bypass [int/float]: pitch correction auto-bypass threshold, at which signal passes unaffected. (default: 100).
  • @quality [symbol]: pitch correction quality. (default: 'basic').
    • 'basic'
    • 'good'
    • 'better'
    • 'best'

Output​

retune operation [llll]

Usage​

retune is meant to be used with the process function:

$buffer = importaudio('singing.wav'); ## input buffer
$op = retune(); ## processing operation
$buffer = $buffer.process($op); ## apply processing
$buffer.inspect('after retune process')