他这句纠正指向一件我一直不知道存在的东西: > 我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置。 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=)。
316 lines
14 KiB
C#
316 lines
14 KiB
C#
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;
|
||
}
|
||
}
|
||
}
|
||
} |