XChart P18(上半):箭头杆沿杆渐变——两端各自的颜色真的分得开了

规范 §25.2/§25.9 里"颜色随记录自带 ⇒ 一支箭头的起点色与终点色可以不同"这一条落到渲染:

- `XChartMeshFillRenderer` 多一档 **线性渐变**(`AddFaceLinear`):`00/10` 一对边一色、`01/11` 一对边一色,
  渐变方向垂直于这两条边。与既有的"四角 + 中心"径向渐变是两种形状,靠新的 `XChartFaceFillKind`
  (Flat / Radial / Linear)区分;`AddFace` 的老语义(两色不同=径向)保持不变,
  圆柱与立方体网格那些调用点一个都不用改。
- 每面花几个顶点收成**单一定义** `XChartMeshBudget.VerticesPerFace(kind)`:
  预算侧与写顶点侧必须同源,否则会出现"预算以为 4 个、实际发 5 个",恰好卡线时撞 65535 上限。
- 箭头:杆用线性渐变(起点色 → 终点色),头用终点色单色;退化小方块用起点色。
  杆的四角绕序(a/d 在起点一侧、b/c 在末端一侧)现在**有判据钉着**——配错的话画面上是
  "杆的两侧各一色"而不是"沿杆渐变",这种错最容易看漏。
- 顺带一条 C# 反直觉:嵌套类型的 private 字段**外层类也读不到**(`CS0122`),
  `ArrowFace.Linear` 因此必须 public(本项目踩过同族的坑)。

判据:编译门三臂 + 3 对照绿;探针 **441** 项 0 失败(新增杆的四角配对、以及"只有径向多花一个顶点");
`p4_control` **59/59** 支臂各红在点名断言上(新增两支:把起点一侧的角取成末端、所有面都按平坦算顶点)。
曲线渲染器(连续绘制走 `UICurveRenderer` + 矢量标签 + 箭头位置可调)是 P18 的下一半。
This commit is contained in:
2026-10-26 07:23:23 +08:00
parent 0d9a3d7417
commit 5cdcbbc635
2 changed files with 82 additions and 7 deletions
+16 -3
View File
@@ -85,7 +85,13 @@ namespace XericUI.XChart.Mesh
public Vector2 C; public Vector2 C;
public Vector2 D; public Vector2 D;
public float Depth; public float Depth;
/// <summary>00/10 这一对边的颜色(线性时=起点色)</summary>
public Color Color; public Color Color;
/// <summary>01/11 这一对边的颜色(只有线性用;=终点色)</summary>
public Color ColorTo;
/// <summary>true=沿杆渐变(杆),false=单色(头、退化点)。
/// 必须 public:嵌套类型的 private 成员**外层类也读不到**(C# 的这条反直觉,本项目踩过)</summary>
public bool Linear;
} }
private static readonly Comparison<ArrowFace> s_FarToNear = private static readonly Comparison<ArrowFace> s_FarToNear =
@@ -142,7 +148,10 @@ namespace XericUI.XChart.Mesh
for (int i = 0; i < m_Faces.Count; i++) for (int i = 0; i < m_Faces.Count; i++)
{ {
ArrowFace face = m_Faces[i]; ArrowFace face = m_Faces[i];
FillRenderer.AddFace(face.A, face.B, face.C, face.D, face.Color, face.Color); if (face.Linear)
FillRenderer.AddFaceLinear(face.A, face.B, face.C, face.D, face.Color, face.ColorTo);
else
FillRenderer.AddFace(face.A, face.B, face.C, face.D, face.Color, face.Color);
} }
FillRenderer.Apply(); FillRenderer.Apply();
} }
@@ -236,15 +245,19 @@ namespace XericUI.XChart.Mesh
return true; return true;
} }
// 杆:沿杆渐变(起点一侧 ← 终点一侧)。BuildShaft 的绕序把 a/d 放在起点、b/c 放在末端,
// 而 AddFaceLinear 取的是"00/10 一色、01/11 一色"——这条配对由探针钉着,配错会横着染到杆宽上
m_Faces.Add(new ArrowFace m_Faces.Add(new ArrowFace
{ {
A = shaftA, B = shaftB, C = shaftC, D = shaftD, Depth = depth, Color = startColor, A = shaftA, B = shaftB, C = shaftC, D = shaftD,
Depth = depth, Color = startColor, ColorTo = endColor, Linear = true,
}); });
if (!withHead) return true; if (!withHead) return true;
m_Faces.Add(new ArrowFace m_Faces.Add(new ArrowFace
{ {
A = headA, B = headB, C = headC, D = headD, Depth = depth, Color = endColor, A = headA, B = headB, C = headC, D = headD,
Depth = depth, Color = endColor,
}); });
return true; return true;
} }
+66 -4
View File
@@ -6,6 +6,23 @@ using XericUI.Core;
namespace XericUI.XChart.Mesh namespace XericUI.XChart.Mesh
{ {
/// <summary>
/// 一个填充四边形怎么上色(<b>纯枚举</b>,住在预算算式旁边是为了让"几顶点"这条判据离线可验)。
///
/// <list type="bullet">
/// <item><see cref="Flat"/>:四角同色(4 顶点 2 三角)。</item>
/// <item><see cref="Radial"/>:四角一色 + 中心一色(5 顶点 4 三角,做浅淡的立体感)。</item>
/// <item><see cref="Linear"/>:沿 00/10 ↔ 01/11 这一对边线性渐变(4 顶点 2 三角)——
/// 箭头杆"起点色 → 终点色"走的是这一档。</item>
/// </list>
/// </summary>
public enum XChartFaceFillKind
{
Flat = 0,
Radial = 1,
Linear = 2,
}
/// <summary> /// <summary>
/// 顶点预算分块(纯算,离线可验)。 /// 顶点预算分块(纯算,离线可验)。
/// ///
@@ -68,6 +85,17 @@ namespace XericUI.XChart.Mesh
} }
return max; return max;
} }
/// <summary>
/// 一块面要几个顶点:只有<b>径向渐变</b>要多一个中心顶点(5 个、4 三角),
/// 平坦与线性渐变都是 4 顶点 2 三角。
///
/// <para>分块预算吃的是这个数(65535 是<b>每个 Graphic 各自</b>的上限),所以它必须是单一定义:
/// 渲染侧按它写顶点、预算侧按它算块,两处各写一套就会出现"预算以为 4 个、实际发 5 个"
/// ——那种分块会在恰好卡线时撞上限。</para>
/// </summary>
public static int VerticesPerFace(XChartFaceFillKind kind)
=> kind == XChartFaceFillKind.Radial ? 5 : 4;
} }
/// <summary> /// <summary>
@@ -90,6 +118,8 @@ namespace XericUI.XChart.Mesh
public Vector2 Corner10; public Vector2 Corner10;
public Color32 EdgeColor; public Color32 EdgeColor;
public Color32 CenterColor; public Color32 CenterColor;
/// <summary>怎么上色(平坦 / 径向 / 线性)。<see cref="XChartMeshBudget.VerticesPerFace"/> 吃它</summary>
public XChartFaceFillKind Kind;
} }
/// <summary>一块:只画 [Start, End) 之间的面。顶点数受预算限制,所以不会撞 65535 上限。</summary> /// <summary>一块:只画 [Start, End) 之间的面。顶点数受预算限制,所以不会撞 65535 上限。</summary>
@@ -138,6 +168,7 @@ namespace XericUI.XChart.Mesh
public void AddFace(Vector2 corner00, Vector2 corner01, Vector2 corner11, Vector2 corner10, public void AddFace(Vector2 corner00, Vector2 corner01, Vector2 corner11, Vector2 corner10,
Color edgeColor, Color centerColor) Color edgeColor, Color centerColor)
{ {
bool gradient = edgeColor != centerColor;
m_Faces.Add(new FaceQuad m_Faces.Add(new FaceQuad
{ {
Corner00 = corner00, Corner00 = corner00,
@@ -146,6 +177,31 @@ namespace XericUI.XChart.Mesh
Corner10 = corner10, Corner10 = corner10,
EdgeColor = edgeColor, EdgeColor = edgeColor,
CenterColor = centerColor, CenterColor = centerColor,
Kind = gradient ? XChartFaceFillKind.Radial : XChartFaceFillKind.Flat,
});
}
/// <summary>
/// 追加一个<b>线性渐变</b>的四边形:<c>corner00</c> 与 <c>corner10</c> 取
/// <paramref name="fromColor"/>,<c>corner01</c> 与 <c>corner11</c> 取 <paramref name="toColor"/>
/// ——也就是"一对边一色",渐变方向垂直于那两条边。
///
/// <para>箭头杆用的就是这一档:<see cref="XChartArrowGeometry.BuildShaft"/> 绕出来的四角里
/// <b>a/d 在起点一侧、b/c 在末端一侧</b>(这条配对由探针钉着,配错就会横着染到杆的宽度上,
/// 画面上看是"杆的两侧各一色"而不是"沿杆渐变")。顶点数与平坦一样(4 个、2 三角)。</para>
/// </summary>
public void AddFaceLinear(Vector2 corner00, Vector2 corner01, Vector2 corner11, Vector2 corner10,
Color fromColor, Color toColor)
{
m_Faces.Add(new FaceQuad
{
Corner00 = corner00,
Corner01 = corner01,
Corner11 = corner11,
Corner10 = corner10,
EdgeColor = fromColor,
CenterColor = toColor,
Kind = XChartFaceFillKind.Linear,
}); });
} }
@@ -161,7 +217,7 @@ namespace XericUI.XChart.Mesh
{ {
if (m_FaceVertexCounts.Length < m_Faces.Count) m_FaceVertexCounts = new int[m_Faces.Count]; if (m_FaceVertexCounts.Length < m_Faces.Count) m_FaceVertexCounts = new int[m_Faces.Count];
for (int i = 0; i < m_Faces.Count; i++) for (int i = 0; i < m_Faces.Count; i++)
m_FaceVertexCounts[i] = IsGradient(m_Faces[i]) ? 5 : 4; m_FaceVertexCounts[i] = XChartMeshBudget.VerticesPerFace(m_Faces[i].Kind);
if (m_ChunkStarts.Length < m_Faces.Count + 1) m_ChunkStarts = new int[m_Faces.Count + 1]; if (m_ChunkStarts.Length < m_Faces.Count + 1) m_ChunkStarts = new int[m_Faces.Count + 1];
int chunks = XChartMeshBudget.Split(m_FaceVertexCounts, m_Faces.Count, int chunks = XChartMeshBudget.Split(m_FaceVertexCounts, m_Faces.Count,
@@ -218,12 +274,18 @@ namespace XericUI.XChart.Mesh
FaceQuad face = m_Faces[i]; FaceQuad face = m_Faces[i];
int first = vh.currentVertCount; int first = vh.currentVertCount;
// 线性渐变:00/10 这一对取 from(EdgeColor),01/11 取 to(CenterColor);
// 平坦与径向都是四角同色(径向另加一个中心顶点)
bool linear = face.Kind == XChartFaceFillKind.Linear;
Color32 corner01Color = linear ? face.CenterColor : face.EdgeColor;
Color32 corner11Color = linear ? face.CenterColor : face.EdgeColor;
vh.AddVert(face.Corner00, face.EdgeColor, new Vector2(0f, 0f)); vh.AddVert(face.Corner00, face.EdgeColor, new Vector2(0f, 0f));
vh.AddVert(face.Corner01, face.EdgeColor, new Vector2(0f, 1f)); vh.AddVert(face.Corner01, corner01Color, new Vector2(0f, 1f));
vh.AddVert(face.Corner11, face.EdgeColor, new Vector2(1f, 1f)); vh.AddVert(face.Corner11, corner11Color, new Vector2(1f, 1f));
vh.AddVert(face.Corner10, face.EdgeColor, new Vector2(1f, 0f)); vh.AddVert(face.Corner10, face.EdgeColor, new Vector2(1f, 0f));
if (IsGradient(face)) if (face.Kind == XChartFaceFillKind.Radial)
{ {
Vector2 center = (face.Corner00 + face.Corner01 + face.Corner11 + face.Corner10) * 0.25f; Vector2 center = (face.Corner00 + face.Corner01 + face.Corner11 + face.Corner10) * 0.25f;
vh.AddVert(center, face.CenterColor, new Vector2(0.5f, 0.5f)); vh.AddVert(center, face.CenterColor, new Vector2(0.5f, 0.5f));