LibHaru 开源PDF库教程

1. 项目介绍

LibHaru 是一个跨平台的开源库，用于生成PDF文件。它支持创建线条、文本、图像、大纲文本注解、链接注解等基本功能。此外，LibHaru还允许压缩文档、嵌入PNG和JPEG图片、添加Type1字体和TrueType字体以及创建加密的PDF文件。值得注意的是，此库目前不支持读取或编辑已存在的PDF文件。

2. 项目快速启动

环境准备

确保你的系统中安装了以下组件：

• C编译器（如GCC）
• Make工具

安装步骤

1. 克隆仓库到本地：

   git clone https://github.com/libharu/libharu.git
   

2. 进入项目目录：

   cd libharu
   

3. 配置并编译项目（这一步可能因操作系统不同而略有差异）：

   ./configure
   make
   

4. 安装到系统路径（需要管理员权限）：

   sudo make install
   

编写简单示例

以下是一个使用C语言的基本示例，创建一个简单的PDF文件：

#include <hpdf.h>

int main() {
    HPDF_Doc pdf = HPDF_New(NULL, NULL);
    HPDF_Page page = HPDF_AddPage(pdf);

    HPDF_Page_SetWidth(page, 210 * HPDF_MM);
    HPDF_Page_SetHeight(page, 297 * HPDF_MM);

    HPDF_Font font = HPDF_GetFont(pdf, "Helvetica", NULL);
    HPDF_Page_SetFontAndSize(page, font, 12);

    HPDF_Page_BeginText(page);
    HPDF_Page_ShowText(page, "Hello World!");
    HPDF_Page_EndText(page);

    const char* filename = "hello.pdf";
    HPDF_SaveAsToFile(pdf, filename);
    HPDF_Free(pdf);

    return 0;
}

编译此示例：

gcc example.c -lharu -o hello_pdf

运行生成PDF：

./hello_pdf

3. 应用案例和最佳实践

1. 嵌入图像: 使用HPDF_LoadPngImageFromFile()函数加载PNG图像，然后使用HPDF_Page_DrawImage()在页面上绘制。
2. 加密PDF: 在创建文档时调用HPDF_SetEncryptionMode()设置密码保护。
3. 多语言支持: 利用LibHaru支持多种编码，可以轻松创建包含非ASCII字符的PDF。

最佳实践：

• 总是在使用资源（如PDF对象）后释放它们，以避免内存泄漏。
• 根据需求选择合适的安全模式，防止未经授权的复制或编辑PDF。

4. 典型生态项目

• PHP绑定: libharu-php 提供PHP接口与LibHaru交互。
• Python绑定: pyharu 是一个Python封装库，使Python程序员能够利用LibHaru的功能。
• Ruby绑定: ruby-haru 将LibHaru的功能暴露给Ruby程序员。

通过这些生态系统中的绑定，开发者可以在各自熟悉的编程环境中轻松地利用LibHaru的功能来生成PDF文件。