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,74 @@
|
||||
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);
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user