afInitAESChannelData(3dm)			     afInitAESChannelData(3dm)

NAME    [Toc]    [Back]

     afInitAESChannelData, afInitAESChannelDataTo - set	a flag in an
     AFfilesetup so that storage space for AES channel status data is reserved
     in	/ removed from a file.

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audiofile.h>

     void afInitAESChannelData(AFfilesetup setup, int track)

     void afInitAESChannelDataTo(AFfilesetup setup, int	track,
				 int usedata)

PARAMETER    [Toc]    [Back]

     setup   is	an AFfilesetup structure, previously created by	a call to
	     afNewFileSetup(3dm).

     track   is	an integer identifier which identifies an audio	track in
	     setup.  For now, the constant value AF_DEFAULT_TRACK should
	     always be used for	this argument.

     usedata is	a flag indicating whether AES data will	be stored in the
	     file.

DESCRIPTION    [Toc]    [Back]

     afInitAESChannelData() sets a flag	in an AFfilesetup structure which
     indicates that space should be reserved for 24 AES	channel	status bytes.

     It	is necessary to	allocate header	space by calling
     afInitAESChannelData() before afOpenFile(3dm) in order to store AES
     channel status information	for a track by calling afSetAESChannelData().

     afInitAESChannelDataTo is designed	to replace the older
     afInitAESChannelData.  This new routine allows a user to remove AES data
     storage from a file by setting usedata to 0.

CAVEATS    [Toc]    [Back]

     This function 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).  In the currently
     supported file formats which allow	AES data (AIFF and AIFF-C), the
     presence of AES channel status data is optional.

SEE ALSO    [Toc]    [Back]

     afNewFileSetup(3dm), afOpenFile(3dm), afSetAESChannelData(3dm),
     afInitAESChannelDataTo(3dm)
afInitAESChannelData(3dm)			     afInitAESChannelData(3dm)

NAME    [Toc]    [Back]

     afInitAESChannelData, afInitAESChannelDataTo - set	a flag in an
     AFfilesetup so that storage space for AES channel status data is reserved
     in	/ removed from a file.

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/audiofile.h>

     void afInitAESChannelData(AFfilesetup setup, int track)

     void afInitAESChannelDataTo(AFfilesetup setup, int	track,
				 int usedata)

PARAMETER    [Toc]    [Back]

     setup   is	an AFfilesetup structure, previously created by	a call to
	     afNewFileSetup(3dm).

     track   is	an integer identifier which identifies an audio	track in
	     setup.  For now, the constant value AF_DEFAULT_TRACK should
	     always be used for	this argument.

     usedata is	a flag indicating whether AES data will	be stored in the
	     file.

DESCRIPTION    [Toc]    [Back]

     afInitAESChannelData() sets a flag	in an AFfilesetup structure which
     indicates that space should be reserved for 24 AES	channel	status bytes.

     It	is necessary to	allocate header	space by calling
     afInitAESChannelData() before afOpenFile(3dm) in order to store AES
     channel status information	for a track by calling afSetAESChannelData().

     afInitAESChannelDataTo is designed	to replace the older
     afInitAESChannelData.  This new routine allows a user to remove AES data
     storage from a file by setting usedata to 0.

CAVEATS    [Toc]    [Back]

     This function 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).  In the currently
     supported file formats which allow	AES data (AIFF and AIFF-C), the
     presence of AES channel status data is optional.

SEE ALSO    [Toc]    [Back]

     afNewFileSetup(3dm), afOpenFile(3dm), afSetAESChannelData(3dm),
     afInitAESChannelDataTo(3dm)


									PPPPaaaaggggeeee 1111