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:
2026-10-26 17:44:13 +08:00
parent 5f4c1adf0a
commit d60d204ec1
5 changed files with 325 additions and 74 deletions
+31 -27
View File
@@ -1,23 +1,12 @@
using System;
using UnityEngine;
using UnityEngine.Serialization;
using XericUI.XChart.Space;
namespace XericUI.XChart.Mesh
{
/// <summary>
/// 一条记录里的两个点怎么变成一支箭头。
///
/// <para><b>绝对</b>:后三点是方向矢量本身(起点 + 方向×倍率=末端)。螺旋点这样画出来是"刺猬"。
/// <b>相对</b>:后三点是第二个点,箭头=第一点指向第二点(差向量×倍率)。
/// 连续绘制模式下两者都不适用(连起来的是一条空间路径)。</para>
/// </summary>
public enum XChartArrowVectorMode
{
/// <summary>后三维=方向矢量</summary>
Absolute = 0,
/// <summary>后三维=第二个点(箭头由第一点指向它)</summary>
Relative = 1,
}
// 方向来源的枚举在 XChartVectorFieldMath.cs 里(XChartArrowDirectionSource):
// 算箭数的四种算法也在那里,配置只存"选哪一种"——两边各写一遍就会答得不一样(§25.1 那一族)。
/// <summary>圆柱元素的配置(几何单位都是立方体局部:±1 就是盒子边界)。</summary>
[Serializable]
@@ -129,8 +118,9 @@ namespace XericUI.XChart.Mesh
/// <para><b>数据口径(2026-10-25 他澄清后定稿,规范 §25.2)</b>:</para>
/// <list type="bullet">
/// <item><b>前三维=坐标 x/y/z</b>(立方体单位,与圆柱、散点同一套归一化)——不是"两组三维"。</item>
/// <item><b>一支箭头=相邻两条记录</b>:第 i 条是起点,第 i+1 条按 <see cref="VectorMode"/> 解释成
/// "第二个点"或"方向矢量"(他原话:"我们是 0 和 1,一个代表坐标,一个代表它的矢量的方向")。</item>
/// <item><b>一支箭头=相邻两条记录</b>:第 i 条是起点,第 i+1 条按 <see cref="m_DirectionSource"/> 解释成
/// "第二个点"或"方向矢量"(他原话:"我们是 0 和 1,一个代表坐标,一个代表它的矢量的方向")。
/// 2026-10-26 又补了两档来源:本条记录自带方向(0~2 点、3~5 方向)、以及"偶数是点、奇数是方向"的分段存法。</item>
/// <item><b>第 4~7 维是颜色</b>:色相(0..256 色环)/ 饱和度 / 明度 / 不透明度,全部可选。
/// 颜色随记录自带 ⇒ 一支箭头的起点色与终点色可以不同(七维信息的那个用法)。</item>
/// </list>
@@ -152,9 +142,11 @@ namespace XericUI.XChart.Mesh
[SerializeField, Tooltip("坐标从第几个数值维开始(一条记录 3 维:x/y/z);一支箭头由**相邻两条记录**构成")]
private int m_CoordinateDimension;
[SerializeField, Tooltip("绝对:第二条记录的坐标当作方向矢量(起点→末端)。" +
"相对:它是第二个点,箭头=第一点指向第二点。**连续绘制打开时这一项不适用**")]
private XChartArrowVectorMode m_VectorMode = XChartArrowVectorMode.Absolute;
[SerializeField, Tooltip("方向从哪来(旧「相对/绝对」就是这里的前两项,存的值不用重设):" +
"相邻两条·下一条的坐标当方向 / 相邻两条·下一条是第二个点(首尾相接) / " +
"本条记录自带方向(0~2 是点、3~5 是方向) / 分段(偶数记录是点、奇数是方向)")]
[FormerlySerializedAs("m_VectorMode")]
private XChartArrowDirectionSource m_DirectionSource = XChartArrowDirectionSource.NextRecordAsVector;
[SerializeField, Tooltip("把每条记录的坐标按顺序连成一条路径(贝塞尔细分,接缝不断口)。" +
"打开之后「相对/绝对」被隐藏——连起来的是一条空间路径,谈不到这两者")]
@@ -165,6 +157,11 @@ namespace XericUI.XChart.Mesh
"只有连续绘制用得上")]
private float m_HeadPosition = 1f;
[SerializeField, Range(0f, 1f), Tooltip("头贴在矢量端点的哪一处:0=尾部落在点上(向前伸)、" +
"0.5=中心对点、1=头尖落在点上(默认)。" +
"头的长短还会按这条矢量的投影比例缩放,指向屏幕里就会缩没")]
private float m_MarkerAnchor = 1f;
[SerializeField, Range(2, 64), Tooltip("连续绘制时每段路径细分成几节(曲线渲染器的 tessellation)。" +
"越大越圆也越贵。只有连续绘制用得上")]
private int m_PathSegments = 12;
@@ -205,22 +202,28 @@ namespace XericUI.XChart.Mesh
/// <summary>
/// 这个元素要几个数值维才画得出来(面板据此报"表里只有几个",不再"什么都不显示")。
/// 坐标 3 +(可选)颜色 3;**不透明度那一维不算硬需求**(多给就多读、没给退回单色 alpha)——
/// <b>坐标那一半随方向来源变</b>:本条自带方向那档要 6 个(0~2 点、3~5 方向),其余三档 3 个;
/// 再加(可选)颜色 3。<b>不透明度那一维不算硬需求</b>(多给就多读、没给退回单色 alpha)——
/// 算进门槛的话,勾一下"有不透明度"会让整个元素因维数不够突然消失。
/// </summary>
public override int RequiredNumericDimensions
=> CoordinateDimensionCount + (m_UseColorDimensions ? ColorDimensionCount : 0);
/// <summary>一支箭头要两条记录 ⇒ 记录少于 2 条时一支都画不出来(面板/报表同样要印出来)</summary>
public override int RequiredRecordCount => 2;
=> XChartVectorFieldMath.RequiredCoordinateDimensions(m_DirectionSource)
+ (m_UseColorDimensions ? ColorDimensionCount : 0);
/// <summary>
/// 互斥显示:连续绘制打开时「相对/绝对」没有意义(他 2026-10-25:勾一个就把排斥的那几个藏起来)。
/// 一支箭头要几条记录:本条自带方向那档<b>一条就够</b>;
/// 相邻两条与"偶点奇向"那两档要两条(后者是同一支的两半,前者是重叠取)。
/// </summary>
public override int RequiredRecordCount
=> m_DirectionSource == XChartArrowDirectionSource.ThisRecordCarriesVector ? 1 : 2;
/// <summary>
/// 互斥显示:连续绘制打开时"方向从哪来"没有意义(他 2026-10-25:勾一个就把排斥的那几个藏起来)。
/// 判据只有一处,面板照着问,不在面板里写特例。
/// </summary>
public override bool IsFieldHidden(string fieldName)
{
if (fieldName == nameof(m_VectorMode)) return m_Continuous;
if (fieldName == nameof(m_DirectionSource)) return m_Continuous;
// 这两项是"路径上的箭头"才有的概念:一支一支画的时候头永远在末端
if (fieldName == nameof(m_HeadPosition) || fieldName == nameof(m_PathSegments)) return !m_Continuous;
if (fieldName == nameof(m_ColorDimension) || fieldName == nameof(m_HasAlphaDimension))
@@ -235,9 +238,10 @@ namespace XericUI.XChart.Mesh
if (!(tool is ChartToolVectorArrows arrows)) return;
arrows.CoordinateDimension = m_CoordinateDimension;
arrows.VectorMode = m_VectorMode;
arrows.DirectionSource = m_DirectionSource;
arrows.Continuous = m_Continuous;
arrows.HeadPosition = m_HeadPosition;
arrows.MarkerAnchor = m_MarkerAnchor;
arrows.PathSegments = m_PathSegments;
arrows.DirectionScale = m_DirectionScale;
arrows.MaxArrowCount = m_MaxArrowCount;