/// <summary>
/// Create and Load a sound effect from an input wav stream.
/// </summary>
/// <param name="engine">Name of the audio engine in which to create the sound effect</param>
/// <param name="stream">A stream corresponding to a wav file.</param>
/// <returns>A new instance soundEffect ready to be played</returns>
/// <exception cref="ArgumentNullException"><paramref name="engine"/> or <paramref name="stream"/> is null.</exception>
/// <exception cref="NotSupportedException">The wave file or has more than 2 channels or is not encoded in 16bits.</exception>
/// <exception cref="InvalidOperationException">The content of the stream does not correspond to a valid wave file.</exception>
/// <exception cref="OutOfMemoryException">There is not enough memory anymore to load the specified file in memory. </exception>
/// <exception cref="ObjectDisposedException">The audio engine has already been disposed</exception>
/// <remarks>Supported WAV files' audio format is the 16bits PCM format.</remarks>
public static SoundEffect Load(AudioEngine engine, Stream stream)
{
if(engine == null)
throw new ArgumentNullException("engine");
var newSdEff = new SoundEffect();
newSdEff.AttachEngine(engine);
newSdEff.Load(stream);
return newSdEff;
}
/// <summary>
/// Create and Load a sound effect from an input wav stream.
/// </summary>
/// <param name="engine">Name of the audio engine in which to create the sound effect</param>
/// <param name="stream">A stream corresponding to a wav file.</param>
/// <returns>A new instance soundEffect ready to be played</returns>
/// <exception cref="ArgumentNullException"><paramref name="engine"/> or <paramref name="stream"/> is null.</exception>
/// <exception cref="NotSupportedException">The wave file or has more than 2 channels or is not encoded in 16bits.</exception>
/// <exception cref="InvalidOperationException">The content of the stream does not correspond to a valid wave file.</exception>
/// <exception cref="OutOfMemoryException">There is not enough memory anymore to load the specified file in memory. </exception>
/// <exception cref="ObjectDisposedException">The audio engine has already been disposed</exception>
/// <remarks>Supported WAV files' audio format is the 16bits PCM format.</remarks>
public static SoundEffect Load(AudioEngine engine, Stream stream)
{
if (engine == null)
{
throw new ArgumentNullException("engine");
}
var newSdEff = new SoundEffect();
newSdEff.AttachEngine(engine);
newSdEff.Load(stream);
return(newSdEff);
}