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

90 lines
4.3 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.Pseudo3D
{
/// <summary>
/// 立方体<b>线框</b>元素的配置(面板上叫 <c>BG Cube Wire</c>)。
///
/// <para><b>它只管 12 条棱</b>:前向一套色、后向一套色,后向棱可整体关掉。
/// 面内格线不在这里——那是 <see cref="XChartMeshBgConfig"/>(<c>BG Cube Grid</c>)的活。
/// 上一版两边都能画格线、还都往 <c>mesh.face.*.grid.S/.T</c> 同一批插槽上发布,
/// 于是"关掉一边另一边又亮回来"+"改完别的再刷新一下这边的状态又反了"
/// (他 2026-10-25 现场报的两条症状,同一个结构问题的两个面,规范 §22)。</para>
///
/// <para>姿态/半边长/中心偏移仍归 <see cref="XChartSpaceConfig"/>:投影是
/// <c>基变换 ∘ 工具变换</c>,这里只出自己的工具变换。</para>
///
/// <para><b>为什么单独立一个元素配置</b>:这些旋钮原先是 <c>XPseudo3DScatterChart</c> 的
/// 图级字段(面板「基础 → 立方体外观」)。渲染参数挂在图上,就有两个后果——
/// 面板里它不在「工具」下("既然是工具就要放在工具下面"),以及换一张图/加第二个背景时
/// 那份旋钮并不能复用。搬进元素表后,参数随元素走、脚本注册与配置注册同一条路(规范 §22)。</para>
/// </summary>
[Serializable]
[XChartElement("cube-wire", "BG Cube Wire", 9)]
public sealed class XChartCubeWireConfig : XChartElementConfig
{
[Header("工具变换")]
[SerializeField, Tooltip("线框自己的缩放/旋转/平移。默认恒等——线框就占满图的空间")]
private XChartToolTransform m_Transform = XChartToolTransform.Identity;
[Header("棱线")]
[SerializeField, Tooltip("前向棱颜色(至少有一端面朝向观察者)")]
private Color m_FrontEdgeColor = new Color(0.7f, 0.7f, 0.7f, 1f);
[SerializeField, Tooltip("后向棱颜色(两面都背朝观察者的棱);透明度低一点就是\"透过去看到的淡线\"")]
private Color m_BackEdgeColor = new Color(0.4f, 0.4f, 0.4f, 0.4f);
[SerializeField, Min(0.1f), Tooltip("棱线宽度(像素)")]
private float m_EdgeThickness = 2f;
[SerializeField, Tooltip("显示后向棱:关掉就只剩看得见的那一面外壳")]
private bool m_ShowBackEdges = true;
/// <summary>元素在 ToolsRoot 下的名字</summary>
public override string ElementName => "BG Cube Wire";
// 脚本入口:写的就是下面这些序列化字段(配置是权威,工具在 ApplyTo 里读它),
// 所以不存在"脚本改了一份、面板显示另一份"
/// <summary>前向棱颜色</summary>
public Color FrontEdgeColor { get => m_FrontEdgeColor; set => m_FrontEdgeColor = value; }
/// <summary>后向棱颜色</summary>
public Color BackEdgeColor { get => m_BackEdgeColor; set => m_BackEdgeColor = value; }
/// <summary>棱线宽度</summary>
public float EdgeThickness { get => m_EdgeThickness; set => m_EdgeThickness = Mathf.Max(0.1f, value); }
/// <summary>是否显示后向棱</summary>
public bool ShowBackEdges { get => m_ShowBackEdges; set => m_ShowBackEdges = value; }
public override XChartToolBase CreateTool() => new ChartToolCubeBg();
public override void ApplyTo(XChartToolBase tool)
{
if (!(tool is ChartToolCubeBg wire)) return;
wire.Transform = m_Transform;
wire.FrontEdgeColor = m_FrontEdgeColor;
wire.BackEdgeColor = m_BackEdgeColor;
wire.EdgeThickness = m_EdgeThickness;
wire.ShowBackEdges = m_ShowBackEdges;
wire.MarkDirty();
}
public override void CaptureFrom(XChartToolBase tool)
{
if (!(tool is ChartToolCubeBg wire)) return;
m_Transform = wire.Transform;
m_FrontEdgeColor = wire.FrontEdgeColor;
m_BackEdgeColor = wire.BackEdgeColor;
m_EdgeThickness = wire.EdgeThickness;
m_ShowBackEdges = wire.ShowBackEdges;
}
}
}