Commit Graph
4 Commits
Author SHA1 Message Date
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
lrss3 cb759fe583 XChart P21:矢量场没渲染的根因是箭头把数据值当立方体单位用了——现在它也折进盒子
他报"矢量场现在没有在渲染"。我先从他自己的资产里取状态,不猜:
SP_盾构机掘进姿态 Variant.prefab 里那份表是 x/y/z 三个数值维、记录值量级 -100..50(三条以上),
箭头元素 m_Enabled=1、VectorMode=Absolute、Continuous=0、UseColorDimensions=0、MaxArrowCount=512。
⇒ 形状是够的(需要 3、现有 3,面板那句"一条都不画"不会亮),问题在**尺度**。

根因(我这边的缺陷,不是 P20 改坏的):ChartToolVectorArrows.ReadPoint 把 GetValueAt 的原始值
**直接当立方体单位**(±1=盒子边界)用,一份 -100..50 的表就把每支箭头投到一万多像素之外——
支数在算、面在提交、画面什么都没有。散点与圆柱一直是"按各维显示范围折进盒子"
(context.TryResolveDomain + XChartBindingMath.TryNormalize),只有箭头这一条路径漏了:
同一件事两套口径,坏的那一套不报错,只是看不见。P20 那次提交 33/17 行全在属性形状上,
他的 Editor.log 里这次导入只有一条无关的 CS0414,也排除了"是我刚改坏的"。

修法:
- 纯算术新增 XChartVectorFieldMath.TryCubePoint(x,y,z, minX..maxZ, out cube):每一维按自己的范围
  映到 [-1,1];**任何一维折不出来(跨度 ≤0、值或端点非有限)就整体拒答**——半归一化的坐标比不
  归一化的更难查,它会画出"看着像个箭头但方向不对"的东西。折法放纯算术里才离线钉得住。
- 工具每帧现问三条轴的范围(范围不归元素存,与散点同一条规矩);读点改 TryReadPoint,
  读不出来的点计入 skipped=,不静默少画。
- 报表多了两个读数:dom=x[..] y[..] z[..](折不出来印 dom=-,那时一支都不画,原因当场可见)、
  skipped=。他那份表应当印出 dom=x[-100..50] ... 且 arrows=记录数-1。

判据:探针 458 项 0 失败(新增 8 条 vector field cube:域两端落 ±1、域中落 0、他表里那种量级的
记录 (-93.5, 10.1, 49.0) 在给定域下折进盒子内、域外**保持成比例而不是被夹住**、零跨度拒答、非有限拒答、坏一轴整体拒答);
p4_control 新增 3 支臂(不折、坏一轴也答、偷偷夹住)各红在自己点名的断言上(分别 5/3/1 条),
全套 64 支 CONTROL PASSED:"arms 0-63 of 64 went red on their named assertions";
dirty_gate 新增 claim F(箭头的坐标必须经 TryCubePoint;原始值直接进 Vector3 就红)并配一支变异 M8,
**八支全红**、正本 knobs=132 takesEffect=132 findings=0;编译门 runtime+player+editor+3 对照
GATE PASSED(chain_p21.txt)。

一条"判据的判据"本轮现形:M8 第一版**是绿的**——不是判据太弱,是 claim F 用来认文件的参数
被 claim C 的 `for name in names` 循环重新绑定了(judge(lines, name) 里 name 既是文件名又当旋钮名,
循环跑完它就变成最后一个旋钮的名字 ⇒ F 支永远不执行)。"臂能红"这件事第一次是靠它自己抓到的:
不红 ⇒ 追下去 ⇒ 抓到参数遮蔽。规矩:给"按文件生效的判据"传参,参数名不许与函数体内的循环变量同名
(这次改成 source)。另记一条 py2 的:门脚本声明 coding: ascii,我把中文写进注释就直接
SyntaxError(中文只进仓内文档,不进脚本)。

如实留给现场/下一轮的两条,我没偷改:
① Absolute 下"方向=下一条记录的坐标",他那串姿态点用 **Relative** 才对(首尾相接=轨迹方向);
② XMeshPreviewChart 的示例数据还是**旧的"一条记录 6 维"口径**(方向存第 4~6 维),
   新口径下那三列是死数据——要按"相邻两条"重造那份 demo,得先确认它还想不想同时喂散点元素。
2026-10-26 10:17:37 +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