chiark / gitweb /
Check for db47 (not db46) on FreeBSD.
[disorder] / README.raw
CommitLineData
460b9539 1* DisOrder Raw Format Players
2
3** Purpose
4
5The purpose of raw format players is:
6
7 * Support pausing of playing tracks, with the audio device closed when not
8 in active use.
9
10 * Eliminate the inter-track gap.
11
12 * Perhaps in the future support network play.
13
14** Usage
15
3b1b5e71
RK
16By default, built-in raw-format players are used for several encodings, so you
17do not need to do anything.
18
460b9539 19** Low-Level Details
20
21Raw format players are started slightly differently to normal ones. Before
22they are executed a pipe is created and one end passed to a special speaker
23process, which is spawned by the main server at startup. The file descriptor
24of the player's end is identified by $DISORDER_RAW_FD.
25
26The expected data format is a ao_sample_format structure followed by the raw
27sample data. However, this may be changed without notice in future versions of
28DisOrder. If you need a stable interface here for some reason then get in
29touch.
30
31Raw format players may be started before the track is to be played, and (if the
32track is then removed from the queue before it reaches the head) terminated
33before the track ever reaches a physical speaker. The point of this is to
34allow audio data to be ready to play the moment the previous track end, without
35having to wait for the player to start up. There is no way for a player to
36tell that this is going on.
37
38Local Variables:
39mode:outline
40fill-column:79
41End: