ExtendedAudioFile.h

/*
   ExtendedAudioFile.h

   Copyright (C) 2026 Free Software Foundation, Inc.

   Author: Gregory John Casamento <greg.casamento@gmail.com>
   Date: August 2026

   This file is part of the GNUstep AudioToolbox Library.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2.1 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General Public
   License along with this library; see the file COPYING.LIB.
   If not, see <http://www.gnu.org/licenses/> or write to the
   Free Software Foundation, 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301, USA.
*/

#ifndef GNUSTEP_AUDIOTOOLBOX_EXTENDEDAUDIOFILE_H
#define GNUSTEP_AUDIOTOOLBOX_EXTENDEDAUDIOFILE_H

#include "AudioFile.h"

#ifdef __cplusplus
extern "C" {
#endif

typedef struct OpaqueExtAudioFile *ExtAudioFileRef;

enum {
  kExtAudioFileProperty_FileDataFormat = AT_MAKE_FOURCC('f','f','m','t'),
  kExtAudioFileProperty_ClientDataFormat = AT_MAKE_FOURCC('c','f','m','t'),
  kExtAudioFileProperty_AudioFile = AT_MAKE_FOURCC('a','f','i','l')
};

OSStatus ExtAudioFileOpenURL(CFURLRef inURL, ExtAudioFileRef *outExtAudioFile);
OSStatus ExtAudioFileCreateWithURL(CFURLRef inURL,
                                   AudioFileTypeID inFileType,
                                   const AudioStreamBasicDescription *inStreamDesc,
                                   const void *inChannelLayout,
                                   UInt32 inFlags,
                                   ExtAudioFileRef *outExtAudioFile);
OSStatus ExtAudioFileWrapAudioFileID(AudioFileID inFileID,
                                     Boolean inForWriting,
                                     ExtAudioFileRef *outExtAudioFile);
OSStatus ExtAudioFileDispose(ExtAudioFileRef inExtAudioFile);
OSStatus ExtAudioFileRead(ExtAudioFileRef inExtAudioFile,
                          UInt32 *ioNumberFrames,
                          AudioBufferList *ioData);
OSStatus ExtAudioFileWrite(ExtAudioFileRef inExtAudioFile,
                           UInt32 inNumberFrames,
                           const AudioBufferList *ioData);
OSStatus ExtAudioFileGetProperty(ExtAudioFileRef inExtAudioFile,
                                 UInt32 inPropertyID,
                                 UInt32 *ioPropertyDataSize,
                                 void *outPropertyData);
OSStatus ExtAudioFileSetProperty(ExtAudioFileRef inExtAudioFile,
                                 UInt32 inPropertyID,
                                 UInt32 inPropertyDataSize,
                                 const void *inPropertyData);

#ifdef __cplusplus
}
#endif

#endif