doc/docs/zh/manuals/gui-pie.md

---

title: Defold GUI饼状图节点

brief: 本手册解释了如何在Defold GUI场景中使用饼状图节点。

GUI饼状图节点

饼状图节点用于创建圆形或椭圆形对象，范围从普通圆形到饼形和方形甜甜圈形状。

创建饼状图节点

在*Outline*中的*Nodes*部分右键点击并选择Add ▸ Pie。新的饼状图节点被选中，您可以修改其属性。

以下属性是饼状图节点特有的：

Inner Radius : 节点的内半径，沿X轴表示。

Outer Bounds : 节点外边界的形状。

• Ellipse 将节点扩展到外半径。
• Rectangle 将节点扩展到节点的边界框。

Perimeter Vertices : 用于构建形状的分段数，表示为完全环绕节点360度周长所需的顶点数。

Pie Fill Angle : 饼状图应填充多少。表示为从右侧开始的逆时针角度。

如果在节点上设置了纹理，纹理图像将平展地应用，纹理的角与节点边界框的角相对应。

运行时修改饼状图节点

饼状图节点响应任何通用的节点操作函数，用于设置大小、轴心、颜色等。还存在一些仅适用于饼状图节点的函数和属性：

local pienode = gui.get_node("my_pie_node")

-- 获取外边界
local fill_angle = gui.get_fill_angle(pienode)

-- 增加周长顶点
local vertices = gui.get_perimeter_vertices(pienode)
gui.set_perimeter_vertices(pienode, vertices + 1)

-- 更改外边界
gui.set_outer_bounds(pienode, gui.PIEBOUNDS_RECTANGLE)

-- 动画内半径
gui.animate(pienode, "inner_radius", 100, gui.EASING_INOUTSINE, 2, 0, nil, gui.PLAYBACK_LOOP_PINGPONG)