Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartMeshFillRenderer.cs
T
lrss3 5f4c1adf0a XChart P22:箭头的杆与头改走曲线渲染器的原生标记(规范 §29,他纠正"箭头为何用的是填充")
他这句纠正指向一件我一直不知道存在的东西:

> 我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置。

P18 那次我读不到库那个包(被拦过一次)就照自己代码里的调用点猜 API——`AddCurve`/`CurveCacheEntry` 猜对了,
于是**没有回头把那个包读一遍**,它旁边的 `ArrowHeadData` 我一直不知道,就用填充四边形自己拼了杆和头。
包其实就在工作区隔壁(com.lrss3.deconstruction),API 一直写在
Release/Runtime/Generation/Curve/CurveRenderDataTypes.cs。教训写进 §29.1:
**照着调用点猜出来能跑之后,要把那个来源补读一遍**——"我猜对了"证明不了"我看见全了"。

画法(一套几何,没有第二条路):
- 杆=一条**共线**三次贝塞尔(新纯算术 XChartArrowPathMath.Straight:内控制点落在 1/3、2/3),
  宽度=ShaftWidth,startColor/endColor 就是沿杆渐变——P18 我要的那个效果原来是条目的原生能力。
- 头=原生标记 ArrowHeadData:width=头长(沿切线)、height=头宽(垂直切线)、
  depthCompensation=+1 ⇒ **头尖对准那个数据点**。尺寸与位置先走我们自己的纯算术 XChartArrowMarker
  (离线探针引不到库那个 assembly,判据打在纯算术上,工具里只做对号入座)。
- 连续绘制的头挂在 ResolvePosition 算出的那一节上、progress=节内参数;**路径不再剪断**——
  "必须剪否则线穿箭头"是我上一版自己加的机制,Split 因此没有调用方,随四角绕序一起删。
- 零向量=一个 Circle 标记(开关关掉则整条不画,计入 skipped=)。
- **曲线渲染器不在位 ⇒ path=none、一支都不画**。不再有"退回填充画法"那第二条路:两套画法就是两套口径,
  而这次的 bug 恰恰长在第二条路上。

撤掉:XChartArrowGeometry(BuildShaft/BuildHead/TryBuild)整个类删、XChartArrowPathMath.Split 删。
留着:XChartMeshFillRenderer.AddFaceLinear 与 XChartFaceFillKind.Linear——那是填充渲染器自己的上色模式
(预算 VerticesPerFace(Linear)==4 与判据都在),只是箭头不再用它;别的元素要渐变填充时不必再写第二套。
配置里 HeadPosition 的 tooltip 一起改(原文写着"路径在这一处剪断",§29 之后不剪,留着就是面板说谎)。

**为什么这一改仍然不算把 bug 修好**(§29.3 写清):P13 遗留的"填充面改了没作用"与今天"杆与头都不画"
是同一坏点的两种症状,都走 XChartMeshFillRenderer。硬证据是他工程里那份报表(我打开开关后跑出来的):
`arrows=31 arrowFaces=62 fillChunks=1 fillMaxVerts=248`(=62×4 顶点一个不多)且
`dom=x[-100..100] y[-49.936..49.936] z[-49.743..50]` ⇒ 坐标已折进盒子、面提交了、子块建了、网格真填了顶点,
画面上却没有 ⇒ 坏点在填充渲染器到 Canvas 的那一跳。箭头不再经过那一跳,所以箭头上屏了,
而那一跳本身没修(P23 专门查;绕过去不等于修好)。同一行还抓到一条会撒谎的读数:
curves=0 却 curveVerts=66,而圆柱那一行也印 66 ⇒ UICurveRenderer.LiveVertexCount 不是本实例的数,
不能当"我这条曲线画了多少顶点"读(一并立进 P23)。

判据:探针 **452** 项 0 失败(删 13 条判"四边形角点/剪开再接回"的——**被测对象已不存在,留着就是假绿**;
新增 7 条:标记两尺寸对号入座、头尖对点 vs 圆点居中、progress 夹进 [0,1]、NaN 位置落到末端、0 尺寸兜底、
Straight 每个采样都落在那条直线上、切线方向与矢量平行);p4_control **65** 支 CONTROL PASSED
(删 2 支靶子随代码没了、新增 3 支:两尺寸互换 / progress 不夹 / 头尖不对点,各红 1/2/1 条点名断言);
dirty_gate 正本 knobs=132 takesEffect=132 findings=0、八支变异全红(claim F 判"坐标必须经 TryCubePoint",
改写后仍判得住);编译门 runtime+player+editor+3 对照 GATE PASSED(chain_p22.txt,
tooltip 那次改动之后重跑一次 chain_p22b.txt 同样绿)。

本轮我自己两次把臂写坏,两次都是 harness 拒绝而不是假判,记进规范:
① 单行锚 `AcrossTangent = Mathf.Max(0.1f, width),` 被我新写的孪生函数 Head/Dot 撞成 2 命中 ⇒ SETUP FAILED,
整轮作废 ⇒ 锚要加宽到"只有那一处才有的形状"(这次用两行块);
② 替换值给对象初始化器里那一行写了分号(`Progress = progress;`)⇒ 变异体 CS1513,又是 SETUP FAILED
⇒ 替换值要保持它所在语法位置的标点。
另外 run_gate 学到一件事(同轮改动):rsp 是项目取的快照,删掉一个源文件后那份快照还列着它 ⇒ CS2001,
整道门红得像"产品编译不过"。现在它跳过"工作区里已不存在的包内源文件"并**逐个点名印出来**
(判决要说出它判的是哪棵树)——这不是吞错:CS2001 说的是快照过期,Unity 重导入会自己重生成 rsp。

顺带把 P18 那个还欠着的 .meta(XChartArrowPathMath.cs.meta,Unity 早生成好了、我一直没提交)一起入仓。
覆盖不到的照旧:观感归他现场判(§29.5 四条:成对模式 31 支直线+三角头、连续绘制拖 HeadPosition 头沿线滑动、
颜色维沿程渐变、什么都没有时读 path=/arrows=/markers=/curveVerts=)。
2026-10-26 13:15:55 +08:00

316 lines
14 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 System.Collections.Generic;
using UnityEngine;
using UnityEngine.UI;
using XericUI.Core;
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>
/// 顶点预算分块(纯算,离线可验)。
///
/// <para><b>为什么要有它</b>:UGUI 的 65535 顶点上限是<b>每个 Graphic 各自</b>的,而有些元素是
/// 按记录数长网格的(箭头一条记录 2 个四边形、散点一个点 1 个四边形)⇒ 记录一多必然撞上
/// (他 2026-10-23 灌 10000 条时现场抛 `Mesh can not have more than 65000 vertices`)。
/// 所以提交前先按预算把面切成若干块,每块一个 Graphic。</para>
/// </summary>
public static class XChartMeshBudget
{
/// <summary>每块顶点上限。65535 是硬上限,这里留足余量(还要给别的顶点与实现细节留空间)。</summary>
public const int ChunkVertexBudget = 16000;
/// <summary>
/// 切块:把 <paramref name="faceCount"/> 个面按"每面顶点数"切成若干块,
/// 各块起始面下标写进 <paramref name="starts"/>,返回块数。
/// 块 k 覆盖面 <c>[starts[k], starts[k+1])</c>,最后一块到 <paramref name="faceCount"/>。
/// 顺序不变、不重不漏;单面就超过预算时它自成一块(无解,只能交给渲染器)。
/// </summary>
public static int Split(int[] faceVertexCounts, int faceCount, int budget, int[] starts)
{
if (faceVertexCounts == null) throw new ArgumentNullException(nameof(faceVertexCounts));
if (starts == null) throw new ArgumentNullException(nameof(starts));
if (starts.Length < 1) throw new ArgumentException("starts 至少要有 1 个位置");
if (faceCount <= 0)
{
starts[0] = 0;
return 0;
}
if (budget < 1) budget = 1;
int chunks = 0;
int start = 0;
int used = 0;
for (int i = 0; i < faceCount; i++)
{
int vertices = Mathf.Max(1, faceVertexCounts[i]);
if (used > 0 && used + vertices > budget)
{
starts[chunks++] = start;
start = i;
used = 0;
}
used += vertices;
}
starts[chunks++] = start;
return chunks;
}
/// <summary>各块顶点数的最大值(报表用:报告"最大的那个 Graphic 有多少顶点")</summary>
public static int MaxChunkVertices(int[] faceVertexCounts, int faceCount, int[] starts, int chunkCount)
{
int max = 0;
for (int c = 0; c < chunkCount; c++)
{
int end = (c + 1 < chunkCount) ? starts[c + 1] : faceCount;
int sum = 0;
for (int i = starts[c]; i < end; i++) sum += Mathf.Max(1, faceVertexCounts[i]);
if (sum > max) max = sum;
}
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>
/// 面填充渲染器:提交若干四边形,<b>按顶点预算自动分块</b>,每块一个子 Graphic。
///
/// <para>每面可以纯色填充,也可以"四角色 + 中心色"径向渐变(背景做浅淡的立体感很需要这个)。
/// 面的<b>提交顺序就是绘制顺序</b>,所以调用方要按深度从远到近喂(画家算法)——
/// 半透明面叠在一起时,顺序错了颜色就错了。分块不改这个顺序:块按提交顺序排,块内也按顺序。</para>
///
/// <para>不参与射线检测(背景不该挡住交互)。</para>
/// </summary>
[AddComponentMenu(XericRegistrationPaths.Chart + "/Mesh/Cube Face Fill Renderer")]
public sealed class XChartMeshFillRenderer : MaskableGraphic
{
private struct FaceQuad
{
public Vector2 Corner00;
public Vector2 Corner01;
public Vector2 Corner11;
public Vector2 Corner10;
public Color32 EdgeColor;
public Color32 CenterColor;
/// <summary>怎么上色(平坦 / 径向 / 线性)。<see cref="XChartMeshBudget.VerticesPerFace"/> 吃它</summary>
public XChartFaceFillKind Kind;
}
/// <summary>一块:只画 [Start, End) 之间的面。顶点数受预算限制,所以不会撞 65535 上限。</summary>
private sealed class FaceChunk : MaskableGraphic
{
public XChartMeshFillRenderer Owner;
public int FirstFace;
public int LastFace;
protected override void OnEnable()
{
base.OnEnable();
raycastTarget = false;
}
protected override void OnPopulateMesh(VertexHelper vh)
{
vh.Clear();
if (Owner != null) Owner.PopulateSlice(vh, FirstFace, LastFace);
}
}
private readonly List<FaceQuad> m_Faces = new List<FaceQuad>(8);
private readonly List<FaceChunk> m_Chunks = new List<FaceChunk>();
private int[] m_FaceVertexCounts = new int[0];
private int[] m_ChunkStarts = new int[8];
/// <summary>报表用:这一帧提交了几个面 / 切成几块 / 最大的那块有多少顶点</summary>
public int FaceCount => m_Faces.Count;
public int ChunkCount => m_Chunks.Count;
public int MaxChunkVertices { get; private set; }
protected override void OnEnable()
{
base.OnEnable();
raycastTarget = false;
}
/// <summary>清空已提交的面(每次重建网格前调用)</summary>
public void ClearFaces() => m_Faces.Clear();
/// <summary>
/// 追加一个面。<paramref name="centerColor"/> 与 <paramref name="edgeColor"/> 不同时
/// 走径向渐变(多一个中心顶点 + 4 个三角),相同则平坦填充(4 顶点 2 三角)。
/// </summary>
public void AddFace(Vector2 corner00, Vector2 corner01, Vector2 corner11, Vector2 corner10,
Color edgeColor, Color centerColor)
{
bool gradient = edgeColor != centerColor;
m_Faces.Add(new FaceQuad
{
Corner00 = corner00,
Corner01 = corner01,
Corner11 = corner11,
Corner10 = corner10,
EdgeColor = edgeColor,
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>这一档是"一对边一色",渐变方向垂直于那两条边,顶点数与平坦一样(4 个、2 三角)。
/// <b>矢量场的箭头已经不用它了</b>(§29:杆改走曲线渲染器的共线贝塞尔,头用库的标记),
/// 这里留着是因为它是这个渲染器本身的一种上色模式,别的元素要用渐变填充时不必再写第二套。</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,
});
}
/// <summary>提交:按预算分块,然后各块重画</summary>
public void Apply()
{
RebuildChunks();
SetVerticesDirty(); // 本体不画东西,但仍刷一次,保证子块的顺序紧跟其后
for (int i = 0; i < m_Chunks.Count; i++) m_Chunks[i].SetVerticesDirty();
}
private void RebuildChunks()
{
if (m_FaceVertexCounts.Length < m_Faces.Count) m_FaceVertexCounts = new int[m_Faces.Count];
for (int i = 0; i < m_Faces.Count; i++)
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];
int chunks = XChartMeshBudget.Split(m_FaceVertexCounts, m_Faces.Count,
XChartMeshBudget.ChunkVertexBudget, m_ChunkStarts);
MaxChunkVertices = XChartMeshBudget.MaxChunkVertices(m_FaceVertexCounts, m_Faces.Count,
m_ChunkStarts, chunks);
EnsureChunkCount(chunks);
for (int c = 0; c < chunks; c++)
{
m_Chunks[c].FirstFace = m_ChunkStarts[c];
m_Chunks[c].LastFace = (c + 1 < chunks) ? m_ChunkStarts[c + 1] : m_Faces.Count;
m_Chunks[c].enabled = true;
}
for (int c = chunks; c < m_Chunks.Count; c++) m_Chunks[c].enabled = false; // 多余的块停掉,不画空网格
}
private void EnsureChunkCount(int count)
{
while (m_Chunks.Count < count)
{
var chunk = new GameObject("FillChunk" + m_Chunks.Count, typeof(RectTransform)).AddComponent<FaceChunk>();
chunk.Owner = this;
var rect = (RectTransform)chunk.transform;
rect.SetParent(transform, false);
rect.anchorMin = Vector2.zero;
rect.anchorMax = Vector2.one;
rect.offsetMin = Vector2.zero;
rect.offsetMax = Vector2.zero;
chunk.raycastTarget = false;
m_Chunks.Add(chunk);
}
}
/// <summary>本体不画东西:所有面都交给受预算约束的子块</summary>
protected override void OnPopulateMesh(VertexHelper vh) => vh.Clear();
private static bool IsGradient(FaceQuad face)
{
// Color32 是逐字节比较:"两色不同"就说明这次要做渐变
return face.CenterColor.r != face.EdgeColor.r
|| face.CenterColor.g != face.EdgeColor.g
|| face.CenterColor.b != face.EdgeColor.b
|| face.CenterColor.a != face.EdgeColor.a;
}
internal void PopulateSlice(VertexHelper vh, int start, int end)
{
if (start < 0) start = 0;
if (end > m_Faces.Count) end = m_Faces.Count;
for (int i = start; i < end; i++)
{
FaceQuad face = m_Faces[i];
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.Corner01, corner01Color, new Vector2(0f, 1f));
vh.AddVert(face.Corner11, corner11Color, new Vector2(1f, 1f));
vh.AddVert(face.Corner10, face.EdgeColor, new Vector2(1f, 0f));
if (face.Kind == XChartFaceFillKind.Radial)
{
Vector2 center = (face.Corner00 + face.Corner01 + face.Corner11 + face.Corner10) * 0.25f;
vh.AddVert(center, face.CenterColor, new Vector2(0.5f, 0.5f));
vh.AddTriangle(first + 0, first + 1, first + 4);
vh.AddTriangle(first + 1, first + 2, first + 4);
vh.AddTriangle(first + 2, first + 3, first + 4);
vh.AddTriangle(first + 3, first + 0, first + 4);
}
else
{
vh.AddTriangle(first + 0, first + 1, first + 2);
vh.AddTriangle(first + 2, first + 3, first + 0);
}
}
}
protected override void OnDisable()
{
base.OnDisable();
// 图形停用时子块也得停,否则会留下"看不见但还在"的空网格
for (int i = 0; i < m_Chunks.Count; i++)
{
if (m_Chunks[i] != null) m_Chunks[i].enabled = false;
}
}
}
}