afgetframesize(3) [centos man page]

AFGETFRAMESIZE(3)														 AFGETFRAMESIZE(3)

NAME

       afGetFrameSize - calculate the frame size in bytes for an audio track

SYNOPSIS

       #include <audiofile.h>

       float afGetFrameSize (AFfilehandle file, int track, int expand3to4);

PARAMETERS

       file is a valid AFfilehandle.

       track is an integer which refers to a specific audio track in the file. At present no supported audio file format allows for more than one
       audio track within a file, so track should always be AF_DEFAULT_TRACK.

       expand3to4 is a boolean-valued integer indicating whether frame size calculation will treat 24-bit data as having a size of 3 bytes or 4
       bytes.

DESCRIPTION

       afGetFrameSize returns the number of bytes in a frame in a given audio track.

       A sample frame consists of one or more samples. For a monaural track, a sample frame will always contain one sample. For a stereophonic
       track, a sample frame will always contain two samples, one for the left channel and one for the right channel.

       A non-zero value of expand3to4 should be used when calculating the frame size for storage in memory (since 24-bit audio data is presented
       in memory as a 4-byte sign-extended integer), while a value of zero should be used for calculating storage on disk where no padding is
       added. The parameter expand3to4 is ignored unless the specified audio track contains 24-bit audio data.

AUTHOR

       Michael Pruett <michael@68k.org>

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

AFGETFRAMECOUNT(3)														AFGETFRAMECOUNT(3)

NAME

       afGetFrameCount, afGetTrackBytes, afGetDataOffset - get the total sample frame count, length of audio track in bytes, offset of the audio
       track for a track in an audio file

SYNOPSIS

       #include <audiofile.h>

       AFframecount afGetFrameCount (AFfilehandle file, int track);

       AFfileoffset afGetTrackBytes (AFfilehandle file, int track);

       AFfileoffset afGetDataOffset (AFfilehandle file, int track);

PARAMETERS

       file is an audio file handle created by a previous call to afOpenFile(3).

       track is an integer which specifies an audio track within file. All supported file formats contain exactly one audio track per file, so the
       constant AF_DEFAULT_TRACK should always be used.

DESCRIPTION

       afGetFrameCount returns the total number of sample frames contained within the specified track of the specified file.

       Each sample frame of audio consists of a fixed number of samples (equal to the number of audio channels in the track. For monaural data, a
       sample frame consists of one audio sample. For stereophonic data, a sample frame consists of a stereo pair.

       afGetTrackBytes returns the total number of bytes of raw audio data (i.e., prior to decompression or conversion) in the track.

       afGetDataOffset returns the offset in bytes of the start of the audio data contained within the specified track of the specified file.

RETURN VALUE

       afGetFrameCount returns the total number of sample frames in track.

       afGetTrackBytes returns the total number of bytes of audio data in track.

       afGetDataOffset returns the offset in bytes to the beginning of the audio data in track.

       Each of these routines returns -1 in case of error.

AUTHOR

       Michael Pruett <michael@68k.org>

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