Preview 面板

本章说明 Unity Easy Chart/Library Editor 中间区域顶部的 Preview 面板。

Preview 的作用是：把当前选中的 ChartProfile 直接渲染出来，让你在编辑配置时能即时看到结果。

Preview 会在什么时候刷新

Preview 刷新是“延迟刷新”（避免你连续拖动/输入时频繁重绘）：

• 当你在 Inspector 或 Series 面板修改任何绑定字段时，会触发一次 ScheduleUpdatePreview()。
• 当你在 JSON Injection 面板点击 ApplyToChart 后，会触发刷新。
• 当你在左侧 Library 树切换到另一个 ChartProfile 时，会刷新到新 Profile。

实现上会把刷新放到 EditorApplication.delayCall，因此你可能会感觉到“改完后稍后才更新”——这是预期行为。

Preview 显示什么

• Preview 使用一个运行时的图表组件（例如 ChartElement）进行绘制。
• Preview 会直接读取当前选中 ChartProfile 的数据并渲染。

你可以把 Preview 理解为：

• 你编辑的就是它渲染的
• 你看到的就是运行时的效果（大多数情况下）

常见问题与排错

1) 预览为空

优先排查：

• 是否选中了一个 ChartProfile
• 是否至少存在一条 Serie
• seriesData 是否为空（没有数据点）

2) 数据有但显示很怪 / 看不到

常见原因：

• 坐标系与 SeriesType 不匹配：例如 Profile 是 Polar2D，但 Series 选择了非 Radar 的类型。
• 轴范围/数据范围不匹配：例如数值全都落在轴范围之外。
• 分类轴可见数量（VisibleCount）太小：导致只显示一小段。

3) Console 报错 “Preview refresh failed”

当刷新过程中出现异常，会在 Console 输出：

• [EasyChartLibraryWindow] Preview refresh failed: ...

这通常意味着：

• 某个配置组合不合法
• 或某个字段值超出预期（例如 null / NaN）

建议处理：

• 先回退最近一次改动
• 再逐步改回去定位哪一个字段触发异常

提示

• Preview 只负责“呈现结果”，结构性问题通常需要回到 Inspector/Series/JSON Injection 去修。
• 如果你在短时间内修改了很多字段，Preview 可能在最后一次改动后才统一刷新（这是为了性能）。

Help

• 点击标题栏最右侧 Help 图标可回到本章节。