473 lines
15 KiB
C#
473 lines
15 KiB
C#
using System;
|
||
using System.Collections.Generic;
|
||
using UnityEngine;
|
||
|
||
using XericLibrary.Runtime.XericComponent;
|
||
|
||
#if UNITY_EDITOR
|
||
using UnityEditor;
|
||
#endif
|
||
|
||
namespace XericLibrary.Runtime.UIGraph
|
||
{
|
||
/// <summary>
|
||
/// 由界面样条（XericRectSplinePath）驱动的曲线绘制组件。
|
||
/// <code>
|
||
/// 一条样条上可以同时铺多条"面片"，每条由一对 (头部, 尾部) 进度值决定覆盖范围，
|
||
/// 于是 {1,0} 是铺满整条的底轨，{0.6f,0} 就是填到 60% 的进度条本体。
|
||
/// 进度默认经样条烘焙后的弧长重映射校正，画面上的推进长度才和进度值成正比；
|
||
/// 面片上的 uv0.y 被重映射成整条面片的 0→1，材质按 UV 就能做流动/遮罩类效果。
|
||
/// </code>
|
||
/// </summary>
|
||
[AddComponentMenu("Xeric Library/UI/UISplineCurveRenderer", 17)]
|
||
public class UISplineCurveRenderer : CurveCacheRendererBase
|
||
{
|
||
#region 字段属性
|
||
|
||
/// <summary>驱动本曲线的界面样条</summary>
|
||
public XericRectSplinePath splinePath;
|
||
|
||
/// <summary>
|
||
/// 面片对：偶数下标=头部、奇数下标=尾部，取值 [0,1]。
|
||
/// 例：{1,0} 一条铺满；{1,0, 0.6f,0} 两条＝底轨 + 60% 填充。
|
||
/// </summary>
|
||
public float[] headTailPairs = { 1f, 0f };
|
||
|
||
/// <summary>可空；与面片同序时逐条叠乘到样条颜色上（底轨压暗、填充提亮）</summary>
|
||
public Color32[] ribbonTints;
|
||
|
||
/// <summary>进度值的含义：直接按参数，还是先经烘焙做弧长校正</summary>
|
||
public SplineProgressMapping progressMapping = SplineProgressMapping.BakedDistance;
|
||
|
||
/// <summary>烘焙采样数，越大校正越细；同时压住库侧 1/(N+1) 的系统偏差</summary>
|
||
[Range(8, 4096)]
|
||
public int bakeSubdivide = 256;
|
||
|
||
/// <summary>
|
||
/// 什么时候做弧长烘焙。默认 OnEditEnd：几何停止变化后补烘一次。
|
||
/// 烘焙是 O(subdivide) 的采样，放在每帧会把编辑器拖到卡。
|
||
/// </summary>
|
||
public SplineBakeTrigger bakeTrigger = SplineBakeTrigger.OnEditEnd;
|
||
|
||
/// <summary>已经烘过几次（排查用：编辑器里拖动一整轮应该只加 1）</summary>
|
||
public int BakeRunCount => m_BakeRunCount;
|
||
|
||
/// <summary>面片上 uv0.y 代表条内进度还是全样条进度</summary>
|
||
public SplineUvProgressSpace uvProgressSpace = SplineUvProgressSpace.RibbonLocal;
|
||
|
||
/// <summary>每条面片至少切成几块，决定 uv 与视觉距离对齐的精度</summary>
|
||
[Range(1, 64)]
|
||
public int chunksPerRibbon = 8;
|
||
|
||
/// <summary>基准带宽（样条所在矩形的局部像素）</summary>
|
||
[Min(0.01f)]
|
||
public float curveWidth = 10f;
|
||
|
||
/// <summary>带宽来源：常量，还是乘上样条的缩放渐层 Y</summary>
|
||
public SplineWidthSource widthSource = SplineWidthSource.ScaleGradientY;
|
||
|
||
/// <summary>单段贝塞尔的细分段数</summary>
|
||
[Range(2, 128)]
|
||
public int tessellationSegments = 32;
|
||
|
||
/// <summary>样条颜色渐层全透明时的兜底颜色</summary>
|
||
public Color fallbackColor = Color.white;
|
||
|
||
/// <summary>
|
||
/// 推给材质 _MainTex 的贴图。
|
||
/// Canvas 是用 MaterialPropertyBlock 把 Graphic.mainTexture 顶到 _MainTex 上的，
|
||
/// 所以必须走这个口子交出去；只改 material 的贴图会被默认白图覆盖掉。
|
||
/// </summary>
|
||
public Texture progressTexture;
|
||
|
||
/// <summary>SetProgress 作用在哪条面片的头部；-1 表示不指定</summary>
|
||
public int fillRibbonIndex = 1;
|
||
|
||
/// <summary>每帧跟随样条变化重建（关掉后只能靠 RebuildCurve 手动触发）</summary>
|
||
public bool followSplineChanges = true;
|
||
|
||
/// <summary>与曲线缓存同序的 uv 区间，x=起点 y=终点</summary>
|
||
private readonly List<Vector2> m_PieceUv = new List<Vector2>();
|
||
|
||
private bool m_NeedUvPatch;
|
||
private int m_LastBakeSignature = int.MinValue;
|
||
private bool m_BakePending;
|
||
private int m_BakeRunCount;
|
||
|
||
#endregion
|
||
|
||
#region 生命周期
|
||
|
||
public override Texture mainTexture
|
||
=> progressTexture != null ? progressTexture : base.mainTexture;
|
||
|
||
protected override void OnEnable()
|
||
{
|
||
base.OnEnable();
|
||
RebuildCurve();
|
||
}
|
||
|
||
#if UNITY_EDITOR
|
||
protected override void OnValidate()
|
||
{
|
||
base.OnValidate();
|
||
if (curveWidth < 0.01f) curveWidth = 0.01f;
|
||
if (tessellationSegments < 2) tessellationSegments = 2;
|
||
if (followSplineChanges && isActiveAndEnabled)
|
||
{
|
||
EditorApplication.delayCall += () =>
|
||
{
|
||
if (this != null && isActiveAndEnabled)
|
||
RebuildCurve();
|
||
};
|
||
}
|
||
}
|
||
#endif
|
||
|
||
protected override void LateUpdate()
|
||
{
|
||
if (followSplineChanges)
|
||
RebuildCurve();
|
||
|
||
base.LateUpdate();
|
||
|
||
// 只能在"刚刚重建过缓存"之后改写一次：
|
||
// 改写后 uv0.y 就不再是生成器写的段内 t，重复改写会把映射套两遍
|
||
if (m_NeedUvPatch)
|
||
{
|
||
m_NeedUvPatch = false;
|
||
ApplyRibbonUv();
|
||
}
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region API
|
||
|
||
/// <summary>
|
||
/// 把指定面片的头部推到 value（进度条前进就调这个）
|
||
/// </summary>
|
||
public void SetProgress(float value)
|
||
{
|
||
int index = fillRibbonIndex >= 0 ? fillRibbonIndex : 0;
|
||
if (headTailPairs == null || headTailPairs.Length < (index + 1) * 2)
|
||
return;
|
||
|
||
headTailPairs[index * 2] = Mathf.Clamp01(value);
|
||
RebuildCurve();
|
||
}
|
||
|
||
/// <summary>
|
||
/// 读取指定面片的头部进度
|
||
/// </summary>
|
||
public float GetProgress()
|
||
{
|
||
int index = fillRibbonIndex >= 0 ? fillRibbonIndex : 0;
|
||
if (headTailPairs == null || headTailPairs.Length < (index + 1) * 2)
|
||
return 0f;
|
||
return headTailPairs[index * 2];
|
||
}
|
||
|
||
/// <summary>
|
||
/// 按当前样条与面片配置重建曲线
|
||
/// </summary>
|
||
public void RebuildCurve()
|
||
{
|
||
ClearAll();
|
||
m_PieceUv.Clear();
|
||
m_NeedUvPatch = false;
|
||
|
||
if (splinePath == null || rectTransform == null)
|
||
return;
|
||
|
||
var spline = splinePath.xericSpline;
|
||
if (spline == null || spline.Count < 2)
|
||
return;
|
||
|
||
// 锚点→世界的换算依赖矩形角点
|
||
splinePath.UpdateRectDepend();
|
||
var rect = rectTransform.rect;
|
||
if (Mathf.Abs(rect.width) < 1e-6f || Mathf.Abs(rect.height) < 1e-6f)
|
||
return;
|
||
|
||
int pointCount = spline.Count;
|
||
var anchors = new Vector2[pointCount];
|
||
var outHandles = new Vector2[pointCount];
|
||
var inHandles = new Vector2[pointCount];
|
||
var colors = new Color[pointCount];
|
||
var widths = new float[pointCount];
|
||
|
||
int signature = pointCount;
|
||
for (int i = 0; i < pointCount; i++)
|
||
{
|
||
anchors[i] = (Vector2)rectTransform.InverseTransformPoint(splinePath.GetPointPosition(i));
|
||
outHandles[i] = (Vector2)rectTransform.InverseTransformPoint(splinePath.GetEndHandlePosition(i));
|
||
inHandles[i] = (Vector2)rectTransform.InverseTransformPoint(splinePath.GetStartHandlePosition(i));
|
||
colors[i] = ColorAt(spline, i);
|
||
widths[i] = WidthAt(spline, i);
|
||
|
||
unchecked
|
||
{
|
||
signature = signature * 31 + anchors[i].GetHashCode()
|
||
+ outHandles[i].GetHashCode() * 7 + inHandles[i].GetHashCode() * 13;
|
||
}
|
||
}
|
||
// 非均匀缩放矩形会改变世界空间弧长的比例，签名要把矩形尺寸也算进去
|
||
unchecked
|
||
{
|
||
signature = signature * 31 + rect.width.GetHashCode() + rect.height.GetHashCode() * 3;
|
||
}
|
||
|
||
var request = new SplineRibbonBuilder.Request
|
||
{
|
||
anchors = anchors,
|
||
outHandles = outHandles,
|
||
inHandles = inHandles,
|
||
pointColors = colors,
|
||
pointWidths = widths,
|
||
pointCount = pointCount,
|
||
segmentCount = spline.useablePointCount,
|
||
curveLoop = spline.CurveLoop,
|
||
headTailPairs = headTailPairs,
|
||
ribbonTints = ribbonTints,
|
||
uvSpace = uvProgressSpace,
|
||
chunksPerRibbon = chunksPerRibbon,
|
||
progressToParametric = BuildMapping(spline, signature),
|
||
};
|
||
|
||
var pieces = SplineRibbonBuilder.Build(request);
|
||
if (pieces.Count == 0)
|
||
return;
|
||
|
||
var ctrl = new Vector2[4];
|
||
var pieceWidths = new float[4];
|
||
|
||
foreach (var piece in pieces)
|
||
{
|
||
ctrl[0] = piece.c0; ctrl[1] = piece.c1; ctrl[2] = piece.c2; ctrl[3] = piece.c3;
|
||
pieceWidths[0] = piece.w0; pieceWidths[1] = piece.w1;
|
||
pieceWidths[2] = piece.w2; pieceWidths[3] = piece.w3;
|
||
|
||
var entry = new CurveCacheEntry
|
||
{
|
||
startColor = piece.startColor,
|
||
endColor = piece.endColor,
|
||
tessellationSegments = PieceTessellation(piece),
|
||
};
|
||
|
||
AddCurve(entry, (Vector2[])ctrl.Clone(), (float[])pieceWidths.Clone());
|
||
m_PieceUv.Add(new Vector2(piece.uvYStart, piece.uvYEnd));
|
||
}
|
||
|
||
m_NeedUvPatch = m_PieceUv.Count > 0;
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region 取数
|
||
|
||
/// <summary>
|
||
/// 造出"进度 → 参数 t"的映射。校正走样条烘焙的弧长重映射，
|
||
/// 库侧要求先烘焙且长度不足时会抛，所以这里自己把关并回落。
|
||
/// </summary>
|
||
private Func<float, float> BuildMapping(XericRectSpline spline, int signature)
|
||
{
|
||
if (progressMapping != SplineProgressMapping.BakedDistance)
|
||
return ParametricIdentity;
|
||
|
||
if (!EnsureBaked(spline, signature))
|
||
return ParametricIdentity;
|
||
|
||
return ParametricFromBakedDistance;
|
||
}
|
||
|
||
private float ParametricIdentity(float progress) => progress;
|
||
|
||
/// <summary>
|
||
/// 进度→参数 t。两端是边界真值：进度 0 就是曲线起点、1 就是终点，
|
||
/// 所以先把两端钉死再走重映射 —— 库里的弧长重映射原本按"采样点数"而不是"段数"
|
||
/// 做分母，进度 1 会落在 (N-1)/N，{1,0} 的面片就永远短一小截贴不到末尾。
|
||
/// 库侧已经修了分母，这里钉端点既是兜底也让旧 DLL 下也能立刻闭合。
|
||
/// </summary>
|
||
private float ParametricFromBakedDistance(float progress)
|
||
{
|
||
if (progress <= 0f) return 0f;
|
||
if (progress >= 1f) return 1f;
|
||
return Mathf.Clamp01(splinePath.RemappingTimeValue(progress));
|
||
}
|
||
|
||
/// <summary>
|
||
/// 按 <see cref="bakeTrigger"/> 决定这一趟烘不烘，返回 false 表示当前用不了弧长校正。
|
||
/// <code>
|
||
/// 烘焙是 O(subdivide) 的采样：以前几何签名一变就烘，编辑器里拖动控制点等于每帧烘一次。
|
||
/// OnEditEnd 的做法是"几何正在线上变"时先挂起、继续用上一次那份烘焙数据，
|
||
/// 等下一趟签名不再变化（编辑停了）才补烘那一次。
|
||
/// </code>
|
||
/// </summary>
|
||
private bool EnsureBaked(XericRectSpline spline, int signature)
|
||
{
|
||
int target = Mathf.Max(bakeSubdivide, spline.Count);
|
||
bool geometryChanged = signature != m_LastBakeSignature;
|
||
m_LastBakeSignature = signature;
|
||
|
||
switch (bakeTrigger)
|
||
{
|
||
case SplineBakeTrigger.Manual:
|
||
// 一次都不自动烘，等 BakeNow
|
||
return HasUsableBake(spline, target);
|
||
|
||
case SplineBakeTrigger.EveryRebuild:
|
||
if (!geometryChanged && HasUsableBake(spline, target))
|
||
return true;
|
||
return RunBake(spline, target);
|
||
|
||
default:
|
||
if (geometryChanged)
|
||
{
|
||
// 几何正在线上变：这一趟不烘，也**不用**上一份烘焙数据。
|
||
// 结构大改（清点重铺、切循环）后那份表对应的已经不是这条曲线了，
|
||
// 拿它做校正会把面片排到错处 —— 宁可这一趟退回参数映射，
|
||
// 等编辑停下来的下一趟烘完再恢复校正。
|
||
m_BakePending = true;
|
||
return false;
|
||
}
|
||
if (!m_BakePending)
|
||
return HasUsableBake(spline, target);
|
||
|
||
m_BakePending = false;
|
||
return RunBake(spline, target);
|
||
}
|
||
}
|
||
|
||
/// <summary>烘焙数据存在且长度够用（旧数据只要长度够就继续用，别再烘一次）</summary>
|
||
private static bool HasUsableBake(XericRectSpline spline, int target)
|
||
=> spline.BakeCount >= target;
|
||
|
||
private bool RunBake(XericRectSpline spline, int target)
|
||
{
|
||
splinePath.BakePoint(target);
|
||
m_BakeRunCount++;
|
||
return spline.BakeCount >= target;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 手动烘一次（bakeTrigger 为 Manual 时用这个，或改完曲线想立刻精确时按）。
|
||
/// 烘完直接重建，按下就能看见贴合结果。
|
||
/// </summary>
|
||
public void BakeNow()
|
||
{
|
||
if (splinePath == null || splinePath.xericSpline == null)
|
||
return;
|
||
|
||
var spline = splinePath.xericSpline;
|
||
RunBake(spline, Mathf.Max(bakeSubdivide, spline.Count));
|
||
m_BakePending = false;
|
||
RebuildCurve();
|
||
}
|
||
|
||
private Color ColorAt(XericRectSpline spline, int index)
|
||
{
|
||
var gradient = spline.ColorGradient;
|
||
if (gradient == null || index < 0 || index >= gradient.Count)
|
||
return fallbackColor;
|
||
|
||
var color = gradient[index];
|
||
return color.a <= 0f ? fallbackColor : color;
|
||
}
|
||
|
||
private float WidthAt(XericRectSpline spline, int index)
|
||
{
|
||
switch (widthSource)
|
||
{
|
||
case SplineWidthSource.ScaleGradientY:
|
||
return curveWidth * Mathf.Abs(GradientAt(spline.ScaleGradient, index, Vector3.one).y);
|
||
case SplineWidthSource.FloatGradient:
|
||
// 额外参数本来就是"每点多大"的语义时用它最直观；
|
||
// 注意它默认全 0，不填就什么都画不出来
|
||
return curveWidth * Mathf.Max(0f, GradientAt(spline.FloatGradient, index, 1f));
|
||
default:
|
||
return curveWidth;
|
||
}
|
||
}
|
||
|
||
/// <summary>渐层可能比点数短（在 Inspector 里直接改 ControlPoint 长度就会这样），一律夹紧</summary>
|
||
private static T GradientAt<T>(SplineGradientBase<T> gradient, int index, T fallback)
|
||
{
|
||
if (gradient == null || index < 0 || index >= gradient.Count)
|
||
return fallback;
|
||
return gradient[index];
|
||
}
|
||
|
||
private int PieceTessellation(RibbonPiece piece)
|
||
{
|
||
int tess = Mathf.RoundToInt(tessellationSegments * Mathf.Clamp01(piece.segmentFraction));
|
||
return Mathf.Clamp(tess, 2, 512);
|
||
}
|
||
|
||
#endregion
|
||
|
||
#region uv 重写
|
||
|
||
/// <summary>
|
||
/// 把生成器写在每个小块里的"段内 t"重映射成整条面片的 0→1。
|
||
/// 默认材质只用到 uv0.x（边缘羽化），uv0.y 留给换上去的材质消费。
|
||
/// </summary>
|
||
private void ApplyRibbonUv()
|
||
{
|
||
if (m_PieceUv.Count == 0)
|
||
return;
|
||
|
||
for (int i = 0; i < m_Curves.Count && i < m_PieceUv.Count; i++)
|
||
{
|
||
var curve = m_Curves[i];
|
||
var range = m_PieceUv[i];
|
||
int end = curve.startVertexIndex + curve.vertexCount;
|
||
if (end > m_MeshVertexCache.Count)
|
||
end = m_MeshVertexCache.Count;
|
||
|
||
for (int v = curve.startVertexIndex; v < end; v++)
|
||
{
|
||
var vert = m_MeshVertexCache[v];
|
||
vert.uv0.y = Mathf.LerpUnclamped(range.x, range.y, vert.uv0.y);
|
||
m_MeshVertexCache[v] = vert;
|
||
}
|
||
}
|
||
|
||
SetVerticesDirty();
|
||
}
|
||
|
||
#endregion
|
||
}
|
||
|
||
/// <summary>进度值如何换算成曲线参数</summary>
|
||
public enum SplineProgressMapping
|
||
{
|
||
/// <summary>进度直接当参数 t：段与段的视觉长度不等</summary>
|
||
Parametric,
|
||
/// <summary>进度按烘焙后的弧长重映射：画面上推进的长度和进度成正比</summary>
|
||
BakedDistance,
|
||
}
|
||
|
||
/// <summary>弧长烘焙的触发时机（校正的数据源就是这份烘焙数据）</summary>
|
||
public enum SplineBakeTrigger
|
||
{
|
||
/// <summary>从不自动烘，只认 BakeNow / Inspector 上的烘焙按钮</summary>
|
||
Manual,
|
||
/// <summary>几何停止变化后补烘一次：编辑器里拖动控制点不会逐帧烘</summary>
|
||
OnEditEnd,
|
||
/// <summary>几何一变就烘（每帧一变烘一次，贵；只在需要立刻精确时用）</summary>
|
||
EveryRebuild,
|
||
}
|
||
|
||
/// <summary>带宽来源</summary>
|
||
public enum SplineWidthSource
|
||
{
|
||
/// <summary>恒用 curveWidth</summary>
|
||
Constant,
|
||
/// <summary>curveWidth × 该点缩放渐层的 Y（渐层默认是 1，不填也等价于常量）</summary>
|
||
ScaleGradientY,
|
||
/// <summary>curveWidth × 该点的额外参数。默认全 0，不填什么都画不出来</summary>
|
||
FloatGradient,
|
||
}
|
||
}
|