1
0
mirror of https://github.com/ppy/osu.git synced 2024-12-16 14:13:21 +08:00
osu-lazer/osu.Game/Overlays/OnScreenDisplay.cs

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

134 lines
5.4 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
2022-06-17 15:37:17 +08:00
#nullable disable
2017-05-16 11:53:50 +08:00
using System;
using System.Collections.Generic;
using osu.Framework.Configuration;
using osu.Framework.Configuration.Tracking;
2017-05-16 11:53:50 +08:00
using osu.Framework.Graphics;
using osu.Framework.Graphics.Containers;
using osu.Framework.Graphics.Transforms;
using osu.Framework.Threading;
using osu.Game.Overlays.OSD;
using osuTK;
2018-04-13 17:19:50 +08:00
2017-05-16 11:53:50 +08:00
namespace osu.Game.Overlays
{
/// <summary>
/// An on-screen display which automatically tracks and displays toast notifications for <seealso cref="TrackedSettings"/>.
/// Can also display custom content via <see cref="Display(Toast)"/>
/// </summary>
2017-05-16 11:53:50 +08:00
public partial class OnScreenDisplay : Container
{
private readonly Container box;
2018-04-13 17:19:50 +08:00
2017-05-16 11:53:50 +08:00
private const float height = 110;
private const float height_contracted = height * 0.9f;
2018-04-13 17:19:50 +08:00
2017-05-16 11:53:50 +08:00
public OnScreenDisplay()
{
RelativeSizeAxes = Axes.Both;
2018-04-13 17:19:50 +08:00
2017-05-16 11:53:50 +08:00
Children = new Drawable[]
{
box = new Container
{
Origin = Anchor.Centre,
RelativePositionAxes = Axes.Both,
Position = new Vector2(0.5f, 0.75f),
Masking = true,
AutoSizeAxes = Axes.X,
Height = height_contracted,
Alpha = 0,
CornerRadius = 20,
},
};
}
2018-04-13 17:19:50 +08:00
private readonly Dictionary<(object, IConfigManager), TrackedSettings> trackedConfigManagers = new Dictionary<(object, IConfigManager), TrackedSettings>();
2018-04-13 17:19:50 +08:00
/// <summary>
/// Registers a <see cref="ConfigManager{T}"/> to have its settings tracked by this <see cref="OnScreenDisplay"/>.
/// </summary>
/// <param name="source">The object that is registering the <see cref="ConfigManager{T}"/> to be tracked.</param>
/// <param name="configManager">The <see cref="ConfigManager{T}"/> to be tracked.</param>
/// <exception cref="ArgumentNullException">If <paramref name="configManager"/> is null.</exception>
/// <exception cref="InvalidOperationException">If <paramref name="configManager"/> is already being tracked from the same <paramref name="source"/>.</exception>
public void BeginTracking(object source, ITrackableConfigManager configManager)
{
ArgumentNullException.ThrowIfNull(configManager);
2018-04-13 17:19:50 +08:00
if (trackedConfigManagers.ContainsKey((source, configManager)))
throw new InvalidOperationException($"{nameof(configManager)} is already registered.");
2018-04-13 17:19:50 +08:00
var trackedSettings = configManager.CreateTrackedSettings();
if (trackedSettings == null)
return;
2018-04-13 17:19:50 +08:00
configManager.LoadInto(trackedSettings);
trackedSettings.SettingChanged += displayTrackedSettingChange;
2018-04-13 17:19:50 +08:00
trackedConfigManagers.Add((source, configManager), trackedSettings);
}
2018-04-13 17:19:50 +08:00
/// <summary>
/// Unregisters a <see cref="ConfigManager{T}"/> from having its settings tracked by this <see cref="OnScreenDisplay"/>.
/// </summary>
/// <param name="source">The object that registered the <see cref="ConfigManager{T}"/> to be tracked.</param>
/// <param name="configManager">The <see cref="ConfigManager{T}"/> that is being tracked.</param>
/// <exception cref="ArgumentNullException">If <paramref name="configManager"/> is null.</exception>
2019-11-17 20:49:36 +08:00
/// <exception cref="InvalidOperationException">If <paramref name="configManager"/> is not being tracked from the same <paramref name="source"/>.</exception>
public void StopTracking(object source, ITrackableConfigManager configManager)
2017-05-16 11:53:50 +08:00
{
ArgumentNullException.ThrowIfNull(configManager);
2018-04-13 17:19:50 +08:00
if (!trackedConfigManagers.TryGetValue((source, configManager), out var existing))
2019-01-24 23:02:47 +08:00
return;
2018-04-13 17:19:50 +08:00
existing.Unload();
existing.SettingChanged -= displayTrackedSettingChange;
2018-04-13 17:19:50 +08:00
trackedConfigManagers.Remove((source, configManager));
2017-05-16 11:53:50 +08:00
}
2018-04-13 17:19:50 +08:00
/// <summary>
/// Displays the provided <see cref="Toast"/> temporarily.
/// </summary>
/// <param name="toast"></param>
public void Display(Toast toast) => Schedule(() =>
2017-05-16 11:53:50 +08:00
{
box.Child = toast;
DisplayTemporarily(box);
});
2018-04-13 17:19:50 +08:00
private void displayTrackedSettingChange(SettingDescription description) => Scheduler.AddOnce(Display, new TrackedSettingToast(description));
private TransformSequence<Drawable> fadeIn;
private ScheduledDelegate fadeOut;
protected virtual void DisplayTemporarily(Drawable toDisplay)
{
// avoid starting a new fade-in if one is already active.
if (fadeIn == null)
{
fadeIn = toDisplay.Animate(
b => b.FadeIn(500, Easing.OutQuint),
b => b.ResizeHeightTo(height, 500, Easing.OutQuint)
);
fadeIn.Finally(_ => fadeIn = null);
}
fadeOut?.Cancel();
fadeOut = Scheduler.AddDelayed(() =>
{
toDisplay.Animate(
b => b.FadeOutFromOne(1500, Easing.InQuint),
b => b.ResizeHeightTo(height_contracted, 1500, Easing.InQuint));
}, 500);
}
2017-05-16 11:53:50 +08:00
}
}