using Robust.Shared.Audio;
using Robust.Shared.Prototypes;
using Robust.Shared.Random;
namespace Content.Shared.Audio
{
public static class AudioHelpers{
///
/// Returns a random pitch.
///
public static AudioParams WithVariation(float amplitude)
{
var scale = (float)(IoCManager.Resolve().NextGaussian(1, amplitude));
return AudioParams.Default.WithPitchScale(scale);
}
// Might as well just hardcode these because the audio system is limited to pitching up and down
// by 12 semitones anyway (ie. 0.5 to 2.0 multiplier).
private static readonly float[] SemitoneMultipliers =
{
0.5f, 233.08f/440f, 246.94f/440f, 261.63f/440f,
277.18f/440f, 293.66f/440f, 311.13f/440f, 329.63f/440f,
349.23f/440f, 369.99f/440f, 392.00f/440f, 415.30f/440f,
1.0f,
466.16f/440f, 493.88f/440f, 523.25f/440f, 554.37f/440f,
587.33f/440f, 622.25f/440f, 659.26f/440f, 698.46f/440f,
739.99f/440f, 783.99f/440f, 830.61f/440f, 2.0f
};
///
/// Returns a pitch multiplier that shifts by the given number of semitones.
///
/// Number of semitones to shift, positive or negative. Clamped between -12 and 12
/// which correspond to a pitch multiplier of 0.5 and 2.0 respectively.
public static AudioParams ShiftSemitone(int shift)
{
shift = MathHelper.Clamp(shift, -12, 12);
float pitchMult = SemitoneMultipliers[shift + 12];
return AudioParams.Default.WithPitchScale(pitchMult);
}
///
/// Returns a pitch multiplier shifted by a random number of semitones within variation.
///
/// Max number of semitones to shift in either direction. Values above 12 have no effect.
public static AudioParams WithSemitoneVariation(int variation)
{
variation = Math.Clamp(variation, 0, 12);
return ShiftSemitone(IoCManager.Resolve().Next(-variation, variation));
}
public static string GetRandomFileFromSoundCollection(string name)
{
var soundCollection = IoCManager.Resolve().Index(name);
return IoCManager.Resolve().Pick(soundCollection.PickFiles).ToString();
}
}
}