Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
AFINITSAMPLEFORMAT(3)					   AFINITSAMPLEFORMAT(3)

NAME
     afInitSampleFormat,  afInitByteOrder, afInitChannels, afInitRate - initial-
     ize 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 afNewFileSetup(3).

     track specifies a track within the audio file setup. track is always AF_DE-
     FAULT_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_LITTLEEN-
     DIAN.

     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:

     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:

     AF_BAD_SAMPFMT   sampleFormat does not  rep-
		      resent  a valid sample for-
		      mat.

     AF_BAD_WIDTH     sampleWidth is not a  valid
		      sample width.

     afInitByteOrder can also produce the following error:

     AF_BAD_BYTEORDER	byteOrder  does  not repre-
			sent a valid byte order.

     afInitChannels can also produce the following error:

     AF_BAD_CHANNELS   channels specifies  an  in-
		       valid number of channels.

     afInitRate can also produce the following error:

     AF_BAD_RATE   rate  specifies  an invalid
		   sample rate.

SEE ALSO
     afNewFileSetup(3), afInitFileFormat(3), afInitCompression(3), afOpenFile(3)

AUTHOR
     Michael Pruett <michael@68k.org>

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

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=afInitSampleFormat&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help