# 饼图

> 饼图组件的参考：一个整体在各实时点位之间是怎么分的，以及编辑器里的每一项属性。

**饼图**显示一个整体是怎么分的：每个地址一块扇形，读的是此刻的值，可以画成饼图、环形图或者半环形图。和[柱状图](component-bar-chart)一样，它是一张按类别比较的图：没有时间轴、没有时间窗口、没有节拍、没有保留时长。两者的内容、点位和格式分区是共用的，只有下面这部分画法不同。

读不到的点位会被排除在这次比较之外，而不是画成零，图表在图形下面说明这一点。刚打开的画面还什么都不说。

## 内容与点位 {#content-and-points}

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 图表标题 | 画在绘图区里面的可选抬头。这是图表自己的抬头，不是组件的角上标题（那一个在共用的外观分区里）。 | 文本 | 空 |
| 点位 | 参与比较的各个类别，每块扇形一张卡片，按声明的顺序排列。**添加点位**在末尾追加一个。 | 列表 | 空 |
| · 地址 | 这块扇形所读的带根 Logic 地址。字段从实时点位清单里给建议，过滤为数值点位，指名之后显示该点位当前的读数。 | 地址 | 空 |
| · 名称 | 标注和图例怎么称呼这块扇形。 | 文本 | 留空则退回到地址 |
| · 颜色 | 这块扇形的墨色，写成 `#RRGGBB`。 | 十六进制颜色 | 留空则按调色板轮到的颜色 |
| 排序 | 各块扇形按什么顺序画。 | 按声明的顺序 · 从小到大 · 从大到小 | 按声明的顺序 |

## 格式 {#format}

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 单位 | 写在每个读数后面的可选工程单位。 | 文本 | 空 |
| 小数位 | 读数固定的小数位数。 | 0 到 15 | 留空则用工作站的偏好 |
| 读数形式 | 每个读数用什么方式写出来，标注里和数据提示里都一样。 | 数字 · 百分比 · 时长 | 数字 |
| 数值按什么计 | 格式为时长时，一个单位的值表示多少。 | 秒 · 毫秒 · 分钟 | 秒 |

## 扇形 {#slices}

| 属性 | 作用 | 取值 | 默认 |
|---|---|---|---|
| 形状 | 从哪种形体上切出这些扇形。三种回答的是同一个问题，区别在于中间那块地方派什么用场：整块圆盘给每块扇形最大的面积，圆环把中心腾出来，半个圆环则正好塞进一排卡片留下的那种又宽又矮的单元格。 | 饼图 · 环形图 · 半环形图 | 饼图 |
| 标签 | 每块扇形旁边写什么。名称永远是画出来的标注的一部分，因为一个数字飘在没有名字的楔形旁边什么也说明不了，这里选的是名称还带上什么。什么都不选，就把命名扇形的活交给图例，小单元格要的正是这样。 | 只显示名称 · 名称和读数 · 名称和占比 · 名称、读数和占比 · 无 | 名称和占比 |
| 标注位置 | 这些字摆在哪里。摆在外侧要付出环的直径和引线的代价：每个标注写在它的引线末端和单元格边缘之间，比这段空间长的标注以省略号结尾，数据提示里能看到全文。名称单独占一行，读数和占比写在下面一行，所以空间不够时被截断的是名称，不会是占比。单元格窄到在环旁边写不下标注时，去掉标注，改由图例把扇形一行一块地列出（图例选了“无”时，图例出现在绘图区下方）；名称比所在的行长时以省略号结尾，这一行的数据提示里能看到全文。列表最多占五行；单元格矮到再给环留出三分之一高度就放不下时，行数更少。扇形比行多时，列表分页显示，最后一行是箭头和页码（如 1/3）。单元格一旦够宽，标注就回来。摆在内部不占用单元格的任何地方，但需要一块宽到放得下它的扇形。只有确实要画标注时才问这一项。 | 环形外侧 · 扇形内部 | 环形外侧 |
| 图例 | 图例摆在哪里。环旁边没有标注时（标签选了“无”，或标注摆在扇形内部），只有图例给扇形标名：单元格窄到一行写不下所有名称时，图例改为把扇形一行一块地列出，这和窄单元格代替外侧标注时画的是同一个列表（见“标注位置”）。单元格一旦够宽，就回到一行。 | 绘图区上方 · 绘图区下方 · 无 | 绘图区上方 |

## 刻度区段 {#scale-bands}

**刻度**分区用共用的那个区段编辑器声明数值范围里的一段一段。在饼图上，区段就是一块调色板：它们按每块扇形的读数落在哪里给它上色，此外再无别的作用，因为同一个整体的各块扇形并没有哪一段是这幅图形*所处*的那一段，所以既不提供配说法的字段，也不提供参考值。超过最后一个上限的读数保留扇形被写定的那个墨色。

## 工具栏 {#toolbox}

| 工具 | 作用 | 是否在默认集合里 |
|---|---|---|
| 保存 PNG | 把图形下载成一个 PNG。 | 是 |
| 复制 PNG | 把图形以 PNG 放到剪贴板上。 | 是 |
| 全屏 | 让这张图铺满整个窗口。 | 是 |