他报的现象:"散点会把点钳在范围内,矢量不钳;而且四档方向来源画出来的东西看不出意义。" 两处都对得上字面,成因不同: - 钳与不钳是**两份实现**:散点折进盒子用 Mathf.Clamp01(超范围的点钉在盒壁上,看着像"数据到边就停"), 圆柱/矢量按 TryNormalize 比例投(可以出盒外)。两边都"看着挺对"、谁也不报错。 - 四档"没意义"里有一档是我的单位错:位置除以了跨度,方向**没有**——(−93.5,10.1,49.0) 这种原始值 直接当立方体单位 ×0.25 ⇒ 长约 23 个盒子单位 ≈ 2700 像素,所以"一根比终点还大的矢量"。 (另两档的小短矢量是"把位置当方向"的必然结果,第四档 ThisRecordCarriesVector 什么都不画是**对的**: 它要 6 个数值维,那张表只有 x/y/z 三列。) 他的裁定:范围的本分是定标尺(网格多大、轴到哪儿),**不该决定数据画不画**;但有时又想看被限制住的版本 ⇒ 开关交给数据图元。落法: ① 新纯算术 XChartCubeFoldMath:TryRatio01(value,min,max,behaviour,out 0..1) 是**唯一**一份"值→盒子内比例", TryFoldCube 是三轴全有或全无版。散点那份 Clamp01、圆柱那份 XChartBindingMath.TryNormalize、 箭头那份 XChartVectorFieldMath.TryCubePoint ——**三份并成一份**(箭头的删掉)。 ② 数据图元各一个 XChartValueOutOfRange,默认 RenderAsIs(散点从此不贴边=行为变更); 另一处行为变更:一整列同一个数以前让矢量整条拒答(跨度≤0 ⇒ false),现在答**居中**—— 为"还没钉范围"把元素弄没等于把状态误报成"这里没有数据";坏数(NaN/Inf)仍拒答。 隐藏是**整条记录**,不藏一半坐标(只夹一轴会画出"数据里不存在"的位置)。 ③ 轴与格线**永远**用范围、不给开关(否则就是 §20 一路在拆的"格线按 A、刻度按 B")。 ④ 颜色映射那一档**刻意不统一**:越界取端色是常态,继续夹;"隐藏超范围"是坐标的事——注释写明, 防下次有人"顺手统一"把梯度弄出洞。 ⑤ 读数 out=asis|clamptorange|hideoutofrange、hidden=(策略隐的)与 skipped=(数据不可用的)分开印: "我主动不画"和"数据不能用"必须分得开。 搬家那一步被门抓了一次且抓得对:dirty_gate 的 claim F 当场 FAIL("箭头坐标不再经过折法")。 它判的是"必须经过**唯一那份**折法",不是"必须调用某个旧名字" ⇒ 正确处置是把门指向新来源, **删判据是错的处理**;M8(把旧形状塞回去)继续红,顺带证明"搬家会被抓到"。 判据:探针 469 项 0 失败(三档各一条 + 常数列居中 + 坏数仍拒 + §28 那批域内/域外判据挪到唯一实现上); p4_control **71** 支 CONTROL PASSED、0 次 SETUP FAILED(新 2 支:hide 不 hide、clamp 不 clamp; 搬家 3 支重挂到新文件,点名清单按实测改:8/3/2/1/1 条各自红); dirty_gate 正本 knobs=136 takesEffect=136(三个新旋钮都是自动置脏 setter)、九支全红; 编译门 runtime+player+editor+3 对照绿(chain_p27.txt)。 自己的两条错照记:新判据的期望值我手打算错了域(y 是 -20..20 我按 -100..50 算),第一次跑就被自己的探针红出来 (手打的数字必须有对着真输入的断言);中文第四次进了声明 coding: ascii 的门脚本。 **还没修的另一半,等他定**:方向的单位错(②那档没除以跨度)要加"差折法" TryDeltaRatio=value/(max-min) (不减 min:位移会把朝向变成位置),四档长度才终于与盒子同尺度;顺带旧 NextRecordAsVector 那一档去留 (他预制里存的就是序号 0,删除或改默认都会改他画面)——三个选项与我的建议(把它迁到首尾相接)已回给他。 覆盖不到的:画到盒外的点会不会被别的东西挡住、"默认钳还是默认原样"好不好看,归他现场判。
224 lines
12 KiB
C#
224 lines
12 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
|
||
{
|
||
// "数据值 → 立方体单位(以及超出显示范围怎么办)"<b>不在这里</b>:散点、矢量、圆柱都要同一套折法,
|
||
// 收在 XChartCubeFoldMath(§32)。两处各写一遍就出现过"散点把点夹在盒壁上、矢量却画到盒外"——
|
||
// 同一张表两幅画,而且两边都"看着挺对"。
|
||
|
||
/// <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);
|
||
}
|
||
}
|
||
}
|
||
} |