Files
XericUIActionVessel/Runtime/XChart/XChartRenderContext.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

75 lines
3.6 KiB
C#
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
using System;
using UnityEngine;
using XericUI.XChart.Mesh;
using XericUI.XChart.Space;
namespace XericUI.XChart
{
/// <summary>
/// 渲染上下文:<b>由 chart 建立并持有,工具只读</b>(规范 §2)。
///
/// <para>它替代"工具自己去 FindTool 找邻居"的写法:空间、数据、显示范围都从这里拿。
/// 于是"谁给谁投影"这件事在图这一层就定了,工具里没有第二条查找路径,
/// 也不会出现两个工具各自算一遍投影、点落不进盒子那种事。</para>
///
/// <para><b>可以返回 null</b>:<see cref="Space"/> 在初始化早期或重建过程中可能还没有,
/// 工具必须判空并跳过这一帧(不抛、也不拿旧的空间凑数)。</para>
/// </summary>
public interface IXChartRenderContext
{
/// <summary>投影权威(图的空间工具)。没有就返回 null,调用方跳过本帧。</summary>
ChartToolSpace Space { get; }
/// <summary>
/// 插槽板(规范 §11.2):<b>定义网格的工具**发布**标定顶点,其余工具按 id **读取**</b>——
/// 消费者认的是点,不是"第几个面",所以换成异形网格也不用改消费者。
/// 空板也一定非 null(没有网格时读到 false),调用方不必判 null。
/// </summary>
IXChartSlotBoard Slots { get; }
/// <summary>数据中转口。默认实现是图表自己那份直通实现。</summary>
IXChartDataSource Data { get; }
/// <summary>
/// 解析某维的显示范围。<b>手动范围不从这里传</b>——它归 chart 的维度行(数据板块,
/// 见 <see cref="XChartDimensionDefinition.DomainOverride"/>),工具只说要哪一维。
/// 规则明细见 <see cref="XChartDomainMath"/>:覆盖优先、没覆盖回落该维聚合、
/// 聚合也没有就返回 false(调用者应清空自己的绘制,而不是画在 0 上)。
/// </summary>
bool TryResolveDomain(int dimension, out double min, out double max);
}
/// <summary>
/// <see cref="IXChartRenderContext"/> 的默认实现:空间靠一个由 chart 提供的解析委托现找,
/// 数据直通图表的 <c>XChartDataModel</c>。
///
/// <para><b>为什么每次现找而不缓存空间实例</b>:重建(<c>RebuildAll</c>、增删元素)会换掉空间工具,
/// 缓存下来的引用不会报错、只会安静地画到旧空间上——那比 null 难查得多。每帧一次线性查找
/// 只在渲染前做一次,代价远小于查错对象。</para>
/// </summary>
public sealed class XChartRenderContext : IXChartRenderContext
{
private readonly IXChartDataSource m_Data;
private readonly Func<ChartToolSpace> m_SpaceResolver;
public XChartRenderContext(IXChartDataSource data, Func<ChartToolSpace> spaceResolver)
{
m_Data = data;
m_SpaceResolver = spaceResolver;
}
public ChartToolSpace Space => m_SpaceResolver != null ? m_SpaceResolver() : null;
public IXChartSlotBoard Slots { get; } = new XChartSlotBoard();
public IXChartDataSource Data => m_Data;
public bool TryResolveDomain(int dimension, out double min, out double max)
{
// 范围的算法只有一份(XChartDomainMath 的那扇门):这里就是转发,
// 覆盖来自 chart 的维度行、自由端来自该维聚合——工具不再各存一份范围
return XChartDomainMath.TryResolve(m_Data, dimension, out min, out max);
}
}
}