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(标签列)落地时要回来同步这份文档,
它现在是"当前实现"的一张快照,不是愿望清单。