API 速查
| 函数 | 说明 |
|---|---|
int xgeShapeExSceneEffectDropShadow(xge_shape_ex_scene pScene, uint32_t iColor, float fAngleDegrees, float fDistance, float fSigma, int iQuality) | 投影 |
int xgeShapeExSceneEffectFill(xge_shape_ex_scene pScene, uint32_t iColor) | 颜色填充覆盖 |
int xgeShapeExSceneEffectTint(xge_shape_ex_scene pScene, uint32_t iBlackColor, uint32_t iWhiteColor, float fIntensity) | 双色调映射 |
int xgeShapeExSceneEffectTritone(xge_shape_ex_scene pScene, uint32_t iShadowColor, uint32_t iMidtoneColor, uint32_t iHighlightColor, int iBlend) | 三色调映射 |
编译本章示例
gcc -O2 -I. -o ch71.exe ch71_main.c build\xge.lib -lm -lws2_32 -liphlpapi -lgdi32 -luser32 -lshell32 -lopengl32 -lole32 -lwinmm -lavrt
.\ch71.exe示例：卡片投影 + 色调
xge_shape_ex_scene card = NULL;
xgeShapeExSceneCreate(&card);
// ... 添加卡片内容 ...
// 投影：黑色半透明, 45°方向, 距离6px, 模糊4
xgeShapeExSceneEffectDropShadow(card,
0x00000080, // 颜色 (半透明黑)
45.0f, // 角度
6.0f, // 距离
4.0f, // 模糊 sigma
1); // 品质
// 双色调：暗部→深蓝, 亮部→暖白, 强度 0.6
xgeShapeExSceneEffectTint(card,
0x1A237EFF, 0xFFF8E1FF, 0.6f);
// 三色调：暗→蓝, 中间→灰, 亮→金
xgeShapeExSceneEffectTritone(card,
0x0D47A1FF, 0x9E9E9EFF, 0xFFD54FFF,
XGE_BLEND_ALPHA);
// 纯色填充（剪影效果）
xgeShapeExSceneEffectFill(card, 0xFF6B5EFF);完整代码
将以下代码保存为 ch71_main.c，编译后运行即可看到投影 + 色调动画效果：
#include "xge.h"
static xge_shape_ex_scene g_card = NULL;
static int g_iFrame = 0;
static int onFrame(void* pUser) {
(void)pUser;
xgeClear(0x081114FF);
g_iFrame++;
// 动画投影距离：模拟按下/弹起
float dist = 4.0f + 3.0f * (float)sin(g_iFrame * 0.05f);
xgeShapeExSceneEffectClear(g_card);
xgeShapeExSceneEffectDropShadow(g_card,
0x00000080, 45.0f, dist, 4.0f, 1);
// 色调动画：强度随时间变化
float intensity = 0.3f + 0.3f * (float)sin(g_iFrame * 0.03f);
xgeShapeExSceneEffectTint(g_card,
0x1A237EFF, 0xFFF8E1FF, intensity);
xgeShapeExSceneDraw(g_card, 0.25f);
return XGE_OK;
}
int main(void) {
xge_desc_t d = {0};
d.iWidth = 800;
d.iHeight = 600;
d.sTitle = "ch71 - DropShadow/Tint";
d.iFlags = XGE_INIT_VSYNC;
xgeInit(&d);
// 构建卡片组
xgeShapeExSceneCreate(&g_card);
xge_shape_ex bg = NULL;
xgeShapeExCreate(&bg);
xgeShapeExAppendRect(bg, 250,180, 300,240, 12,12, 1)
xgeShapeExFillColor(bg, 0xE0E0E0FF);
xgeShapeExSceneAdd(g_card, bg);
xgeShapeExDestroy(bg);
xge_shape_ex icon = NULL;
xgeShapeExCreate(&icon);
xgeShapeExAppendCircle(icon, 400, 270, 40, 1);
xgeShapeExFillColor(icon, 0x4FD8C2FF);
xgeShapeExSceneAdd(g_card, icon);
xgeShapeExDestroy(icon);
xgeRun(onFrame, NULL);
xgeShapeExSceneEffectClear(g_card);
xgeShapeExSceneDestroy(g_card);
xgeUnit();
return 0;
}代码讲解
- 动画投影：用 sin 函数让投影距离在 1~7 之间波动，模拟卡片“呼吸”效果。
- EffectClear + 重设：每帧先清除再重新设置特效，因为特效参数不支持增量修改。
- Tint 双色调：暗部映射到深蓝、亮部映射到暖白，intensity 控制混合强度。
- 特效叠加顺序：先 DropShadow 再 Tint，投影不受色调影响。
要点与陷阱
- 特效叠加：多个特效按添加顺序依次应用（先投影再色调）。
- DropShadow 角度：使用角度制（度数），非弧度。
- Tint intensity：0=无效果，1=完全替换为双色调。
- EffectFill：保留 α 通道，仅替换 RGB（剪影/图标着色）。
- EffectClear：一次清除所有特效。
进阶练习
- 实现按钮按下时投影缩小（distance 从 6→2）模拟按压。
- 用 Tritone 实现"夜间模式"色调切换。
