diff --git a/CHANGELOG.md b/CHANGELOG.md index f877802..8fafc65 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -107,6 +107,7 @@ P29 方向的单位="差折法"(只缩不移位)+ 四档方向来源到底 注册路径根改名:`Xeric Library` → `XericLibrary`(2026-10-26 他点名两处"`Table/Table Editor OverrideLayer`"和"`UI/Image/场景变形手柄`"的族前缀带了空格):他在两个具体组件上看到的只是症状,根因在唯一那份总表——`XericRegistrationPaths.Root`(`Runtime/Core/XericRegistrationPaths.cs`)写的是带空格的 `"Xeric Library"`,而**所有族常量都是它拼出来的**(Chart/Table/UI/Layout/Form/翻页/…),所以改了根就一次性把整个包的菜单与组件路径统一成 `XericLibrary/...`。改动是**一个常量加一行注释**,不散落:全仓 `grep "Xeric Library"` 只剩两处**散文**(ObjectVessel 里指向 Wiki 的原名、以及新注释里引用旧写法),没有一处活的路径字面量;也确认没有 `EditorApplication.ExecuteMenuItem("Xeric Library/...")` 这类按字符串找回菜单的地方。安全性:`AddComponentMenu`/`MenuItem` 的路径不入场景、不入预制(只影响菜单显示),所以这次改名不会动他的资产;**代价是旧的菜单路径没了**——他若把某个子菜单拖进过快捷栏/记过路径,需要按新根重找一次。编译门三臂 + 3 对照绿(`chain_paths.txt`)。 P29b 方向来源删到三档 + 资产值迁移(规范 §33.4,2026-11-08 他从三个选项里选了"删 0 号、值迁到 NextRecordAsPoint"):**序号 1/2/3 不许改**——资产存的就是这些数(`m_DirectionSource`),换序号就是换含义,所以 0 号只能空着,只有值迁移(选项 ② 被排除正是这个原因:它会把存着的 0 读成另一档)。默认值两处跟着改(`ChartToolVectorArrows` 与 `XChartVolumeConfigs`),但默认只管新建的元素,他预制里那个 0 不靠默认值救,靠迁移。迁移脚本 `.ximage-gate/migrate_direction_source.py`:扫工程 Assets 下的 .prefab/.unity,两种字段名都认(现名 `m_DirectionSource` 和 `[FormerlySerializedAs]` 的旧名 `m_VectorMode`),**先落备份再写,判决读回文件而不是信改写**——期望行 `m_DirectionSource: 1` 真出现才算通过,残留 0 就红。两份日志正好是一对:迁移前 `--check` 红(1 条,退出 1)→ 迁移后 `--check` 绿(0 条,退出 0),被改的就是 `SP_盾构机掘进姿态 Variant.prefab` 第 703 行;画面要重导入才变(改的是 YAML 本体)。**限制说清楚**:只扫了他当前工程的 Assets(1 处);别的项目/备份里存 0 的不会报错,它靠 `switch` 的 `default` 那一支跑,画出来的正是被删掉的那个含义,而面板下拉里已经没有这一项,所以 Inspector 上会显示成对不上号的值。判据跟着改:探针 **473** 照旧 0 失败("方向是矢量本身"那条从 0 号档改打在 `AlternatingRecords`、"点到点作差"照打 `NextRecordAsPoint`——两条还能在同一份数据上分开,所以覆盖没少)+ `p4_control` **73** 支照旧各红在点名断言(那支改名 "point-to-point reuses the carries-direction rule",**期望断言标签同步改**,否则臂红了却没人认它的断言)+ `dirty_gate` `knobs=136 takesEffect=136 findings=0` + 编译门三臂 + 3 对照绿。 合并他那 17 条 ShaderBake 提交(gitea/thr_dev/dev2,2026-11-05/06)到 thr_dev/dev_chart(`ae992c6`,已推):两条线从 a311c41 分叉,文件集只共用 `XericRegistrationPaths.cs`,他那侧只新增 `ToolBar` 常量、两套根都保住(工具栏 `XericLibrary/Action Vessel`、右键 `Xeric Library/Action Vessel`),入口走常量没有硬编码 ⇒ 无冲突。**门先整轮红在环境不是代码**:rsp 记录的引擎 `U:/UNITY_Engine/editor/2022.1.24f1` 已经不在(U: 上那版只剩安装包),同版本在 `G:/Unity_EngineFlie/Unity 2022.1.24f1`;给 `run_gate.py` 加"引用按引擎根重映射 + 逐臂计数 + 开头点名读的是哪个引擎根"(211 条引用全部能在那边解析),`probe_run.py` 的 mono 路径同规则。重跑三臂 + 3 对照绿,并且正向确认 ShaderBake 的 **11 runtime + 8 editor** 文件真进了被编译的清单——rsp 是快照,新文件靠 `scan_dir` 补,不补就会"绿着跳过"它们。 +P25/P23 填充改由一个 Graphic 自己画完(规范 §34,2026-11-08 他定形状:"填充不需要额外的渲染脚本,自己写一个简单的就够了"):形状上把分块那套(`FaceChunk`/`EnsureChunkCount`/子物体/`MaxChunkVertices`)全部拿掉,一个 `MaskableGraphic` 自己填,不再依赖库的分块填充渲染器(库那侧的分块照旧,只有这一份实现改了)。② **顶点上限只能前缀取舍**:一个 Graphic 65535 顶点 ⇒ 装不下的只能整段放弃且不许重排(画家顺序就是提交顺序,跳着画会画出"数据里不存在"的拼接),被放弃的面由报表 `fillRefused=` 报出来而不是静默少画;`XChartMeshBudget.VerticesPerFace`(Radial 5 / Flat·Linear 4)**一处定义、守卫与写网格两边共用**——否则守卫按 4 判、写手按 5 画,报出来的 refused 数就不等于画面上的缺。③ **P23"发了但不上屏"的根因读源码而不是靠记忆**(`com.unity.ugui@1.0.0/Runtime/UI/Core/Graphic.cs`):17-18 行属性只有 `DisallowMultipleComponent` + `RequireComponent(RectTransform)`,**没有 CanvasRenderer**;640 行 `Rebuild` 第一句 `if (canvasRenderer == null || canvasRenderer.cull) return`;453-467 行的 `canvasRenderer` **是 getter,读到时会 `AddComponent`**(所以读它等于写应用状态)⇒ 我们运行时造的子物体只带 RectTransform,网格填满了、提交发生了、什么也没画、也不报错;库里那三个基类都带这个属性,**这正是散点/折线/曲线/箭头能上屏而填充不能的那条差**。两处修:类上补 `[RequireComponent(typeof(CanvasRenderer))]`,`CreateChild`(工具子物体的唯一出处)把两个组件写全;`OnPopulateMesh` 开头补 `vh.Clear()`(`DoMeshGeneration` 只在坏矩形那一支清,共享的 `s_VertexHelper` 不归子类清)。④ **四个读数各判一层**:`fillPlan=`(Apply 时算)、`fillShipped=`(真写进 VertexHelper 的)、`fillRefused=`(被上限挤出去的)、`fillCr=`(用 `GetComponent()` 判,不用那个会 AddComponent 的 getter,否则永远答 yes)。判据:新门 `fill_gate.py`(7 支,主张是"类带属性/CreateChild 写全/渲染器里没有嵌套 Graphic、没有运行时 GameObject、没有 AddComponent/上限被真正使用且只画接受的前缀/`VerticesPerFace` 是唯一那张表/报表印四个键且 presence 走 GetComponent"),正本 0 findings + 7 支全红 + 编译门三臂绿;探针 **474** 项 0 失败(6 条打在性质上:接受的面永远不超上限、真的有一面被拒、接受的是最大前缀所以画家顺序没被打乱、装得下的整批全收、单面超上限则整批全拒、0 面则两头都 0),`p4_control` **73** 支照旧各红在点名断言(第 26 支重挂"从不查上限、每面都收=会撞 65535"),`dirty_gate` `knobs=136 takesEffect=136 findings=0`。三次被门/自己抓到的记录:① `fill_gate` 基线假红——属性正则要求它在第 0 列;② 臂 F4 绿着——主张 D 把 `Apply()` 里的计数循环也当成了"画前缀",正确处置是**把判据收窄到真提交顶点的那个方法体**,不是放宽正则;③ 探针在第 26 支上**先死再判**(断言的明细值 `counts[accepted]` 越界,打印的是"NO VERDICT LINE (the probe died before judging)")——仪器死掉的"红"不是判决,明细值必须自证安全。**覆盖不到**:Canvas 收 CanvasRenderer 那一跳在引擎内部,离线门只能判形状与读数;上屏归他 Ctrl+R 判——报表 `fillCr=yes`、`fillShipped>0`、超大数据上 `fillRefused>0`(而不是抛异常)就是这一笔该给的样子;若那三个数都对而画面仍空,§34.3 就不是全部故事。 ## [0.1.6] - 2026-07-01 diff --git a/Documentation/XChart-ExternalAPI.md b/Documentation/XChart-ExternalAPI.md index fab1685..29868ca 100644 --- a/Documentation/XChart-ExternalAPI.md +++ b/Documentation/XChart-ExternalAPI.md @@ -183,12 +183,13 @@ chart.Space.CenterOffset = new Vector2(0, 40f); 3. **元素靠类型去重**:`AddDefaultElement` 同类型只补一份;真要两份(两条轴)就 `AddElement` 并让名字不同名(面板会自动加序号,配对按 `ElementNameFor`)。 4. **"图里一定有一个空间工具"是不变量**:删掉/停用空间元素会被补回默认(删掉它≠图没了),要拿回旋钮就重新 Add 一条。 5. **箭头/圆柱的数据驱动模式要"几条记录凑一个图元"**:`GroupSize`(圆柱,默认 2)与箭头的四档来源都在说这件事——支数=记录数的函数,不是记录数本身。 -6. **65535 顶点上限**:填充/线网格按预算自动分块(`chunks=`/`fillMaxVerts=` 读数);自己加图元时不要绕开预算。 -7. **`UICurveRenderer.LiveVertexCount` 不是本实例的数**(报表里 `curveVerts=` 是"库里一共活着多少顶点",P23 待办);要判自己那份,读 `curves=`/`markers=`。 +6. **65535 顶点上限**:库那三个渲染器(线/曲线/散点)按预算自动分块;**填充这一侧不分块**(2026-11-08 他要求:一个 Graphic 自己画,没有 chunk 子物体)——超上限时按提交顺序**整段放弃**并报 `fillRefused=`,不是抛异常。填充的读数换成 `fillPlan=`/`fillShipped=`/`fillRefused=`/`fillCr=`(规范 §34)。自己加图元时不要绕开预算。 +7. **`UICurveRenderer.LiveVertexCount` 不是本实例的数**(报表里 `curveVerts=` 是"库里一共活着多少顶点");要判自己那份,读 `curves=`/`markers=`。P23("发了但不上屏")已于 2026-11-08 修掉,机制和读数见规范 §34。 8. **雷达图与伪 3D 图是两套空间**:`XRadarChart` 用自己的 `XChartRadarDataModel`(2D 极坐标),不吃立方体的 `TryResolveDomain` 那套。 9. **别在元素自己的对象上做手脚**:工具与它生成的节点是运行时的(`HideAndDontSave`),重建一次就换一批——把状态存在你自己的组件或配置里。 10. **显示范围只定标尺,不决定数据画不画**(§32):散点/矢量/圆柱各有一个 `OutOfRange` 三档(`RenderAsIs` 默认=超范围的点画到盒子外面、`ClampToRange`=贴回盒壁、`HideOutOfRange`=整条不画),轴与格线**永远**按范围、没有这个开关。想让点"限定在网格内"就把那一档调成 `ClampToRange`——默认已经不是了。报表里 `hidden=`(策略隐的)与 `skipped=`(数据不可用的)是两个数。 11. **从对象池拿到的文本件是干净的**(§P26a):颜色/字号/旋转/矩形在复用时会恢复默认,所以你的元素"没写的属性"不会继承上一个元素写过的值;反过来,**你在元素上没设的属性就是那一份默认**(14 号字、白色、不换行、居中对齐)。 +12. **运行时新建的 Graphic 必须自己带 `CanvasRenderer`**(§34,P23 的根因):`Graphic` 只 `RequireComponent(RectTransform)`,`AddComponent` 不会替它补那个组件,而 `Graphic.Rebuild` 第一句就是 `if (canvasRenderer == null || canvasRenderer.cull) return`——网格照填、不画、也不报错。工具的 `CreateChild` 已经写全(`RectTransform` + `CanvasRenderer`),所以走工具建的子渲染器没问题;**绕过 `CreateChild` 自己 `new GameObject` 挂 Graphic 时**,要自己补那个组件(类上也贴 `[RequireComponent(typeof(CanvasRenderer))]`,跟库里三个基类同一个形状),并把 `AddComponent` 放在 `SetParent` 之后——`OnEnable` 里的 `CacheCanvas` / `GraphicRegistry` 读的是当时的父级。判"有没有"用 `GetComponent()`,别读 `canvasRenderer` 属性(缺的时候它自己会 `AddComponent`,读它就把"有没有"变成"我补了一个")。 ## 10. 端到端:一个"掘进姿态"箭头 diff --git a/Documentation/XChart-RenderFramework.md b/Documentation/XChart-RenderFramework.md index 6a68459..8ab10c7 100644 --- a/Documentation/XChart-RenderFramework.md +++ b/Documentation/XChart-RenderFramework.md @@ -464,6 +464,10 @@ chart.RebuildToolPools() // 帧首或脏标记后调用 所以画家序不变)。**判据**:探针 5 条(每块不超预算、覆盖不重不漏且保序、最大值真是最大、单面超预算也自成一块不丢面、 零面零块),对照臂 R「把切块关掉(永远一块)」⇒ 第一条红;**现场读数**:圆柱与箭头两个按记录数长网格的工具 各自在报表里印 `fillChunks=` 与 `fillMaxVerts=`("最大的那个 Graphic 有多少顶点")。 + **这一套在 2026-11-08 被他推翻**("自己写个简单填充就行,不要那套 chunk 子物体")⇒ 填充这一侧现在是 + **一个 Graphic 自己画**,判据从"切成几块"换成"装不下的按提交顺序整段放弃、而且必须报出来",读数换成 + `fillPlan=/fillShipped=/fillRefused=/fillCr=`;全套在 §34。**库那三个基类的分块照旧**(散点/曲线/线仍按记录数 + 长网格,那一条没被推翻,被推翻的只是填充这一侧的实现形状)。 **库侧分块已做一半(2026-10-23)**:`PrimitiveCacheRendererBase`(**散点走它**)与 `CurveCacheRendererBase` 都改成"本体不画、按 `ChunkVertexBudget = 16000` 把条目切块、每块一个子 Graphic", 块内索引按块内顶点起点**重基**(`PopulateSlice`);顺序不变(块按提交顺序、块内也按顺序)⇒ 画家序不动。 @@ -494,7 +498,9 @@ chart.RebuildToolPools() // 帧首或脏标记后调用 **已修**(两棵库树按符号名对齐:`LiveVertexCount` 各 6 处、`RemoveRange` 各 5 处):重建时把缓存 shrink 到 当前真正需要的顶点/索引数,并暴露 `LiveVertexCount`(**当帧真提交量**,不是水位)。 **报告口径**:每个按数据量长网格的元素都印自己组件的提交量 —— 散点 `points= / pointVerts=`、 - 箭头 `arrowFaces= / fillChunks= / fillMaxVerts=`、圆柱再加 `curveVerts= / wireVerts=`、轴线 `wireVerts=`。 + 箭头 `arrowFaces= / curves= / markers=`(箭头不再经过填充渲染器,§29)、圆柱再加 `curveVerts= / wireVerts=`、 + 轴线 `wireVerts=`。填充那一侧的三个数分开印(§34):`fillPlan=`(算出来的)/ `fillShipped=`(真写进网格的)/ + `fillRefused=`(被上限挤掉的)+ `fillCr=`(有没有 CanvasRenderer)——这四个数就是"发"与"画"的分界线。 **跨包编译顺序也补上了**(否则一改库就满屏 `CS1061` 假红):`run_gate_lib.py` 先把库编出来, `run_gate.py` 再把渲染里指向 dag 旧 `Lrss3.Deconstruction.ref.dll` 的引用重定向到本次产出 (打印 `lib_ref=N`,N 必须 ≥ 1 ——"重定向真的发生了"本身是判据)。 @@ -1975,6 +1981,9 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码 `fillMaxVerts=248`(=62×4 个顶点,一个不多)⇒ **面提交了、子块建了、网格也真填了顶点**,画面上却没有。 所以不是数据形状、不是开关、不是顶点预算,是**填充渲染器到 Canvas 的那一跳**。(那一跳本轮没修: 箭头不再经过它,所以箭头上屏了,而网格背景/圆柱填充那两类如果也看不见,就是同一个坏点还没除掉。) + **2026-11-08 那一跳找到了并修掉**(§34):填充那一类是**我们自己写的 Graphic**,而 `Graphic` 不要求 + `CanvasRenderer`——工具建子物体时也没给——所以它从来没有那个组件,`Graphic.Rebuild` 第一句就 return: + 网格照填、不画、不报错。走库渲染器的元素(散点/线/曲线)都有那个组件,所以它们上屏;只有自写的这一类不上屏。 - **顺手抓到的一条会撒谎的读数**:同一行里 `curves=0` 但 `curveVerts=66`——`UICurveRenderer.LiveVertexCount` **不是这个实例自己的数**(同一时刻圆柱那一行也印 66)。所以 `curveVerts=` 只能当"库里现在一共活着多少顶点"读, 不能当"我这条曲线提交了几个顶点"读;要看自己那份,读 `curves=`(条目数)与 `markers=`。已记进 P23 待办。 @@ -2221,4 +2230,79 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码 照打 `NextRecordAsPoint`——两条还是能在同一份数据上分开,覆盖没少);`p4_control` **73** 支照旧各红在点名断言上 (那支改名 `point-to-point reuses the carries-direction rule`,期望断言标签同步改,否则臂红了却没人认它的断言); 编译门 runtime + player + editor + 3 对照绿。要让矢量场真有内容,缺的还是**方向列**:多 3 列(凑 6 个数值维) -或者让奇数行放方向,`ThisRecordCarriesVector` / `AlternatingRecords` 才是给矢量场用的两档。 \ No newline at end of file +或者让奇数行放方向,`ThisRecordCarriesVector` / `AlternatingRecords` 才是给矢量场用的两档。 + +## 34. P25/P23:填充自己写(一个 Graphic,没有子物体),以及"发"与"画"的分界线(2026-11-08) + +### 34.1 他要的形状 + +原话:"这个填充我之前说的是需要你写一个简单的填充脚本就可以,也就是自己实现,不需要额外的渲染脚本实现。" +(加上"自己写简单填充,替掉 chunk 式填充渲染器")。落码后 `XChartMeshFillRenderer.cs` 里**只剩一个类**: + +- `AddFace` / `AddFaceLinear` 收面,`OnPopulateMesh` 把面写进**自己**的 `VertexHelper`; +- 没有 `FaceChunk`、没有子 GameObject、没有 `EnsureChunkCount`、没有"本体不画、交给块画"那二层; +- 三档上色(`Flat`/`Radial`/`Linear`)不变,每面顶点数仍只有**一个**定义 + (`XChartMeshBudget.VerticesPerFace`)——预算侧和渲染侧都吃它,两边各写一套就会出现"预算以为 4 个、实际发 5 个"。 + +顺手补回一条:`OnPopulateMesh` 里的 `vh.Clear()` 是渲染器自己的责任(`DoMeshGeneration` 只在"矩形无效"那一支 +才替它清,ugui@1.0.0 `Graphic.cs:694-700`),不写就会把上一批顶点留在网格里,读数也跟着撒谎。 + +### 34.2 上限超了怎么办:只能按提交顺序整段放弃 + +不分块 ⇒ 一个 Graphic 就是 65535 的整个额度,`XChartMeshBudget.FacesWithinCap` 取**前缀**。 + +- 为什么是前缀而不是"跳过装不下的":提交顺序=绘制顺序(调用方按深度从远到近喂,画家算法),重排就是改画面。 + 所以超了只能放弃后面整段,不能挑着收。 +- 放弃必须报:报表里 `fillRefused=`。"悄悄少画"和"崩溃"是同一种坏——他 2026-10-23 那次是崩,这一种是数字好看、画面缺一块。 +- 实际用量离上限差一个数量级(立方体 6 面、圆柱一片轮廓 ≤ 1024 面)⇒ 这一档平时是 0。它存在是为了"数据喂大了要看得见它挤掉了"。 + +### 34.3 P23 的真相:`Graphic` 不要求 CanvasRenderer + +- 证据(本工程实际加载的 ugui@1.0.0 源,不是我记忆里的版本):`Graphic.cs:17-18` 只声明 + `DisallowMultipleComponent` + `RequireComponent(RectTransform)`——**没有** `CanvasRenderer`; + `Graphic.cs:640` 的 `Rebuild` 第一句是 `if (canvasRenderer == null || canvasRenderer.cull) return`。 + 运行时 `AddComponent` 出来的 Graphic 没有那个组件 ⇒ 网格照填、不画、也不报错。 +- 对照:库里三个渲染器基类(line/curve/primitive)**都显式贴了** `[RequireComponent(typeof(CanvasRenderer))]` + ⇒ 走它们的元素上屏;只有"我们自己写的那类 Graphic"不上屏。这正好解释了他报的现象组合:散点、格线、箭头都在, + 填充没有;Inspector 里那个块是个没材质的空壳;报表数字全对。 +- 修法两处(都在单一入口):① `XChartToolBase.CreateChild` 建子物体时写全 `RectTransform` + `CanvasRenderer`, + 工具子物体的整族一起修;② 类上贴 `[RequireComponent(typeof(CanvasRenderer))]`(跟库里三个基类同一个形状)。 + 顺序照旧:`AddComponent` 放在 `SetParent` 之后,因为 `OnEnable` 的 `CacheCanvas` / `GraphicRegistry` 读的是当时的父级。 +- 判"有没有"必须用 `GetComponent()`:`Graphic.canvasRenderer` 那个 getter 在缺的时候自己 + `AddComponent`(`Graphic.cs:453-467`),读它就把"有没有"变成"我补了一个"——判据不许写被检对象的状态。 + +### 34.4 四个读数就是"发"与"画"的分界线 + +| 读数 | 谁产生的 | 说明 | +| --- | --- | --- | +| `fillPlan=` | `Apply()` | 提交那一刻算出来要发几个顶点 | +| `fillShipped=` | `OnPopulateMesh` | canvas 更新循环**真写进网格**的顶点数 | +| `fillRefused=` | `Apply()` | 被上限挤掉的面数 | +| `fillCr=` | 报表读 `HasCanvasRenderer` | 这个 Graphic 到底有没有 CanvasRenderer | + +判据形状:`fillPlan>0` 而 `fillShipped=0` ⇒ 发出去了但没上屏(P23 的形状);`fillCr=NO` ⇒ 那一跳的入口不在; +三个数都正常而画面还空 ⇒ 我不再猜,直接说"离线门看不到引擎的 Canvas 收集这一步,现场才算数"。 +注意报表里原先那两个读数(`fillChunks=`/`fillMaxVerts=`)没了——块没有了,读数自然跟着换。 + +### 34.5 判据 + +- **源码门** `.ximage-gate/fill_gate.py`(claims A–E,7 支臂):A 类上那个属性 / B `CreateChild` 写全 / + C 渲染器自己不建子物体 / D 渲染路径真吃上限与前缀、且每面顶点数只有一份定义 / E 报表印齐四个读数且 presence 走 `GetComponent`。 + clean tree 全绿,7 支各红在点名 claim(F1 摘属性、F2 `CreateChild` 只给 RectTransform、F3 chunk 子物体放回来、 + F4 `OnPopulateMesh` 无视前缀、F5 预算自己再写一套 5-vs-4、F6 报表只印 plan、F7 用那个会写状态的 getter)。 + 注意 claim C/D/E 只扫代码行,不扫文档注释:文件把 `canvasRenderer` 的坑写在注释里,判据如果打在文字上就是在判文本不是判代码。 +- **探针 474 条 0 失败**(6 条打在 `FacesWithinCap`):不超上限、装不下时真挤掉、前缀收到装不下为止、 + 装得下就整批收、单面超上限一个都不收、零面零收。断言的读数不许越界取 `counts[accepted]`:臂把上限关掉时 + `accepted` 就是全表,探针会在断言之前先越界死掉——那种"红"是仪器坏不是判据红(本轮真踩到一次,已修)。 +- **`p4_control` 73 支**照旧各红在点名断言上;原来那支"把切块关掉(永远一块)"换成"上限从不被 consulted"(臂 26), + 期望标签同步换成新的 3 条。 +- **`dirty_gate.py`** 136 旋钮 136 生效;编译门 runtime + player + editor + 3 对照绿(`engine_remapped` 照旧打印, + 因为记着的引擎安装路径已经不在了,读的是 `G:/Unity_EngineFlie/Unity 2022.1.24f1`)。 + +### 34.6 覆盖不到什么 / 他侧验收(Ctrl+R 后) + +- 离线门判不到"真上屏":Graphic 到 Canvas 那一跳(Canvas 什么时候把 CanvasRenderer 收进批次)不在我们代码里, + 所以 §34.3 的修法在离线侧只有"形状判据 + 读数",画面归他。 +- 现场看三件事:① 立方体的填充面和圆柱的填充应上屏;② 报表 `fillCr=yes` 且 `fillShipped>0`; + ③ 数据喂到超上限时是 `fillRefused>0`,而不是抛 `Mesh can not have more than 65000 vertices`。 +- 如果 `fillCr=yes`、`fillShipped>0` 而画面还空,那 §34.3 的机制就不是全部——这条要说清楚,别把"修了形状"当"修了画面"。 \ No newline at end of file diff --git a/Runtime/XChart/Mesh/ChartToolCylinder.cs b/Runtime/XChart/Mesh/ChartToolCylinder.cs index 0804d76..da1adb5 100644 --- a/Runtime/XChart/Mesh/ChartToolCylinder.cs +++ b/Runtime/XChart/Mesh/ChartToolCylinder.cs @@ -734,8 +734,11 @@ namespace XericUI.XChart.Mesh sb.Append(" outlinePoints=").Append(m_OutlineCount) .Append(" curveEntries=").Append(m_CurveEntries) .Append(" fill=").Append(ShowFill) - .Append(" fillChunks=").Append(FillRenderer != null ? FillRenderer.ChunkCount : 0) - .Append(" fillMaxVerts=").Append(FillRenderer != null ? FillRenderer.MaxChunkVertices : 0) + .Append(" fillPlan=").Append(FillRenderer == null ? -1 : FillRenderer.PlannedVertexCount) + .Append(" fillShipped=").Append(FillRenderer == null ? -1 : FillRenderer.ShippedVertexCount) + .Append(" fillRefused=").Append(FillRenderer == null ? -1 : FillRenderer.RefusedFaces) + .Append(" fillCr=").Append(FillRenderer == null ? "fill-NULL" + : (FillRenderer.HasCanvasRenderer ? "yes" : "NO")) .Append(" curveVerts=").Append(CurveRenderer != null ? CurveRenderer.LiveVertexCount : 0) .Append(" wireVerts=").Append(WireRenderer != null ? WireRenderer.LiveVertexCount : 0) .Append(" ringStart=").Append(ShowStartRing) diff --git a/Runtime/XChart/Mesh/ChartToolMeshBg.cs b/Runtime/XChart/Mesh/ChartToolMeshBg.cs index 3208623..2ca5178 100644 --- a/Runtime/XChart/Mesh/ChartToolMeshBg.cs +++ b/Runtime/XChart/Mesh/ChartToolMeshBg.cs @@ -493,7 +493,11 @@ namespace XericUI.XChart.Mesh : "DIFF drawn=" + m_GridLinesDrawn + " want=" + want) .Append(" lines=").Append(m_LinesS).Append('/').Append(m_LinesT) .Append(" frames=").Append(valid).Append('/').Append(m_FaceFrames.Length) - .Append(" chunks=").Append(FillRenderer != null ? FillRenderer.ChunkCount : -1) + .Append(" fillPlan=").Append(FillRenderer == null ? -1 : FillRenderer.PlannedVertexCount) + .Append(" fillShipped=").Append(FillRenderer == null ? -1 : FillRenderer.ShippedVertexCount) + .Append(" fillRefused=").Append(FillRenderer == null ? -1 : FillRenderer.RefusedFaces) + .Append(" fillCr=").Append(FillRenderer == null ? "fill-NULL" + : (FillRenderer.HasCanvasRenderer ? "yes" : "NO")) .Append(" renderers=").Append(FillRenderer == null ? "fill-NULL" : "ok") .Append('/').Append(GridRenderer == null ? "grid-NULL" : "ok"); } diff --git a/Runtime/XChart/Mesh/XChartMeshFillRenderer.cs b/Runtime/XChart/Mesh/XChartMeshFillRenderer.cs index d59b43d..c6596be 100644 --- a/Runtime/XChart/Mesh/XChartMeshFillRenderer.cs +++ b/Runtime/XChart/Mesh/XChartMeshFillRenderer.cs @@ -24,89 +24,72 @@ namespace XericUI.XChart.Mesh } /// - /// 顶点预算分块(纯算,离线可验)。 + /// 顶点预算(纯算,离线可验)。 /// - /// 为什么要有它:UGUI 的 65535 顶点上限是每个 Graphic 各自的,而有些元素是 - /// 按记录数长网格的(箭头一条记录 2 个四边形、散点一个点 1 个四边形)⇒ 记录一多必然撞上 - /// (他 2026-10-23 灌 10000 条时现场抛 `Mesh can not have more than 65000 vertices`)。 - /// 所以提交前先按预算把面切成若干块,每块一个 Graphic。 + /// 为什么要有它:UGUI 的 65535 顶点上限是每个 Graphic 各自的 + /// (`VertexHelper.FillMesh` 超了就抛 `Mesh can not have more than 65000 vertices`,他 2026-10-23 + /// 现场中过一次),而有些元素是按记录数长网格的(散点一个点 1 个四边形、圆柱填充一片轮廓) + /// ⇒ 数据一多就会撞。 + /// + /// 填充这一侧不分块(2026-11-08 他要求:自己写简单填充,不要那套 chunk 子物体), + /// 所以判据从"切成几块"换成"装不下的那部分必须整段放弃、并且必须报出来"—— + /// 悄悄少画和崩溃是同一种坏。 /// public static class XChartMeshBudget { - /// 每块顶点上限。65535 是硬上限,这里留足余量(还要给别的顶点与实现细节留空间)。 - public const int ChunkVertexBudget = 16000; + /// UGUI 每个 Graphic 的硬上限(`VertexHelper.FillMesh` 超过就抛) + public const int GraphicVertexCap = 65535; /// - /// 切块:把 个面按"每面顶点数"切成若干块, - /// 各块起始面下标写进 ,返回块数。 - /// 块 k 覆盖面 [starts[k], starts[k+1]),最后一块到 。 - /// 顺序不变、不重不漏;单面就超过预算时它自成一块(无解,只能交给渲染器)。 + /// 按提交顺序能装进 的前缀面数。 + /// + /// 只取前缀是硬要求:提交顺序=绘制顺序(画家算法),所以"装不下的"不能重排、 + /// 也不能插到前面去——只能整段放弃。被放弃的面由渲染器报出来(报表里的 `fillRefused=`), + /// 不能悄悄少画。 /// - public static int Split(int[] faceVertexCounts, int faceCount, int budget, int[] starts) + public static int FacesWithinCap(int[] faceVertexCounts, int faceCount, int cap) { if (faceVertexCounts == null) throw new ArgumentNullException(nameof(faceVertexCounts)); - if (starts == null) throw new ArgumentNullException(nameof(starts)); - if (starts.Length < 1) throw new ArgumentException("starts 至少要有 1 个位置"); - if (faceCount <= 0) - { - starts[0] = 0; - return 0; - } - if (budget < 1) budget = 1; + if (faceCount <= 0) return 0; + if (cap < 1) return 0; - int chunks = 0; - int start = 0; + int accepted = 0; int used = 0; for (int i = 0; i < faceCount; i++) { int vertices = Mathf.Max(1, faceVertexCounts[i]); - if (used > 0 && used + vertices > budget) - { - starts[chunks++] = start; - start = i; - used = 0; - } + // 装不下的只能整段放弃(顺序不许重排),被放弃的面由报表 fillRefused= 报出来 + if (used + vertices > cap) break; used += vertices; + accepted++; } - starts[chunks++] = start; - return chunks; - } - - /// 各块顶点数的最大值(报表用:报告"最大的那个 Graphic 有多少顶点") - public static int MaxChunkVertices(int[] faceVertexCounts, int faceCount, int[] starts, int chunkCount) - { - int max = 0; - for (int c = 0; c < chunkCount; c++) - { - int end = (c + 1 < chunkCount) ? starts[c + 1] : faceCount; - int sum = 0; - for (int i = starts[c]; i < end; i++) sum += Mathf.Max(1, faceVertexCounts[i]); - if (sum > max) max = sum; - } - return max; + return accepted; } /// - /// 一块面要几个顶点:只有径向渐变要多一个中心顶点(5 个、4 三角), + /// 一个面要几个顶点:只有径向渐变要多一个中心顶点(5 个、4 三角), /// 平坦与线性渐变都是 4 顶点 2 三角。 /// - /// 分块预算吃的是这个数(65535 是每个 Graphic 各自的上限),所以它必须是单一定义: - /// 渲染侧按它写顶点、预算侧按它算块,两处各写一套就会出现"预算以为 4 个、实际发 5 个" - /// ——那种分块会在恰好卡线时撞上限。 + /// 预算和渲染两侧必须吃这同一个定义:两边各写一套就会出现"预算以为 4 个、 + /// 实际发 5 个",正好卡线时撞上限。 /// public static int VerticesPerFace(XChartFaceFillKind kind) => kind == XChartFaceFillKind.Radial ? 5 : 4; } /// - /// 面填充渲染器:提交若干四边形,按顶点预算自动分块,每块一个子 Graphic。 + /// 面填充渲染器:把四边形写进自己这一个 Graphic 的网格——没有子物体,也没有第二套渲染脚本。 /// - /// 每面可以纯色填充,也可以"四角色 + 中心色"径向渐变(背景做浅淡的立体感很需要这个)。 - /// 面的提交顺序就是绘制顺序,所以调用方要按深度从远到近喂(画家算法)—— - /// 半透明面叠在一起时,顺序错了颜色就错了。分块不改这个顺序:块按提交顺序排,块内也按顺序。 + /// 每面可以纯色填充,也可以"四角色 + 中心色"径向渐变(背景做浅淡的立体感很需要这个), + /// 或"一对边各一色"的线性渐变。 + /// + /// 面的提交顺序就是绘制顺序,所以调用方要按深度从远到近喂(画家算法)—— + /// 半透明面叠在一起时,顺序错了颜色就错了。这条决定了上限超了以后只能按顺序整段放弃: + /// 不能把装不下的面挪到前面去(),也不能悄悄少画。 /// /// 不参与射线检测(背景不该挡住交互)。 /// + [RequireComponent(typeof(CanvasRenderer))] [AddComponentMenu(XericRegistrationPaths.Chart + "/Mesh/Cube Face Fill Renderer")] public sealed class XChartMeshFillRenderer : MaskableGraphic { @@ -122,35 +105,32 @@ namespace XericUI.XChart.Mesh public XChartFaceFillKind Kind; } - /// 一块:只画 [Start, End) 之间的面。顶点数受预算限制,所以不会撞 65535 上限。 - private sealed class FaceChunk : MaskableGraphic - { - public XChartMeshFillRenderer Owner; - public int FirstFace; - public int LastFace; - - protected override void OnEnable() - { - base.OnEnable(); - raycastTarget = false; - } - - protected override void OnPopulateMesh(VertexHelper vh) - { - vh.Clear(); - if (Owner != null) Owner.PopulateSlice(vh, FirstFace, LastFace); - } - } - private readonly List m_Faces = new List(8); - private readonly List m_Chunks = new List(); private int[] m_FaceVertexCounts = new int[0]; - private int[] m_ChunkStarts = new int[8]; - /// 报表用:这一帧提交了几个面 / 切成几块 / 最大的那块有多少顶点 + // 三个数分开看,因为 P23 那个坏点就是"提交侧的数好看、画面是空的": + // PlannedVertexCount 是提交那一刻算出来的,ShippedVertexCount 是 canvas 更新循环真写进 + // VertexHelper 的,HasCanvasRenderer 是"这一跳的入口在不在"。三个数凑不齐就是还没画。 + private int m_PlannedVertexCount; + private int m_ShippedVertexCount; + private int m_RefusedFaces; + private int m_AcceptedFaces; + + /// 报表用:提交了几个面 / 算出来要发几个顶点 / 真写进网格的顶点数 / 被上限挤掉的面 public int FaceCount => m_Faces.Count; - public int ChunkCount => m_Chunks.Count; - public int MaxChunkVertices { get; private set; } + public int PlannedVertexCount => m_PlannedVertexCount; + public int ShippedVertexCount => m_ShippedVertexCount; + public int RefusedFaces => m_RefusedFaces; + + /// + /// 报表用:这个 Graphic 到底有没有 CanvasRenderer。 + /// + /// 必须走 GetComponent:`Graphic.canvasRenderer` 那个 getter 在缺的时候会被访问 + /// (它自己会 AddComponent),读它就把"有没有"变成"我补了一个"——判据不许写被检对象的状态。 + /// 缺的后果是 Graphic.Rebuild 第一句 `if (canvasRenderer == null …) return` + /// (ugui@1.0.0 Graphic.cs:640):网格填了、不画、也不报错。 + /// + public bool HasCanvasRenderer => GetComponent() != null; protected override void OnEnable() { @@ -205,71 +185,37 @@ namespace XericUI.XChart.Mesh }); } - /// 提交:按预算分块,然后各块重画 + /// + /// 提交:按"每面顶点数"算这个 Graphic 装得下前几面(装不下的整段放弃、报出来),然后置脏 + /// 让 canvas 更新循环去发顶点。 + /// public void Apply() - { - RebuildChunks(); - SetVerticesDirty(); // 本体不画东西,但仍刷一次,保证子块的顺序紧跟其后 - for (int i = 0; i < m_Chunks.Count; i++) m_Chunks[i].SetVerticesDirty(); - } - - private void RebuildChunks() { if (m_FaceVertexCounts.Length < m_Faces.Count) m_FaceVertexCounts = new int[m_Faces.Count]; for (int i = 0; i < m_Faces.Count; i++) m_FaceVertexCounts[i] = XChartMeshBudget.VerticesPerFace(m_Faces[i].Kind); - if (m_ChunkStarts.Length < m_Faces.Count + 1) m_ChunkStarts = new int[m_Faces.Count + 1]; - int chunks = XChartMeshBudget.Split(m_FaceVertexCounts, m_Faces.Count, - XChartMeshBudget.ChunkVertexBudget, m_ChunkStarts); - MaxChunkVertices = XChartMeshBudget.MaxChunkVertices(m_FaceVertexCounts, m_Faces.Count, - m_ChunkStarts, chunks); + m_AcceptedFaces = XChartMeshBudget.FacesWithinCap(m_FaceVertexCounts, m_Faces.Count, + XChartMeshBudget.GraphicVertexCap); - EnsureChunkCount(chunks); - for (int c = 0; c < chunks; c++) - { - m_Chunks[c].FirstFace = m_ChunkStarts[c]; - m_Chunks[c].LastFace = (c + 1 < chunks) ? m_ChunkStarts[c + 1] : m_Faces.Count; - m_Chunks[c].enabled = true; - } - for (int c = chunks; c < m_Chunks.Count; c++) m_Chunks[c].enabled = false; // 多余的块停掉,不画空网格 + int used = 0; + for (int i = 0; i < m_AcceptedFaces; i++) used += m_FaceVertexCounts[i]; + m_PlannedVertexCount = used; + m_RefusedFaces = m_Faces.Count - m_AcceptedFaces; + + SetVerticesDirty(); } - private void EnsureChunkCount(int count) + protected override void OnPopulateMesh(VertexHelper vh) { - while (m_Chunks.Count < count) - { - var chunk = new GameObject("FillChunk" + m_Chunks.Count, typeof(RectTransform)).AddComponent(); - chunk.Owner = this; - var rect = (RectTransform)chunk.transform; - rect.SetParent(transform, false); - rect.anchorMin = Vector2.zero; - rect.anchorMax = Vector2.one; - rect.offsetMin = Vector2.zero; - rect.offsetMax = Vector2.zero; - chunk.raycastTarget = false; - m_Chunks.Add(chunk); - } - } + // `Graphic` 自己不清:s_VertexHelper 是静态共用的那一个,Clear 是 OnPopulateMesh 的责任 + // (ugui@1.0.0 Graphic.cs:694-700 —— 只有"矩形无效"那一支才替它清)。不清就会把上一批 + // 顶点留在网格里,读数也会跟着撒谎。 + vh.Clear(); - /// 本体不画东西:所有面都交给受预算约束的子块 - protected override void OnPopulateMesh(VertexHelper vh) => vh.Clear(); - - private static bool IsGradient(FaceQuad face) - { - // Color32 是逐字节比较:"两色不同"就说明这次要做渐变 - return face.CenterColor.r != face.EdgeColor.r - || face.CenterColor.g != face.EdgeColor.g - || face.CenterColor.b != face.EdgeColor.b - || face.CenterColor.a != face.EdgeColor.a; - } - - internal void PopulateSlice(VertexHelper vh, int start, int end) - { - if (start < 0) start = 0; - if (end > m_Faces.Count) end = m_Faces.Count; - - for (int i = start; i < end; i++) + // 只写提交侧认下来的那前 m_AcceptedFaces 个面:提交顺序就是画家序,不能重排。 + // 读数用 vh.currentVertCount(真写进去的),不用"应该是几个"——两者相等才是这条链真的跑到终点。 + for (int i = 0; i < m_AcceptedFaces && i < m_Faces.Count; i++) { FaceQuad face = m_Faces[i]; int first = vh.currentVertCount; @@ -301,16 +247,8 @@ namespace XericUI.XChart.Mesh vh.AddTriangle(first + 2, first + 3, first + 0); } } - } - protected override void OnDisable() - { - base.OnDisable(); - // 图形停用时子块也得停,否则会留下"看不见但还在"的空网格 - for (int i = 0; i < m_Chunks.Count; i++) - { - if (m_Chunks[i] != null) m_Chunks[i].enabled = false; - } + m_ShippedVertexCount = vh.currentVertCount; } } } \ No newline at end of file diff --git a/Runtime/XChart/XChartToolBase.cs b/Runtime/XChart/XChartToolBase.cs index 7ba7877..c452111 100644 --- a/Runtime/XChart/XChartToolBase.cs +++ b/Runtime/XChart/XChartToolBase.cs @@ -189,7 +189,11 @@ namespace XericUI.XChart protected RectTransform CreateChild(string childName) { - var child = new GameObject(childName, typeof(RectTransform)); + // CanvasRenderer 必须在这里给全:`Graphic` 只 RequireComponent(RectTransform)、不要求它 + // (ugui@1.0.0 Graphic.cs:17-18),运行时 AddComponent 不会替工具补,而 `Graphic.Rebuild` + // 第一句 `if (canvasRenderer == null || canvasRenderer.cull) return`(Graphic.cs:640) + // —— 缺了它 mesh 照填、不画、也不报错。这就是 P23"发了但不上屏"的入口。 + var child = new GameObject(childName, typeof(RectTransform), typeof(CanvasRenderer)); child.transform.SetParent(RootTransform, false); child.hideFlags = CurrentFlags;