afinitfileformat(3) [centos man page]

AFINITFILEFORMAT(3)													       AFINITFILEFORMAT(3)

NAME

       afInitFileFormat - initialize file format of an audio file setup

SYNOPSIS

       #include <audiofile.h>

       void afInitFileFormat(AFfilesetup setup, int fileFormat);

PARAMETERS

       setup is a valid file setup created by afNewFileSetup(3).

       fileFormat is an integer constant specifying a file format.

DESCRIPTION

       Given an AFfilesetup structure created with afNewFileSetup(3), afInitFileFormat initializes the file format to that specified by
       fileFormat.

       The following file formats are currently supported:

       AF_FILE_RAWDATA
	   raw audio data

       AF_FILE_AIFF
	   Audio Interchange File Format

       AF_FILE_AIFFC
	   Audio Interchange File Format AIFF-C

       AF_FILE_NEXTSND
	   NeXT .snd/Sun .au

       AF_FILE_WAVE
	   Microsoft RIFF WAVE

       AF_FILE_BICSF
	   Berkeley/IRCAM/CARL Sound File

       AF_FILE_AVR
	   Audio Visual Research

       AF_FILE_IFF_8SVX
	   Amiga IFF/8SVX

       AF_FILE_SAMPLEVISION
	   Sample Vision

       AF_FILE_VOC
	   Creative Voice File

       AF_FILE_NIST_SPHERE
	   NIST SPHERE

       AF_FILE_CAF
	   Core Audio Format

ERRORS

       afInitFileFormat can produce the following errors:

       AF_BAD_FILESETUP

	   setup represents an invalid file setup.

       AF_BAD_FILEFMT

	   fileFormat represents an unknown file format.

       AF_BAD_NOT_IMPLEMENTED

	   fileFormat represents a file format which is not currently implemented.

SEE ALSO

       afNewFileSetup(3)

AUTHOR

       Michael Pruett <michael@68k.org>

Audio File Library 0.3.6					    03/06/2013						       AFINITFILEFORMAT(3)

AFOPENFILE(3)															     AFOPENFILE(3)

NAME

       afOpenFile - open an audio file and create a file handle structure used for subsequent calls to the Audio File Library

SYNOPSIS

       #include <audiofile.h>

       AFfilehandle afOpenFile(const char *path, const char *mode,
	   AFfilesetup setup);

PARAMETERS

       path is the path to the file to be opened.

       mode specifies a mode for opening the file: "r" for reading or "w" for writing.

       setup is an AFfilesetup created by afNewFileSetup(3). This value is ignored for files opened for reading except when the file format is
       AF_FILE_RAWDATA.

RETURN VALUE

       Upon success, afOpenFile returns a valid AFfilehandle which can be used in subsequent calls to the Audio File Library. Upon failure,
       afOpenFile returns NULL and generates an error.

       afCloseFile(3) is used to close the file when it is no longer needed.

ERRORS

       afOpenFile can produce the following errors:

       AF_BAD_OPEN
	   A call to open failed.

       AF_BAD_READ
	   A call to read failed

       AF_BAD_WRITE
	   A call to write failed.

       AF_BAD_LSEEK
	   A call to lseek failed.

       AF_BAD_MALLOC
	   Memory allocation failed.

       AF_BAD_FILEFMT

	   setup specifies a file format which is unsupported for mode.

       AF_BAD_SAMPFMT
	   The file's sample format is not supported.

       AF_BAD_WIDTH
	   The file's sample width is not supported.

       AF_BAD_RATE
	   The file's sample rate is not supported.

       AF_BAD_CHANNELS
	   The number of channels in the file is not supported.

       AF_BAD_FILESETUP

	   setup specifies an invalid or unsupported configuration.

SEE ALSO

       afCloseFile(3), afNewFileSetup(3), afInitFileFormat(3), afInitSampleFormat(3), afReadFrames(3), afWriteFrames(3)

AUTHOR

       Michael Pruett <michael@68k.org>

Audio File Library 0.3.6					    03/06/2013							     AFOPENFILE(3)