osu/osu.Game/Screens/IOsuScreen.cs

70 lines
2.5 KiB
C#
Raw Normal View History

2019-01-29 12:48:35 +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.
2019-01-23 11:52:00 +00:00
2019-02-21 10:04:31 +00:00
using osu.Framework.Bindables;
2019-01-23 11:52:00 +00:00
using osu.Framework.Screens;
2019-02-01 06:42:15 +00:00
using osu.Game.Beatmaps;
using osu.Game.Overlays;
2019-02-01 06:42:15 +00:00
using osu.Game.Rulesets;
2019-01-23 11:52:00 +00:00
namespace osu.Game.Screens
{
public interface IOsuScreen : IScreen
{
/// <summary>
/// Whether the beatmap or ruleset should be allowed to be changed by the user or game.
/// Used to mark exclusive areas where this is strongly prohibited, like gameplay.
/// </summary>
2019-02-01 06:42:15 +00:00
bool DisallowExternalBeatmapRulesetChanges { get; }
2019-01-23 11:52:00 +00:00
2019-06-25 07:55:49 +00:00
/// <summary>
/// Whether the user can exit this this <see cref="IOsuScreen"/> by pressing the back button.
/// </summary>
bool AllowBackButton { get; }
/// <summary>
/// Whether a top-level component should be allowed to exit the current screen to, for example,
/// complete an import. Note that this can be overridden by a user if they specifically request.
/// </summary>
bool AllowExternalScreenChange { get; }
2019-01-23 11:52:00 +00:00
/// <summary>
/// Whether this <see cref="OsuScreen"/> allows the cursor to be displayed.
/// </summary>
bool CursorVisible { get; }
/// <summary>
/// Whether all overlays should be hidden when this screen is entered or resumed.
/// </summary>
bool HideOverlaysOnEnter { get; }
/// <summary>
/// Whether overlays should be able to be opened when this screen is current.
/// </summary>
IBindable<OverlayActivation> OverlayActivationMode { get; }
/// <summary>
/// The amount of parallax to be applied while this screen is displayed.
/// </summary>
float BackgroundParallaxAmount { get; }
2019-02-01 06:42:15 +00:00
Bindable<WorkingBeatmap> Beatmap { get; }
Bindable<RulesetInfo> Ruleset { get; }
/// <summary>
/// Whether mod rate adjustments are allowed to be applied.
/// </summary>
bool AllowRateAdjustments { get; }
2020-07-14 06:59:20 +00:00
2020-07-14 20:14:59 +00:00
/// <summary>
/// Invoked when the back button has been pressed to close any overlays before exiting this <see cref="IOsuScreen"/>.
2020-07-14 20:14:59 +00:00
/// </summary>
/// <remarks>
/// Return <c>true</c> to block this <see cref="IOsuScreen"/> from being exited after closing an overlay.
/// Return <c>false</c> if this <see cref="IOsuScreen"/> should continue exiting.
/// </remarks>
2020-07-14 06:59:20 +00:00
bool OnBackButton();
2019-01-23 11:52:00 +00:00
}
}