Files
XericUIActionVessel/Runtime/XChart/Mesh/XChartArrowGeometry.cs
T
lrss3 c51ab7a3c8 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/,未入本仓库。)
2026-10-25 20:21:28 +08:00

71 lines
3.3 KiB
C#

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;
}
}
}