roar_simple_new_stream(3)
NAME
roar_simple_new_stream, roar_simple_new_stream_obj - Create a new
stream via RoarAudio
SYNOPSIS
#include <roaraudio.h> int roar_simple_new_stream(struct roar_connection * con, int rate, int channels, int bits, int codec, int dir); int roar_simple_new_stream_obj(struct roar_connection * con, struct roar_stream * s, int rate, int channels, int bits, int codec, int dir);
DESCRIPTION
Opens a new stream to the sound server as a independet file handle (not
an execed one). This is useful if you still want some meta data or the
volume to be updated after the stream is open.
PARAMETERS
- con The "parent" connection. This is a valid open controll connec
- tion as opend via roar_simple_connect(3).
- s The stream object to be updated to corresponde to the new
- stream. This is useful if use want to update some meta data after the stream has be opened as you can use all controll commands on this object.
- rate, channels, bits, codec
- For an explanation on these parameters see roar_simple_play(3).
- dir For an explanation on this parameter see roar_simple_stream(3).
RETURN VALUE
On success these calls return a new filehandle. On error, -1 is
returned.
EXAMPLES
An example of the use of roar_simple_new_stream_obj() can be found on
roarvorbis(1) code.