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=)。
This commit is contained in:
@@ -97,6 +97,7 @@ P17 口径修正(同日,听他澄清;规范 §24.5 与 §25 已按正确
|
||||
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` 同树复跑。**没做**:曲线渲染器的"矢量标签"(它自带的那个)还没接——现在箭头方向来自切线,标签要下一轮;观感照例归他现场判。
|
||||
P20 外部数据驱动访问(规范 §27,2026-10-26 他问"我能不能直接拿到圆柱渲染器,改属性就自动置脏"):**入口本来就有**(`ToolManager.FindTool<T>()`),缺的是第二半——9 个工具的参数全是裸自动属性,**写进去值在、画面不动**,必须再补一句 `MarkDirty()`(`XMeshPreviewChart.ApplyVolume` 手工补的那个样子)。落法:① `XChartToolBase` 新增 **`public abstract void MarkDirty()`**——不给基类空实现,因为空实现通过基类引用调用时**静默什么都不做**(参数改了、画面不动、报表看不出错,"零要说出它零在哪一层"那一族),抽象让编译器逼 9 个工具各自说清"我的脏位是哪个字段";7 个已有 `public void MarkDirty()` 的必须逐个补 `override`(少了就是 **CS0108 隐藏**:编译只出警告、基类调用失效),`ChartToolSpace` 没有独立脏位⇒转发 `MarkProjectionDirty()`(投影就是它唯一要重算的东西),`ChartToolScatterPoints` 只有 `MarkDataDirty()`⇒override 接 `m_PointsDirty`、旧名转发(同一字段两个名字)。② **132 个旋钮全部改成"设了就生效"**:`public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } }`(122 支走 `MarkDirty`,**10 支走 `SyncShapeParams`——这 10 支是门查出来的,不是我原本知道的**:散点外观早就自带生效路径,于是判据从"必须调 MarkDirty"改成"必须调到本文件里定义的 `MarkDirty` 或 `Sync*/Push*/Apply*/Rebuild*`")。③ `XChartBase` 加两个入口:`Tool<T>(toolName)`(`FindTool<T>` 的空安全简写,管理器还没建时答 null 而不是抛 NRE——"图里现在有没有这一类"是现场状态,调用方要问得出"没有")与 `Element<T>()`(走 `XChartElementTable.FirstOfKind`,与默认元素去重同一个答法)。④ **权威只有一处这件事写明**:外部写进工具的值会活到下一次 `ReapplyElements()`/`RebuildElements()`(面板动任一字段、增删/停用元素、脚本重载、进 Play、`ResetRender()`),那一次把配置整份重灌 ⇒ 外部的写被静默覆盖;要活得过重建就得写配置,而配置的公开写入口本轮**没开**(字段仍 private,面板走 `SerializedProperty`),列为下一步。判据:新门 `.ximage-gate/dirty_gate.py`——清单**两侧都数**(`TOOLS` 9 个 vs 磁盘 `ChartTool*.cs` 9 个,多一个少一个都红)、终态 `knobs=132 takesEffect=132 findings=0` 才算绿;另立两条同门判据:**D** 工具不许在 setter 之外给自己的旋钮赋值(那会在自己渲染的过程中把自己重新置脏 ⇒ 每帧重建),**E** 靠 `Sync` 生效的必须 `OnInitialize` 里也有那一句(否则 `if (IsInitialized) Sync()` 把初始化之前的写全丢);**七支变异各红在自己点名的那条**(M1 抹掉一个 setter 的 `MarkDirty()`、M2 拿掉 `override`、M3 新增一个裸自动属性、M4 工具自赋值、M5 把一个工具从路径上挪走、M6 `Sync` 调用改成不存在的名字、M7 从 `OnInitialize` 删掉那句 `Sync`)。**本轮自己的三处错都被门/编译门抓住(不是现场)**:批量改写脚本把字段行的**等号漏了**(`private float m_Radius 0.22f;`,121 处全中);判据把标识符里的字母当关键字(`Offset` 含 "set" ⇒ 只读的 `Offset` 被读成"从不置脏的 setter",改词边界 `\bset\b`);`{ get; private set; }` 没先归类成 views 时 D 支报出 **26 处**"自赋值"全是渲染器属性的初始化写盘(**分类之后真违规 0 处——写了判据才知道有没有**)。`ChartToolSpace.Rotation` 的初始化式跨两行,脚本按"同一行没闭合就拒绝整份文件"跳过整个文件、那 4 个旋钮手改(**拒绝写比写一半好**)。编译门 runtime+player+editor+3 对照 `GATE PASSED`(`chain_p20a.txt`/`chain_p20b.txt` rc=0);mono 数学探针本轮不重跑——改的全是 MonoBehaviour 侧工具的 setter,纯算文件一个没动。**覆盖不到**:画面观感归他现场判。
|
||||
P21 矢量场没渲染的根因与修法(规范 §28,2026-10-26 他报"矢量场现在没有在渲染"):**读数先从他自己的资产里取**——`SP_盾构机掘进姿态 Variant.prefab` 那份表是 x/y/z 三维、记录值量级 **−100..50**、三条以上记录,箭头元素 `m_Enabled=1 / VectorMode=Absolute / Continuous=0 / UseColorDimensions=0`,所以形状够(需要 3、现有 3,面板那句"一条都不画"不会亮),问题不在 §25.1 那一层而在**尺度**。根因:`ChartToolVectorArrows.ReadPoint` 把 `GetValueAt` 的**原始值直接当立方体单位**(±1=盒子边界)用 ⇒ 每支箭头被投到**一万多像素之外**:支数在算、面在提交、计数全对,画面上什么都没有;而散点与圆柱一直是"按各维显示范围折进盒子"(`TryResolveDomain` + `XChartBindingMath.TryNormalize`)——**只有箭头这一条路径没折**,同一件事两套口径,坏的那套不抛不报错、只是看不见(§22 格线双作者、§24.5 序号双口径的同族)。排除"P20 改坏"用的是 diff 形状:那次提交 33 增 17 删全在属性形状上、编译门绿、他 `Editor.log` 里这次导入只有一条无关的 `CS0414`。落法:① 纯算术新增 `XChartVectorFieldMath.TryCubePoint(x,y,z, minX..maxZ, out cube)`(每维按自己的范围映到 [-1,1];**任何一维折不出来——跨度 ≤0、值或端点非有限——就整体拒答**,因为半归一化的坐标比不归一化的更难查,它会画出"看着像个箭头、方向却不对"的东西;折法进纯算术才离线钉得住);② 工具**每帧现问**三条轴的范围(范围不归元素存,与散点同规矩),读点改 `TryReadPoint`,读不出的点计入 `skipped=` 而不是静默少画;③ 报表加 `dom=x[..] y[..] z[..]` 与 `skipped=`,**折不出来印 `dom=-` 且一支都不画**——"为什么没有"当场说话(他那份表应印 `dom=x[-100..50] …`、`arrows=记录数−1`)。判据:探针 **458** 项 0 失败(新增 8 条 `vector field cube:`:域两端落 ±1、域中落 0、他那种量级的记录折进盒子内、**域外保持成比例而不是被夹住**(夹住=把数据改了)、零跨度拒答、非有限拒答、坏一轴整体拒答——全是性质判据,不写手算中间值)+ `p4_control` 新增 **3** 支臂(不折 / 坏一轴也照答 / 偷偷 `Clamp`)各红在点名断言上 + `dirty_gate` 新增 **claim F**(箭头这条路径的坐标必须经 `TryCubePoint`,原始值直接进 `new Vector3(` 就红;只挂这个文件,因为它判的是"形状对、画面空"这一类)并配变异 **M8_rawcoord**——**八支全红**、正本 `knobs=132 takesEffect=132 findings=0`;编译门三臂 + 3 对照绿(`chain_p21.txt rc=0`)。**两条判据自身的错记档**:① M8 第一版是**绿的**——不是判据弱,是 claim F 用来认文件的参数被 claim C 的 `for name in names` 重新绑定了(`judge(lines, name)` 里 `name` 既是文件名又当旋钮名,循环跑完它就等于最后一个旋钮名 ⇒ F 支永远不执行),**"臂能不能红"第一次是靠它自己抓到的** ⇒ 规矩:给"按文件生效的判据"传参,参数名不许与函数体内循环变量同名(这次改成 `source`);② 门脚本声明 `coding: ascii`,中文写进注释就直接 `SyntaxError`(中文只进仓内文档,不进脚本)。**留给现场/下一轮、没偷改的两条**:他这串姿态点的正确读法是 `Relative`(首尾相接=轨迹方向,`Absolute` 是给"点一行、方向一行"分开存的表用的);`XMeshPreviewChart` 的示例数据仍是**旧的"一条记录 6 维"口径**(方向存第 4~6 维),新口径下那三列是**死数据**,画出来的是"每条记录位置 → 0.25×下一条记录位置"——重造那份 demo 之前要先确认它还想不想同时喂散点元素(一对记录里的第二条也会成为一个点)。
|
||||
P22 箭头改走"线 + 库的原生标记"(规范 §29,2026-10-26 他纠正:"箭头为何用的是填充?我不是给你提供了曲线,曲线渲染器里面带标记就可以直接显示箭头,你还可以调节箭头在曲线上的位置"):**根因是一次"猜对了来源"没被复盘**——P18 我读不到库那个包(被拦过一次)就照自己代码里的调用点猜 API,`AddCurve`/`CurveCacheEntry` 猜对了,于是没再回头把那个包读一遍,它旁边的 `ArrowHeadData` 我一直不知道存在,就自己用填充四边形拼了杆和头;包其实就在工作区隔壁(`com.lrss3.deconstruction`),API 一直写在 `Release/Runtime/Generation/Curve/CurveRenderDataTypes.cs`。⇒ 规矩:**照着调用点猜出来能跑之后,要把那个来源补读一遍**,"我猜对了"证明不了"我看见全了"。落法:① 杆=一条**共线**三次贝塞尔(新纯算术 `XChartArrowPathMath.Straight`:内控制点落在 1/3、2/3),宽度=`ShaftWidth`、起止色就是沿杆渐变(P18 那个效果原来是条目的原生能力);② 头=曲线渲染器原生标记 `ArrowHeadData`(`width`=头长沿切线、`height`=头宽垂直切线、`depthCompensation=+1`=**头尖对准那个数据点**);③ 连续绘制的头挂在 `ResolvePosition` 算出的那一节上、`progress`=节内参数,**路径不再剪断**——"必须剪否则线穿箭头"是我上一版自己加的,库的标记本来就叠在线上,于是 `Split` 没有调用方、随四角绕序那套(`XChartArrowGeometry` 整个类)一起删;④ 零向量画 `Circle` 标记(开关关掉就整条不画,计入 `skipped=`);⑤ **曲线渲染器不在位 ⇒ `path=none` 一支都不画**,不再有"退回填充画法"那第二条路(两套画法=两套口径,这次的 bug 恰恰长在第二条路上)。`AddFaceLinear`/`XChartFaceFillKind.Linear` **留着**:那是填充渲染器自己的上色模式(预算 `VerticesPerFace(Linear)==4` 与判据都在),别的元素要渐变填充时不必再写第二套。**另一面要说清**: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 的那一跳**,不是数据形状也不是顶点预算。箭头不再经过那一跳,所以箭头上屏了而**网格背景/圆柱填充若也看不见就是同一坏点未除**,那一跳本轮没修(绕过去不等于修好)。**顺手抓到一条会撒谎的读数**:同一行 `curves=0` 却 `curveVerts=66`,而圆柱那一行也印 66 ⇒ `UICurveRenderer.LiveVertexCount` 不是本实例自己的数,只能当"库里一共活着多少顶点"读,看自己那份要读 `curves=`/`markers=`(已立待办)。判据:探针 **452** 项 0 失败(删 13 条判"四边形角点/剪开再接回"的——**被测对象已不存在,留着就是假绿**;新增 7 条:标记两尺寸对号入座、头尖对点 vs 圆点居中、`progress` 夹进 [0,1]、NaN 位置落到末端而不是"位置未知"、0 尺寸兜底、`Straight` 每个采样都落在那条直线上、切线方向与矢量平行)+ `p4_control` **65** 支(删 2 支靶子随代码没了、新增 3 支:两尺寸互换 / `progress` 不夹 / 头尖不对点,各红在点名断言上)+ `dirty_gate` 正本 `knobs=132 takesEffect=132 findings=0`、八支变异全红(claim F 判"坐标必须经 `TryCubePoint`",改写后仍判得住)+ 编译门三臂 + 3 对照绿(`chain_p22.txt`)。**门自己的一次改动**:`run_gate` 原先把 rsp 里列出的每个源文件都喂给 csc,删掉一个源文件后那份快照还列着它 ⇒ `CS2001 找不到源文件`,整道门红得像"产品编译不过";现在它跳过"工作区里已不存在的包内源文件"并**逐个点名印出来**(判决要说清它判的是哪棵树)——这不是吞错:CS2001 说的是"快照过期",Unity 重导入会自己重生成 rsp。
|
||||
|
||||
## [0.1.6] - 2026-07-01
|
||||
|
||||
|
||||
Reference in New Issue
Block a user