// Copyright (c) ppy Pty Ltd . Licensed under the MIT Licence. // See the LICENCE file in the repository root for full licence text. #nullable disable using System; using System.Linq; using JetBrains.Annotations; using osu.Framework.Allocation; using osu.Framework.Audio; using osu.Framework.Bindables; using osu.Framework.Graphics; using osu.Framework.Graphics.Containers; using osu.Game.Audio; using osu.Game.Rulesets.Judgements; using osu.Game.Rulesets.Objects; using osu.Game.Rulesets.Objects.Drawables; using osu.Game.Rulesets.Osu.Judgements; using osu.Game.Rulesets.Osu.Skinning; using osu.Game.Rulesets.Osu.Skinning.Default; using osu.Game.Rulesets.Scoring; using osu.Game.Screens.Ranking; using osu.Game.Skinning; namespace osu.Game.Rulesets.Osu.Objects.Drawables { public partial class DrawableSpinner : DrawableOsuHitObject { public new Spinner HitObject => (Spinner)base.HitObject; public new OsuSpinnerJudgementResult Result => (OsuSpinnerJudgementResult)base.Result; public SkinnableDrawable Body { get; private set; } public SpinnerRotationTracker RotationTracker { get; private set; } private SpinnerSpmCalculator spmCalculator; private Container ticks; private PausableSkinnableSound spinningSample; private Bindable isSpinning; private bool spinnerFrequencyModulate; private const float spinning_sample_initial_frequency = 1.0f; private const float spinning_sample_modulated_base_frequency = 0.5f; /// /// The amount of bonus score gained from spinning after the required number of spins, for display purposes. /// public IBindable GainedBonus => gainedBonus; private readonly Bindable gainedBonus = new BindableDouble(); /// /// The number of spins per minute this spinner is spinning at, for display purposes. /// public readonly IBindable SpinsPerMinute = new BindableDouble(); private const double fade_out_duration = 240; public DrawableSpinner() : this(null) { } public DrawableSpinner([CanBeNull] Spinner s = null) : base(s) { } [BackgroundDependencyLoader] private void load() { Origin = Anchor.Centre; RelativeSizeAxes = Axes.Both; AddRangeInternal(new Drawable[] { spmCalculator = new SpinnerSpmCalculator { Result = { BindTarget = SpinsPerMinute }, }, ticks = new Container { RelativeSizeAxes = Axes.Both, }, new AspectContainer { Anchor = Anchor.Centre, Origin = Anchor.Centre, RelativeSizeAxes = Axes.Y, Children = new Drawable[] { Body = new SkinnableDrawable(new OsuSkinComponentLookup(OsuSkinComponents.SpinnerBody), _ => new DefaultSpinner()), RotationTracker = new SpinnerRotationTracker(this) } }, spinningSample = new PausableSkinnableSound { Volume = { Value = 0 }, Looping = true, Frequency = { Value = spinning_sample_initial_frequency } } }); PositionBindable.BindValueChanged(pos => Position = pos.NewValue); } protected override void LoadComplete() { base.LoadComplete(); isSpinning = RotationTracker.IsSpinning.GetBoundCopy(); isSpinning.BindValueChanged(updateSpinningSample); } protected override void OnFree() { base.OnFree(); spinningSample.ClearSamples(); } protected override void LoadSamples() { base.LoadSamples(); spinningSample.Samples = HitObject.CreateSpinningSamples().Cast().ToArray(); spinningSample.Frequency.Value = spinning_sample_initial_frequency; } private void updateSpinningSample(ValueChangedEvent tracking) { if (tracking.NewValue) { if (!spinningSample.IsPlaying) spinningSample.Play(); spinningSample.VolumeTo(1, 300); } else { spinningSample.VolumeTo(0, fade_out_duration); } } public override void StopAllSamples() { base.StopAllSamples(); spinningSample?.Stop(); } protected override void AddNestedHitObject(DrawableHitObject hitObject) { base.AddNestedHitObject(hitObject); switch (hitObject) { case DrawableSpinnerTick tick: ticks.Add(tick); break; } } protected override void UpdateHitStateTransforms(ArmedState state) { base.UpdateHitStateTransforms(state); this.FadeOut(fade_out_duration).OnComplete(_ => { // looping sample should be stopped here as it is safer than running in the OnComplete // of the volume transition above. spinningSample.Stop(); }); Expire(); // skin change does a rewind of transforms, which will stop the spinning sound from playing if it's currently in playback. isSpinning?.TriggerChange(); } protected override void ClearNestedHitObjects() { base.ClearNestedHitObjects(); ticks.Clear(false); } protected override DrawableHitObject CreateNestedHitObject(HitObject hitObject) { switch (hitObject) { case SpinnerBonusTick bonusTick: return new DrawableSpinnerBonusTick(bonusTick); case SpinnerTick tick: return new DrawableSpinnerTick(tick); } return base.CreateNestedHitObject(hitObject); } protected override void ApplySkin(ISkinSource skin, bool allowFallback) { base.ApplySkin(skin, allowFallback); spinnerFrequencyModulate = skin.GetConfig(OsuSkinConfiguration.SpinnerFrequencyModulate)?.Value ?? true; } /// /// The completion progress of this spinner from 0..1 (clamped). /// public float Progress { get { if (HitObject.SpinsRequired == 0) // some spinners are so short they can't require an integer spin count. // these become implicitly hit. return 1; return Math.Clamp(Result.RateAdjustedRotation / 360 / HitObject.SpinsRequired, 0, 1); } } protected override JudgementResult CreateResult(Judgement judgement) => new OsuSpinnerJudgementResult(HitObject, judgement); protected override void CheckForResult(bool userTriggered, double timeOffset) { if (Time.Current < HitObject.StartTime) return; if (Progress >= 1) Result.TimeCompleted ??= Time.Current; if (userTriggered || Time.Current < HitObject.EndTime) return; // Trigger a miss result for remaining ticks to avoid infinite gameplay. foreach (var tick in ticks.Where(t => !t.Result.HasResult)) tick.TriggerResult(false); ApplyResult(r => { if (Progress >= 1) r.Type = HitResult.Great; else if (Progress > .9) r.Type = HitResult.Ok; else if (Progress > .75) r.Type = HitResult.Meh; else if (Time.Current >= HitObject.EndTime) r.Type = r.Judgement.MinResult; }); } protected override void Update() { base.Update(); if (HandleUserInput) { bool isValidSpinningTime = Time.Current >= HitObject.StartTime && Time.Current <= HitObject.EndTime; bool correctButtonPressed = (OsuActionInputManager?.PressedActions.Any(x => x == OsuAction.LeftButton || x == OsuAction.RightButton) ?? false); RotationTracker.Tracking = !Result.HasResult && correctButtonPressed && isValidSpinningTime; } if (spinningSample != null && spinnerFrequencyModulate) spinningSample.Frequency.Value = spinning_sample_modulated_base_frequency + Progress; } protected override void UpdateAfterChildren() { base.UpdateAfterChildren(); if (Result.TimeStarted == null && RotationTracker.Tracking) Result.TimeStarted = Time.Current; // don't update after end time to avoid the rate display dropping during fade out. // this shouldn't be limited to StartTime as it causes weirdness with the underlying calculation, which is expecting updates during that period. if (Time.Current <= HitObject.EndTime) spmCalculator.SetRotation(Result.RateAdjustedRotation); updateBonusScore(); } private static readonly int score_per_tick = new SpinnerBonusTick.OsuSpinnerBonusTickJudgement().MaxNumericResult; private int completedFullSpins; private void updateBonusScore() { if (ticks.Count == 0) return; int spins = (int)(Result.RateAdjustedRotation / 360); if (spins < completedFullSpins) { // rewinding, silently handle completedFullSpins = spins; return; } while (completedFullSpins != spins) { var tick = ticks.FirstOrDefault(t => !t.Result.HasResult); // tick may be null if we've hit the spin limit. if (tick != null) { tick.TriggerResult(true); if (tick is DrawableSpinnerBonusTick) gainedBonus.Value = score_per_tick * (spins - HitObject.SpinsRequiredForBonus); } completedFullSpins++; } } } }