*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> audiofile/AFgetaeschanneldata (3d)              
Title
Content
Arch
Section
 

Contents


afGetAESChannelData(3dm)			      afGetAESChannelData(3dm)


NAME    [Toc]    [Back]

     afGetAESChannelData, afSetAESChannelData -	get/set	AES channel status
     information in an AFfilehandle structure for an audio track

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audiofile.h>

     int afGetAESChannelData(AFfilehandle file,	int track,
			      unsigned char buf[24])

     void afSetAESChannelData(AFfilehandle file, int track,
			      unsigned char buf[24])

PARAMETER    [Toc]    [Back]

     file    expects an	AFfilehandle structure,	previously created by a	call
	     to	afOpenFile(3dm).

     track   expects an	integer	which identifies the audio track in the	file.
	     Since all currently supported file	formats	allow at most one
	     audio track per file, the constant	value AF_DEFAULT_TRACK should
	     always be used for	this argument for now.

     buf     is	a data buffer used to pass the 24 bytes	of AES channel status
	     data to afSetAESChannelData(), or to obtain the 24	bytes of AES
	     channel status data from afGetAESChannelData().

RETURN VALUE    [Toc]    [Back]

     afGetAESChannelData() returns 0 if	there is no AES	channel	status
     information associated with the given track, 1 if there is	AES data, and
     -1	in the event of	an error.

DESCRIPTION    [Toc]    [Back]

     afSetAESChannelData() writes the specified	AES channel status data	bytes
     into the appropriate header location of file.  If no header space has
     been reserved in the header by afInitAESChannelData(3dm), the routine
     will ignore the data and return.

     afGetAESChannelData() copies the channel status data for track into buf.
     If	no AES channel status data is found, it	returns	0.

CAVEATS    [Toc]    [Back]

     These functions will always manipulate data that is to be interpreted as
     AES channel status	data, but there	is never any guarantee that such data
     will be present in	a given	input file or not, or will be allowed in a
     given output file or not (unless the file format of the file being	read
     or	written	requires that AES data is always present).  Even in the
     formats AIFF and AIFF-C, the presence of AES channel status data is
     optional.







									Page 1






afGetAESChannelData(3dm)			      afGetAESChannelData(3dm)



SEE ALSO
     afOpenFile(3dm), afReadFrames(3dm), afInitChannels(3dm), aifc(4)
afGetAESChannelData(3dm)			      afGetAESChannelData(3dm)


NAME    [Toc]    [Back]

     afGetAESChannelData, afSetAESChannelData -	get/set	AES channel status
     information in an AFfilehandle structure for an audio track

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audiofile.h>

     int afGetAESChannelData(AFfilehandle file,	int track,
			      unsigned char buf[24])

     void afSetAESChannelData(AFfilehandle file, int track,
			      unsigned char buf[24])

PARAMETER    [Toc]    [Back]

     file    expects an	AFfilehandle structure,	previously created by a	call
	     to	afOpenFile(3dm).

     track   expects an	integer	which identifies the audio track in the	file.
	     Since all currently supported file	formats	allow at most one
	     audio track per file, the constant	value AF_DEFAULT_TRACK should
	     always be used for	this argument for now.

     buf     is	a data buffer used to pass the 24 bytes	of AES channel status
	     data to afSetAESChannelData(), or to obtain the 24	bytes of AES
	     channel status data from afGetAESChannelData().

RETURN VALUE    [Toc]    [Back]

     afGetAESChannelData() returns 0 if	there is no AES	channel	status
     information associated with the given track, 1 if there is	AES data, and
     -1	in the event of	an error.

DESCRIPTION    [Toc]    [Back]

     afSetAESChannelData() writes the specified	AES channel status data	bytes
     into the appropriate header location of file.  If no header space has
     been reserved in the header by afInitAESChannelData(3dm), the routine
     will ignore the data and return.

     afGetAESChannelData() copies the channel status data for track into buf.
     If	no AES channel status data is found, it	returns	0.

CAVEATS    [Toc]    [Back]

     These functions will always manipulate data that is to be interpreted as
     AES channel status	data, but there	is never any guarantee that such data
     will be present in	a given	input file or not, or will be allowed in a
     given output file or not (unless the file format of the file being	read
     or	written	requires that AES data is always present).  Even in the
     formats AIFF and AIFF-C, the presence of AES channel status data is
     optional.







									Page 1






afGetAESChannelData(3dm)			      afGetAESChannelData(3dm)



SEE ALSO
     afOpenFile(3dm), afReadFrames(3dm), afInitChannels(3dm), aifc(4)


									PPPPaaaaggggeeee 2222
[ Back ]
 Similar pages
Name OS Title
AFgetchannels IRIX get the number of interleaved track / virtual channels from an AFfilehandle structure for an audio track
afGetFrameSize IRIX get the track / virtual frame size in bytes for a specified audio track from an AFfilehandle structure
afGetPCMMapping IRIX get the track / virtual PCM mapping values for a specified audio track from an AFfilehandle structure
AFgetrate IRIX get the track/virtual sample rate for a specified audio track from an AFfilehandle structure
AFgetsampfmt IRIX get the track / virtual sample format or byte order for a specified audio track from an AFfilehandle structure
AFgetcompression IRIX get the compression type and parameters for an audio track from an AFfilehandle structure
afSetChannelMatrix IRIX set the channel mix matrix associated with a given track in an AFfilehandle
afSetVirtualFormatParams IRIX set/get the virtual audio data format in an AFfilehandle for a specified audio track via dmParams
afGetFormatParams IRIX get the audio data format in an AFfilehandle for a specified audio track via dmParams
AFgetloopstart IRIX get the start/end markers, play mode, and track from an AFfilehandle structure for a specified loop.
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service