roar_str2codec(3) [debian man page]

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

NAME

       roar_str2codec - Get codec ID by codec name

       roar_codec2str - Get codec name by ID

SYNOPSIS

	#include <roaraudio.h>

	int    roar_str2codec (char * codec);
	char * roar_codec2str (int    codec);

DESCRIPTION

       roar_str2codec converts a string to a RoarAudio Codec ID. It also supports some common aliases.	roar_codec2str is the reverse operation of
       roar_str2codec: It get's a name by the ID given.  If a codec is valid the following should be true:
	roar_str2codec(roar_codec2str(codec)) == codec

       Note that because of aliasing and case insensitivity the revers operation needs not to be true.

THREAD SAFETY

       Because roar_codec2str returns a static unique pointer for each codec it is fully thread safe.

RETURN VALUE

       On success roar_str2codec returns a codec ID.  On error, -1 is returned.  roar_codec2str returns the name of the codec or  NULL	on  error.
       You must not free this pointer or write to it.

EXAMPLES

       FIXME

SEE ALSO

       libroar(7), RoarAudio(7).

RoarAudio							     May 2011							 roar_str2codec(3)

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

NAME

       roar_vs_new_simple, roar_vs_new_playback - Create new VS objects

SYNOPSIS

       #include <roaraudio.h>

       roar_vs_t * roar_vs_new_simple(const char * server, const char * name, int rate, int channels, int codec, int bits, int dir, int * error);

       roar_vs_t * roar_vs_new_playback(const char * server, const char * name, int rate, int channels, int codec, int bits, int * error);

DESCRIPTION

       These  functions create a new VS object with a already connected data connection.  The functions connect to the server server with applica-
       tion name name.	They take the audio parameters as arguments rate, channels, codec, bits.

       roar_vs_new_simple() takes the stream direction as parameter dir.

       roar_vs_new_playback() is equivalent to roar_vs_new_simple() expect that it does not take the direction parameter  but  uses  ROAR_DIR_PLAY
       (waveform playback). It may be implemented as a macro.

PARAMETERS

       server The server to connect to. NULL for defaults.

       name   The  application	name.  This  should  be  something the user can use to identify the application.  It MUST NOT be the application's
	      binary name or the value of argv[0].

       rate, channels, codec, bits
	      The audio parameters for the new stream: sampling rate, number of channels per frame, used codec and number of bits per sample.

       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 a new VS object.  On error, NULL is returned.

EXAMPLES

       FIXME

SEE ALSO

       roar_vs_new(3), roar_vs_new_from_file(3), roar_vs_close(3), roarvs(7), libroar(7), RoarAudio(7).

RoarAudio							     June 2011						     roar_vs_new_simple(3)