如何通过C++ 给PDF文档添加文字水印

因PDF文档具有较好的稳定性和兼容性，现在越来越多的合同、研究论文、报告等都采用PDF格式。为了进一步保护这些重要文档内容免受未经授权的复制或使用，我们可以添加水印以表明其状态、所有权或用途。针对工作中可能出现的在 C++ 应用程序中给 PDF 文档添加文字水印的需求，本文将详细展示如何通过第三方国产库Spire.PDF for C++来实现这一功能。

安装： Spire.PDF for C++是一款国产独立 PDF 控件，可实现 C++ 程序中创建、读取、操作、编辑和转换 PDF 文档。推荐的安装方式是在Visual Studio 中通过NuGet搜索 “spire.pdf.cpp”，然后点击下载将其安装到程序中。或者下载 Spire.PDF for C++ 到本地，解压后手动将库复制到程序中。

在 PDF 文档中添加单行文字水印

Spire.PDF for C++ 没有提供直接在PDF中插入水印的接口或类，但可以通过在PDF页面上绘制文本并设置其透明度来模拟添加文字水印的效果。主要步骤如下：

创建 PdfDocument 对象。
使用 PdfDocument->LoadFromFile() 方法加载示例 PDF 文档。
使用 PdfDocument->GetPages()->GetItem() 方法获取档中的特定页面。
使用 PdfPageBase->GetCanvas()->TraslateTransform() 方法将页面坐标系平移至指定位置。
使用 PdfPageBase->GetCanvas()->RotateTransform() 方法将坐标系旋转指定角度。（第四五步是为了确保水印以指定角度显示在页面中心位置。）
使用 PdfPageBase->GetCanvas()->DrawString() 方法在PDF页面上绘制文本水印。
使用 PdfDocument->SaveToFile() 方法保存结果文档。

C++代码：

#include "Spire.Pdf.o.h";
 
using namespace std;
using namespace Spire::Pdf;
 
int main()
{
 
    //创建PdfDocument对象
    intrusive_ptr <PdfDocument> doc = new PdfDocument();
 
    //加载PDF文件
    doc->LoadFromFile(L"协议.pdf");
 
    //创建TrueType字体
    intrusive_ptr <PdfTrueTypeFont> font = new PdfTrueTypeFont(L"黑体", 60.0f, PdfFontStyle::Bold, true);
 
    //创建笔刷
    intrusive_ptr <PdfBrush> brush = PdfBrushes::GetSkyBlue();
 
    //指定水印文本
    wstring text = L"内部文件";
 
    //测量水印文本大小
    SizeF textSize = font->MeasureString(text.c_str());
 
    //计算两个偏移量，用于计算坐标系的平移量
    float offset1 = (float)(textSize.GetWidth() * sqrt(2) / 4);
    float offset2 = (float)(textSize.GetHeight() * sqrt(2) / 4);
 
    //遍历文档中的页面
    for (size_t i = 0; i < doc->GetPages()->GetCount(); i++)
    {
        //获取指定页面
        intrusive_ptr <PdfPageBase> page = doc->GetPages()->GetItem(i);
 
        //设置透明度
        page->GetCanvas()->SetTransparency(0.8);
 
        //将页面坐标系平移至指定位置
        page->GetCanvas()->TranslateTransform(page->GetCanvas()->GetSize()->GetWidth() / 2 - offset1 - offset2, page->GetCanvas()->GetSize()->GetHeight() / 2 + offset1 - offset2);
 
        //逆时针旋转坐标系45度
        page->GetCanvas()->RotateTransform(-45);
 
        //在页面上绘制水印
        page->GetCanvas()->DrawString(text.c_str(), font, brush, 0, 0, new PdfStringFormat(PdfTextAlignment::Left));
    }
 
    //保存结果文档
    doc->SaveToFile(L"Output\\文字水印.pdf");
    doc->Close();
}

单行水印效果：

在 PDF 文档中添加多行文字水印

使用Spire.PDF for C++提供的 PdfTilingBrush 类可以实现平铺水印效果。平铺笔刷会生成一个平铺图案，用它重复填充指定图形区域即可在 PDF 文档中添加多行水印。主要步骤如下：

创建自定义方法 InsertTiledTextWatermark(intrusive_ptr <PdfPageBase> page, wstring watermarkText, intrusive_ptr <PdfTrueTypeFont> font, int rowNum, int columnNum)来为 PDF 页面添加平铺水印。(其中参数 rowNum 和 columnNum 指定平铺水印的行数和列数)。
创建 PdfDocument 对象。
使用 PdfDocument->LoadFromFile() 方法加载 PDF 示例文档。
遍历文档中的所有页面，并调用自定义方法 InsertTiledTextWatermark() 将水印添加到每一页。
使用PdfDocument->SaveToFile()方法保存结果文档。

C++代码：

#include "Spire.Pdf.o.h";
 
using namespace std;
using namespace Spire::Pdf;
 
static void InsertTiledTextWatermark(intrusive_ptr <PdfPageBase> page, wstring watermarkText, intrusive_ptr <PdfTrueTypeFont> font, int rowNum, int columnNum)
{
    //测量水印文本大小
    SizeF textSize = font->MeasureString(watermarkText.c_str());
 
    //计算两个偏移量，用于计算坐标系的平移量
    float offset1 = (float)(textSize.GetWidth() * sqrt(2) / 4);
    float offset2 = (float)(textSize.GetHeight() * sqrt(2) / 4);
 
    //获取页面高度和宽度
    float height = page->GetActualSize()->GetHeight();
    float width = page->GetActualSize()->GetWidth();
 
    //创建平铺笔刷
    intrusive_ptr <PdfTilingBrush> brush = new PdfTilingBrush(new SizeF(width / columnNum, height / rowNum));
    brush->GetGraphics()->SetTransparency(0.3f);
    brush->GetGraphics()->TranslateTransform(brush->GetSize()->GetWidth() / 2 - offset1 - offset2, brush->GetSize()->GetHeight() / 2 + offset1 - offset2);
    brush->GetGraphics()->RotateTransform(-45);
 
    //在笔刷上绘制水印文字
    brush->GetGraphics()->DrawString(watermarkText.c_str(), font, PdfBrushes::GetRed(), 0, 0, new PdfStringFormat(PdfTextAlignment::Left));
 
    //使用平铺笔刷绘制一个覆盖整个页面的矩形
    page->GetCanvas()->DrawRectangle(brush, new RectangleF(new PointF(0, 0), page->GetActualSize()));
}
 
int main()
{
 
    //创建PdfDocument对象
    intrusive_ptr <PdfDocument> doc = new PdfDocument();
 
    //加载PDF文件
    doc->LoadFromFile(L"协议.pdf");
 
    //指定水印文本
    wstring text = L"内部文件";
 
    //创建TrueType字体
    intrusive_ptr <PdfTrueTypeFont> font = new PdfTrueTypeFont(L"黑体", 30.0f, PdfFontStyle::Bold, true);
 
    //遍历文档中的页面
    for (size_t i = 0; i < doc->GetPages()->GetCount(); i++)
    {
        //调用自定义方法来插入多行文本水印
        InsertTiledTextWatermark(doc->GetPages()->GetItem(i), text.c_str(), font, 3, 3);
    }
 
    //保存结果文件
    doc->SaveToFile(L"Output\\多行水印.pdf");
    doc->Close();
}