lrss3 f9c758b01c XChart:补一份面向使用者的接入文档 Documentation/XChart-ExternalAPI.md
他今天连着两轮都在问"从外部怎么使一张图"(GetChartComponent<Cylinder> 那个问题、以及现在要接的标签/钳制/方向来源),
规范正文(§27-§30)写的是"为什么这样设计 + 每条判据靠什么红",不适合当速查。所以拆一份出来:

- §0 三条入口(数据 / 元素参数 / 结构与配置)+ 那条最容易中的取舍:**配置是作者数据,工具是它的投影**,
  外部写进工具的值会被下一次 Reapply/Rebuild 用配置重灌覆盖。要"这一帧对"写工具,要"活得过重建"写配置。
- §1 五分钟代码(用包内真实的构造写法:SetDimensions(new List<XChartDimensionDefinition>{ new XChartDimensionDefinition("x","X",Number) … }),
  不写想象的 helper——初稿里我自己编了两个 helper,被这条规矩逮住改掉了)。
- §2 有哪些图可挂 · §3 数据 API 表(每个方法什么时候返回 false、TrySetTime 为什么可拒、分侧钉范围、环形容量)
- §4 元素参数:133 个旋钮"设了就生效"、同类多条按登记名取、每个工具的关键属性清单
- §5 矢量场:四档方向来源一张表(支数 N−1/N−1/N/N÷2、维数 3/3/6/3)、头贴哪(MarkerAnchor)、头的尺寸吃投影、颜色维与 colors=overlap
- §6 空间与视图 · §7 结构与配置(含如实一条:**配置的公开写入口还没开**,眼下要么写工具要么走 SerializedProperty)
- §8 自查表:dims=a/b、records、dom=-、skipped、path=none、colors=overlap 各是什么 + 编辑期要有重绘帧
- §9 会咬人的九条(改配置字段名静默丢值、类型去重、空间不变量、支数是记录数的函数、65535 分块、
  LiveVertexCount 不是本实例的数、状态别存在生成件上…)
- §10 端到端:一个"掘进姿态"箭头的三种写法(自带方向 / 偶点奇向 / 只要轨迹)

规范开头加一行指路:"要接图表,不用读本文"。P27(钳制开关)与 P26(标签列)落地时要回来同步这份文档,
它现在是"当前实现"的一张快照,不是愿望清单。
2026-10-26 17:44:55 +08:00
2026-08-18 14:00:28 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2026-07-09 17:25:16 +08:00
2025-07-14 16:50:06 +08:00
2025-08-05 10:52:35 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00
2025-07-14 16:50:06 +08:00

Xeric UI Action Vessel

提供一些unity上常见UI容器用法。

容器类说明

泛型界面容器

使用ObjectVessel<T>来声名一个可以呈现在界面上的属性,其中,泛型可以用于在Unity界面上约束目标类型。

这个类不建议进行封装,封装后会失去在Inspector界面上的泛型约束功能。

翻页管理器

提供一个FlipPageComponentManager类,其继承于XericFlipPageIndexVesselBase。
实现一种基于翻页逻辑的数据虚拟化结构管理器。
父级实现了基础翻页逻辑,而子类实现在此基础上的组件交互逻辑,使用时,需要继承于FlipPageComponentManager再实现数据层功能。
比如下面是一个通过翻页管理器控制Xchart.UITable内数据翻页的基础实例:

public class MeasuringPointPageManager : FlipPageComponentManager
{
    public UITable Table; // 表格呈现

    // 页面数据对象
    public class PageMeasuringPointInfo : PageComponentInfo
    {
        // 页面数据对象里包含多个内容数据对象,并会由于数据的增加自动增加页面。
    }
    // 内容数据对象
    public class ItemMeasuringPointInfo : ItemComponentInfo
    {
        public string RiskSourceName = "数据内容";
        // 单个数据条目内容的数据在此定义。
    }

    // 当翻页时,处理翻页数据
    public override void FlipPage(int pageIndex, bool forceRefresh = false)
    {
        base.FlipPage(pageIndex, forceRefresh);

        Table.ClearData();
        var page = Currentpage as PageMeasuringPointInfo;
        foreach (var item in page.itemInfos)
        {
            AddTableRowData(page.pageNumber, item as ItemMeasuringPointInfo);
        }
    }
    // 直接添加一个空数据对象到表格中
    [HorizontalGroup("数据"), Button("添加测试项目")]
    private void AddItem()
    {
        AddItem(new ItemMeasuringPointInfo(),
            () => AddPageLast(new PageMeasuringPointInfo()));
    }
    // 定义一下如何将数据处理为表格格式
    public void AddTableRowData(int pageOffset, ItemMeasuringPointInfo info)
    {
        Table.AddRow(
            (pageOffset + Table.data.Count).ToString(),
            info.RiskSourceName);
    }

}
S
Description
Xeric界面容器
Readme MIT
16 MiB
Languages
C# 98.1%
ShaderLab 1.9%