|
|
Python Audio Tools 2.10 (Default branch)
11-19-2008
Python Audio Tools is a collection of audio handling programs that work from the command line. These include programs for CD extraction, track conversion from one audio format to another, track renaming and retagging, track identification, CD burning from tracks, and more. It supports internationalized track filenames and metadata using Unicode. It works with high-definition, multi-channel audio as well as CD-quality. Track conversion uses multiple CPUs or CPU cores if available to greatly speed the transcoding process. Track metadata can be retrieved from FreeDB or FreeDB-compatible servers. Audio formats supported are WAV, FLAC, WavPack, MP3, Ogg Vorbis, M4A, and more. License: GNU General Public License v2 Changes:|
|
AFSEEKFRAME(3) AFSEEKFRAME(3) NAME
afSeekFrame, afTellFrame - update or access the current sample frame position for a track in an audio file SYNOPSIS
#include <audiofile.h> AFframecount afSeekFrame(AFfilehandle file, int track, AFframecount frameOffset); AFframecount afTellFrame(AFfilehandle file, int track); PARAMETERS
file is a valid audio file handle created by afOpenFile(3). track identifies an audio track within the file. track is always AF_DEFAULT_TRACK for all currently supported audio file formats. frameOffset is a sample frame offset. Valid sample frame offsets must be greater than or equal to zero and strictly less than the number of sample frames contained within the specified audio track. The special value -1 is also allowed. DESCRIPTION
afSeekFrame moves the logical file position for a specified audio track to a desired sample frame location. If frameOffset is -1, afSeekFrame will not modify the current file offset and will instead return the current file position. afTellFrame returns current file position in sample frames. RETURN VALUE
On success, afSeekFrame and afTellFrame will return the current file position as measured in sample frames from the start of the audio track. On failure, afSeekFrame and afTellFrame will return the value -1. ERRORS
The following errors can be generated by afSeekFrame or afTellFrame: AF_BAD_FILEHANDLE file does not represent a valid file handle. AF_BAD_TRACK track does not identify a valid track. AF_BAD_LSEEK A call to lseek failed. AUTHOR
Michael Pruett <michael@68k.org> Audio File Library 0.3.6 03/06/2013 AFSEEKFRAME(3)