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

113 lines
5.1 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;
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() : "-";
}
}
}