roar_simple_stream(3) [debian man page]

roar_simple_stream(3)					System Manager's Manual: RoarAudio				     roar_simple_stream(3)

NAME

       roar_simple_stream - Opens a stream to RoarAudio's sound server

SYNOPSIS

       #include <roaraudio.h>

       int roar_simple_stream(int rate, int channels, int bits, int codec, char * server, int dir, char * name);

DESCRIPTION

       This  creates a new stream to RoarAudio. Normally you want to use one of roar_simple_play(3), roar_simple_monitor(3), roar_simple_record(3)
       or roar_simple_filter(3).

       his functions are marked obsolete and will be removed very soon.  Please upgrade to VS API. See roar_vs_new_simple(3).

PARAMETERS

       rate, channels, bits, codec, server, name
	      For an explanation on these parameters see roar_simple_play(3).

       dir    The direction of the new stream. See below for a list of valid directions.

STREAM DIRECTIONS

       ROAR_DIR_PLAY
	      This stream directions meens that a player streams data to the server in order to play it back.

       ROAR_DIR_RECORD
	      This direction is to record audio from the soundcard. This is used if for example you want to get data from your microphon  or  line
	      in.

       ROAR_DIR_MONITOR
	      This  direction  is  used  to get a copy of what the server sends to the soundcard. This can for example be used to stream the fully
	      mixed data to Icecast (see icecast2(1)).

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

       ROAR_DIR_OUTPUT
	      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  complete-
	      ness.

RETURN VALUE

       On success these calls return a filehandle.  On error, -1 is returned.

EXAMPLES

       FIXME

SEE ALSO

       roar_vs_new_simple(3), roar_simple_play(3), roar_simple_close(3), libroar(7), RoarAudio(7).

RoarAudio							     May 2011						     roar_simple_stream(3)

roar_vs_stream(3)					   RoarAudio Programmer's Manual					 roar_vs_stream(3)

NAME

       roar_vs_stream - Set up stream parameters for VS object

SYNOPSIS

       #include <roaraudio.h>

       int roar_vs_stream(roar_vs_t * vss, const struct roar_audio_info * info, int dir, int * error);

DESCRIPTION

       This  function  asks a VS object opened by roar_vs_new_from_con(3) or roar_vs_new(3) to open the data connection using the audio parameters
       info and the stream direction dir.

       This function needs to be called before data is read or written if one of the above functions is used to create the VS object.

       This function is also used to provide parameters for the file mode (which is started by using roar_vs_file(3)  or  roar_vs_file_simple(3)).
       To  play  back  a  file	this  is not needed in a common case as the VS API tries to find correct parameters.  It is required for all other
       stream directions. See roar_vs_file(3) and roar_vs_file_simple(3) for more information.

       On failture this function can be called again with diffrent parameters.

PARAMETERS

       vss    The VS object to be updated.

       info   This is a pointer to the roar_audio_info structure storing the audio format parameters.  The structure contains the following  meme-
	      bers: rate (sample rate), bits (bits per sample), channels (channels per frame) and codec.

       dir    This  is	the stream direction. Common values include ROAR_DIR_PLAY for waveform playback, ROAR_DIR_MONITOR for waveform monitoring,
	      ROAR_DIR_RECORD for waveform recording.  For MIDI ROAR_DIR_MIDI_IN and ROAR_DIR_MIDI_OUT is used.

       error  This is a pointer to a integer used to store the error value in case of error.  This can be NULL if not used but it is  very  recom-
	      mended to use this error value to report good error messages to the user.

RETURN VALUE

       On success these calls return 0.  On error, -1 is returned.

EXAMPLES

	struct roar_audio_info info;
	int err;

	if ( roar_profile2info(&info, "isdn-eu") == -1 ) {
	 // error handling.
	}

	if ( roar_vs_stream(vss, &info, ROAR_DIR_PLAY, &err) == -1 ) {
	 // error handling.
	}

SEE ALSO

       roar_vs_file(3), roar_vs_file_simple(3), roarvs(7), libroar(7), RoarAudio(7).

RoarAudio							     June 2011							 roar_vs_stream(3)