---
name: "SoundCreate"
section: "3nas"
platform: "linux"
package: "libaudio-dev"
version: "1.9.4-9"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/SoundCreate"
---

# SoundCreate(3nas)

create a description of an audio file.

## Name

**SoundCreate** - create a description of an audio file.

## Synopsis

\#include \<audio/audiolib.h\>

**Sound** **SoundCreate**(*file\_format*, *data\_format*, *num\_tracks*, *sample\_rate*, *num\_samples*, *comment*)\
\
     int *file\_format*;\
\
     int *data\_format*;\
\
     int *num\_tracks*;\
\
     int *sample\_rate*;\
\
     int *num\_samples*;\
\
     char \**comment*;

## Arguments

- *file\_format*

  Specifies the format of the audio file. Currently, the following file formats are supported: **SoundFileFormatSnd**, **SoundFileFormatVoc**, **SoundFileFormatWave**, **SoundFileFormatAiff**, and **SoundFileFormatSvx**.

- *data\_format*

  Specifies the format of the audio data. Currently, the following formats are defined: **AuFormatULAW8**, **AuFormatLinearUnsigned8**, **AuFormatLinearSigned8**, **AuFormatLinearSigned16MSB**, **AuFormatLinearUnsigned16MSB**, **AuFormatSignedLinear16LSB**, and **AuFormatLinearUnsigned16LSB**.

- *num\_tracks*

  Specifies the number of tracks in the audio data.

- *sample\_rate*

  Specifies the sample rate of the audio data.

- *num\_samples*

  Specifies the number of samples in the audio data.

- *comment*

  ## Description

**SoundCreate** creates a **SoundRec** structure, initializes it with the specified values and returns a **Sound** (a pointer to the **SoundRec** structure) or NULL if there was an error.

## See Also

**SoundCloseFile**, **SoundOpenFileForReading**, **SoundOpenFileWriting**,

audiolib - **Network Audio System** C Language Interface