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,38 @@
|
||||
namespace XericUI.XChart.Pools
|
||||
{
|
||||
/// <summary>
|
||||
/// 槽位工厂。<b>池的调度器只认这一个接口</b>,所以调度算法是纯托管的,能在离线探针里
|
||||
/// 用假工厂跑(规范 <c>Documentation/XChart-RenderFramework.md</c> §5.3)。
|
||||
///
|
||||
/// <para><c>host</c> 对调度器是透明引用,只有实现认识它(运行时里是标签宿主 RectTransform)。
|
||||
/// 把 host 交给 <see cref="Assign"/> 与 <see cref="IsUsable"/>,是为了让"挂在哪"成为有效性判据
|
||||
/// 的一部分:父节点不对就是被人挪走了(或者宿主节点随域重载没了),必须丢弃重补,
|
||||
/// 而不是继续画在一个来历不明的位置。</para>
|
||||
/// </summary>
|
||||
public interface IXChartSlotFactory<TSlot>
|
||||
{
|
||||
/// <summary>
|
||||
/// 取一个可用槽位:工厂自己的空闲表里有就复用,没有就新建(新建件的 hideFlags 由实现负责)。
|
||||
/// 给不出来就返回 null——调度器会保持该 owner 为脏,下一帧再试,不会静默少画。
|
||||
/// </summary>
|
||||
TSlot Acquire();
|
||||
|
||||
/// <summary>
|
||||
/// 真正归还:停用并放回工厂的空闲表。
|
||||
/// <b>只在顺位复用之后还有剩余时调用</b>——抽出来的槽位默认先在本帧回收队列里等别人认领。
|
||||
/// </summary>
|
||||
void Release(TSlot slot);
|
||||
|
||||
/// <summary>发落给某个 owner:挂到 host 下并置为激活</summary>
|
||||
void Assign(TSlot slot, object host);
|
||||
|
||||
/// <summary>§5.3 的合取判据:任一条件不满足就返回 false(调度器随即丢弃它并补新的)</summary>
|
||||
bool IsUsable(TSlot slot, object host);
|
||||
|
||||
/// <summary>
|
||||
/// 硬销毁池的一切(<c>chart.RebuildAll()</c> 与调试菜单走这一条)。
|
||||
/// 调度器只管列表,只有实现知道"件"是什么、池根挂在哪——所以销毁也归它。
|
||||
/// </summary>
|
||||
void DestroyAll();
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user