version 1.21, 2008/05/29 13:53:47 |
version 1.22, 2008/06/02 17:09:51 |
|
|
.Op Fl qu |
.Op Fl qu |
.Op Fl C Ar min : Ns Ar max |
.Op Fl C Ar min : Ns Ar max |
.Op Fl c Ar min : Ns Ar max |
.Op Fl c Ar min : Ns Ar max |
.Op Fl d Ar level |
|
.Op Fl E Ar enc |
.Op Fl E Ar enc |
.Op Fl e Ar enc |
.Op Fl e Ar enc |
.Op Fl f Ar device |
.Op Fl f Ar device |
|
|
.Op Fl o Ar file |
.Op Fl o Ar file |
.Op Fl R Ar rate |
.Op Fl R Ar rate |
.Op Fl r Ar rate |
.Op Fl r Ar rate |
|
.Op Fl X Ar policy |
|
.Op Fl x Ar policy |
.Ek |
.Ek |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
The |
The |
|
|
.It Fl c Ar min : Ns Ar max |
.It Fl c Ar min : Ns Ar max |
The range of channel numbers on the input stream. |
The range of channel numbers on the input stream. |
The default is 0:1, i.e. stereo. |
The default is 0:1, i.e. stereo. |
.It Fl d Ar level |
|
The debug level: |
|
may be a value between 0 and 4. |
|
.It Fl E Ar enc |
.It Fl E Ar enc |
Encoding of the output stream (see below). |
Encoding of the output stream (see below). |
The default is signed, 16-bit, native byte order. |
The default is signed, 16-bit, native byte order. |
|
|
it will instead use the parameters specified by the |
it will instead use the parameters specified by the |
.Fl CcEeRr |
.Fl CcEeRr |
options. |
options. |
|
.It Fl X Ar policy |
|
Action when the output stream cannot accept |
|
recorded data fast enough. |
|
If the policy |
|
is |
|
.Ar ignore |
|
(the default) then samples that cannot be written are discarded. |
|
If the policy is |
|
.Ar sync |
|
then samples are discarded, but the same amount of silence will be written |
|
once the stream is unblocked, in order to reach the right position in time. |
|
If the policy is |
|
.Ar error |
|
then the stream is closed permanenty. |
|
.It Fl x Ar policy |
|
Action when the input stream cannot provide |
|
data to play fast enough. |
|
If the policy is |
|
.Ar ignore |
|
(the default) then silence is played. |
|
If the policy is |
|
.Ar sync |
|
then silence is played, but the same amount of samples will be discarded |
|
once the stream is unblocked, in order to reach the right position in time. |
|
If the policy is |
|
.Ar error |
|
then the stream is closed permanenty. |
.El |
.El |
.Pp |
.Pp |
Settings for input |
Settings for input |
|
|
and output |
and output |
.Pq Fl o |
.Pq Fl o |
files can be changed using the |
files can be changed using the |
.Fl CcEeHhRr |
.Fl CcEeHhRrXx |
options. |
options. |
The last |
The last |
.Fl CcEeHhRr |
.Fl CcEeHhRrXx |
option specified before an |
option specified before an |
.Fl i |
.Fl i |
or |
or |
|
|
.Bl -tag -width AUDIODEVICE |
.Bl -tag -width AUDIODEVICE |
.It Ev AUDIODEVICE |
.It Ev AUDIODEVICE |
The audio device to use. |
The audio device to use. |
|
.It Ev AUCAT_DEBUG |
|
The debug level: |
|
may be a value between 0 and 4. |
.El |
.El |
.Sh EXAMPLES |
.Sh EXAMPLES |
The following command will record a stereo s16le stream at |
The following command will record a stereo s16le stream at |
|
|
.Pp |
.Pp |
CPU usage is the same for all conversions. |
CPU usage is the same for all conversions. |
It should be smaller for simpler ones. |
It should be smaller for simpler ones. |
.Pp |
|
Buffer overruns and underruns are not handled. |
|
.Pp |
.Pp |
Processing is done using 16-bit arithmetic, |
Processing is done using 16-bit arithmetic, |
thus samples with more than 16 bits are rounded. |
thus samples with more than 16 bits are rounded. |