sm64ex-coop/tools/audiofile-0.3.6/docs/afInitSampleFormat.3.txt

95 lines
2.7 KiB
Plaintext

afInitSampleFormat(3)
=====================
NAME
----
afInitSampleFormat, afInitByteOrder, afInitChannels, afInitRate -
initialize audio data format for a track in an audio file setup
SYNOPSIS
--------
#include <audiofile.h>
void afInitSampleFormat(AFfilesetup setup, int track, int sampleFormat,
int sampleWidth);
void afInitByteOrder(AFfilesetup setup, int track, int byteOrder);
void afInitChannels(AFfilesetup setup, int track, int channels);
void afInitRate(AFfilesetup setup, int track, double rate);
PARAMETERS
----------
`setup` is a valid file setup returned by linkaf:afNewFileSetup[3].
`track` specifies a track within the audio file setup. `track` is always
`AF_DEFAULT_TRACK` for all currently supported file formats.
`sampleFormat` is a symbolic constant specifying the sample format
for the audio data in the track. `sampleFormat` must be one of
`AF_SAMPFMT_TWOSCOMP`, `AF_SAMPFMT_UNSIGNED`, `AF_SAMPFMT_FLOAT`, or
`AF_SAMPFMT_DOUBLE`.
`sampleWidth` is a positive integer specifying the number of bits for
each sample in the track.
`byteOrder` is a symbolic constant specifying the byte order of
the track. `byteOrder` must be one of `AF_BYTEORDER_BIGENDIAN` or
`AF_BYTEORDER_LITTLEENDIAN`.
`channels` is a positive integer specifying the number of channels in
the track.
`rate` is a positive double-precision floating-point number specifying
the sample rate of the track.
DESCRIPTION
-----------
`afInitSampleFormat` initializes the track to the specified sample format
and sample width.
`afInitByteOrder` initializes the track to the specified byte order.
`afInitChannels` initializes the track to the specified number of channels.
`afInitRate` initializes the track to the specified sample rate.
ERRORS
------
`afInitSampleFormat`, `afInitByteOrder`, `afInitChannels`, and
`afInitRate` can produce the following errors:
[horizontal]
`AF_BAD_FILESETUP`:: `setup` represents an invalid file setup.
`AF_BAD_TRACK`:: `track` represents an invalid track identifier.
`afInitSampleFormat` can also produce the following errors:
[horizontal]
`AF_BAD_SAMPFMT`:: `sampleFormat` does not represent a valid sample format.
`AF_BAD_WIDTH`:: `sampleWidth` is not a valid sample width.
`afInitByteOrder` can also produce the following error:
[horizontal]
`AF_BAD_BYTEORDER`:: `byteOrder` does not represent a valid byte order.
`afInitChannels` can also produce the following error:
[horizontal]
`AF_BAD_CHANNELS`:: `channels` specifies an invalid number of channels.
`afInitRate` can also produce the following error:
[horizontal]
`AF_BAD_RATE`:: `rate` specifies an invalid sample rate.
SEE ALSO
--------
linkaf:afNewFileSetup[3],
linkaf:afInitFileFormat[3],
linkaf:afInitCompression[3],
linkaf:afOpenFile[3]
AUTHOR
------
Michael Pruett <michael@68k.org>