XChart 图表框架落地(P0–P17):格线单一作者、面板一行状态、矢量场
此前整个 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/,未入本仓库。)
This commit is contained in:
@@ -0,0 +1,70 @@
|
||||
using System;
|
||||
using UnityEngine;
|
||||
|
||||
namespace XericUI.XChart.Mesh
|
||||
{
|
||||
/// <summary>
|
||||
/// 箭头的像素空间几何:<b>杆 + 头</b>两组四边形。
|
||||
///
|
||||
/// <para>放在像素空间算是有意的:箭头的<b>宽度</b>要恒定(不管视角怎么转、向量投得多短,
|
||||
/// 头都得是个看得见的头),而长度和方向已经由 <see cref="Space.ChartToolSpace"/> 投影给出来了。
|
||||
/// 所以这里只做"沿单位方向量长度、按垂直方向量宽度"这一件事,纯数学、离线可验。</para>
|
||||
///
|
||||
/// <para><see cref="HeadLength"/> 会被钳到向量屏幕长度的 60%,因此短箭头的杆不会被头穿过去;
|
||||
/// 屏幕长度接近 0 时返回 false,由调用方决定是画个点还是什么都不画。</para>
|
||||
/// </summary>
|
||||
public static class XChartArrowGeometry
|
||||
{
|
||||
/// <summary>杆最长能占屏幕长度的比例上限之外,头也不得超过这个比例</summary>
|
||||
public const float HeadLengthRatioCap = 0.6f;
|
||||
|
||||
/// <summary>屏幕长度小于这个值就当"没有方向",交给调用方的退化分支。</summary>
|
||||
public const float MinScreenLength = 1e-3f;
|
||||
|
||||
/// <summary>杆的四角(沿箭头方向绕一圈)</summary>
|
||||
public static void BuildShaft(Vector2 from, Vector2 unit, Vector2 side, float shaftEndDistance,
|
||||
float width, out Vector2 a, out Vector2 b, out Vector2 c, out Vector2 d)
|
||||
{
|
||||
float half = width * 0.5f;
|
||||
Vector2 end = from + unit * shaftEndDistance;
|
||||
a = from + side * half;
|
||||
b = end + side * half;
|
||||
c = end - side * half;
|
||||
d = from - side * half;
|
||||
}
|
||||
|
||||
/// <summary>头的四角:两个底角 + 尖点(尖点重复一次,四边形即三角形)</summary>
|
||||
public static void BuildHead(Vector2 baseCenter, Vector2 tip, Vector2 side, float headWidth,
|
||||
out Vector2 a, out Vector2 b, out Vector2 c, out Vector2 d)
|
||||
{
|
||||
float half = headWidth * 0.5f;
|
||||
a = baseCenter + side * half;
|
||||
b = tip;
|
||||
c = tip;
|
||||
d = baseCenter - side * half;
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// 一条箭头的完整拆分。<paramref name="to"/> 是屏幕上的尖点。
|
||||
/// 返回 false 表示屏幕长度退化。
|
||||
/// </summary>
|
||||
public static bool TryBuild(Vector2 from, Vector2 to, float shaftWidth, float headLength,
|
||||
float headWidth, out Vector2 shaftA, out Vector2 shaftB, out Vector2 shaftC, out Vector2 shaftD,
|
||||
out Vector2 headA, out Vector2 headB, out Vector2 headC, out Vector2 headD)
|
||||
{
|
||||
shaftA = shaftB = shaftC = shaftD = headA = headB = headC = headD = Vector2.zero;
|
||||
|
||||
Vector2 axis = to - from;
|
||||
float length = axis.magnitude;
|
||||
if (length < MinScreenLength) return false;
|
||||
|
||||
Vector2 unit = axis / length;
|
||||
Vector2 side = new Vector2(-unit.y, unit.x);
|
||||
float head = Mathf.Min(Mathf.Max(0f, headLength), length * HeadLengthRatioCap);
|
||||
|
||||
BuildShaft(from, unit, side, length - head, shaftWidth, out shaftA, out shaftB, out shaftC, out shaftD);
|
||||
BuildHead(from + unit * (length - head), to, side, headWidth, out headA, out headB, out headC, out headD);
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user