P26:标签按"标签列"1:1 落到记录、窗口、元素、文本四处(规范 §35)

- 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)
This commit is contained in:
2026-11-09 06:58:39 +08:00
parent 4a40b317be
commit 084591d104
18 changed files with 968 additions and 84 deletions
+1
View File
@@ -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 对照绿。 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` 补,不补就会"绿着跳过"它们。 合并他那 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<CanvasRenderer>()` 判,不用那个会 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 就不是全部故事。 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<CanvasRenderer>()` 判,不用那个会 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 ## [0.1.6] - 2026-07-01
+21 -6
View File
@@ -66,20 +66,27 @@ public void Drive()
| API | 语义 | 失败时 | | API | 语义 | 失败时 |
| --- | --- | --- | | --- | --- | --- |
| `SetDimensions(list)` | 换整张表的列(会按新列重排已有记录的值) | — | | `SetDimensions(list)` | 换整张表的列(会按新列重排已有记录的值与标签) | — |
| `TryAddRecord(time, values, labels?)` | 追加一条(时间戳必须**非递减**) | `false`,原因在数据窗口/报表里看得见 | | `TryAddRecord(time, values, labels?)` | 追加一条(时间戳必须**非递减**;`labels` 非 null 时长度必须=标签列个数,否则拒) | `false`,原因在数据窗口/报表里看得见 |
| `TrySetValue(recordIndex, numericDim, value)` | 改一个数 | 越界/非有限 ⇒ `false` | | `TrySetValue(recordIndex, numericDim, value)` | 改一个数 | 越界/非有限 ⇒ `false` |
| `TrySetTime(recordIndex, time, out reason)` | 改时间戳(会破坏单调性时拒) | `false` + `reason` | | `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` | | `TrySetDomainOverride(dim, overrideMin, min, overrideMax, max)` | 钉住某一维的显示范围(**分侧**可钉) | 越界列 ⇒ `false` |
| `Clear()` / `Capacity`(环形上限)/ `DroppedCount` | 清空、容量、被丢了多少条 | — | | `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 自己置脏) ## 4. 入口 B:元素的参数(setter 自己置脏)
每个元素工具的公开属性都是这个形状(P20 立的规矩,`dirty_gate` 数着:**133 个旋钮,133 个设了就生效**): 每个元素工具的公开属性都是这个形状(P20 立的规矩,`dirty_gate` 数着:**149 个旋钮,149 个设了就生效**):
```csharp ```csharp
public float Radius { get => m_Radius; set { m_Radius = value; MarkDirty(); } } 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` | | `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` | | `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.<f>.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…`) | | `ChartToolAxis` | `SlotId`(**宿主**:板上现在发 `mesh.face.<0..5>` 与 `mesh.face.<f>.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. 矢量场(箭头):方向从哪来、头贴在哪、尺寸怎么算 ## 5. 矢量场(箭头):方向从哪来、头贴在哪、尺寸怎么算
@@ -172,6 +183,10 @@ chart.Space.CenterOffset = new Vector2(0, 40f);
| `path=none` | 曲线渲染器没建起来 ⇒ 箭头什么都画不出(箭头的唯一绘制出口就是它) | | `path=none` | 曲线渲染器没建起来 ⇒ 箭头什么都画不出(箭头的唯一绘制出口就是它) |
| `colors=overlap` | 颜色维起点撞上坐标/方向列 ⇒ 实际画的是单色 | | `colors=overlap` | 颜色维起点撞上坐标/方向列 ⇒ 实际画的是单色 |
| `arrows=31 arrowFaces=…`(旧版本)/ `markers=` | 提交了多少:与"看得见"是两件事,先跟上面几项对齐 | | `arrows=31 arrowFaces=…`(旧版本)/ `markers=` | 提交了多少:与"看得见"是两件事,先跟上面几项对齐 |
| `labels=0/1`(面板元素块) | 这个标签元素要 1 个标签列,表里没有 ⇒ 它一条都不画。去数据窗口点「+标签」,再把那一格填上 |
| `labelSlot=0 records=N` | 标签元素在看第几个标签列、表里几条记录 |
| `written=` / `empty=` / `hidden=` / `skipped=` | 写了几个字 / 那几格是空的 / 被"超范围怎么办"这一档藏了 / 数据读不出来(分属三件事,不要合看) |
| `pending=N`、`have<want` | 文本槽位还没发下来:这一帧是"件没到",不是"这一行没标签" |
开关报表:图表 Inspector 底部「自述报表 开/关」(= 工程根放一个 `xchart.dump.on`,每 0.4 秒追加一次,删掉就停)。 开关报表:图表 Inspector 底部「自述报表 开/关」(= 工程根放一个 `xchart.dump.on`,每 0.4 秒追加一次,删掉就停)。
**编辑期要有重绘帧才会跑**(`[ExecuteAlways]`):编辑器静止时外部写要等一帧——滚一下 Scene 视图即可。 **编辑期要有重绘帧才会跑**(`[ExecuteAlways]`):编辑器静止时外部写要等一帧——滚一下 Scene 视图即可。
+82
View File
@@ -2306,3 +2306,85 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码
- 现场看三件事:① 立方体的填充面和圆柱的填充应上屏;② 报表 `fillCr=yes` 且 `fillShipped>0`; - 现场看三件事:① 立方体的填充面和圆柱的填充应上屏;② 报表 `fillCr=yes` 且 `fillShipped>0`;
③ 数据喂到超上限时是 `fillRefused>0`,而不是抛 `Mesh can not have more than 65000 vertices`。 ③ 数据喂到超上限时是 `fillRefused>0`,而不是抛 `Mesh can not have more than 65000 vertices`。
- 如果 `fillCr=yes`、`fillShipped>0` 而画面还空,那 §34.3 的机制就不是全部——这条要说清楚,别把"修了形状"当"修了画面"。 - 如果 `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<slot>` / `V<slot>`:两张表列数相同但种类不同(或标签列换位置)时,旧行必须重造。
### 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`;③ 点「+标签」后老记录那一格是空的(不是把旧标签挤走)。
+22 -7
View File
@@ -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 int haveDims = chart != null && chart.DataModel != null
? chart.DataModel.NumericDimensionCount ? chart.DataModel.NumericDimensionCount
@@ -239,18 +245,27 @@ namespace XericUI.XChart.Editor
int haveRecords = chart != null && chart.DataModel != null int haveRecords = chart != null && chart.DataModel != null
? chart.DataModel.RecordCount ? chart.DataModel.RecordCount
: 0; : 0;
int needDims = config.RequiredNumericDimensions; int haveLabels = chart != null && chart.DataModel != null
int needRecords = config.RequiredRecordCount; ? chart.DataModel.LabelDimensionCount
: 0;
string dimsPart = "需要 " + needDims + " 个数值维,表现在有 " + haveDims + " 个"; string dimsPart = "需要 " + needDims + " 个数值维,表现在有 " + haveDims + " 个";
string recordsPart = needRecords > 0 string recordsPart = needRecords > 0
? ";需要 " + needRecords + " 条记录,表现在有 " + haveRecords + " 条" ? ";需要 " + needRecords + " 条记录,表现在有 " + haveRecords + " 条"
: string.Empty; : string.Empty;
bool shortOfShape = haveDims < needDims || haveRecords < needRecords; string labelsPart = needLabels > 0
block.Body.Add(MakeReadonly(dimsPart + recordsPart ? ";需要 " + needLabels + " 个标签列,表现在有 " + haveLabels + " 个"
: string.Empty;
bool shortOfShape = haveDims < needDims
|| haveRecords < needRecords
|| haveLabels < needLabels;
block.Body.Add(MakeReadonly(dimsPart + recordsPart + labelsPart
+ (shortOfShape + (shortOfShape
? " ⇒ 画不出来(报表里 dims=" + haveDims + "/" + needDims ? " ⇒ 画不出来(报表里 dims=" + haveDims + "/" + needDims
+ " records=" + haveRecords + ")" + " records=" + haveRecords
+ " labels=" + haveLabels + "/" + needLabels + ")"
: string.Empty))); : string.Empty)));
} }
+176 -45
View File
@@ -41,9 +41,22 @@ namespace XericUI.XChart.Editor
/// <summary>每一列对应的值下标(-1=这一列不占值格);表头与格子共用,规则来自 <see cref="XChartColumnMath"/></summary> /// <summary>每一列对应的值下标(-1=这一列不占值格);表头与格子共用,规则来自 <see cref="XChartColumnMath"/></summary>
private int[] m_ColumnValueSlots = new int[0]; private int[] m_ColumnValueSlots = new int[0];
/// <summary>上面那组的签名:换一张同列数但种类不同的图时,旧行里的格子必须重造</summary> /// <summary>每一列对应的<b>标签</b>下标(-1=这一列不占标签格)。与值下标是同一套规则的两半:
/// 值数组按"第几个数值列"排,标签数组按"第几个标签列"排,所以两边都只有一个换算处</summary>
private int[] m_ColumnLabelSlots = new int[0];
/// <summary>表页的显示序:<b>标签列排在最前</b>(他 2026-10-26 要的是"这一族直接在窗口里编辑",
/// 排在每行最前面才不用横向拖到表尾去找)。表头和行里的格子按同一份排,否则列标题和格子对不上。</summary>
private int[] m_TableDisplayOrder = new int[0];
/// <summary>值格分布的签名(表里的行序):范围页按它判"要不要整页重建"——一列一行不能指错列</summary>
private string m_ColumnValueSignature = string.Empty; private string m_ColumnValueSignature = string.Empty;
/// <summary>行里那一排格子的签名(种类 + 下标 + 显示序):换一张同列数、种类不同的图,
/// 或标签列排到了前面,旧行的格子必须重造。只看列数会把"这一格是标签格还是数值格"当成没变——
/// 那正是往错的列写数的路</summary>
private string m_TableSignature = string.Empty;
/// <summary>范围页是在哪一份值格分布上建的:对不上就整页重建(一列一行不能指错列)</summary> /// <summary>范围页是在哪一份值格分布上建的:对不上就整页重建(一列一行不能指错列)</summary>
private string m_RangeSignature = string.Empty; private string m_RangeSignature = string.Empty;
private bool m_Applying; private bool m_Applying;
@@ -246,12 +259,35 @@ namespace XericUI.XChart.Editor
{ {
int dimensions = model != null ? model.Dimensions.Count : 0; int dimensions = model != null ? model.Dimensions.Count : 0;
m_ColumnValueSlots = new int[dimensions]; m_ColumnValueSlots = new int[dimensions];
m_ColumnLabelSlots = new int[dimensions];
for (int i = 0; i < dimensions; i++) for (int i = 0; i < dimensions; i++)
{
m_ColumnValueSlots[i] = XChartColumnMath.ValueSlot(model.Dimensions, i); m_ColumnValueSlots[i] = XChartColumnMath.ValueSlot(model.Dimensions, i);
m_ColumnLabelSlots[i] = XChartColumnMath.LabelSlotOf(model.Dimensions, i);
}
var signature = new System.Text.StringBuilder(); // 显示序:标签列在前、其余列照表里的顺序。这里<b>只算一次</b>,表头和行共用,
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();
} }
/// <summary>工具栏上的一个下拉:条目按顺序排,点哪个跑哪个</summary> /// <summary>工具栏上的一个下拉:条目按顺序排,点哪个跑哪个</summary>
@@ -294,16 +330,20 @@ namespace XericUI.XChart.Editor
}); });
m_Header.Add(new Label("时间") { style = { width = kTimeWidth } }); 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 index = m_TableDisplayOrder[pos];
int valueSlot = m_ColumnValueSlots[i]; int valueSlot = m_ColumnValueSlots[index];
bool isLabel = m_ColumnLabelSlots[index] >= 0;
var cell = new VisualElement { style = { flexDirection = FlexDirection.Row, width = kCellWidth } }; var cell = new VisualElement { style = { flexDirection = FlexDirection.Row, width = kCellWidth } };
var name = new TextField { style = { flexGrow = 1 } }; var name = new TextField { style = { flexGrow = 1 } };
name.SetValueWithoutNotify(ColumnName(model, index)); name.SetValueWithoutNotify(ColumnName(model, index));
name.tooltip = "列标题=这一维的显示名;改它只改显示名,维度序号不动" name.tooltip = "列标题=这一维的显示名;改它只改显示名,维度序号不动"
+ (valueSlot < 0 ? "(这一列不占值格:种类不是 Number)" : string.Empty); + (isLabel
? "(这一列占的是标签格:每一行在这一格直接写字符串)"
: (valueSlot < 0 ? "(这一列不占值格:种类不是 Number)" : string.Empty));
name.RegisterCallback<KeyDownEvent>(evt => name.RegisterCallback<KeyDownEvent>(evt =>
{ {
if (evt.keyCode != KeyCode.Return && evt.keyCode != KeyCode.KeypadEnter) return; if (evt.keyCode != KeyCode.Return && evt.keyCode != KeyCode.KeypadEnter) return;
@@ -329,8 +369,14 @@ namespace XericUI.XChart.Editor
style = { width = kAddColumnWidth }, style = { width = kAddColumnWidth },
tooltip = "加一列(新增一个数值维,默认名 D<n>,随后可在这里改名)", tooltip = "加一列(新增一个数值维,默认名 D<n>,随后可在这里改名)",
}); });
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 } }); m_Header.Add(new Label { style = { width = kDeleteWidth } });
} }
@@ -379,6 +425,29 @@ namespace XericUI.XChart.Editor
SetMessage("已加一列(" + key + "):老记录这一维补 0"); SetMessage("已加一列(" + key + "):老记录这一维补 0");
} }
/// <summary>
/// 加一个标签列=新增一个 String 维。走的是 <c>SetDimensions</c> 那一条路(唯一的定长处),
/// 所以老记录的标签数组会跟着变长、补空串——不是在窗口里凭空多一个"没主的格子"。
/// </summary>
private void AddLabelColumn()
{
var model = m_Chart != null ? m_Chart.DataModel : null;
if (model == null) { SetMessage("先指定一个图表"); return; }
var dimensions = new List<XChartDimensionDefinition>(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 + " 个标签");
}
/// <summary> /// <summary>
/// 删一列=删掉一个维度定义,连同每一行的那一格。 /// 删一列=删掉一个维度定义,连同每一行的那一格。
/// <b>破坏性动作要看得见代价</b>:先把整表留在剪贴板(和"清空"同一个安全网),再要一次确认—— /// <b>破坏性动作要看得见代价</b>:先把整表留在剪贴板(和"清空"同一个安全网),再要一次确认——
@@ -503,27 +572,41 @@ namespace XericUI.XChart.Editor
cells.Add(widgets.Time); cells.Add(widgets.Time);
int dimensions = Mathf.Max(m_DimensionCount, 0); int dimensions = Mathf.Max(m_DimensionCount, 0);
widgets.Values = new TextField[dimensions]; widgets.Cells = new TextField[dimensions];
widgets.Slots = m_ColumnValueSignature; widgets.Slots = m_TableSignature;
for (int i = 0; i < dimensions; i++) for (int pos = 0; pos < dimensions; pos++)
{ {
int valueSlot = i < m_ColumnValueSlots.Length ? m_ColumnValueSlots[i] : -1; int column = pos < m_TableDisplayOrder.Length ? m_TableDisplayOrder[pos] : -1;
var cell = new TextField { userData = valueSlot, style = { width = kCellWidth } }; int labelSlot = column >= 0 ? m_ColumnLabelSlots[column] : -1;
if (valueSlot < 0) 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)
{ {
// 非数值列:没有对应的值格。留一个禁用的格子而不是让人填进去再被拒—— // 标签格:这一族的本分就是就地编辑(他 2026-10-26 要的"直接在前面上编辑")。
// 他填过却存不进去,比一眼看出"这一格不归我改"更坏。 // 它不能走数字解析那一支——标签是字符串,把"不是数字"当错报会把正常的标签拒掉。
cell.SetEnabled(false); cell.tooltip = "这一行的标签(String 维):直接写,回车或失焦提交。"
cell.tooltip = "这一列的种类不是 Number ⇒ 它不占值格(值数组里没有它的位置)"; + "标签元素按记录读它(一条记录一个标签),所以这一格存的就是画面上那个字";
HookCommit(cell, () => CommitCell(cell));
} }
else HookCommit(cell, () => CommitCell(cell)); else if (valueSlot >= 0)
widgets.Values[i] = cell; {
HookCommit(cell, () => CommitCell(cell));
}
else
{
// 既不占值格也不占标签格(比如 Time 列在表里的那一行):留一个禁用的格子而不是
// 让人填进去再被拒——他填过却存不进去,比一眼看出"这一格不归我改"更坏。
cell.SetEnabled(false);
cell.tooltip = "这一列不占格:种类既不是 Number 也不是 Label(值数组和标签数组里都没有它的位置)";
}
widgets.Cells[pos] = cell;
cells.Add(cell); cells.Add(cell);
} }
widgets.Labels = new Label { style = { flexGrow = 1 } };
cells.Add(widgets.Labels);
widgets.Delete = new ToolbarButton(() => DeleteRecord(widgets)) widgets.Delete = new ToolbarButton(() => DeleteRecord(widgets))
{ {
text = "-", // 一个符号就够(他 2026-10-25:"删除按钮应该改为 -,而不是一个'删'") text = "-", // 一个符号就够(他 2026-10-25:"删除按钮应该改为 -,而不是一个'删'")
@@ -553,10 +636,11 @@ namespace XericUI.XChart.Editor
var existing = element.Q("row-cells"); var existing = element.Q("row-cells");
var widgets = existing != null ? existing.userData as RowWidgets : null; var widgets = existing != null ? existing.userData as RowWidgets : null;
int want = Mathf.Max(m_DimensionCount, 0); 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(); element.Clear();
var fresh = MakeRow(); var fresh = MakeRow();
@@ -620,12 +704,29 @@ namespace XericUI.XChart.Editor
if (widgets == null || widgets.RecordIndex < 0) return; if (widgets == null || widgets.RecordIndex < 0) return;
int recordIndex = widgets.RecordIndex; int recordIndex = widgets.RecordIndex;
bool isTime = ReferenceEquals(field, widgets.Time); bool isTime = ReferenceEquals(field, widgets.Time);
int slot = field.userData is int value ? value : -1; var target = field.userData as CellRef;
if (!isTime && slot < 0) return; // 非数值列的格子是禁用的,压根不该走到这里 int slot = target != null ? target.Slot : -1;
if (!isTime && slot < 0) return; // 不占格的列:格子是禁用的,压根不该走到这里
var model = m_Chart.DataModel; var model = m_Chart.DataModel;
if (model == null || recordIndex < 0 || recordIndex >= model.RecordCount) return; 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; double parsed;
if (!double.TryParse(field.value, System.Globalization.NumberStyles.Float, if (!double.TryParse(field.value, System.Globalization.NumberStyles.Float,
System.Globalization.CultureInfo.InvariantCulture, out parsed)) System.Globalization.CultureInfo.InvariantCulture, out parsed))
@@ -670,18 +771,34 @@ namespace XericUI.XChart.Editor
widgets.Index.text = "#" + index; widgets.Index.text = "#" + index;
widgets.Time.SetValueWithoutNotify(model.GetTimeAt(index).ToString("0.###")); 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]; 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);
}
} }
/// <summary>删一行=删一条记录。删完立刻重排行号(列表多/少一行都要跟着改)</summary> /// <summary>删一行=删一条记录。删完立刻重排行号(列表多/少一行都要跟着改)</summary>
@@ -715,7 +832,10 @@ namespace XericUI.XChart.Editor
if (m_Stats != null) if (m_Stats != null)
{ {
// 每行的两个数组长度都在这里印出来:1:1 是形状,看得见的那个数字才是判据
m_Stats.text = "总行 " + total + " 维度 " + dimensions m_Stats.text = "总行 " + total + " 维度 " + dimensions
+ " 每行 " + (model != null ? model.NumericDimensionCount : 0) + " 个值、"
+ (model != null ? model.LabelDimensionCount : 0) + " 个标签"
+ " 已丢弃 " + (model != null ? model.DroppedCount : 0); + " 已丢弃 " + (model != null ? model.DroppedCount : 0);
} }
@@ -1135,14 +1255,25 @@ namespace XericUI.XChart.Editor
public int RecordIndex = -1; public int RecordIndex = -1;
public Label Index; public Label Index;
public TextField Time; public TextField Time;
public TextField[] Values;
/// <summary>建这一行时"哪一列有值格"的签名;对不上就整条重造(格子是禁用的还是可编辑的都记在格子上)</summary> /// <summary>每一列的格子,按<b>显示序</b>排(标签格在前,其后数值格)。
/// 格子种类不同(标签写字符串、数值写数字)所以不能靠"第几格"猜它是哪一列</summary>
public TextField[] Cells;
/// <summary>建这一行时"每一格是哪个种类、哪一下标"的签名;对不上就整条重造
/// (格子是禁用的还是可编辑的、走数字解析还是字符串提交,都记在格子上)</summary>
public string Slots; public string Slots;
public Label Labels;
public ToolbarButton Delete; public ToolbarButton Delete;
} }
/// <summary>格子背后那一列的身份:<c>IsLabel</c> 决定 <c>Slot</c> 是标签下标还是值下标。
/// 两个含义不许挤在同一个数上(-1 已经被"这一列不占格"占了),所以种类写在明面上。</summary>
private sealed class CellRef
{
public bool IsLabel;
public int Slot = -1;
}
/// <summary>范围页里一列的那一行控件</summary> /// <summary>范围页里一列的那一行控件</summary>
private sealed class DimensionRow private sealed class DimensionRow
{ {
+20 -6
View File
@@ -208,18 +208,32 @@ namespace XericUI.XChart.Radar
/// <summary>设置维度名称</summary> /// <summary>设置维度名称</summary>
public void SetDimensions(params string[] dimensionNames) public void SetDimensions(params string[] dimensionNames)
{ {
m_DataModel.SetDimensions(dimensionNames); ApplyDimensionNames(dimensionNames);
var dimensions = new System.Collections.Generic.List<XChartDimensionDefinition>(dimensionNames.Length);
for (int i = 0; i < dimensionNames.Length; i++)
dimensions.Add(new XChartDimensionDefinition($"radar_{i}", dimensionNames[i], XChartDimensionKind.Number));
DataModel.SetDimensions(dimensions);
// 由 Update 自动同步
} }
/// <summary>设置维度名称(从列表)</summary> /// <summary>设置维度名称(从列表)</summary>
public void SetDimensions(System.Collections.Generic.IList<string> dimensionNames) public void SetDimensions(System.Collections.Generic.IList<string> dimensionNames)
{
var names = new string[dimensionNames != null ? dimensionNames.Count : 0];
for (int i = 0; i < names.Length; i++) names[i] = dimensionNames[i];
ApplyDimensionNames(names);
}
/// <summary>
/// 两个重载都走这里:<see cref="AddSeries"/> 给每条记录带一个系列名,
/// 而共享表要有一个<b>标签列</b>那个名字才落得进去(1:1 是门口那条规矩)。
/// 只更新雷达自己的模型、不交代共享表,系列名就会被整条记录一起拒掉。
/// </summary>
private void ApplyDimensionNames(string[] dimensionNames)
{ {
m_DataModel.SetDimensions(dimensionNames); m_DataModel.SetDimensions(dimensionNames);
if (dimensionNames == null) return;
var dimensions = new System.Collections.Generic.List<XChartDimensionDefinition>(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);
} }
/// <summary>添加一个数据系列(自动分配颜色)</summary> /// <summary>添加一个数据系列(自动分配颜色)</summary>
+8
View File
@@ -0,0 +1,8 @@
fileFormatVersion: 2
guid: 2b931f6ed464bca4daa43d0230027e92
folderAsset: yes
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:
+268
View File
@@ -0,0 +1,268 @@
using System;
using TMPro;
using UnityEngine;
using XericUI.Core;
using XericUI.XChart.Space;
namespace XericUI.XChart.Text
{
/// <summary>
/// 数据标签元素:一条记录一个标签,标签读的是那一行在<b>某一标签列</b>上的字符串。
///
/// <para><b>1:1 是结构保证而不是约定</b>:记录身上的标签数组长度=标签列个数,
/// 所以这一列读得到的就是那一行的那一格;比列更多的字符串没有列叫得出它的名字,
/// 它在窗口里显示得出来、元素读不到(口径只有一份:<see cref="XChartColumnMath"/>)。
/// 一条记录配几个数值维+一个字符串维,画面上就是"点+它自己的名字"。</para>
///
/// <para><b>位置从哪儿来</b>:和散点/圆柱/矢量场<b>同一个</b>空间与同一份折法
/// (<see cref="XChartCubeFoldMath"/>),显示范围只定标尺;超范围怎么办由这一档自己决定(§32)。
/// <b>显示从哪儿来</b>:文本槽位池(运行时里唯一造 TMP 标签的地方),一件对应一条记录。</para>
///
/// <para><b>锚点和对齐出自同一张表</b>:贴在左下角却把字居中,字就会横跨在那一点两侧。
/// 锚点决定矩形从哪一侧从点起排,对齐由同一个锚点算出来(<see cref="XChartLabelAnchorMath"/>)。</para>
///
/// 子节点结构:
/// [Labels]
/// └─ GeneratedTexts(文本槽位的宿主)
/// </summary>
[AddComponentMenu(XericRegistrationPaths.Chart + "/Text/Data Label Tool")]
public class ChartToolLabels : XChartToolBase
{
// ── 数据装配 ──────────────────────────────────────────────
private int m_LabelSlot;
/// <summary>读第几个<b>标签列</b>(不是表里的行号;换算只有 <see cref="XChartColumnMath.LabelSlotOf"/> 那一处)</summary>
public int LabelSlot { get => m_LabelSlot; set { m_LabelSlot = value; MarkDirty(); } }
private int m_DimensionX;
/// <summary>标签挂在哪条记录的哪一个位置:三个数值维下标(显示范围归 chart 的数据维度行)</summary>
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;
/// <summary>标签的位置受显示范围之外的影响时怎么办(§32:范围只定标尺,画不画由数据图元自己决定)</summary>
public XChartValueOutOfRange OutOfRange { get => m_OutOfRange; set { m_OutOfRange = value; MarkDirty(); } }
// ── 外观 ──────────────────────────────────────────────────
private XChartLabelAnchor m_Anchor = XChartLabelAnchor.UpperCenter;
/// <summary>标签矩形相对它那一点的位置(9 档)。<b>文字对齐由同一档算出来</b>,不另给一个字段</summary>
public XChartLabelAnchor Anchor { get => m_Anchor; set { m_Anchor = value; MarkDirty(); } }
private Vector2 m_Offset = new Vector2(0f, 6f);
/// <summary>从那个点再挪多少像素(非有限数按零算:NaN 进 anchoredPosition 会把这一件字整个挪出画面而不报错)</summary>
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]);
}
/// <summary>显示范围只问上下文要(覆盖优先、否则该维聚合):元素自己存一份范围就是"标签和轴对不上"的来路</summary>
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
/// <summary>
/// 报表里这一行只印"这一帧到底有没有写、没写的话卡在哪":<b>数据侧</b>(skipped/hidden/empty)
/// 与<b>槽位侧</b>(want/have/pending)必须分开,否则"这一行没标签"和"件还没发落"在画面上同形。
/// </summary>
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
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 04e8bfc387c126047b089da0749b1cda
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
@@ -0,0 +1,72 @@
using System;
using TMPro;
using UnityEngine;
namespace XericUI.XChart.Text
{
/// <summary>标签矩形相对它那一点的位置:9 档(四角 + 四边中点 + 中心)。</summary>
public enum XChartLabelAnchor
{
LowerLeft,
LowerCenter,
LowerRight,
MiddleLeft,
Center,
MiddleRight,
UpperLeft,
UpperCenter,
UpperRight,
}
/// <summary>
/// 锚点的<b>纯算</b>部分(离线可验)。
///
/// <para><b>为什么锚点与对齐必须出自同一张表</b>:锚定在左下角的矩形如果把字居中对齐,
/// 字就横跨在那一点两侧,"标签贴在点上"这句话当场作废。以前这两件事各写各的
/// (锚点一处、对齐来自池的默认值),所以改锚点而字仍居中是画面上最难归因的一种错。</para>
/// </summary>
public static class XChartLabelAnchorMath
{
/// <summary>九档锚点各自的那个位置([0,1] 内的矩形锚位)。九档互不相同是判据,不是巧合。</summary>
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
}
}
/// <summary>
/// 这一档锚点对应的文字对齐:<b>由同一个锚点算出来</b>(横分量取锚点的 x、纵分量取锚点的 y)。
/// 这样"贴在左下角"和"字从左下角起排"是同一件事,不再有第二处定义。
/// </summary>
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;
}
/// <summary>
/// 偏移:<b>非有限数当成零</b>。NaN 进 anchoredPosition 会把这一件字整个挪出画面,
/// 而且它不报错——这正是"计数全对、画面空无一物"那一族。
/// </summary>
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;
}
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: 887ef129beec6e841875636169cb0a4d
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
+101
View File
@@ -0,0 +1,101 @@
using System;
using UnityEngine;
using XericUI.XChart.Space;
namespace XericUI.XChart.Text
{
/// <summary>
/// 数据标签元素的配置。<b>面板这一侧只存"选哪一档/哪一列"</b>:
/// 锚点与文字对齐的对应关系住在 <see cref="XChartLabelAnchorMath"/>,
/// 列号到标签槽的换算住在 <see cref="XChartColumnMath"/>——配置里再写一遍就会各说一套。
///
/// <para><c>LabelSlot</c> 是<b>标签列的序号</b>(不是数据表里的行号):窗口里排在最前面那些列就是标签列,
/// 面板上看到的列号要换算成槽号才读得对,所以这一格存的是槽号而由同一处算出来。</para>
/// </summary>
[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;
}
}
@@ -0,0 +1,11 @@
fileFormatVersion: 2
guid: c3ac62f975d4c9f4180064e4839edabc
MonoImporter:
externalObjects: {}
serializedVersion: 2
defaultReferences: []
executionOrder: 0
icon: {instanceID: 0}
userData:
assetBundleName:
assetBundleVariant:
+65
View File
@@ -60,5 +60,70 @@ namespace XericUI.XChart
} }
return null; return null;
} }
// ── 标签列(String 那一族):与数值列同一套规则,只是占的是标签数组的格 ──
//
// 记录身上有两个数组:值数组的长度=<see cref="ValueCount"/>,标签数组的长度=
// <see cref="LabelCount"/>。<b>标签数组的长度就是它自己的判据</b>:一条记录能写出
// 比标签列更多的字符串,那些字符串没有一个列能叫出名字,屏幕上便凭空多出一个标签
// (以前这里靠调用方自觉,所以导入能塞进去、窗口显示得出来、元素却读不到)。
/// <summary>标签列的个数=每条记录标签数组的长度(非标签列不占格)</summary>
public static int LabelCount(IReadOnlyList<XChartDimensionDefinition> 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;
}
/// <summary>
/// 表里第 <paramref name="tableIndex"/> 行对应的<b>标签下标</b>;
/// 那一列不占标签格(种类不是 Label)或行号越界时返回 <c>-1</c>。
/// </summary>
public static int LabelSlotOf(IReadOnlyList<XChartDimensionDefinition> 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;
}
/// <summary>
/// 把一条记录的标签数组按<b>标签列个数</b>定长——这是"记录标签长度"唯一的定义处:
/// 按位置逐格搬(不是按列号搬:列号已经被调用方换算过),短的补空串、长的截掉。
/// <b>加/删列之后重排就靠它</b>,所以各写入路径不许各自 Copy 一遍。
/// </summary>
public static string[] SizedLabels(IReadOnlyList<string> 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;
}
/// <summary>反方向:标签下标属于表里哪一列(拿到那一列的定义)——与 <see cref="DefinitionOfValueSlot"/> 对称</summary>
public static XChartDimensionDefinition DefinitionOfLabelSlot(
IReadOnlyList<XChartDimensionDefinition> 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;
}
} }
} }
+56 -17
View File
@@ -222,17 +222,26 @@ namespace XericUI.XChart
/// </summary> /// </summary>
public int NumericDimensionCount => XChartColumnMath.ValueCount(m_Dimensions); public int NumericDimensionCount => XChartColumnMath.ValueCount(m_Dimensions);
/// <summary>
/// 标签列个数=每条记录标签数组的长度(<see cref="XChartColumnMath.LabelCount"/>,唯一那一条规则)。
/// <b>1:1 是形状而不是一句承诺</b>:记录身上可以写出比标签列更多的字符串,那些字符串没有一个列
/// 叫得出名字,屏幕上就凭空多出一个标签,而报表里看不出是谁写的。
/// </summary>
public int LabelDimensionCount => XChartColumnMath.LabelCount(m_Dimensions);
public void SetDimensions(IList<XChartDimensionDefinition> dimensions) public void SetDimensions(IList<XChartDimensionDefinition> dimensions)
{ {
m_Dimensions.Clear(); m_Dimensions.Clear();
if (dimensions != null) for (int i = 0; i < dimensions.Count; i++) m_Dimensions.Add(dimensions[i]); if (dimensions != null) for (int i = 0; i < dimensions.Count; i++) m_Dimensions.Add(dimensions[i]);
int numericCount = NumericDimensionCount; int numericCount = NumericDimensionCount;
int labelCount = LabelDimensionCount;
for (int i = 0; i < m_Records.Count; i++) for (int i = 0; i < m_Records.Count; i++)
{ {
var values = new float[numericCount]; var values = new float[numericCount];
int copyCount = Math.Min(values.Length, m_Records[i].Values.Count); 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]; 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(); Publish();
} }
@@ -293,19 +302,26 @@ namespace XericUI.XChart
// 值数组按"数值维中的序号"排,不是按维度表下标排:中间夹一个非数值维时两者会错开 // 值数组按"数值维中的序号"排,不是按维度表下标排:中间夹一个非数值维时两者会错开
// 值下标由那一条规则给(非数值列返回 -1:本来就没有格要摘) // 值下标由那一条规则给(非数值列返回 -1:本来就没有格要摘)
int column = XChartColumnMath.ValueSlot(m_Dimensions, index); int column = XChartColumnMath.ValueSlot(m_Dimensions, index);
int labelSlot = XChartColumnMath.LabelSlotOf(m_Dimensions, index);
m_Dimensions.RemoveAt(index); m_Dimensions.RemoveAt(index);
if (column >= 0) if (column >= 0 || labelSlot >= 0)
{ {
for (int i = 0; i < m_Records.Count; i++) for (int i = 0; i < m_Records.Count; i++)
{ {
var record = m_Records[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++) for (int j = 0, k = 0; j < record.Values.Count; j++)
if (j != column) values[k++] = record.Values[j]; if (column < 0 || j != column) values[k++] = record.Values[j];
m_Records[i] = new XChartRecord(record.RecordId, record.Timestamp, values, CopyLabels(record.Labels));
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; return true;
} }
/// <summary>
/// 加一条记录。两个数组都必须<b>对得上当前的列</b>:值数组长度=数值列个数,
/// 标签数组长度=标签列个数(或 <c>null</c>=这一条还没有标签)。
/// 长度不对就整条拒收、不改一半——"多出来的那个字符串"没有列叫得出它的名字,
/// 落进表里就是屏幕上一个没主的标签(1:1 靠门口这一关守住,不靠调用方自觉)。
/// </summary>
public bool TryAddRecord(double timestamp, float[] values, string[] labels = null) public bool TryAddRecord(double timestamp, float[] values, string[] labels = null)
{ {
if (double.IsNaN(timestamp) || double.IsInfinity(timestamp) || values == null || values.Length != NumericDimensionCount) return false; 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; 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 > 0 && timestamp < m_Records[m_Records.Count - 1].Timestamp) return false;
if (m_Records.Count == Capacity) if (m_Records.Count == Capacity)
{ {
@@ -325,7 +348,7 @@ namespace XericUI.XChart
} }
var copy = new float[values.Length]; var copy = new float[values.Length];
Array.Copy(values, copy, values.Length); Array.Copy(values, copy, values.Length);
m_Records.Add(new XChartRecord(m_NextRecordId++, timestamp, copy, labels ?? Array.Empty<string>())); m_Records.Add(new XChartRecord(m_NextRecordId++, timestamp, copy, CopyLabels(labels)));
Publish(); Publish();
return true; return true;
} }
@@ -377,15 +400,19 @@ namespace XericUI.XChart
return true; return true;
} }
/// <summary>改某条记录的某个标签(下标越界或空串一律拒绝)</summary> /// <summary>
public bool TrySetLabel(int recordIndex, int labelIndex, string text) /// 改某条记录在某一标签列上的字符串。<b>下标是标签下标</b>(第几个标签列,不是表里的行号),
/// 由 <see cref="XChartColumnMath.LabelSlotOf"/> 换算。行号或下标越界拒绝;<b>空串是合法值</b>
/// (把标签清空),所以清空与"这一列本来没有格"分得开——后者压根进不到这里。
/// </summary>
public bool TrySetLabel(int recordIndex, int labelSlot, string text)
{ {
if (recordIndex < 0 || recordIndex >= m_Records.Count) return false; if (recordIndex < 0 || recordIndex >= m_Records.Count) return false;
var record = m_Records[recordIndex]; 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); 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); m_Records[recordIndex] = new XChartRecord(record.RecordId, record.Timestamp, CopyValues(record.Values), labels);
Publish(); Publish();
return true; return true;
@@ -484,6 +511,20 @@ namespace XericUI.XChart
return definition != null; return definition != null;
} }
/// <summary>
/// 取某条记录在某一标签列上的字符串(<b>标签下标</b>,第几个标签列)。
/// 行号或下标越界返回 false;列存在但那一格是空串时返回 true + 空串——
/// "这一列没这一格"和"这一格是空的"是两件事,画不画由调用方决定。
/// </summary>
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;
}
/// <summary> /// <summary>
/// 一次扫描算 Count/First/Last/Min/Max/Sum/Mean/Rms;中位数单独排序一次。 /// 一次扫描算 Count/First/Last/Min/Max/Sum/Mean/Rms;中位数单独排序一次。
/// 结果按(版本, 维度)缓存,请求的是缓存子集时直接复用。 /// 结果按(版本, 维度)缓存,请求的是缓存子集时直接复用。
@@ -620,12 +661,10 @@ namespace XericUI.XChart
return low; return low;
} }
private static string[] CopyLabels(IReadOnlyList<string> labels) /// <summary>标签数组的拷贝<b>并且按那一条规则定长</b>——长度只由标签列个数决定,
{ /// 所以任何一次写入之后,"这一行的标签个数"都还等于表里的标签列数。</summary>
var copy = new string[labels.Count]; private string[] CopyLabels(IReadOnlyList<string> labels)
for (int i = 0; i < labels.Count; i++) copy[i] = labels[i]; => XChartColumnMath.SizedLabels(labels, LabelDimensionCount);
return copy;
}
} }
public class XChartDataModel3D public class XChartDataModel3D
+14
View File
@@ -155,6 +155,12 @@ namespace XericUI.XChart
/// <summary>数值维度数量</summary> /// <summary>数值维度数量</summary>
int NumericDimensionCount { get; } int NumericDimensionCount { get; }
/// <summary>
/// 标签(String)列数量=每条记录身上标签数组的长度。<b>元素只能读到这里说得出的那些格</b>:
/// 记录里比这更多的字符串没有一个列能叫出名字,所以这一数就是"1:1"的形状判据。
/// </summary>
int LabelDimensionCount { get; }
/// <summary>是否有数据</summary> /// <summary>是否有数据</summary>
bool HasData { get; } bool HasData { get; }
@@ -182,6 +188,14 @@ namespace XericUI.XChart
/// </summary> /// </summary>
bool TryGetDimension(int dimension, out XChartDimensionDefinition definition); bool TryGetDimension(int dimension, out XChartDimensionDefinition definition);
/// <summary>
/// 取某条记录在某一标签列上的字符串。<b>下标是标签下标</b>(同一个口径:
/// <see cref="XChartColumnMath.LabelSlotOf"/> 把"表里那一列"换算成它)。
/// 越界返回 false(渲染路径里调用,不抛)——"这一格没有"和"这一格是空串"要分得开,
/// 所以空串照实返回 true,由调用方决定要不要画。
/// </summary>
bool TryGetLabelAt(int recordIndex, int labelSlot, out string text);
/// <summary>按时间窗打开一个范围游标(虚拟指针)</summary> /// <summary>按时间窗打开一个范围游标(虚拟指针)</summary>
XChartRangeCursor OpenRange(int dimension, double fromTime, double toTime); XChartRangeCursor OpenRange(int dimension, double fromTime, double toTime);
} }
+21 -2
View File
@@ -213,6 +213,14 @@ namespace XericUI.XChart
return false; return false;
} }
// 少字段的行要在门口拒:直接读 fields[1] 会抛出去,而"导入失败"的语义是
// **指出行号并整份拒绝**,不是把异常丢给调用方(半份数据比没数据更坏)
if (fields.Length < 2)
{
error = "第 " + (i + 1) + " 行的记录少了时间戳字段";
return false;
}
double timestamp; double timestamp;
if (!TryParseDouble(fields[1], out timestamp)) if (!TryParseDouble(fields[1], out timestamp))
{ {
@@ -224,11 +232,22 @@ namespace XericUI.XChart
for (int d = 0; d < dimensions.Count; d++) for (int d = 0; d < dimensions.Count; d++)
if (dimensions[d].Kind == XChartDimensionKind.Number) numericCount++; 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) if (fields.Length - 2 < numericCount)
{ {
error = "第 " + (i + 1) + " 行的数值个数(" + (fields.Length - 2) + ")少于数值维个数(" + numericCount + ")"; error = "第 " + (i + 1) + " 行的数值个数(" + (fields.Length - 2) + ")少于数值维个数(" + numericCount + ")";
return false; return false;
} }
if (labelFields != labelCount)
{
error = "第 " + (i + 1) + " 行的标签个数(" + labelFields + ")与标签列个数(" + labelCount + ")对不上";
return false;
}
var values = new float[numericCount]; var values = new float[numericCount];
for (int d = 0; d < numericCount; d++) for (int d = 0; d < numericCount; d++)
@@ -247,8 +266,8 @@ namespace XericUI.XChart
values[d] = (float)value; values[d] = (float)value;
} }
var labels = new string[Math.Max(fields.Length - 2 - numericCount, 0)]; var labels = new string[labelCount];
for (int l = 0; l < labels.Length; l++) labels[l] = fields[2 + numericCount + l]; for (int l = 0; l < labelCount; l++) labels[l] = fields[2 + numericCount + l];
timestamps.Add(timestamp); timestamps.Add(timestamp);
recordValues.Add(values); recordValues.Add(values);
+7
View File
@@ -114,6 +114,13 @@ namespace XericUI.XChart
/// </summary> /// </summary>
public virtual int RequiredRecordCount => 0; public virtual int RequiredRecordCount => 0;
/// <summary>
/// 这个元素要<b>几个标签列</b>才画得出来(0=不需要)。标签元素读的是那一列在每一行上的那一格:
/// 表里没有标签列时它一条都不画,而这在画面上和"没数据"长得一模一样——所以"要几个、表里有几个"
/// 必须和数值维、记录数一起印出来(§25.1 的第三半)。
/// </summary>
public virtual int RequiredLabelColumns => 0;
/// <summary> /// <summary>
/// 互斥显示:<paramref name="fieldName"/> 这个字段在当前配置下要不要从面板上<b>藏掉</b>。 /// 互斥显示:<paramref name="fieldName"/> 这个字段在当前配置下要不要从面板上<b>藏掉</b>。
/// ///