增加了支持仿射变换的image组件
This commit is contained in:
@@ -0,0 +1,497 @@
|
||||
using UnityEditor;
|
||||
using UnityEditor.UI;
|
||||
|
||||
using UnityEngine;
|
||||
using UnityEngine.UI;
|
||||
|
||||
using XericUI.OverrideUI;
|
||||
using XericUI.Core;
|
||||
|
||||
namespace XericUIEditor.OverrideUI
|
||||
{
|
||||
/// <summary>
|
||||
/// XericImage 的 Inspector 与场景编辑手柄。
|
||||
/// 场景手柄布局(每条边一套):
|
||||
/// <code>
|
||||
/// 圆点 --------- 圆点 - 横 - 圆点 --------- 圆点
|
||||
/// 顶点 旋转 滑移 旋转 顶点
|
||||
/// </code>
|
||||
/// 顶点=自由拖拽该角点;横=沿这条边的方向平移两端点;圆点=绕这条边的中点旋转两端点(保持边长)。
|
||||
/// </summary>
|
||||
[CustomEditor(typeof(XericImage), true)]
|
||||
[CanEditMultipleObjects]
|
||||
public class XericImageEditor : ImageEditor
|
||||
{
|
||||
#region 常量与静态状态
|
||||
|
||||
private const string SceneEditKey = "XericImage.SceneEdit";
|
||||
private const string SceneEditMenu = XericRegistrationPaths.UIBar + "/Image/场景变形手柄";
|
||||
|
||||
private static bool s_SceneEdit;
|
||||
private static bool s_SceneEditLoaded;
|
||||
|
||||
/// <summary>场景手柄总开关(默认关闭,避免选中任何 Image 都冒出手柄)</summary>
|
||||
private static bool SceneEditEnabled
|
||||
{
|
||||
get
|
||||
{
|
||||
if (!s_SceneEditLoaded)
|
||||
{
|
||||
s_SceneEdit = EditorPrefs.GetBool(SceneEditKey, false);
|
||||
s_SceneEditLoaded = true;
|
||||
}
|
||||
return s_SceneEdit;
|
||||
}
|
||||
set
|
||||
{
|
||||
s_SceneEdit = value;
|
||||
s_SceneEditLoaded = true;
|
||||
EditorPrefs.SetBool(SceneEditKey, value);
|
||||
SceneView.RepaintAll();
|
||||
}
|
||||
}
|
||||
|
||||
[MenuItem(SceneEditMenu, false, 300)]
|
||||
private static void ToggleSceneEdit() => SceneEditEnabled = !SceneEditEnabled;
|
||||
|
||||
[MenuItem(SceneEditMenu, true)]
|
||||
private static bool ToggleSceneEditValidate()
|
||||
{
|
||||
Menu.SetChecked(SceneEditMenu, SceneEditEnabled);
|
||||
return true;
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 字段
|
||||
|
||||
private SerializedProperty m_OffsetBL;
|
||||
private SerializedProperty m_OffsetTL;
|
||||
private SerializedProperty m_OffsetTR;
|
||||
private SerializedProperty m_OffsetBR;
|
||||
|
||||
// 生成器参数(编辑器侧状态,不进序列化)
|
||||
private bool m_ShowGenerator;
|
||||
private bool m_KeepParallelogram;
|
||||
private Matrix4x4 m_Matrix = Matrix4x4.identity;
|
||||
private Vector3 m_PlaneNormal = Vector3.back;
|
||||
private float m_PlaneRoll;
|
||||
|
||||
// 一轮操作只登记一条撤销:登记过就按住,等这一轮操作结束再放开
|
||||
private bool m_UndoLatched;
|
||||
|
||||
#endregion
|
||||
|
||||
#region 生命周期
|
||||
|
||||
protected override void OnEnable()
|
||||
{
|
||||
base.OnEnable();
|
||||
|
||||
m_OffsetBL = serializedObject.FindProperty("m_CornerOffsetBL");
|
||||
m_OffsetTL = serializedObject.FindProperty("m_CornerOffsetTL");
|
||||
m_OffsetTR = serializedObject.FindProperty("m_CornerOffsetTR");
|
||||
m_OffsetBR = serializedObject.FindProperty("m_CornerOffsetBR");
|
||||
}
|
||||
|
||||
protected override void OnDisable()
|
||||
{
|
||||
base.OnDisable();
|
||||
m_UndoLatched = false;
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region Inspector
|
||||
|
||||
public override void OnInspectorGUI()
|
||||
{
|
||||
base.OnInspectorGUI();
|
||||
|
||||
DrawDeformSection();
|
||||
|
||||
// 拖动数值框时每帧都会改值,鼠标松开才算这一轮操作结束
|
||||
if (Event.current.type == EventType.MouseUp)
|
||||
m_UndoLatched = false;
|
||||
}
|
||||
|
||||
private void DrawDeformSection()
|
||||
{
|
||||
serializedObject.Update();
|
||||
|
||||
EditorGUILayout.Space(8);
|
||||
EditorGUILayout.LabelField("变形(四顶点)", EditorStyles.boldLabel);
|
||||
|
||||
SceneEditEnabled = EditorGUILayout.ToggleLeft(
|
||||
"场景手柄编辑(选中时在 Scene 视图拖拽顶点与边)", SceneEditEnabled);
|
||||
|
||||
m_KeepParallelogram = EditorGUILayout.ToggleLeft(
|
||||
"拖拽顶点时保持平行四边形", m_KeepParallelogram);
|
||||
|
||||
EditorGUILayout.Space(2);
|
||||
DrawCornerFields();
|
||||
|
||||
EditorGUILayout.Space(4);
|
||||
m_ShowGenerator = EditorGUILayout.Foldout(m_ShowGenerator, "生成器(矩阵 / 虚拟法线)", true);
|
||||
if (m_ShowGenerator)
|
||||
{
|
||||
EditorGUI.indentLevel++;
|
||||
DrawMatrixGenerator();
|
||||
DrawPlaneGenerator();
|
||||
EditorGUI.indentLevel--;
|
||||
}
|
||||
|
||||
EditorGUILayout.Space(4);
|
||||
using (new EditorGUILayout.HorizontalScope())
|
||||
{
|
||||
if (GUILayout.Button("复制角点"))
|
||||
CopyCorners();
|
||||
if (GUILayout.Button("粘贴角点"))
|
||||
PasteCorners();
|
||||
if (GUILayout.Button("重置变形"))
|
||||
ApplyToTargets(img => img.ResetDeform(), "重置 Image 变形", recordSerialized: true);
|
||||
}
|
||||
|
||||
serializedObject.ApplyModifiedProperties();
|
||||
}
|
||||
|
||||
private void DrawCornerFields()
|
||||
{
|
||||
var image = target as XericImage;
|
||||
if (image == null) return;
|
||||
|
||||
EditorGUI.BeginChangeCheck();
|
||||
Vector2 bl = EditorGUILayout.Vector2Field("左下 (0,0)", image.GetCorner(0));
|
||||
Vector2 tl = EditorGUILayout.Vector2Field("左上 (0,1)", image.GetCorner(1));
|
||||
Vector2 tr = EditorGUILayout.Vector2Field("右上 (1,1)", image.GetCorner(2));
|
||||
Vector2 br = EditorGUILayout.Vector2Field("右下 (1,0)", image.GetCorner(3));
|
||||
if (EditorGUI.EndChangeCheck())
|
||||
{
|
||||
RecordTargetsUndo("编辑 Image 变形");
|
||||
foreach (Object t in targets)
|
||||
{
|
||||
if (t is XericImage img)
|
||||
img.SetCorners(bl, tl, tr, br);
|
||||
}
|
||||
// 上面走的是字段直改,SerializedObject 的缓存要重新读一遍
|
||||
serializedObject.Update();
|
||||
}
|
||||
}
|
||||
|
||||
private void DrawMatrixGenerator()
|
||||
{
|
||||
for (int r = 0; r < 4; r++)
|
||||
{
|
||||
EditorGUI.BeginChangeCheck();
|
||||
Vector4 row = EditorGUILayout.Vector4Field(r == 0 ? "矩阵 (4x4)" : " ", m_Matrix.GetRow(r));
|
||||
if (EditorGUI.EndChangeCheck())
|
||||
m_Matrix.SetRow(r, row);
|
||||
}
|
||||
|
||||
using (new EditorGUILayout.HorizontalScope())
|
||||
{
|
||||
if (GUILayout.Button("应用矩阵(2D 仿射)"))
|
||||
ApplyToTargets(img => img.ApplyAffine(m_Matrix), "应用仿射矩阵");
|
||||
if (GUILayout.Button("应用矩阵(伪投影)"))
|
||||
ApplyToTargets(img => img.ApplyProjected(m_Matrix), "应用伪投影矩阵");
|
||||
}
|
||||
}
|
||||
|
||||
private void DrawPlaneGenerator()
|
||||
{
|
||||
m_PlaneNormal = EditorGUILayout.Vector3Field("虚拟法线", m_PlaneNormal);
|
||||
m_PlaneRoll = EditorGUILayout.Slider("绕法线旋转", m_PlaneRoll, -180f, 180f);
|
||||
|
||||
if (GUILayout.Button("应用法线(拟合平面,仿射)"))
|
||||
ApplyToTargets(img => img.ApplyPlane(m_PlaneNormal, m_PlaneRoll), "应用平面法线");
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region Inspector 辅助
|
||||
|
||||
private void RecordTargetsUndo(string undoName)
|
||||
=> Undo.RecordObjects(targets, undoName);
|
||||
|
||||
private void ApplyToTargets(System.Action<XericImage> action, string undoName, bool recordSerialized = false)
|
||||
{
|
||||
if (recordSerialized)
|
||||
RecordTargetsUndo(undoName + "(含 Inspector 值)");
|
||||
else
|
||||
RecordTargetsUndo(undoName);
|
||||
|
||||
foreach (Object t in targets)
|
||||
{
|
||||
if (t is XericImage img)
|
||||
action(img);
|
||||
}
|
||||
|
||||
serializedObject.Update();
|
||||
SceneView.RepaintAll();
|
||||
}
|
||||
|
||||
private const string CornersClipboardKey = "XericImage.Corners";
|
||||
|
||||
private void CopyCorners()
|
||||
{
|
||||
var image = target as XericImage;
|
||||
if (image == null) return;
|
||||
|
||||
Vector2[] c = image.GetCorners();
|
||||
EditorPrefs.SetString(CornersClipboardKey, string.Format(
|
||||
"{0:F6}|{1:F6}|{2:F6}|{3:F6}|{4:F6}|{5:F6}|{6:F6}|{7:F6}",
|
||||
c[0].x, c[0].y, c[1].x, c[1].y, c[2].x, c[2].y, c[3].x, c[3].y));
|
||||
}
|
||||
|
||||
private void PasteCorners()
|
||||
{
|
||||
string raw = EditorPrefs.GetString(CornersClipboardKey, string.Empty);
|
||||
if (string.IsNullOrEmpty(raw)) return;
|
||||
|
||||
string[] parts = raw.Split('|');
|
||||
if (parts.Length != 8) return;
|
||||
|
||||
var values = new float[8];
|
||||
for (int i = 0; i < 8; i++)
|
||||
{
|
||||
float v;
|
||||
if (!float.TryParse(parts[i], System.Globalization.NumberStyles.Float,
|
||||
System.Globalization.CultureInfo.InvariantCulture, out v))
|
||||
return;
|
||||
values[i] = v;
|
||||
}
|
||||
|
||||
ApplyToTargets(img => img.SetCorners(
|
||||
new Vector2(values[0], values[1]),
|
||||
new Vector2(values[2], values[3]),
|
||||
new Vector2(values[4], values[5]),
|
||||
new Vector2(values[6], values[7])), "粘贴 Image 变形");
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 场景手柄
|
||||
|
||||
/// <summary>九宫格线框的格数(3 = 横竖各两条内线)</summary>
|
||||
private const int GridDivisions = 3;
|
||||
|
||||
/// <summary>滑移手柄横杠的朝向(供给 DashCap,绘制时逐边设置)</summary>
|
||||
private static Vector3 s_DashDirection = Vector3.right;
|
||||
|
||||
private void OnSceneGUI()
|
||||
{
|
||||
if (!SceneEditEnabled) return;
|
||||
|
||||
var image = target as XericImage;
|
||||
if (image == null) return;
|
||||
|
||||
Rect rect = image.GetPixelAdjustedRect();
|
||||
if (rect.width <= 0f || rect.height <= 0f) return;
|
||||
|
||||
Transform tr = image.transform;
|
||||
Vector3 planeNormal = tr.forward;
|
||||
|
||||
var world = new Vector3[4];
|
||||
var normalized = new Vector2[4];
|
||||
for (int i = 0; i < 4; i++)
|
||||
{
|
||||
normalized[i] = image.GetCorner(i);
|
||||
world[i] = tr.TransformPoint(image.NormalizedToLocal(normalized[i]));
|
||||
}
|
||||
|
||||
Handles.color = new Color(0.35f, 0.75f, 1f, 0.85f);
|
||||
Handles.DrawAAPolyLine(2f, world[0], world[1], world[2], world[3], world[0]);
|
||||
|
||||
DrawDeformGrid(image, tr);
|
||||
DrawEdgeHandles(image, rect, tr, world, normalized);
|
||||
DrawVertexHandles(image, tr, world, planeNormal);
|
||||
|
||||
// 一轮拖动结束才放开撤销闩锁
|
||||
if (Event.current.type == EventType.MouseUp || Event.current.type == EventType.Ignore)
|
||||
m_UndoLatched = false;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 九宫格线框:画的是单位正方形网格线在变形映射下的像。
|
||||
/// 单应把直线映成直线,所以每条线取两个端点即可精确;半透明的面上靠它看形变。
|
||||
/// </summary>
|
||||
private void DrawDeformGrid(XericImage image, Transform tr)
|
||||
{
|
||||
// 与 OnPopulateMesh 走同一个 XericQuadMapper:线框和网格必须在同一套映射下
|
||||
if (!image.TryGetDeformMapper(out XericQuadMapper mapper))
|
||||
return;
|
||||
|
||||
Handles.color = new Color(0.35f, 0.75f, 1f, 0.32f);
|
||||
|
||||
for (int i = 1; i < GridDivisions; i++)
|
||||
{
|
||||
float t = (float)i / GridDivisions;
|
||||
|
||||
Handles.DrawAAPolyLine(1f,
|
||||
tr.TransformPoint(mapper.MapNormalized(new Vector2(t, 0f))),
|
||||
tr.TransformPoint(mapper.MapNormalized(new Vector2(t, 1f))));
|
||||
Handles.DrawAAPolyLine(1f,
|
||||
tr.TransformPoint(mapper.MapNormalized(new Vector2(0f, t))),
|
||||
tr.TransformPoint(mapper.MapNormalized(new Vector2(1f, t))));
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>逐边绘制:滑移手柄(沿边方向平移两端点)与两个旋转手柄(绕边中点保持边长旋转)</summary>
|
||||
private void DrawEdgeHandles(XericImage image, Rect rect, Transform tr, Vector3[] world, Vector2[] normalized)
|
||||
{
|
||||
for (int e = 0; e < 4; e++)
|
||||
{
|
||||
int ia = e;
|
||||
int ib = (e + 1) % 4;
|
||||
|
||||
Vector3 a = world[ia];
|
||||
Vector3 b = world[ib];
|
||||
Vector3 mid = (a + b) * 0.5f;
|
||||
|
||||
Vector3 dir = b - a;
|
||||
float length = dir.magnitude;
|
||||
if (length < 1e-6f) continue;
|
||||
dir /= length;
|
||||
|
||||
float handleScale = HandleUtility.GetHandleSize(mid);
|
||||
|
||||
DrawSlideHandle(image, rect, tr, ia, ib, mid, dir, handleScale);
|
||||
DrawRotateHandles(image, tr, normalized, ia, ib, mid, dir, handleScale);
|
||||
}
|
||||
}
|
||||
|
||||
private void DrawSlideHandle(XericImage image, Rect rect, Transform tr, int ia, int ib,
|
||||
Vector3 mid, Vector3 dir, float handleScale)
|
||||
{
|
||||
s_DashDirection = dir;
|
||||
Handles.color = new Color(1f, 0.85f, 0.25f, 0.95f);
|
||||
|
||||
EditorGUI.BeginChangeCheck();
|
||||
Vector3 moved = Handles.Slider(mid, dir, handleScale * 0.11f, DashCap, 0f);
|
||||
if (!EditorGUI.EndChangeCheck()) return;
|
||||
|
||||
// 沿边方向平移:两端点吃同一个位移
|
||||
Vector3 worldDelta = moved - mid;
|
||||
Vector2 localDelta = tr.InverseTransformVector(worldDelta);
|
||||
var normalizedDelta = new Vector2(localDelta.x / rect.width, localDelta.y / rect.height);
|
||||
if (normalizedDelta == Vector2.zero) return;
|
||||
|
||||
Vector2[] corners = image.GetCorners();
|
||||
corners[ia] += normalizedDelta;
|
||||
corners[ib] += normalizedDelta;
|
||||
PushCorners(corners);
|
||||
}
|
||||
|
||||
private void DrawRotateHandles(XericImage image, Transform tr, Vector2[] normalized,
|
||||
int ia, int ib, Vector3 mid, Vector3 dir, float handleScale)
|
||||
{
|
||||
// 旋转在局部坐标里算:归一化空间两轴比例不同,直接在那里面旋转会把形状拧歪
|
||||
Vector2 localA = image.NormalizedToLocal(normalized[ia]);
|
||||
Vector2 localB = image.NormalizedToLocal(normalized[ib]);
|
||||
Vector2 midLocal = (localA + localB) * 0.5f;
|
||||
float halfLengthLocal = Vector2.Distance(localA, localB) * 0.5f;
|
||||
if (halfLengthLocal < 1e-6f) return;
|
||||
|
||||
Handles.color = new Color(0.4f, 1f, 0.6f, 0.95f);
|
||||
float offset = handleScale * 0.30f;
|
||||
|
||||
for (int side = -1; side <= 1; side += 2)
|
||||
{
|
||||
Vector3 handlePos = mid + dir * (offset * side);
|
||||
|
||||
EditorGUI.BeginChangeCheck();
|
||||
// 用"五个参数 + 显式旋转"那一档:它在 2021.1 … 6.x 都存在(四参数那档在旧版本里没有,
|
||||
// 他 2026-10-26 的编辑器报过 CS1501 "FreeMoveHandle 没有 4 参数的重载")。
|
||||
// 2022.1 起这一档被标了 Obsolete("Rotation parameter is obsolete"),但同名的四参数版
|
||||
// 在更老的版本里不存在 ⇒ 为了让同一个包在他所有工程都编得过,这里显式压掉 618,
|
||||
// 而不是二选一(选四参数=旧工程编不过,选五参数不压警告=门把警告记成诊断)。
|
||||
#pragma warning disable 618
|
||||
Vector3 dragged = Handles.FreeMoveHandle(handlePos, Quaternion.identity,
|
||||
handleScale * 0.07f, Vector3.zero, Handles.DotHandleCap);
|
||||
#pragma warning restore 618
|
||||
if (!EditorGUI.EndChangeCheck()) continue;
|
||||
if (dragged == handlePos) continue;
|
||||
|
||||
Vector3 dragLocal3 = tr.InverseTransformPoint(dragged);
|
||||
var dragLocal = new Vector2(dragLocal3.x, dragLocal3.y) - midLocal;
|
||||
if (dragLocal.sqrMagnitude < 1e-12f) continue;
|
||||
dragLocal.Normalize();
|
||||
|
||||
// 以当前边的长度和中点,把这条边旋到指向拖拽点的方向
|
||||
Vector2[] corners = image.GetCorners();
|
||||
corners[ia] = image.LocalToNormalized(midLocal - dragLocal * halfLengthLocal);
|
||||
corners[ib] = image.LocalToNormalized(midLocal + dragLocal * halfLengthLocal);
|
||||
PushCorners(corners);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>逐顶点绘制自由拖拽手柄(限制在组件自身的 XY 平面内)</summary>
|
||||
private void DrawVertexHandles(XericImage image, Transform tr, Vector3[] world, Vector3 planeNormal)
|
||||
{
|
||||
Handles.color = new Color(1f, 1f, 1f, 0.95f);
|
||||
|
||||
for (int i = 0; i < 4; i++)
|
||||
{
|
||||
Vector3 pos = world[i];
|
||||
float size = HandleUtility.GetHandleSize(pos) * 0.075f;
|
||||
|
||||
EditorGUI.BeginChangeCheck();
|
||||
Vector3 moved = Handles.Slider2D(pos, planeNormal, tr.right, tr.up, size,
|
||||
Handles.SphereHandleCap, Vector2.zero);
|
||||
if (!EditorGUI.EndChangeCheck()) continue;
|
||||
|
||||
Vector2 local = tr.InverseTransformPoint(moved);
|
||||
Vector2 target = image.LocalToNormalized(local);
|
||||
if (target == image.GetCorner(i)) continue;
|
||||
|
||||
Vector2[] corners = image.GetCorners();
|
||||
if (m_KeepParallelogram && IsParallelogram(corners))
|
||||
{
|
||||
// 平行四边形:对角点的位移必须与当前角点一致
|
||||
corners[(i + 2) % 4] += target - corners[i];
|
||||
}
|
||||
corners[i] = target;
|
||||
PushCorners(corners);
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>平行四边形判定:对角点连线的中点重合</summary>
|
||||
private static bool IsParallelogram(Vector2[] corners)
|
||||
{
|
||||
Vector2 d = corners[0] + corners[2] - corners[1] - corners[3];
|
||||
return d.sqrMagnitude < 1e-8f;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 场景手柄写回。只动 <see cref="Editor.target"/>:
|
||||
/// OnSceneGUI 里读 targets 数组是非法的(Unity 会直接报错),
|
||||
/// 而多选时每个选中对象的 Editor 都会各自收到一次 OnSceneGUI,天然就是各改各的。
|
||||
/// </summary>
|
||||
private void PushCorners(Vector2[] corners)
|
||||
{
|
||||
var image = target as XericImage;
|
||||
if (image == null) return;
|
||||
|
||||
// 一轮操作只登记一条撤销,否则拖动时一帧一条会把撤销栈刷满
|
||||
if (!m_UndoLatched)
|
||||
{
|
||||
Undo.RecordObject(image, "变形 Image 顶点");
|
||||
m_UndoLatched = true;
|
||||
}
|
||||
|
||||
image.SetCorners(corners[0], corners[1], corners[2], corners[3]);
|
||||
EditorUtility.SetDirty(image);
|
||||
SceneView.RepaintAll();
|
||||
}
|
||||
|
||||
/// <summary>滑移手柄的横杠:沿当前边的方向画一段粗线</summary>
|
||||
private static void DashCap(int controlID, Vector3 position, Quaternion rotation, float size, EventType eventType)
|
||||
{
|
||||
if (eventType != EventType.Repaint) return;
|
||||
Vector3 half = s_DashDirection * size;
|
||||
Handles.DrawAAPolyLine(4f, position - half, position + half);
|
||||
}
|
||||
|
||||
#endregion
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
fileFormatVersion: 2
|
||||
guid: e26e5a1acab84c8480f3ea4d4076dafd
|
||||
MonoImporter:
|
||||
externalObjects: {}
|
||||
serializedVersion: 2
|
||||
defaultReferences: []
|
||||
executionOrder: 0
|
||||
icon: {instanceID: 0}
|
||||
userData:
|
||||
assetBundleName:
|
||||
assetBundleVariant:
|
||||
@@ -3,16 +3,15 @@ using System.Collections.Generic;
|
||||
using UnityEngine;
|
||||
using UnityEngine.Pool;
|
||||
using XericLibrary.Runtime;
|
||||
using XericLibrary.Runtime.Type;
|
||||
|
||||
namespace XericUI.InfiniteVessel
|
||||
{
|
||||
/// <summary>
|
||||
/// 无限UI列表容器基类
|
||||
/// 无限UI列表容器基类
|
||||
/// </summary>
|
||||
public abstract class XericInfiniteVesselBase : WeaklyMonoBase
|
||||
{
|
||||
#region 字段属性
|
||||
#region 字段属性
|
||||
|
||||
public GameObject mainItemPrefab;
|
||||
|
||||
@@ -20,7 +19,7 @@ namespace XericUI.InfiniteVessel
|
||||
|
||||
#endregion
|
||||
|
||||
#region 生命周期
|
||||
#region 生命周期
|
||||
|
||||
protected virtual void Awake()
|
||||
{
|
||||
@@ -35,10 +34,10 @@ namespace XericUI.InfiniteVessel
|
||||
|
||||
#endregion
|
||||
|
||||
#region 对象池操作
|
||||
#region 对象池操作
|
||||
|
||||
/// <summary>
|
||||
/// 创建对象
|
||||
/// 创建对象
|
||||
/// </summary>
|
||||
/// <returns></returns>
|
||||
public virtual GameObject CreatItem()
|
||||
@@ -47,7 +46,7 @@ namespace XericUI.InfiniteVessel
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 获取对象,并获取管理器
|
||||
/// 获取对象,并获取管理器
|
||||
/// </summary>
|
||||
/// <param name="target"></param>
|
||||
/// <typeparam name="T"></typeparam>
|
||||
@@ -58,7 +57,7 @@ namespace XericUI.InfiniteVessel
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 释放对象
|
||||
/// 释放对象
|
||||
/// </summary>
|
||||
/// <param name="target"></param>
|
||||
public virtual void ReleaseItem(GameObject target)
|
||||
@@ -67,7 +66,7 @@ namespace XericUI.InfiniteVessel
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 销毁对象
|
||||
/// 销毁对象
|
||||
/// </summary>
|
||||
/// <param name="target"></param>
|
||||
public virtual void DestroyItem(GameObject target)
|
||||
|
||||
@@ -3,6 +3,7 @@ using UnityEngine;
|
||||
using UnityEngine.Serialization;
|
||||
using UnityEngine.UI;
|
||||
using XericUI.Helper;
|
||||
using XericUI.Core;
|
||||
|
||||
namespace XericUI.OverrideUI
|
||||
{
|
||||
@@ -10,9 +11,11 @@ namespace XericUI.OverrideUI
|
||||
/// 图像组件
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// 这个组件主要为了提供graphic层的事件,用于应对部分无法重写的ui组件事件
|
||||
/// 这个组件主要为了提供graphic层的事件,用于应对部分无法重写的ui组件事件。
|
||||
/// 另外支持四顶点变形(错切 / 倾斜 / 平行四边形 / 伪投影):
|
||||
/// 顶点偏移存在归一化矩形空间里,RectTransform 尺寸变化时变形等比跟随。
|
||||
/// </remarks>
|
||||
[AddComponentMenu("Xeric UI Vessel/UI/Image", 50)]
|
||||
[AddComponentMenu(XericRegistrationPaths.UI + "/Image", 50)]
|
||||
public class XericImage : Image
|
||||
{
|
||||
/// <summary>
|
||||
@@ -25,13 +28,185 @@ namespace XericUI.OverrideUI
|
||||
OnToggleCrossFadeCall?.Invoke(targetColor.a > 0);
|
||||
}
|
||||
|
||||
#region 顶点变形
|
||||
|
||||
// 角点索引:0=左下 1=左上 2=右上 3=右下(与 Image 生成的顶点顺序一致)
|
||||
|
||||
[SerializeField, Tooltip("左下角顶点偏移(归一化矩形空间,零=不变形)")]
|
||||
private Vector2 m_CornerOffsetBL;
|
||||
[SerializeField, Tooltip("左上角顶点偏移(归一化矩形空间,零=不变形)")]
|
||||
private Vector2 m_CornerOffsetTL;
|
||||
[SerializeField, Tooltip("右上角顶点偏移(归一化矩形空间,零=不变形)")]
|
||||
private Vector2 m_CornerOffsetTR;
|
||||
[SerializeField, Tooltip("右下角顶点偏移(归一化矩形空间,零=不变形)")]
|
||||
private Vector2 m_CornerOffsetBR;
|
||||
|
||||
/// <summary>是否处于变形状态(四角偏移全为零即未变形)</summary>
|
||||
public bool HasDeform =>
|
||||
m_CornerOffsetBL != Vector2.zero ||
|
||||
m_CornerOffsetTL != Vector2.zero ||
|
||||
m_CornerOffsetTR != Vector2.zero ||
|
||||
m_CornerOffsetBR != Vector2.zero;
|
||||
|
||||
/// <summary>归一化矩形空间下的恒等角点</summary>
|
||||
public static Vector2 IdentityCorner(int index)
|
||||
{
|
||||
switch (index)
|
||||
{
|
||||
case 0: return new Vector2(0f, 0f);
|
||||
case 1: return new Vector2(0f, 1f);
|
||||
case 2: return new Vector2(1f, 1f);
|
||||
case 3: return new Vector2(1f, 0f);
|
||||
default: throw new ArgumentOutOfRangeException(nameof(index), index, "角点索引必须在 0..3");
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>取某个角点在归一化矩形空间下的坐标(恒等 + 偏移)</summary>
|
||||
public Vector2 GetCorner(int index) => IdentityCorner(index) + GetCornerOffset(index);
|
||||
|
||||
/// <summary>取某个角点在归一化矩形空间下的偏移量</summary>
|
||||
public Vector2 GetCornerOffset(int index)
|
||||
{
|
||||
switch (index)
|
||||
{
|
||||
case 0: return m_CornerOffsetBL;
|
||||
case 1: return m_CornerOffsetTL;
|
||||
case 2: return m_CornerOffsetTR;
|
||||
case 3: return m_CornerOffsetBR;
|
||||
default: throw new ArgumentOutOfRangeException(nameof(index), index, "角点索引必须在 0..3");
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>按归一化矩形空间下的坐标设置单个角点</summary>
|
||||
public void SetCorner(int index, Vector2 normalizedCorner)
|
||||
{
|
||||
Vector2[] corners = GetCorners();
|
||||
corners[index] = normalizedCorner;
|
||||
ApplyCorners(corners[0], corners[1], corners[2], corners[3]);
|
||||
}
|
||||
|
||||
/// <summary>一次性设置四个角点(归一化矩形空间)</summary>
|
||||
public void SetCorners(Vector2 cornerBL, Vector2 cornerTL, Vector2 cornerTR, Vector2 cornerBR)
|
||||
=> ApplyCorners(cornerBL, cornerTL, cornerTR, cornerBR);
|
||||
|
||||
/// <summary>取四个角点(归一化矩形空间),顺序 左下 / 左上 / 右上 / 右下</summary>
|
||||
public Vector2[] GetCorners() => new[]
|
||||
{
|
||||
GetCorner(0),
|
||||
GetCorner(1),
|
||||
GetCorner(2),
|
||||
GetCorner(3),
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// 用 2D 仿射矩阵变形(只取矩阵的 XY 子块),结果一定是平行四边形。
|
||||
/// </summary>
|
||||
public void ApplyAffine(Matrix4x4 matrix)
|
||||
{
|
||||
Vector2[] c = XericQuadDeformMath.AffineCorners(matrix);
|
||||
ApplyCorners(c[0], c[1], c[2], c[3]);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 用完整 4x4 矩阵变形并做透视除(伪投影):可得到任意四边形。
|
||||
/// </summary>
|
||||
public void ApplyProjected(Matrix4x4 matrix)
|
||||
{
|
||||
Vector2[] c = XericQuadDeformMath.ProjectedCorners(matrix);
|
||||
ApplyCorners(c[0], c[1], c[2], c[3]);
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 用虚拟平面法线定义这个面,内部换算成拟合该平面的仿射(倾斜 = 纵向 cos 压缩)。
|
||||
/// </summary>
|
||||
/// <param name="normal">虚拟法线,UI 平面默认朝向为 (0,0,-1)</param>
|
||||
/// <param name="rollDegrees">绕法线自身的旋转角(度)</param>
|
||||
public void ApplyPlane(Vector3 normal, float rollDegrees = 0f)
|
||||
{
|
||||
Vector2[] c = XericQuadDeformMath.PlaneCorners(normal, rollDegrees);
|
||||
ApplyCorners(c[0], c[1], c[2], c[3]);
|
||||
}
|
||||
|
||||
/// <summary>清除变形,恢复未变形的矩形</summary>
|
||||
public void ResetDeform()
|
||||
{
|
||||
m_CornerOffsetBL = Vector2.zero;
|
||||
m_CornerOffsetTL = Vector2.zero;
|
||||
m_CornerOffsetTR = Vector2.zero;
|
||||
m_CornerOffsetBR = Vector2.zero;
|
||||
SetVerticesDirty();
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 取当前变形的映射器。基准矩形与 Image 生成网格时用的那个同源
|
||||
/// (<see cref="Graphic.GetPixelAdjustedRect"/>);变形数据退化时返回 false。
|
||||
/// </summary>
|
||||
public bool TryGetDeformMapper(out XericQuadMapper mapper)
|
||||
=> XericQuadMapper.TryCreate(GetCorner(0), GetCorner(1), GetCorner(2), GetCorner(3),
|
||||
GetPixelAdjustedRect(), out mapper);
|
||||
|
||||
/// <summary>归一化矩形空间 -> RectTransform 局部坐标</summary>
|
||||
public Vector2 NormalizedToLocal(Vector2 normalized)
|
||||
=> XericQuadDeformMath.NormalizedToLocal(normalized, GetPixelAdjustedRect());
|
||||
|
||||
/// <summary>RectTransform 局部坐标 -> 归一化矩形空间</summary>
|
||||
public Vector2 LocalToNormalized(Vector2 local)
|
||||
{
|
||||
Rect rect = GetPixelAdjustedRect();
|
||||
if (rect.width <= 0f || rect.height <= 0f)
|
||||
return Vector2.zero;
|
||||
return XericQuadDeformMath.LocalToNormalized(local, rect);
|
||||
}
|
||||
|
||||
/// <summary>取某个角点的局部坐标(场景编辑手柄与网格生成共用同一套换算)</summary>
|
||||
public Vector2 GetCornerLocal(int index) => NormalizedToLocal(GetCorner(index));
|
||||
|
||||
private void ApplyCorners(Vector2 cornerBL, Vector2 cornerTL, Vector2 cornerTR, Vector2 cornerBR)
|
||||
{
|
||||
m_CornerOffsetBL = cornerBL - IdentityCorner(0);
|
||||
m_CornerOffsetTL = cornerTL - IdentityCorner(1);
|
||||
m_CornerOffsetTR = cornerTR - IdentityCorner(2);
|
||||
m_CornerOffsetBR = cornerBR - IdentityCorner(3);
|
||||
SetVerticesDirty();
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 网格生成
|
||||
|
||||
protected override void OnPopulateMesh(VertexHelper toFill)
|
||||
{
|
||||
base.OnPopulateMesh(toFill);
|
||||
|
||||
if (!HasDeform || toFill.currentVertCount == 0)
|
||||
return;
|
||||
|
||||
// 退化四边形(自交/零面积)时退回未变形网格,避免把 NaN 顶点写进 CanvasRenderer。
|
||||
// 顶点坐标活在局部空间、变形数据活在归一化矩形空间,那次换乘只在
|
||||
// XericQuadMapper 里实现一次(曾经在这里手写换算,漏掉回程就整块塌成 1 像素)。
|
||||
if (!TryGetDeformMapper(out XericQuadMapper mapper))
|
||||
return;
|
||||
|
||||
var vertex = UIVertex.simpleVert;
|
||||
for (int i = 0; i < toFill.currentVertCount; i++)
|
||||
{
|
||||
toFill.PopulateUIVertex(ref vertex, i);
|
||||
|
||||
Vector2 mapped = mapper.MapLocal(vertex.position);
|
||||
vertex.position = new Vector3(mapped.x, mapped.y, vertex.position.z);
|
||||
toFill.SetUIVertex(vertex, i);
|
||||
}
|
||||
}
|
||||
|
||||
#endregion
|
||||
|
||||
#region 组件替换
|
||||
#if UNITY_EDITOR
|
||||
[UnityEditor.MenuItem("CONTEXT/Image/Replace To/Xeric Image", true)]
|
||||
[UnityEditor.MenuItem(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Xeric Image", true)]
|
||||
private static bool ValidateReplaceToXeric(UnityEditor.MenuCommand command)
|
||||
=> command.context is Image and not XericImage;
|
||||
|
||||
[UnityEditor.MenuItem("CONTEXT/Image/Replace To/Xeric Image", false, 10)]
|
||||
[UnityEditor.MenuItem(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Xeric Image", false, 10)]
|
||||
private static void ReplaceToXeric(UnityEditor.MenuCommand command)
|
||||
=> command.ReplaceCommandContext<Image, XericImage, Sprite>(
|
||||
o =>
|
||||
@@ -41,11 +216,11 @@ namespace XericUI.OverrideUI
|
||||
t.sprite = d;
|
||||
});
|
||||
|
||||
[UnityEditor.MenuItem("CONTEXT/Image/Replace To/Unity Image (Native)", true)]
|
||||
[UnityEditor.MenuItem(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Unity Image (Native)", true)]
|
||||
private static bool ValidateReplaceToUnity(UnityEditor.MenuCommand command)
|
||||
=> command.context is XericImage;
|
||||
|
||||
[UnityEditor.MenuItem("CONTEXT/Image/Replace To/Unity Image (Native)", false, 100)]
|
||||
[UnityEditor.MenuItem(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Unity Image (Native)", false, 100)]
|
||||
private static void ReplaceToUnity(UnityEditor.MenuCommand command)
|
||||
=> command.ReplaceCommandContext<XericImage, Image, Sprite>(
|
||||
o =>
|
||||
|
||||
@@ -0,0 +1,312 @@
|
||||
using UnityEngine;
|
||||
|
||||
namespace XericUI.OverrideUI
|
||||
{
|
||||
/// <summary>
|
||||
/// 单位正方形 [0,1]^2 到任意四边形的投影映射(单应)。
|
||||
/// 平行四边形自动退化为仿射(分母恒为 1);自交或零面积的退化四边形判定为无效。
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// 顶点约定与 <see cref="UnityEngine.UI.Image"/> 的顶点顺序一致:
|
||||
/// (0,0)=左下 BL,(1,0)=右下 BR,(1,1)=右上 TR,(0,1)=左上 TL。
|
||||
/// 坐标是归一化矩形空间下的坐标,乘以矩形尺寸即得 RectTransform 局部坐标。
|
||||
/// </remarks>
|
||||
public struct XericQuadProjection
|
||||
{
|
||||
private const float Epsilon = 1e-8f;
|
||||
|
||||
private float m_A, m_B, m_C;
|
||||
private float m_D, m_E, m_F;
|
||||
private float m_G, m_H;
|
||||
private bool m_Valid;
|
||||
|
||||
public bool IsValid => m_Valid;
|
||||
|
||||
/// <summary>
|
||||
/// 由四边形的四个角点构造映射。
|
||||
/// </summary>
|
||||
/// <param name="p00">单位坐标 (0,0) 对应的角点</param>
|
||||
/// <param name="p10">单位坐标 (1,0) 对应的角点</param>
|
||||
/// <param name="p11">单位坐标 (1,1) 对应的角点</param>
|
||||
/// <param name="p01">单位坐标 (0,1) 对应的角点</param>
|
||||
/// <param name="projection">构造结果;四点为退化四边形时 IsValid 为 false</param>
|
||||
public static bool TryCreate(Vector2 p00, Vector2 p10, Vector2 p11, Vector2 p01,
|
||||
out XericQuadProjection projection)
|
||||
{
|
||||
float x0 = p00.x, y0 = p00.y;
|
||||
float x1 = p10.x, y1 = p10.y;
|
||||
float x2 = p11.x, y2 = p11.y;
|
||||
float x3 = p01.x, y3 = p01.y;
|
||||
|
||||
float g, h;
|
||||
float sx = x0 - x1 + x2 - x3;
|
||||
float sy = y0 - y1 + y2 - y3;
|
||||
|
||||
if (Mathf.Abs(sx) < Epsilon && Mathf.Abs(sy) < Epsilon)
|
||||
{
|
||||
// 平行四边形:仿射,分母恒为 1
|
||||
g = 0f;
|
||||
h = 0f;
|
||||
}
|
||||
else
|
||||
{
|
||||
float dx1 = x1 - x2, dx2 = x3 - x2, dx3 = x0 - x1 + x2 - x3;
|
||||
float dy1 = y1 - y2, dy2 = y3 - y2, dy3 = y0 - y1 + y2 - y3;
|
||||
float den = dx1 * dy2 - dx2 * dy1;
|
||||
if (Mathf.Abs(den) < Epsilon)
|
||||
{
|
||||
projection = default;
|
||||
return false;
|
||||
}
|
||||
|
||||
g = (dx3 * dy2 - dx2 * dy3) / den;
|
||||
h = (dx1 * dy3 - dx3 * dy1) / den;
|
||||
|
||||
// 分母 g*u+h*v+1 是线性函数,其在单位正方形上的最小值必落在角点上,
|
||||
// 且 (0,0) 处恒为 1。若另外三个角点出现非正分母,说明该分母在四边形内部
|
||||
// 会穿过零点,映射会炸成 NaN 顶点。
|
||||
if (Mathf.Min(g + 1f, Mathf.Min(h + 1f, g + h + 1f)) <= 0f)
|
||||
{
|
||||
projection = default;
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
projection = new XericQuadProjection
|
||||
{
|
||||
m_A = x1 - x0 + g * x1,
|
||||
m_B = x3 - x0 + h * x3,
|
||||
m_C = x0,
|
||||
m_D = y1 - y0 + g * y1,
|
||||
m_E = y3 - y0 + h * y3,
|
||||
m_F = y0,
|
||||
m_G = g,
|
||||
m_H = h,
|
||||
m_Valid = true,
|
||||
};
|
||||
return true;
|
||||
}
|
||||
|
||||
/// <summary>把单位正方形内的坐标映射到四边形上(需 IsValid)。</summary>
|
||||
public Vector2 Transform(float u, float v)
|
||||
{
|
||||
float w = m_G * u + m_H * v + 1f;
|
||||
return new Vector2(
|
||||
(m_A * u + m_B * v + m_C) / w,
|
||||
(m_D * u + m_E * v + m_F) / w);
|
||||
}
|
||||
|
||||
/// <summary>求逆映射:四边形上的坐标映射回单位正方形。</summary>
|
||||
public bool TryInvert(out XericQuadProjection inverse)
|
||||
{
|
||||
float m00 = m_A, m01 = m_B, m02 = m_C;
|
||||
float m10 = m_D, m11 = m_E, m12 = m_F;
|
||||
float m20 = m_G, m21 = m_H, m22 = 1f;
|
||||
|
||||
float det = m00 * (m11 * m22 - m12 * m21)
|
||||
- m01 * (m10 * m22 - m12 * m20)
|
||||
+ m02 * (m10 * m21 - m11 * m20);
|
||||
if (Mathf.Abs(det) < Epsilon)
|
||||
{
|
||||
inverse = default;
|
||||
return false;
|
||||
}
|
||||
|
||||
float i00 = (m11 * m22 - m12 * m21) / det;
|
||||
float i01 = (m02 * m21 - m01 * m22) / det;
|
||||
float i02 = (m01 * m12 - m02 * m11) / det;
|
||||
float i10 = (m12 * m20 - m10 * m22) / det;
|
||||
float i11 = (m00 * m22 - m02 * m20) / det;
|
||||
float i12 = (m02 * m10 - m00 * m12) / det;
|
||||
float i20 = (m10 * m21 - m11 * m20) / det;
|
||||
float i21 = (m01 * m20 - m00 * m21) / det;
|
||||
float i22 = (m00 * m11 - m01 * m10) / det;
|
||||
if (Mathf.Abs(i22) < Epsilon)
|
||||
{
|
||||
inverse = default;
|
||||
return false;
|
||||
}
|
||||
|
||||
// 正向映射的分母常数是 1,逆矩阵必须按 i22 归一化才能同构表示
|
||||
float inv = 1f / i22;
|
||||
inverse = new XericQuadProjection
|
||||
{
|
||||
m_A = i00 * inv,
|
||||
m_B = i01 * inv,
|
||||
m_C = i02 * inv,
|
||||
m_D = i10 * inv,
|
||||
m_E = i11 * inv,
|
||||
m_F = i12 * inv,
|
||||
m_G = i20 * inv,
|
||||
m_H = i21 * inv,
|
||||
m_Valid = true,
|
||||
};
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 变形映射 + 它所属的矩形,合起来才够把局部坐标映射到局部坐标。
|
||||
/// </summary>
|
||||
/// <remarks>
|
||||
/// 角点活在归一化矩形空间,而网格顶点活在 RectTransform 局部空间(两者差一次
|
||||
/// 矩形偏移与尺寸的换算)。这次换乘必须只有一份实现:网格生成、场景线框、离线自测
|
||||
/// 都走这里,否则很容易漏掉某一次换算 —— 漏了就会写出一堆 0..1 的顶点,
|
||||
/// 在像素空间里塌成不到 1 像素的一团。
|
||||
/// </remarks>
|
||||
public struct XericQuadMapper
|
||||
{
|
||||
private XericQuadProjection m_Projection;
|
||||
private Rect m_Rect;
|
||||
private bool m_Valid;
|
||||
|
||||
public bool IsValid => m_Valid;
|
||||
|
||||
/// <summary>
|
||||
/// 角点按 左下 / 左上 / 右上 / 右下 给(与 UnityEngine.UI.Image 的顶点顺序一致)。
|
||||
/// </summary>
|
||||
public static bool TryCreate(Vector2 cornerBL, Vector2 cornerTL, Vector2 cornerTR, Vector2 cornerBR,
|
||||
Rect rect, out XericQuadMapper mapper)
|
||||
{
|
||||
mapper = default;
|
||||
if (rect.width <= 0f || rect.height <= 0f)
|
||||
return false;
|
||||
// 单位正方形顺序:p00=左下 p10=右下 p11=右上 p01=左上
|
||||
if (!XericQuadProjection.TryCreate(cornerBL, cornerBR, cornerTR, cornerTL, out XericQuadProjection projection))
|
||||
return false;
|
||||
|
||||
mapper.m_Projection = projection;
|
||||
mapper.m_Rect = rect;
|
||||
mapper.m_Valid = true;
|
||||
return true;
|
||||
}
|
||||
|
||||
public Vector2 NormalizedToLocal(Vector2 normalized)
|
||||
=> XericQuadDeformMath.NormalizedToLocal(normalized, m_Rect);
|
||||
|
||||
public Vector2 LocalToNormalized(Vector2 local)
|
||||
=> XericQuadDeformMath.LocalToNormalized(local, m_Rect);
|
||||
|
||||
/// <summary>归一化矩形空间 -> 局部坐标,并经过变形投射。</summary>
|
||||
public Vector2 MapNormalized(Vector2 normalized)
|
||||
=> NormalizedToLocal(m_Projection.Transform(normalized.x, normalized.y));
|
||||
|
||||
/// <summary>局部坐标 -> 局部坐标:网格顶点就是这么算的。</summary>
|
||||
public Vector2 MapLocal(Vector2 local)
|
||||
{
|
||||
Vector2 normalized = LocalToNormalized(local);
|
||||
return NormalizedToLocal(m_Projection.Transform(normalized.x, normalized.y));
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 四边形变形的生成器:把矩阵 / 虚拟法线换算成归一化矩形空间下的四个角点。
|
||||
/// 角点数组顺序统一为 [0]=左下BL [1]=左上TL [2]=右上TR [3]=右下BR。
|
||||
/// </summary>
|
||||
public static class XericQuadDeformMath
|
||||
{
|
||||
/// <summary>归一化矩形空间 -> 局部坐标(矩形自身的换算,与变形是否有效无关)。</summary>
|
||||
public static Vector2 NormalizedToLocal(Vector2 normalized, Rect rect) => new Vector2(
|
||||
rect.xMin + rect.width * normalized.x,
|
||||
rect.yMin + rect.height * normalized.y);
|
||||
|
||||
/// <summary>局部坐标 -> 归一化矩形空间(矩形自身的换算,与变形是否有效无关)。</summary>
|
||||
public static Vector2 LocalToNormalized(Vector2 local, Rect rect) => new Vector2(
|
||||
(local.x - rect.xMin) / rect.width,
|
||||
(local.y - rect.yMin) / rect.height);
|
||||
|
||||
/// <summary>恒等角点(不变形)</summary>
|
||||
public static Vector2[] IdentityCorners() => new[]
|
||||
{
|
||||
new Vector2(0f, 0f),
|
||||
new Vector2(0f, 1f),
|
||||
new Vector2(1f, 1f),
|
||||
new Vector2(1f, 0f),
|
||||
};
|
||||
|
||||
/// <summary>
|
||||
/// 2D 仿射:只取矩阵的 XY 子块(平移取第三列),结果必为平行四边形。
|
||||
/// </summary>
|
||||
public static Vector2[] AffineCorners(Matrix4x4 matrix)
|
||||
{
|
||||
var corners = new Vector2[4];
|
||||
for (int i = 0; i < 4; i++)
|
||||
{
|
||||
Vector2 unit = UnitSquareCorner(i);
|
||||
Vector3 p = matrix.MultiplyPoint3x4(new Vector3(unit.x, unit.y, 0f));
|
||||
corners[i] = new Vector2(p.x, p.y);
|
||||
}
|
||||
return corners;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 伪投影:用完整 4x4 变换四个角点后做 w 透视除。
|
||||
/// 与 <see cref="AffineCorners"/> 的区别在于 w 不恒为 1,
|
||||
/// 因此可以吃到"平面在 3D 内倾斜后再投影"的透视收敛。
|
||||
/// </summary>
|
||||
public static Vector2[] ProjectedCorners(Matrix4x4 matrix)
|
||||
{
|
||||
var corners = new Vector2[4];
|
||||
for (int i = 0; i < 4; i++)
|
||||
{
|
||||
Vector2 unit = UnitSquareCorner(i);
|
||||
corners[i] = Project(matrix, new Vector3(unit.x, unit.y, 0f));
|
||||
}
|
||||
return corners;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 虚拟平面法线:把 UI 平面(默认法线 (0,0,-1))旋到给定法线后做正交投影,
|
||||
/// 得到一个拟合该平面的仿射(倾斜会带来 cos 的纵向压缩)。
|
||||
/// </summary>
|
||||
/// <param name="normal">虚拟法线,零向量按默认朝向处理</param>
|
||||
/// <param name="rollDegrees">绕法线自身的旋转角(度)</param>
|
||||
public static Vector2[] PlaneCorners(Vector3 normal, float rollDegrees)
|
||||
{
|
||||
if (normal.sqrMagnitude < 1e-8f)
|
||||
normal = Vector3.back;
|
||||
normal = normal.normalized;
|
||||
|
||||
Quaternion rotation = Quaternion.FromToRotation(Vector3.back, normal)
|
||||
* Quaternion.Euler(0f, 0f, rollDegrees);
|
||||
Matrix4x4 m = Matrix4x4.Rotate(rotation);
|
||||
|
||||
// 旋转后的本地 XY 轴在屏幕 XY 平面上的投影(正交投影)
|
||||
var ex = new Vector2(m.m00, m.m10);
|
||||
var ey = new Vector2(m.m01, m.m11);
|
||||
var center = new Vector2(0.5f, 0.5f);
|
||||
Vector2 hx = ex * 0.5f;
|
||||
Vector2 hy = ey * 0.5f;
|
||||
|
||||
return new[]
|
||||
{
|
||||
center - hx - hy,
|
||||
center - hx + hy,
|
||||
center + hx + hy,
|
||||
center + hx - hy,
|
||||
};
|
||||
}
|
||||
|
||||
private static Vector2 UnitSquareCorner(int index)
|
||||
{
|
||||
switch (index)
|
||||
{
|
||||
case 0: return new Vector2(0f, 0f);
|
||||
case 1: return new Vector2(0f, 1f);
|
||||
case 2: return new Vector2(1f, 1f);
|
||||
case 3: return new Vector2(1f, 0f);
|
||||
default: return Vector2.zero;
|
||||
}
|
||||
}
|
||||
|
||||
private static Vector2 Project(Matrix4x4 m, Vector3 p)
|
||||
{
|
||||
float x = m.m00 * p.x + m.m01 * p.y + m.m02 * p.z + m.m03;
|
||||
float y = m.m10 * p.x + m.m11 * p.y + m.m12 * p.z + m.m13;
|
||||
float w = m.m30 * p.x + m.m31 * p.y + m.m32 * p.z + m.m33;
|
||||
if (Mathf.Abs(w) < 1e-6f)
|
||||
w = w < 0f ? -1e-6f : 1e-6f;
|
||||
return new Vector2(x / w, y / w);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
fileFormatVersion: 2
|
||||
guid: 704b3d7a7481414aacc86e7a83ebc0b3
|
||||
MonoImporter:
|
||||
externalObjects: {}
|
||||
serializedVersion: 2
|
||||
defaultReferences: []
|
||||
executionOrder: 0
|
||||
icon: {instanceID: 0}
|
||||
userData:
|
||||
assetBundleName:
|
||||
assetBundleVariant:
|
||||
Reference in New Issue
Block a user