From a311c417bebdb8031d7b6229b5b00c5580a9a706 Mon Sep 17 00:00:00 2001 From: lrc <571244399@qq.com> Date: Tue, 3 Nov 2026 10:43:23 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E4=BA=86=E6=94=AF=E6=8C=81?= =?UTF-8?q?=E4=BB=BF=E5=B0=84=E5=8F=98=E6=8D=A2=E7=9A=84image=E7=BB=84?= =?UTF-8?q?=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Editor/OverrideUI/XericImageEditor.cs | 497 ++++++++++++++++++ Editor/OverrideUI/XericImageEditor.cs.meta | 11 + .../InfiniteVessel/XericInfiniteVesselBase.cs | 17 +- Runtime/OverrideUI/XericImage.cs | 187 ++++++- Runtime/OverrideUI/XericImageDeform.cs | 312 +++++++++++ Runtime/OverrideUI/XericImageDeform.cs.meta | 11 + 6 files changed, 1020 insertions(+), 15 deletions(-) create mode 100644 Editor/OverrideUI/XericImageEditor.cs create mode 100644 Editor/OverrideUI/XericImageEditor.cs.meta create mode 100644 Runtime/OverrideUI/XericImageDeform.cs create mode 100644 Runtime/OverrideUI/XericImageDeform.cs.meta diff --git a/Editor/OverrideUI/XericImageEditor.cs b/Editor/OverrideUI/XericImageEditor.cs new file mode 100644 index 0000000..1684815 --- /dev/null +++ b/Editor/OverrideUI/XericImageEditor.cs @@ -0,0 +1,497 @@ +using UnityEditor; +using UnityEditor.UI; + +using UnityEngine; +using UnityEngine.UI; + +using XericUI.OverrideUI; +using XericUI.Core; + +namespace XericUIEditor.OverrideUI +{ + /// + /// XericImage 的 Inspector 与场景编辑手柄。 + /// 场景手柄布局(每条边一套): + /// + /// 圆点 --------- 圆点 - 横 - 圆点 --------- 圆点 + /// 顶点 旋转 滑移 旋转 顶点 + /// + /// 顶点=自由拖拽该角点;横=沿这条边的方向平移两端点;圆点=绕这条边的中点旋转两端点(保持边长)。 + /// + [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; + + /// 场景手柄总开关(默认关闭,避免选中任何 Image 都冒出手柄) + 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 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 场景手柄 + + /// 九宫格线框的格数(3 = 横竖各两条内线) + private const int GridDivisions = 3; + + /// 滑移手柄横杠的朝向(供给 DashCap,绘制时逐边设置) + 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; + } + + /// + /// 九宫格线框:画的是单位正方形网格线在变形映射下的像。 + /// 单应把直线映成直线,所以每条线取两个端点即可精确;半透明的面上靠它看形变。 + /// + 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)))); + } + } + + /// 逐边绘制:滑移手柄(沿边方向平移两端点)与两个旋转手柄(绕边中点保持边长旋转) + 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); + } + } + + /// 逐顶点绘制自由拖拽手柄(限制在组件自身的 XY 平面内) + 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); + } + } + + /// 平行四边形判定:对角点连线的中点重合 + private static bool IsParallelogram(Vector2[] corners) + { + Vector2 d = corners[0] + corners[2] - corners[1] - corners[3]; + return d.sqrMagnitude < 1e-8f; + } + + /// + /// 场景手柄写回。只动 : + /// OnSceneGUI 里读 targets 数组是非法的(Unity 会直接报错), + /// 而多选时每个选中对象的 Editor 都会各自收到一次 OnSceneGUI,天然就是各改各的。 + /// + 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(); + } + + /// 滑移手柄的横杠:沿当前边的方向画一段粗线 + 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 + } +} \ No newline at end of file diff --git a/Editor/OverrideUI/XericImageEditor.cs.meta b/Editor/OverrideUI/XericImageEditor.cs.meta new file mode 100644 index 0000000..b6dea51 --- /dev/null +++ b/Editor/OverrideUI/XericImageEditor.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: e26e5a1acab84c8480f3ea4d4076dafd +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: \ No newline at end of file diff --git a/Runtime/InfiniteVessel/XericInfiniteVesselBase.cs b/Runtime/InfiniteVessel/XericInfiniteVesselBase.cs index 7fcc93c..37fbeda 100644 --- a/Runtime/InfiniteVessel/XericInfiniteVesselBase.cs +++ b/Runtime/InfiniteVessel/XericInfiniteVesselBase.cs @@ -3,16 +3,15 @@ using System.Collections.Generic; using UnityEngine; using UnityEngine.Pool; using XericLibrary.Runtime; -using XericLibrary.Runtime.Type; namespace XericUI.InfiniteVessel { /// - /// ÎÞÏÞUIÁбíÈÝÆ÷»ùÀà + /// 无限UI列表容器基类 /// 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 对象池操作 /// - /// ´´½¨¶ÔÏó + /// 创建对象 /// /// public virtual GameObject CreatItem() @@ -47,7 +46,7 @@ namespace XericUI.InfiniteVessel } /// - /// »ñȡ¶ÔÏ󣬲¢»ñȡ¹ÜÀíÆ÷ + /// 获取对象,并获取管理器 /// /// /// @@ -58,7 +57,7 @@ namespace XericUI.InfiniteVessel } /// - /// ÊͷŶÔÏó + /// 释放对象 /// /// public virtual void ReleaseItem(GameObject target) @@ -67,7 +66,7 @@ namespace XericUI.InfiniteVessel } /// - /// Ïú»ٶÔÏó + /// 销毁对象 /// /// public virtual void DestroyItem(GameObject target) diff --git a/Runtime/OverrideUI/XericImage.cs b/Runtime/OverrideUI/XericImage.cs index eddd773..08336df 100644 --- a/Runtime/OverrideUI/XericImage.cs +++ b/Runtime/OverrideUI/XericImage.cs @@ -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 /// 图像组件 /// /// - /// 这个组件主要为了提供graphic层的事件,用于应对部分无法重写的ui组件事件 + /// 这个组件主要为了提供graphic层的事件,用于应对部分无法重写的ui组件事件。 + /// 另外支持四顶点变形(错切 / 倾斜 / 平行四边形 / 伪投影): + /// 顶点偏移存在归一化矩形空间里,RectTransform 尺寸变化时变形等比跟随。 /// - [AddComponentMenu("Xeric UI Vessel/UI/Image", 50)] + [AddComponentMenu(XericRegistrationPaths.UI + "/Image", 50)] public class XericImage : Image { /// @@ -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; + + /// 是否处于变形状态(四角偏移全为零即未变形) + public bool HasDeform => + m_CornerOffsetBL != Vector2.zero || + m_CornerOffsetTL != Vector2.zero || + m_CornerOffsetTR != Vector2.zero || + m_CornerOffsetBR != Vector2.zero; + + /// 归一化矩形空间下的恒等角点 + 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"); + } + } + + /// 取某个角点在归一化矩形空间下的坐标(恒等 + 偏移) + public Vector2 GetCorner(int index) => IdentityCorner(index) + GetCornerOffset(index); + + /// 取某个角点在归一化矩形空间下的偏移量 + 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"); + } + } + + /// 按归一化矩形空间下的坐标设置单个角点 + public void SetCorner(int index, Vector2 normalizedCorner) + { + Vector2[] corners = GetCorners(); + corners[index] = normalizedCorner; + ApplyCorners(corners[0], corners[1], corners[2], corners[3]); + } + + /// 一次性设置四个角点(归一化矩形空间) + public void SetCorners(Vector2 cornerBL, Vector2 cornerTL, Vector2 cornerTR, Vector2 cornerBR) + => ApplyCorners(cornerBL, cornerTL, cornerTR, cornerBR); + + /// 取四个角点(归一化矩形空间),顺序 左下 / 左上 / 右上 / 右下 + public Vector2[] GetCorners() => new[] + { + GetCorner(0), + GetCorner(1), + GetCorner(2), + GetCorner(3), + }; + + /// + /// 用 2D 仿射矩阵变形(只取矩阵的 XY 子块),结果一定是平行四边形。 + /// + public void ApplyAffine(Matrix4x4 matrix) + { + Vector2[] c = XericQuadDeformMath.AffineCorners(matrix); + ApplyCorners(c[0], c[1], c[2], c[3]); + } + + /// + /// 用完整 4x4 矩阵变形并做透视除(伪投影):可得到任意四边形。 + /// + public void ApplyProjected(Matrix4x4 matrix) + { + Vector2[] c = XericQuadDeformMath.ProjectedCorners(matrix); + ApplyCorners(c[0], c[1], c[2], c[3]); + } + + /// + /// 用虚拟平面法线定义这个面,内部换算成拟合该平面的仿射(倾斜 = 纵向 cos 压缩)。 + /// + /// 虚拟法线,UI 平面默认朝向为 (0,0,-1) + /// 绕法线自身的旋转角(度) + public void ApplyPlane(Vector3 normal, float rollDegrees = 0f) + { + Vector2[] c = XericQuadDeformMath.PlaneCorners(normal, rollDegrees); + ApplyCorners(c[0], c[1], c[2], c[3]); + } + + /// 清除变形,恢复未变形的矩形 + public void ResetDeform() + { + m_CornerOffsetBL = Vector2.zero; + m_CornerOffsetTL = Vector2.zero; + m_CornerOffsetTR = Vector2.zero; + m_CornerOffsetBR = Vector2.zero; + SetVerticesDirty(); + } + + /// + /// 取当前变形的映射器。基准矩形与 Image 生成网格时用的那个同源 + /// ();变形数据退化时返回 false。 + /// + public bool TryGetDeformMapper(out XericQuadMapper mapper) + => XericQuadMapper.TryCreate(GetCorner(0), GetCorner(1), GetCorner(2), GetCorner(3), + GetPixelAdjustedRect(), out mapper); + + /// 归一化矩形空间 -> RectTransform 局部坐标 + public Vector2 NormalizedToLocal(Vector2 normalized) + => XericQuadDeformMath.NormalizedToLocal(normalized, GetPixelAdjustedRect()); + + /// RectTransform 局部坐标 -> 归一化矩形空间 + public Vector2 LocalToNormalized(Vector2 local) + { + Rect rect = GetPixelAdjustedRect(); + if (rect.width <= 0f || rect.height <= 0f) + return Vector2.zero; + return XericQuadDeformMath.LocalToNormalized(local, rect); + } + + /// 取某个角点的局部坐标(场景编辑手柄与网格生成共用同一套换算) + 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( 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( o => diff --git a/Runtime/OverrideUI/XericImageDeform.cs b/Runtime/OverrideUI/XericImageDeform.cs new file mode 100644 index 0000000..d0b9592 --- /dev/null +++ b/Runtime/OverrideUI/XericImageDeform.cs @@ -0,0 +1,312 @@ +using UnityEngine; + +namespace XericUI.OverrideUI +{ + /// + /// 单位正方形 [0,1]^2 到任意四边形的投影映射(单应)。 + /// 平行四边形自动退化为仿射(分母恒为 1);自交或零面积的退化四边形判定为无效。 + /// + /// + /// 顶点约定与 的顶点顺序一致: + /// (0,0)=左下 BL,(1,0)=右下 BR,(1,1)=右上 TR,(0,1)=左上 TL。 + /// 坐标是归一化矩形空间下的坐标,乘以矩形尺寸即得 RectTransform 局部坐标。 + /// + 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; + + /// + /// 由四边形的四个角点构造映射。 + /// + /// 单位坐标 (0,0) 对应的角点 + /// 单位坐标 (1,0) 对应的角点 + /// 单位坐标 (1,1) 对应的角点 + /// 单位坐标 (0,1) 对应的角点 + /// 构造结果;四点为退化四边形时 IsValid 为 false + 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; + } + + /// 把单位正方形内的坐标映射到四边形上(需 IsValid)。 + 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); + } + + /// 求逆映射:四边形上的坐标映射回单位正方形。 + 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; + } + } + + /// + /// 变形映射 + 它所属的矩形,合起来才够把局部坐标映射到局部坐标。 + /// + /// + /// 角点活在归一化矩形空间,而网格顶点活在 RectTransform 局部空间(两者差一次 + /// 矩形偏移与尺寸的换算)。这次换乘必须只有一份实现:网格生成、场景线框、离线自测 + /// 都走这里,否则很容易漏掉某一次换算 —— 漏了就会写出一堆 0..1 的顶点, + /// 在像素空间里塌成不到 1 像素的一团。 + /// + public struct XericQuadMapper + { + private XericQuadProjection m_Projection; + private Rect m_Rect; + private bool m_Valid; + + public bool IsValid => m_Valid; + + /// + /// 角点按 左下 / 左上 / 右上 / 右下 给(与 UnityEngine.UI.Image 的顶点顺序一致)。 + /// + 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); + + /// 归一化矩形空间 -> 局部坐标,并经过变形投射。 + public Vector2 MapNormalized(Vector2 normalized) + => NormalizedToLocal(m_Projection.Transform(normalized.x, normalized.y)); + + /// 局部坐标 -> 局部坐标:网格顶点就是这么算的。 + public Vector2 MapLocal(Vector2 local) + { + Vector2 normalized = LocalToNormalized(local); + return NormalizedToLocal(m_Projection.Transform(normalized.x, normalized.y)); + } + } + + /// + /// 四边形变形的生成器:把矩阵 / 虚拟法线换算成归一化矩形空间下的四个角点。 + /// 角点数组顺序统一为 [0]=左下BL [1]=左上TL [2]=右上TR [3]=右下BR。 + /// + public static class XericQuadDeformMath + { + /// 归一化矩形空间 -> 局部坐标(矩形自身的换算,与变形是否有效无关)。 + public static Vector2 NormalizedToLocal(Vector2 normalized, Rect rect) => new Vector2( + rect.xMin + rect.width * normalized.x, + rect.yMin + rect.height * normalized.y); + + /// 局部坐标 -> 归一化矩形空间(矩形自身的换算,与变形是否有效无关)。 + public static Vector2 LocalToNormalized(Vector2 local, Rect rect) => new Vector2( + (local.x - rect.xMin) / rect.width, + (local.y - rect.yMin) / rect.height); + + /// 恒等角点(不变形) + public static Vector2[] IdentityCorners() => new[] + { + new Vector2(0f, 0f), + new Vector2(0f, 1f), + new Vector2(1f, 1f), + new Vector2(1f, 0f), + }; + + /// + /// 2D 仿射:只取矩阵的 XY 子块(平移取第三列),结果必为平行四边形。 + /// + 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; + } + + /// + /// 伪投影:用完整 4x4 变换四个角点后做 w 透视除。 + /// 与 的区别在于 w 不恒为 1, + /// 因此可以吃到"平面在 3D 内倾斜后再投影"的透视收敛。 + /// + 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; + } + + /// + /// 虚拟平面法线:把 UI 平面(默认法线 (0,0,-1))旋到给定法线后做正交投影, + /// 得到一个拟合该平面的仿射(倾斜会带来 cos 的纵向压缩)。 + /// + /// 虚拟法线,零向量按默认朝向处理 + /// 绕法线自身的旋转角(度) + 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); + } + } +} \ No newline at end of file diff --git a/Runtime/OverrideUI/XericImageDeform.cs.meta b/Runtime/OverrideUI/XericImageDeform.cs.meta new file mode 100644 index 0000000..10c40c4 --- /dev/null +++ b/Runtime/OverrideUI/XericImageDeform.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 704b3d7a7481414aacc86e7a83ebc0b3 +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: \ No newline at end of file