#pragma once
// Copyright (c) 2015 - 2025 kio@little-bat.de
// BSD-2-Clause license
// https://opensource.org/licenses/BSD-2-Clause

/* 	initially based on
		libaudiodecoder - Native Portable Audio Decoder Library
		libaudiodecoder API Header File
		http://www.oscillicious.com/libaudiodecoder
		Copyright (c) 2010-2012 Albert Santoni, Bill Good, RJ Ryan
 */

#include "kio/kio.h"

#ifdef _MACOSX
  #include "macos/CAStreamBasicDescription.h"
  #include <AudioToolbox/AudioToolbox.h>

  #if !defined(__COREAUDIO_USE_FLAT_INCLUDES__)
	#include <AudioToolbox/AudioFile.h>
	#include <AudioToolbox/AudioFormat.h>
	#include <CoreAudio/CoreAudioTypes.h>
	#include <CoreServices/CoreServices.h>
  #else
	#include "AudioFile.h"
	#include "AudioFormat.h"
	#include "CoreAudioTypes.h"
  #endif
#endif

class AudioDecoder
{
	cstr	filename;
	uint64	num_frames;		   // total number of frames (~samples) in file
	float64 frames_per_second; // sample rate in file
	uint	num_channels;	   // number of channels in file
	uint	sizeof_sample;	   // sample size in file (2=int16, 4=float32)

#ifdef _MACOSX
	ExtAudioFileRef			 audiofile;		// OSX handle for audio file
	CAStreamBasicDescription file_format;	// file format data
	CAStreamBasicDescription client_format; // client format data
#endif

	uint32 frame_position; // current play position in file [samples]

	uint32 read_buffer(void* bu, uint num_channels, uint32 num_frames, uint sizeof_sample) noexcept(false);

public:
	AudioDecoder();
	~AudioDecoder();

	// Open file for decoding
	// if there is already a file open, then it will be closed first.
	void open(cstr filename);

	// close file. you may reuse the decoder.
	int /*err*/ close();

	// Read a maximum of max_frames of audio into a buffer.
	//	Samples are returned as 32-bit floats, with stereo interlacing if num_channels=2.
	//	Returns the number of samples read, 0 at end of file.
	uint32 read(float32*, uint32 max_frames, uint num_channels);

	// Read a maximum of max_frames of audio into a buffer.
	//	Samples are returned as 16-bit signed integers, with stereo interlacing if num_channels=2.
	//	Returns the number of samples read, 0 at end of file.
	uint32 read(int16*, uint32 max_frames, uint num_channels);

	// Seek to a sample in the file
	void seekSamplePosition(uint32 frame_position);

	// Get the current playback position in samples
	uint32 getSamplePosition() const { return frame_position; }

	// Get the number of sample frames in the file. This will be a good estimate of the
	//	number of samples you can get out of read(), though you should not rely on it
	//	being perfectly accurate always. e.g. it might be slightly inaccurate with VBR MP3s
	// better read() until read() returns 0
	uint64 numSamples() const { return num_frames; }

	// get size of samples in the audio file
	uint sizeofSample() const { return sizeof_sample; }

	// Get number of channels in the audio file
	uint numChannels() const { return num_channels; }

	// Get sample rate of the audio file
	double samplesPerSecond() const { return frames_per_second; }

	// Get the play time of the audio file [seconds]
	double playtime() const { return double(num_frames) / frames_per_second; }

	// get filename:
	cstr getFilename() const { return filename; }

	// Get a NULL-terminated list of the filetypes supported by the decoder, by extension
	static cstr* supportedFileExtensions();
};