如何使用libharu API避免生成PDF时完全占用内存？

libharu默认会把整个PDF内容缓存到内存，但通过它的API可以实现流式输出，避免内存随图片数量持续增长，具体方法如下：

启用流式写入模式 #

调用HPDF_SetStreamMode开启流式模式，让libharu不再将整个PDF保存在内存中，而是生成一部分内容就写入输出目标：

HPDF_Doc pdf = HPDF_New(error_handler, NULL);
// 启用流式模式，HPDF_TRUE表示开启
HPDF_SetStreamMode(pdf, HPDF_TRUE);

自定义输出流（按需使用） #

如果不是直接写入本地文件，而是需要写入自定义流（比如网络连接、内存缓冲区），可以通过HPDF_SetOutputStream注册自己的写入回调，让libharu实时将生成的内容输出：

// 自定义写入函数
HPDF_BOOL custom_write(HPDF_BYTE *data, HPDF_UINT size, HPDF_VOID *user_data) {
    // 这里实现你的写入逻辑，比如写入到网络流或自定义缓冲区
    YourStream *stream = (YourStream*)user_data;
    return write_to_stream(stream, data, size) == size ? HPDF_TRUE : HPDF_FALSE;
}

// 注册输出流
HPDF_StreamWriter writer = {
    .write = custom_write,
    .user_data = your_stream_instance
};
HPDF_SetOutputStream(pdf, &writer);

及时刷新输出释放内存 #

在添加完页面或图片后，调用HPDF_Flush强制libharu把已生成的内容写入输出流，并释放对应的内存：

// 添加图片到页面后，刷新输出
HPDF_Flush(pdf);

注意事项 #

• 流式模式下，无法修改已经写入流的内容（比如修改之前的页面、给已处理页面添加书签），所以需要提前规划好PDF的结构，一次性完成所有内容的添加
• 确保错误处理函数能正确处理流式写入中的异常，避免中途出错导致PDF文件损坏

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