// Copyright (c) ppy Pty Ltd . Licensed under the MIT Licence. // See the LICENCE file in the repository root for full licence text. using osu.Framework.Bindables; using osu.Framework.Graphics; using osu.Framework.Graphics.Containers; using osu.Game.Configuration; using osu.Game.Screens.Play.HUD; using osu.Game.Skinning; using osuTK; using System; namespace osu.Game.Extensions { public static class DrawableExtensions { /// /// Shakes this drawable. /// /// The target to shake. /// The length of a single shake. /// Pixels of displacement per shake. /// The maximum length the shake should last. public static void Shake(this Drawable target, double shakeDuration = 80, float shakeMagnitude = 8, double? maximumLength = null) { // if we don't have enough time, don't bother shaking. if (maximumLength < shakeDuration * 2) return; var sequence = target.MoveToX(shakeMagnitude, shakeDuration / 2, Easing.OutSine).Then() .MoveToX(-shakeMagnitude, shakeDuration, Easing.InOutSine).Then(); // if we don't have enough time for the second shake, skip it. if (!maximumLength.HasValue || maximumLength >= shakeDuration * 4) { sequence = sequence .MoveToX(shakeMagnitude, shakeDuration, Easing.InOutSine).Then() .MoveToX(-shakeMagnitude, shakeDuration, Easing.InOutSine).Then(); } sequence.MoveToX(0, shakeDuration / 2, Easing.InSine); } /// /// Accepts a delta vector in screen-space coordinates and converts it to one which can be applied to this drawable's position. /// /// The drawable. /// A delta in screen-space coordinates. /// The delta vector in Parent's coordinates. public static Vector2 ScreenSpaceDeltaToParentSpace(this Drawable drawable, Vector2 delta) => drawable.Parent.ToLocalSpace(drawable.Parent.ToScreenSpace(Vector2.Zero) + delta); public static SkinnableInfo CreateSkinnableInfo(this Drawable component) => new SkinnableInfo(component); public static void ApplySkinnableInfo(this Drawable component, SkinnableInfo info) { // todo: can probably make this better via deserialisation directly using a common interface. component.Position = info.Position; component.Rotation = info.Rotation; component.Scale = info.Scale; component.Anchor = info.Anchor; component.Origin = info.Origin; if (component is ISkinnableDrawable skinnable) { skinnable.UsesFixedAnchor = info.UsesFixedAnchor; foreach (var (_, property) in component.GetSettingsSourceProperties()) { if (!info.Settings.TryGetValue(property.Name.ToSnakeCase(), out object settingValue)) continue; skinnable.CopyAdjustedSetting((IBindable)property.GetValue(component), settingValue); } } if (component is Container container) { foreach (var child in info.Children) container.Add(child.CreateInstance()); } } /// /// Keeps the drawable upright and prevents it from being scaled or flipped with its Parent. /// /// The drawable. public static void KeepUprightAndUnscaled(this Drawable drawable) { var parentMatrix = drawable.Parent.DrawInfo.Matrix; float angle = MathF.Atan(parentMatrix.M12 / parentMatrix.M11); angle = MathHelper.RadiansToDegrees(angle); parentMatrix.Transpose(); parentMatrix.M13 = 0.0f; parentMatrix.M23 = 0.0f; if ((Math.Abs(Math.Abs(angle) - 90.0)) < 2.0f) { Matrix3 m = Matrix3.CreateRotationZ(MathHelper.DegreesToRadians(40.0f)); m.Transpose(); parentMatrix *= m; drawable.Rotation = 40.0f; } else drawable.Rotation = 0.0f; Matrix3 C = parentMatrix.Inverted(); float alpha, beta, sx, sy; sy = C.M22; alpha = C.M12 / C.M22; beta = (C.M21 == 0.0f) ? 0.0f : 1 / ((C.M11 / C.M21) - alpha); sx = (beta == 0.0f) ? C.M11 : C.M21 / beta; drawable.Scale = new Vector2(sx, sy); drawable.Shear = new Vector2(-alpha, -beta); } } }