version 1.66, 2010/04/06 20:07:01 |
version 1.67, 2010/04/07 06:47:52 |
|
|
Multiple modes can be specified, separated by commas, |
Multiple modes can be specified, separated by commas, |
but the same stream cannot be used for both recording and monitoring. |
but the same stream cannot be used for both recording and monitoring. |
The default is |
The default is |
.Ar play , rec |
.Ar play , Ns Ar rec |
(i.e. full-duplex). |
(i.e. full-duplex). |
.It Fl n |
.It Fl n |
Loopback mode. |
Loopback mode. |
|
|
.Xr sndio 7 |
.Xr sndio 7 |
device name string. |
device name string. |
.It Fl t Ar mode |
.It Fl t Ar mode |
Select the way sub-devices are controlled by MMC (MIDI Machine Control) messages. |
Select the way sub-devices are controlled by MIDI Machine Control (MMC) |
|
messages. |
If the mode is |
If the mode is |
.Va off |
.Va off |
(the default), then streams are not affected by MMC messages. |
(the default), then streams are not affected by MMC messages. |
If the mode is |
If the mode is |
.Va slave , |
.Va slave , |
then streams are started synchronously by MMC start messages; |
then streams are started synchronously by MMC start messages; |
additionally, the server clock is exposed as MTC (MIDI Time Code) |
additionally, the server clock is exposed as MIDI Time Code (MTC) |
messages allowing MTC-capable software or hardware to be synchronized |
messages allowing MTC-capable software or hardware to be synchronized |
to audio streams. |
to audio streams. |
.It Fl U Ar unit |
.It Fl U Ar unit |
|
|
.Dq error |
.Dq error |
then the stream is closed permanently. |
then the stream is closed permanently. |
.Pp |
.Pp |
If a sub-device is created with |
If a sub-device is created with the |
.Fl t , |
.Fl t |
|
option, |
the |
the |
.Dq ignore |
.Dq ignore |
action is disabled for any stream connected to it |
action is disabled for any stream connected to it |
|
|
The audio block size in frames. |
The audio block size in frames. |
This is the number of frames between audio clock ticks, |
This is the number of frames between audio clock ticks, |
i.e. the clock resolution. |
i.e. the clock resolution. |
If a sub-device is created with |
If a sub-device is created with the |
.Fl t , |
.Fl t |
and MTC (Midi Time Code) is used for synchronization, the clock |
option, |
|
and MTC is used for synchronization, the clock |
resolution must be 96, 100 or 120 ticks per second for maximum |
resolution must be 96, 100 or 120 ticks per second for maximum |
accuracy. |
accuracy. |
For instance, 120 ticks per second at 48000Hz corresponds |
For instance, 120 ticks per second at 48000Hz corresponds |
|
|
for instance for monitoring or as feedback for motorized |
for instance for monitoring or as feedback for motorized |
faders. |
faders. |
.Pp |
.Pp |
Clients connected to sub-devices created with |
Clients connected to sub-devices created with the |
.Fl t |
.Fl t |
are controlled by the following MMC (MIDI Machine Control) messages: |
option are controlled by the following MMC messages: |
.Bl -tag -width relocateXXX -offset indent |
.Bl -tag -width relocateXXX -offset indent |
.It stop |
|
Put the sub-device in stopped mode (the default). |
|
In this mode, any stream attempting to start playback or recording |
|
is paused. |
|
Streams that are already started are not affected until they stop |
|
and try to start again. |
|
.It relocate |
.It relocate |
Gives |
Gives |
.Nm |
.Nm |
|
|
to start, and then starts them synchronously. |
to start, and then starts them synchronously. |
Once started, new streams can be created, but they will be blocked |
Once started, new streams can be created, but they will be blocked |
until the next stop-to-start transition. |
until the next stop-to-start transition. |
|
.It stop |
|
Put the sub-device in stopped mode (the default). |
|
In this mode, any stream attempting to start playback or recording |
|
is paused. |
|
Streams that are already started are not affected until they stop |
|
and try to start again. |
.El |
.El |
.Pp |
.Pp |
Sub-devices created with |
Sub-devices created with the |
.Fl t |
.Fl t |
will export the server clock using MTC (MIDI Time Code), allowing non-audio |
option export the server clock using MTC, allowing non-audio |
software or hardware to be synchronized to the audio stream. |
software or hardware to be synchronized to the audio stream. |
The following sample rates |
The following sample rates |
.Pq Fl r |
.Pq Fl r |
|
|
.Pp |
.Pp |
A MIDI channel is assigned to each stream, and the volume |
A MIDI channel is assigned to each stream, and the volume |
is changed using the standard volume controller (number 7). |
is changed using the standard volume controller (number 7). |
Streams created with |
Streams created with the |
.Fl t |
.Fl t |
option are controlled by the following MIDI Machine Control (MMC) messages: |
option are controlled by the following MMC messages: |
.Bl -tag -width relocateXXX -offset indent |
.Bl -tag -width relocateXXX -offset indent |
.It start |
|
Start all streams synchronously. |
|
By default, streams are created in a stopped state. |
|
.It stop |
|
Playback or recording is stopped, and |
|
the stream is rewound back to the starting position. |
|
.It relocate |
.It relocate |
Streams are relocated to the requested time postion |
Streams are relocated to the requested time postion |
relative to the beginning of the stream, at which playback |
relative to the beginning of the stream, at which playback |
and recording must start. |
and recording must start. |
If the requested position is beyond the end of file, |
If the requested position is beyond the end of file, |
the stream is temporarly disabled until a valid postion is requested. |
the stream is temporarly disabled until a valid postion is requested. |
|
.It start |
|
Start all streams synchronously. |
|
By default, streams are created in a stopped state. |
|
.It stop |
|
Playback or recording is stopped, and |
|
the stream is rewound back to the starting position. |
.El |
.El |
.Pp |
.Pp |
For instance, the following command will play a file on the |
For instance, the following command will play a file on the |