增加了支持仿射变换的image组件

This commit is contained in:
2026-11-03 10:43:23 +08:00
parent 5a73718646
commit a311c417be
6 changed files with 1020 additions and 15 deletions
+181 -6
View File
@@ -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 =>