Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

CentOS 7.0 - man page for aftellframe (centos section 3)

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)


All times are GMT -4. The time now is 01:01 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password