// Copyright (c) 2007-2017 ppy Pty Ltd . // Licensed under the MIT Licence - https://raw.githubusercontent.com/ppy/osu/master/LICENCE using System; using System.Collections.Generic; using System.Linq; using osu.Framework.Configuration; using osu.Framework.Graphics; using osu.Framework.Graphics.Containers; using osu.Game.Rulesets.Objects.Drawables; namespace osu.Game.Rulesets.Timing { /// /// A collection of s. /// /// /// This container redirects any 's added to it to the /// which provides the speed adjustment active at the start time of the hit object. Furthermore, this container provides the /// necessary for the contained s. /// /// public class SpeedAdjustmentCollection : Container { private readonly BindableDouble visibleTimeRange = new BindableDouble(); /// /// Gets or sets the range of time that is visible by the length of this container. /// For example, only hit objects with start time less than or equal to 1000 will be visible with = 1000. /// public Bindable VisibleTimeRange { get { return visibleTimeRange; } set { visibleTimeRange.BindTo(value); } } protected override int Compare(Drawable x, Drawable y) { var xSpeedAdjust = x as SpeedAdjustmentContainer; var ySpeedAdjust = y as SpeedAdjustmentContainer; // If either of the two drawables are not hit objects, fall back to the base comparer if (xSpeedAdjust?.ControlPoint == null || ySpeedAdjust?.ControlPoint == null) return CompareReverseChildID(x, y); // Compare by start time int i = ySpeedAdjust.ControlPoint.StartTime.CompareTo(xSpeedAdjust.ControlPoint.StartTime); return i != 0 ? i : CompareReverseChildID(x, y); } /// /// Hit objects that are to be re-processed on the next update. /// private readonly Queue queuedHitObjects = new Queue(); private readonly Axes scrollingAxes; /// /// Creates a new . /// /// The axes upon which hit objects should appear to scroll inside this container. public SpeedAdjustmentCollection(Axes scrollingAxes) { this.scrollingAxes = scrollingAxes; } public override void Add(SpeedAdjustmentContainer speedAdjustment) { speedAdjustment.VisibleTimeRange.BindTo(VisibleTimeRange); speedAdjustment.ScrollingAxes = scrollingAxes; base.Add(speedAdjustment); } /// /// Adds a hit object to this . The hit objects will be kept in a queue /// and will be processed when new s are added to this . /// /// The hit object to add. public void Add(DrawableHitObject hitObject) { if (!(hitObject is IScrollingHitObject)) throw new InvalidOperationException($"Hit objects added to a {nameof(SpeedAdjustmentCollection)} must implement {nameof(IScrollingHitObject)}."); queuedHitObjects.Enqueue(hitObject); } protected override void Update() { base.Update(); // Todo: At the moment this is going to re-process every single Update, however this will only be a null-op // when there are no SpeedAdjustmentContainers available. This should probably error or something, but it's okay for now. // An external count is kept because hit objects that can't be added are re-queued int count = queuedHitObjects.Count; while (count-- > 0) { var hitObject = queuedHitObjects.Dequeue(); var target = adjustmentContainerFor(hitObject); if (target == null) { // We can't add this hit object to a speed adjustment container yet, so re-queue it // for re-processing when the layout next invalidated queuedHitObjects.Enqueue(hitObject); continue; } if (hitObject.RelativePositionAxes != target.ScrollingAxes) throw new InvalidOperationException($"Make sure to set all {nameof(DrawableHitObject)}'s {nameof(RelativePositionAxes)} are equal to the correct axes of scrolling ({target.ScrollingAxes})."); target.Add(hitObject); } } /// /// Finds the which provides the speed adjustment active at the start time /// of a hit object. If there is no active at the start time of the hit object, /// then the first (time-wise) speed adjustment is returned. /// /// The hit object to find the active for. /// The active at 's start time. Null if there are no speed adjustments. private SpeedAdjustmentContainer adjustmentContainerFor(DrawableHitObject hitObject) => Children.FirstOrDefault(c => c.CanContain(hitObject)) ?? Children.LastOrDefault(); /// /// Finds the which provides the speed adjustment active at a time. /// If there is no active at the time, then the first (time-wise) speed adjustment is returned. /// /// The time to find the active at. /// The active at . Null if there are no speed adjustments. private SpeedAdjustmentContainer adjustmentContainerAt(double time) => Children.FirstOrDefault(c => c.CanContain(time)) ?? Children.LastOrDefault(); } }