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