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,113 @@
|
||||
using System;
|
||||
|
||||
namespace XericUI.XChart.Mesh
|
||||
{
|
||||
/// <summary>
|
||||
/// 立方体六面的选择掩码。用它可以精确控制"渲染哪些面"(填充与网格各自独立一份掩码)。
|
||||
///
|
||||
/// <para><b>面编号契约(固定不变)</b></para>
|
||||
/// <code>
|
||||
/// a = 前 Front (法线 +Z) d = 下 Down (法线 -Y)
|
||||
/// b = 后 Back (法线 -Z) e = 左 Left (法线 -X)
|
||||
/// c = 上 Up (法线 +Y) f = 右 Right (法线 +X)
|
||||
/// </code>
|
||||
/// 字母按<b>语义</b>绑定,与内部遍历顺序无关:<see cref="XChartCubeGeometry.CubeFace"/> 的枚举值
|
||||
/// 顺序将来即使调整,字母也不会跟着漂。
|
||||
///
|
||||
/// <para><b>注意</b>:掩码是"画哪些面"的唯一依据,<b>不看可见性</b>——图表里的背景网格
|
||||
/// 恰恰常画在背朝观察者的那几面(后墙 / 底面)。要只画朝向观察者的面请自行用
|
||||
/// <see cref="XChartCubeGeometry.IsFaceVisible"/> 过滤。</para>
|
||||
/// </summary>
|
||||
[Flags]
|
||||
public enum XChartCubeFaceMask
|
||||
{
|
||||
None = 0,
|
||||
/// <summary>a 前</summary>
|
||||
Front = 1 << 0,
|
||||
/// <summary>b 后</summary>
|
||||
Back = 1 << 1,
|
||||
/// <summary>c 上</summary>
|
||||
Up = 1 << 2,
|
||||
/// <summary>d 下</summary>
|
||||
Down = 1 << 3,
|
||||
/// <summary>e 左</summary>
|
||||
Left = 1 << 4,
|
||||
/// <summary>f 右</summary>
|
||||
Right = 1 << 5,
|
||||
|
||||
All = Front | Back | Up | Down | Left | Right,
|
||||
|
||||
/// <summary>三面(后 + 下 + 左):常见的"背景墙"一组</summary>
|
||||
BackWalls = Back | Down | Left,
|
||||
}
|
||||
|
||||
/// <summary>面掩码与面之间的换算(与 <see cref="XChartCubeFaceMask"/> 的字母契约配套)</summary>
|
||||
public static class XChartCubeFaceMaskUtility
|
||||
{
|
||||
/// <summary>面的稳定字母(a=前 b=后 c=上 d=下 e=左 f=右)</summary>
|
||||
public static char GetLetter(XChartCubeGeometry.CubeFace face)
|
||||
{
|
||||
switch (face)
|
||||
{
|
||||
case XChartCubeGeometry.CubeFace.Front: return 'a';
|
||||
case XChartCubeGeometry.CubeFace.Back: return 'b';
|
||||
case XChartCubeGeometry.CubeFace.Top: return 'c';
|
||||
case XChartCubeGeometry.CubeFace.Bottom: return 'd';
|
||||
case XChartCubeGeometry.CubeFace.Left: return 'e';
|
||||
default: return 'f';
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>字母反查面</summary>
|
||||
public static bool TryParseLetter(char letter, out XChartCubeGeometry.CubeFace face)
|
||||
{
|
||||
switch (char.ToLowerInvariant(letter))
|
||||
{
|
||||
case 'a': face = XChartCubeGeometry.CubeFace.Front; return true;
|
||||
case 'b': face = XChartCubeGeometry.CubeFace.Back; return true;
|
||||
case 'c': face = XChartCubeGeometry.CubeFace.Top; return true;
|
||||
case 'd': face = XChartCubeGeometry.CubeFace.Bottom; return true;
|
||||
case 'e': face = XChartCubeGeometry.CubeFace.Left; return true;
|
||||
case 'f': face = XChartCubeGeometry.CubeFace.Right; return true;
|
||||
default: face = XChartCubeGeometry.CubeFace.Front; return false;
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>单个面对应的掩码位</summary>
|
||||
public static XChartCubeFaceMask GetMask(XChartCubeGeometry.CubeFace face)
|
||||
{
|
||||
switch (face)
|
||||
{
|
||||
case XChartCubeGeometry.CubeFace.Front: return XChartCubeFaceMask.Front;
|
||||
case XChartCubeGeometry.CubeFace.Back: return XChartCubeFaceMask.Back;
|
||||
case XChartCubeGeometry.CubeFace.Top: return XChartCubeFaceMask.Up;
|
||||
case XChartCubeGeometry.CubeFace.Bottom: return XChartCubeFaceMask.Down;
|
||||
case XChartCubeGeometry.CubeFace.Left: return XChartCubeFaceMask.Left;
|
||||
default: return XChartCubeFaceMask.Right;
|
||||
}
|
||||
}
|
||||
|
||||
/// <summary>掩码里是否包含某个面</summary>
|
||||
public static bool HasFace(XChartCubeFaceMask mask, XChartCubeGeometry.CubeFace face)
|
||||
=> (mask & GetMask(face)) != 0;
|
||||
|
||||
/// <summary>
|
||||
/// 掩码的<b>字母写法</b>(<c>a=前 b=后 c=上 d=下 e=左 f=右</c>,按面号升序),空掩码写作 <c>-</c>。
|
||||
///
|
||||
/// <para>报表与调试行要说"这一帧工具手上到底是哪几面",直接印枚举的<b>数字</b>没用——
|
||||
/// 面板上的掩码下拉显示的是字母组合,数字对不上眼睛;而印枚举名(<c>Back | Down | Left</c>)
|
||||
/// 又会随枚举定义漂移。字母是这份契约里唯一钉住的语义(见类型注释),所以读数用它。</para>
|
||||
/// </summary>
|
||||
public static string Describe(XChartCubeFaceMask mask)
|
||||
{
|
||||
var builder = new System.Text.StringBuilder();
|
||||
for (int i = 0; i < 6; i++)
|
||||
{
|
||||
var face = (XChartCubeGeometry.CubeFace)i;
|
||||
if (!HasFace(mask, face)) continue;
|
||||
builder.Append(GetLetter(face));
|
||||
}
|
||||
return builder.Length > 0 ? builder.ToString() : "-";
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user