Section: USER COMMANDS (1)
Updated: Sept 2012
zretune - resample an audio file in order to change its pitch
[options] input-file output-file
resamples an audio file by a the inverse of a ratio expressed in cents,
without changing the nominal sample rate. The result is to change the
musical pitch and lenght of the file. Input can be any audio file
readable by the libsndfile library. The output file type is either
WAV, WAVEX, CAF, AIFF or FLAC.
Display a short help text.
- --cent pitch change in cents
The number of cents by which the pitch is changed. The accepted
range is +/- 1200 cents, the useful range in practice will be
something like +/- 100 cents.
Output file type
Produce a WAV file, or for more than 2 channels, a WAVEX file.
This is the default.
Produce a WAVEX file with the Ambisonic GUID. Such files should
Produce a Core Audio file.
Produce an AIFF file.
Produce a FLAC file.
Output sample format
Output sample format is signed 16-bit. This option also
enables the use of dithering, described below.
Output sample format is 24-bit. This is the default.
Output sample format is 32-bit floating point.
Add white dithering noise with a rectangular distribution. This
is the best option if the output data is going to processed again,
but in that case it would be advisable to use 24-bit or float.
Add filtered noise with a triangular distribution. Compared to the
rectangular dither this reduces the noise density in the lower
This uses the optimal error feedback filter described by
Stanley Lipschitz. This is recommended is the output is the
final distribution format, e.g. for a CD.
Insert zero valued input samples at the start and end so that the output
includes the full symmetric filter response even for the first and last
Zero in case there are no errors, non-zero otherwise.
Fons Adriaensen (fons (at) linuxaudio.org)