From b26d533ffe410984a8a5846564f3ee826a855405 Mon Sep 17 00:00:00 2001 From: lrc <571244399@qq.com> Date: Mon, 26 Oct 2026 07:56:00 +0800 Subject: [PATCH] =?UTF-8?q?XChart=20P18=EF=BC=88=E4=B8=8B=E5=8D=8A?= =?UTF-8?q?=EF=BC=89=EF=BC=9A=E8=BF=9E=E7=BB=AD=E7=BB=98=E5=88=B6=E8=B5=B0?= =?UTF-8?q?=E6=9B=B2=E7=BA=BF=E6=B8=B2=E6=9F=93=E5=99=A8=20+=20=E7=AE=AD?= =?UTF-8?q?=E5=A4=B4=E4=BD=8D=E7=BD=AE=E5=8F=AF=E8=B0=83=EF=BC=88=E8=A7=84?= =?UTF-8?q?=E8=8C=83=20=C2=A726=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - `ChartToolVectorArrows` 的连续绘制不再提交折线,改为**Catmull-Rom → 三次贝塞尔链**喂库里的 `UICurveRenderer`(圆柱弧段同一件,§10.4:折线只留给直线,逐段提交会在转角留断口)。 曲线**真的经过每个数据点**——矢量场的点是数据本身,用不经过控制点的自由贝塞尔等于把数据挪了位置。 `CurveCacheEntry` 自带起止色 ⇒ 沿程渐变是它本来的能力,不必靠切段凑。 - **箭头位置可调**(`HeadPosition` 0..1):`ResolvePosition` 给"段号 + 段内参数",该段用 `Split` 剪断、 只画左半,箭头放在剪口上、方向取该点**切线**(不是两端连线,弯处会歪)。 必须剪:不剪的话路径从箭头底下穿出去,看着像"箭头朝里长"。 - 互斥显示再用一次:`HeadPosition` / `PathSegments` 只在连续绘制下出现,`相对/绝对` 只在非连续下出现。 - **退路要看得见**:曲线渲染器不在位时退回直线段(形状仍读得出来),报表带 `path=curve|fill|-`、`at=`、`curves=`、`curveVerts=` —— 退没退一个字段说清。 - 文档:规范新增 §26(含他侧验收四条:平滑曲线、拖位置、互斥隐藏、杆两端不同色)。 判据(交付树那一跑,`.ximage-gate/chain_p18.txt` 每套一行 rc):编译门三臂 + 3 对照绿; 探针 **450** 项 0 失败;`p4_control` **61/61** 支臂各红在自己点名的断言上; `p2_control` 4 臂 / `pool_family` / `generator_gate` 2 变异 / `hierarchy_gate` 5 变异全绿。 **没做**:曲线渲染器自带的那个"矢量标签"还没接(现在箭头方向来自切线); `XChartArrowPathMath.cs.meta` 要等 Unity 导入才生成,届时单独补一笔。 --- CHANGELOG.md | 1 + Documentation/XChart-RenderFramework.md | 54 +++++++ Runtime/XChart/Mesh/ChartToolVectorArrows.cs | 140 +++++++++++++++++-- Runtime/XChart/Mesh/XChartVolumeConfigs.cs | 14 +- 4 files changed, 197 insertions(+), 12 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 75a68a4..a205006 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -94,6 +94,7 @@ P14 界面收敛(规范 §23,2026-10-25 他对着截图点了三条):① P15 界面:元素块收成一行状态 + 默认元素让删(规范 §24,2026-10-25 他给的格式 `▼ √ Cylinder (R1, D4) [↑][↓][-]`):① 新增 `MakeHeaderRow` 把折叠板的标题搬进一个横排行,右边依次是 **√**(写 `m_Enabled`)、**R**、**D** 两个**可编辑**格子、`↑ ↓ -` 三个单字符动作键(中文说明进 tooltip),Body 里那行「启用/注册序/绘制序/上移/下移/删除」整行删掉 ⇒ 同一个写入口只有一处。他报的"注册序/绘制序的字段我在界面上没看到"根因**不是没做,是控件在折叠着的 Body 里**(面板默认全折叠,§13)——这一类要按位置查、不按存在查;R/D **不做成静态读数**:面板树在值变化时故意不重建(重建会换掉用户正在拖的输入框),静态读数会停在旧数字上="改了没反应"的又一种形状,绑定的格子没有这个问题。顺带拆掉一个**藏着的第二入口**:基类那三个字段没有 `[Header]`,会被 `AppendHeaderGroups` 整组塞进元素 Body 的「其它」里 ⇒ 标题行有了 √ R D 之后同一个写入口出现两次,现在分组时跳过这三个名字(与 `m_SlotId` 同一条规矩)。② 回答"默认工具应该被删除吗":**让删,也让关**,`[-]` 与 `√` 对每个元素都可用、不做特例,理由写进 `-` 的 tooltip 与 §24.2 那张表(删线框 ⇒ 网格仍发面四角给轴线;删网格 ⇒ 线框仍发四角、`AlignToGrid` 回落并在报表 `align=` 说原因;删空间 ⇒ 见③)。③ 顺带补一条会咬人的不变量:`EnsureSpace()` 原来只在初始化那一次跑,把「空间(基变换)」删掉或停用之后没人再补 ⇒ 投影权威为 null ⇒ 线框/网格/散点全部不画,现象是**"点了一下删,整张图空了"**;现在**每次 `RebuildElements` 之后**都保证图里有一个空间工具(删掉它=回到默认姿态继续画,重新 Add 一条就把旋钮拿回来)。判据:编译门三臂绿(`XChartBaseEditor.cs`/`XChartDataWindow.cs` 在点名源里)、`p4_control` **52/52** 支臂各红在点名的断言上、探针 **424** 项 0 失败、`p2` 4 臂 + `pool_family` + `generator_gate` 2 变异 + `hierarchy_gate` 5 变异**在交付树上复跑**全绿(`.ximage-gate/chain_p15.txt` 每套一行 rc);hierarchy 之所以必须复跑:它算父级是沿**盒子根**往上走的,把 Foldout 搬进横排行不动它的身份——真动错了就会以 `HIERARCHY-NO-PARENT` 红出来。**每份绿各覆盖哪棵树也记清**:那六套复跑覆盖的是"标题行 + `EnsureSpace`"那一版;之后为拆「其它」里的第二入口又改了一次编辑器文件,改完只复跑编译门与探针(`XChartBaseEditor` 只在 `run_gate.py` 的点名源里出现,其余套件一个都不读它,逐脚本 grep 过)。④ **这份绿覆盖不到什么**也点名:一行排不排得下、窄格子能不能改数、"删掉 `Space` 那一行图还在不在",离线一律判不了(引擎 mono 造不出真 `VisualElement`,§13.2)⇒ 归他现场判。 P17 矢量场(箭头)修复 + 相对/绝对 + 连续绘制 + 颜色维(规范 §25,2026-10-25 他现场):① **"加了箭头元素一条都不画"的根因**是维数不够时它静默返回——一条记录要 6 个数值维(起点 3 + 方向 3),而伪 3D 散点预设默认只建了 `x/y/z` 三列,于是算完 0 支、提交 0 个面,画面上与"工具没注册 / 空间是 null / 渲染器没建"长得完全一样 ⇒ 处置不是改那行判断,而是**让这件事说得出来**:元素配置新增 `RequiredNumericDimensions`(默认 0=无所谓),面板在元素块里印"需要 N 个数值维,表现在有 M 个 ⇒ 一条都不画(报表里 dims=N/M)",报表里该元素自己印 `dims=有/需要 arrows=算了几支 mode=… colors=…`;② 一条记录的两组三维按**两种读法**解释(他口述):`Absolute`=后三维是方向矢量本身(起点+方向×倍率 ⇒ 螺旋点画成一片"刺猬")、`Relative`=后三维是第二个点(起点+差向量×倍率 ⇒ 一串首尾相接、顺着螺旋转),算式收进纯算术 `XChartVectorFieldMath.Tip`;③ `连续绘制`:把每条记录的**第一组三维**按顺序连成折线(只有最后一段带箭头),这时"相对/绝对"没有意义 ⇒ **面板上隐藏**——互斥显示的判据写在配置自己身上(`XChartElementConfig.IsFieldHidden(fieldName)`,面板只照着藏/放;**藏而不是不建**:面板树在值变化时不重建,勾回来必须立刻可见);④ **颜色维**:矢量后面再接 3~4 个数值维 `[色相, 饱和度, 明度, (不透明度)]`——色相走 **0..256 的色环**(256 与 0 同色、128 半圈),其余三个按 0..1 夹住;**不透明度那一维不算硬需求**(多给就多读、没给退回单色 alpha),算进门槛的话勾一下"有不透明度"就会让整个元素因维数不够突然消失;不是有限数**门口就拒**(退回单色,不画成黑——NaN 经取模 + HSV 会变成一块"看着像黑"的东西,那是我们替数据编的颜色);HSV 换算**自己写**(`Color.HSVToRGB` 是引擎侧静态调用,离线探针里跑不起来,而这条换算正是要离线钉住的);⑤ 数据侧新增 `测试 → 螺旋矢量场 32(9 维:起点+第二点+色相/饱和/明度)`:前三维是螺旋上的点、中三维是**下一个点**、后三维是颜色(色相 0→256 走满一圈)——两种读法在这份数据上正好是"刺猬"与"首尾相接"两幅图,且它**自己会把列补到 9 个**(测试数据的判据是"点一下就能看到东西",不是"提示他先去加六列")。判据:探针 **436** 项 0 失败(新增 12 条 `vector field` / `vector field colour`)、`p4_control` 新增 3 支臂(相对被读成绝对 / 色环按 0..1 读 / 颜色门口放 NaN 进来)各红在点名断言上、编译门三臂绿,`p2` / `family` / `generator_gate` / `hierarchy_gate` 在交付树上复跑,**55 支臂全红在各自主张上**、探针 436 项 0 失败(终态见 §25.6)。**本轮没做的**如实点名:仍然**不用曲线渲染器**(是直线段——"默认使用直线"是他给的,库里那个带矢量标签的曲线渲染器 + "调整箭头位置"排下一轮)、**两端各自的颜色**(现在是每支一个色,读一条记录的颜色维;他提的"两个分量各自设色"要逐顶点双色)、圆柱的颜色开关没动。 P17 口径修正(同日,听他澄清;规范 §24.5 与 §25 已按正确口径重写):① **序号不是给人设的**——*注册序*由**类型**定好(定义几何的那一类天然靠前、数据呈现那一类靠后),面板**只显示、不给输入控件**;*绘制序*与**元素在表里的位置**绑定(上移/下移就是改绘制顺序),也不再有第二个手填的序号——序号能手填就会出现两条口径(位置 vs 数字)指向不同事实,"上移之后绘制顺序变没变"就没人回答得了。第一版我把 `R… D…` 做成了两个窄输入框,他现场否掉("我根本不想给它设置这个序号"),而且那对输入框还会露出拖拽光标、窄到数字看不见 ⇒ 改成**文本读数**并就地刷新(面板树在值变化时不重建)。② **矢量场的数据口径写错了**:正确是**前三维=坐标 x/y/z**(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录**(第二条按相对/绝对解释成"第二个点"或"方向矢量")、**第 4~7 维才是颜色**(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,全部可选);初版照着旧实现写成"一条记录塞两组三维(6 维)"——那既不是他的口径,也让"两个分量各自有颜色"讲不通。代码随后按这一版改(改前仍按旧口径跑)。 +P18 矢量场收尾:两端各自的颜色 + 连续绘制走曲线渲染器 + 箭头位置可调(规范 §26,2026-10-26):① 填充四边形多一档**线性渐变**(`AddFaceLinear`:`00/10` 一对边一色、`01/11` 一对边一色),箭头**杆走渐变(起点色→终点色)、头走终点色**——两端颜色来自相邻两条记录各自的颜色维,所以"这条与下条颜色不同"直接看得出来;每面花几个顶点收成**单一定义** `XChartMeshBudget.VerticesPerFace(kind)`(预算侧与写顶点侧同源,否则"预算以为 4 个、实际发 5 个"会在卡线时撞 65535,§10.3 那一族);**杆的四角绕序有判据**(a/d 在起点一侧、b/c 在末端一侧;配错画面上是"杆两侧各一色"而不是"沿杆渐变",最容易看漏)。② 连续绘制改走**曲线渲染器**(库里 `UICurveRenderer`,圆柱弧段同一件):途经点 → **Catmull-Rom 转三次贝塞尔**(张力 1/6,新纯算术 `XChartArrowPathMath`),曲线**真的经过每个数据点**——矢量场的点是数据本身,用不经过控制点的自由贝塞尔等于把数据挪了位置;`entry` 自带起止色 ⇒ 沿程渐变是它本来的能力;不再逐段提交折线(§10.4 的转角断口)。③ **箭头位置可调**(`HeadPosition` 0..1):`ResolvePosition` 给段号+段内参数 ⇒ 该段 `Split` 剪断、只画左半,箭头放在剪口上、方向取该点**切线**(不是两端连线,弯处会歪);**必须剪**,否则路径从箭头底下穿出去、看着像"箭头朝里长"。④ 互斥显示又用一次:`HeadPosition`/`PathSegments` 只在连续绘制下出现,`相对/绝对` 反过来只在非连续下出现。⑤ 读数与退路:报表带 `path=curve|fill|-`、`at=`、`curves=`、`curveVerts=`——曲线渲染器不在位时退回直线段(形状仍读得出来),但**退没退在 `path=` 上一个字说清**,不是悄悄换个画法还报一样的数。判据:编译门三臂 + 3 对照绿;探针 **450** 项 0 失败(新增 `arrow path:` 9 条——全是**性质**判据:过数据点、端点切线=弦的一半、剪开再接回逐点一致、共线仍是直的、位置 0/0.5/1 落在哪一段,不写手算的中间点坐标)+ `arrow shaft:` 配对 1 条 + 顶点数 1 条;`p4_control` **61** 支臂各红在点名断言上(新增 4 支:起点侧角取成末端、所有面按平坦算顶点、控制柄拉成 /3 张力、剪开不共用剪口点);`p2` / `family` / `generator_gate` / `hierarchy_gate` 同树复跑。**没做**:曲线渲染器的"矢量标签"(它自带的那个)还没接——现在箭头方向来自切线,标签要下一轮;观感照例归他现场判。 ## [0.1.6] - 2026-07-01 diff --git a/Documentation/XChart-RenderFramework.md b/Documentation/XChart-RenderFramework.md index bd2a428..049d4b7 100644 --- a/Documentation/XChart-RenderFramework.md +++ b/Documentation/XChart-RenderFramework.md @@ -1719,6 +1719,60 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最 于是 `did not go red` 当场把这条假点名抓了出来。⇒ 规矩不变:**点名清单按实测改**; 给每条判据配**它自己那支**变异体(这次补了"空表不挡而直接进算术"那一支专门管零/一条记录)。 +## 26. P18:矢量场的两端颜色,与"路径上的箭头"(2026-10-26) + +### 26.1 两端各自的颜色=填充四边形多一档线性渐变 + +`XChartMeshFillRenderer` 原来只有两档:四角同色(平坦)与"四角 + 中心"(径向)。这轮加第三档 +**线性渐变**(`AddFaceLinear`):`00/10` 一对边一色、`01/11` 一对边一色,渐变方向垂直于这两条边。 + +- **每面花几个顶点收成单一定义** `XChartMeshBudget.VerticesPerFace(kind)`:预算侧与写顶点侧必须同源, + 否则会出现"预算以为 4 个、实际发 5 个",恰好在卡线时撞 65535(§10.3 那一族)。 +- 箭头:**杆走线性渐变(起点色 → 终点色),头走单色(终点色)**。两端颜色来自相邻两条记录各自的颜色维, + 所以"这条记录的颜色和下一条不同"就直接看得出来了。 +- **杆的四角绕序有判据**:`BuildShaft` 把 a/d 放在起点一侧、b/c 放在末端一侧——配错的话画面上是 + "杆的两侧各一色"而不是"沿杆渐变",这种错最容易看漏,所以离线钉住(探针 `arrow shaft:` 一条 + 一支臂)。 + +### 26.2 连续绘制改走曲线渲染器(贝塞尔细分) + +路径是"会弯的线",所以交给库里的 `UICurveRenderer`(圆柱弧段同一件,§10.4:折线渲染器只留给直线, +逐段提交会在转角留断口)。API 形状是从我们自己的调用点学的: +`AddCurve(CurveCacheEntry{startColor,endColor,tessellationSegments}, 4 个控制点, 4 个宽度)`, +`autoRebuild = false`(控制点每帧由工具喂),报表读 `LiveVertexCount`。 +**entry 自带起止色 ⇒ 沿程渐变是曲线渲染器本来就有的能力**,路径的颜色不必靠切段去凑。 + +途经点 → 控制点用 **Catmull-Rom 转三次贝塞尔**(张力 1/6,`XChartArrowPathMath`): +这样曲线**真的经过每个数据点**——矢量场的点是数据本身,用不经过控制点的自由贝塞尔等于把数据挪了位置。 + +### 26.3 箭头位置可调:路径在剪口处剪断 + +`HeadPosition`(0..1,默认 1=末端)="画到路径的哪个位置",箭头放在那一处: + +1. `ResolvePosition(段数, along)` → 段号 + 段内参数; +2. 该段用 `Split` 在参数处剪成两半,**只画左半**(前面的段整段画); +3. 箭头放在剪口上,方向取该点的**切线**(`Tangent`),不是两端连线——弯处会歪。 + +**为什么要剪断**:不剪的话路径从箭头底下穿出去,看着像"箭头朝里长"。 +剪开再接回去必须与原段逐点一致(探针 8 个采样点,最大偏差 <1e-4),否则"箭头前面那段路挪了位"。 + +### 26.4 互斥显示又用了一次 + +`HeadPosition` 与 `PathSegments` **只在连续绘制下出现**(一支一支画时头永远在末端,这两个值没有意义); +`VectorMode` 反过来只在非连续下出现。判据全在配置自己的 `IsFieldHidden` 里,面板不写特例。 + +### 26.5 读数与退路 + +报表那一行现在带 `path=curve|fill|-`、`at=<位置>`、`curves=<提交了几段>`、`curveVerts=<顶点数>`: +**曲线渲染器不在位时退回直线段**(形状仍读得出来),但退没退在 `path=` 上一个字就说清了—— +不是"悄悄换个画法还报一样的数"。 + +### 26.6 他侧验收(Ctrl+R 后) + +1. 打开颜色维 + `连续绘制`:路径是平滑曲线(不是折角链),颜色沿程渐变,末端一个箭头。 +2. 拖 `HeadPosition` 到 0.3:路径只画到 30% 处,箭头在那里、顺着曲线的方向;拖回 1=整条。 +3. 关掉连续绘制:`HeadPosition` / `PathSegments` 两项**消失**,`相对/绝对`回来。 +4. 一支一支的箭头:杆的两端颜色不同(起点色 → 终点色),头是终点色。 + ### 25.8 他侧验收(Ctrl+R 后) 1. `工具 → Add → 向量箭头`,数据窗口 `测试 → 螺旋矢量场`:立刻看到箭头。 diff --git a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs index 76273f8..6200127 100644 --- a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs +++ b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs @@ -65,6 +65,30 @@ namespace XericUI.XChart.Mesh public XChartMeshFillRenderer FillRenderer { get; private set; } + /// + /// 连续绘制用的曲线渲染器(库里的贝塞尔细分渲染器,圆柱弧段同一件)。 + /// 折线渲染器只留给直线——他 2026-10-23 的原话,而路径正是"会弯的那种线"(§10.4)。 + /// + public UICurveRenderer CurveRenderer { get; private set; } + + /// + /// 连续绘制时画到路径的哪个位置(0=起点、1=整条,默认 1): + /// 箭头就放在这一处,路径在这一点被剪断(剪口之后不画)—— + /// 不剪的话路径会从箭头底下穿出去,看着像"箭头朝里长"。 + /// + public float HeadPosition { get; set; } = 1f; + + /// 连续绘制时每段贝塞尔细分成几节(曲线渲染器的 tessellation) + public int PathSegments { get; set; } = 12; + + private readonly List m_Pixels = new List(64); + private string m_PathRenderer = "-"; + private readonly Vector2[] m_Bezier = new Vector2[XChartArrowPathMath.ControlPointsPerSegment]; + private readonly Vector2[] m_Left = new Vector2[XChartArrowPathMath.ControlPointsPerSegment]; + private readonly Vector2[] m_Right = new Vector2[XChartArrowPathMath.ControlPointsPerSegment]; + private readonly float[] m_Widths = new float[XChartArrowPathMath.ControlPointsPerSegment]; + private int m_CurveEntries; + private Matrix4x4 m_Composed = Matrix4x4.identity; private int m_LastSpaceVersion = -1; private long m_LastDataVersion = -1; @@ -122,6 +146,18 @@ namespace XericUI.XChart.Mesh rect.offsetMin = Vector2.zero; rect.offsetMax = Vector2.zero; } + + // 连续绘制走曲线渲染器(贝塞尔细分);控制点每帧由本工具喂,别让它自己重建默认那条 + CurveRenderer = CreateChildComponent("ArrowPath"); + if (CurveRenderer != null) + { + CurveRenderer.autoRebuild = false; + var rect = CurveRenderer.rectTransform; + rect.anchorMin = Vector2.zero; + rect.anchorMax = Vector2.one; + rect.offsetMin = Vector2.zero; + rect.offsetMax = Vector2.zero; + } SetVisible(true); } @@ -129,6 +165,7 @@ namespace XericUI.XChart.Mesh { base.OnRender(); if (FillRenderer == null) return; + // 曲线渲染器不在位也要出图(退回直线段),所以它不是"能不能画"的前提 var space = Context?.Space; if (space == null) return; @@ -142,6 +179,7 @@ namespace XericUI.XChart.Mesh m_LastDataVersion = dataVersion; m_Composed = space.Compose(Transform); + if (CurveRenderer != null) CurveRenderer.ClearAll(); BuildFaces(space); FillRenderer.ClearFaces(); @@ -154,6 +192,7 @@ namespace XericUI.XChart.Mesh FillRenderer.AddFace(face.A, face.B, face.C, face.D, face.Color, face.Color); } FillRenderer.Apply(); + if (CurveRenderer != null) CurveRenderer.RebuildAll(); } private void BuildFaces(ChartToolSpace space) @@ -163,6 +202,8 @@ namespace XericUI.XChart.Mesh m_DimensionsHave = 0; m_RecordsHave = 0; m_DimensionsNeed = RequiredDimensionCount; + m_CurveEntries = 0; + m_PathRenderer = Continuous ? (CurveRenderer != null ? "curve" : "fill") : "-"; var source = Data; if (source == null || !source.HasData) return; @@ -197,23 +238,94 @@ namespace XericUI.XChart.Mesh } /// - /// 连续绘制:把每条记录的坐标按顺序连成折线,只有最后一段带箭头。 - /// 段与段之间是同一串坐标,所以"相对/绝对"在这里没有意义(配置里那一项也隐藏了)。 + /// 连续绘制:一串途经点 → Catmull-Rom 贝塞尔链,交给曲线渲染器(贝塞尔细分,接缝不断口); + /// 路径在 处剪断,箭头放在剪口上、顺着那一点的切线。 + /// 不剪的话路径会从箭头底下穿出去,看着像"箭头朝里长"。 + /// 段与段之间是同一串坐标,所以"相对/绝对"在这里没有意义(配置里那一项也隐藏了); + /// 曲线渲染器不在位时退回直线段(形状仍读得出来),报表里 path=fill 会说出来。 /// private void BuildContinuous(IXChartDataSource source, ChartToolSpace space, int limit) { - if (limit < 1) return; + m_Pixels.Clear(); + for (int i = 0; i <= limit; i++) + m_Pixels.Add(space.Project(ReadPoint(source, i), m_Composed)); - Vector3 previous = ReadPoint(source, 0); - for (int i = 1; i <= limit; i++) + int segments = m_Pixels.Count - 1; + if (segments < 1) return; + + XChartArrowPathMath.ResolvePosition(segments, HeadPosition, out int headSegment, out float headT); + + Vector2 cut = Vector2.zero; + Vector2 cutTangent = Vector2.zero; + + for (int s = 0; s <= headSegment; s++) { - Vector3 current = ReadPoint(source, i); - bool last = i == limit; - // 段用"到达点"的颜色(最后一段的箭头用终点色):一串颜色维读下来就是沿路径渐变 - AddArrow(space, previous, current, ColorAt(source, i - 1), ColorAt(source, i), last); - m_ArrowsBuilt++; - previous = current; + BuildSegmentBezier(s); + Vector2[] drawn = m_Bezier; + if (s == headSegment && headT < 1f) + { + XChartArrowPathMath.Split(m_Bezier, headT, m_Left, m_Right); + drawn = m_Left; + } + + AddPathSegment(drawn, ColorAt(source, s), ColorAt(source, s + 1)); + + cut = XChartArrowPathMath.Evaluate(drawn, 1f); + cutTangent = XChartArrowPathMath.Tangent(drawn, 1f); + if (s == headSegment) break; } + + AddHeadAt(cut, cutTangent, ColorAt(source, Mathf.Min(headSegment + 1, m_RecordsHave - 1))); + m_ArrowsBuilt = headSegment + 1; + } + + /// 段 s(点 s → 点 s+1)的贝塞尔控制点。端点之外重复端点:端点处切线指向段内。 + private void BuildSegmentBezier(int s) + { + int last = m_Pixels.Count - 1; + XChartArrowPathMath.CatmullRomToBezier( + m_Pixels[s > 0 ? s - 1 : 0], m_Pixels[s], m_Pixels[s + 1], + m_Pixels[s + 2 <= last ? s + 2 : last], m_Bezier); + } + + private void AddPathSegment(Vector2[] bezier, Color fromColor, Color toColor) + { + if (CurveRenderer != null) + { + for (int i = 0; i < m_Widths.Length; i++) m_Widths[i] = ShaftWidth; + CurveRenderer.AddCurve(new CurveCacheEntry + { + startColor = fromColor, + endColor = toColor, + tessellationSegments = Mathf.Clamp(PathSegments, 2, 64), + }, bezier, m_Widths); + m_CurveEntries++; + return; + } + + Vector2 a = bezier[0]; + Vector2 b = bezier[3]; + Vector2 side = new Vector2(-(b.y - a.y), b.x - a.x); + if (side.sqrMagnitude < 1e-6f) return; + side.Normalize(); + float half = ShaftWidth * 0.5f; + m_Faces.Add(new ArrowFace + { + A = a + side * half, B = b + side * half, C = b - side * half, D = a - side * half, + Depth = 0f, Color = fromColor, ColorTo = toColor, Linear = true, + }); + } + + /// 箭头放在剪口上,方向顺那一点的切线(不是两端连线——弯处会歪)。 + private void AddHeadAt(Vector2 tip, Vector2 tangent, Color color) + { + if (tangent.sqrMagnitude < 1e-6f) return; + Vector2 unit = tangent.normalized; + Vector2 side = new Vector2(-unit.y, unit.x); + Vector2 baseCenter = tip - unit * HeadLength; + Vector2 a, b, c, d; + XChartArrowGeometry.BuildHead(baseCenter, tip, side, HeadWidth, out a, out b, out c, out d); + m_Faces.Add(new ArrowFace { A = a, B = b, C = c, D = d, Depth = 0f, Color = color }); } /// @@ -295,7 +407,9 @@ namespace XericUI.XChart.Mesh protected override void OnDispose() { FillRenderer = null; + CurveRenderer = null; m_Faces.Clear(); + m_Pixels.Clear(); } #if UNITY_EDITOR @@ -312,6 +426,10 @@ namespace XericUI.XChart.Mesh .Append(" arrows=").Append(m_ArrowsBuilt) .Append(" mode=").Append(Continuous ? "continuous" : (VectorMode == XChartArrowVectorMode.Relative ? "relative" : "absolute")) .Append(" colors=").Append(UseColorDimensions ? (HasAlphaDimension ? "hsv+a" : "hsv") : "single") + .Append(" path=").Append(m_PathRenderer) + .Append(" at=").Append(HeadPosition.ToString("0.###")) + .Append(" curves=").Append(m_CurveEntries) + .Append(" curveVerts=").Append(CurveRenderer != null ? CurveRenderer.LiveVertexCount : 0) .Append(" arrowFaces=").Append(FillRenderer != null ? FillRenderer.FaceCount : 0) .Append(" fillChunks=").Append(FillRenderer != null ? FillRenderer.ChunkCount : 0) .Append(" fillMaxVerts=").Append(FillRenderer != null ? FillRenderer.MaxChunkVertices : 0); diff --git a/Runtime/XChart/Mesh/XChartVolumeConfigs.cs b/Runtime/XChart/Mesh/XChartVolumeConfigs.cs index a330586..e14b32e 100644 --- a/Runtime/XChart/Mesh/XChartVolumeConfigs.cs +++ b/Runtime/XChart/Mesh/XChartVolumeConfigs.cs @@ -156,10 +156,18 @@ namespace XericUI.XChart.Mesh "相对:它是第二个点,箭头=第一点指向第二点。**连续绘制打开时这一项不适用**")] private XChartArrowVectorMode m_VectorMode = XChartArrowVectorMode.Absolute; - [SerializeField, Tooltip("把每条记录的坐标按顺序连成一条折线(只有最后一段带箭头)。" + + [SerializeField, Tooltip("把每条记录的坐标按顺序连成一条路径(贝塞尔细分,接缝不断口)。" + "打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")] private bool m_Continuous; + [SerializeField, Range(0f, 1f), Tooltip("连续绘制时箭头放在路径的哪个位置(0=起点、1=末端):" + + "路径在这一处剪断,箭头顺那一点的切线。只有连续绘制用得上")] + private float m_HeadPosition = 1f; + + [SerializeField, Range(2, 64), Tooltip("连续绘制时每段路径细分成几节(曲线渲染器的 tessellation)。" + + "越大越圆也越贵。只有连续绘制用得上")] + private int m_PathSegments = 12; + [SerializeField, Tooltip("方向向量长度倍率(立方体单位);相对模式下作用在差向量上")] private float m_DirectionScale = 0.25f; @@ -212,6 +220,8 @@ namespace XericUI.XChart.Mesh public override bool IsFieldHidden(string fieldName) { if (fieldName == nameof(m_VectorMode)) return m_Continuous; + // 这两项是"路径上的箭头"才有的概念:一支一支画的时候头永远在末端 + if (fieldName == nameof(m_HeadPosition) || fieldName == nameof(m_PathSegments)) return !m_Continuous; if (fieldName == nameof(m_ColorDimension) || fieldName == nameof(m_HasAlphaDimension)) return !m_UseColorDimensions; return false; @@ -226,6 +236,8 @@ namespace XericUI.XChart.Mesh arrows.CoordinateDimension = m_CoordinateDimension; arrows.VectorMode = m_VectorMode; arrows.Continuous = m_Continuous; + arrows.HeadPosition = m_HeadPosition; + arrows.PathSegments = m_PathSegments; arrows.DirectionScale = m_DirectionScale; arrows.MaxArrowCount = m_MaxArrowCount; arrows.Transform = m_Transform;