---
name: "SoundCreate"
section: "3x"
platform: "linux"
package: "nas"
version: "1.2p5-3"
release: "Debian 2.0 (Hamm)"
platforms: ["linux"]
url: "https://new.carta.tech/SoundCreate/3x"
---

# SoundCreate(3x)

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