Provided by: libroar-dev_0.4-2_i386 bug

NAME

       roar_vs_stream, roar_vs_new_from_con - Create new VS objects

SYNOPSIS

       #include <roaraudio.h>

       roar_vs_t  *  roar_vs_new(const char * server, const char * name, int *
       error);

       roar_vs_t * roar_vs_new_from_con(struct roar_connection *  con,  int  *
       error);

DESCRIPTION

       These  calls  are used to create new VS objects without a yet connected
       data connection.  They are only helpful if there you want  to  share  a
       control  connection  between multiple streams (generally recommended if
       using multiple streams to the same server) or need to use some extended
       parts  of  the  VS API. If you look for a easy way to open a stream see
       roar_vs_new_simple(3) and roar_vs_new_from_file(3).

       roar_vs_new() opens a new control connection to server server.  name is
       used as application name.

       roar_vs_new_from_con() creates a new VS object from the extsing control
       connection con.

       VS objects  created  via  roar_vs_new_from_con()  will  not  close  the
       control connection on roar_vs_close(3).

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

       con    The already existing and open control connection to use.

       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
              recommended  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_simple(3),    roar_vs_new_from_file(3),   roar_vs_close(3),
       roarvs(7), libroar(7), RoarAudio(7).