XChart P24:方向来源四档、头的尺寸吃投影、锚点字段(规范 §30)
他这轮给了三条,我先只回答"是不是真的",再动手。
1) "矢量被归一化到屏幕空间再算了"——是真的,而且成因在库那一行:
CurveMeshGenerator.cs:150 pos += tangent * arrow.width * 0.5f * arrow.depthCompensation
标记的**方向**跟曲线切线走(对),**尺寸是固定像素**(不是投影结果)。杆随姿态缩短、头不缩 ⇒
整支读起来就是"屏幕空间里等长的箭头"。修法:新增纯算术 ProjectedScale(投影像素, 立方体长度, CubeToPixel)
=这条矢量自己的投影比例(平行于屏幕=1、指向屏幕里→0),头的两个尺寸都乘它;连续绘制那一档取
**这一节自己**的比例,所以弯到背面去的那一节头跟着缩;除不出来(NaN、零长、零比例)就答 0——
宁可头缩成没有,也不要一个凭空的固定像素尺寸。
2) Absolute 下"方向从哪来"要可选,支数跟着变(他的算术:32 个点两两一组 ⇒ 16 支,而不是现在的 32 支)。
新增 XChartArrowDirectionSource 四档:NextRecordAsVector(旧 Absolute,N−1)/NextRecordAsPoint
(旧 Relative,N−1,点到点不用再算一次投影,所以 Tip 只在这一档作差)/ThisRecordCarriesVector
(同一条记录 0~2 是点、3~5 是方向,N 支、要 6 维)/AlternatingRecords(偶数是点、奇数是方向,N÷2 支)。
**支数与维数只有 ArrowCount(source,…) 和 RequiredCoordinateDimensions(source) 这一个实现**:
四档算法在工具里各写一遍,画面上只是"少几支",那是最难查的一类错。
3) 锚点:MarkerAnchor [0,1] → 库的 depthCompensation(anchor×2−1;0=尾部落点、0.5=中心、1=头尖落点=默认),
非有限退回 1——"头该贴在哪"不该因为一次写坏的值变成位置未知。
另外两条顺手立的规矩:
- **方向是原始矢量,绝不按位置的显示范围折**(TryReadRaw):折一次就把"朝哪"变成"在哪"
((0,1,0) 会被折成一个偏移量,整场箭头一起跑偏);尺度交给 DirectionScale。
顺带:XMeshPreviewChart 那份"一条记录 6 维、方向存 3~5"的旧示例数据在 ThisRecordCarriesVector 下
正好合法(§28.5 说的"死数据"有了读法)——默认值我没替他改。
- **颜色维撞上方向维**(自带方向那档吃 0~5 六列,颜色起点默认仍是 3):撞了就退回单色并印 colors=overlap,
不静默把方向当色相读。
- **序列化兼容**:新枚举的 0/1 就是旧 XChartArrowVectorMode 的 Absolute/Relative,字段再加
[FormerlySerializedAs("m_VectorMode")] ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改字段名静默丢值"的反面)。
判据:探针 462 项 0 失败(新增 10 条:四档各自支数、维数需求只有自带方向那档要 6、锚点 0/0.5/1→−1/0/+1、
越界夹取与非有限回退、投影比例 1/0.5/指向屏幕=0、坏输入答 0);p4_control 66 支
(新增 3 支:分档按条数算/头无视投影比例/锚点映射写死 0;**删 1 支**——"空表被挡在算术外"那支的守卫
在新算术下已经到不了,**没有靶子的臂不当证据用**);编译门三臂 + 3 对照绿(chain_p24.txt)。
**门自己这轮现了一次瞎,这是本轮最值钱的自证**:`public T X` 与 `{` 分成两行的属性写法**根本没被数到**,
所以总数是 132 而不是 133——而"132/132 VERDICT: PASS"是绿的、却已经不等于"每个旋钮都看得见"
(我这次把 DirectionSource 写成了多行形状,正好撞上)。补 match_head(认得大括号在下一行的声明),
并加 **M9_nextline** 专测这种失明:把某个旋钮改写成多行形状**并抽掉它的 MarkDirty()**,门必须红——
看不见形状的门会放行一个不置脏的旋钮。补完后 knobs=133 takesEffect=133、九支变异全红。
两次 harness 正常工作也记在这里(都是它拒绝,而不是假判):CJK 第三次进了声明 coding: ascii 的脚本
(⇒ 中文只进仓内文档);一支臂的单行锚被我新写的孪生函数撞成 2 命中 ⇒ SETUP FAILED 整轮作废
(锚点加宽成两行块)。
覆盖不到的照旧:头的绝对大小好不好看归他现场判(§30.6 五条:换 AlternatingRecords 应见 16 支、
换 ThisRecordCarriesVector 应见 32 支且 colors=overlap 时把颜色起点调到 6、转立方体时长短不一且
headScale 读数跟着变、拖 MarkerAnchor 头尾互换、以及报表 src= anchor= headScale= 三个新读数)。
P25(自己写简单填充、替掉 chunk 式填充渲染器,顺带解掉 P23)按他的指示排在下一轮。
This commit is contained in:
@@ -3,6 +3,9 @@
|
||||
本文是**实施依据**:先约定职责与流程,再按分期落地。每节末尾的"判据"是必须能机器验证或能明确观察的条目,
|
||||
不写"应该会更好"这种无法证伪的话。
|
||||
|
||||
> **要接图表,不用读本文**:面向使用者(从外部喂数据、改元素参数)的速查在
|
||||
> [`XChart-ExternalAPI.md`](XChart-ExternalAPI.md);本文管的是"为什么这样设计、每条判据靠什么红"。
|
||||
|
||||
---
|
||||
|
||||
## 0. 现状问题(P0,先修)
|
||||
@@ -1998,3 +2001,69 @@ P18 那次我读不到库那个包(被拦过一次),就照着自己代码
|
||||
3. 打开颜色维:杆沿程渐变(起点色 → 终点色),头是终点色。
|
||||
4. 若画面仍然什么都没有 ⇒ 读报表那一行的 `path= / arrows= / markers= / curveVerts=`。
|
||||
现在箭头这条路上没有"填充"那一层了,读数能给的解释比上一版窄——这正是这次改动的目的。
|
||||
|
||||
## 30. P24:方向来源四档、头的尺寸吃投影、锚点字段(2026-10-26 他三条要求)
|
||||
|
||||
### 30.1 他指出的两件事
|
||||
|
||||
1. **"矢量被归一化到屏幕空间再算了"**:圆周方向的一圈矢量,投到 2D 上不可能一样长,而他看到的一样长。
|
||||
成因在库那一行——`CurveMeshGenerator.cs:150 pos += tangent * arrow.width * 0.5f * arrow.depthCompensation`:
|
||||
标记的**方向**跟着曲线切线走(对),**尺寸是固定像素**(≠投影结果)。杆是两端点投影画的,所以会缩短;
|
||||
头不缩 ⇒ 整支读起来就是"屏幕空间里等长的箭头"。
|
||||
2. **`Absolute` 下"方向的来源"应该是可选的**,而且支数要跟着一起来:
|
||||
他说"要让一个箭头对应两组数据,32 个点上就只该有 16 个箭头,而现在有 32 个"。
|
||||
|
||||
### 30.2 四档方向来源(`XChartArrowDirectionSource`,算式全在 `XChartVectorFieldMath`)
|
||||
|
||||
| 档 | 起点 | 方向/第二量 | 支数 | 要几个数值维 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `NextRecordAsVector`(旧 Absolute) | 第 i 条 0~2 | 第 i+1 条 0~2(折进盒子后的坐标当方向) | N−1 | 3 |
|
||||
| `NextRecordAsPoint`(旧 Relative) | 第 i 条 0~2 | 第 i+1 条 0~2(**第二个点**,作差) | N−1 | 3 |
|
||||
| `ThisRecordCarriesVector` | 第 i 条 0~2 | **同一条**的 3~5(原始矢量) | N | 6 |
|
||||
| `AlternatingRecords`(分段) | **偶数**条 0~2 | **奇数**条 0~2(原始矢量) | N÷2 | 3 |
|
||||
|
||||
- **支数与维数只有这一个实现**:`ArrowCount(source,…)` / `RequiredCoordinateDimensions(source)`。
|
||||
四档的算法(`N−1 / N / N÷2`、`3 / 6`)一旦在工具里各写一遍,画面上只是"少几支",最难查。
|
||||
- **方向是原始矢量,绝不按位置的显示范围折**(`TryReadRaw`):折一次就把"朝哪"变成"在哪"——
|
||||
一个 `(0,1,0)` 会被折成一个偏移量,于是整场箭头一起跑偏。它的尺度由 `DirectionScale`(每数据单位给多少立方体单位)说话。
|
||||
- **兼容**:新枚举的 0/1 就是旧 `XChartArrowVectorMode` 的 Absolute/Relative,字段另加了
|
||||
`[FormerlySerializedAs("m_VectorMode")]` ⇒ 他场景里存过的值不用重设("换类型不换序号"是"改名静默丢值"的反面做法)。
|
||||
- 他说"相对模式是一个点到另一个点,不用再算一次投影":这条本来就成立(两端都是投影点),
|
||||
所以 `Tip` 只在 `NextRecordAsPoint` 那一档作差,其余三档第二量直接就是方向。
|
||||
|
||||
### 30.3 头的尺寸吃投影 + 锚点
|
||||
|
||||
- `ProjectedScale(投影像素, 立方体长度, CubeToPixel)`=这条矢量的**投影比例**:平行于屏幕=1、指向屏幕里→0;
|
||||
头的两个尺寸都乘它(连续绘制那一档取**这一节自己**的比例,所以弯到背面去的那一节头也跟着缩)。
|
||||
除不出来(NaN、零长、零比例)就答 **0**:宁可头缩成没有,也不要一个凭空的固定尺寸。
|
||||
- `MarkerAnchor` [0,1] → 库的 `depthCompensation`(`anchor×2−1`):**0=尾部落在点上(向前伸)、0.5=中心、1=头尖落在点上**(默认 1)。
|
||||
非有限数退回 1——"头该贴在哪"不该因为一次写坏的值变成位置未知。
|
||||
- `XMeshPreviewChart` 那份"一条记录 6 维、方向存 3~5 维"的旧示例数据,在 `ThisRecordCarriesVector` 这一档下
|
||||
**正好是合法的**(§28.5 里我说的"死数据"从此有了读法)——我没有替他把默认值改掉。
|
||||
|
||||
### 30.4 颜色维撞上方向维:当场说,不静默画错
|
||||
|
||||
`ThisRecordCarriesVector` 要吃 0~5 六列,而颜色起点默认还是 3 ⇒ 会把**方向**当色相读。
|
||||
判据:`ColorDimension < RequiredCoordinateDimensions(source)` 时退回单色,报表印 `colors=overlap`
|
||||
("颜色没生效"与"配置撞了"是分开的两件事)。
|
||||
|
||||
### 30.5 判据
|
||||
|
||||
- 探针 **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`、**九支变异全红**。
|
||||
这轮它自己也现了一次瞎:`public T X` 与 `{` 分成两行的写法**根本没被数到**(所以是 132 而不是 133),
|
||||
那时"132/132 PASS"是绿的、却不再等于"每个旋钮都看得见"。补了 `match_head`(认得大括号在下一行的声明),
|
||||
并加 **M9_nextline** 专测这种失明:把某个旋钮改写成多行形状**并抽掉它的 `MarkDirty()`**,门必须红——
|
||||
看不见形状的门会放行一个不置脏的旋钮。
|
||||
- 编译门 runtime + player + editor + 3 支对照 `GATE PASSED`(`chain_p24.txt`)。
|
||||
|
||||
### 30.6 覆盖不到什么 / 他侧验收(Ctrl+R 后)
|
||||
|
||||
1. 换成 `AlternatingRecords`:32 条记录 ⇒ **16 支**(报表 `arrows=16 src=alternatingrecords`)。
|
||||
2. 换成 `ThisRecordCarriesVector`(他那份 demo 数据的形状)⇒ 32 支;若 `colors=overlap` 就把颜色起点调到 6。
|
||||
3. 转立方体:一圈"圆周方向"的矢量投到 2D 上**长短不一**(`headScale` 读数跟着变;指向屏幕里的那支会缩到几乎看不见)。
|
||||
4. 拖 `MarkerAnchor`:0 时尾巴钉在点上、1 时头尖钉在点上(默认)。
|
||||
5. 头的绝对大小他满意与否归他判——机器只保证"它是投影算出来的,不是写死的"。
|
||||
|
||||
Reference in New Issue
Block a user