basegames/zeling_v2
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: initial commit

Browse Source
This commit is contained in:
Joywayer
2026-05-08 11:04:00 +08:00
commit f55d2a57c3
6278 changed files with 866081 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

172
Packages/com.kybernetik.animancer/Runtime/Utilities/Directional Animations/DirectionalSet.cs Normal file
View File

@@ -0,0 +1,172 @@
// Animancer // https://kybernetik.com.au/animancer // Copyright 2018-2026 Kybernetik //
using System;
using System.Collections.Generic;
using UnityEngine;
using Object = UnityEngine.Object;
namespace Animancer
{
/// <summary>A generic set of objects corresponding to up/right/down/left.</summary>
/// <remarks>
/// <strong>Documentation:</strong>
/// <see href="https://kybernetik.com.au/animancer/docs/manual/playing/directional-sets">
/// Directional Animation Sets</see>
/// </remarks>
/// https://kybernetik.com.au/animancer/api/Animancer/DirectionalSet_1
///
[AnimancerHelpUrl(typeof(DirectionalSet<>))]
public abstract class DirectionalSet<T> : ScriptableObject
{
/************************************************************************************************************************/
#region Read-Only
/************************************************************************************************************************/
#if UNITY_ASSERTIONS
private bool _AllowChanges;
#endif
/// <summary>[Assert-Only] Sets a debug flag to enable or disable the ability to modify this set.</summary>
[System.Diagnostics.Conditional(Strings.Assertions)]
public void AllowChanges(bool allow = true)
{
#if UNITY_ASSERTIONS
_AllowChanges = allow;
#endif
}
/// <summary>[Assert-Only]
/// Throws an <see cref="InvalidOperationException"/> if <see cref="AllowChanges"/> wasn't called.
/// </summary>
[System.Diagnostics.Conditional(Strings.Assertions)]
public void AssertAllowChanges()
{
#if UNITY_ASSERTIONS
if (!_AllowChanges)
throw new InvalidOperationException(
$"Unable to modify {this} because it is read-only." +
$" Call {nameof(AllowChanges)}() before making any changes.");
#endif
}
/************************************************************************************************************************/
#endregion
/************************************************************************************************************************/
#region Directions
/************************************************************************************************************************/
/// <summary>The number of directions in this set.</summary>
public abstract int DirectionCount { get; }
/************************************************************************************************************************/
/// <summary>Returns the name of the specified `direction`.</summary>
protected abstract string GetDirectionName(int direction);
/************************************************************************************************************************/
/// <summary>Returns the object associated with the specified `direction`.</summary>
public abstract T Get(int direction);
/************************************************************************************************************************/
/// <summary>Returns the object closest to the specified `direction`.</summary>
public abstract T Get(Vector2 direction);
/************************************************************************************************************************/
/// <summary>Sets the object associated with the specified `direction`.</summary>
public abstract void Set(int direction, T value);
/************************************************************************************************************************/
/// <summary>[Editor-Only]
/// Attempts to assign the `value` to one of this set's fields based on its `name` and
/// returns the direction index of that field (or -1 if it was unable to determine the direction).
/// </summary>
public int SetByName(string name, T value)
{
var direction = GetDirection(name);
if (direction >= 0)
Set(direction, value);
return direction;
}
/// <summary>[Editor-Only]
/// Attempts to assign the `value` to one of this set's fields based on its name and
/// returns the direction index of that field (or -1 if it was unable to determine the direction).
/// </summary>
public int SetByName<U>(U value)
where U : Object, T
=> SetByName(value.name, value);
/************************************************************************************************************************/
#region Conversion
/************************************************************************************************************************/
/// <summary>Returns a vector representing the specified `direction`.</summary>
public abstract Vector2 GetDirection(int direction);
/************************************************************************************************************************/
/// <summary>Returns the index of the direction which best matches the given `name`.</summary>
public abstract int GetDirection(string name);
/************************************************************************************************************************/
/// <summary>Returns a copy of the `vector` pointing in the closest direction this set has an object for.</summary>
public abstract Vector2 Snap(Vector2 vector);
/************************************************************************************************************************/
#endregion
/************************************************************************************************************************/
#region Gathering
/************************************************************************************************************************/
/// <summary>Adds all objects from this set to the `values`, starting from the specified `index`.</summary>
public void AddTo(T[] values, int index)
{
var count = DirectionCount;
for (int i = 0; i < count; i++)
values[index + i] = Get(i);
}
/// <summary>Adds all objects from this set to the `values`.</summary>
public void AddTo(List<T> values)
{
var count = DirectionCount;
for (int i = 0; i < count; i++)
values.Add(Get(i));
}
/************************************************************************************************************************/
/// <summary>
/// Adds unit vectors corresponding to each of the objects in this set to the `directions`,
/// starting from the specified `index`.
/// </summary>
public void AddTo(Vector2[] directions, int index)
{
var count = DirectionCount;
for (int i = 0; i < count; i++)
directions[index + i] = GetDirection(i);
}
/************************************************************************************************************************/
/// <summary>Calls <see cref="AddTo"/> and <see cref="AddTo"/>.</summary>
public void AddTo(T[] values, Vector2[] directions, int index)
{
AddTo(values, index);
AddTo(directions, index);
}
/************************************************************************************************************************/
#endregion
/************************************************************************************************************************/
#endregion
/************************************************************************************************************************/
}
}