Decoder.h

#pragma once

#include <functional>
#include <memory>
#include <optional>
#include <stdexcept>

// Decoder interface.
class Decoder
{
public:
	Decoder();

	virtual ~Decoder();

	// Decoder shared pointer type.
	using Ptr = std::shared_ptr<Decoder>;

	// A callback which returns true to continue.
	using CanContinue = std::function<bool()>;

	// Reads sample data.
	// 'buffer' - output buffer (floating point format scaled to +/-1.0f).
	// 'sampleCount' - number of samples to read.
	// Returns the number of samples read, or zero if the stream has ended.
	virtual long Read( float* buffer, const long sampleCount ) = 0;

	// Seeks to a 'position' in the stream, in seconds.
	// Returns the new position in seconds.
	virtual float Seek( const float position ) = 0;

	// Returns the duration in seconds.
	float GetDuration() const;

	// Returns the sample rate.
	long GetSampleRate() const;

	// Returns the number of channels.
	long GetChannels() const;

	// Returns the number of bits per sample (if relevant).
	std::optional<long> GetBPS() const;

	// Returns the bitrate in kbps (if relevant).
	std::optional<float> GetBitrate() const;

	// Returns the track gain, in dB, or nullopt if the calculation failed.
	// 'canContinue' - callback which returns whether the calculation can continue.
	// 'secondslimit' - number of seconds to devote to calculating an estimate, or 0 to perform a complete calculation.
	virtual std::optional<float> CalculateTrackGain( CanContinue canContinue, const float secondsLimit = 0 );

	// Skips any leading silence.
	void SkipSilence();

	// Returns whether stream titles are supported.
	virtual bool SupportsStreamTitles() const;

	// Returns the current stream title, and the position (in seconds) at which the title last changed.
	virtual std::pair<float /*seconds*/, std::wstring /*title*/> GetStreamTitle();

protected:
	// Sets the 'duration'.
	void SetDuration( const float duration );

	// Sets the 'sampleRate'.
	void SetSampleRate( const long sampleRate );

	// Sets the number of 'channels'.
	void SetChannels( const long channels );

	// Sets the number of 'bitsPerSample'.
	void SetBPS( const std::optional<long> bitsPerSample );

	// Sets the 'bitrate' in kbps.
	void SetBitrate( const std::optional<float> bitrate );

private:
	// Duration in seconds.
	float m_Duration;

	// Sample rate.
	long m_SampleRate;

	// Number of channels.
	long m_Channels;

	// Bits per sample (if relevant).
	std::optional<long> m_BPS;

	// Bitrate in kbps (if relevant).
	std::optional<float> m_Bitrate;
};