| 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 |
|---|
