// 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.Collections.Generic; using System.Linq; using osu.Framework.Allocation; using osu.Framework.Graphics; using osu.Framework.Graphics.Containers; using osu.Framework.Graphics.Shapes; using osu.Game.Graphics; using osu.Game.Graphics.Sprites; using osu.Game.Rulesets.Scoring; using osuTK.Graphics; namespace osu.Game.Screens.Ranking.Statistics { /// /// A graph which displays the distribution of hit timing in a series of s. /// public class HitEventTimingDistributionGraph : CompositeDrawable { /// /// The number of bins on each side of the timing distribution. /// private const int timing_distribution_bins = 50; /// /// The total number of bins in the timing distribution, including bins on both sides and the centre bin at 0. /// private const int total_timing_distribution_bins = timing_distribution_bins * 2 + 1; /// /// The centre bin, with a timing distribution very close to/at 0. /// private const int timing_distribution_centre_bin_index = timing_distribution_bins; /// /// The number of data points shown on each side of the axis below the graph. /// private const float axis_points = 5; /// /// The currently displayed hit events. /// private readonly IReadOnlyList hitEvents; /// /// Creates a new . /// /// The s to display the timing distribution of. public HitEventTimingDistributionGraph(IReadOnlyList hitEvents) { this.hitEvents = hitEvents.Where(e => !(e.HitObject.HitWindows is HitWindows.EmptyHitWindows) && e.Result.IsHit()).ToList(); } private IDictionary[] bins; private double binSize; private double hitOffset; private Bar[] barDrawables; [BackgroundDependencyLoader] private void load() { if (hitEvents == null || hitEvents.Count == 0) return; bins = Enumerable.Range(0, total_timing_distribution_bins).Select(_ => new Dictionary()).ToArray>(); binSize = Math.Ceiling(hitEvents.Max(e => Math.Abs(e.TimeOffset)) / timing_distribution_bins); // Prevent div-by-0 by enforcing a minimum bin size binSize = Math.Max(1, binSize); Scheduler.AddOnce(updateDisplay); } public void UpdateOffset(double hitOffset) { this.hitOffset = hitOffset; Scheduler.AddOnce(updateDisplay); } private void updateDisplay() { bool roundUp = true; foreach (var bin in bins) bin.Clear(); foreach (var e in hitEvents) { double time = e.TimeOffset + hitOffset; double binOffset = time / binSize; // .NET's round midpoint handling doesn't provide a behaviour that works amazingly for display // purposes here. We want midpoint rounding to roughly distribute evenly to each adjacent bucket // so the easiest way is to cycle between downwards and upwards rounding as we process events. if (Math.Abs(binOffset - (int)binOffset) == 0.5) { binOffset = (int)binOffset + Math.Sign(binOffset) * (roundUp ? 1 : 0); roundUp = !roundUp; } int index = timing_distribution_centre_bin_index + (int)Math.Round(binOffset, MidpointRounding.AwayFromZero); // may be out of range when applying an offset. for such cases we can just drop the results. if (index >= 0 && index < bins.Length) { bins[index].TryGetValue(e.Result, out int value); bins[index][e.Result] = ++value; } } if (barDrawables != null) { for (int i = 0; i < barDrawables.Length; i++) { barDrawables[i].UpdateOffset(bins[i].Sum(b => b.Value)); } } else { int maxCount = bins.Max(b => b.Values.Sum()); barDrawables = bins.Select((bin, i) => new Bar(bins[i], maxCount, i == timing_distribution_centre_bin_index)).ToArray(); Container axisFlow; const float axis_font_size = 12; InternalChild = new GridContainer { Anchor = Anchor.Centre, Origin = Anchor.Centre, RelativeSizeAxes = Axes.Both, Width = 0.8f, Content = new[] { new Drawable[] { new GridContainer { RelativeSizeAxes = Axes.Both, Content = new[] { barDrawables } } }, new Drawable[] { axisFlow = new Container { RelativeSizeAxes = Axes.X, Height = axis_font_size, } }, }, RowDimensions = new[] { new Dimension(), new Dimension(GridSizeMode.AutoSize), } }; // Our axis will contain one centre element + 5 points on each side, each with a value depending on the number of bins * bin size. double maxValue = timing_distribution_bins * binSize; double axisValueStep = maxValue / axis_points; axisFlow.Add(new OsuSpriteText { Anchor = Anchor.Centre, Origin = Anchor.Centre, Text = "0", Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold) }); for (int i = 1; i <= axis_points; i++) { double axisValue = i * axisValueStep; float position = (float)(axisValue / maxValue); float alpha = 1f - position * 0.8f; axisFlow.Add(new OsuSpriteText { Anchor = Anchor.Centre, Origin = Anchor.Centre, RelativePositionAxes = Axes.X, X = -position / 2, Alpha = alpha, Text = axisValue.ToString("-0"), Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold) }); axisFlow.Add(new OsuSpriteText { Anchor = Anchor.Centre, Origin = Anchor.Centre, RelativePositionAxes = Axes.X, X = position / 2, Alpha = alpha, Text = axisValue.ToString("+0"), Font = OsuFont.GetFont(size: axis_font_size, weight: FontWeight.SemiBold) }); } } } private class Bar : CompositeDrawable { private float totalValue => values.Sum(v => v.Value); private float basalHeight => BoundingBox.Width / BoundingBox.Height; private float availableHeight => 1 - basalHeight; private readonly IReadOnlyList> values; private readonly float maxValue; private readonly bool isCentre; private Circle[] boxOriginals; private Circle boxAdjustment; [Resolved] private OsuColour colours { get; set; } public Bar(IDictionary values, float maxValue, bool isCentre) { this.values = values.OrderBy(v => v.Key.GetIndexForOrderedDisplay()).ToList(); this.maxValue = maxValue; this.isCentre = isCentre; RelativeSizeAxes = Axes.Both; Masking = true; } [BackgroundDependencyLoader] private void load() { if (values.Any()) { boxOriginals = values.Select((v, i) => new Circle { RelativeSizeAxes = Axes.Both, Anchor = Anchor.BottomCentre, Origin = Anchor.BottomCentre, Colour = isCentre && i == 0 ? Color4.White : colours.ForHitResult(v.Key), Height = 0, }).ToArray(); // The bars of the stacked bar graph will be processed (stacked) from the bottom, which is the base position, // to the top, and the bottom bar should be drawn more toward the front by design, // while the drawing order is from the back to the front, so the order passed to `InternalChildren` is the opposite. InternalChildren = boxOriginals.Reverse().ToArray(); } else { // A bin with no value draws a grey dot instead. InternalChildren = boxOriginals = new[] { new Circle { RelativeSizeAxes = Axes.Both, Anchor = Anchor.BottomCentre, Origin = Anchor.BottomCentre, Colour = isCentre ? Color4.White : Color4.Gray, Height = 0, }, }; } } private const double duration = 300; private float offsetForValue(float value) { return availableHeight * value / maxValue; } private float heightForValue(float value) { return basalHeight + offsetForValue(value); } protected override void LoadComplete() { base.LoadComplete(); foreach (var boxOriginal in boxOriginals) boxOriginal.Height = basalHeight; float offsetValue = 0; for (int i = 0; i < values.Count; i++) { boxOriginals[i].MoveToY(offsetForValue(offsetValue) * BoundingBox.Height, duration, Easing.OutQuint); boxOriginals[i].ResizeHeightTo(heightForValue(values[i].Value), duration, Easing.OutQuint); offsetValue -= values[i].Value; } } public void UpdateOffset(float adjustment) { bool hasAdjustment = adjustment != totalValue; if (boxAdjustment == null) { if (!hasAdjustment) return; AddInternal(boxAdjustment = new Circle { RelativeSizeAxes = Axes.Both, Anchor = Anchor.BottomCentre, Origin = Anchor.BottomCentre, Colour = Color4.Yellow, Blending = BlendingParameters.Additive, Alpha = 0.6f, Height = 0, }); } boxAdjustment.ResizeHeightTo(heightForValue(adjustment), duration, Easing.OutQuint); boxAdjustment.FadeTo(!hasAdjustment ? 0 : 1, duration, Easing.OutQuint); } } } }