[159] | 1 | .\" roar_simple_play.3: |
---|
| 2 | |
---|
| 3 | .TH "roar_simple_stream" "3" "July 2008" "RoarAudio" "System Manager's Manual: RoarAuido" |
---|
| 4 | |
---|
| 5 | .SH NAME |
---|
| 6 | roar_simple_stream \- Opens a stream to RoarAudio's sound server |
---|
| 7 | |
---|
| 8 | .SH SYNOPSIS |
---|
| 9 | |
---|
| 10 | #include <roaraudio.h> |
---|
| 11 | |
---|
| 12 | int roar_simple_stream(int rate, int channels, int bits, int codec, char * server, int dir, char * name); |
---|
| 13 | |
---|
| 14 | .SH "DESCRIPTION" |
---|
| 15 | This creates a new stream to RoarAudio. Normaly you want to use one of \fBroar_simple_play\fR(3), \fBroar_simple_monitor\fR(3), \fBroar_simple_record\fR(3) or \fBroar_simple_filter\fR(3). |
---|
| 16 | |
---|
| 17 | .SH "PARAMETERS" |
---|
| 18 | .TP |
---|
| 19 | \fBrate, channels, bits, codec, server, name\fR |
---|
| 20 | For an explanation on these parameters see \fBroar_simple_play\fR(3). |
---|
| 21 | |
---|
| 22 | .TP |
---|
| 23 | \fBdir\fR |
---|
| 24 | The direction of the new stream. See below for a list of valid directions. |
---|
| 25 | |
---|
| 26 | .SH "STREAM DIRECTIONS" |
---|
| 27 | |
---|
| 28 | .TP |
---|
| 29 | \fBROAR_DIR_PLAY\fR |
---|
| 30 | This stream directions meens that a player streams data to the server in order to play it back. |
---|
| 31 | |
---|
| 32 | .TP |
---|
| 33 | \fBROAR_DIR_RECORD\fR |
---|
| 34 | This direction is to record audio from the soundcard. This is used if for example you want to |
---|
| 35 | get data from your microphon or line in. |
---|
| 36 | |
---|
| 37 | .TP |
---|
| 38 | \fBROAR_DIR_MONITOR\fR |
---|
| 39 | This direction is used to get a copy of what the server sends to the soundcard. This can for example be used |
---|
| 40 | to stream the fully mixed data to Icecast (see \fBicecast2\fR(1)). |
---|
| 41 | |
---|
| 42 | .TP |
---|
| 43 | \fBROAR_DIR_FILTER\fR |
---|
| 44 | This is used to crate a filter stream: A filter stream is a stream used to filter the output of the sound server by some tool. This can for example be used for an software equalizer. The filter stream is the only bi-directional stream. You have to read some data and write back data of exactly the same size. |
---|
| 45 | |
---|
| 46 | .TP |
---|
| 47 | \fBROAR_DIR_OUTPUT\fR |
---|
| 48 | This is the type of the stream the server sends to the soundcard. You can not create such a stream. It's only listend for completeness. |
---|
| 49 | |
---|
| 50 | |
---|
| 51 | .SH "RETURN VALUE" |
---|
| 52 | On success these calls return a filehandle. On error, -1 is returned. |
---|
| 53 | |
---|
| 54 | .SH "EXAMPLES" |
---|
| 55 | FIXME |
---|
| 56 | |
---|
| 57 | .SH "SEE ALSO" |
---|
| 58 | \fBroar_simple_play\fR(3), |
---|
| 59 | \fBroar_simple_close\fR(3), |
---|
| 60 | \fBlibroar\fR(7), |
---|
| 61 | \fBRoarAudio\fR(7). |
---|
| 62 | |
---|
| 63 | .\" ll |
---|