1
0
mirror of https://github.com/ppy/osu.git synced 2024-12-16 11:03:21 +08:00
osu-lazer/osu.Game/Screens/OsuScreen.cs

214 lines
6.8 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
2018-05-28 12:02:06 +08:00
using Microsoft.EntityFrameworkCore.Internal;
2018-04-13 17:19:50 +08:00
using osu.Framework.Allocation;
2018-04-30 01:15:09 +08:00
using osu.Framework.Audio;
using osu.Framework.Audio.Sample;
2019-02-21 18:04:31 +08:00
using osu.Framework.Bindables;
2018-04-30 01:15:09 +08:00
using osu.Framework.Graphics;
using osu.Framework.Input.Bindings;
2018-04-13 17:19:50 +08:00
using osu.Framework.Screens;
using osu.Game.Beatmaps;
using osu.Game.Input.Bindings;
2018-04-13 17:19:50 +08:00
using osu.Game.Rulesets;
using osu.Game.Screens.Menu;
using osu.Game.Overlays;
2018-04-13 17:19:50 +08:00
namespace osu.Game.Screens
{
2019-01-23 19:52:00 +08:00
public abstract class OsuScreen : Screen, IOsuScreen, IKeyBindingHandler<GlobalAction>, IHasDescription
2018-04-13 17:19:50 +08:00
{
2019-01-25 13:10:59 +08:00
/// <summary>
/// The amount of negative padding that should be applied to game background content which touches both the left and right sides of the screen.
/// This allows for the game content to be pushed byt he options/notification overlays without causing black areas to appear.
/// </summary>
public const float HORIZONTAL_OVERFLOW_PADDING = 50;
2018-05-28 12:02:06 +08:00
/// <summary>
/// A user-facing title for this screen.
/// </summary>
public virtual string Title => GetType().ShortDisplayName();
public string Description => Title;
protected virtual bool AllowBackButton => true;
public virtual bool AllowExternalScreenChange => false;
2018-04-13 17:19:50 +08:00
/// <summary>
/// Whether all overlays should be hidden when this screen is entered or resumed.
2018-04-13 17:19:50 +08:00
/// </summary>
public virtual bool HideOverlaysOnEnter => false;
/// <summary>
/// Whether overlays should be able to be opened once this screen is entered or resumed.
/// </summary>
public virtual OverlayActivation InitialOverlayActivationMode => OverlayActivation.All;
2018-04-13 17:19:50 +08:00
public virtual bool CursorVisible => true;
protected new OsuGameBase Game => base.Game as OsuGameBase;
2019-02-01 14:42:15 +08:00
/// <summary>
/// Whether to disallow changes to game-wise Beatmap/Ruleset bindables for this screen (and all children).
2019-02-01 14:42:15 +08:00
/// </summary>
public virtual bool DisallowExternalBeatmapRulesetChanges => false;
private SampleChannel sampleExit;
2018-04-13 17:19:50 +08:00
2019-01-23 19:52:00 +08:00
public virtual float BackgroundParallaxAmount => 1;
2018-04-13 17:19:50 +08:00
2019-02-02 16:11:25 +08:00
public Bindable<WorkingBeatmap> Beatmap { get; set; }
public Bindable<RulesetInfo> Ruleset { get; set; }
2018-04-13 17:19:50 +08:00
2019-02-02 16:11:25 +08:00
protected override IReadOnlyDependencyContainer CreateChildDependencies(IReadOnlyDependencyContainer parent)
{
var deps = new OsuScreenDependencies(DisallowExternalBeatmapRulesetChanges, base.CreateChildDependencies(parent));
2019-02-01 14:42:15 +08:00
2019-02-02 16:11:25 +08:00
Beatmap = deps.Beatmap;
Ruleset = deps.Ruleset;
2019-02-01 14:42:15 +08:00
2019-02-02 16:11:25 +08:00
return deps;
}
2018-04-13 17:19:50 +08:00
protected BackgroundScreen Background => backgroundStack?.CurrentScreen as BackgroundScreen;
private BackgroundScreen localBackground;
2019-01-31 10:00:33 +08:00
[Resolved(canBeNull: true)]
private BackgroundScreenStack backgroundStack { get; set; }
2019-01-31 10:00:33 +08:00
[Resolved(canBeNull: true)]
private OsuLogo logo { get; set; }
2019-01-23 19:52:00 +08:00
protected OsuScreen()
{
Anchor = Anchor.Centre;
Origin = Anchor.Centre;
}
[BackgroundDependencyLoader(true)]
2019-02-01 14:42:15 +08:00
private void load(OsuGame osu, AudioManager audio)
2018-04-13 17:19:50 +08:00
{
2018-08-31 06:04:40 +08:00
sampleExit = audio.Sample.Get(@"UI/screen-back");
2018-04-13 17:19:50 +08:00
}
public virtual bool OnPressed(GlobalAction action)
2018-04-13 17:19:50 +08:00
{
2019-01-23 19:52:00 +08:00
if (!this.IsCurrentScreen()) return false;
2018-06-27 15:06:26 +08:00
if (action == GlobalAction.Back && AllowBackButton)
2018-04-13 17:19:50 +08:00
{
2019-01-23 19:52:00 +08:00
this.Exit();
return true;
2018-04-13 17:19:50 +08:00
}
return false;
2018-04-13 17:19:50 +08:00
}
public bool OnReleased(GlobalAction action) => action == GlobalAction.Back && AllowBackButton;
2019-01-23 19:52:00 +08:00
public override void OnResuming(IScreen last)
2018-04-13 17:19:50 +08:00
{
sampleExit?.Play();
applyArrivingDefaults(true);
base.OnResuming(last);
}
2019-01-23 19:52:00 +08:00
public override void OnSuspending(IScreen next)
2018-04-13 17:19:50 +08:00
{
base.OnSuspending(next);
onSuspendingLogo();
}
2019-01-23 19:52:00 +08:00
public override void OnEntering(IScreen last)
2018-04-13 17:19:50 +08:00
{
applyArrivingDefaults(false);
2019-01-31 10:00:33 +08:00
backgroundStack?.Push(localBackground = CreateBackground());
2018-04-13 17:19:50 +08:00
base.OnEntering(last);
}
2019-01-23 19:52:00 +08:00
public override bool OnExiting(IScreen next)
2018-04-13 17:19:50 +08:00
{
if (ValidForResume && logo != null)
onExitingLogo();
if (base.OnExiting(next))
return true;
if (localBackground != null && backgroundStack?.CurrentScreen == localBackground)
backgroundStack?.Exit();
2018-04-13 17:19:50 +08:00
return false;
}
/// <summary>
/// Fired when this screen was entered or resumed and the logo state is required to be adjusted.
/// </summary>
protected virtual void LogoArriving(OsuLogo logo, bool resuming)
{
2019-01-25 20:02:35 +08:00
ApplyLogoArrivingDefaults(logo);
2018-04-13 17:19:50 +08:00
}
private void applyArrivingDefaults(bool isResuming)
{
2019-01-31 10:00:33 +08:00
logo?.AppendAnimatingAction(() =>
{
2019-01-23 19:52:00 +08:00
if (this.IsCurrentScreen()) LogoArriving(logo, isResuming);
}, true);
2018-04-13 17:19:50 +08:00
}
2019-01-25 20:02:35 +08:00
/// <summary>
/// Applies default animations to an arriving logo.
/// Todo: This should not exist.
/// </summary>
/// <param name="logo">The logo to apply animations to.</param>
public static void ApplyLogoArrivingDefaults(OsuLogo logo)
{
logo.Action = null;
logo.FadeOut(300, Easing.OutQuint);
logo.Anchor = Anchor.TopLeft;
logo.Origin = Anchor.Centre;
logo.RelativePositionAxes = Axes.Both;
2019-01-25 20:02:35 +08:00
logo.BeatMatching = true;
logo.Triangles = true;
logo.Ripple = true;
}
2018-04-13 17:19:50 +08:00
private void onExitingLogo()
{
2019-01-31 10:00:33 +08:00
logo?.AppendAnimatingAction(() => LogoExiting(logo), false);
2018-04-13 17:19:50 +08:00
}
/// <summary>
/// Fired when this screen was exited to add any outwards transition to the logo.
/// </summary>
protected virtual void LogoExiting(OsuLogo logo)
{
}
private void onSuspendingLogo()
{
2019-01-31 10:00:33 +08:00
logo?.AppendAnimatingAction(() => LogoSuspending(logo), false);
2018-04-13 17:19:50 +08:00
}
/// <summary>
/// Fired when this screen was suspended to add any outwards transition to the logo.
/// </summary>
protected virtual void LogoSuspending(OsuLogo logo)
{
}
/// <summary>
/// Override to create a BackgroundMode for the current screen.
/// Note that the instance created may not be the used instance if it matches the BackgroundMode equality clause.
/// </summary>
protected virtual BackgroundScreen CreateBackground() => null;
2018-04-13 17:19:50 +08:00
}
}