他这轮给了三条,我先只回答"是不是真的",再动手。
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)按他的指示排在下一轮。
247 lines
14 KiB
C#
247 lines
14 KiB
C#
using UnityEngine;
|
||
using XericUI.XChart;
|
||
|
||
namespace XericUI.XChart.Mesh
|
||
{
|
||
/// <summary>
|
||
/// 一支箭头的<b>方向从哪来</b>(他 2026-10-26 补的口径:光有"相对/绝对"两个词表达不出
|
||
/// "一条记录自带方向"和"偶数点是点、奇数点是方向"这两种存法)。
|
||
///
|
||
/// <para><b>编号是有意接旧的</b>:0/1 就是原来 <c>XChartArrowVectorMode</c> 的 Absolute/Relative,
|
||
/// 所以场景里存过的 <c>m_VectorMode</c> 值不用动就还是同一个意思(枚举换类型而序号不改=静默丢值的反面)。
|
||
/// 2/3 是新增的两档"方向是矢量"的存法。</para>
|
||
/// </summary>
|
||
public enum XChartArrowDirectionSource
|
||
{
|
||
/// <summary>相邻两条、重叠:本条=起点,下一条的<b>坐标</b>就是方向矢量(旧 Absolute)。箭数=N−1</summary>
|
||
NextRecordAsVector = 0,
|
||
/// <summary>相邻两条、重叠:本条=起点,下一条=<b>第二个点</b>(旧 Relative,首尾相接)。箭数=N−1</summary>
|
||
NextRecordAsPoint = 1,
|
||
/// <summary>一条记录自带:0~2 维是点、3~5 维是方向矢量。箭数=N(要 6 个数值维)</summary>
|
||
ThisRecordCarriesVector = 2,
|
||
/// <summary>分段:偶数记录是点、奇数记录是方向(不重叠)。箭数=N/2</summary>
|
||
AlternatingRecords = 3,
|
||
}
|
||
|
||
/// <summary>
|
||
/// 曲线渲染器的箭头标记长什么样(接线时一对一映射到库的 <c>ArrowShape</c>)。
|
||
/// 只列我们真用的两档:三角形=有方向的箭头,圆形=零向量那种"就是一个点"。
|
||
/// </summary>
|
||
public enum XChartMarkerShape
|
||
{
|
||
Triangle,
|
||
Circle,
|
||
}
|
||
|
||
/// <summary>
|
||
/// 一支箭头的<b>头</b>:位置(在曲线上的参数 0..1)、尺寸(沿切线/垂直切线)、颜色。
|
||
///
|
||
/// <para>这是<b>我们自己的</b>纯算术写法,不是库的结构体——离线探针引不到库那个 assembly,
|
||
/// 所以判据打在这个结构上,工具里只做"对号入座"的映射(§29)。尺寸在 <see cref="XChartVectorFieldMath.Head"/>
|
||
/// 里夹住而不是原样传:"头长 0"进库里就是画不出来的东西,而那里的调用方是面板上的数字框。</para>
|
||
/// </summary>
|
||
public struct XChartArrowMarker
|
||
{
|
||
public XChartMarkerShape Shape;
|
||
/// <summary>在曲线上的位置(0=起点、1=末端),已夹进 [0,1]</summary>
|
||
public float Progress;
|
||
/// <summary>沿切线方向的尺寸(库里叫 width)</summary>
|
||
public float AlongTangent;
|
||
/// <summary>垂直切线方向的尺寸(库里叫 height)</summary>
|
||
public float AcrossTangent;
|
||
/// <summary>+1=头尖对准那个点;0=中心对准(圆点用这个)</summary>
|
||
public float TipAtPoint;
|
||
public Color32 Color;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 矢量场(箭头)的<b>纯算术</b>:一条记录的两组三维怎么变成一支箭头,以及一组颜色维怎么变成颜色。
|
||
/// 单独拎出来是因为这两条是"看图看不出来"的判据——
|
||
/// 他 2026-10-25 现场:"我把它添加进来了,之后它并没有显示出来",以及"相对和绝对就是这两种区别"。
|
||
/// 读数与算式放在一起,离线探针才能逐条钉住(规范 §25)。
|
||
/// </summary>
|
||
public static class XChartVectorFieldMath
|
||
{
|
||
/// <summary>
|
||
/// 一条记录的原始三值 → <b>立方体单位</b>:每一维按<b>它自己的显示范围</b>映到 [-1,1]
|
||
/// (±1 就是盒子边界),与散点、圆柱走的是同一套(<see cref="XChartBindingMath.TryNormalize"/>)。
|
||
///
|
||
/// <para><b>为什么单独有这么一个函数</b>:箭头以前把数据值<b>直接当成立方体单位</b>用了,
|
||
/// 于是一份 x∈[-100,50] 的表把所有箭头投到一万多像素之外——支数在算、面在提交、画面什么都没有
|
||
/// (他 2026-10-26:"矢量场现在没有在渲染")。散点和圆柱一直归一化、只有箭头没归,
|
||
/// 这就是"同一件事两套口径"的又一种形状:它不报错,只是看不见。</para>
|
||
///
|
||
/// <para><b>任何一维给不出有效范围(跨度 ≤0、或值/端点非有限)就整体拒答</b>——
|
||
/// 半归一化的坐标比不归一化的更难查:它会画出"看着像个箭头但方向不对"的东西。</para>
|
||
/// </summary>
|
||
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;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 三角形头。<paramref name="progress"/> 与 <paramref name="anchorOnPoint"/> 都夹进 [0,1];
|
||
/// <b>不是有限数就退回默认</b>(位置=末端、锚=头尖对点)——
|
||
/// NaN 一路传进库里会得到一个位置未知、也报不出错的东西,那正是"画面和读数对不上"的来路。
|
||
/// 两个尺寸都兜住最小值:0 长的头等于没画,而"没画"该由开关说话,不该由算术偷偷决定。
|
||
/// </summary>
|
||
public static XChartArrowMarker Head(float length, float width, float progress, float anchorOnPoint,
|
||
Color color)
|
||
{
|
||
return new XChartArrowMarker
|
||
{
|
||
Shape = XChartMarkerShape.Triangle,
|
||
Progress = IsFinite(progress) ? Mathf.Clamp01(progress) : 1f,
|
||
AlongTangent = Mathf.Max(0.1f, length),
|
||
AcrossTangent = Mathf.Max(0.1f, width),
|
||
TipAtPoint = AnchorToCompensation(anchorOnPoint),
|
||
Color = color,
|
||
};
|
||
}
|
||
|
||
/// <summary>零向量的圆点:位置在条目中间(0.5)、中心对准那个点。</summary>
|
||
public static XChartArrowMarker Dot(float diameter, float width, Color color)
|
||
{
|
||
return new XChartArrowMarker
|
||
{
|
||
Shape = XChartMarkerShape.Circle,
|
||
Progress = 0.5f,
|
||
AlongTangent = Mathf.Max(0.1f, diameter),
|
||
AcrossTangent = Mathf.Max(0.1f, width),
|
||
TipAtPoint = 0f,
|
||
Color = color,
|
||
};
|
||
}
|
||
|
||
/// <summary>
|
||
/// 末端位置。<paramref name="source"/>=<see cref="XChartArrowDirectionSource.NextRecordAsPoint"/> 时
|
||
/// <paramref name="second"/> 是<b>第二个点</b>(起点 + 差向量×倍率,首尾相接);
|
||
/// 其余三档它就是<b>方向矢量</b>本身(起点 + 方向×倍率)。
|
||
/// 相邻两条的两档在同一个数据上画出来是两幅图:一片"刺猬"对一串首尾相接。
|
||
/// </summary>
|
||
public static Vector3 Tip(XChartArrowDirectionSource source, Vector3 first, Vector3 second, float scale)
|
||
{
|
||
// 只有"下一条记录是第二个点"这一档要作差;其余档里 second 本身就是方向矢量。
|
||
// 点到点这一档的两端都是投影点,所以它的 2D 长度天然是投影结果,不需要再多算一次(他 2026-10-26)
|
||
Vector3 direction = source == XChartArrowDirectionSource.NextRecordAsPoint ? second - first : second;
|
||
return first + direction * scale;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 这一档方向来源<b>每个箭头自己要吃几个数值维</b>:自带方向那档要 6 个(0~2 点、3~5 方向),
|
||
/// 其余三档只要 3 个(方向从别的记录来)。
|
||
///
|
||
/// <para>面板拿它和表里现有的维数对印(§25.1):维数不够时元素一支都不画,
|
||
/// 报出来必须是"需要几个、现有几个"两个数,不能只说"没显示"。</para>
|
||
/// </summary>
|
||
public static int RequiredCoordinateDimensions(XChartArrowDirectionSource source)
|
||
=> source == XChartArrowDirectionSource.ThisRecordCarriesVector
|
||
? XChartArrowConfig.CoordinateDimensionCount * 2
|
||
: XChartArrowConfig.CoordinateDimensionCount;
|
||
|
||
/// <summary>
|
||
/// 给定记录数与上限,这一档来源能画几支。四种算法各不同,所以都得在这里,
|
||
/// 由调用方现问而不是在工具里各写一遍("N−1/N/N÷2"三个数写错一个,画面上只是少几支,最难查)。
|
||
/// </summary>
|
||
public static int ArrowCount(XChartArrowDirectionSource source, int recordCount, int maxArrows)
|
||
{
|
||
// 没有"记录数 ≤0 就先返回 0"那道闸:四档算法各自都把 0/1 条算成 0(0−1、0/2、<2 那一支),
|
||
// 加一道到不了的守卫只会多一个"看起来判过、其实永远不响"的地方(§29.4 那条教训)
|
||
int pairs;
|
||
switch (source)
|
||
{
|
||
case XChartArrowDirectionSource.ThisRecordCarriesVector: pairs = recordCount; break;
|
||
case XChartArrowDirectionSource.AlternatingRecords: pairs = recordCount / 2; break;
|
||
default: pairs = recordCount < 2 ? 0 : recordCount - 1; break; // 相邻两条那两档
|
||
}
|
||
if (maxArrows > 0 && maxArrows < pairs) return maxArrows;
|
||
return pairs;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 锚点 → 库的 <c>depthCompensation</c>:<b>0=尾部落在数据点上、0.5=中心、1=头尖落在点上</b>
|
||
/// (映射就是 anchor×2−1)。默认 1:矢量场的箭头指的就是那一点。
|
||
/// 非有限数按 1 处理——"头该贴在哪"这件事不该因为一次写坏的值变成位置未知。
|
||
/// </summary>
|
||
public static float AnchorToCompensation(float anchorOnPoint)
|
||
=> IsFinite(anchorOnPoint) ? Mathf.Clamp01(anchorOnPoint) * 2f - 1f : 1f;
|
||
|
||
/// <summary>
|
||
/// <b>这条矢量的投影比例</b>:投影后画了多少像素 ÷ 它在立方体单位里该有多少像素
|
||
/// (<paramref name="projectedPixels"/>=|to−from|,<paramref name="cubeLength"/>=|tip−origin|(立方体单位),
|
||
/// <paramref name="pixelsPerCubeUnit"/>=<c>space.CubeToPixel</c>)。
|
||
/// 平行于屏幕=1,指向屏幕里→0。库的标记吃的是<b>固定像素</b>(库里那行
|
||
/// <c>pos += tangent * arrow.width * 0.5f * depthCompensation</c>),所以头的尺寸必须乘上这个比例,
|
||
/// 否则所有姿态下头一样长——他 2026-10-26 看到的就是这个:"圆周方向的长度在 2D 上的投影不可能完全一样长"。
|
||
/// 除不出来(长度为 0 或不是有限数)就答 0:宁可头缩成没有,也不要一个凭空的固定尺寸。
|
||
/// </summary>
|
||
public static float ProjectedScale(float projectedPixels, float cubeLength, float pixelsPerCubeUnit)
|
||
{
|
||
if (!IsFinite(projectedPixels) || !IsFinite(cubeLength) || !IsFinite(pixelsPerCubeUnit)) return 0f;
|
||
float reference = cubeLength * pixelsPerCubeUnit;
|
||
if (reference <= 1e-6f) return 0f;
|
||
float scale = projectedPixels / reference;
|
||
return scale > 0f ? scale : 0f;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 读一组颜色维:<paramref name="hue"/> 按 <b>0..256 的色环</b>(256 与 0 是同一个颜色,
|
||
/// 取模,所以 300 也读得动),饱和度/明度/不透明度按 0..1 夹住。
|
||
///
|
||
/// <para><b>任何一个不是有限数就拒绝</b>(返回 false,调用方退回单色):
|
||
/// NaN 经取模与 HSV 换算会得到一个看着像"黑色块"的东西——那不是数据的意思,
|
||
/// 是我们在替它编一个颜色(同 §14.1 的"宁可这一帧不画")。</para>
|
||
/// </summary>
|
||
public static bool TryColor(float hue, float saturation, float value, float alpha, out Color color)
|
||
{
|
||
color = Color.white;
|
||
if (!IsFinite(hue) || !IsFinite(saturation) || !IsFinite(value) || !IsFinite(alpha)) return false;
|
||
|
||
color = HsvToRgb(Mathf.Repeat(hue / 256f, 1f), Mathf.Clamp01(saturation), Mathf.Clamp01(value));
|
||
color.a = Mathf.Clamp01(alpha);
|
||
return true;
|
||
}
|
||
|
||
private static bool IsFinite(float value)
|
||
=> !float.IsNaN(value) && !float.IsInfinity(value);
|
||
|
||
/// <summary>
|
||
/// HSV → RGB(h∈[0,1),s/v∈[0,1])。
|
||
/// <b>自己写而不是调 <c>Color.HSVToRGB</c></b>:后者是引擎侧的静态调用,
|
||
/// 离线探针(mono + CoreModule)里跑不起来,而这条换算恰恰是要离线钉住的(规范 §25)。
|
||
/// </summary>
|
||
private static Color HsvToRgb(float h, float s, float v)
|
||
{
|
||
if (s <= 0f) return new Color(v, v, v, 1f);
|
||
|
||
float sector = h * 6f;
|
||
int index = Mathf.FloorToInt(sector) % 6;
|
||
if (index < 0) index += 6;
|
||
float f = sector - Mathf.Floor(sector);
|
||
|
||
float p = v * (1f - s);
|
||
float q = v * (1f - s * f);
|
||
float t = v * (1f - s * (1f - f));
|
||
|
||
switch (index)
|
||
{
|
||
case 0: return new Color(v, t, p, 1f);
|
||
case 1: return new Color(q, v, p, 1f);
|
||
case 2: return new Color(p, v, t, 1f);
|
||
case 3: return new Color(p, q, v, 1f);
|
||
case 4: return new Color(t, p, v, 1f);
|
||
default: return new Color(v, p, q, 1f);
|
||
}
|
||
}
|
||
}
|
||
} |