osu/osu.Game/Audio/HitSampleInfo.cs

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

106 lines
3.8 KiB
C#
Raw Normal View History

2019-06-30 12:58:30 +00:00
// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
// See the LICENCE file in the repository root for full licence text.
using System;
using System.Collections.Generic;
2020-12-01 09:09:28 +00:00
using Newtonsoft.Json;
2023-05-16 07:29:24 +00:00
using osu.Game.Beatmaps.ControlPoints;
2020-12-01 06:37:51 +00:00
using osu.Game.Utils;
2019-06-30 12:58:30 +00:00
namespace osu.Game.Audio
{
/// <summary>
/// Describes a gameplay hit sample.
/// </summary>
[Serializable]
public class HitSampleInfo : ISampleInfo, IEquatable<HitSampleInfo>
2019-06-30 12:58:30 +00:00
{
public const string HIT_NORMAL = @"hitnormal";
2019-06-30 12:58:30 +00:00
public const string HIT_WHISTLE = @"hitwhistle";
public const string HIT_FINISH = @"hitfinish";
public const string HIT_CLAP = @"hitclap";
2022-10-19 11:34:41 +00:00
public const string BANK_NORMAL = @"normal";
public const string BANK_SOFT = @"soft";
public const string BANK_DRUM = @"drum";
// new sample used exclusively by taiko for now.
public const string HIT_FLOURISH = "hitflourish";
// new bank used exclusively by taiko for now.
public const string BANK_STRONG = @"strong";
/// <summary>
/// All valid sample addition constants.
/// </summary>
public static IEnumerable<string> AllAdditions => new[] { HIT_WHISTLE, HIT_FINISH, HIT_CLAP };
2022-10-19 11:34:41 +00:00
/// <summary>
/// All valid bank constants.
/// </summary>
public static IEnumerable<string> AllBanks => new[] { BANK_NORMAL, BANK_SOFT, BANK_DRUM };
2019-06-30 12:58:30 +00:00
/// <summary>
2020-12-01 06:37:51 +00:00
/// The name of the sample to load.
2019-06-30 12:58:30 +00:00
/// </summary>
2020-12-01 06:37:51 +00:00
public readonly string Name;
2019-06-30 12:58:30 +00:00
/// <summary>
2020-12-01 06:37:51 +00:00
/// The bank to load the sample from.
2019-06-30 12:58:30 +00:00
/// </summary>
2023-05-16 07:29:24 +00:00
public readonly string Bank;
2019-06-30 12:58:30 +00:00
/// <summary>
/// An optional suffix to provide priority lookup. Falls back to non-suffixed <see cref="Name"/>.
/// </summary>
2020-12-01 06:37:51 +00:00
public readonly string? Suffix;
2019-06-30 12:58:30 +00:00
/// <summary>
/// The sample volume.
/// </summary>
2020-12-01 06:37:51 +00:00
public int Volume { get; }
public HitSampleInfo(string name, string bank = SampleControlPoint.DEFAULT_BANK, string? suffix = null, int volume = 100)
2020-12-01 06:37:51 +00:00
{
Name = name;
Bank = bank;
Suffix = suffix;
Volume = volume;
}
2019-06-30 12:58:30 +00:00
/// <summary>
/// Retrieve all possible filenames that can be used as a source, returned in order of preference (highest first).
/// </summary>
[JsonIgnore]
2019-06-30 12:58:30 +00:00
public virtual IEnumerable<string> LookupNames
{
get
{
if (!string.IsNullOrEmpty(Suffix))
yield return $"Gameplay/{Bank}-{Name}{Suffix}";
2019-06-30 12:58:30 +00:00
yield return $"Gameplay/{Bank}-{Name}";
2019-06-30 12:58:30 +00:00
}
}
2020-12-01 06:37:51 +00:00
/// <summary>
/// Creates a new <see cref="HitSampleInfo"/> with overridden values.
/// </summary>
2020-12-02 01:55:48 +00:00
/// <param name="newName">An optional new sample name.</param>
/// <param name="newBank">An optional new sample bank.</param>
/// <param name="newSuffix">An optional new lookup suffix.</param>
/// <param name="newVolume">An optional new volume.</param>
2020-12-01 06:37:51 +00:00
/// <returns>The new <see cref="HitSampleInfo"/>.</returns>
public virtual HitSampleInfo With(Optional<string> newName = default, Optional<string> newBank = default, Optional<string?> newSuffix = default, Optional<int> newVolume = default)
2020-12-02 01:55:48 +00:00
=> new HitSampleInfo(newName.GetOr(Name), newBank.GetOr(Bank), newSuffix.GetOr(Suffix), newVolume.GetOr(Volume));
public bool Equals(HitSampleInfo? other)
=> other != null && Name == other.Name && Bank == other.Bank && Suffix == other.Suffix;
public override bool Equals(object? obj)
=> obj is HitSampleInfo other && Equals(other);
public override int GetHashCode() => HashCode.Combine(Name, Bank, Suffix);
2019-06-30 12:58:30 +00:00
}
}