// Copyright (c) ppy Pty Ltd . Licensed under the MIT Licence. // See the LICENCE file in the repository root for full licence text. using System; using osu.Framework.Caching; using osu.Framework.Graphics; using osuTK; namespace osu.Game.Skinning { /// /// A drawable which can be skinned via an . /// public class SkinnableDrawable : SkinReloadableDrawable { /// /// The displayed component. /// protected Drawable Drawable { get; private set; } private readonly string componentName; private readonly ConfineMode confineMode; /// /// Create a new skinnable drawable. /// /// The namespace-complete resource name for this skinnable element. /// A function to create the default skin implementation of this element. /// A conditional to decide whether to allow fallback to the default implementation if a skinned element is not present. /// How (if at all) the should be resize to fit within our own bounds. public SkinnableDrawable(string name, Func defaultImplementation, Func allowFallback = null, ConfineMode confineMode = ConfineMode.ScaleDownToFit) : this(name, allowFallback, confineMode) { createDefault = defaultImplementation; } protected SkinnableDrawable(string name, Func allowFallback = null, ConfineMode confineMode = ConfineMode.ScaleDownToFit) : base(allowFallback) { componentName = name; this.confineMode = confineMode; RelativeSizeAxes = Axes.Both; } private readonly Func createDefault; private readonly Cached scaling = new Cached(); private bool isDefault; protected virtual Drawable CreateDefault(string name) => createDefault(name); /// /// Whether to apply size restrictions (specified via ) to the default implementation. /// protected virtual bool ApplySizeRestrictionsToDefault => false; protected override void SkinChanged(ISkinSource skin, bool allowFallback) { Drawable = skin.GetDrawableComponent(componentName); isDefault = false; if (Drawable == null && allowFallback) { Drawable = CreateDefault(componentName); isDefault = true; } if (Drawable != null) { scaling.Invalidate(); Drawable.Origin = Anchor.Centre; Drawable.Anchor = Anchor.Centre; InternalChild = Drawable; } else ClearInternal(); } protected override void Update() { base.Update(); if (!scaling.IsValid) { try { if (Drawable == null || (isDefault && !ApplySizeRestrictionsToDefault)) return; switch (confineMode) { case ConfineMode.NoScaling: return; case ConfineMode.ScaleDownToFit: if (Drawable.DrawSize.X <= DrawSize.X && Drawable.DrawSize.Y <= DrawSize.Y) return; break; } Drawable.RelativeSizeAxes = Axes.Both; Drawable.Size = Vector2.One; Drawable.Scale = Vector2.One; Drawable.FillMode = FillMode.Fit; } finally { scaling.Validate(); } } } } public enum ConfineMode { /// /// Don't apply any scaling. This allows the user element to be of any size, exceeding specified bounds. /// NoScaling, ScaleDownToFit, ScaleToFit, } }