使用JagPDF库加载PDF格式图片时抛出异常的技术求助

算力阿峰

2026-7-7

解决JagPDF加载PDF格式文件时抛出异常的问题

问题背景

使用JagPDF库通过C++生成计算结果PDF报告，库文档说明支持PNG、JPG及原生PDF格式的内容嵌入。加载JPG格式文件时程序正常运行，但尝试加载PDF格式文件时抛出异常。

问题原因

你误用了加载光栅图像的API来处理PDF文档：image_load_file()仅适用于PNG、JPG这类光栅图像，而PDF属于矢量文档，JagPDF对其有专门的导入处理逻辑，不能当作普通图片加载。

解决方案

要嵌入PDF文档，需要使用JagPDF的页面导入功能，步骤如下：

使用import_pages()方法导入目标PDF文件的页面
通过导入的页面对象，使用canvas().page()将其绘制到当前页面中

修正后的代码

#include <jagpdf/api.h>

using namespace jag;

int main()
{
    int pagewidth = 766;
    int pageheight = 589;
    pdf::Document doc(pdf::create_file("report.pdf"));
    doc.page_start(pagewidth, pageheight);

    // 导入目标PDF的页面，参数为PDF文件路径
    pdf::PageImport imp = doc.import_pages("example1.pdf");
    // 获取导入的第一页（索引从0开始）
    pdf::Page imported_page = imp.page(0);

    int posx = 0;
    int posy = 0;
    // 将导入的PDF页面绘制到当前页面指定位置
    doc.page().canvas().page(imported_page, posx, posy);

    doc.page_end();
    doc.finalize();
    return 0;
}