Rust PDF处理库pdf的使用指南

概述

pdf是一个纯Rust实现的PDF处理库，提供了高效解析、生成和操作PDF文档的功能。它支持读取现有PDF文件、创建新PDF文件以及修改PDF内容。

主要功能

• 解析现有PDF文档
• 创建新的PDF文档
• 修改PDF内容
• 提取文本和图像
• 添加注释和水印
• 合并/拆分PDF文档

安装方法

在Cargo.toml中添加依赖：

[dependencies]
pdf = "0.8.0"

基本使用方法

1. 读取PDF文档

use pdf::file::File;

fn main() -> Result<(), pdf::error::PdfError> {
    // 打开PDF文件
    let file = File::open("example.pdf")?;
    
    // 获取文档版本
    println!("PDF版本: {:?}", file.version());
    
    // 遍历所有页面
    for page in file.pages() {
        let page = page?;
        println!("页面尺寸: {:?}", page.media_box());
    }
    
    Ok(())
}

2. 创建新PDF文档

use pdf::{PdfWriter, Page, Rect, Mm};
use pdf::font::Font;
use pdf::encoder::Text;

fn main() -> Result<(), pdf::error::PdfError> {
    // 创建新的PDF写入器
    let mut writer = PdfWriter::new();
    
    // 添加一个页面
    let mut page = Page::new(Rect::new(Mm(0.0), Mm(0.0), Mm(210.0), Mm(297.0)));
    
    // 获取默认字体
    let font = Font::helvetica();
    
    // 添加文本到页面
    page.add_text(
        Text::new("Hello, PDF World!", font)
            .at(Mm(50.0), Mm(150.0))
            .size(24.0),
    );
    
    // 将页面添加到文档
    writer.add_page(page);
    
    // 保存到文件
    writer.write_to_file("output.pdf")?;
    
    Ok(())
}

3. 提取PDF文本内容

use pdf::file::File;
use pdf::object::*;

fn main() -> Result<(), pdf::error::PdfError> {
    let file = File::open("example.pdf")?;
    
    for (i, page) in file.pages().enumerate() {
        let page = page?;
        println!("--- 第 {} 页 ---", i + 1);
        
        if let Some(content) = page.content() {
            for operation in content.operations.iter() {
                if let Ok(op) = operation {
                    if let Operation::ShowText(text) = op {
                        println!("{}", text);
                    }
                }
            }
        }
    }
    
    Ok(())
}

4. 合并PDF文档

use pdf::{PdfWriter, Page};
use pdf::file::File;

fn merge_pdfs(filenames: &[&str], output: &str) -> Result<(), pdf::error::PdfError> {
    let mut writer = PdfWriter::new();
    
    for filename in filenames {
        let file = File::open(filename)?;
        
        for page in file.pages() {
            let page = page?;
            let mut new_page = Page::new(page.media_box().unwrap());
            // 这里需要更复杂的逻辑来复制页面内容
            // 实际应用中可能需要使用更高级的合并方法
            writer.add_page(new_page);
        }
    }
    
    writer.write_to_file(output)?;
    Ok(())
}

fn main() -> Result<(), pdf::error::PdfError> {
    merge_pdfs(&["doc1.pdf", "doc2.pdf"], "merged.pdf")
}

高级功能

添加水印

use pdf::{PdfWriter, Page, Rect, Mm};
use pdf::font::Font;
use pdf::encoder::{Text, Color};

fn add_watermark(input: &str, output: &str) -> Result<(), pdf::error::PdfError> {
    let file = File::open(input)?;
    let mut writer = PdfWriter::new();
    let font = Font::helvetica();
    
    for page in file.pages() {
        let original_page = page?;
        let mut new_page = Page::new(original_page.media_box().unwrap());
        
        // 复制原始页面内容
        // 这里简化处理，实际需要更复杂的逻辑
        
        // 添加水印文本
        new_page.add_text(
            Text::new("CONFIDENTIAL", font)
                .at(Mm(50.0), Mm(150.0))
                .size(48.0)
                .color(Color::Rgb(255, 0, 0))
                .rotate(45.0)
                .opacity(0.3),
        );
        
        writer.add_page(new_page);
    }
    
    writer.write_to_file(output)?;
    Ok(())
}

完整示例demo

下面是一个完整的PDF处理示例，展示了如何创建一个PDF文档并添加水印：

use pdf::{PdfWriter, Page, Rect, Mm};
use pdf::font::Font;
use pdf::encoder::{Text, Color};
use pdf::file::File;

fn main() -> Result<(), pdf::error::PdfError> {
    // 1. 创建一个新的PDF文档
    let mut writer = PdfWriter::new();
    
    // 2. 添加一个A4尺寸的页面
    let mut page = Page::new(Rect::new(Mm(0.0), Mm(0.0), Mm(210.0), Mm(297.0)));
    
    // 3. 获取Helvetica字体
    let font = Font::helvetica();
    
    // 4. 添加主文本内容
    page.add_text(
        Text::new("Rust PDF处理示例", font)
            .at(Mm(50.0), Mm(250.0))
            .size(36.0)
            .color(Color::Rgb(0, 0, 0)),
    );
    
    // 5. 添加副文本
    page.add_text(
        Text::new("使用pdf库创建PDF文档", font)
            .at(Mm(50.0), Mm(220.0))
            .size(24.0)
            .color(Color::Rgb(0, 0, 0)),
    );
    
    // 6. 将页面添加到文档
    writer.add_page(page);
    
    // 7. 保存初始文档
    writer.write_to_file("initial.pdf")?;
    
    // 8. 为文档添加水印
    add_watermark("initial.pdf", "watermarked.pdf")?;
    
    Ok(())
}

fn add_watermark(input: &str, output: &str) -> Result<(), pdf::error::PdfError> {
    let file = File::open(input)?;
    let mut writer = PdfWriter::new();
    let font = Font::helvetica();
    
    for page in file.pages() {
        let original_page = page?;
        let mut new_page = Page::new(original_page.media_box().unwrap());
        
        // 复制原始页面内容
        // 这里简化处理，实际需要更复杂的逻辑
        
        // 添加水印文本
        new_page.add_text(
            Text::new("示例水印", font)
                .at(Mm(50.0), Mm(150.0))
                .size(48.0)
                .color(Color::Rgb(255, 0, 0))
                .rotate(45.0)
                .opacity(0.3),
        );
        
        writer.add_page(new_page);
    }
    
    writer.write_to_file(output)?;
    Ok(())
}

注意事项

1. 该库仍在积极开发中，某些高级PDF功能可能不完全支持
2. 处理大型PDF文件时注意内存使用
3. 复杂的PDF操作可能需要深入理解PDF格式规范
4. 对于生产环境使用，建议充分测试所有功能

替代方案

如果需要更高级或更稳定的PDF功能，可以考虑以下替代方案：

• lopdf - 另一个Rust PDF操作库
• printpdf - 专注于PDF生成的库
• 通过FFI绑定使用成熟的C/C++库如poppler或pdfium