Commit Graph
9 Commits
Author SHA1 Message Date
lrss3 71629c08bf XChart P20a:MarkDirty 升成基类抽象——置脏这件事不许有静默空实现
外部按参数驱动渲染这条路要通了,第一步是把"脏位"从各工具的私有约定升成基类协议:
XChartToolBase 新增 `public abstract void MarkDirty()`。

为什么是 abstract 而不是"基类给个空实现":空实现通过基类引用调用时什么都不做——
参数改了、值也进去了、画面不动、报表也看不出错("零要说出它零在哪一层"那一族)。
抽象让编译器逼每个工具自己说清脏位是哪个字段。

- 7 个已有 MarkDirty 的工具:`public void` → `public override void`。
  漏改任何一个都会是 CS0108 隐藏:编译只出警告,而基类引用上的调用从此静默失效。
- ChartToolSpace:没有独立脏位,投影就是它唯一要重算的东西 ⇒ override 转发给
  MarkProjectionDirty(),不自立第二个标记。
- ChartToolScatterPoints:只有 MarkDataDirty() ⇒ override 接 m_PointsDirty,
  旧名字留着转发(同工具里"数据脏"与"参数脏"本来就是同一个字段,两个名字一个字段)。

离线编译门(runtime + player + editor + 3 支对照):GATE PASSED,chain_p20a.txt。
本轮只动生命周期协议,旋钮行为未变;setter 自动置脏在下一笔。
2026-10-26 08:49:34 +08:00
lrss3 b26d533ffe 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 导入才生成,届时单独补一笔。
2026-10-26 07:56:00 +08:00
lrss3 c40aa1f0c1 XChart P18(中):连续绘制那条路径的算术与判据(曲线渲染器接线前的地基)
新增纯算术 `Runtime/XChart/Mesh/XChartArrowPathMath.cs`:一串途经点 → 三次贝塞尔链
(Catmull-Rom,张力 1/6),以及链上取点 / 取切线 / 在参数处剪成两段 / "整条路径的位置"换成段号+段内参数。

为什么先落算式:曲线渲染器(库里的 `UICurveRenderer`,圆柱弧段已在用,`AddCurve(entry, 4 控制点, 4 宽度)`,
entry 自带起止色=沿程渐变)吃的是**控制点**——控制点算错,画面上只是"看着不太对",不会报错。
箭头放在路径哪一处、切线朝哪,全由这几个函数决定,所以每条都要有判据。

判据(9 条,全是**性质**而不是手算的中间点坐标——写死的数字一旦错了就是抄自己的输出):
- 曲线**经过每个数据点**(段的两端就是那两个点);
- 端点切线=过该点那条弦的一半(Catmull-Rom 的标准性质,张力 1/6 就是它的来源);
- 剪开的两半**共用同一个剪口点**,且逐参数接回去与原段逐点一致(8 个采样点,最大偏差 <1e-4);
- 共线的点画出来仍是直的(切线平行、y 恒 0);
- 位置 0 → 首段起点、1 → **末段末端**、0.5 → 第 2 段起点;段数 0 时给出的是"没有路径"而不是猜。

`p4_control` **61** 支臂:新增两支各红在点名断言上(把控制柄拉成 /3 张力、剪开时不共用剪口点);
探针 **450** 项 0 失败;编译门三臂 + 3 对照绿。
下一笔把这条链接进 `ChartToolVectorArrows` 的连续绘制(曲线渲染器 + 箭头位置可调)。
新文件的 `.meta` 要等 Unity 导入才有,届时单独补一笔。
2026-10-26 07:29:58 +08:00
lrss3 5cdcbbc635 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 的下一半。
2026-10-26 07:23:23 +08:00
lrss3 0d9a3d7417 XChart P17 口径修正:序号只读、矢量场按 3 维坐标 + 相邻两条记录一支箭头
按他 2026-10-25 的澄清(规范 §24.5 / §25 已先改对):

- **序号不再是给人设的**:标题行 `R… D…` 改成文本读数(就地刷新);Body 里不再有任何序号输入控件。
  新增 `RenumberDrawOrder()`:任何结构变化(上移/下移/加/删)之后把每个元素的 `m_DrawOrder`
  重写成它在表里的位置 ⇒ **位置更靠后=绘得更晚=盖在上面**,位置是唯一权威;
  注册序由类型定死,只显示。↑↓ 的 tooltip 也改成讲层序。
- **矢量场数据口径改对**:前三维=坐标 x/y/z(与圆柱/散点同一套归一化)、**一支箭头=相邻两条记录**
  (第 i 条起点、第 i+1 条按绝对/相对解释)、**第 4~7 维=颜色**(色相 0..256 色环 / 饱和 / 明度 / 不透明,
  全可选)。需求印**三个数**(需要几个数值维 / 需要几条记录 / 表里各有多少)——
  "记录不够"与"维数不够"在画面上同形,只有这三个数分得清。
- 支数由纯算术 `XChartVectorFieldMath.ArrowCount(记录数, 上限)` 算(N 条 ⇒ N−1 支,上限裁剪,<2 条 ⇒ 0)。
- **两端各自颜色**:杆用起点色、头用终点色(读两条记录各自的颜色维);沿杆逐顶点渐变留给 P18。
- 生成器 `螺旋矢量场` 改成 **7 维**(坐标 + 色相走满一圈 + 饱和/明度/不透明),自己补列。

判据:编译门三臂 + 3 对照绿;探针 **439** 项 0 失败(新增支数一族);
`p4_control` **57/57** 支臂各红在点名断言上(新增两支:一对不再花两条记录、空表不挡而直接进算术);
`p2` / `family` / `generator_gate` / `hierarchy_gate` 在同一棵交付树上复跑全绿。
过程记录:第一版给"一对不再花两条记录"点名的清单里放了一条**被更前面的守卫挡住、这支变异体碰不到**
的判据,`did not go red` 当场抓出来 ⇒ 按实测改清单,并给零/一条记录补了它自己那支变异体(§25.7)。
2026-10-25 21:01:53 +08:00
lrss3 c51ab7a3c8 XChart 图表框架落地(P0–P17):格线单一作者、面板一行状态、矢量场
此前整个 XChart 特性一直没有提交(分期 P0–P12 的代码与素材都还在工作区里)。这一批一并入库,
并含本轮 P13–P17 的改动(规范 Documentation/XChart-RenderFramework.md 新增 §22–§25):

- P13:格线只剩一个作者——线框工具不再有"画格线 / 发布格线插槽"的代码路径;BG Cube Grid(原 MeshBg)
  是唯一作者,且"画上去的线=发布给轴线的那份比例数组";插槽板新增 Unpublish(说得出"这里不再有线",
  否则掩码筛掉的面会把上一轮的值留着被消费者吸走);渲染参数搬进元素表
  (DeclareDefaultElements / AddDefaultElement + XChartElementTable 按类型去重,只在第一次读到表时补);
  图上「立方体外观」那组字段删除、公共属性转发到元素表;面板逐行点名脚本注册的工具。
- P14 / P15:数据窗口文案收敛(行末 `-`、标题 `X [0]`、长说明退回 tooltip、范围页三行不再被压扁);
  元素块收成一行状态 `▼ 名称 √ R… D… [↑][↓][-]`;**注册序由类型定死、只显示不给输入控件,
  绘制序与元素在表里的位置绑定**(§24.5,他 2026-10-25 澄清);默认元素让删也让关;
  EnsureSpace 改成每次重建后都跑(删掉"空间"不再等于整张图空掉)。
- P17:矢量场——维数不够时不再静默不画(元素配置报需求,面板与报表同时印"需求/现有");
  相对/绝对两种读法收进纯算术 XChartVectorFieldMath;连续绘制(互斥显示把"相对/绝对"藏起来);
  颜色维(色相走 0..256 色环,饱和/明度/不透明 0..1,不透明度不算硬需求);新增螺旋矢量场测试数据。
  数据口径按他澄清修正为:前三维=坐标、一支箭头=相邻两条记录、第 4~7 维是颜色(§25、CHANGELOG 修正行)。

判据:编译门三臂 + 3 支对照绿;离线探针 436 项 0 失败;p4_control 55 支臂各红在自己点名的断言上;
p2_control / pool_family / generator_gate / hierarchy_gate 在同一棵交付树上复跑。
(证据脚本与日志在包外的 .ximage-gate/,未入本仓库。)
2026-10-25 20:21:28 +08:00
lrss3 216d157472 XChart重构:共享数据模型快照、时间序列与多分辨率系列,伪3D散点图/雷达图接入共享数据 2026-08-31 08:29:42 +08:00
lrss3 48ef51d169 伪3d散点图 2026-08-21 14:07:38 +08:00
lrss3 5a28ab5c59 添加图表功能。 2026-08-21 11:52:08 +08:00