如何使用libharu为PDF添加半透明多边形效果？

核心方案：使用独立的填充透明度接口 #

libharu提供了单独控制填充透明度的函数，不需要依赖带Alpha通道的RGB颜色模式，步骤如下：

• 先调用HPDF_Page_SetRGBFill(page, r, g, b)设置基础RGB颜色（参数范围0-1）
• 再调用HPDF_Page_SetFillOpacity(page, alpha)设置透明度（参数范围0-1，0为完全透明，1为完全不透明）

示例代码片段：

// 设置填充色为纯红色
HPDF_Page_SetRGBFill(page, 1.0, 0.0, 0.0);
// 设置50%的透明度
HPDF_Page_SetFillOpacity(page, 0.5);
// 绘制半透明椭圆
HPDF_Page_Ellipse(page, 100, 100, 50, 30);
HPDF_Page_Fill(page);

进阶方案：使用软蒙版实现复杂透明效果 #

如果需要局部渐变透明这类复杂效果，可以借助libharu的软蒙版功能：

1. 创建软蒙版对象，获取对应的蒙版页面
2. 在蒙版页面绘制灰度图形（灰度值对应透明度：黑色完全透明，白色完全不透明）
3. 将蒙版关联到当前页面的填充设置，再绘制目标多边形

示例步骤代码：

// 创建软蒙版
HPDF_Dict* mask = HPDF_Page_CreateSoftMask(page, HPDF_SOFTMASK_SUBTRACT, 0.0, 0.0);
HPDF_Page* mask_page = HPDF_SoftMask_GetMaskPage(mask);

// 在蒙版页面绘制灰度椭圆，配合渐变实现中心透明、边缘不透明的效果
HPDF_Shading* shading = HPDF_CreateRadialShading(doc, 100, 100, 0, 100, 100, 50, 0.0, 1.0, 0.0, 0.0);
HPDF_Page_SetGrayFill(mask_page, 1.0);
HPDF_Page_ShadingFill(mask_page, shading);

// 将蒙版绑定到当前页面的填充属性
HPDF_Page_SetFillSoftMask(page, mask);
// 设置填充色并绘制椭圆
HPDF_Page_SetRGBFill(page, 0.0, 0.0, 1.0);
HPDF_Page_Ellipse(page, 100, 100, 50, 30);
HPDF_Page_Fill(page);

替代方案：颜色混合模拟半透明（仅适用于固定背景场景） #

如果不想用透明度接口，可通过计算前景色与背景色的混合值模拟半透明，公式为：最终色 = 前景色 * alpha + 背景色 * (1 - alpha)

示例计算（背景为白色，前景蓝色50%透明）：

float alpha = 0.5;
// 白色背景RGB为(1,1,1)，蓝色前景RGB为(0,0,1)
float r = 0.0 * alpha + 1.0 * (1 - alpha);
float g = 0.0 * alpha + 1.0 * (1 - alpha);
float b = 1.0 * alpha + 1.0 * (1 - alpha);
HPDF_Page_SetRGBFill(page, r, g, b);
HPDF_Page_Ellipse(page, 100, 100, 50, 30);
HPDF_Page_Fill(page);

注意：该方法仅适用于背景色固定的简单场景，无法处理多图形重叠的复杂半透明效果。

内容的提问来源于stack exchange，提问作者Duke