mirror of https://github.com/ppy/osu
51 lines
2.0 KiB
C#
51 lines
2.0 KiB
C#
// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
|
|
// See the LICENCE file in the repository root for full licence text.
|
|
|
|
using System;
|
|
using osu.Framework.Bindables;
|
|
using osu.Framework.Extensions.TypeExtensions;
|
|
using osu.Framework.Graphics;
|
|
using osu.Game.Configuration;
|
|
|
|
namespace osu.Game.Skinning
|
|
{
|
|
/// <summary>
|
|
/// Denotes a drawable which, as a drawable, can be adjusted via skinning specifications.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// Attaching this interface to any <see cref="IDrawable"/> will make it serialisable to skin settings.
|
|
/// Adding <see cref="SettingSourceAttribute"/> annotated bindables will also serialise these settings alongside each instance.
|
|
/// </remarks>
|
|
public interface ISkinnableDrawable : IDrawable
|
|
{
|
|
/// <summary>
|
|
/// Whether this component should be editable by an end user.
|
|
/// </summary>
|
|
bool IsEditable => true;
|
|
|
|
/// <summary>
|
|
/// In the context of the skin layout editor, whether this <see cref="ISkinnableDrawable"/> has a permanent anchor defined.
|
|
/// If <see langword="false"/>, this <see cref="ISkinnableDrawable"/>'s <see cref="Drawable.Anchor"/> is automatically determined by proximity,
|
|
/// If <see langword="true"/>, a fixed anchor point has been defined.
|
|
/// </summary>
|
|
bool UsesFixedAnchor { get; set; }
|
|
|
|
void CopyAdjustedSetting(IBindable target, object source)
|
|
{
|
|
if (source is IBindable sourceBindable)
|
|
{
|
|
// copy including transfer of default values.
|
|
target.BindTo(sourceBindable);
|
|
target.UnbindFrom(sourceBindable);
|
|
}
|
|
else
|
|
{
|
|
if (!(target is IParseable parseable))
|
|
throw new InvalidOperationException($"Bindable type {target.GetType().ReadableName()} is not {nameof(IParseable)}.");
|
|
|
|
parseable.Parse(source);
|
|
}
|
|
}
|
|
}
|
|
}
|