osu/osu.Game/Rulesets/Ruleset.cs

105 lines
4.5 KiB
C#
Raw Normal View History

2018-01-05 11:21:19 +00:00
// Copyright (c) 2007-2018 ppy Pty Ltd <contact@ppy.sh>.
// Licensed under the MIT Licence - https://raw.githubusercontent.com/ppy/osu/master/LICENCE
2017-08-13 17:54:07 +00:00
using System;
using System.Collections.Generic;
using System.Linq;
2017-08-14 13:16:22 +00:00
using osu.Framework.Graphics;
using osu.Framework.Input.Bindings;
using osu.Game.Beatmaps;
using osu.Game.Graphics;
2017-08-14 13:16:22 +00:00
using osu.Game.Overlays.Settings;
using osu.Game.Rulesets.Edit;
2017-04-18 07:05:58 +00:00
using osu.Game.Rulesets.Mods;
2017-11-17 05:29:19 +00:00
using osu.Game.Rulesets.Scoring;
2017-04-18 07:05:58 +00:00
using osu.Game.Rulesets.UI;
2017-04-18 07:05:58 +00:00
namespace osu.Game.Rulesets
{
public abstract class Ruleset
{
public readonly RulesetInfo RulesetInfo;
public virtual IEnumerable<BeatmapStatistic> GetBeatmapStatistics(WorkingBeatmap beatmap) => new BeatmapStatistic[] { };
public IEnumerable<Mod> GetAllMods() => Enum.GetValues(typeof(ModType)).Cast<ModType>()
2017-12-08 09:55:25 +00:00
// Confine all mods of each mod type into a single IEnumerable<Mod>
2017-12-11 05:52:15 +00:00
.SelectMany(GetModsFor)
2017-12-08 09:55:25 +00:00
// Filter out all null mods
2017-12-11 05:52:15 +00:00
.Where(mod => mod != null)
// Resolve MultiMods as their .Mods property
2017-12-08 09:55:25 +00:00
.SelectMany(mod => (mod as MultiMod)?.Mods ?? new[] { mod });
public abstract IEnumerable<Mod> GetModsFor(ModType type);
public Mod GetAutoplayMod() => GetAllMods().First(mod => mod is ModAutoplay);
2017-08-03 16:25:24 +00:00
protected Ruleset(RulesetInfo rulesetInfo = null)
{
RulesetInfo = rulesetInfo ?? createRulesetInfo();
}
2017-04-20 02:36:50 +00:00
/// <summary>
/// Attempt to create a hit renderer for a beatmap
2017-04-20 02:36:50 +00:00
/// </summary>
/// <param name="beatmap">The beatmap to create the hit renderer for.</param>
/// <param name="isForCurrentRuleset">Whether the hit renderer should assume the beatmap is for the current ruleset.</param>
2017-04-20 02:36:50 +00:00
/// <exception cref="BeatmapInvalidForRulesetException">Unable to successfully load the beatmap to be usable with this ruleset.</exception>
/// <returns></returns>
2017-08-09 04:28:29 +00:00
public abstract RulesetContainer CreateRulesetContainerWith(WorkingBeatmap beatmap, bool isForCurrentRuleset);
public abstract DifficultyCalculator CreateDifficultyCalculator(Beatmap beatmap, Mod[] mods = null);
public virtual PerformanceCalculator CreatePerformanceCalculator(Beatmap beatmap, Score score) => null;
public virtual HitObjectComposer CreateHitObjectComposer() => null;
public virtual Drawable CreateIcon() => new SpriteIcon { Icon = FontAwesome.fa_question_circle };
2017-01-30 04:35:40 +00:00
public abstract string Description { get; }
2017-07-11 18:25:24 +00:00
public virtual SettingsSubsection CreateSettings() => null;
2017-04-17 08:43:48 +00:00
/// <summary>
/// Do not override this unless you are a legacy mode.
/// </summary>
public virtual int LegacyID => -1;
2017-12-08 09:55:25 +00:00
/// <summary>
/// A unique short name to reference this ruleset in online requests.
/// </summary>
public abstract string ShortName { get; }
/// <summary>
/// A list of available variant ids.
/// </summary>
public virtual IEnumerable<int> AvailableVariants => new[] { 0 };
/// <summary>
/// Get a list of default keys for the specified variant.
/// </summary>
/// <param name="variant">A variant.</param>
/// <returns>A list of valid <see cref="KeyBinding"/>s.</returns>
public virtual IEnumerable<KeyBinding> GetDefaultKeyBindings(int variant = 0) => new KeyBinding[] { };
2017-08-23 05:19:14 +00:00
/// <summary>
/// Gets the name for a key binding variant. This is used for display in the settings overlay.
/// </summary>
/// <param name="variant">The variant.</param>
/// <returns>A descriptive name of the variant.</returns>
public virtual string GetVariantName(int variant) => string.Empty;
/// <summary>
/// Create a ruleset info based on this ruleset.
/// </summary>
/// <returns>A filled <see cref="RulesetInfo"/>.</returns>
private RulesetInfo createRulesetInfo() => new RulesetInfo
{
Name = Description,
ShortName = ShortName,
InstantiationInfo = GetType().AssemblyQualifiedName,
ID = LegacyID
};
}
}