---
name: "roar_vs_new_playback"
section: "3"
platform: "linux"
package: "libroar-dev"
version: "1.0~beta12-4"
release: "Debian 11 (Bullseye)"
platforms: ["linux"]
url: "https://new.carta.tech/roar_vs_new_playback"
---

# roar\_vs\_new\_playback(3)

Create new VS objects

## 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 application 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 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**(3)](/roar_vs_new/3.md), [**roar\_vs\_new\_from\_file**(3)](/roar_vs_new_from_file/3.md), [**roar\_vs\_close**(3)](/roar_vs_close/3.md), [**roarvs**(7)](/roarvs/7.md), [**libroar**(7)](/libroar/7.md), [**RoarAudio**(7)](/RoarAudio/7.md).