Ztx-based pitch/time modification of an audio buffer Use the stretch~ object to perform destructive pitch and time modifications to the contents of a buffer~. object. Cycling '74 TEXT_HERE bang to start time stretching TEXT_HERE TEXT_HERE timestretch progress information TEXT_HERE bang when done TEXT_HERE Buffer name Specifies the name of the buffer which contains the result of destructive pitch/time modifications. Modify the buffer's contents bang message starts processing to modify the contents of the currently referenced buffer. Modify the buffer's contents same as bang Open a file buffer display window Double-clicking on stretch~ opens a display window where you can view the results of the pitch/time modifications you have made. The contents of the display window are updated when a modification is completed. Cancel the current operation Cancels the currently running operation. Define complex time stretching You can use a dictionary to define more complex stretching and pitch shifting. You define a point in time (sourcetime, sourcetimesample or sourcetimebbu) and define where this point should be transformed to (desttime, desttimesample or desttimebbu). For expample the dictionary below will

• create marker01 which will stretch the file so that the audio at 500 ms will be on the first bar, will pitch-shift the audio down by 100 cents until the next marker
• create marker02 which will stretch so the material at 1000 ms will be at 1.2.0 bbu, will pitch-shift the audio by a factor of 1.1 up until the next marker
• create marker03 which will stretch the whole sample (“end”) to be twice as long

{ "marker01" : { "sourcetime" : "500", "desttimebbu" : "1.0.0", "pitchshiftcent" : -100 } , "marker02" : { "sourcetime" : 1000, "desttime" : 1.2.0, "pitchshift" : 1.1 } , "marker03" : { "sourcetime" : “end”, "desttime" : “*2”, } } Sets the name of the audio buffer referenced by the stretch~ object. The word set, followed by the name of an audio buffer, sets the name of the audio buffer referenced by the stretch~ object. Basic tuning (from A) Sets a tuning standard based on a frequency for A for pitch-correction operations (440 = default, range is 400 - 500) Follow global tempo When followgobaltempo is enabled, stretch~ will calculate the current tempo out of the ratio between originaltempo and the current global tempo. Formant Scale The word formant, followed by floating point value, sets the amount of formant scaling when pitch shifting is performed. Turn on formant correction The word formantcorrection, followed by a zero or one, disables/enables formant correction when pitch correction is performed. Timestretching Mode Sets the timestretching mode to be used. Each mode is optimized for handling different kinds of audio material
Default mode of operation This is the default mode of operation. Monophonic sources (voice, flute) This mode is best for monophonic instruments (e.g. solo voice, flute, etc.) Optimizes for transient preservation This mode is for time stretched percussion. It provides optimal transient preservation. Balance spectral integrity with transient preservaton This mode balances spectral integrity and transient preservation for general cases. Polyphonic sources (piano, guitar) Polyphonic mode is a better choice for instruments such as piano or guitar. Emphasize spectral quality over transient preservation This mode emphasizes spectral quality over transient preservation. For stretch ratios greater than 2.0 This mode is intended for stretch ratios greater 2.0, a more artistic effect is intended. Good CPU performance This mode is intended for a good CPU performance/quality tradeoff. Original Length The original length of the the audio file in beats. Used by followglobaltempo to calculate the speed in relation to the global transport speed. Setting the originallength will calculate the originaltempo. Original Tempo The original tempo of the the audio file. Used by followglobaltempo to calculate the speed in relation to the global transport speed. Setting the originaltempo will calculate the originallength. Enable/disable pitch correction The word pitchcorrection, followed by a zero or one, enable/disables the formant-corrected chromatic intonation correction. For more extensive real-time intonation correction, use the retune~ object. Pitch Shifting Factor Specifies pitchshift as a factor of the original pitch (i.e. 2.0 = doubling of pitch, .5 = halving of the original pitch, etc.). Pitch Shifting in Cents Specify pitchshift as positive or negative cent values (i.e. 100 = semitone up, -1200 = octave down). Cents may be specified as ints or floats. Show Progress Bar Enable/disable progress bar display when calculating pitch/time shifting. Timestretching Quality Choose the quality for the timestretching output.
TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE TEXT_HERE Process audio from original buffer rather than current buffer Process audio from original buffer rather than current buffer when pitch or timestretching is done Slur time Set the time it takes for the correction to reach the full correction amount. Typically, notes are a bit unstable at the beginning, because the attack phase of a sound has a higher amount of noise, and because singers gradually adjust their tuning after the onset of the note. The slur time makes the pitch correction sound natural because it models this effect. Higher values will yield a slower adaptation time and it will take longer for the correction to produce the corrected pitch. However, longer slur times will also preserve vibrato better. Stretch factor Set the timestretching as a factor in relation to the length of the current buffer (e.g. 2.0 = double the length, .5 = half the length, etc.).