Files
XericUIActionVessel/Runtime/OverrideUI/XericImage.cs
T

235 lines
9.9 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using System;
using UnityEngine;
using UnityEngine.Serialization;
using UnityEngine.UI;
using XericUI.Helper;
using XericUI.Core;
namespace XericUI.OverrideUI
{
/// <summary>
/// 图像组件
/// </summary>
/// <remarks>
/// 这个组件主要为了提供graphic层的事件,用于应对部分无法重写的ui组件事件。
/// 另外支持四顶点变形(错切 / 倾斜 / 平行四边形 / 伪投影):
/// 顶点偏移存在归一化矩形空间里,RectTransform 尺寸变化时变形等比跟随。
/// </remarks>
[AddComponentMenu(XericRegistrationPaths.UI + "/Image", 50)]
public class XericImage : Image
{
/// <summary>
/// 针对toggle的回报(ison)
/// </summary>
internal Action<bool> OnToggleCrossFadeCall;
public override void CrossFadeColor(Color targetColor, float duration, bool ignoreTimeScale, bool useAlpha, bool useRGB)
{
base.CrossFadeColor(targetColor, duration, ignoreTimeScale, useAlpha, useRGB);
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(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Xeric Image", true)]
private static bool ValidateReplaceToXeric(UnityEditor.MenuCommand command)
=> command.context is Image and not XericImage;
[UnityEditor.MenuItem(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Xeric Image", false, 10)]
private static void ReplaceToXeric(UnityEditor.MenuCommand command)
=> command.ReplaceCommandContext<Image, XericImage, Sprite>(
o =>
o.sprite,
(t, d) =>
{
t.sprite = d;
});
[UnityEditor.MenuItem(XericRegistrationPaths.ContextPrefix + "Image/Replace To/Unity Image (Native)", true)]
private static bool ValidateReplaceToUnity(UnityEditor.MenuCommand command)
=> command.context is XericImage;
[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 =>
o.sprite,
(t, d) =>
{
t.sprite = d;
});
#endif
#endregion
}
}