diff --git a/CHANGELOG.md b/CHANGELOG.md index a205006..e086451 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -95,6 +95,7 @@ P15 界面:元素块收成一行状态 + 默认元素让删(规范 §24,20 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` 同树复跑。**没做**:曲线渲染器的"矢量标签"(它自带的那个)还没接——现在箭头方向来自切线,标签要下一轮;观感照例归他现场判。 +P20 外部数据驱动访问(规范 §27,2026-10-26 他问"我能不能直接拿到圆柱渲染器,改属性就自动置脏"):**入口本来就有**(`ToolManager.FindTool()`),缺的是第二半——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(toolName)`(`FindTool` 的空安全简写,管理器还没建时答 null 而不是抛 NRE——"图里现在有没有这一类"是现场状态,调用方要问得出"没有")与 `Element()`(走 `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,纯算文件一个没动。**覆盖不到**:画面观感归他现场判。 ## [0.1.6] - 2026-07-01 diff --git a/Documentation/XChart-RenderFramework.md b/Documentation/XChart-RenderFramework.md index 049d4b7..13dffe8 100644 --- a/Documentation/XChart-RenderFramework.md +++ b/Documentation/XChart-RenderFramework.md @@ -1780,10 +1780,88 @@ UI Toolkit 里 `flexShrink` 默认为 1,窗口矮了,被压扁的就是**最 3. 勾 `连续绘制`:`相对/绝对`那一项**消失**,图上变成一条折线(末端一个箭头);取消勾选 ⇒ 回来。 4. 打开颜色维:颜色取自色环;起点色与终点色不同时沿杆渐变(见 25.2 的颜色归属)。 -### 25.9 还没做的(如实点名) +### 25.9 还没做的(如实点名)——**本小节的两条已被 26 节做掉** -- **曲线渲染器**:现在是直线段(他给的默认)。库里那个带矢量标签的曲线渲染器 + "箭头位置可调" - 排下一轮(`UICurveRenderer`,注意 §10.4:整条一次提交,别逐段 `DrawLine`)。 -- **两端各自颜色**的渲染侧支持:**现在杆用起点色、头用终点色**(读第 i 与第 i+1 两条记录各自的颜色维) - ⇒ 两条记录颜色不同时,一支箭头上就能看到两种颜色。真正的"沿杆逐顶点渐变"要等填充渲染器支持 - 逐顶点双色(P18,模板已有"径向渐变"那一档可参照)。 +- ~~曲线渲染器:现在是直线段~~ ⇒ **26.2 已走 `UICurveRenderer`**(贝塞尔细分,接缝不断口)。 + 还没上的只有它自带的**矢量标签**(P19:要么放行读 `com.lrss3.deconstruction`,要么他给成员清单)。 +- ~~两端各自颜色要等逐顶点双色~~ ⇒ **26.1 已有线性那一档**(`AddFaceLinear`:00/10 起点色、01/11 终点色), + 所以一支箭头的杆真的沿杆渐变。 + +## 27. P20:外部数据驱动访问("我能不能直接拿到圆柱渲染器,改属性就自己更新",2026-10-26) + +### 27.1 他要的形态(原话) + +> 我是否有方法可以直接 GetChartComponent<Cylinder> 去获取这个圆柱体渲染器。并且访问里面的所有属性字段, +> 然后设置的同时,属性就会自动完成脏标记,这样就能完成渲染组件更新了。 + +本轮之前只有第一半有:入口早就在(`chart.ToolManager.FindTool()`,`XChartToolsManager.cs:257`), +第二半没有——工具的参数全是裸自动属性,**写进去值在、画面不动**,必须再补一句 `MarkDirty()` +(`XMeshPreviewChart.ApplyVolume` 就是手工补的那个样子)。 + +### 27.2 三条入口,各管一件事 + +| 要改的东西 | 入口 | 怎么生效 | +| --- | --- | --- | +| 数据(记录、维、范围覆盖) | `chart.DataModel` / `chart.DataSource` | 版本自增,下一帧自己刷(一直是自动的) | +| **渲染元素的参数** | `chart.Tool()`、`chart.Space` | **setter 自己置脏**,下一帧重算几何 | +| 元素的结构与作者数据 | `chart.Elements` / `chart.Element()` | 改完要 `ReapplyElements()` / `RebuildElements()` | + +`Tool()` 是 `ToolManager.FindTool()` 的空安全简写(管理器还没建时答 null 而不是抛 NRE—— +"图里现在有没有这一类"是现场状态,调用方要问得出"没有")。同类多条按名字点: +`chart.Tool("Axis 2")`,名字就是 `ElementNameFor(i)` 那一个。 + +### 27.3 权威只有一处:配置是作者数据,工具是它的投影 + +外部写进**工具**的值,会活到下一次 `ReapplyElements()` / `RebuildElements()`——那一次把配置整份重灌进工具 +(面板动任何一个字段、增删/停用元素、脚本重载、进 Play、`ResetRender()` 都走这条路), +于是外部的写被**静默覆盖**。这不是缺陷,是"两处存同一件事"那一族的取舍: + +- 只要求这一帧看起来对 ⇒ 写工具(本轮就是为这条把 setter 做成自动置脏的)。 +- 要活得过重建 ⇒ 写配置;配置的公开写入口还没开(27.6),现在写它得走 `SerializedProperty`。 +- 反向那条(把元素当前状态收回配置)叫 `CaptureFrom`,只有 scatter / cubewire / meshbg / space 四个配置实现了, + 且按设计只给编辑器"拾取"用,运行时不接。 + +### 27.4 `MarkDirty()` 为什么是 abstract,而不是基类给个空实现 + +空实现的 `MarkDirty()` 通过基类引用调用时**静默什么都不做**——参数改了、值也进去了、画面不动、报表也看不出错 +("零要说出它零在哪一层"那一族)。抽象把这件事交给编译器:**9 个工具必须各自说清"我的脏位是哪个字段"**。 +同族还有一种只出警告的错法:派生类写 `public void MarkDirty()`(少一个 `override`)= CS0108 隐藏, +编译过、基类调用失效——`dirty_gate.py` 专门有一支变异管这个。 + +### 27.5 判据(离线,源码门)与它到底判了什么 + +工具要建 GameObject,engine 的 mono 造不出它们,所以**运行时探针够不着 setter**——能离线判的是声明清单的形状, +而形状恰恰就是这句主张的形状("设了属性,渲染器就更新")。`.ximage-gate/dirty_gate.py`: + +- 清单**两侧都数**:`TOOLS` 里点名的 9 个文件 vs 磁盘上 `Runtime/XChart/**/ChartTool*.cs`,多一个少一个都红(M5)。 +- 每个**外部可写**属性必须落在一条生效路径上:`MarkDirty(`,或本文件里定义了名字的 `Sync*/Push*/Apply*/Rebuild*(`。 + 读数:`knobs=132 takesEffect=132`——122 支走 `MarkDirty`,**10 支走 `SyncShapeParams`(这 10 支是门查出来的, + 不是我原本知道的:散点外观那 10 个早就自带生效路径,于是判据从"必须调 MarkDirty"改成"必须调到本文件定义的生效方法")**。 +- 另外两条同门判据: + **D** 工具不许在 setter 之外给自己的旋钮赋值(那会在自己渲染的过程中把自己重新置脏 ⇒ 每帧重建); + **E** 靠 `Sync` 生效的,`OnInitialize` 里也必须有那一句——否则 `if (IsInitialized) Sync()` 把初始化之前的写全丢掉。 +- `{ get; private set; }` 归 **views**(只读投影,不是旋钮)。这一条不分类的话第一轮报出 26 处"自赋值", + 全是 `FillRenderer = CreateChildComponent…` 这种初始化写盘——**分类之后真违规 0 处**(写了判据才知道有没有)。 +- 七支变异各红在自己点名的那条:M1 抹掉一个 setter 的 `MarkDirty()`、M2 拿掉 `override`、M3 新增一个裸自动属性、 + M4 工具自赋值、M5 把一个工具从路径上挪走、M6 `SyncShapeParams()` 写成不存在的名字、M7 从 `OnInitialize` 删掉那句 `Sync`。 + +本轮自己的两处错,都是被门/编译门抓住的(不是现场):批量改写脚本**把字段行的等号漏了** +(`private float m_Radius 0.22f;`,121 处全中——形状判据"这种形状的行了 0"+编译门各报一次); +判据把标识符里的字母当关键字(`Offset` 含 "set" ⇒ 只读的 `Offset` 被读成"有个从不置脏的 setter"),改词边界 `\bset\b`。 +编译门:runtime + player + editor + 3 支对照 `GATE PASSED`(`chain_p20b.txt rc=0`)。 + +### 27.6 覆盖不到什么 / 还没做的 + +- 画面观感归他现场判(§13.2)。 +- **配置那一层还没有公开写入口**:`Element()` 拿到的实例,字段仍是 `private`(面板走 `SerializedProperty`, + 本来不需要公开属性)。要"从代码写配置、并且活得过重建",下一步给配置开属性 + 写完自动 push—— + 否则那又是一条"改了没反应"。 +- 外部写工具 vs 配置重灌的冲突,现在只在文档里说明,机器侧不响。要收紧就是: + 面板保存前把工具当前值与配置值对一遍并印出差值。 + +### 27.7 他侧验收(Ctrl+R 后) + +1. 代码里 `var cyl = chart.Tool(); cyl.Radius = 0.4f;` —— 不动面板、不点刷新,下一帧圆柱变粗。 +2. `chart.Space.HalfEdge = 260f;` —— 整张图的尺度跟着走(空间的脏就是投影脏,其余工具靠 `ProjectionVersion` 跟着重算)。 +3. `chart.DataModel.TryAddRecord(t, values)` —— 和以前一样;数据这条路一直是自动的。 +4. 做完第 1 条后去面板动**任意**一个元素字段 ⇒ 圆柱回到配置里的值。这就是 27.3 说的覆盖,属预期,不是回归。 diff --git a/Runtime/XChart/XChartBase.cs b/Runtime/XChart/XChartBase.cs index b5c2115..3eac1d8 100644 --- a/Runtime/XChart/XChartBase.cs +++ b/Runtime/XChart/XChartBase.cs @@ -458,6 +458,16 @@ namespace XericUI.XChart public void RemoveAllTools() => ToolManager?.RemoveAllTools(); + /// + /// 按类型取已加载的元素实例(同类多条时用 点名,名字见 + /// )。没初始化、没找到都答 null——不抛,因为"图里现在有没有这一类" + /// 是现场状态,调用方要能问出"没有"这个答案。 + /// + /// 取到之后直接写它的公开旋钮就行:每个 setter 自己置脏(规范 §27),不用补 MarkDirty()。 + /// + public T Tool(string toolName = null) where T : XChartToolBase + => ToolManager != null ? ToolManager.FindTool(toolName) : null; + // ── 元素(配置路径) ────────────────────────────────────── /// 元素配置表([SerializeReference],Inspector 里逐项展开自己类型的字段) @@ -466,6 +476,14 @@ namespace XericUI.XChart /// 当前已加载的元素实例(与配置表同序、只含启用的项) public IReadOnlyList ElementTools => m_ElementTools; + /// + /// 按类型取表里第一份这一类的配置,没有则 null。 + /// "哪一条是这一类"只许有这一个答法(与 同源), + /// 面板、默认元素去重、外部写配置都读这一条。 + /// + public T Element() where T : XChartElementConfig + => XChartElementTable.FirstOfKind(m_Elements, typeof(T)) as T; + private readonly List m_ElementTools = new List(); ///