MoonWorks/src/Audio/AudioDataStreamable.cs

namespace MoonWorks.Audio
{
	/// <summary>
	/// Use this in conjunction with a StreamingVoice to play back streaming audio data.
	/// </summary>
	public abstract class AudioDataStreamable : AudioResource
	{
		public Format Format { get; protected set; }
		public abstract bool Loaded { get; }
		public abstract uint DecodeBufferSize { get; }

		protected AudioDataStreamable(AudioDevice device) : base(device)
		{
		}

		/// <summary>
		/// Loads the raw audio data into memory to prepare it for stream decoding.
		/// </summary>
		public abstract void Load();

		/// <summary>
		/// Unloads the raw audio data from memory.
		/// </summary>
		public abstract void Unload();

		/// <summary>
		/// Seeks to the given sample frame.
		/// </summary>
		public abstract void Seek(uint sampleFrame);

		/// <summary>
		/// Attempts to decodes data of length bufferLengthInBytes into the provided buffer.
		/// </summary>
		/// <param name="buffer">The buffer that decoded bytes will be placed into.</param>
		/// <param name="bufferLengthInBytes">Requested length of decoded audio data.</param>
		/// <param name="filledLengthInBytes">How much data was actually filled in by the decode.</param>
		/// <param name="reachedEnd">Whether the end of the data was reached on this decode.</param>
		public abstract unsafe void Decode(void* buffer, int bufferLengthInBytes, out int filledLengthInBytes, out bool reachedEnd);

		protected override void Dispose(bool disposing)
		{
			if (!IsDisposed)
			{
				Unload();
			}
			base.Dispose(disposing);
		}
	}
}