XChart P20d:外部访问的两条入口补上(Tool<T>/Element<T>),权威分工写进规范 §27
他问的是"能不能直接拿到圆柱渲染器,改属性就自动更新"。答案分两半: **入口早就有**(`chart.ToolManager.FindTool<ChartToolCylinder>()`),**自动置脏这半没有**—— 第二半已由前两笔补齐(P20a 抽象脏位协议、P20b 132 个旋钮全部设了就生效)。 这一笔补第一半的手感,并把"谁覆盖谁"这件事写成文字。 - `XChartBase.Tool<T>(toolName = null)`:`FindTool<T>` 的空安全简写。 为什么不直接让他写 `ToolManager.FindTool<T>()`——工具管理器还没建时那句抛 NRE, 而"图里现在有没有这一类"是现场状态,调用方要问得出"没有"这个答案(答 null,不抛)。 同类多条按名字点,名字就是 `ElementNameFor(i)` 那一个(面板上元素行印的也是它)。 - `XChartBase.Element<T>()`:按类型取表里第一份配置,走 `XChartElementTable.FirstOfKind`—— "哪一条是这一类"只许有这一个答法(默认元素去重、面板、外部读配置共用)。 规范 §27 里最要紧的是 **27.3 那条会咬人的分工**:配置是作者数据、工具是它的投影。 外部写进工具的值活到下一次 `ReapplyElements()` / `RebuildElements()`(面板动任一字段、 增删/停用元素、脚本重载、进 Play、`ResetRender()` 都走这条),那一次把配置整份重灌进工具 ⇒ 外部的写被静默覆盖。要活得过重建就得写配置,而**配置的公开写入口这一轮没开**(字段仍是 private;面板走 SerializedProperty 本来就不需要公开属性)——这条如实记在 27.6,是下一步。 顺手把 §25.9 那两条"还没做的"改成已被 §26 做掉(旧话写着"现在还是直线段""等逐顶点双色", 而这两条本轮之前就已经实现了)——对外文档按最新实现校准,不留过期主张。 判据:新源码门 dirty_gate.py(P20b 那笔已交)终态 knobs=132 takesEffect=132 findings=0、 七支变异各红在自己点名的断言上;本笔改的是 `XChartBase`(不在门覆盖里), 由离线编译门覆盖:runtime + player + editor + 3 支对照 GATE PASSED,chain_p20d.txt rc=0。 CHANGELOG 补 P20 一行。观感归他现场判(Ctrl+R 后的验收四条写在 27.7)。
This commit is contained in:
@@ -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<ChartToolCylinder>()`,`XChartToolsManager.cs:257`),
|
||||
第二半没有——工具的参数全是裸自动属性,**写进去值在、画面不动**,必须再补一句 `MarkDirty()`
|
||||
(`XMeshPreviewChart.ApplyVolume` 就是手工补的那个样子)。
|
||||
|
||||
### 27.2 三条入口,各管一件事
|
||||
|
||||
| 要改的东西 | 入口 | 怎么生效 |
|
||||
| --- | --- | --- |
|
||||
| 数据(记录、维、范围覆盖) | `chart.DataModel` / `chart.DataSource` | 版本自增,下一帧自己刷(一直是自动的) |
|
||||
| **渲染元素的参数** | `chart.Tool<ChartToolCylinder>()`、`chart.Space` | **setter 自己置脏**,下一帧重算几何 |
|
||||
| 元素的结构与作者数据 | `chart.Elements` / `chart.Element<T>()` | 改完要 `ReapplyElements()` / `RebuildElements()` |
|
||||
|
||||
`Tool<T>()` 是 `ToolManager.FindTool<T>()` 的空安全简写(管理器还没建时答 null 而不是抛 NRE——
|
||||
"图里现在有没有这一类"是现场状态,调用方要问得出"没有")。同类多条按名字点:
|
||||
`chart.Tool<XChartToolBase>("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<T>()` 拿到的实例,字段仍是 `private`(面板走 `SerializedProperty`,
|
||||
本来不需要公开属性)。要"从代码写配置、并且活得过重建",下一步给配置开属性 + 写完自动 push——
|
||||
否则那又是一条"改了没反应"。
|
||||
- 外部写工具 vs 配置重灌的冲突,现在只在文档里说明,机器侧不响。要收紧就是:
|
||||
面板保存前把工具当前值与配置值对一遍并印出差值。
|
||||
|
||||
### 27.7 他侧验收(Ctrl+R 后)
|
||||
|
||||
1. 代码里 `var cyl = chart.Tool<ChartToolCylinder>(); cyl.Radius = 0.4f;` —— 不动面板、不点刷新,下一帧圆柱变粗。
|
||||
2. `chart.Space.HalfEdge = 260f;` —— 整张图的尺度跟着走(空间的脏就是投影脏,其余工具靠 `ProjectionVersion` 跟着重算)。
|
||||
3. `chart.DataModel.TryAddRecord(t, values)` —— 和以前一样;数据这条路一直是自动的。
|
||||
4. 做完第 1 条后去面板动**任意**一个元素字段 ⇒ 圆柱回到配置里的值。这就是 27.3 说的覆盖,属预期,不是回归。
|
||||
|
||||
Reference in New Issue
Block a user