ref: e11ca5c9083abd9f9aa60999d5548f6f345e54fd
parent: 9b1f7f515d0173a16a263f2d16a0b3a541530177
author: evilynux <evilynux>
date: Sat Oct 10 11:19:59 EDT 2009
Plenty of hyphen explicitely converted to minus to make groff happy.
--- a/libsox.3
+++ b/libsox.3
@@ -358,7 +358,7 @@
link with the correct linker flags. See the libtool manual for
details; basically, you use it as:
.EX
- libtool --mode=link gcc -o prog /path/to/libsox.la
+ libtool \-\-mode=link gcc \-o prog /path/to/libsox.la
.EE
.SH BUGS
This manual page is both incomplete and out of date.
--- a/sox.1
+++ b/sox.1
@@ -97,13 +97,13 @@
.EE
translates an audio file in Sun AU format to a Microsoft WAV file, whilst
.EX
- sox recital.au -b 16 recital.wav channels 1 rate 16k fade 3 norm
+ sox recital.au \-b 16 recital.wav channels 1 rate 16k fade 3 norm
.EE
performs the same format translation, but also applies four effects
(down-mix to one channel, sample rate change, fade-in, nomalize),
and stores the result at a bit-depth of 16.
.EX
- sox -r 16k -e signed -b 8 -c 1 voice-memo.raw voice-memo.wav
+ sox \-r 16k \-e signed \-b 8 \-c 1 voice-memo.raw voice-memo.wav
.EE
converts `raw' (a.k.a. `headerless') audio to a self-describing file format,
.EX
@@ -115,7 +115,7 @@
.EE
concatenates two audio files, and
.EX
- sox -m music.mp3 voice.wav mixed.flac
+ sox \-m music.mp3 voice.wav mixed.flac
.EE
mixes together two audio files.
.EX
@@ -123,22 +123,22 @@
.EE
plays a collection of audio files whilst applying a bass boosting effect,
.EX
- play -n -c1 synth sin %-12 sin %-9 sin %-5 sin %-2 fade h 0.1 1 0.1
+ play \-n \-c1 synth sin %\-12 sin %\-9 sin %\-5 sin %\-2 fade h 0.1 1 0.1
.EE
plays a synthesised `A minor seventh' chord with a pipe-organ sound,
.EX
- rec -c 2 radio.aiff trim 0 30:00
+ rec \-c 2 radio.aiff trim 0 30:00
.EE
records half an hour of stereo audio, and
.EX
- play -q take1.aiff & rec -M take1.aiff take1-dub.aiff
+ play \-q take1.aiff & rec \-M take1.aiff take1-dub.aiff
.EE
(with POSIX shell and where supported by hardware)
records a new track in a multi-track recording. Finally,
.EX
.ne 3
- rec -r 44100 -b 16 -s -p silence 1 0.50 0.1% 1 10:00 0.1% | \\
- sox -p song.ogg silence 1 0.50 0.1% 1 2.0 0.1% : \\
+ rec \-r 44100 \-b 16 \-s \-p silence 1 0.50 0.1% 1 10:00 0.1% | \\
+ sox \-p song.ogg silence 1 0.50 0.1% 1 2.0 0.1% : \\
newfile : restart
.EE
records a stream of audio such as LP/cassette and splits in to multiple
@@ -258,11 +258,11 @@
.EE
These two commands are functionally equivalent to
.EX
- sox existing-file.wav -d
+ sox existing-file.wav \-d
.EE
and
.EX
- sox -d new-file.wav
+ sox \-d new-file.wav
.EE
Of course, further options and effects (as described below) can be
added to the commands in either form.
@@ -293,13 +293,13 @@
.EX
set AUDIODEV=/dev/dsp2
play ...
- sox ... -t oss
+ sox ... \-t oss
.EE
or
.EX
set AUDIODEV=hw:soundwave,1,2
play ...
- sox ... -t alsa
+ sox ... \-t alsa
.EE
Note that the way of setting environment variables varies from system
to system\*mfor some specific examples, see `SOX_OPTS' below.
@@ -312,7 +312,7 @@
can be changed if desired, by explicitly specifying the \fBrate\fR
effect with a different quality level, e.g.
.EX
- play ... rate -m
+ play ... rate \-m
.EE
or by using the
.B \-\-play\-rate\-arg
@@ -333,7 +333,7 @@
To help with setting a suitable recording level, SoX includes a peak-level
meter which can be invoked (before making the actual recording) as follows:
.EX
- rec -n
+ rec \-n
.EE
The recording level should be adjusted (using the system-provided mixer
program, not SoX) so that the meter is \fIat most occasionally\fR full
@@ -459,7 +459,7 @@
.B vol
effect can be used to prevent clipping, e.g.
.EX
- sox dull.wav bright.wav gain -6 treble +6
+ sox dull.wav bright.wav gain \-6 treble +6
.EE
guarantees that the treble boost will not clip.
.SP
@@ -651,7 +651,7 @@
standard output, then the following command makes a stereo file
from two generated signals:
.EX
- sox -M "|genw --imd -" "|genw --thd -" out.wav
+ sox \-M "|genw \-\-imd \-" "|genw \-\-thd \-" out.wav
.EE
For headerless (raw) audio,
.B \-t
@@ -664,16 +664,16 @@
applied to a group of files. For example, if the current directory contains
three `vox' files: file1.vox, file2.vox, and file3.vox, then
.EX
- play --rate 6k *.vox
+ play \-\-rate 6k *.vox
.EE
will be expanded by the `shell' (in most environments) to
.EX
- play --rate 6k file1.vox file2.vox file3.vox
+ play \-\-rate 6k file1.vox file2.vox file3.vox
.EE
which will treat only the first vox file as having a sample rate of 6k; but
with
.EX
- play --rate 6k "*.vox"
+ play \-\-rate 6k "*.vox"
.EE
the given sample rate option will be applied to all three vox files.
.TP
@@ -682,7 +682,7 @@
the SoX command should be used as in input pipe to another SoX command.
For example, the command:
.EX
- play "|sox -n -p synth 2" "|sox -n -p synth 2 tremolo 10" stat
+ play "|sox \-n \-p synth 2" "|sox \-n \-p synth 2 tremolo 10" stat
.EE
plays two `files' in succession, each with different effects.
.SP
@@ -734,7 +734,7 @@
SoX's global options.
For example:
.EX
- SOX_OPTS="--buffer 20000 --play-rate-arg -hs --temp /mnt/temp"
+ SOX_OPTS="\-\-buffer 20000 \-\-play-rate-arg \-hs \-\-temp /mnt/temp"
.EE
Note that setting SOX_OPTS can potentially create unwanted changes in
the behaviour of scripts or other programs that invoke SoX. So SOX_OPTS
@@ -750,9 +750,9 @@
alternative approach is to explicitly invoke SoX with default
option values, e.g.
.EX
- SOX_OPTS="-V --no-clobber"
+ SOX_OPTS="\-V \-\-no-clobber"
...
- sox -V2 --clobber $input $output ...
+ sox \-V2 \-\-clobber $input $output ...
.EE
Note that the way of setting environment variables varies from system
to system\*mhere are some examples:
@@ -759,15 +759,15 @@
.SP
Unix bash:
.EX
- export SOX_OPTS="-V --no-clobber"
+ export SOX_OPTS="\-V \-\-no-clobber"
.EE
Unix csh:
.EX
- setenv SOX_OPTS "-V --no-clobber"
+ setenv SOX_OPTS "\-V \-\-no-clobber"
.EE
MS-DOS/MS-Windows:
.EX
- set SOX_OPTS=-V --no-clobber
+ set SOX_OPTS=\-V \-\-no-clobber
.EE
MS-Windows GUI: via Control Panel : System : Advanced : Environment
Variables
@@ -815,11 +815,11 @@
.B gain
effect to guard against clipping. E.g.
.EX
- sox -G infile -b 16 outfile rate 44100 dither -s
+ sox \-G infile \-b 16 outfile rate 44100 dither \-s
.EE
is shorthand for
.EX
- sox infile -b 16 outfile gain -h rate 44100 gain -rh dither -s
+ sox infile \-b 16 outfile gain \-h rate 44100 gain \-rh dither \-s
.EE
See also
.BR \-V,
@@ -895,11 +895,11 @@
.B gain
effect to guard against clipping, and to normalise the audio. E.g.
.EX
- sox --norm infile -b 16 outfile rate 44100 dither -s
+ sox \-\-norm infile \-b 16 outfile rate 44100 dither \-s
.EE
is shorthand for
.EX
- sox infile -b 16 outfile gain -h rate 44100 gain -nh dither -s
+ sox infile \-b 16 outfile gain \-h rate 44100 gain \-nh dither \-s
.EE
See also
.BR \-V,
@@ -926,7 +926,7 @@
SoX will output commands to plot the effect's transfer function, and
then exit without actually processing any audio. E.g.
.EX
- sox --plot octave input-file -n highpass 1320 > highpass.plt
+ sox \-\-plot octave input-file \-n highpass 1320 > highpass.plt
octave highpass.plt
.EE
.TP
@@ -1078,7 +1078,7 @@
SoX of the number of bits per sample in a `raw' (`headerless') audio
file. For example
.EX
- sox -r 16k -e signed -b 8 input.raw output.wav
+ sox \-r 16k \-e signed \-b 8 input.raw output.wav
.EE
converts a particular `raw' file to a self-describing `WAV' file.
.SP
@@ -1089,7 +1089,7 @@
by the output file type) be set to the input encoding size. For
example
.EX
- sox input.cdda -b 24 output.wav
+ sox input.cdda \-b 24 output.wav
.EE
converts raw CD digital audio (16-bit, signed-integer) to a
24-bit (signed-integer) `WAV' file.
@@ -1110,11 +1110,11 @@
header\*mnote that this is only supported with certain file types.
Examples:
.EX
- sox -r 48k -e float -b 32 -c 2 input.raw output.wav
+ sox \-r 48k \-e float \-b 32 \-c 2 input.raw output.wav
.EE
converts a particular `raw' file to a self-describing `WAV' file.
.EX
- play -c 1 music.wav
+ play \-c 1 music.wav
.EE
interprets the file data as belonging to a single channel regardless
of what is indicated in the file header. Note that if the file does
@@ -1129,8 +1129,8 @@
example, the following two commands are equivalent:
.EX
.ne 2
- sox input.wav -c 1 output.wav bass -3
- sox input.wav output.wav bass -3 channels 1
+ sox input.wav \-c 1 output.wav bass \-3
+ sox input.wav output.wav bass \-3 channels 1
.EE
though the second form is more flexible as it allows the effects to
be ordered arbitrarily.
@@ -1143,7 +1143,7 @@
.RS
.IP \fBsigned-integer\fR
PCM data stored as signed (`two's complement') integers. Commonly used
-with a 16 or 24 -bit encoding size.
+with a 16 or 24 \-bit encoding size.
A value of 0 represents minimum signal power.
.IP \fBunsigned-integer\fR
PCM data stored as signed (`two's complement') integers. Commonly used
@@ -1202,9 +1202,9 @@
.BR \-b )
to set the output encoding type For example
.EX
- sox input.cdda -e float output1.wav
+ sox input.cdda \-e float output1.wav
- sox input.cdda -b 64 -e float output2.wav
+ sox input.cdda \-b 64 \-e float output2.wav
.EE
convert raw CD digital audio (16-bit, signed-integer) to
floating-point `WAV' files (single & double precision respectively).
@@ -1225,7 +1225,7 @@
performed by SoX on the following filename. For example, if the current
directory contains the two files `five-seconds.wav' and `five*.wav', then
.EX
- play --no-glob "five*.wav"
+ play \-\-no-glob "five*.wav"
.EE
can be used to play just the single file `five*.wav'.
.TP
@@ -1245,7 +1245,7 @@
For example, if audio was recorded with a sample-rate of say 48k from
a source that played back a little, say 1\*d5%, too slowly, then
.EX
- sox -r 48720 input.wav output.wav
+ sox \-r 48720 input.wav output.wav
.EE
effectively corrects the speed by changing only the file header (but see
also the
@@ -1260,8 +1260,8 @@
following two commands are equivalent:
.EX
.ne 2
- sox input.wav -r 48k output.wav bass -3
- sox input.wav output.wav bass -3 rate 48k
+ sox input.wav \-r 48k output.wav bass \-3
+ sox input.wav output.wav bass \-3 rate 48k
.EE
though the second form is more flexible as it allows
.B rate
@@ -1273,9 +1273,9 @@
audio file (e.g. raw, mp3) where the actual/desired type cannot be
determined from a given filename extension. For example:
.EX
- another-command | sox -t mp3 - output.wav
+ another-command | sox \-t mp3 \- output.wav
- sox input.wav -t raw output.bin
+ sox input.wav \-t raw output.bin
.EE
It can also be used to override the type implied by an input filename
extension, but if overriding with a type that has a header, SoX will
@@ -1310,11 +1310,11 @@
bit ordering) of the input file is not automatically used for the output
file; so, for example, when the following is run on a little-endian system:
.EX
- sox -B audio.s16 trimmed.s16 trim 2
+ sox \-B audio.s16 trimmed.s16 trim 2
.EE
trimmed.s16 will be created as little-endian;
.EX
- sox -B audio.s16 -B trimmed.s16 trim 2
+ sox \-B audio.s16 \-B trimmed.s16 trim 2
.EE
must be used to preserve big-endianness in the output file.
.SP
@@ -1603,8 +1603,8 @@
four different notes in total:
.EX
.ne 2
- play -n synth 2.5 sin 667 gain 1 \\
- bend .35,180,.25 .15,740,.53 0,-520,.3
+ play \-n synth 2.5 sin 667 gain 1 \\
+ bend .35,180,.25 .15,740,.53 0,\-520,.3
.EE
Note that the clipping that is produced in this example is deliberate;
to remove it, use
@@ -1634,8 +1634,8 @@
equivalent:
.EX
.ne 2
- sox input.wav -c 1 output.wav bass -3
- sox input.wav output.wav bass -3 channels 1
+ sox input.wav \-c 1 output.wav bass \-3
+ sox input.wav output.wav bass \-3 channels 1
.EE
though the second form is more flexible as it allows the effects to
be ordered arbitrarily.
@@ -1761,7 +1761,7 @@
quiet and loud passages suitable for listening to in a noisy environment
such as a moving vehicle:
.EX
- sox asz.wav asz-car.wav compand 0.3,1 6:-70,-60,-20 -5 -90 0.2
+ sox asz.wav asz-car.wav compand 0.3,1 6:\-70,\-60,\-20 \-5 \-90 0.2
.EE
The transfer function (`6:\-70,...') says that very soft sounds (below
\-70dB) will remain unchanged. This will stop the compander from
@@ -1780,13 +1780,13 @@
In the next example, compand is being used as a noise-gate for when the
noise is at a lower level than the signal:
.EX
- play infile compand .1,.2 -inf,-50.1,-inf,-50,-50 0 -90 .1
+ play infile compand .1,.2 \-inf,\-50.1,\-inf,\-50,\-50 0 \-90 .1
.EE
Here is another noise-gate, this time for when the
noise is at a higher level than the signal (making it, in some ways,
similar to squelch):
.EX
- play infile compand .1,.1 -45.1,-45,-inf,0,-inf 45 -90 .1
+ play infile compand .1,.1 \-45.1,\-45,\-inf,0,\-inf 45 \-90 .1
.EE
This effect supports the \fB\-\-plot\fR global option (for the transfer function).
.SP
@@ -1841,7 +1841,7 @@
filter effect at a frequency of say 10Hz, as illustrated in the following
example:
.EX
- sox -n dc.wav synth 5 sin %0 50
+ sox \-n dc.wav synth 5 sin %0 50
sox dc.wav fixed.wav highpass 10
.EE
.TP
@@ -1896,15 +1896,15 @@
The following (one long) command plays a chime sound:
.EX
.ne 3
- play -n synth -j 3 sin %3 sin %-2 sin %-5 sin %-9 \\
- sin %-14 sin %-21 fade h .01 2 1.5 delay \\
- 1.3 1 .76 .54 .27 remix - fade h 0 2.7 2.5 norm -1
+ play \-n synth \-j 3 sin %3 sin %\-2 sin %\-5 sin %\-9 \\
+ sin %\-14 sin %\-21 fade h .01 2 1.5 delay \\
+ 1.3 1 .76 .54 .27 remix \- fade h 0 2.7 2.5 norm \-1
.EE
and this plays a guitar chord:
.EX
.ne 2
- play -n synth pl G2 pl B2 pl D3 pl G3 pl D4 pl G4 \\
- delay 0 .05 .1 .15 .2 .25 remix - fade 0 4 .1 norm -1
+ play \-n synth pl G2 pl B2 pl D3 pl G3 pl D4 pl G4 \\
+ delay 0 .05 .1 .15 .2 .25 remix \- fade 0 4 .1 norm \-1
.EE
.TP
\fBdither\fR [\fB\-a\fR] [\fB\-S\fR\^|\^\fB\-s\fR\^|\^\fB\-f \fIfilter\fR]
@@ -2100,7 +2100,7 @@
otherwise, coefficients may be given on the command line.
Examples:
.EX
- sox infile outfile fir 0.0195 -0.082 0.234 0.891 -0.145 0.043
+ sox infile outfile fir 0.0195 \-0.082 0.234 0.891 \-0.145 0.043
.EE
.EX
sox infile outfile fir coefs.txt
@@ -2110,9 +2110,9 @@
# HP filter
# freq=10000
1.2311233052619888e-01
- -4.4777096106211783e-01
+ \-4.4777096106211783e-01
5.1031563346705155e-01
- -6.6502926320995331e-02
+ \-6.6502926320995331e-02
...
.EE
.TP
@@ -2223,11 +2223,11 @@
to the effect that the audio is normalised to a given level below 0dB.
For example,
.EX
- sox infile outfile gain -n
+ sox infile outfile gain \-n
.EE
normalises to 0dB, and
.EX
- sox infile outfile gain -n -3
+ sox infile outfile gain \-n \-3
.EE
normalises to \-3dB.
.SP
@@ -2235,7 +2235,7 @@
.B \-l
option invokes a simple limiter, e.g.
.EX
- sox infile outfile gain -l 6
+ sox infile outfile gain \-l 6
.EE
will apply 6dB of gain but never clip. Note that limiting more than a
few dBs more than occasionally (in a piece of audio) is not recommended
@@ -2249,7 +2249,7 @@
option is used to apply gain to provide head-room for subsequent
processing. For example, with
.EX
- sox infile outfile gain -h bass +6
+ sox infile outfile gain \-h bass +6
.EE
6dB of attenuation will be applied prior to the bass boosting effect
thus ensuring that it will not clip. Of course, with bass, it is
@@ -2257,9 +2257,9 @@
rate, dither) it is not always as clear. Another advantage of using
\fBgain \-h\fR rather than an explicit attenuation, is that if the
headroom is not used by subsequent effects, it can be reclaimed with
-\fBgain -r\fR, for example:
+\fBgain \-r\fR, for example:
.EX
- sox infile outfile gain -h bass +6 rate 44100 gain -r
+ sox infile outfile gain \-h bass +6 rate 44100 gain \-r
.EE
The above effects chain guarantees never to clip nor amplify;
it attenuates if necessary to prevent clipping, but by only as
@@ -2268,7 +2268,7 @@
Output formatting (dithering and bit-depth reduction) also requires
headroom (which cannot be `reclaimed'), e.g.
.EX
- sox infile outfile gain -h bass +6 rate 44100 gain -rh dither
+ sox infile outfile gain \-h bass +6 rate 44100 gain \-rh dither
.EE
Here, the second
.B gain
@@ -2277,7 +2277,7 @@
subsequent processing.
The SoX global option
.B \-G
-can be given to automatically invoke \fBgain \-h\fR and \fBgain -r\fR.
+can be given to automatically invoke \fBgain \-h\fR and \fBgain \-r\fR.
.SP
See also the
.B norm
@@ -2354,14 +2354,14 @@
companding is typically used in FM radio:
.EX
.ne 8
- play track1.wav gain -3 sinc 8000- 29 100 mcompand \\
- \(dq0.005,0.1 -47,-40,-34,-34,-17,-33\(dq 100 \\
- \(dq0.003,0.05 -47,-40,-34,-34,-17,-33\(dq 400 \\
- \(dq0.000625,0.0125 -47,-40,-34,-34,-15,-33\(dq 1600 \\
- \(dq0.0001,0.025 -47,-40,-34,-34,-31,-31,-0,-30\(dq 6400 \\
- \(dq0,0.025 -38,-31,-28,-28,-0,-25\(dq \\
- gain 15 highpass 22 highpass 22 sinc -n 255 -b 16 -17500 \\
- gain 9 lowpass -1 17801
+ play track1.wav gain \-3 sinc 8000\- 29 100 mcompand \\
+ \(dq0.005,0.1 \-47,\-40,\-34,\-34,\-17,\-33\(dq 100 \\
+ \(dq0.003,0.05 \-47,\-40,\-34,\-34,\-17,\-33\(dq 400 \\
+ \(dq0.000625,0.0125 \-47,\-40,\-34,\-34,\-15,\-33\(dq 1600 \\
+ \(dq0.0001,0.025 \-47,\-40,\-34,\-34,\-31,\-31,\-0,\-30\(dq 6400 \\
+ \(dq0,0.025 \-38,\-31,\-28,\-28,\-0,\-25\(dq \\
+ gain 15 highpass 22 highpass 22 sinc \-n 255 \-b 16 \-17500 \\
+ gain 9 lowpass \-1 17801
.EE
The audio file is played with a simulated FM radio sound (or broadcast
signal condition if the lowpass filter at the end is skipped).
@@ -2441,7 +2441,7 @@
profile to \fIprofile-file\fR, or to stdout if no \fIprofile-file\fR or
if `\-' is given. E.g.
.EX
- sox speech.wav -n trim 0 1.5 noiseprof speech.noise-profile
+ sox speech.wav \-n trim 0 1.5 noiseprof speech.noise-profile
.EE
To actually remove the noise, run SoX again, this time with the \fBnoisered\fR
effect;
@@ -2468,7 +2468,7 @@
On most systems, the two stages\*mprofiling and reduction\*mcan be combined
using a pipe, e.g.
.EX
- sox noisy.wav -n trim 0 1 noiseprof | play noisy.wav noisered
+ sox noisy.wav \-n trim 0 1 noiseprof | play noisy.wav noisered
.EE
.TP
\fBnorm\fR [\fIdB-level\fR]
@@ -2542,19 +2542,19 @@
.SP
For example:
.EX
- play snare.flac phaser 0.8 0.74 3 0.4 0.5 -t
+ play snare.flac phaser 0.8 0.74 3 0.4 0.5 \-t
.EE
Gentler:
.EX
- play snare.flac phaser 0.9 0.85 4 0.23 1.3 -s
+ play snare.flac phaser 0.9 0.85 4 0.23 1.3 \-s
.EE
A popular sound:
.EX
- play snare.flac phaser 0.89 0.85 1 0.24 2 -t
+ play snare.flac phaser 0.89 0.85 1 0.24 2 \-t
.EE
More severe:
.EX
- play snare.flac phaser 0.6 0.66 3 0.6 2 -t
+ play snare.flac phaser 0.6 0.66 3 0.6 2 \-t
.EE
.TP
\fBpitch \fR[\fB\-q\fR] \fIshift\fR [\fIsegment\fR [\fIsearch\fR [\fIoverlap\fR]]]
@@ -2641,8 +2641,8 @@
equivalent:
.EX
.ne 2
- sox input.wav -r 48k output.wav bass -3
- sox input.wav output.wav bass -3 rate 48k
+ sox input.wav \-r 48k output.wav bass \-3
+ sox input.wav output.wav bass \-3 rate 48k
.EE
though the second command is more flexible as it allows
.B rate
@@ -2742,13 +2742,13 @@
.SP
Examples:
.EX
- sox input.wav -b 16 output.wav rate -s -a 44100 dither -s
+ sox input.wav \-b 16 output.wav rate \-s \-a 44100 dither \-s
.EE
default (high) quality resampling; overrides: steep filter, allow
aliasing; to 44\*d1kHz sample rate; noise-shaped dither to 16-bit WAV
file.
.EX
- sox input.wav -b 24 output.aiff rate -v -I -b 90 48k
+ sox input.wav \-b 24 output.aiff rate \-v \-I \-b 90 48k
.EE
very high quality resampling; overrides: intermediate phase, band-width 90%;
to 48k sample rate; store output to 24-bit AIFF file.
@@ -2811,7 +2811,7 @@
right of the hyphen are optional and default to 1 and to the number of input
channels respectively. Thus
.EX
- sox input.wav output.wav remix -
+ sox input.wav output.wav remix \-
.EE
performs a mix-down of all input channels to mono.
.SP
@@ -2853,13 +2853,13 @@
.EE
results in channel level multipliers of 0\*d5,0\*d5 1,0\*d8, whereas
.EX
- sox input.wav output.wav remix -a 1,2 3,4v0.8
+ sox input.wav output.wav remix \-a 1,2 3,4v0.8
.EE
results in channel level multipliers of 0\*d5,0\*d5 0\*d5,0\*d8.
.SP
The \-m (manual) option disables all automatic volume adjustments, so
.EX
- sox input.wav output.wav remix -m 1,2 3,4v0.8
+ sox input.wav output.wav remix \-m 1,2 3,4v0.8
.EE
results in channel level multipliers of 1,1 1,0\*d8.
.SP
@@ -2896,12 +2896,12 @@
script) is useful:
.EX
#!/bin/sh
-chans=\`soxi -c "$1"\`
-while [ $chans -ge 1 ]; do
+chans=\`soxi \-c "$1"\`
+while [ $chans \-ge 1 ]; do
chans0=\`printf %02i $chans\` # 2 digits hence up to 99 chans
out=\`echo "$1"|sed "s/\\(.*\\)\\.\\(.*\\)/\\1-$chans0.\\2/"\`
sox "$1" "$out" remix $chans
- chans=\`expr $chans - 1\`
+ chans=\`expr $chans \- 1\`
done
.EE
If a file
@@ -2940,7 +2940,7 @@
increases both the volume and the length of the audio, so to prevent clipping
in these domains, a typical invocation might be:
.EX
- play dry.wav gain -3 pad 0 3 reverb
+ play dry.wav gain \-3 pad 0 3 reverb
.EE
The
.B \-w
@@ -2947,7 +2947,7 @@
option can be given to select only the `wet' signal, thus allowing it to be
processed further, independently of the `dry' signal. E.g.
.EX
- play -m voice.wav "|sox voice.wav -p reverse reverb -w reverse"
+ play \-m voice.wav "|sox voice.wav \-p reverse reverb \-w reverse"
.EE
for a reverse reverb effect.
.TP
@@ -3094,13 +3094,13 @@
.SP
For example, if `my.wav' is a stereo file, then with
.EX
- sox my.wav -n spectrogram
+ sox my.wav \-n spectrogram
.EE
a spectrogram of the entire file will be created in the file
`spectrogram.png'. More often though, analysis of a smaller portion
of the audio is required; e.g. with
.EX
- sox my.wav -n remix 2 trim 20 30 spectrogram
+ sox my.wav \-n remix 2 trim 20 30 spectrogram
.EE
the spectrogram shows information only from the second (right)
channel, and of thirty seconds of audio starting from twenty seconds
@@ -3108,13 +3108,13 @@
.B rate
effect may be used, e.g.
.EX
- sox my.wav -n rate 6k spectrogram
+ sox my.wav \-n rate 6k spectrogram
.EE
allows detailed analysis of frequencies up to 3kHz (half the sampling
rate) i.e. where the human auditory system is most sensitive.
With
.EX
- sox my.wav -n trim 0 10 spectrogram -x 600 -y 200 -z 100
+ sox my.wav \-n trim 0 10 spectrogram \-x 600 \-y 200 \-z 100
.EE
the given options control the size of the spectrogram's X, Y & Z axes
(in this case, the spectrogram area of the produced image will be 600
@@ -3122,7 +3122,7 @@
the produced image includes axes legends etc. and so will be a little
larger than the specified spectrogram size. In this example:
.EX
- sox -n -n synth 6 tri 10k:14k spectrogram -z 100 -w kaiser
+ sox \-n \-n synth 6 tri 10k:14k spectrogram \-z 100 \-w kaiser
.EE
an analysis `window' with high dynamic range is selected to best
display the spectrogram of a swept triangular wave. For a smilar
@@ -3131,12 +3131,12 @@
.B delay
effect (above):
.EX
- rate 2k spectrogram -X 200 -Z -10 -w kaiser
+ rate 2k spectrogram \-X 200 \-Z \-10 \-w kaiser
.EE
Options are also avaliable to control the appearance (colour-set,
brightness, contrast, etc.) and filename of the spectrogram; e.g. with
.EX
- sox my.wav -n spectrogram -m -l -o print.png
+ sox my.wav \-n spectrogram \-m \-l \-o print.png
.EE
a spectrogram is created suitable for printing on a `black and white'
printer.
@@ -3269,7 +3269,7 @@
([[HH:]MM:]SS) fits the selected (or default) X-axis width. For
example,
.EX
- sox input.mp3 output.wav -n spectrogram -d 1:00 stats
+ sox input.mp3 output.wav \-n spectrogram \-d 1:00 stats
.EE
creates a spectrogram showing the first minute of the audio, whilst
.EE
@@ -3284,7 +3284,7 @@
Start the spectrogram at the given point in the audio stream. For
example
.EX
- sox input.aiff output.wav spectrogram -S 1:00
+ sox input.aiff output.wav spectrogram \-S 1:00
.EE
creates a spectrogram showing all but the first minute of the audio
(the output file however, receives the entire audio stream).
@@ -3377,7 +3377,7 @@
.EE
For another example, the SoX command
.EX
- play "|sox -n -p synth 1 sin %1" "|sox -n -p synth 1 sin %3"
+ play "|sox \-n \-p synth 1 sin %1" "|sox \-n \-p synth 1 sin %3"
.EE
generates and plays two notes, but there is a nasty click at the
transition; the click can be removed by splicing instead of
@@ -3394,16 +3394,16 @@
# Audio Copy and Paste Over
# acpo infile copy-start copy-stop paste-over-start outfile
# All times measured in samples.
-rate=\`soxi -r "$1"\`
+rate=\`soxi \-r "$1"\`
e=\`expr $rate '*' 5 / 1000\` # Using default excess
l=$e # and leeway.
-sox "$1" piece.wav trim \`expr $2 - $e - $l\`s \\
- \`expr $3 - $2 + $e + $l + $e\`s
+sox "$1" piece.wav trim \`expr $2 \- $e \- $l\`s \\
+ \`expr $3 \- $2 + $e + $l + $e\`s
sox "$1" part1.wav trim 0 \`expr $4 + $e\`s
-sox "$1" part2.wav trim \`expr $4 + $3 - $2 - $e - $l\`s
+sox "$1" part2.wav trim \`expr $4 + $3 \- $2 \- $e \- $l\`s
sox part1.wav piece.wav part2.wav "$5" splice \\
\`expr $4 + $e\`s \\
- \`expr $4 + $e + $3 - $2 + $e + $l + $e\`s
+ \`expr $4 + $e + $3 \- $2 + $e + $l + $e\`s
.EE
In the above Bourne shell script,
two splices are used to `copy and paste' audio.
@@ -3426,7 +3426,7 @@
is given). For example, if f1.wav and f2.wav are audio files
to be cross-faded, then
.EX
- sox f1.wav f2.wav out.wav splice -q $(soxi -D f1.wav),3
+ sox f1.wav f2.wav out.wav splice \-q $(soxi \-D f1.wav),3
.EE
cross-fades the files where the point of equal loudness is 3 seconds
before the end of f1.wav, i.e. the total length of the cross-fade is
@@ -3541,14 +3541,14 @@
l.
.ft CW
Overall Left Right
-DC offset 0.000803 -0.000391 0.000803
-Min level -0.750977 -0.750977 -0.653412
+DC offset 0.000803 \-0.000391 0.000803
+Min level \-0.750977 \-0.750977 \-0.653412
Max level 0.708801 0.708801 0.653534
-Pk lev dB -2.49 -2.49 -3.69
-RMS lev dB -19.41 -19.13 -19.71
-RMS Pk dB -13.82 -13.82 -14.38
-RMS Tr dB -85.25 -85.25 -82.66
-Crest factor - 6.79 6.32
+Pk lev dB \-2.49 \-2.49 \-3.69
+RMS lev dB \-19.41 \-19.13 \-19.71
+RMS Pk dB \-13.82 \-13.82 \-14.38
+RMS Tr dB \-85.25 \-85.25 \-82.66
+Crest factor \- 6.79 6.32
Flat factor 0.00 0.00 0.00
Pk count 2 2 2
Bit-depth 16/16 16/16 16/16
@@ -3707,11 +3707,11 @@
For example, the following produces a 3 second, 48kHz,
audio file containing a sine-wave swept from 300 to 3300\ Hz:
.EX
- sox -n output.wav synth 3 sine 300-3300
+ sox \-n output.wav synth 3 sine 300-3300
.EE
and this produces an 8\ kHz version:
.EX
- sox -r 8000 -n output.wav synth 3 sine 300-3300
+ sox \-r 8000 \-n output.wav synth 3 sine 300-3300
.EE
Multiple channels can be synthesised by specifying the set of
parameters shown between braces multiple times;
@@ -3718,13 +3718,13 @@
the following puts the swept tone in the left channel and adds `brown'
noise in the right:
.EX
- sox -n output.wav synth 3 sine 300-3300 brownnoise
+ sox \-n output.wav synth 3 sine 300-3300 brownnoise
.EE
The following example shows how two synth effects can be cascaded
to create a more complex waveform:
.EX
.ne 2
- play -n synth 0.5 sine 200-500 synth 0.5 sine fmod 700-100
+ play \-n synth 0.5 sine 200-500 synth 0.5 sine fmod 700-100
.EE
Frequencies can also be given in `scientific' note notation, or, by
prefixing a `%' character, as a number of semitones relative to
@@ -3731,13 +3731,13 @@
`middle A' (440\ Hz). For example, the following could be used to
help tune a guitar's low `E' string:
.EX
- play -n synth 4 pluck %-29
+ play \-n synth 4 pluck %-29
.EE
or with a (Bourne shell) loop, the whole guitar:
.EX
.ne 2
for n in E2 A2 D3 G3 B3 E4; do
- play -n synth 4 pluck $n repeat 2; done
+ play \-n synth 4 pluck $n repeat 2; done
.EE
See the
.B delay
--- a/soxformat.7
+++ b/soxformat.7
@@ -145,10 +145,10 @@
recording audio. ALSA is only used in Linux-based operating systems, though
these often support OSS (see below) as well. Examples:
.EX
- sox infile -t alsa
- sox infile -t alsa default
- sox infile -t alsa plughw:0,0
- sox -2 -t alsa hw:1 outfile
+ sox infile \-t alsa
+ sox infile \-t alsa default
+ sox infile \-t alsa plughw:0,0
+ sox \-2 \-t alsa hw:1 outfile
.EE
See also
.BR play (1),
@@ -199,9 +199,9 @@
for a given plugin (such as \fBpulse\fR for pulse audio plugin).
Examples:
.EX
- sox infile -t ao
- sox infile -t ao default
- sox infile -t ao pulse
+ sox infile \-t ao
+ sox infile \-t ao default
+ sox infile \-t ao pulse
.EE
See also
.BR play (1)
@@ -248,8 +248,8 @@
Mac OSX CoreAudio device driver: supports both playing and recording
audio. Examples:
.EX
- sox infile -t coreaudio
- sox infile -t coreaudio default
+ sox infile \-t coreaudio
+ sox infile \-t coreaudio default
.EE
See also
.BR play (1),
@@ -271,7 +271,7 @@
be used with any bit-rate. E.g.
.EX
sox infile outfile.cvu rate 28k
- play -r 28k outfile.cvu sinc -3.4k
+ play \-r 28k outfile.cvu sinc \-3.4k
.EE
.TP
.B .dat
@@ -338,7 +338,7 @@
G.723, G.726, G.728, or iLBC encoded audio, SoX supports reading and
writing only A-Law and \(*m-law. E.g.
.EX
- sox music.wav -t gsrt ring.bin
+ sox music.wav \-t gsrt ring.bin
play ring.bin
.EE
.TP
@@ -475,9 +475,9 @@
recording audio. OSS support is available in Unix-like operating systems,
sometimes together with alternative sound systems (such as ALSA). Examples:
.EX
- sox infile -t oss
- sox infile -t oss /dev/dsp
- sox -2 -t oss /dev/dsp outfile
+ sox infile \-t oss
+ sox infile \-t oss /dev/dsp
+ sox \-2 \-t oss /dev/dsp outfile
.EE
See also
.BR play (1),
@@ -501,7 +501,7 @@
and is only partially supported: it's necessary to
specify the audio type manually, e.g.
.EX
- play -t mp3 \(dqhttp://a.server/pls?rn=265&file=filename.pls\(dq
+ play \-t mp3 \(dqhttp://a.server/pls?rn=265&file=filename.pls\(dq
.EE
and SoX does not know about alternative servers\*mhit Ctrl-C twice in
quick succession to quit.
@@ -520,8 +520,8 @@
PulseAudio is a cross platform networked sound server.
If a file name is specified with this driver, it is ignored. Examples:
.EX
- sox infile -t pulseaudio
- sox infile -t pulseaudio default
+ sox infile \-t pulseaudio
+ sox infile \-t pulseaudio default
.EE
See also
.BR play (1),
@@ -576,7 +576,7 @@
\fBsndio\fR (optional)
OpenBSD audio device driver; supports both playing and recording audio.
.EX
- sox infile -t sndio
+ sox infile \-t sndio
.EE
See also
.BR play (1),
@@ -619,11 +619,11 @@
Sun /dev/audio device driver; supports both playing and
recording audio. For example:
.EX
- sox infile -t sunau /dev/audio
+ sox infile \-t sunau /dev/audio
.EE
or
.EX
- sox infile -t sunau -U -c 1 /dev/audio
+ sox infile \-t sunau \-U \-c 1 /dev/audio
.EE
for older sun equipment.
.SP
@@ -704,10 +704,10 @@
\fBwaveaudio\fR (optional)
MS-Windows native audio device driver. Examples:
.EX
- sox infile -t waveaudio
- sox infile -t waveaudio default
- sox infile -t waveaudio 1
- sox infile -t waveaudio "High Definition Audio Device ("
+ sox infile \-t waveaudio
+ sox infile \-t waveaudio default
+ sox infile \-t waveaudio 1
+ sox infile \-t waveaudio "High Definition Audio Device ("
.EE
If the device name is omitted, \fB-1\fR, or \fBdefault\fR, then you
get the `Microsoft Wave Mapper' device. Wave Mapper means `use the
@@ -746,7 +746,7 @@
The most common use of this file-type is likely to be along the following
lines:
.EX
- sox infile.any -t wavpcm -s outfile.wav
+ sox infile.any \-t wavpcm \-s outfile.wav
.EE
.TP
\&\fB.wv\fR (optional)