此前整个 XChart 特性一直没有提交(分期 P0–P12 的代码与素材都还在工作区里)。这一批一并入库, 并含本轮 P13–P17 的改动(规范 Documentation/XChart-RenderFramework.md 新增 §22–§25): - P13:格线只剩一个作者——线框工具不再有"画格线 / 发布格线插槽"的代码路径;BG Cube Grid(原 MeshBg) 是唯一作者,且"画上去的线=发布给轴线的那份比例数组";插槽板新增 Unpublish(说得出"这里不再有线", 否则掩码筛掉的面会把上一轮的值留着被消费者吸走);渲染参数搬进元素表 (DeclareDefaultElements / AddDefaultElement + XChartElementTable 按类型去重,只在第一次读到表时补); 图上「立方体外观」那组字段删除、公共属性转发到元素表;面板逐行点名脚本注册的工具。 - P14 / P15:数据窗口文案收敛(行末 `-`、标题 `X [0]`、长说明退回 tooltip、范围页三行不再被压扁); 元素块收成一行状态 `▼ 名称 √ R… D… [↑][↓][-]`;**注册序由类型定死、只显示不给输入控件, 绘制序与元素在表里的位置绑定**(§24.5,他 2026-10-25 澄清);默认元素让删也让关; EnsureSpace 改成每次重建后都跑(删掉"空间"不再等于整张图空掉)。 - P17:矢量场——维数不够时不再静默不画(元素配置报需求,面板与报表同时印"需求/现有"); 相对/绝对两种读法收进纯算术 XChartVectorFieldMath;连续绘制(互斥显示把"相对/绝对"藏起来); 颜色维(色相走 0..256 色环,饱和/明度/不透明 0..1,不透明度不算硬需求);新增螺旋矢量场测试数据。 数据口径按他澄清修正为:前三维=坐标、一支箭头=相邻两条记录、第 4~7 维是颜色(§25、CHANGELOG 修正行)。 判据:编译门三臂 + 3 支对照绿;离线探针 436 项 0 失败;p4_control 55 支臂各红在自己点名的断言上; p2_control / pool_family / generator_gate / hierarchy_gate 在同一棵交付树上复跑。 (证据脚本与日志在包外的 .ximage-gate/,未入本仓库。)
79 lines
3.7 KiB
C#
79 lines
3.7 KiB
C#
using System.Collections.Generic;
|
||
using UnityEngine;
|
||
using XericUI.XChart.Axis;
|
||
|
||
namespace XericUI.XChart.Mesh
|
||
{
|
||
/// <summary>
|
||
/// 网格线的位置从哪儿来(P9):<b>网格是定义方</b>——按绑定的那一维的数据范围与目标条数
|
||
/// 算出一组"好看"的刻度值,再折成面参数比例发布出去;轴线以后按这些发布的线吸附,
|
||
/// 不再两边各算一遍(他 2026-10-23 的原话:"立方体网格上的分割线也都统一通过 chart 上的
|
||
/// 数据范围控制")。
|
||
///
|
||
/// <para><b>不绑数据(维度 < 0)时退回等分</b>:比例 = <c>i/(count-1)</c>,与旧行为逐位相同——
|
||
/// 所以"没配维度"这件事不会改变任何画面。</para>
|
||
///
|
||
/// <para>刻度值那一套(nice step + 升序铺 + 指数/对数换算)直接复用
|
||
/// <see cref="XChartAxisMath"/>:**网格与刻度同源**,"逐条坐标相等"才有基础。</para>
|
||
/// </summary>
|
||
public static class XChartGridLines
|
||
{
|
||
/// <summary>等分(不绑数据):<paramref name="count"/> 条线,含两条边,比例 i/(count-1)。</summary>
|
||
public static int BuildUniformRatios(int count, float[] ratios)
|
||
{
|
||
if (ratios == null || count <= 0) return 0;
|
||
count = Mathf.Min(count, ratios.Length);
|
||
for (int i = 0; i < count; i++)
|
||
ratios[i] = count > 1 ? (float)i / (count - 1) : 0f;
|
||
return count;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 按数据范围算线位置:用 <see cref="XChartAxisMath.BuildTicks"/> 求出刻度值,
|
||
/// 每个值经 <see cref="XChartAxisMath.ToParameter"/> 折成面参数比例并<b>夹到 [0,1]</b>
|
||
/// (范围外的刻度值不该画到面外去)。
|
||
/// </summary>
|
||
public static int BuildRatios(double min, double max, XChartAxisScale scale, double strength,
|
||
int targetCount, double manualStep, bool autoStep, float[] ratios, List<double> scratch)
|
||
{
|
||
if (ratios == null || scratch == null) return 0;
|
||
|
||
XChartAxisMath.BuildTicks(min, max, scale, manualStep, targetCount, autoStep, scratch);
|
||
|
||
int count = 0;
|
||
for (int i = 0; i < scratch.Count && count < ratios.Length; i++)
|
||
{
|
||
double ratio = XChartAxisMath.ToParameter(scratch[i], min, max, scale, strength);
|
||
if (double.IsNaN(ratio) || double.IsInfinity(ratio)) continue;
|
||
ratios[count++] = Mathf.Clamp01((float)ratio);
|
||
}
|
||
return count;
|
||
}
|
||
/// <summary>
|
||
/// 把 <paramref name="ratio"/> 吸附到<b>最近的一条格线比例</b>上(P9 的"轴线跟随"那一步)。
|
||
/// 最近那条的距离超过 <paramref name="maxDistance"/> 就<b>不吸</b>——宁可不对齐,也不要把刻度
|
||
/// 扭到老远的地方(那会让人以为数据变了)。吸不上时 <paramref name="snapped"/> 原样回填,返回 false。
|
||
/// </summary>
|
||
public static bool TrySnapToGrid(float[] ratios, int count, float ratio, float maxDistance, out float snapped)
|
||
{
|
||
snapped = ratio;
|
||
if (ratios == null || count <= 0) return false;
|
||
|
||
int best = -1;
|
||
float bestDistance = float.MaxValue;
|
||
for (int i = 0; i < count; i++)
|
||
{
|
||
float distance = Mathf.Abs(ratios[i] - ratio);
|
||
if (distance < bestDistance)
|
||
{
|
||
bestDistance = distance;
|
||
best = i;
|
||
}
|
||
}
|
||
|
||
if (best < 0 || bestDistance > maxDistance) return false;
|
||
snapped = ratios[best];
|
||
return true;
|
||
}
|
||
}
|
||
} |