shithub: sox

Download patch

ref: d8386c3024934f4e39b17bf18028b6fba96a830c
parent: 8330c91f0a5c7358002f9f788a90278e76605059
author: robs <robs>
date: Sat Sep 12 14:00:59 EDT 2009

waveaudio devices

--- a/soxformat.7
+++ b/soxformat.7
@@ -29,7 +29,7 @@
 .SP
 .fi
 ..
-.TH SoX 7 "June 14, 2009" "soxformat" "Sound eXchange"
+.TH SoX 7 "September 12, 2009" "soxformat" "Sound eXchange"
 .SH NAME
 SoX \- Sound eXchange, the Swiss Army knife of audio manipulation
 .SH DESCRIPTION
@@ -151,9 +151,11 @@
 	sox -2 -t alsa hw:1 outfile
 .EE
 See also
-.BR play (1)
+.BR play (1),
+.BR rec (1),
 and
-.BR rec (1).
+.BR sox (1)
+.BR \-d .
 .TP
 .B .amb
 Ambisonic B-Format: a specialisation of
@@ -202,7 +204,10 @@
 	sox infile -t ao pulse
 .EE
 See also
-.BR play (1).
+.BR play (1)
+and
+.BR sox (1)
+.BR \-d .
 .TP
 \&\fB.au\fR, \fB.snd\fR (also with \fB\-t sndfile\fR)
 Sun Microsystems AU files.
@@ -247,9 +252,11 @@
 	sox infile -t coreaudio default
 .EE
 See also
-.BR play (1)
+.BR play (1),
+.BR rec (1),
 and
-.BR rec (1).
+.BR sox (1)
+.BR \-d .
 .TP
 \&\fB.cvsd\fR, \fB.cvs\fR
 Continuously Variable Slope Delta modulation.
@@ -440,9 +447,11 @@
 	sox -2 -t oss /dev/dsp outfile
 .EE
 See also
-.BR play (1)
+.BR play (1),
+.BR rec (1),
 and
-.BR rec (1).
+.BR sox (1)
+.BR \-d .
 .TP
 \&\fB.paf\fR, \fB.fap\fR (optional)
 Ensoniq PARIS file format (big and little-endian respectively).
@@ -482,9 +491,11 @@
 	sox infile -t pulseaudio default
 .EE
 See also
-.BR play (1)
+.BR play (1),
+.BR rec (1),
 and
-.BR rec (1).
+.BR sox (1)
+.BR \-d .
 .TP
 \&\fB.pvf\fR (optional)
 Portable Voice Format.
@@ -535,9 +546,11 @@
 	sox infile -t sndio
 .EE
 See also
-.BR play (1)
+.BR play (1),
+.BR rec (1),
 and
-.BR rec (1).
+.BR sox (1)
+.BR \-d .
 .TP
 .B .sndr
 Sounder files.
@@ -582,9 +595,11 @@
 for older sun equipment.
 .SP
 See also
-.BR play (1)
+.BR play (1),
+.BR rec (1),
 and
-.BR rec (1).
+.BR sox (1)
+.BR \-d .
 .TP
 .B .txw
 Yamaha TX-16W sampler.
@@ -654,16 +669,34 @@
 option with the output file options.
 .TP
 \fBwaveaudio\fR (optional)
-MS-Windows native audio device driver.
-If a file name is specified with this driver, it is ignored.  Examples:
+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 ("
 .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
+system default audio devices'.  You can control what `default' means
+via the OS Control Panel.
+.SP
+If the device name given is some other number, you get that audio
+device by index; so recording with device name \fB0\fR would get the
+first input device (perhaps the microphone), \fB1\fR would get the
+second (perhaps line in), etc.  Playback using \fB0\fR will get the
+first output device (usually the only audio device).
+.SP
+If the device name given is something other than a number, SoX tries
+to match it (maximum 31 characters) against the names of the available
+devices.
+.SP
 See also
-.BR play (1)
+.BR play (1),
+.BR rec (1),
 and
-.BR rec (1).
+.BR sox (1)
+.BR \-d .
 .TP
 .B .wavpcm
 A non-standard, but widely used, variant of