概念：Pie vs Chord
- 扇形（Pie）：由圆心 + 弧线围成的"披萨切片"形状。
- 弓形（Chord）：由弧线 + 连接两端点的弦围成的"弓"形状（不含圆心）。
API 速查
| 函数 | 说明 |
|---|---|
void xgeShapePieFill(float fX, float fY, float fRadiusX, float fRadiusY, float fStartRadians, float fEndRadians, uint32_t iColor) | 填充扇形 |
void xgeShapePieFillPx(...) | 填充扇形（像素坐标） |
void xgeShapeChordFill(float fX, float fY, float fRadiusX, float fRadiusY, float fStartRadians, float fEndRadians, uint32_t iColor) | 填充弓形 |
void xgeShapeChordFillPx(...) | 填充弓形（像素坐标） |
编译本章示例
gcc -O2 -I. -o ch27.exe ch27_main.c build\xge.lib -lm -lws2_32 -liphlpapi -lgdi32 -luser32 -lshell32 -lopengl32 -lole32 -lwinmm -lavrt
.\ch27.exe示例 1：饼图
float data[] = { 0.35f, 0.25f, 0.20f, 0.20f };
uint32_t colors[] = { 0x4FD8C2FF, 0xFFB454FF, 0xFF6B5EFF, 0x6DB3F2FF };
float start = -3.14159265f / 2.0f; // 从顶部开始
for (int i = 0; i < 4; i++) {
float end = start + data[i] * 2.0f * 3.14159265f;
xgeShapePieFill(400, 300, 150, 150, start, end, colors[i]);
start = end;
}示例 2：技能冷却（扇形遮罩）
float fCooldown = 0.7f; // 70% 冷却中
float fAngle = fCooldown * 2.0f * 3.14159265f;
// 技能图标底色
xgeShapeCircleFill(100, 500, 30, 0x4FD8C2FF);
// 冷却遮罩（半透明黑扇形）
xgeShapePieFill(100, 500, 30, 30,
-3.14159265f/2, -3.14159265f/2 + fAngle, 0x000000A0);示例 3：弓形装饰
// 弓形（不含圆心的弧段区域）
xgeShapeChordFill(400, 300, 120, 120,
0, 3.14159265f, // 下半圆弓形
0xFFB45480);完整代码
将以下代码保存为 ch27_main.c，编译后运行即可看到扇形与弓形绘制效果：
#include "xge.h"
static int onFrame(void* pUser) {
(void)pUser;
xgeClear(0x081114FF);
// 扇形（饼图切片）
xgeShapePieFill(250, 250, 120, 0.0f, 120.0f, 0x4FD8C2FF);
xgeShapePieFill(250, 250, 120, 120.0f, 120.0f, 0xFFB454FF);
xgeShapePieFill(250, 250, 120, 240.0f, 120.0f, 0xFF6B5EFF);
// 弓形（圆弧 + 弦围成的区域）
xgeShapeChordFill(550, 350, 100, 30.0f, 150.0f, 0x6DB3F2FF);
return XGE_OK;
}
int main(void) {
xge_desc_t d = {0};
d.iWidth = 800;
d.iHeight = 600;
d.sTitle = "ch27 - Sector & Chord";
d.iFlags = XGE_INIT_VSYNC;
xgeInit(&d);
xgeRun(onFrame, NULL);
xgeUnit();
return 0;
}代码讲解
xgeShapePieFill(cx, cy, r, startAngle, sweepAngle, color)绘制扇形（饼图切片）。xgeShapeChordFill(cx, cy, r, startAngle, sweepAngle, color)绘制弓形（圆弧+弦围成）。- 扇形与弓形的区别：扇形包含圆心，弓形不包含。
- 三个 120° 扇形组合成完整饼图。
要点与陷阱
- 支持椭圆：fRadiusX ≠ fRadiusY 时绘制椭圆扇形/弓形。
- 只有填充：Pie/Chord 没有 Stroke 版本。需要描边用 ShapeEx（第 33 章起）。
- 角度方向：与 Arc 一致，0 = 右方，顺时针增长。
- 完整圆：End - Start = 2π 时，Pie 绘制完整圆，Chord 也绘制完整圆。
进阶练习
- 实现一个动态饼图：数据随时间变化，扇形平滑过渡。
- 用扇形实现雷达扫描效果：旋转的半透明扇形 + 余辉。
- 对比 Pie 和 Chord 在 270° 弧时的形状差异，截图说明。
