1
0
mirror of https://github.com/ppy/osu.git synced 2024-12-16 09:17:31 +08:00
osu-lazer/osu.Game/Beatmaps/BeatmapConverter.cs

115 lines
3.9 KiB
C#
Raw Normal View History

// 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.
2018-04-13 17:19:50 +08:00
using System;
using System.Collections.Generic;
using System.Linq;
using osu.Game.Rulesets.Objects;
namespace osu.Game.Beatmaps
{
/// <summary>
/// Converts a Beatmap for another mode.
/// </summary>
/// <typeparam name="T">The type of HitObject stored in the Beatmap.</typeparam>
public abstract class BeatmapConverter<T> : IBeatmapConverter
where T : HitObject
{
private event Action<HitObject, IEnumerable<HitObject>> ObjectConverted;
2019-02-28 12:31:40 +08:00
2018-04-13 17:19:50 +08:00
event Action<HitObject, IEnumerable<HitObject>> IBeatmapConverter.ObjectConverted
{
add => ObjectConverted += value;
remove => ObjectConverted -= value;
}
public IBeatmap Beatmap { get; }
protected BeatmapConverter(IBeatmap beatmap)
{
Beatmap = beatmap;
}
2018-04-13 17:19:50 +08:00
/// <summary>
/// Whether <see cref="Beatmap"/> can be converted by this <see cref="BeatmapConverter{T}"/>.
2018-04-13 17:19:50 +08:00
/// </summary>
public bool CanConvert => !Beatmap.HitObjects.Any() || ValidConversionTypes.All(t => Beatmap.HitObjects.Any(t.IsInstanceOfType));
2018-04-13 17:19:50 +08:00
/// <summary>
/// Converts <see cref="Beatmap"/>.
2018-04-13 17:19:50 +08:00
/// </summary>
/// <returns>The converted Beatmap.</returns>
public IBeatmap Convert()
2018-04-13 17:19:50 +08:00
{
// We always operate on a clone of the original beatmap, to not modify it game-wide
return ConvertBeatmap(Beatmap.Clone());
2018-04-13 17:19:50 +08:00
}
/// <summary>
/// Performs the conversion of a Beatmap using this Beatmap Converter.
/// </summary>
/// <param name="original">The un-converted Beatmap.</param>
/// <returns>The converted Beatmap.</returns>
2018-04-19 19:44:38 +08:00
protected virtual Beatmap<T> ConvertBeatmap(IBeatmap original)
2018-04-13 17:19:50 +08:00
{
var beatmap = CreateBeatmap();
beatmap.BeatmapInfo = original.BeatmapInfo;
beatmap.ControlPointInfo = original.ControlPointInfo;
2018-10-11 19:29:26 +08:00
beatmap.HitObjects = convertHitObjects(original.HitObjects, original);
2018-04-13 17:19:50 +08:00
beatmap.Breaks = original.Breaks;
return beatmap;
}
2018-10-11 19:29:26 +08:00
private List<T> convertHitObjects(IReadOnlyList<HitObject> hitObjects, IBeatmap beatmap)
2018-04-13 17:19:50 +08:00
{
2018-10-11 19:29:26 +08:00
var result = new List<T>(hitObjects.Count);
2018-04-13 17:19:50 +08:00
2018-10-11 19:29:26 +08:00
foreach (var obj in hitObjects)
2018-04-13 17:19:50 +08:00
{
2018-10-11 19:29:26 +08:00
if (obj is T tObj)
{
result.Add(tObj);
2018-04-13 17:19:50 +08:00
continue;
2018-10-11 19:29:26 +08:00
}
var converted = ConvertHitObject(obj, beatmap);
2018-04-13 17:19:50 +08:00
2018-10-16 11:01:58 +08:00
if (ObjectConverted != null)
{
converted = converted.ToList();
ObjectConverted.Invoke(obj, converted);
}
2018-10-11 19:29:26 +08:00
foreach (var c in converted)
{
if (c != null)
result.Add(c);
}
2018-04-13 17:19:50 +08:00
}
2018-10-11 19:29:26 +08:00
return result;
2018-04-13 17:19:50 +08:00
}
/// <summary>
/// The types of HitObjects that can be converted to be used for this Beatmap.
/// </summary>
protected abstract IEnumerable<Type> ValidConversionTypes { get; }
/// <summary>
2019-04-25 16:36:17 +08:00
/// Creates the <see cref="Beatmap{T}"/> that will be returned by this <see cref="BeatmapProcessor"/>.
2018-04-13 17:19:50 +08:00
/// </summary>
protected virtual Beatmap<T> CreateBeatmap() => new Beatmap<T>();
/// <summary>
/// Performs the conversion of a hit object.
/// This method is generally executed sequentially for all objects in a beatmap.
/// </summary>
/// <param name="original">The hit object to convert.</param>
/// <param name="beatmap">The un-converted Beatmap.</param>
/// <returns>The converted hit object.</returns>
2018-04-19 19:44:38 +08:00
protected abstract IEnumerable<T> ConvertHitObject(HitObject original, IBeatmap beatmap);
2018-04-13 17:19:50 +08:00
}
}