diff --git a/CHANGELOG.md b/CHANGELOG.md index eb01774..b6015b1 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -101,6 +101,7 @@ P22 箭头改走"线 + 库的原生标记"(规范 §29,2026-10-26 他纠正 P24 箭头:方向来源四档 + 头的尺寸吃投影 + 锚点(规范 §30,2026-10-26 他三条要求):① **他指出的"矢量被归一化到屏幕空间再算了"是真的**,成因在库那一行 `CurveMeshGenerator.cs:150 pos += tangent * arrow.width * 0.5f * arrow.depthCompensation`——标记的**方向**跟曲线切线走(对)、**尺寸是固定像素**(不是投影结果):杆会随姿态缩短而头不缩,整支读起来就是"屏幕空间里等长的箭头"。修法:新增纯算术 `ProjectedScale(投影像素, 立方体长度, CubeToPixel)`=这条矢量自己的投影比例(平行于屏幕=1、指向屏幕里→0),头的两个尺寸都乘它;连续绘制那一档取**这一节自己**的比例,所以弯到背面去的那一节头跟着一起缩;**除不出来(NaN、零长、零比例)就答 0**——宁可头缩成没有,也不要一个凭空的固定像素尺寸。② **`XChartArrowDirectionSource` 四档**(他的"一个箭头对应两组数据 ⇒ 32 个点只该 16 支"):`NextRecordAsVector`(旧 Absolute,N−1)/`NextRecordAsPoint`(旧 Relative,N−1,**点到点不用再算一次投影**,所以 `Tip` 只在这一档作差)/`ThisRecordCarriesVector`(同一条的 3~5 维是方向,N 支、要 6 维)/`AlternatingRecords`(偶数条是点、奇数条是方向,N÷2 支);**支数与维数只有 `ArrowCount(source,…)`/`RequiredCoordinateDimensions(source)` 这一个实现**——四档算法在工具里各写一遍,画面上只是"少几支",最难查。③ **方向是原始矢量、绝不按位置的显示范围折**(`TryReadRaw`):折一次就把"朝哪"变成"在哪"(`(0,1,0)` 会被折成一个偏移量,整场箭头一起跑偏),尺度交给 `DirectionScale`;顺带 `XMeshPreviewChart` 那份"一条记录 6 维、方向存 3~5"的旧示例数据在新档 `ThisRecordCarriesVector` 下**正好合法**(§28.5 说的"死数据"有了读法,默认值我没替他改)。④ **序列化兼容**:新枚举 0/1 就是旧 `XChartArrowVectorMode` 的 Absolute/Relative,字段再加 `[FormerlySerializedAs("m_VectorMode")]` ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改字段名静默丢值"的反面)。⑤ **`MarkerAnchor` [0,1]** → 库的 `depthCompensation`(`anchor×2−1`;0=尾部落点、0.5=中心、1=头尖落点=默认),非有限退回 1。⑥ **颜色维撞上方向维**:自带方向那档吃 0~5 六列而颜色起点默认仍是 3 ⇒ 会把方向当色相读;判据是撞了就退回单色并印 `colors=overlap`("颜色没生效"与"配置撞了"分得开)。判据:探针 **462** 项 0 失败(新增 10 条:四档各自支数(含 33÷2=16、1 条=0)、维数需求只有自带方向那档要 6、锚点 0/0.5/1→−1/0/+1、越界夹取与非有限回退、投影比例 1/0.5/指向屏幕=0、坏输入答 0)+ `p4_control` **66** 支(新增 3 支:分档按条数算/头无视投影比例/锚点映射写死 0;**删 1 支**——"空表被挡在算术外"那支的守卫在新算术下已经到不了,**没有靶子的臂不当证据用**)+ `dirty_gate` 正本 `knobs=133 takesEffect=133 findings=0`、**九支变异全红** + 编译门三臂 + 3 对照绿(`chain_p24.txt`)。**门自己也现了一次瞎**(本轮最重要的自证):`public T X` 与 `{` 分成两行的属性写法**根本没被数到**,于是总数是 132 而不是 133,而"132/132 PASS"是绿的、却不再等于"每个旋钮都看得见"——补 `match_head`(认得大括号在下一行的声明)并加 **M9_nextline** 专测这种失明:把某个旋钮改写成多行形状**并抽掉它的 `MarkDirty()`**,门必须红(看不见形状的门会放行一个不置脏的旋钮)。另记两次 harness 正常工作:CJK 又进了一次声明 `coding: ascii` 的脚本(第三次),以及一支臂的锚点被我新写的孪生函数撞成 2 命中 ⇒ `SETUP FAILED` 整轮作废(锚点加宽成两行块;规矩已进记忆)。 P26a 文本槽位复用时恢复默认(存量缺陷,2026-10-26 他提标签需求时点出"我们改的属性在池复用的阶段都要能恢复默认"):`XChartTextSlotFactory.Acquire()` 以前只给**新建**那件设默认,从 `m_Free` Pop 出来的只 `SetActive(true)`,而元素每帧往槽位写的远不止那些(轴线六样:`text/fontSize/color/sizeDelta/anchoredPosition/localEulerAngles`,`ChartToolAxis.cs:469-474`)⇒ 复用件带着上一轮的字色、矩形大小和旋转走,新元素只写自己关心的几样,剩下沿用——症状"标签换个顺序就变大/歪了",画面上看不出是谁写的("同一件事两处存"的另一种:上一轮的残留也是两处)。修法:抽 `public static ResetToDefaults(TMP_Text)`,**默认值只此一处定义**,新建与复用**两条路径都调**。清单不靠记忆:新门 `slot_reset_gate.py` 两条主张——A 所有元素写过的属性 ⊆ 恢复清单(`files scanned=53 slot writes=14 distinct=7 reset lines=16`)、B 恢复函数真的在**两条获取路径**上被调用(只在新建分支调=一条绿谎,直接 FAIL);三支变异各红在点名处(S1 从清单删 `fontSize`、S2 让轴线多写一个 `overflowMode` 当场点名、S3 删掉复用路径那句调用 → 两个分支同报 False),正本 PASS + 三支全红 + 编译门三臂绿(`chain_p26a.txt`)。一条 TMP 版本事实由门先替我撞:这版 `TextMeshProUGUI.outlineWidth` 是 **float** 且没有 `enableOutline` ⇒ 宽度归零即不描边(我按新版文档写的 `Vector2.zero`/`enableOutline` 吃了 CS0029+CS1061,没进他的编辑器)。覆盖不到:这一笔不解决"上不上屏"(P23/P25),只保证"没写的属性不会带着上一轮的值"。 P28 面边插槽 6×4=24(规范 §31,2026-10-26 他数的两件事):他先说"网格发布的轴线虽然有 12 个,实际可用的只有上下两个面周围的边线,另外 4 个垂直边线插槽无法注册",又说"只有前面的 mesh.face.1-5 有用,后面的 mesh.face.0.grid.S/T 都没用"——**两句都对得上字面**,而且各有各的成因:板上当时只有 `mesh.face.<0..5>`(Quad3D 面四角,6 个)和 `mesh.face..grid.S|T`(Line3D **比例数组**,12 个),而轴线只认 Quad3D(`ResolveFaceFrame`),所以那 12 条在"已发布插槽"下拉里**永远是死项**(它们是「对齐格线」那一栏的输入,不是宿主);"4 条垂直棱注册不上"则不是漏发布,而是**"边"根本不是一个可寻址的东西**——以前只能"选一个面 + `CrossRatio=±1`"去贴一条棱,而一根立方体棱被两个面共享、两面的面内方向又不同 ⇒ 同一根棱两种参数化,其中一种落不到你要的位置。他给的结论正是缺的那层命名:"不可能只有 12 个,而是 4×6=24 个,命名该是 face/side,然后根据面选择对应的边"。落法:① id `mesh.face..side.` 共 24(前缀沿用 `mesh.face.`——`TryGetSlotAt` 与轴从 id 回落读面号都按它解析,换写法就等于同时存在两套前缀);② **值就是同一个面的四角按 `<00,01,11,10>` 环旋转 s 格**,让选中的那条棱正好落在面帧底边(S 轴、t=0)⇒ 仍是 `Quad3D`,轴线的 `AlongS`/`CrossRatio`/刻度朝外/标签随轴旋转**一行都不用改**,绕序不变所以不会镜像(镜像了"往面内刻度"就翻到外面);边号 0 底·1 左·2 顶·3 右(`SideName` 一个来源,面板与报表共用);③ **发布者只有线框元素**(它就是画棱的那个,`mesh.face.` 也它发),一处算式出 24 份,报表 `faces=6 sides=24`,发不出去印 `sideRefuse=<原因>`;④ 面板下拉只列"能当宿主的",判据收成**一处** `ChartToolAxis.CanHostAxis(mode)`(消费者与面板共用,否则会出现"下拉里能选、线上画不出"),并明说"另有 N 个比例数组插槽是给对齐格线用的"——不静默少一项;轴那行现成的 `slot=` / `frame=slot|cube` 已能回答"我贴上了哪条边",没加新读数。判据:探针 **466** 项 0 失败,新增 4 条**全部打在性质上**(每个 side 的底边就是它自己那条棱/旋转后法向同向不镜像/24 档把 12 条棱**各覆盖两次**——这就是"不该只有 12 个"的机器版说法/id 与边名不撞),故意不写成"重跑实现自己的下标",否则改错旋转的人会顺手把判据一起改错;`p4_control` **69** 支(新增 3 支:所有 side 旋到同一格/环序取镜像/两条边名撞同一个词);编译门三臂 + 3 对照绿(`chain_p28.txt`)。⑤ 选中项还在下面一行翻成人话(`mesh.face.2.side.1` → "当前宿主:面 Top · 左边(side.1)"):**下拉的选项文本就是写回的值**,加后缀会写坏 id,所以翻译只能另起一行;面板在值变化时故意不重建树(那会换掉正在拖的控件),所以这一行自己跟着回调改——挂在树上的静态读数正是 §24.1 点过的那一族。顺带一条自证:我先在文档里写了"SideName 面板与报表共用",而当时代码里**没人用它**(下拉显示的是裸 id),这句话在下一笔里被改成真的,而不是把文档改回来说假话。本轮自己两次被工具拦下并如实记下:`git add -A` 被分类器拒绝(这条一直禁用;提交用 pathspec 就够,不需要暂存),以及中文第三次进了声明 `coding: ascii` 的门脚本(⇒ 臂文件里的中文源行改用 `\uXXXX`)。覆盖不到:30 个插槽真进了下拉、垂直棱真贴住了,只有他现场判(报表 `sides=24`、`slot=`、`frame=slot`)。 +P27 显示范围只定标尺;数据图元自己决定"钳/藏/原样"(规范 §32,2026-10-26 他裁定):症状是**同一张表两幅画**——散点折进盒子用的是 `Mathf.Clamp01`(超范围的点钉在盒壁上,看着像"数据到边就停"),而矢量与圆柱按 `TryNormalize` 比例投(可以跑到盒外),两边都"看着挺对"、谁也不报错(再往前箭头连折都没折=§28 的"计数全对画面空无一物")。他给的口径:**范围的本分是定标尺(网格多大、轴到哪儿),它不该决定数据画不画**;数据项目该呈现自己准确的位置;有时又确实想看被限制住的版本 ⇒ 开关交给数据图元。落法:① 新纯算术 `XChartCubeFoldMath`——`TryRatio01(value,min,max,behaviour,out 0..1)` 是**唯一**一份"值→盒子内比例",`TryFoldCube` 是三轴全有或全无版([-1,1];只夹一轴会画出"数据里不存在"的位置,比少画一条糟得多);② 圆柱原来调 `XChartBindingMath.TryNormalize`、箭头调 `XChartVectorFieldMath.TryCubePoint`、散点调自己那份 `Normalize` ⇒ **三份并成一份**(箭头的 `TryCubePoint` 删掉);③ 数据图元各一个三档 `XChartValueOutOfRange`,**默认 `RenderAsIs`**(散点从此不贴边=行为变更,另一处行为变更:**一整列同一个数**以前让矢量整条拒答,现在答居中,因为为"还没钉范围"把元素弄没等于把状态误报成"这里没有数据";坏数 NaN/Inf 仍拒答);轴与格线**永远**用范围、不给开关(否则就是 §20 一路在拆的"格线按 A、刻度按 B");④ 颜色映射那一档**刻意不统一**:越界的颜色取端色是常态,继续夹,"隐藏超范围"是坐标的事——写成注释防下次有人"顺手统一"把梯度弄出洞;⑤ 读数 `out=asis|clamptorange|hideoutofrange` 与 `hidden=`(策略隐的)/`skipped=`(数据不可用的)分开印,"我主动不画"和"数据不能用"必须分得开。搬家那一步被门抓了一次且抓得对:`dirty_gate` 的 claim F 当场 FAIL("箭头的坐标不再经过折法")——它判的是"必须经过**唯一那份**折法"而不是"必须调用某个旧名字",所以正确处置是把门指向新来源,**删判据是错的处理**;M8(把旧形状塞回去)这轮继续红,顺带证明"搬家会被抓到"。判据:探针 **469** 项 0 失败(三档各一条 + 常数列居中 + 坏数仍拒 + §28 那批域内/域外判据挪到唯一实现上)、`p4_control` **71** 支全红在点名断言(新 2 支:hide 不 hide/clamp 不 clamp;搬家 3 支重挂新文件)、`dirty_gate` 正本 `knobs=136 takesEffect=136`(三个新旋钮都是自动置脏 setter)九支全红、编译门三臂 + 3 对照绿(`chain_p27.txt`)。自己的错照记:新判据的期望值我手打算错了(y 域是 `-20..20` 却按 `-100..50` 算),探针第一次跑就红——手打的数字必须有对着真输入的断言;中文第四次进了声明 `coding: ascii` 的门脚本。覆盖不到:画到盒外的点会不会被别的东西挡住、以及"默认到底该钳还是原样"的观感,归他现场判——**他觉得"跑出去太乱"时不用回滚代码,把那一档调成 `ClampToRange` 就行**,这正是开关存在的意义。 ## [0.1.6] - 2026-07-01 diff --git a/Documentation/XChart-ExternalAPI.md b/Documentation/XChart-ExternalAPI.md index 7f69f50..227143a 100644 --- a/Documentation/XChart-ExternalAPI.md +++ b/Documentation/XChart-ExternalAPI.md @@ -188,6 +188,8 @@ chart.Space.CenterOffset = new Vector2(0, 40f); 7. **`UICurveRenderer.LiveVertexCount` 不是本实例的数**(报表里 `curveVerts=` 是"库里一共活着多少顶点",P23 待办);要判自己那份,读 `curves=`/`markers=`。 8. **雷达图与伪 3D 图是两套空间**:`XRadarChart` 用自己的 `XChartRadarDataModel`(2D 极坐标),不吃立方体的 `TryResolveDomain` 那套。 9. **别在元素自己的对象上做手脚**:工具与它生成的节点是运行时的(`HideAndDontSave`),重建一次就换一批——把状态存在你自己的组件或配置里。 +10. **显示范围只定标尺,不决定数据画不画**(§32):散点/矢量/圆柱各有一个 `OutOfRange` 三档(`RenderAsIs` 默认=超范围的点画到盒子外面、`ClampToRange`=贴回盒壁、`HideOutOfRange`=整条不画),轴与格线**永远**按范围、没有这个开关。想让点"限定在网格内"就把那一档调成 `ClampToRange`——默认已经不是了。报表里 `hidden=`(策略隐的)与 `skipped=`(数据不可用的)是两个数。 +11. **从对象池拿到的文本件是干净的**(§P26a):颜色/字号/旋转/矩形在复用时会恢复默认,所以你的元素"没写的属性"不会继承上一个元素写过的值;反过来,**你在元素上没设的属性就是那一份默认**(14 号字、白色、不换行、居中对齐)。 ## 10. 端到端:一个"掘进姿态"箭头 diff --git a/Documentation/XChart-RenderFramework.md b/Documentation/XChart-RenderFramework.md index e4190bd..707262c 100644 --- a/Documentation/XChart-RenderFramework.md +++ b/Documentation/XChart-RenderFramework.md @@ -2109,3 +2109,58 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码 这一条是他这次报"垂直边注册不上"的直接判据。 3. 报表里线框那行 `sides=24`;轴那行 `slot=` 与 `frame=slot` 同时到位(`frame=cube` 说明回落了,即没读上槽)。 4. 转立方体看刻度方向对不对——这条机器判不了(§13.2)。 + +## 32. P27:显示范围只定标尺;数据图元自己决定"钳 / 藏 / 原样"(2026-10-26 他裁定) + +### 32.1 症状:同一张表两幅画 + +散点折进盒子时用的是 `Mathf.Clamp01`(`ChartToolScatterPoints`),所以超范围的点**钉在盒壁上**——看着像"数据到边就停"; +而矢量与圆柱按 `TryNormalize` 比例投,**可以跑到盒子外面**。两边都"看着挺对",谁也没报错。 +(再往前,箭头连折都没折,那就是 §28 的"计数全对、画面空无一物"。) + +### 32.2 口径:范围的本分是定标尺,不是决定数据画不画 + +- **轴线与格线永远用它**——不给开关。否则会出现"格线按 A 范围铺、刻度按 B 范围标",那正是 §20 一路在拆的东西。 +- **数据图元**(散点、矢量箭头、圆柱;以后的标签同理)各有一个三档开关 `XChartValueOutOfRange`,**默认 `RenderAsIs`**: + `RenderAsIs` 按数据自己的值投(可以出盒外,"呈现自己准确的位置")· `ClampToRange` 夹到范围端点 · `HideOutOfRange` 整条不画。 +- 隐藏是**整条记录**,不藏一半坐标:只夹一轴会画出一个"数据里不存在"的位置,比少画一条糟得多。 + +### 32.3 一份折法,三处调用 + +新纯算术 `XChartCubeFoldMath`:`TryRatio01(value, min, max, behaviour, out 0..1)` 是**唯一**的"值 → 盒子内比例", +`TryFoldCube` 是它的三轴全有或全无版([-1,1])。圆柱原来调 `XChartBindingMath.TryNormalize`、 +箭头调 `XChartVectorFieldMath.TryCubePoint`、散点调自己那份 `Normalize`——**三份并成一份**,箭头的 `TryCubePoint` 删除。 + +删除那一步被门抓了一次,而且抓得对:`dirty_gate` 的 claim F 当场报 FAIL("箭头的坐标不再经过折法")。 +它判的是**"坐标必须经过唯一那份折法"**,不是"必须调用某个旧名字"——所以搬家的正确处置是把门指向新来源, +**删判据是错的处理**。九支变异里 M8 这一轮顺手证明了这件事:把旧形状(原始值直接进 `Vector3`)塞回去,门红。 + +还有一处刻意**不统一**:颜色映射那一档继续夹(`Normalize` 只服务它)。越界的颜色取端色是常态, +"隐藏超出范围的数据"是坐标的事——把梯度也弄出洞来才是灾难。这条写进注释,防止下次有人"顺手统一"。 + +### 32.4 这次改到的两处默认行为(他要看得见的) + +1. **散点不再贴边**:默认下超范围的点画在盒子外面(UGUI 不裁,所以会画到图外)。想让点限定在网格内就把这一档调成 `ClampToRange`。 +2. **一整列同一个数**以前让矢量整条拒答(跨度 ≤0 ⇒ `false` ⇒ 少画),现在答**居中**; + 坏数(NaN/Inf)仍旧拒答。理由:为"我还没钉范围"把整个元素弄没,等于把状态误报成"这里没有数据"(§25.1 同一条精神)。 + +读数跟着补了两个:`out=asis|clamptorange|hideoutofrange`(这一档选的是什么)、 +`hidden=`(按策略隐掉的条数)与 `skipped=`(数据不可用的条数)——**"我主动不画"与"数据不能用"必须分得开**。 + +### 32.5 判据 + +- 探针 **469** 项 0 失败:三档各一条(原样保持成比例 / 夹住落 ±1 / 藏起来整条拒),加上 + "常数列答居中而不是拒"、"非有限数仍拒"、以及 §28 那批"域内/域外"的判据整体挪到唯一实现上。 +- `p4_control` **71** 支全红在点名断言上(新 2 支:`HideOutOfRange` 不 hide、`ClampToRange` 不 clamp; + 搬家那 3 支重挂到新文件,点名清单按实测改)。 +- `dirty_gate` 正本 `knobs=136 takesEffect=136 findings=0`(三个新旋钮都是自动置脏 setter),九支变异全红。 +- 编译门 runtime + player + editor + 3 对照绿(`chain_p27.txt`)。 +- 一次自己的错照记:我给新判据手打的期望值算错了(y 域是 `-20..20` 我按 `-100..50` 算), + 探针第一次跑就红——**手打的数字必须有对着真输入的断言**,而这条断言本身就是那个读数器。 + +### 32.6 覆盖不到什么 / 他侧验收(Ctrl+R 后) + +1. 散点:默认下若有超范围的点,它们画在盒子外(这就是"准确位置");调 `ClampToRange` 应当看到它们贴回盒壁; + 调 `HideOutOfRange` 应当少点,且报表 `hidden=` 数得出来。 +2. 矢量/圆柱同样三档各试一次(报表 `out=` 与 `hidden=`/`skipped=` 同步)。 +3. 他如果觉得"跑出去太乱",**不用回滚代码**——那正是这个开关存在的意义:把这一档调成 `ClampToRange` 即可。 \ No newline at end of file diff --git a/Runtime/XChart/Mesh/ChartToolCylinder.cs b/Runtime/XChart/Mesh/ChartToolCylinder.cs index 57aa730..0804d76 100644 --- a/Runtime/XChart/Mesh/ChartToolCylinder.cs +++ b/Runtime/XChart/Mesh/ChartToolCylinder.cs @@ -68,6 +68,14 @@ namespace XericUI.XChart.Mesh /// 最多画几根 public int MaxCylinders { get => m_MaxCylinders; set { m_MaxCylinders = value; MarkDirty(); } } + private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs; + /// 数据落在显示范围之外时怎么办(默认原样画,§32);隐藏是整根不画,不画一半坐标 + public XChartValueOutOfRange OutOfRange + { + get => m_OutOfRange; + set { m_OutOfRange = value; MarkDirty(); } + } + // ── 呈现(各有开关) ────────────────────────────────────── private bool m_ShowOutline = true; @@ -378,11 +386,12 @@ namespace XericUI.XChart.Mesh return false; float x, y, z; - if (!XChartBindingMath.TryNormalize(raw.x, minX, maxX, out x) - || !XChartBindingMath.TryNormalize(raw.y, minY, maxY, out y) - || !XChartBindingMath.TryNormalize(raw.z, minZ, maxZ, out z)) return false; + // 折法与"超范围怎么办"只有一处定义(XChartCubeFoldMath),散点/矢量/圆柱同源(§32) + if (!XChartCubeFoldMath.TryRatio01(raw.x, minX, maxX, OutOfRange, out x) + || !XChartCubeFoldMath.TryRatio01(raw.y, minY, maxY, OutOfRange, out y) + || !XChartCubeFoldMath.TryRatio01(raw.z, minZ, maxZ, OutOfRange, out z)) return false; - unit = new Vector3(x, y, z); + unit = new Vector3(x * 2f - 1f, y * 2f - 1f, z * 2f - 1f); return true; } diff --git a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs index dddbec9..7f32c49 100644 --- a/Runtime/XChart/Mesh/ChartToolVectorArrows.cs +++ b/Runtime/XChart/Mesh/ChartToolVectorArrows.cs @@ -9,7 +9,7 @@ namespace XericUI.XChart.Mesh /// /// 向量场 / 流形箭头元素。数据口径(规范 §25.2,2026-10-25 他澄清后定稿): /// 前三维=坐标 x/y/z(与圆柱、散点同一套归一化,折法见 - /// 与 §28),一支箭头=相邻两条记录 + /// 与 §28/§32),一支箭头=相邻两条记录 /// (第 i 条是起点,第 i+1 条按 解释成"第二个点"或"方向矢量"), /// 第 4~7 维是颜色(色相 0..256 色环 / 饱和度 / 明度 / 不透明度,可选)。 /// @@ -55,6 +55,17 @@ namespace XericUI.XChart.Mesh /// 箭头自己的变换(叠在图的空间之上) 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 bool m_UseColorDimensions; @@ -132,6 +143,8 @@ namespace XericUI.XChart.Mesh private int m_DimensionsNeed; private int m_RecordsHave; private int m_PointsSkipped; + // 坏数据(非有限)与"按策略隐藏"是两件事:前者是数据不可用,后者是我们主动不画(§32) + private int m_PointsHidden; // 三条坐标轴各自的显示范围(每帧现问上下文要:覆盖优先、否则该维聚合)。 // 数据值必须经它们折成立方体单位才投影——直接当立方体单位用会把整场箭头投到盒子外面(§28) @@ -217,6 +230,7 @@ namespace XericUI.XChart.Mesh m_DimensionsHave = 0; m_RecordsHave = 0; m_PointsSkipped = 0; + m_PointsHidden = 0; m_DimensionsNeed = RequiredDimensionCount; m_HasDomains = false; @@ -445,7 +459,7 @@ namespace XericUI.XChart.Mesh /// /// 一条记录的第 offset~offset+2 维(相对坐标起点)→ 立方体单位的点:原始值先按各维 - /// 范围折进 [-1,1] 再投影(折法在纯算术里,离线钉着:)。 + /// 范围折进 [-1,1] 再投影(折法与"超范围怎么办"在纯算术里,离线钉着:)。 /// 折不出来(值非有限、或那一维跨度为 0)就返回 false,调用方计入 skipped=—— /// 不是"静默少一支",是"少几支当场说"。 /// @@ -454,13 +468,20 @@ namespace XericUI.XChart.Mesh cube = Vector3.zero; if (record < 0 || record >= m_RecordsHave) return false; int dim = CoordinateDimension + offset; - return XChartVectorFieldMath.TryCubePoint( - source.GetValueAt(record, dim), - source.GetValueAt(record, dim + 1), - source.GetValueAt(record, dim + 2), - m_MinX, m_MaxX, m_MinY, m_MaxY, m_MinZ, m_MaxZ, out cube); + double x = source.GetValueAt(record, dim); + double y = source.GetValueAt(record, dim + 1); + double z = source.GetValueAt(record, dim + 2); + if (XChartCubeFoldMath.TryFoldCube(x, y, z, + m_MinX, m_MaxX, m_MinY, m_MaxY, m_MinZ, m_MaxZ, OutOfRange, out cube)) return true; + // 分得清"数据不可用"与"按策略主动不画":两者在画面上同形(都少一支),只有这一对数分得开 + if (IsBad(x) || IsBad(y) || IsBad(z)) m_PointsSkipped++; else m_PointsHidden++; + cube = Vector3.zero; + return false; } + private static bool IsBad(double value) + => double.IsNaN(value) || double.IsInfinity(value); + /// /// 一条记录的三个原始值(方向用):不折进盒子、不位移——方向是矢量, /// 拿位置的显示范围去折它就是把"朝哪"变成"在哪"。这里只保证三个数都是有限数, @@ -533,6 +554,8 @@ namespace XericUI.XChart.Mesh : "-") .Append(" arrows=").Append(m_ArrowsBuilt) .Append(" skipped=").Append(m_PointsSkipped) + .Append(" hidden=").Append(m_PointsHidden) + .Append(" out=").Append(OutOfRange.ToString().ToLower()) .Append(" src=").Append(Continuous ? "continuous" : DirectionSource.ToString().ToLower()) .Append(" anchor=").Append(MarkerAnchor.ToString("0.###")) .Append(" headScale=").Append(m_HeadScale.ToString("0.###")) diff --git a/Runtime/XChart/Mesh/XChartVectorFieldMath.cs b/Runtime/XChart/Mesh/XChartVectorFieldMath.cs index 97deb1c..374408f 100644 --- a/Runtime/XChart/Mesh/XChartVectorFieldMath.cs +++ b/Runtime/XChart/Mesh/XChartVectorFieldMath.cs @@ -62,32 +62,9 @@ namespace XericUI.XChart.Mesh /// public static class XChartVectorFieldMath { - /// - /// 一条记录的原始三值 → 立方体单位:每一维按它自己的显示范围映到 [-1,1] - /// (±1 就是盒子边界),与散点、圆柱走的是同一套()。 - /// - /// 为什么单独有这么一个函数:箭头以前把数据值直接当成立方体单位用了, - /// 于是一份 x∈[-100,50] 的表把所有箭头投到一万多像素之外——支数在算、面在提交、画面什么都没有 - /// (他 2026-10-26:"矢量场现在没有在渲染")。散点和圆柱一直归一化、只有箭头没归, - /// 这就是"同一件事两套口径"的又一种形状:它不报错,只是看不见。 - /// - /// 任何一维给不出有效范围(跨度 ≤0、或值/端点非有限)就整体拒答—— - /// 半归一化的坐标比不归一化的更难查:它会画出"看着像个箭头但方向不对"的东西。 - /// - public static bool TryCubePoint(double x, double y, double z, - double minX, double maxX, double minY, double maxY, double minZ, double maxZ, - out Vector3 cube) - { - cube = Vector3.zero; - - float nx, ny, nz; - if (!XChartBindingMath.TryNormalize(x, minX, maxX, out nx) - || !XChartBindingMath.TryNormalize(y, minY, maxY, out ny) - || !XChartBindingMath.TryNormalize(z, minZ, maxZ, out nz)) return false; - - cube = new Vector3(nx, ny, nz); - return true; - } + // "数据值 → 立方体单位(以及超出显示范围怎么办)"不在这里:散点、矢量、圆柱都要同一套折法, + // 收在 XChartCubeFoldMath(§32)。两处各写一遍就出现过"散点把点夹在盒壁上、矢量却画到盒外"—— + // 同一张表两幅画,而且两边都"看着挺对"。 /// /// 三角形头。 与 都夹进 [0,1]; diff --git a/Runtime/XChart/Mesh/XChartVolumeConfigs.cs b/Runtime/XChart/Mesh/XChartVolumeConfigs.cs index 969a588..4009ab9 100644 --- a/Runtime/XChart/Mesh/XChartVolumeConfigs.cs +++ b/Runtime/XChart/Mesh/XChartVolumeConfigs.cs @@ -32,6 +32,10 @@ namespace XericUI.XChart.Mesh [SerializeField, Min(1), Tooltip("最多画几根(记录多时按组数上限截断,报表会点名截了多少)")] private int m_MaxCylinders = 64; + [SerializeField, Tooltip("数据落在显示范围之外时怎么办:原样画(默认)/ 夹到范围端点 / 整根隐藏。" + + "显示范围的本分是定标尺(网格多大、轴到哪儿),不该顺手决定数据画不画")] + private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs; + [SerializeField, Min(0.001f), Tooltip("半径(立方体单位)")] private float m_Radius = 0.22f; [SerializeField, Range(8, 256), Tooltip("一圈分多少段(轮廓与十字的采样精度)")] @@ -85,6 +89,7 @@ namespace XericUI.XChart.Mesh cylinder.DimensionZ = m_DimensionZ; cylinder.GroupSize = m_GroupSize; cylinder.MaxCylinders = m_MaxCylinders; + cylinder.OutOfRange = m_OutOfRange; cylinder.Radius = m_Radius; cylinder.SegmentCount = m_SegmentCount; cylinder.StartNormal = m_StartNormal; @@ -169,6 +174,11 @@ namespace XericUI.XChart.Mesh [SerializeField, Tooltip("方向向量长度倍率(立方体单位);相对模式下作用在差向量上")] private float m_DirectionScale = 0.25f; + [SerializeField, Tooltip("数据落在显示范围之外时怎么办:原样画(默认——显示范围只管定标尺," + + "不该决定数据画不画)/ 夹到范围端点 / 整条隐藏。" + + "隐藏与\"数据不可用\"分得开:报表里 hidden= 与 skipped= 是两个数")] + private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs; + [SerializeField, Range(0, 100000), Tooltip("最多画多少支(0=不限);防止十万条记录一口气铺满")] private int m_MaxArrowCount = 512; @@ -245,6 +255,7 @@ namespace XericUI.XChart.Mesh arrows.PathSegments = m_PathSegments; arrows.DirectionScale = m_DirectionScale; arrows.MaxArrowCount = m_MaxArrowCount; + arrows.OutOfRange = m_OutOfRange; arrows.Transform = m_Transform; arrows.UseColorDimensions = m_UseColorDimensions; diff --git a/Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs b/Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs index 21bc3c1..a6ae268 100644 --- a/Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs +++ b/Runtime/XChart/Pseudo3D/ChartToolScatterPoints.cs @@ -57,6 +57,22 @@ namespace XericUI.XChart.Pseudo3D /// 桶内取哪个统计量当这个点(抽稀 First/Last 不造新值;趋势 Mean/Median;包络 Minimum/Maximum) public XChartAggregateKind BucketReduce { get => m_BucketReduce; set { m_BucketReduce = value; MarkDirty(); } } + private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs; + /// + /// 数据落在显示范围之外时怎么办。这一档从"夹住"改成了"原样画"(2026-10-26,§32): + /// 以前散点把超范围的点钉在盒壁上,看着像"数据到边就停",而矢量/圆柱是按比例投出去的—— + /// 同一张表两幅画。要恢复旧观感就把这一档调成 。 + /// + public XChartValueOutOfRange OutOfRange + { + get => m_OutOfRange; + set { m_OutOfRange = value; MarkDirty(); } + } + + /// 这一帧按策略隐掉了几个点(与"数据不可用"的坏值分开,§32) + public int HiddenCount => m_Hidden; + private int m_Hidden; + // ── 外观 ────────────────────────────────────────────────── public float PointSize { get => m_PointSize; set { m_PointSize = Mathf.Max(0.5f, value); if (IsInitialized) SyncShapeParams(); } } @@ -255,6 +271,7 @@ namespace XericUI.XChart.Pseudo3D double minX, maxX, minY, maxY, minZ, maxZ; ResolveRange(DimensionX, out minX, out maxX); ResolveRange(DimensionY, out minY, out maxY); + m_Hidden = 0; ResolveRange(DimensionZ, out minZ, out maxZ); double colorMin, colorMax; ResolveRange(ColorMapDimension, out colorMin, out colorMax); @@ -274,14 +291,26 @@ namespace XericUI.XChart.Pseudo3D continue; } - m_CubePoints[written] = ChartToolSpace.NormalizedToCube(new Vector3( - Normalize(x, minX, maxX), Normalize(y, minY, maxY), Normalize(z, minZ, maxZ))); + // 坐标:折法与"超范围怎么办"走唯一那份(XChartCubeFoldMath)。 + // 全有或全无——只夹一轴会画出一个"数据里不存在"的位置,所以 Hide 时整条不画并计数。 + float fx, fy, fz; + if (!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 (!IsBad(x) && !IsBad(y) && !IsBad(z)) m_Hidden++; + continue; + } + m_CubePoints[written] = ChartToolSpace.NormalizedToCube(new Vector3(fx, fy, fz)); if (EnableColorMapping) { double color; if (!XChartBucketMath.TryReduce(source, ColorMapDimension, first, end, BucketReduce, m_BucketScratch, out color)) continue; + // 颜色映射**不吃上面的开关**:越界的颜色取端色是常态(clamp), + // "隐藏超出范围的点"是坐标的事,不该把颜色梯度也变成洞 m_ColorValues[written] = Normalize(color, colorMin, colorMax); } written++; @@ -332,6 +361,10 @@ namespace XericUI.XChart.Pseudo3D return Mathf.Clamp01((float)((value - min) / span)); } + /// 坏数据(非有限)与"按策略隐藏"要分得开:前者是数据不可用,后者是我们主动不画 + private static bool IsBad(double value) + => double.IsNaN(value) || double.IsInfinity(value); + private void ApplyColorMapping() { if (m_ColorValues == null || m_PointColors == null) return; @@ -358,7 +391,10 @@ namespace XericUI.XChart.Pseudo3D // 桶采样读数:画了几个点、源有多少条、取的是哪个统计量——"少画了多少"必须能看到 .Append(" buckets=").Append(m_BucketCount) .Append(" records=").Append(m_SourceRecords) - .Append(" reduce=").Append(BucketReduce); + .Append(" reduce=").Append(BucketReduce) + // 超范围的两类"少画"分开印:hidden=策略隐的,out=这一档选的是什么(§32) + .Append(" hidden=").Append(m_Hidden) + .Append(" out=").Append(OutOfRange.ToString().ToLower()); } #endif } diff --git a/Runtime/XChart/Space/XChartScatterConfig.cs b/Runtime/XChart/Space/XChartScatterConfig.cs index ba21f39..748001b 100644 --- a/Runtime/XChart/Space/XChartScatterConfig.cs +++ b/Runtime/XChart/Space/XChartScatterConfig.cs @@ -36,6 +36,10 @@ namespace XericUI.XChart.Space [SerializeField, Tooltip("桶内取哪个统计量当这个点:抽稀用 First/Last(不造新值),看趋势用 Mean/Median,看包络用 Minimum/Maximum")] private XChartAggregateKind m_BucketReduce = XChartAggregateKind.Last; + [SerializeField, Tooltip("点落在显示范围之外时怎么办:原样画(默认,2026-10-26 起;以前散点总是夹住," + + "与矢量/圆柱不一致)/ 夹到范围端点 / 整条隐藏。颜色映射那一档总是夹(越界取端色)")] + private XChartValueOutOfRange m_OutOfRange = XChartValueOutOfRange.RenderAsIs; + [Header("外观")] [SerializeField, Min(0.5f), Tooltip("点的大小(像素)")] private float m_PointSize = 8f; @@ -86,6 +90,7 @@ namespace XericUI.XChart.Space scatter.Transform = m_Transform; scatter.BucketTargetPoints = m_BucketTargetPoints; scatter.BucketReduce = m_BucketReduce; + scatter.OutOfRange = m_OutOfRange; scatter.PointSize = m_PointSize; scatter.PointType = m_PointType; diff --git a/Runtime/XChart/XChartCubeFoldMath.cs b/Runtime/XChart/XChartCubeFoldMath.cs new file mode 100644 index 0000000..18d4f3a --- /dev/null +++ b/Runtime/XChart/XChartCubeFoldMath.cs @@ -0,0 +1,78 @@ +using UnityEngine; + +namespace XericUI.XChart +{ + /// + /// 数据落在显示范围之外时怎么办(每个数据图元自己选,规范 §32)。 + /// + /// 显示范围的本分是"定标尺":它决定网格多大、轴刻度到哪儿。它不该顺手决定数据画不画—— + /// 但历史上两件事不一致过:散点把值夹进盒子(超范围的点贴在盒壁上,看着像"数据到边就停"), + /// 而矢量/圆柱直接把值按比例投出去(可以跑到盒子外面)。同一张表两套口径, + /// 症状就是"散点看着钳制对了、别的组件钳制没做"(他 2026-10-26)。 + /// + public enum XChartValueOutOfRange + { + /// 默认:不钳、不藏,按数据自己的值投(可以画到盒子外面)——"呈现自己准确的位置"。 + RenderAsIs = 0, + /// 夹到范围端点上(超出部分画在盒子边上)。 + ClampToRange = 1, + /// 整条记录隐藏(任何一轴越界就不画这一条)。 + HideOutOfRange = 2, + } + + /// + /// "值 → 盒子内比例"的唯一折法:三个数据图元(散点、矢量箭头、圆柱)都从这里取, + /// 于是"超范围怎么处理"只有一个答案,而不是每个元素各写一遍 Clamp/不 Clamp。 + /// + public static class XChartCubeFoldMath + { + /// + /// 单轴折法:0=该轴的下端点、1=上端点,范围外按 办。 + /// + /// 返回 false 只有两种情况:值或端点不是有限数(那是坏数据,宁可不画这条,也不要拿别的值顶替)、 + /// 或者选了 而这一轴越界。 + /// 一整列同一个数(跨度 ≤0)不算坏:答居中(0.5)——为这个把整张图弄没, + /// 是把"我还没钉范围"误报成"这里没有数据"(与 §25.1 的"需求 vs 现有"同一条精神)。 + /// + public static bool TryRatio01(double value, double minimum, double maximum, + XChartValueOutOfRange behaviour, out float ratio01) + { + ratio01 = 0.5f; + if (!IsFinite(value) || !IsFinite(minimum) || !IsFinite(maximum)) return false; + + double span = maximum - minimum; + if (span <= 0d) return true; + + double r = (value - minimum) / span; + if (r < 0d || r > 1d) + { + if (behaviour == XChartValueOutOfRange.HideOutOfRange) return false; + if (behaviour == XChartValueOutOfRange.ClampToRange) r = r < 0d ? 0d : 1d; + } + ratio01 = (float)r; + return true; + } + + /// + /// 三轴一起折到 立方体单位([-1,1],±1 就是盒子边界)。 + /// 全有或全无:任何一轴要隐藏,这一条整体不画——只藏一半坐标的点 + /// 会画出一个"在数据里不存在"的位置,那比少画一条糟得多。 + /// + public static bool TryFoldCube(double x, double y, double z, + double minX, double maxX, double minY, double maxY, double minZ, double maxZ, + XChartValueOutOfRange behaviour, out Vector3 cube) + { + cube = Vector3.zero; + float nx, ny, nz; + if (!TryRatio01(x, minX, maxX, behaviour, out nx) + || !TryRatio01(y, minY, maxY, behaviour, out ny) + || !TryRatio01(z, minZ, maxZ, behaviour, out nz)) return false; + + cube = new Vector3(nx * 2f - 1f, ny * 2f - 1f, nz * 2f - 1f); + return true; + } + + private static bool IsFinite(double value) + => !double.IsNaN(value) && !double.IsInfinity(value); + } +} diff --git a/Runtime/XChart/XChartCubeFoldMath.cs.meta b/Runtime/XChart/XChartCubeFoldMath.cs.meta new file mode 100644 index 0000000..559cb61 --- /dev/null +++ b/Runtime/XChart/XChartCubeFoldMath.cs.meta @@ -0,0 +1,11 @@ +fileFormatVersion: 2 +guid: debeb5aedeacb4b47ba8ea795208068b +MonoImporter: + externalObjects: {} + serializedVersion: 2 + defaultReferences: [] + executionOrder: 0 + icon: {instanceID: 0} + userData: + assetBundleName: + assetBundleVariant: