From 084591d104387bf2724b4d2f939e86747ddcb893 Mon Sep 17 00:00:00 2001 From: lrc <571244399@qq.com> Date: Mon, 9 Nov 2026 06:58:39 +0800 Subject: [PATCH] =?UTF-8?q?P26=EF=BC=9A=E6=A0=87=E7=AD=BE=E6=8C=89"?= =?UTF-8?q?=E6=A0=87=E7=AD=BE=E5=88=97"1:1=20=E8=90=BD=E5=88=B0=E8=AE=B0?= =?UTF-8?q?=E5=BD=95=E3=80=81=E7=AA=97=E5=8F=A3=E3=80=81=E5=85=83=E7=B4=A0?= =?UTF-8?q?=E3=80=81=E6=96=87=E6=9C=AC=E5=9B=9B=E5=A4=84=EF=BC=88=E8=A7=84?= =?UTF-8?q?=E8=8C=83=20=C2=A735=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - XChartColumnMath 补标签半边(LabelCount / LabelSlotOf / DefinitionOfLabelSlot / SizedLabels), 记录的标签长度只由这一处定;TryAddRecord 在 labels 长度≠标签列数时整条拒收 - 导入按标签字段个数校验并点名行号;记录行少到连时间戳都没有时点名拒绝(不再抛异常) - 数据窗口:一个显示序两个读者(标签列在前),格子身份 CellRef{IsLabel,Slot}, 标签格走 TrySetLabel 的字符串分支,「+标签」走 SetDimensions 这唯一定长路径 - 新标签元素 ChartToolLabels + XChartLabelConfig:13 旋钮全自动置脏、位置/折法同散点、 文本走池且多余槽位必须擦、锚点与对齐出自同一张表(anchorMin/Max 不写) - 面板把"要几个标签列、表里有几个"与数值维、记录数一起印(§25.1 第三半 RequiredLabelColumns) - 探针先红的两个真缺陷:SizedLabels(null,n) 补 null 不是空串;锚点表漏 MiddleRight 与 Center 重合 - 雷达 AddSeries 带系列名,两个 SetDimensions 重载都声明 series 标签列(否则新门口整条拒收) - 判据:探针 492/0、label_gate 15 claim/15 臂全红、dirty_gate 149/149、slot_reset PASS、 编译门三臂+3 对照绿(source present 点名四个新文件)、p4_control 78 支各红在点名断言 (同一棵树指纹 478727e6748c67cddda40995874b20968e9eae3706f2a21c24726d3412059747) --- CHANGELOG.md | 1 + Documentation/XChart-ExternalAPI.md | 27 +- Documentation/XChart-RenderFramework.md | 84 +++++- Editor/XChart/XChartBaseEditor.cs | 29 +- Editor/XChart/XChartDataWindow.cs | 221 ++++++++++++--- Runtime/XChart/Radar/XRadarChart.cs | 26 +- Runtime/XChart/Text.meta | 8 + Runtime/XChart/Text/ChartToolLabels.cs | 268 ++++++++++++++++++ Runtime/XChart/Text/ChartToolLabels.cs.meta | 11 + Runtime/XChart/Text/XChartLabelAnchorMath.cs | 72 +++++ .../XChart/Text/XChartLabelAnchorMath.cs.meta | 11 + Runtime/XChart/Text/XChartLabelConfig.cs | 101 +++++++ Runtime/XChart/Text/XChartLabelConfig.cs.meta | 11 + Runtime/XChart/XChartColumnMath.cs | 65 +++++ Runtime/XChart/XChartDataModel.cs | 73 +++-- Runtime/XChart/XChartDataSource.cs | 14 + Runtime/XChart/XChartDataText.cs | 23 +- Runtime/XChart/XChartElementConfig.cs | 7 + 18 files changed, 968 insertions(+), 84 deletions(-) create mode 100644 Runtime/XChart/Text.meta create mode 100644 Runtime/XChart/Text/ChartToolLabels.cs create mode 100644 Runtime/XChart/Text/ChartToolLabels.cs.meta create mode 100644 Runtime/XChart/Text/XChartLabelAnchorMath.cs create mode 100644 Runtime/XChart/Text/XChartLabelAnchorMath.cs.meta create mode 100644 Runtime/XChart/Text/XChartLabelConfig.cs create mode 100644 Runtime/XChart/Text/XChartLabelConfig.cs.meta diff --git a/CHANGELOG.md b/CHANGELOG.md index 8fafc65..beff499 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -108,6 +108,7 @@ P29 方向的单位="差折法"(只缩不移位)+ 四档方向来源到底 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 就不是全部故事。 +P26 标签是"记录上的标签列",不是随身的一串字符串(规范 §35,2026-11-08 他前几轮的口径:"每个数据项目对应数个 float 维和一个 string 维,把 string 维放在数据编辑器窗口前面直接编辑"):① **1:1 落在门口**——`XChartColumnMath` 补标签半边(`LabelCount` / `LabelSlotOf` / `DefinitionOfLabelSlot` / `SizedLabels`,与数值三支完全对称),`TryAddRecord` 在 `labels` 非 null 且长度≠标签列数时整条拒收,文本导入按标签字段个数校验并点名行号(以前默认"多出来的就是标签",于是窗口显示得出来、元素读不到、导出再读回来变了样;顺带补上记录行少到连时间戳都没有时点名拒绝,那条路原来抛的是异常不是判决);② **窗口一个显示序、两个读者**——`ComputeColumnSlots` 同时算值槽/标签槽/显示序(标签列在前),表头与行都遍历它;每格身份是 `CellRef{IsLabel,Slot}`(`-1` 仍只表示"这一列不占格"),标签格走 `TrySetLabel` 的字符串分支(数字解析会把"巷道1"当错报拒掉),工具栏「+标签」加的是 Label 维、走 `SetDimensions` 这唯一定长路径(老记录补空串、不挤走旧标签);③ **标签元素**(`ChartToolLabels` + `XChartLabelConfig`)13 个旋钮全自动置脏,位置与折法同散点/圆柱(范围只定标尺,§32),文本走池且**比记录多的槽位必须擦**,锚点与对齐出自同一档(pivot 与 alignment 都从 `AnchorOf`/`AlignmentFor` 来,`anchorMin/Max` 不写),报表 `labelSlot= dim= records= want= have= pending= written= cleared= empty= hidden= skipped= out= anchor= wrap=` 把数据侧与槽位侧分开;面板把"要几个标签列/表里有几个"和数值维、记录数一起印(§25.1 第三半,`RequiredLabelColumns`)。④ **探针这一轮抓到两个真缺陷(判据先红、代码后改)**:`SizedLabels(null,n)` 原来补的是 null 元素而不是空串——窗口里同为空,但"这一格是空的"这条判据上 null 与 `""` 各答一套(导入写出的永远是 `""`,往返一次就变样);九档锚点表**漏了 `MiddleRight`**、落到 `default`(Center),所谓"九档"实际只有八档。判据:探针 **492** 项 0 失败(新增 `label columns:` 一组 8 条 + `label anchor:` 一组 6 条;原 `data text:` 的标签断言按新口径重写——记录带 1 个标签列,没给标签的记录**仍有那一格**、是空串);新门 `label_gate.py` 15 条 claim + 15 支臂全红(每条 claim 一支变异;C7 的 forbidden 只认**写** `anchorMin =`,注释里解释"为什么不写"不算违规);`p4_control` **78** 支(新增 5 支:标签槽手数/记录自定标签长度/边中点锚点落到中心/非有限偏移直通/删标签列留错那一格;原"删列留旧值"那支的锚点因 `TryRemoveDimension` 重写而失效,已**重定靶**不是删掉);`dirty_gate` **149** 旋钮 149 生效(应磁盘清单新增 `Text/ChartToolLabels.cs`);`slot_reset_gate` 照旧 PASS;编译门三臂 + 3 对照绿,且 `source present:` 逐条点名四个新文件。覆盖不到:`AlignmentFor` 返回 TMPro 类型、离线探针引用不到那个程序集 ⇒ "对齐出自同一表"由源码门(C5/C6)判;标签真上屏、窗口里改完字跟着变归他 Ctrl+R 判。 ## [0.1.6] - 2026-07-01 diff --git a/Documentation/XChart-ExternalAPI.md b/Documentation/XChart-ExternalAPI.md index 29868ca..865cc28 100644 --- a/Documentation/XChart-ExternalAPI.md +++ b/Documentation/XChart-ExternalAPI.md @@ -66,20 +66,27 @@ public void Drive() | API | 语义 | 失败时 | | --- | --- | --- | -| `SetDimensions(list)` | 换整张表的列(会按新列重排已有记录的值) | — | -| `TryAddRecord(time, values, labels?)` | 追加一条(时间戳必须**非递减**) | `false`,原因在数据窗口/报表里看得见 | +| `SetDimensions(list)` | 换整张表的列(会按新列重排已有记录的值与标签) | — | +| `TryAddRecord(time, values, labels?)` | 追加一条(时间戳必须**非递减**;`labels` 非 null 时长度必须=标签列个数,否则拒) | `false`,原因在数据窗口/报表里看得见 | | `TrySetValue(recordIndex, numericDim, value)` | 改一个数 | 越界/非有限 ⇒ `false` | | `TrySetTime(recordIndex, time, out reason)` | 改时间戳(会破坏单调性时拒) | `false` + `reason` | -| `TrySetLabel` / `TryRemoveRecord` / `TryRemoveDimension` | 改标签、删行、删列 | `false` + `reason` | +| `TrySetLabel(recordIndex, labelSlot, text)` | 改某一行的第 `labelSlot` 个标签(空串=清空那一格,合法) | 越界 ⇒ `false` | +| `TryRemoveRecord` / `TryRemoveDimension` | 删行、删列(删 Label 列会连带丢掉每行的那个标签格) | `false` + `reason` | | `TrySetDomainOverride(dim, overrideMin, min, overrideMax, max)` | 钉住某一维的显示范围(**分侧**可钉) | 越界列 ⇒ `false` | | `Clear()` / `Capacity`(环形上限)/ `DroppedCount` | 清空、容量、被丢了多少条 | — | -| `Version` / `RecordCount` / `NumericDimensionCount` / `Snapshot` | 读数(工具靠 `Version` 判要不要重算) | — | +| `Version` / `RecordCount` / `NumericDimensionCount` / `LabelDimensionCount` / `Snapshot` | 读数(工具靠 `Version` 判要不要重算) | — | -只读侧统一走 `IXChartDataSource`(`GetValueAt(record, dim)` 等),元素工具只认它——不要伸手去摸 `Records`。 +**标签是"列",不是每条记录随身的一串**:一条记录的标签数组长度**恒等于**标签列(`Kind == Label`)的个数, +下标是"第几个标签列"而不是表里的行号。多出来的字符串没有一个列能叫出它的名字,所以 `TryAddRecord` 在门口就拒; +文本导入同样按标签字段个数校验并点名行号。窗口里标签列排在最前面,那些格子就地改的就是这个数组。 + +只读侧统一走 `IXChartDataSource`(`GetValueAt(record, dim)`、`TryGetLabelAt(record, labelSlot, out text)` 等), +元素工具只认它——不要伸手去摸 `Records`。`TryGetLabelAt` 对"没有这一格"答 `false`,对"这一格是空的"答 `true` + 空串: +这两件事在画面上同形,在读数上必须分得开。 ## 4. 入口 B:元素的参数(setter 自己置脏) -每个元素工具的公开属性都是这个形状(P20 立的规矩,`dirty_gate` 数着:**133 个旋钮,133 个设了就生效**): +每个元素工具的公开属性都是这个形状(P20 立的规矩,`dirty_gate` 数着:**149 个旋钮,149 个设了就生效**): ```csharp public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } } @@ -99,6 +106,10 @@ public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } } | `ChartToolCubeBg`(`BG Cube Wire`) | `FrontEdgeColor/BackEdgeColor/EdgeThickness/ShowBackEdges` | | `ChartToolScatterPoints` | `AutoFromData/DimensionX/Y/Z` · 外观 10 个(`PointSize/PointType/PointSizeMode/PointColor/CenterColor/BorderColor/BorderThickness/SideCount/ChamferSize/PointAngle`,走 `SyncShapeParams`) · `EnableColorMapping/ColorMapMin/ColorMapMax/ColorMapDimension` | | `ChartToolAxis` | `SlotId`(**宿主**:板上现在发 `mesh.face.<0..5>` 与 `mesh.face..side.<0..3>` 共 30 个可当选;边号 0 底·1 左·2 顶·3 右,见规范 §31。下拉里不会再出现 `…grid.S/T`,那是「对齐格线」的输入) · `AlignToGrid/Direction/StartRatio/EndRatio/CrossRatio` · 刻度(`Dimension/Scale/AutoStep/ManualStep/TargetMajorCount/MinorTickCount`) · 线与标签(`LineColor/LineThickness/Major…/Minor…/LabelSource/LabelFormat/CustomLabels/Label…`) | +| `ChartToolLabels`(数据标签) | `LabelSlot`(第几个**标签列**,不是表行号) · `DimensionX/Y/Z`(标签挂在哪条记录的那一点上) · `Transform/OutOfRange` · `Anchor`(9 档,`XChartLabelAnchor`) · `Offset/FontSize/LabelColor/OutlineWidth/RectSize/Wrap` | + +`ChartToolLabels` 的一条规矩:**锚点和对齐出自同一档**。`Anchor` 同时决定 pivot(矩形从哪一侧从点起排)和 +`alignment`(字在矩形里怎么排),没有第二个"对齐"字段——贴在左下角却把字居中,字就横跨在那一点两侧(规范 §35.4)。 ## 5. 矢量场(箭头):方向从哪来、头贴在哪、尺寸怎么算 @@ -172,6 +183,10 @@ chart.Space.CenterOffset = new Vector2(0, 40f); | `path=none` | 曲线渲染器没建起来 ⇒ 箭头什么都画不出(箭头的唯一绘制出口就是它) | | `colors=overlap` | 颜色维起点撞上坐标/方向列 ⇒ 实际画的是单色 | | `arrows=31 arrowFaces=…`(旧版本)/ `markers=` | 提交了多少:与"看得见"是两件事,先跟上面几项对齐 | +| `labels=0/1`(面板元素块) | 这个标签元素要 1 个标签列,表里没有 ⇒ 它一条都不画。去数据窗口点「+标签」,再把那一格填上 | +| `labelSlot=0 records=N` | 标签元素在看第几个标签列、表里几条记录 | +| `written=` / `empty=` / `hidden=` / `skipped=` | 写了几个字 / 那几格是空的 / 被"超范围怎么办"这一档藏了 / 数据读不出来(分属三件事,不要合看) | +| `pending=N`、`have0`; ③ 数据喂到超上限时是 `fillRefused>0`,而不是抛 `Mesh can not have more than 65000 vertices`。 -- 如果 `fillCr=yes`、`fillShipped>0` 而画面还空,那 §34.3 的机制就不是全部——这条要说清楚,别把"修了形状"当"修了画面"。 \ No newline at end of file +- 如果 `fillCr=yes`、`fillShipped>0` 而画面还空,那 §34.3 的机制就不是全部——这条要说清楚,别把"修了形状"当"修了画面"。 + +## 35. P26:标签是"列",不是每条记录随身的一串(2026-11-08) + +### 35.1 他要的形状 + +前几轮的原话:"标签是和数据元素对应的……每个数据项目都对应数个 float 维度,和一个 string 维度…… +直接将这个 string 维度放在数据编辑器窗口的前面直接编辑。" + +落成三条硬边界: + +1. **1:1 是结构保证**:一条记录的标签数组长度**恒等于**标签列(`Kind == Label`)的个数; +2. **标签元素读的是"某一标签列在每一行上的那一格"**,不是"这条记录的第几个字符串"; +3. **数据窗口里标签格排在最前面**,就地改的就是那一格。 + +### 35.2 口径只有一处:`XChartColumnMath` 的标签半边 + +`LabelCount` / `LabelSlotOf` / `DefinitionOfLabelSlot` 与数值那三支(`ValueCount` / `ValueSlot` / +`DefinitionOfValueSlot`)完全对称;`SizedLabels` 是"记录标签长度"的**唯一**定长处。 + +- 记录身上两个数组都是**槽下标**(Number 列里的序号 / Label 列里的序号),不是表行号—— + 表是 `x, tag, t, note` 时,`note` 在表里是第 3 行、在标签数组里是第 1 格(§21.7 的同一条规矩)。 +- **为什么必须在门口拦**:一条记录能带出比列更多的字符串,那些字符串没有一个列叫得出名字—— + 于是窗口显示得出来、元素读不到;导入能塞进去、导出再读回来就变样。所以 `TryAddRecord` 在 + `labels` 非 null 且长度 ≠ `LabelDimensionCount` 时整条拒收;导入按 `labelFields != labelCount` 拒并点名行号; + 删列之后按 `SizedLabels` 重排(唯一路径)。 +- 文本格式第 2 版本来就带标签字段;本轮补的是**导入侧的校验**(以前默认"多出来的那些就是标签"), + 顺带补上"记录行少到连时间戳都没有"时点名拒绝——那条路原来直接读 `fields[1]`,抛的是异常不是判决。 + +### 35.3 数据窗口:一个显示序,两个读者 + +- `ComputeColumnSlots` 一次算出 `m_ColumnValueSlots`、`m_ColumnLabelSlots`、`m_TableDisplayOrder`(标签列在前); + 表头与行**都**遍历这一个显示序——两处各排一遍,就会出现"表头写的是标签、格子填的是数值"。 +- 每格的身份是 `CellRef { IsLabel, Slot }`:`-1` 仍然只有一个含义(这一列不占格),不拿它兼任"标签格"。 +- 标签格走 `CommitCell` 的**字符串**分支(`TrySetLabel`):数字解析会把"甲""巷道1"当错报拒掉, + 而"就地编辑却碰壁"正是他要的那条路被堵死的样子。 +- 工具栏加了「+标签」:加的是 `XChartDimensionKind.Label` 维,走 `SetDimensions`(唯一定长路径), + 老记录那一格补空串、**不挤走旧标签**。 +- 表格签名带上 `L` / `V`:两张表列数相同但种类不同(或标签列换位置)时,旧行必须重造。 + +### 35.4 标签元素(`ChartToolLabels` + `XChartLabelConfig`) + +- 13 个旋钮,**全部**经 `MarkDirty`(`dirty_gate` 149/149)。 +- 位置与折法和散点/圆柱走同一份:`XChartCubeFoldMath`,显示范围只定标尺(§32),超范围三档自己决定。 +- 文本走池:`RequestTextSlots(records)`;**比记录多的槽位必须擦**——上一轮表更长时留下的字会原地不动, + 而那在画面上和"新数据"长得一样。 +- 锚点与对齐出自**一张表**:`AnchorOf` 给 pivot,`AlignmentFor` 由同一个锚点算出来;`anchorMin/Max` + **不写**(保持池默认),否则 `anchoredPosition` 的参照点会跟着换,同一个读数在两种锚法下答得不同。 +- 报表一行: + `labelSlot= dim= records= want= have= pending= written= cleared= empty= hidden= skipped= out= anchor= wrap=`。 + **数据侧**(`skipped` 读不出 / `empty` 那格是空的 / `hidden` 这一档自己藏了)与**槽位侧** + (`want/have/pending`)必须分开:`pending` 是"件还没发落",不是"这一行没标签"。 +- 面板把"要几个标签列、表里有几个"和数值维、记录数**一起**印(§25.1 的第三半,`RequiredLabelColumns`)。 + +### 35.5 探针在这一轮抓到两个真缺陷 + +- `SizedLabels(null, n)` 返回的是 **null 元素**而不是空串:窗口里两者都显示为空,但"这一格是空的"这条判据上 + null 与 `""` 各答一套(导入写出的永远是 `""`,往返一次就变了样)。改成空位一律 `string.Empty`。 +- 九档锚点表**漏了 `MiddleRight`**,落到 `default`(Center):所谓"九档"实际只有八档, + 而"贴在右边中点"与"贴在正中心"在画面上只差半格——探针的"九个点互不相同"当场红。 +- 这两条都是**判据先红、代码后改**(不是事后补判据):new assertion → red → fix → green。 + +### 35.6 判据 + +- **探针 492 条 0 失败**:新增两组——`label columns:`(只数 Label 列 / 表行→槽 / 反查 / 定长三种输入 / + 门口 1:1 / 改与越界 / 空 vs 不存在 / 删列对位)与 `label anchor:`(九档互异 + 五个坐标 + 非有限偏移); + 原 `data text:` 的标签断言按新口径重写(记录带 1 个标签列;没给标签的记录**仍有那一格**、是空串)。 +- **`label_gate.py`**:15 条 claim、15 支臂全红(每条 claim 一支变异:标签槽手数 / 标签走数字门 / 标签列不在最前 / + 绕开唯一定长 / 对齐不再读锚点表 / 对齐留池默认 / pivot 居中 / 原始偏移 / 多余槽位不擦 / 读数混在一起 / + 空串当缺失 / 永远读第 0 列 / 面板不印要求 / 导入不查字段数 / 门口不查长度)。 + C7 的 forbidden 只认**写**(`anchorMin =`):注释里解释"为什么不写"不算违规——判据不许打在文字上。 +- **`p4_control` 78 支**(新增 5 支:标签槽手数、记录自定标签长度、边中点锚点落到中心、非有限偏移直通、 + 删标签列留错那一格)。原来"删列留旧值"那支的锚点因 `TryRemoveDimension` 重写而失效,已**重定靶**(不是删掉)。 +- **`dirty_gate`** 149 旋钮 149 生效(新增 13 个;清单 `Text/ChartToolLabels.cs` 已登记); + **`slot_reset_gate`** 不变(P26a 的池复位早就在里面);编译门 runtime + player + editor + 3 对照绿, + 并且 `source present:` 逐条点名四个新文件(`XChartLabelAnchorMath` / `ChartToolLabels` / `XChartLabelConfig` / `XChartDataText`)。 + +### 35.7 覆盖不到什么 / 他侧验收 + +- 离线判不到 TMP:`AlignmentFor` 返回 TMPro 类型,探针引用不到那个程序集——"对齐出自同一表"这一半由源码门 + (C5/C6)判,画面归他。 +- 现场看三件事:① 数据窗口每行**最前面**是标签格,改完图上的字跟着变;② 报表 `written=` 等于有字标签的记录数、 + `pending=0`;③ 点「+标签」后老记录那一格是空的(不是把旧标签挤走)。 \ No newline at end of file diff --git a/Editor/XChart/XChartBaseEditor.cs b/Editor/XChart/XChartBaseEditor.cs index 072c81a..62857c2 100644 --- a/Editor/XChart/XChartBaseEditor.cs +++ b/Editor/XChart/XChartBaseEditor.cs @@ -229,9 +229,15 @@ namespace XericUI.XChart.Editor // 位置是唯一权威——再多两个手填的格子,就会出现"位置与数字各说一套", // 而"上移之后绘制顺序到底变没变"这个问题就没人回答得了。 - // 这个元素要几个数值维、几条记录,表里现在各有多少——**三个数一起印**(§25.1)。 + // 这个元素要几个数值维、几条记录、几个标签列,表里现在各有多少——**三个数一起印**(§25.1)。 // "加了工具但什么都没显示"最常见的原因就是形状不够,而画面上两者长得一模一样。 - if (config.RequiredNumericDimensions > 0) + // 标签列也归进来:标签元素读的是"某一列在每一行上的那一格",表里没这一列时它一条都不画, + // 而这一支在画面上和"没数据"同形——只印数值维和记录数就会漏掉这一半。 + int needDims = config.RequiredNumericDimensions; + int needRecords = config.RequiredRecordCount; + int needLabels = config.RequiredLabelColumns; + + if (needDims > 0 || needRecords > 0 || needLabels > 0) { int haveDims = chart != null && chart.DataModel != null ? chart.DataModel.NumericDimensionCount @@ -239,18 +245,27 @@ namespace XericUI.XChart.Editor int haveRecords = chart != null && chart.DataModel != null ? chart.DataModel.RecordCount : 0; - int needDims = config.RequiredNumericDimensions; - int needRecords = config.RequiredRecordCount; + int haveLabels = chart != null && chart.DataModel != null + ? chart.DataModel.LabelDimensionCount + : 0; string dimsPart = "需要 " + needDims + " 个数值维,表现在有 " + haveDims + " 个"; string recordsPart = needRecords > 0 ? ";需要 " + needRecords + " 条记录,表现在有 " + haveRecords + " 条" : string.Empty; - bool shortOfShape = haveDims < needDims || haveRecords < needRecords; - block.Body.Add(MakeReadonly(dimsPart + recordsPart + string labelsPart = needLabels > 0 + ? ";需要 " + needLabels + " 个标签列,表现在有 " + haveLabels + " 个" + : string.Empty; + + bool shortOfShape = haveDims < needDims + || haveRecords < needRecords + || haveLabels < needLabels; + + block.Body.Add(MakeReadonly(dimsPart + recordsPart + labelsPart + (shortOfShape ? " ⇒ 画不出来(报表里 dims=" + haveDims + "/" + needDims - + " records=" + haveRecords + ")" + + " records=" + haveRecords + + " labels=" + haveLabels + "/" + needLabels + ")" : string.Empty))); } diff --git a/Editor/XChart/XChartDataWindow.cs b/Editor/XChart/XChartDataWindow.cs index 2c433d7..ed09a80 100644 --- a/Editor/XChart/XChartDataWindow.cs +++ b/Editor/XChart/XChartDataWindow.cs @@ -41,9 +41,22 @@ namespace XericUI.XChart.Editor /// 每一列对应的值下标(-1=这一列不占值格);表头与格子共用,规则来自 private int[] m_ColumnValueSlots = new int[0]; - /// 上面那组的签名:换一张同列数但种类不同的图时,旧行里的格子必须重造 + /// 每一列对应的标签下标(-1=这一列不占标签格)。与值下标是同一套规则的两半: + /// 值数组按"第几个数值列"排,标签数组按"第几个标签列"排,所以两边都只有一个换算处 + private int[] m_ColumnLabelSlots = new int[0]; + + /// 表页的显示序:标签列排在最前(他 2026-10-26 要的是"这一族直接在窗口里编辑", + /// 排在每行最前面才不用横向拖到表尾去找)。表头和行里的格子按同一份排,否则列标题和格子对不上。 + private int[] m_TableDisplayOrder = new int[0]; + + /// 值格分布的签名(表里的行序):范围页按它判"要不要整页重建"——一列一行不能指错列 private string m_ColumnValueSignature = string.Empty; + /// 行里那一排格子的签名(种类 + 下标 + 显示序):换一张同列数、种类不同的图, + /// 或标签列排到了前面,旧行的格子必须重造。只看列数会把"这一格是标签格还是数值格"当成没变—— + /// 那正是往错的列写数的路 + private string m_TableSignature = string.Empty; + /// 范围页是在哪一份值格分布上建的:对不上就整页重建(一列一行不能指错列) private string m_RangeSignature = string.Empty; private bool m_Applying; @@ -246,12 +259,35 @@ namespace XericUI.XChart.Editor { int dimensions = model != null ? model.Dimensions.Count : 0; m_ColumnValueSlots = new int[dimensions]; + m_ColumnLabelSlots = new int[dimensions]; for (int i = 0; i < dimensions; i++) + { m_ColumnValueSlots[i] = XChartColumnMath.ValueSlot(model.Dimensions, i); + m_ColumnLabelSlots[i] = XChartColumnMath.LabelSlotOf(model.Dimensions, i); + } - var signature = new System.Text.StringBuilder(); - for (int i = 0; i < dimensions; i++) signature.Append(m_ColumnValueSlots[i]).Append('|'); - m_ColumnValueSignature = signature.ToString(); + // 显示序:标签列在前、其余列照表里的顺序。这里只算一次,表头和行共用, + // 所以"第几列显示在哪"与"这一格属于哪一列"不会各数各的。 + m_TableDisplayOrder = new int[dimensions]; + int at = 0; + for (int i = 0; i < dimensions; i++) + if (m_ColumnLabelSlots[i] >= 0) m_TableDisplayOrder[at++] = i; + for (int i = 0; i < dimensions; i++) + if (m_ColumnLabelSlots[i] < 0) m_TableDisplayOrder[at++] = i; + + var valueSignature = new System.Text.StringBuilder(); + var tableSignature = new System.Text.StringBuilder(); + for (int i = 0; i < dimensions; i++) + { + valueSignature.Append(m_ColumnValueSlots[i]).Append('|'); + + int column = m_TableDisplayOrder[i]; + tableSignature.Append(m_ColumnLabelSlots[column] >= 0 + ? "L" + m_ColumnLabelSlots[column] + : "V" + m_ColumnValueSlots[column]).Append('|'); + } + m_ColumnValueSignature = valueSignature.ToString(); + m_TableSignature = tableSignature.ToString(); } /// 工具栏上的一个下拉:条目按顺序排,点哪个跑哪个 @@ -294,16 +330,20 @@ namespace XericUI.XChart.Editor }); m_Header.Add(new Label("时间") { style = { width = kTimeWidth } }); - for (int i = 0; i < dimensions; i++) + for (int pos = 0; pos < dimensions; pos++) { - int index = i; - int valueSlot = m_ColumnValueSlots[i]; + int index = m_TableDisplayOrder[pos]; + int valueSlot = m_ColumnValueSlots[index]; + bool isLabel = m_ColumnLabelSlots[index] >= 0; + var cell = new VisualElement { style = { flexDirection = FlexDirection.Row, width = kCellWidth } }; var name = new TextField { style = { flexGrow = 1 } }; name.SetValueWithoutNotify(ColumnName(model, index)); name.tooltip = "列标题=这一维的显示名;改它只改显示名,维度序号不动" - + (valueSlot < 0 ? "(这一列不占值格:种类不是 Number)" : string.Empty); + + (isLabel + ? "(这一列占的是标签格:每一行在这一格直接写字符串)" + : (valueSlot < 0 ? "(这一列不占值格:种类不是 Number)" : string.Empty)); name.RegisterCallback(evt => { if (evt.keyCode != KeyCode.Return && evt.keyCode != KeyCode.KeypadEnter) return; @@ -329,8 +369,14 @@ namespace XericUI.XChart.Editor style = { width = kAddColumnWidth }, tooltip = "加一列(新增一个数值维,默认名 D,随后可在这里改名)", }); - m_Header.Add(new Label("标签") { style = { flexGrow = 1 }, tooltip = "记录自带的标签(只读)" }); - // 行末"删"那一格的位置:表头留同样的宽度,否则标签列和删列对不齐 + m_Header.Add(new ToolbarButton(AddLabelColumn) + { + text = "+标签", + style = { width = 52 }, + tooltip = "加一个标签列(String 维):每一行在最前面那一格直接写它。" + + "记录身上的标签数组长度=标签列个数,所以这一格没有列叫得出名字时它压根存不进去", + }); + // 行末"删"那一格的位置:表头留同样的宽度,否则最后一列和删列对不齐 m_Header.Add(new Label { style = { width = kDeleteWidth } }); } @@ -379,6 +425,29 @@ namespace XericUI.XChart.Editor SetMessage("已加一列(" + key + "):老记录这一维补 0"); } + /// + /// 加一个标签列=新增一个 String 维。走的是 SetDimensions 那一条路(唯一的定长处), + /// 所以老记录的标签数组会跟着变长、补空串——不是在窗口里凭空多一个"没主的格子"。 + /// + private void AddLabelColumn() + { + var model = m_Chart != null ? m_Chart.DataModel : null; + if (model == null) { SetMessage("先指定一个图表"); return; } + + var dimensions = new List(model.Dimensions); + string key = "label" + dimensions.Count; + dimensions.Add(new XChartDimensionDefinition(key, + "标签" + (XChartColumnMath.LabelCount(dimensions) + 1), XChartDimensionKind.Label)); + model.SetDimensions(dimensions); + EditorUtility.SetDirty(m_Chart); + m_Chart.ForceRefresh(); + + RebuildColumns(); + RebuildList(); + SetMessage("已加一个标签列(" + key + "):老记录这一格补空串,现在每行 " + + model.NumericDimensionCount + " 个值、" + model.LabelDimensionCount + " 个标签"); + } + /// /// 删一列=删掉一个维度定义,连同每一行的那一格。 /// 破坏性动作要看得见代价:先把整表留在剪贴板(和"清空"同一个安全网),再要一次确认—— @@ -503,27 +572,41 @@ namespace XericUI.XChart.Editor cells.Add(widgets.Time); int dimensions = Mathf.Max(m_DimensionCount, 0); - widgets.Values = new TextField[dimensions]; - widgets.Slots = m_ColumnValueSignature; - for (int i = 0; i < dimensions; i++) + widgets.Cells = new TextField[dimensions]; + widgets.Slots = m_TableSignature; + for (int pos = 0; pos < dimensions; pos++) { - int valueSlot = i < m_ColumnValueSlots.Length ? m_ColumnValueSlots[i] : -1; - var cell = new TextField { userData = valueSlot, style = { width = kCellWidth } }; - if (valueSlot < 0) + int column = pos < m_TableDisplayOrder.Length ? m_TableDisplayOrder[pos] : -1; + int labelSlot = column >= 0 ? m_ColumnLabelSlots[column] : -1; + int valueSlot = column >= 0 ? m_ColumnValueSlots[column] : -1; + + var target = new CellRef { IsLabel = labelSlot >= 0, Slot = labelSlot >= 0 ? labelSlot : valueSlot }; + var cell = new TextField { userData = target, style = { width = kCellWidth } }; + + if (labelSlot >= 0) { - // 非数值列:没有对应的值格。留一个禁用的格子而不是让人填进去再被拒—— - // 他填过却存不进去,比一眼看出"这一格不归我改"更坏。 - cell.SetEnabled(false); - cell.tooltip = "这一列的种类不是 Number ⇒ 它不占值格(值数组里没有它的位置)"; + // 标签格:这一族的本分就是就地编辑(他 2026-10-26 要的"直接在前面上编辑")。 + // 它不能走数字解析那一支——标签是字符串,把"不是数字"当错报会把正常的标签拒掉。 + cell.tooltip = "这一行的标签(String 维):直接写,回车或失焦提交。" + + "标签元素按记录读它(一条记录一个标签),所以这一格存的就是画面上那个字"; + HookCommit(cell, () => CommitCell(cell)); } - else HookCommit(cell, () => CommitCell(cell)); - widgets.Values[i] = cell; + else if (valueSlot >= 0) + { + HookCommit(cell, () => CommitCell(cell)); + } + else + { + // 既不占值格也不占标签格(比如 Time 列在表里的那一行):留一个禁用的格子而不是 + // 让人填进去再被拒——他填过却存不进去,比一眼看出"这一格不归我改"更坏。 + cell.SetEnabled(false); + cell.tooltip = "这一列不占格:种类既不是 Number 也不是 Label(值数组和标签数组里都没有它的位置)"; + } + + widgets.Cells[pos] = cell; cells.Add(cell); } - widgets.Labels = new Label { style = { flexGrow = 1 } }; - cells.Add(widgets.Labels); - widgets.Delete = new ToolbarButton(() => DeleteRecord(widgets)) { text = "-", // 一个符号就够(他 2026-10-25:"删除按钮应该改为 -,而不是一个'删'") @@ -553,10 +636,11 @@ namespace XericUI.XChart.Editor var existing = element.Q("row-cells"); var widgets = existing != null ? existing.userData as RowWidgets : null; int want = Mathf.Max(m_DimensionCount, 0); - // 列数一样但"哪一列有值格"变了(换了一张同列数、种类不同的图):格子的可编辑性与 - // 值下标都记在格子上,只看列数会把这一列当成能改的,于是往错的列写数 - if (widgets != null && widgets.Values != null && widgets.Values.Length == want - && widgets.Slots == m_ColumnValueSignature) return widgets; + // 列数一样但"每一格是哪一列、哪个种类"变了(换了一张同列数、种类不同的图,或者标签列 + // 排到了前面):格子的可编辑性与下标都记在格子上,只看列数会把标签格当数值格解析, + // 于是正常的标签被"不是数字"拒掉 + if (widgets != null && widgets.Cells != null && widgets.Cells.Length == want + && widgets.Slots == m_TableSignature) return widgets; element.Clear(); var fresh = MakeRow(); @@ -620,12 +704,29 @@ namespace XericUI.XChart.Editor if (widgets == null || widgets.RecordIndex < 0) return; int recordIndex = widgets.RecordIndex; bool isTime = ReferenceEquals(field, widgets.Time); - int slot = field.userData is int value ? value : -1; - if (!isTime && slot < 0) return; // 非数值列的格子是禁用的,压根不该走到这里 + var target = field.userData as CellRef; + int slot = target != null ? target.Slot : -1; + if (!isTime && slot < 0) return; // 不占格的列:格子是禁用的,压根不该走到这里 var model = m_Chart.DataModel; if (model == null || recordIndex < 0 || recordIndex >= model.RecordCount) return; + if (!isTime && target.IsLabel) + { + // 标签格走字符串那一支:数字解析会把正常的标签("甲"、"巷道1")当错报拒掉, + // 而"这一格存不进去"正是他要就地编辑却碰壁的那条路。 + if (!model.TrySetLabel(recordIndex, slot, field.value)) + { + SetMessage("第 " + recordIndex + " 行的第 " + slot + " 个标签改不动(行号或标签列下标越界)"); + RefreshRow(widgets, recordIndex); + return; + } + + m_Chart.ForceRefresh(); + SetMessage("第 " + recordIndex + " 行的标签已改(标签元素按这一格读)"); + return; + } + double parsed; if (!double.TryParse(field.value, System.Globalization.NumberStyles.Float, System.Globalization.CultureInfo.InvariantCulture, out parsed)) @@ -670,18 +771,34 @@ namespace XericUI.XChart.Editor widgets.Index.text = "#" + index; widgets.Time.SetValueWithoutNotify(model.GetTimeAt(index).ToString("0.###")); - for (int d = 0; d < widgets.Values.Length; d++) - { - if (widgets.Values[d] == null) continue; - // 格子的下标是**表里的列号**,值数组的下标是**第几个数值列**:中间夹一个非数值列时 - // 两者就差开了,所以这里问的是行控件建好时记下的那一对(widgets.Slots)。 - int slot = d < m_ColumnValueSlots.Length ? m_ColumnValueSlots[d] : -1; - string text = slot >= 0 ? model.GetValueAt(index, slot).ToString("0.####") : "-"; - widgets.Values[d].SetValueWithoutNotify(text); - } - var record = model.Records[index]; - widgets.Labels.text = record.Labels.Count > 0 ? string.Join(", ", record.Labels) : string.Empty; + + // 每一格读自己那块牌(CellRef):格子的**显示位置**是显示序(标签格排前面), + // 而值/标签数组的下标是"第几个那一类的列",两者对不上是这套表页的基本事实—— + // 按位置数格子就是"上一版把标签格当数值格填"的那条路。 + for (int d = 0; d < widgets.Cells.Length; d++) + { + var cell = widgets.Cells[d]; + if (cell == null) continue; + var target = cell.userData as CellRef; + if (target == null || target.Slot < 0) + { + cell.SetValueWithoutNotify("-"); // 不占格的列(比如 Time 那一行) + continue; + } + + string text; + if (target.IsLabel) + { + // 空串照实显示(这一格被清空过),不是"没有这一格":两者要分得开 + text = target.Slot < record.Labels.Count ? (record.Labels[target.Slot] ?? string.Empty) : string.Empty; + } + else + { + text = model.GetValueAt(index, target.Slot).ToString("0.####"); + } + cell.SetValueWithoutNotify(text); + } } /// 删一行=删一条记录。删完立刻重排行号(列表多/少一行都要跟着改) @@ -715,7 +832,10 @@ namespace XericUI.XChart.Editor if (m_Stats != null) { + // 每行的两个数组长度都在这里印出来:1:1 是形状,看得见的那个数字才是判据 m_Stats.text = "总行 " + total + " 维度 " + dimensions + + " 每行 " + (model != null ? model.NumericDimensionCount : 0) + " 个值、" + + (model != null ? model.LabelDimensionCount : 0) + " 个标签" + " 已丢弃 " + (model != null ? model.DroppedCount : 0); } @@ -1135,14 +1255,25 @@ namespace XericUI.XChart.Editor public int RecordIndex = -1; public Label Index; public TextField Time; - public TextField[] Values; - /// 建这一行时"哪一列有值格"的签名;对不上就整条重造(格子是禁用的还是可编辑的都记在格子上) + /// 每一列的格子,按显示序排(标签格在前,其后数值格)。 + /// 格子种类不同(标签写字符串、数值写数字)所以不能靠"第几格"猜它是哪一列 + public TextField[] Cells; + + /// 建这一行时"每一格是哪个种类、哪一下标"的签名;对不上就整条重造 + /// (格子是禁用的还是可编辑的、走数字解析还是字符串提交,都记在格子上) public string Slots; - public Label Labels; public ToolbarButton Delete; } + /// 格子背后那一列的身份:IsLabel 决定 Slot 是标签下标还是值下标。 + /// 两个含义不许挤在同一个数上(-1 已经被"这一列不占格"占了),所以种类写在明面上。 + private sealed class CellRef + { + public bool IsLabel; + public int Slot = -1; + } + /// 范围页里一列的那一行控件 private sealed class DimensionRow { diff --git a/Runtime/XChart/Radar/XRadarChart.cs b/Runtime/XChart/Radar/XRadarChart.cs index 7b3acd3..d58b05a 100644 --- a/Runtime/XChart/Radar/XRadarChart.cs +++ b/Runtime/XChart/Radar/XRadarChart.cs @@ -208,18 +208,32 @@ namespace XericUI.XChart.Radar /// 设置维度名称 public void SetDimensions(params string[] dimensionNames) { - m_DataModel.SetDimensions(dimensionNames); - var dimensions = new System.Collections.Generic.List(dimensionNames.Length); - for (int i = 0; i < dimensionNames.Length; i++) - dimensions.Add(new XChartDimensionDefinition($"radar_{i}", dimensionNames[i], XChartDimensionKind.Number)); - DataModel.SetDimensions(dimensions); - // 由 Update 自动同步 + ApplyDimensionNames(dimensionNames); } /// 设置维度名称(从列表) public void SetDimensions(System.Collections.Generic.IList dimensionNames) + { + var names = new string[dimensionNames != null ? dimensionNames.Count : 0]; + for (int i = 0; i < names.Length; i++) names[i] = dimensionNames[i]; + ApplyDimensionNames(names); + } + + /// + /// 两个重载都走这里: 给每条记录带一个系列名, + /// 而共享表要有一个标签列那个名字才落得进去(1:1 是门口那条规矩)。 + /// 只更新雷达自己的模型、不交代共享表,系列名就会被整条记录一起拒掉。 + /// + private void ApplyDimensionNames(string[] dimensionNames) { m_DataModel.SetDimensions(dimensionNames); + if (dimensionNames == null) return; + + var dimensions = new System.Collections.Generic.List(dimensionNames.Length + 1); + for (int i = 0; i < dimensionNames.Length; i++) + dimensions.Add(new XChartDimensionDefinition($"radar_{i}", dimensionNames[i], XChartDimensionKind.Number)); + dimensions.Add(new XChartDimensionDefinition("series", "系列", XChartDimensionKind.Label)); + DataModel.SetDimensions(dimensions); } /// 添加一个数据系列(自动分配颜色) diff --git a/Runtime/XChart/Text.meta b/Runtime/XChart/Text.meta new file mode 100644 index 0000000..8ffc4d4 --- /dev/null +++ b/Runtime/XChart/Text.meta @@ -0,0 +1,8 @@ +fileFormatVersion: 2 +guid: 2b931f6ed464bca4daa43d0230027e92 +folderAsset: yes +DefaultImporter: + externalObjects: {} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Runtime/XChart/Text/ChartToolLabels.cs b/Runtime/XChart/Text/ChartToolLabels.cs new file mode 100644 index 0000000..eb84071 --- /dev/null +++ b/Runtime/XChart/Text/ChartToolLabels.cs @@ -0,0 +1,268 @@ +using System; +using TMPro; +using UnityEngine; +using XericUI.Core; +using XericUI.XChart.Space; + +namespace XericUI.XChart.Text +{ + /// + /// 数据标签元素:一条记录一个标签,标签读的是那一行在某一标签列上的字符串。 + /// + /// 1:1 是结构保证而不是约定:记录身上的标签数组长度=标签列个数, + /// 所以这一列读得到的就是那一行的那一格;比列更多的字符串没有列叫得出它的名字, + /// 它在窗口里显示得出来、元素读不到(口径只有一份:)。 + /// 一条记录配几个数值维+一个字符串维,画面上就是"点+它自己的名字"。 + /// + /// 位置从哪儿来:和散点/圆柱/矢量场同一个空间与同一份折法 + /// (),显示范围只定标尺;超范围怎么办由这一档自己决定(§32)。 + /// 显示从哪儿来:文本槽位池(运行时里唯一造 TMP 标签的地方),一件对应一条记录。 + /// + /// 锚点和对齐出自同一张表:贴在左下角却把字居中,字就会横跨在那一点两侧。 + /// 锚点决定矩形从哪一侧从点起排,对齐由同一个锚点算出来()。 + /// + /// 子节点结构: + /// [Labels] + /// └─ GeneratedTexts(文本槽位的宿主) + /// + [AddComponentMenu(XericRegistrationPaths.Chart + "/Text/Data Label Tool")] + public class ChartToolLabels : XChartToolBase + { + // ── 数据装配 ────────────────────────────────────────────── + + private int m_LabelSlot; + /// 读第几个标签列(不是表里的行号;换算只有 那一处) + public int LabelSlot { get => m_LabelSlot; set { m_LabelSlot = value; MarkDirty(); } } + + private int m_DimensionX; + /// 标签挂在哪条记录的哪一个位置:三个数值维下标(显示范围归 chart 的数据维度行) + public int DimensionX { get => m_DimensionX; set { m_DimensionX = value; MarkDirty(); } } + private int m_DimensionY = 1; + public int DimensionY { get => m_DimensionY; set { m_DimensionY = value; MarkDirty(); } } + private int m_DimensionZ = 2; + public int DimensionZ { get => m_DimensionZ; set { m_DimensionZ = value; MarkDirty(); } } + + private XChartToolTransform m_Transform = XChartToolTransform.Identity; + public XChartToolTransform Transform { get => m_Transform; set { m_Transform = value; MarkDirty(); } } + + private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs; + /// 标签的位置受显示范围之外的影响时怎么办(§32:范围只定标尺,画不画由数据图元自己决定) + public XChartValueOutOfRange OutOfRange { get => m_OutOfRange; set { m_OutOfRange = value; MarkDirty(); } } + + // ── 外观 ────────────────────────────────────────────────── + + private XChartLabelAnchor m_Anchor = XChartLabelAnchor.UpperCenter; + /// 标签矩形相对它那一点的位置(9 档)。文字对齐由同一档算出来,不另给一个字段 + public XChartLabelAnchor Anchor { get => m_Anchor; set { m_Anchor = value; MarkDirty(); } } + + private Vector2 m_Offset = new Vector2(0f, 6f); + /// 从那个点再挪多少像素(非有限数按零算:NaN 进 anchoredPosition 会把这一件字整个挪出画面而不报错) + public Vector2 Offset { get => m_Offset; set { m_Offset = value; MarkDirty(); } } + + private int m_FontSize = 14; + public int FontSize { get => m_FontSize; set { m_FontSize = Mathf.Max(1, value); MarkDirty(); } } + + private Color m_LabelColor = Color.white; + public Color LabelColor { get => m_LabelColor; set { m_LabelColor = value; MarkDirty(); } } + + private float m_OutlineWidth; + public float OutlineWidth { get => m_OutlineWidth; set { m_OutlineWidth = Mathf.Max(0f, value); MarkDirty(); } } + + private Vector2 m_RectSize = new Vector2(160f, 30f); + public Vector2 RectSize { get => m_RectSize; set { m_RectSize = new Vector2(Mathf.Max(0f, value.x), Mathf.Max(0f, value.y)); MarkDirty(); } } + + private bool m_Wrap; + public bool Wrap { get => m_Wrap; set { m_Wrap = value; MarkDirty(); } } + + // ── 内部 ────────────────────────────────────────────────── + + private bool m_GeometryDirty = true; + private long m_LastDataVersion = -1; + private int m_LastSpaceVersion = -1; + private Matrix4x4 m_Composed = Matrix4x4.identity; + + private int m_Records; + private int m_Written; + private int m_Cleared; + private int m_Empty; + private int m_Hidden; + private int m_Skipped; + + public override void MarkDirty() => m_GeometryDirty = true; + + public override void OnRender() + { + base.OnRender(); + var space = Context?.Space; + if (space == null) return; + + var data = Data; + bool spaceChanged = space.ProjectionVersion != m_LastSpaceVersion; + bool dataChanged = data != null && data.Version != m_LastDataVersion; + if (!m_GeometryDirty && !spaceChanged && !dataChanged) return; + + if (spaceChanged || dataChanged) m_GeometryDirty = true; + m_LastSpaceVersion = space.ProjectionVersion; + m_LastDataVersion = data != null ? data.Version : -1; + m_Composed = space.Compose(Transform); + + if (data == null || !data.HasData) + { + m_Records = 0; + RequestTextSlots(0); + ClearTexts(); + m_GeometryDirty = false; + return; + } + + int records = data.RecordCount; + m_Records = records; + RequestTextSlots(records); + + double minX, maxX, minY, maxY, minZ, maxZ; + ResolveRange(DimensionX, out minX, out maxX); + ResolveRange(DimensionY, out minY, out maxY); + ResolveRange(DimensionZ, out minZ, out maxZ); + + var texts = Texts; + m_Written = 0; + m_Cleared = 0; + m_Empty = 0; + m_Hidden = 0; + m_Skipped = 0; + + for (int i = 0; i < records; i++) + { + bool ready = i < texts.Count && texts[i] != null; + + string text; + if (!data.TryGetLabelAt(i, LabelSlot, out text)) + { + // 这一列没有这一格:数据不可用(不是"标签是空的") + m_Skipped++; + if (ready) BlankSlot(texts[i]); + continue; + } + + if (string.IsNullOrEmpty(text)) + { + // 那一格是空的(被清空过):这一件不画字,照实擦掉上一轮的字 + m_Empty++; + if (ready) BlankSlot(texts[i]); + continue; + } + + double x = data.GetValueAt(i, DimensionX); + double y = data.GetValueAt(i, DimensionY); + double z = data.GetValueAt(i, DimensionZ); + + // 三个 out 先给初值:`&&` 短路时后面那两次调用根本没跑,编译器认不出"折得成就说明三个都赋过" + // (散点那一处是 `if (!a || !b || !c) continue;` 的写法,所以它没这个问题) + float fx = 0f, fy = 0f, fz = 0f; + bool foldable = XChartCubeFoldMath.TryRatio01(x, minX, maxX, OutOfRange, out fx) + && XChartCubeFoldMath.TryRatio01(y, minY, maxY, OutOfRange, out fy) + && XChartCubeFoldMath.TryRatio01(z, minZ, maxZ, OutOfRange, out fz); + + if (!foldable) + { + // 三个数都可用却被拒 ⇒ 是这一档主动不画;否则是坏数据(本来就不该画,另算) + if (!IsBad(x) && !IsBad(y) && !IsBad(z)) m_Hidden++; + else m_Skipped++; + if (ready) BlankSlot(texts[i]); + continue; + } + + if (!ready) continue; // 件还没到位:欠着件不算"这一行没标签"(pending= 那一行说的是它) + + Vector2 local = space.Project(ChartToolSpace.NormalizedToCube(new Vector3(fx, fy, fz)), m_Composed) + + XChartLabelAnchorMath.SafeOffset(Offset); + + WriteLabel(texts[i], local, text); + m_Written++; + } + + // 槽位数比记录数多(上一轮表更长)时多出来的那些必须擦干净,否则上一轮的标签留在原地 + for (int i = records; i < texts.Count; i++) + if (texts[i] != null) BlankSlot(texts[i]); + + m_GeometryDirty = texts.Count < records; + } + + private void BlankSlot(TMP_Text slot) + { + slot.text = string.Empty; + m_Cleared++; + } + + private void WriteLabel(TMP_Text label, Vector2 local, string text) + { + Vector2 anchor = XChartLabelAnchorMath.AnchorOf(Anchor); + + label.text = text; + label.fontSize = FontSize; + label.color = LabelColor; + label.enableWordWrapping = Wrap; + label.outlineWidth = OutlineWidth; + label.alignment = XChartLabelAnchorMath.AlignmentFor(Anchor); + + var rect = label.rectTransform; + rect.sizeDelta = RectSize; + // 锚点写在 pivot 上:这样"那一格从点起排"和"点正好落在矩形的这一角"是同一件事。 + // anchorMin/Max 留在池的默认(中心),否则 anchoredPosition 的参照点会跟着换, + // 同一个读数在两种锚法下答得不同。 + rect.pivot = anchor; + rect.anchoredPosition = local; + } + + private void ClearTexts() + { + var texts = Texts; + m_Cleared = 0; + for (int i = 0; i < texts.Count; i++) + if (texts[i] != null) BlankSlot(texts[i]); + } + + /// 显示范围只问上下文要(覆盖优先、否则该维聚合):元素自己存一份范围就是"标签和轴对不上"的来路 + private void ResolveRange(int dimension, out double min, out double max) + { + var context = Context; + if (context != null && context.TryResolveDomain(dimension, out min, out max)) return; + min = 0.0; + max = 1.0; + } + + private static bool IsBad(double value) + => double.IsNaN(value) || double.IsInfinity(value); + + protected override void OnDispose() + { + m_Records = 0; + m_Written = 0; + } + +#if UNITY_EDITOR + /// + /// 报表里这一行只印"这一帧到底有没有写、没写的话卡在哪":数据侧(skipped/hidden/empty) + /// 与槽位侧(want/have/pending)必须分开,否则"这一行没标签"和"件还没发落"在画面上同形。 + /// + internal override void AppendDebugLine(System.Text.StringBuilder sb) + { + base.AppendDebugLine(sb); + sb.Append(" labelSlot=").Append(LabelSlot) + .Append(" dim=").Append(DimensionX).Append('/').Append(DimensionY).Append('/').Append(DimensionZ) + .Append(" records=").Append(m_Records) + .Append(" want=").Append(RequestedTextCount) + .Append(" have=").Append(Texts.Count) + .Append(" pending=").Append(TextSlotsPending) + .Append(" written=").Append(m_Written) + .Append(" cleared=").Append(m_Cleared) + .Append(" empty=").Append(m_Empty) + .Append(" hidden=").Append(m_Hidden) + .Append(" skipped=").Append(m_Skipped) + .Append(" out=").Append(OutOfRange.ToString().ToLower()) + .Append(" anchor=").Append(Anchor.ToString().ToLower()) + .Append(" wrap=").Append(Wrap); + } +#endif + } +} diff --git a/Runtime/XChart/Text/ChartToolLabels.cs.meta b/Runtime/XChart/Text/ChartToolLabels.cs.meta new file mode 100644 index 0000000..24a1b2e --- /dev/null +++ b/Runtime/XChart/Text/ChartToolLabels.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 04e8bfc387c126047b089da0749b1cda +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Runtime/XChart/Text/XChartLabelAnchorMath.cs b/Runtime/XChart/Text/XChartLabelAnchorMath.cs new file mode 100644 index 0000000..1612ee4 --- /dev/null +++ b/Runtime/XChart/Text/XChartLabelAnchorMath.cs @@ -0,0 +1,72 @@ +using System; +using TMPro; +using UnityEngine; + +namespace XericUI.XChart.Text +{ + /// 标签矩形相对它那一点的位置:9 档(四角 + 四边中点 + 中心)。 + public enum XChartLabelAnchor + { + LowerLeft, + LowerCenter, + LowerRight, + MiddleLeft, + Center, + MiddleRight, + UpperLeft, + UpperCenter, + UpperRight, + } + + /// + /// 锚点的纯算部分(离线可验)。 + /// + /// 为什么锚点与对齐必须出自同一张表:锚定在左下角的矩形如果把字居中对齐, + /// 字就横跨在那一点两侧,"标签贴在点上"这句话当场作废。以前这两件事各写各的 + /// (锚点一处、对齐来自池的默认值),所以改锚点而字仍居中是画面上最难归因的一种错。 + /// + public static class XChartLabelAnchorMath + { + /// 九档锚点各自的那个位置([0,1] 内的矩形锚位)。九档互不相同是判据,不是巧合。 + public static Vector2 AnchorOf(XChartLabelAnchor anchor) + { + switch (anchor) + { + case XChartLabelAnchor.LowerLeft: return new Vector2(0f, 0f); + case XChartLabelAnchor.LowerCenter: return new Vector2(0.5f, 0f); + case XChartLabelAnchor.LowerRight: return new Vector2(1f, 0f); + case XChartLabelAnchor.MiddleLeft: return new Vector2(0f, 0.5f); + case XChartLabelAnchor.MiddleRight: return new Vector2(1f, 0.5f); + case XChartLabelAnchor.UpperLeft: return new Vector2(0f, 1f); + case XChartLabelAnchor.UpperCenter: return new Vector2(0.5f, 1f); + case XChartLabelAnchor.UpperRight: return new Vector2(1f, 1f); + default: return new Vector2(0.5f, 0.5f); // Center + } + } + + /// + /// 这一档锚点对应的文字对齐:由同一个锚点算出来(横分量取锚点的 x、纵分量取锚点的 y)。 + /// 这样"贴在左下角"和"字从左下角起排"是同一件事,不再有第二处定义。 + /// + public static TextAlignmentOptions AlignmentFor(XChartLabelAnchor anchor) + { + Vector2 a = AnchorOf(anchor); + if (Mathf.Abs(a.x - 0.5f) < 1e-4f && Mathf.Abs(a.y - 0.5f) < 1e-4f) return TextAlignmentOptions.Center; + if (Mathf.Abs(a.y - 0.5f) < 1e-4f) return a.x < 0.5f ? TextAlignmentOptions.MidlineLeft : TextAlignmentOptions.MidlineRight; + if (Mathf.Abs(a.x - 0.5f) < 1e-4f) return a.y < 0.5f ? TextAlignmentOptions.Bottom : TextAlignmentOptions.Top; + if (a.y < 0.5f) return a.x < 0.5f ? TextAlignmentOptions.BottomLeft : TextAlignmentOptions.BottomRight; + return a.x < 0.5f ? TextAlignmentOptions.TopLeft : TextAlignmentOptions.TopRight; + } + + /// + /// 偏移:非有限数当成零。NaN 进 anchoredPosition 会把这一件字整个挪出画面, + /// 而且它不报错——这正是"计数全对、画面空无一物"那一族。 + /// + public static Vector2 SafeOffset(Vector2 offset) + { + if (float.IsNaN(offset.x) || float.IsInfinity(offset.x)) offset.x = 0f; + if (float.IsNaN(offset.y) || float.IsInfinity(offset.y)) offset.y = 0f; + return offset; + } + } +} diff --git a/Runtime/XChart/Text/XChartLabelAnchorMath.cs.meta b/Runtime/XChart/Text/XChartLabelAnchorMath.cs.meta new file mode 100644 index 0000000..26e00b7 --- /dev/null +++ b/Runtime/XChart/Text/XChartLabelAnchorMath.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: 887ef129beec6e841875636169cb0a4d +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Runtime/XChart/Text/XChartLabelConfig.cs b/Runtime/XChart/Text/XChartLabelConfig.cs new file mode 100644 index 0000000..95ad37c --- /dev/null +++ b/Runtime/XChart/Text/XChartLabelConfig.cs @@ -0,0 +1,101 @@ +using System; +using UnityEngine; +using XericUI.XChart.Space; + +namespace XericUI.XChart.Text +{ + /// + /// 数据标签元素的配置。面板这一侧只存"选哪一档/哪一列": + /// 锚点与文字对齐的对应关系住在 , + /// 列号到标签槽的换算住在 ——配置里再写一遍就会各说一套。 + /// + /// LabelSlot 是标签列的序号(不是数据表里的行号):窗口里排在最前面那些列就是标签列, + /// 面板上看到的列号要换算成槽号才读得对,所以这一格存的是槽号而由同一处算出来。 + /// + [Serializable] + [XChartElement("label", "标签", 60)] + public sealed class XChartLabelConfig : XChartElementConfig + { + [Header("数据来源")] + [SerializeField, Min(0), Tooltip("读第几个标签列(标签列在数据表里排在最前面;这一格是槽号,不是表里的行号)")] + private int m_LabelSlot; + + [SerializeField, Tooltip("标签挂在哪儿:三个数值维下标(显示范围在 chart 的数据板块逐维给)")] + private int m_DimensionX; + [SerializeField] private int m_DimensionY = 1; + [SerializeField] private int m_DimensionZ = 2; + + [SerializeField, Tooltip("标签自己的变换(叠在图的空间之上)")] + private XChartToolTransform m_Transform = XChartToolTransform.Identity; + + [SerializeField, Tooltip("数据落在显示范围之外时怎么办:原样画(默认)/ 夹到范围端点 / 整条隐藏")] + private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs; + + [Header("呈现")] + [SerializeField, Tooltip("标签矩形相对它那一点的位置(9 档)。文字对齐由同一档算出来,不另给一个字段")] + private XChartLabelAnchor m_Anchor = XChartLabelAnchor.UpperCenter; + + [SerializeField, Tooltip("从那个点再挪多少像素(非有限数按零算)")] + private Vector2 m_Offset = new Vector2(0f, 6f); + + [SerializeField, Min(1), Tooltip("字号")] + private int m_FontSize = 14; + + [SerializeField, Tooltip("字色")] + private Color m_LabelColor = Color.white; + + [SerializeField, Min(0f), Tooltip("描边宽度")] + private float m_OutlineWidth; + + [SerializeField, Tooltip("标签矩形大小(像素)。字超出的部分按下面的换行档处理")] + private Vector2 m_RectSize = new Vector2(160f, 30f); + + [SerializeField, Tooltip("字是否在这个矩形内换行")] + private bool m_Wrap; + + public override string ElementName => "Label"; + + public override XChartToolBase CreateTool() => new ChartToolLabels(); + + public override void ApplyTo(XChartToolBase tool) + { + if (!(tool is ChartToolLabels labels)) return; + + labels.LabelSlot = m_LabelSlot; + labels.DimensionX = m_DimensionX; + labels.DimensionY = m_DimensionY; + labels.DimensionZ = m_DimensionZ; + labels.Transform = m_Transform; + labels.OutOfRange = m_OutOfRange; + + labels.Anchor = m_Anchor; + labels.Offset = m_Offset; + labels.FontSize = m_FontSize; + labels.LabelColor = m_LabelColor; + labels.OutlineWidth = m_OutlineWidth; + labels.RectSize = m_RectSize; + labels.Wrap = m_Wrap; + + labels.MarkDirty(); + } + + public override void CaptureFrom(XChartToolBase tool) + { + if (!(tool is ChartToolLabels labels)) return; + + m_LabelSlot = labels.LabelSlot; + m_Anchor = labels.Anchor; + m_Offset = labels.Offset; + m_FontSize = labels.FontSize; + m_LabelColor = labels.LabelColor; + m_RectSize = labels.RectSize; + m_Wrap = labels.Wrap; + } + + public override int RequiredNumericDimensions => 3; + + public override int RequiredRecordCount => 1; + + public override int RequiredLabelColumns => 1; + } +} diff --git a/Runtime/XChart/Text/XChartLabelConfig.cs.meta b/Runtime/XChart/Text/XChartLabelConfig.cs.meta new file mode 100644 index 0000000..07f1e05 --- /dev/null +++ b/Runtime/XChart/Text/XChartLabelConfig.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: c3ac62f975d4c9f4180064e4839edabc +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: diff --git a/Runtime/XChart/XChartColumnMath.cs b/Runtime/XChart/XChartColumnMath.cs index 8b047c4..9bda9f1 100644 --- a/Runtime/XChart/XChartColumnMath.cs +++ b/Runtime/XChart/XChartColumnMath.cs @@ -60,5 +60,70 @@ namespace XericUI.XChart } return null; } + + // ── 标签列(String 那一族):与数值列同一套规则,只是占的是标签数组的格 ── + // + // 记录身上有两个数组:值数组的长度=,标签数组的长度= + // 。标签数组的长度就是它自己的判据:一条记录能写出 + // 比标签列更多的字符串,那些字符串没有一个列能叫出名字,屏幕上便凭空多出一个标签 + // (以前这里靠调用方自觉,所以导入能塞进去、窗口显示得出来、元素却读不到)。 + + /// 标签列的个数=每条记录标签数组的长度(非标签列不占格) + public static int LabelCount(IReadOnlyList dimensions) + { + if (dimensions == null) return 0; + int count = 0; + for (int i = 0; i < dimensions.Count; i++) + if (dimensions[i] != null && dimensions[i].Kind == XChartDimensionKind.Label) count++; + return count; + } + + /// + /// 表里第 行对应的标签下标; + /// 那一列不占标签格(种类不是 Label)或行号越界时返回 -1。 + /// + public static int LabelSlotOf(IReadOnlyList dimensions, int tableIndex) + { + if (dimensions == null || tableIndex < 0 || tableIndex >= dimensions.Count) return -1; + var target = dimensions[tableIndex]; + if (target == null || target.Kind != XChartDimensionKind.Label) return -1; + + int slot = 0; + for (int i = 0; i < tableIndex; i++) + if (dimensions[i] != null && dimensions[i].Kind == XChartDimensionKind.Label) slot++; + return slot; + } + + /// + /// 把一条记录的标签数组按标签列个数定长——这是"记录标签长度"唯一的定义处: + /// 按位置逐格搬(不是按列号搬:列号已经被调用方换算过),短的补空串、长的截掉。 + /// 加/删列之后重排就靠它,所以各写入路径不许各自 Copy 一遍。 + /// + public static string[] SizedLabels(IReadOnlyList labels, int labelCount) + { + if (labelCount < 0) labelCount = 0; + var copy = new string[labelCount]; + // 空位一律写空串,不写 null:null 与 "" 在窗口里都显示为空,却在"这一格是空的"这条判据上 + // 各答一套(导入写出的是 "",而这里补 null,往返一次就变了样)。 + for (int i = 0; i < labelCount; i++) + copy[i] = labels != null && i < labels.Count ? labels[i] : string.Empty; + return copy; + } + + /// 反方向:标签下标属于表里哪一列(拿到那一列的定义)——与 对称 + public static XChartDimensionDefinition DefinitionOfLabelSlot( + IReadOnlyList dimensions, int labelSlot) + { + if (dimensions == null || labelSlot < 0) return null; + int slot = 0; + for (int i = 0; i < dimensions.Count; i++) + { + var candidate = dimensions[i]; + if (candidate == null || candidate.Kind != XChartDimensionKind.Label) continue; + if (slot == labelSlot) return candidate; + slot++; + } + return null; + } } } diff --git a/Runtime/XChart/XChartDataModel.cs b/Runtime/XChart/XChartDataModel.cs index 4e151d6..0109995 100644 --- a/Runtime/XChart/XChartDataModel.cs +++ b/Runtime/XChart/XChartDataModel.cs @@ -222,17 +222,26 @@ namespace XericUI.XChart /// public int NumericDimensionCount => XChartColumnMath.ValueCount(m_Dimensions); + /// + /// 标签列个数=每条记录标签数组的长度(,唯一那一条规则)。 + /// 1:1 是形状而不是一句承诺:记录身上可以写出比标签列更多的字符串,那些字符串没有一个列 + /// 叫得出名字,屏幕上就凭空多出一个标签,而报表里看不出是谁写的。 + /// + public int LabelDimensionCount => XChartColumnMath.LabelCount(m_Dimensions); + public void SetDimensions(IList dimensions) { m_Dimensions.Clear(); if (dimensions != null) for (int i = 0; i < dimensions.Count; i++) m_Dimensions.Add(dimensions[i]); int numericCount = NumericDimensionCount; + int labelCount = LabelDimensionCount; for (int i = 0; i < m_Records.Count; i++) { var values = new float[numericCount]; int copyCount = Math.Min(values.Length, m_Records[i].Values.Count); for (int j = 0; j < copyCount; j++) values[j] = m_Records[i].Values[j]; - m_Records[i] = new XChartRecord(m_Records[i].RecordId, m_Records[i].Timestamp, values, CopyLabels(m_Records[i].Labels)); + m_Records[i] = new XChartRecord(m_Records[i].RecordId, m_Records[i].Timestamp, values, + XChartColumnMath.SizedLabels(m_Records[i].Labels, labelCount)); } Publish(); } @@ -293,19 +302,26 @@ namespace XericUI.XChart // 值数组按"数值维中的序号"排,不是按维度表下标排:中间夹一个非数值维时两者会错开 // 值下标由那一条规则给(非数值列返回 -1:本来就没有格要摘) int column = XChartColumnMath.ValueSlot(m_Dimensions, index); + int labelSlot = XChartColumnMath.LabelSlotOf(m_Dimensions, index); m_Dimensions.RemoveAt(index); - if (column >= 0) + if (column >= 0 || labelSlot >= 0) { for (int i = 0; i < m_Records.Count; i++) { var record = m_Records[i]; - if (column >= record.Values.Count) continue; // 这一行短了一截:本就没有这一格 - var values = new float[record.Values.Count - 1]; + + // 标签列同理:摘掉的是"这一列在标签数组里那一格",不是"第 index 个字符串" + var values = new float[column >= 0 ? record.Values.Count - 1 : record.Values.Count]; for (int j = 0, k = 0; j < record.Values.Count; j++) - if (j != column) values[k++] = record.Values[j]; - m_Records[i] = new XChartRecord(record.RecordId, record.Timestamp, values, CopyLabels(record.Labels)); + if (column < 0 || j != column) values[k++] = record.Values[j]; + + var labels = new string[labelSlot >= 0 ? record.Labels.Count - 1 : record.Labels.Count]; + for (int j = 0, k = 0; j < record.Labels.Count; j++) + if (labelSlot < 0 || j != labelSlot) labels[k++] = record.Labels[j]; + + m_Records[i] = new XChartRecord(record.RecordId, record.Timestamp, values, CopyLabels(labels)); } } @@ -313,10 +329,17 @@ namespace XericUI.XChart return true; } + /// + /// 加一条记录。两个数组都必须对得上当前的列:值数组长度=数值列个数, + /// 标签数组长度=标签列个数(或 null=这一条还没有标签)。 + /// 长度不对就整条拒收、不改一半——"多出来的那个字符串"没有列叫得出它的名字, + /// 落进表里就是屏幕上一个没主的标签(1:1 靠门口这一关守住,不靠调用方自觉)。 + /// public bool TryAddRecord(double timestamp, float[] values, string[] labels = null) { if (double.IsNaN(timestamp) || double.IsInfinity(timestamp) || values == null || values.Length != NumericDimensionCount) return false; for (int i = 0; i < values.Length; i++) if (float.IsNaN(values[i]) || float.IsInfinity(values[i])) return false; + if (labels != null && labels.Length != LabelDimensionCount) return false; if (m_Records.Count > 0 && timestamp < m_Records[m_Records.Count - 1].Timestamp) return false; if (m_Records.Count == Capacity) { @@ -325,7 +348,7 @@ namespace XericUI.XChart } var copy = new float[values.Length]; Array.Copy(values, copy, values.Length); - m_Records.Add(new XChartRecord(m_NextRecordId++, timestamp, copy, labels ?? Array.Empty())); + m_Records.Add(new XChartRecord(m_NextRecordId++, timestamp, copy, CopyLabels(labels))); Publish(); return true; } @@ -377,15 +400,19 @@ namespace XericUI.XChart return true; } - /// 改某条记录的某个标签(下标越界或空串一律拒绝) - public bool TrySetLabel(int recordIndex, int labelIndex, string text) + /// + /// 改某条记录在某一标签列上的字符串。下标是标签下标(第几个标签列,不是表里的行号), + /// 由 换算。行号或下标越界拒绝;空串是合法值 + /// (把标签清空),所以清空与"这一列本来没有格"分得开——后者压根进不到这里。 + /// + public bool TrySetLabel(int recordIndex, int labelSlot, string text) { if (recordIndex < 0 || recordIndex >= m_Records.Count) return false; var record = m_Records[recordIndex]; - if (labelIndex < 0 || labelIndex >= record.Labels.Count) return false; + if (labelSlot < 0 || labelSlot >= LabelDimensionCount) return false; var labels = CopyLabels(record.Labels); - labels[labelIndex] = text ?? string.Empty; + labels[labelSlot] = text ?? string.Empty; m_Records[recordIndex] = new XChartRecord(record.RecordId, record.Timestamp, CopyValues(record.Values), labels); Publish(); return true; @@ -484,6 +511,20 @@ namespace XericUI.XChart return definition != null; } + /// + /// 取某条记录在某一标签列上的字符串(标签下标,第几个标签列)。 + /// 行号或下标越界返回 false;列存在但那一格是空串时返回 true + 空串—— + /// "这一列没这一格"和"这一格是空的"是两件事,画不画由调用方决定。 + /// + public bool TryGetLabelAt(int recordIndex, int labelSlot, out string text) + { + text = null; + if (recordIndex < 0 || recordIndex >= m_Records.Count) return false; + if (labelSlot < 0 || labelSlot >= LabelDimensionCount) return false; + text = m_Records[recordIndex].Labels[labelSlot] ?? string.Empty; + return true; + } + /// /// 一次扫描算 Count/First/Last/Min/Max/Sum/Mean/Rms;中位数单独排序一次。 /// 结果按(版本, 维度)缓存,请求的是缓存子集时直接复用。 @@ -620,12 +661,10 @@ namespace XericUI.XChart return low; } - private static string[] CopyLabels(IReadOnlyList labels) - { - var copy = new string[labels.Count]; - for (int i = 0; i < labels.Count; i++) copy[i] = labels[i]; - return copy; - } + /// 标签数组的拷贝并且按那一条规则定长——长度只由标签列个数决定, + /// 所以任何一次写入之后,"这一行的标签个数"都还等于表里的标签列数。 + private string[] CopyLabels(IReadOnlyList labels) + => XChartColumnMath.SizedLabels(labels, LabelDimensionCount); } public class XChartDataModel3D diff --git a/Runtime/XChart/XChartDataSource.cs b/Runtime/XChart/XChartDataSource.cs index 8755523..587d3f6 100644 --- a/Runtime/XChart/XChartDataSource.cs +++ b/Runtime/XChart/XChartDataSource.cs @@ -155,6 +155,12 @@ namespace XericUI.XChart /// 数值维度数量 int NumericDimensionCount { get; } + /// + /// 标签(String)列数量=每条记录身上标签数组的长度。元素只能读到这里说得出的那些格: + /// 记录里比这更多的字符串没有一个列能叫出名字,所以这一数就是"1:1"的形状判据。 + /// + int LabelDimensionCount { get; } + /// 是否有数据 bool HasData { get; } @@ -182,6 +188,14 @@ namespace XericUI.XChart /// bool TryGetDimension(int dimension, out XChartDimensionDefinition definition); + /// + /// 取某条记录在某一标签列上的字符串。下标是标签下标(同一个口径: + /// 把"表里那一列"换算成它)。 + /// 越界返回 false(渲染路径里调用,不抛)——"这一格没有"和"这一格是空串"要分得开, + /// 所以空串照实返回 true,由调用方决定要不要画。 + /// + bool TryGetLabelAt(int recordIndex, int labelSlot, out string text); + /// 按时间窗打开一个范围游标(虚拟指针) XChartRangeCursor OpenRange(int dimension, double fromTime, double toTime); } diff --git a/Runtime/XChart/XChartDataText.cs b/Runtime/XChart/XChartDataText.cs index b2fc970..8f04620 100644 --- a/Runtime/XChart/XChartDataText.cs +++ b/Runtime/XChart/XChartDataText.cs @@ -213,6 +213,14 @@ namespace XericUI.XChart return false; } + // 少字段的行要在门口拒:直接读 fields[1] 会抛出去,而"导入失败"的语义是 + // **指出行号并整份拒绝**,不是把异常丢给调用方(半份数据比没数据更坏) + if (fields.Length < 2) + { + error = "第 " + (i + 1) + " 行的记录少了时间戳字段"; + return false; + } + double timestamp; if (!TryParseDouble(fields[1], out timestamp)) { @@ -224,11 +232,22 @@ namespace XericUI.XChart for (int d = 0; d < dimensions.Count; d++) if (dimensions[d].Kind == XChartDimensionKind.Number) numericCount++; + // 标签段的长度由**标签列个数**定(同一处规则:XChartColumnMath.LabelCount)。 + // 多出来的字符串没有列叫得出它的名字:它落进记录后窗口显示得出来、元素却读不到, + // 所以这里当场拒收并点名行号,而不是"先收下再说"。 + int labelCount = XChartColumnMath.LabelCount(dimensions); + int labelFields = fields.Length - 2 - numericCount; + if (fields.Length - 2 < numericCount) { error = "第 " + (i + 1) + " 行的数值个数(" + (fields.Length - 2) + ")少于数值维个数(" + numericCount + ")"; return false; } + if (labelFields != labelCount) + { + error = "第 " + (i + 1) + " 行的标签个数(" + labelFields + ")与标签列个数(" + labelCount + ")对不上"; + return false; + } var values = new float[numericCount]; for (int d = 0; d < numericCount; d++) @@ -247,8 +266,8 @@ namespace XericUI.XChart values[d] = (float)value; } - var labels = new string[Math.Max(fields.Length - 2 - numericCount, 0)]; - for (int l = 0; l < labels.Length; l++) labels[l] = fields[2 + numericCount + l]; + var labels = new string[labelCount]; + for (int l = 0; l < labelCount; l++) labels[l] = fields[2 + numericCount + l]; timestamps.Add(timestamp); recordValues.Add(values); diff --git a/Runtime/XChart/XChartElementConfig.cs b/Runtime/XChart/XChartElementConfig.cs index 0d0a64a..f396cb9 100644 --- a/Runtime/XChart/XChartElementConfig.cs +++ b/Runtime/XChart/XChartElementConfig.cs @@ -114,6 +114,13 @@ namespace XericUI.XChart /// public virtual int RequiredRecordCount => 0; + /// + /// 这个元素要几个标签列才画得出来(0=不需要)。标签元素读的是那一列在每一行上的那一格: + /// 表里没有标签列时它一条都不画,而这在画面上和"没数据"长得一模一样——所以"要几个、表里有几个" + /// 必须和数值维、记录数一起印出来(§25.1 的第三半)。 + /// + public virtual int RequiredLabelColumns => 0; + /// /// 互斥显示: 这个字段在当前配置下要不要从面板上藏掉。 ///