XChart P18(下半):连续绘制走曲线渲染器 + 箭头位置可调(规范 §26)

- `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 导入才生成,届时单独补一笔。
This commit is contained in:
2026-10-26 07:56:00 +08:00
parent c40aa1f0c1
commit b26d533ffe
4 changed files with 197 additions and 12 deletions
+1
View File
@@ -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)⇒ 归他现场判。 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 矢量场(箭头)修复 + 相对/绝对 + 连续绘制 + 颜色维(规范 §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 维)"——那既不是他的口径,也让"两个分量各自有颜色"讲不通。代码随后按这一版改(改前仍按旧口径跑)。 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 ## [0.1.6] - 2026-07-01
+54
View File
@@ -1719,6 +1719,60 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最
于是 `did not go red` 当场把这条假点名抓了出来。⇒ 规矩不变:**点名清单按实测改**; 于是 `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 后) ### 25.8 他侧验收(Ctrl+R 后)
1. `工具 → Add → 向量箭头`,数据窗口 `测试 → 螺旋矢量场`:立刻看到箭头。 1. `工具 → Add → 向量箭头`,数据窗口 `测试 → 螺旋矢量场`:立刻看到箭头。
+129 -11
View File
@@ -65,6 +65,30 @@ namespace XericUI.XChart.Mesh
public XChartMeshFillRenderer FillRenderer { get; private set; } public XChartMeshFillRenderer FillRenderer { get; private set; }
/// <summary>
/// 连续绘制用的曲线渲染器(库里的贝塞尔细分渲染器,圆柱弧段同一件)。
/// <b>折线渲染器只留给直线</b>——他 2026-10-23 的原话,而路径正是"会弯的那种线"(§10.4)。
/// </summary>
public UICurveRenderer CurveRenderer { get; private set; }
/// <summary>
/// 连续绘制时<b>画到路径的哪个位置</b>(0=起点、1=整条,默认 1):
/// 箭头就放在这一处,路径在这一点被剪断(剪口之后不画)——
/// 不剪的话路径会从箭头底下穿出去,看着像"箭头朝里长"。
/// </summary>
public float HeadPosition { get; set; } = 1f;
/// <summary>连续绘制时每段贝塞尔细分成几节(曲线渲染器的 tessellation)</summary>
public int PathSegments { get; set; } = 12;
private readonly List<Vector2> m_Pixels = new List<Vector2>(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 Matrix4x4 m_Composed = Matrix4x4.identity;
private int m_LastSpaceVersion = -1; private int m_LastSpaceVersion = -1;
private long m_LastDataVersion = -1; private long m_LastDataVersion = -1;
@@ -122,6 +146,18 @@ namespace XericUI.XChart.Mesh
rect.offsetMin = Vector2.zero; rect.offsetMin = Vector2.zero;
rect.offsetMax = Vector2.zero; rect.offsetMax = Vector2.zero;
} }
// 连续绘制走曲线渲染器(贝塞尔细分);控制点每帧由本工具喂,别让它自己重建默认那条
CurveRenderer = CreateChildComponent<UICurveRenderer>("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); SetVisible(true);
} }
@@ -129,6 +165,7 @@ namespace XericUI.XChart.Mesh
{ {
base.OnRender(); base.OnRender();
if (FillRenderer == null) return; if (FillRenderer == null) return;
// 曲线渲染器不在位也要出图(退回直线段),所以它不是"能不能画"的前提
var space = Context?.Space; var space = Context?.Space;
if (space == null) return; if (space == null) return;
@@ -142,6 +179,7 @@ namespace XericUI.XChart.Mesh
m_LastDataVersion = dataVersion; m_LastDataVersion = dataVersion;
m_Composed = space.Compose(Transform); m_Composed = space.Compose(Transform);
if (CurveRenderer != null) CurveRenderer.ClearAll();
BuildFaces(space); BuildFaces(space);
FillRenderer.ClearFaces(); 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.AddFace(face.A, face.B, face.C, face.D, face.Color, face.Color);
} }
FillRenderer.Apply(); FillRenderer.Apply();
if (CurveRenderer != null) CurveRenderer.RebuildAll();
} }
private void BuildFaces(ChartToolSpace space) private void BuildFaces(ChartToolSpace space)
@@ -163,6 +202,8 @@ namespace XericUI.XChart.Mesh
m_DimensionsHave = 0; m_DimensionsHave = 0;
m_RecordsHave = 0; m_RecordsHave = 0;
m_DimensionsNeed = RequiredDimensionCount; m_DimensionsNeed = RequiredDimensionCount;
m_CurveEntries = 0;
m_PathRenderer = Continuous ? (CurveRenderer != null ? "curve" : "fill") : "-";
var source = Data; var source = Data;
if (source == null || !source.HasData) return; if (source == null || !source.HasData) return;
@@ -197,23 +238,94 @@ namespace XericUI.XChart.Mesh
} }
/// <summary> /// <summary>
/// 连续绘制:把每条记录的坐标按顺序连成折线,<b>只有最后一段带箭头</b>。 /// 连续绘制:一串途经点 → Catmull-Rom 贝塞尔链,交给曲线渲染器(贝塞尔细分,接缝不断口);
/// 段与段之间是同一串坐标,所以"相对/绝对"在这里没有意义(配置里那一项也隐藏了)。 /// 路径在 <see cref="HeadPosition"/> 处<b>剪断</b>,箭头放在剪口上、顺着那一点的<b>切线</b>。
/// 不剪的话路径会从箭头底下穿出去,看着像"箭头朝里长"。
/// 段与段之间是同一串坐标,所以"相对/绝对"在这里没有意义(配置里那一项也隐藏了);
/// 曲线渲染器不在位时退回直线段(形状仍读得出来),报表里 <c>path=fill</c> 会说出来。
/// </summary> /// </summary>
private void BuildContinuous(IXChartDataSource source, ChartToolSpace space, int limit) 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); int segments = m_Pixels.Count - 1;
for (int i = 1; i <= limit; i++) 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); BuildSegmentBezier(s);
bool last = i == limit; Vector2[] drawn = m_Bezier;
// 段用"到达点"的颜色(最后一段的箭头用终点色):一串颜色维读下来就是沿路径渐变 if (s == headSegment && headT < 1f)
AddArrow(space, previous, current, ColorAt(source, i - 1), ColorAt(source, i), last); {
m_ArrowsBuilt++; XChartArrowPathMath.Split(m_Bezier, headT, m_Left, m_Right);
previous = current; 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;
}
/// <summary>段 s(点 s → 点 s+1)的贝塞尔控制点。端点之外重复端点:端点处切线指向段内。</summary>
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,
});
}
/// <summary>箭头放在剪口上,方向顺那一点的<b>切线</b>(不是两端连线——弯处会歪)。</summary>
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 });
} }
/// <summary> /// <summary>
@@ -295,7 +407,9 @@ namespace XericUI.XChart.Mesh
protected override void OnDispose() protected override void OnDispose()
{ {
FillRenderer = null; FillRenderer = null;
CurveRenderer = null;
m_Faces.Clear(); m_Faces.Clear();
m_Pixels.Clear();
} }
#if UNITY_EDITOR #if UNITY_EDITOR
@@ -312,6 +426,10 @@ namespace XericUI.XChart.Mesh
.Append(" arrows=").Append(m_ArrowsBuilt) .Append(" arrows=").Append(m_ArrowsBuilt)
.Append(" mode=").Append(Continuous ? "continuous" : (VectorMode == XChartArrowVectorMode.Relative ? "relative" : "absolute")) .Append(" mode=").Append(Continuous ? "continuous" : (VectorMode == XChartArrowVectorMode.Relative ? "relative" : "absolute"))
.Append(" colors=").Append(UseColorDimensions ? (HasAlphaDimension ? "hsv+a" : "hsv") : "single") .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(" arrowFaces=").Append(FillRenderer != null ? FillRenderer.FaceCount : 0)
.Append(" fillChunks=").Append(FillRenderer != null ? FillRenderer.ChunkCount : 0) .Append(" fillChunks=").Append(FillRenderer != null ? FillRenderer.ChunkCount : 0)
.Append(" fillMaxVerts=").Append(FillRenderer != null ? FillRenderer.MaxChunkVertices : 0); .Append(" fillMaxVerts=").Append(FillRenderer != null ? FillRenderer.MaxChunkVertices : 0);
+13 -1
View File
@@ -156,10 +156,18 @@ namespace XericUI.XChart.Mesh
"相对:它是第二个点,箭头=第一点指向第二点。**连续绘制打开时这一项不适用**")] "相对:它是第二个点,箭头=第一点指向第二点。**连续绘制打开时这一项不适用**")]
private XChartArrowVectorMode m_VectorMode = XChartArrowVectorMode.Absolute; private XChartArrowVectorMode m_VectorMode = XChartArrowVectorMode.Absolute;
[SerializeField, Tooltip("把每条记录的坐标按顺序连成一条折线(只有最后一段带箭头)。" + [SerializeField, Tooltip("把每条记录的坐标按顺序连成一条路径(贝塞尔细分,接缝不断口)。" +
"打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")] "打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")]
private bool m_Continuous; 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("方向向量长度倍率(立方体单位);相对模式下作用在差向量上")] [SerializeField, Tooltip("方向向量长度倍率(立方体单位);相对模式下作用在差向量上")]
private float m_DirectionScale = 0.25f; private float m_DirectionScale = 0.25f;
@@ -212,6 +220,8 @@ namespace XericUI.XChart.Mesh
public override bool IsFieldHidden(string fieldName) public override bool IsFieldHidden(string fieldName)
{ {
if (fieldName == nameof(m_VectorMode)) return m_Continuous; 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)) if (fieldName == nameof(m_ColorDimension) || fieldName == nameof(m_HasAlphaDimension))
return !m_UseColorDimensions; return !m_UseColorDimensions;
return false; return false;
@@ -226,6 +236,8 @@ namespace XericUI.XChart.Mesh
arrows.CoordinateDimension = m_CoordinateDimension; arrows.CoordinateDimension = m_CoordinateDimension;
arrows.VectorMode = m_VectorMode; arrows.VectorMode = m_VectorMode;
arrows.Continuous = m_Continuous; arrows.Continuous = m_Continuous;
arrows.HeadPosition = m_HeadPosition;
arrows.PathSegments = m_PathSegments;
arrows.DirectionScale = m_DirectionScale; arrows.DirectionScale = m_DirectionScale;
arrows.MaxArrowCount = m_MaxArrowCount; arrows.MaxArrowCount = m_MaxArrowCount;
arrows.Transform = m_Transform; arrows.Transform = m_Transform;