Rust PDF生成库printpdf的使用指南

介绍

printpdf是一个纯Rust实现的PDF生成库，它允许开发者高效地创建、编辑和操作PDF文档。这个库提供了简单易用的API，支持文本、图像、矢量图形等多种PDF元素的添加和操作。

主要特性包括：

• 纯Rust实现，无外部依赖
• 支持创建多页PDF文档
• 可添加文本、图像、矢量图形
• 支持自定义字体
• 可设置页面大小和方向
• 支持图层操作

基本使用方法

添加依赖

首先在Cargo.toml中添加依赖：

[dependencies]
printpdf = "0.5.0"

创建简单PDF文档

use printpdf::*;
use std::fs::File;
use std::io::BufWriter;

fn main() {
    // 创建新PDF文档
    let (doc, page1, layer1) = PdfDocument::new(
        "PDF_Document_title", 
        Mm(210.0),  // A4宽度
        Mm(297.0),  // A4高度
        "Layer 1"
    );
    
    // 获取当前图层
    let current_layer = doc.get_page(page1).get_layer(layer1);
    
    // 添加文本
    current_layer.use_text("Hello, printpdf!", 48.0, Mm(10.0), Mm(200.0), &Font::default());
    
    // 保存到文件
    doc.save(&mut BufWriter::new(File::create("test.pdf").unwrap())).unwrap();
}

添加图像

use printpdf::*;
use std::fs::File;
use std::io::BufWriter;
use image::io::Reader as ImageReader;

fn main() {
    let (doc, page1, layer1) = PdfDocument::new("PDF with Image", Mm(210.0), Mm(297.0), "Layer 1");
    let current_layer = doc.get_page(page1).get_layer(layer1);
    
    // 加载图像
    let img = ImageReader::open("example.png").unwrap().decode().unwrap();
    
    // 添加图像到PDF
    let image = Image::try_from(img).unwrap();
    image.add_to_layer(current_layer.clone(), None, None, None, None, None, None);
    
    doc.save(&mut BufWriter::new(File::create("image.pdf").unwrap())).unwrap();
}

绘制图形

use printpdf::*;
use std::fs::File;
use std::io::BufWriter;

fn main() {
    let (doc, page1, layer1) = PdfDocument::new("PDF with Shapes", Mm(210.0), Mm(297.0), "Layer 1");
    let current_layer = doc.get_page(page1).get_layer(layer1);
    
    // 绘制矩形
    let line = Line {
        points: vec![
            (Point::new(Mm(20.0), Mm(20.0)), false),
            (Point::new(Mm(20.0), Mm(50.0)), false),
            (Point::new(Mm(50.0), Mm(50.0)), false),
            (Point::new(Mm(50.0), Mm(20.0)), false),
            (Point::new(Mm(20.0), Mm(20.0)), false),
        ],
        is_closed: true,
        has_fill: true,
        has_stroke: true,
        is_clipping_path: false,
    };
    
    current_layer.add_shape(line);
    
    doc.save(&mut BufWriter::new(File::create("shapes.pdf").unwrap())).unwrap();
}

高级功能

使用自定义字体

use printpdf::*;
use std::fs::File;
use std::io::BufWriter;

fn main() {
    let (doc, page1, layer1) = PdfDocument::new("PDF with Custom Font", Mm(210.0), Mm(297.0), "Layer 1");
    let current_layer = doc.get_page(page1).get_layer(layer1);
    
    // 加载字体文件
    let font_data = std::fs::read("custom_font.ttf").unwrap();
    let font = doc.add_external_font(font_data.as_slice()).unwrap();
    
    // 使用自定义字体
    current_layer.use_text("Custom Font Text", 48.0, Mm(10.0), Mm(200.0), &font);
    
    doc.save(&mut BufWriter::new(File::create("custom_font.pdf").unwrap())).unwrap();
}

创建多页文档

use printpdf::*;
use std::fs::File;
use std::io::BufWriter;

fn main() {
    let (doc, page1, layer1) = PdfDocument::new("Multi-page PDF", Mm(210.0), Mm(297.0), "Layer 1");
    let current_layer = doc.get_page(page1).get_layer(layer1);
    current_layer.use_text("Page 1", 48.0, Mm(10.0), Mm(200.0), &Font::default());
    
    // 添加第二页
    let (page2, layer2) = doc.add_page(Mm(210.0), Mm(297.0), "Layer 1");
    let current_layer2 = doc.get_page(page2).get_layer(layer2);
    current_layer2.use_text("Page 2", 48.0, Mm(10.0), Mm(200.0), &Font::default());
    
    doc.save(&mut BufWriter::new(File::create("multi_page.pdf").unwrap())).unwrap();
}

完整示例

以下是一个综合示例，展示如何创建一个包含文本、图像和图形的多页PDF文档：

use printpdf::*;
use std::fs::File;
use std::io::BufWriter;
use image::io::Reader as ImageReader;

fn main() {
    // 创建多页PDF文档
    let (doc, page1, layer1) = PdfDocument::new("Comprehensive PDF Example", Mm(210.0), Mm(297.0), "Layer 1");
    let current_layer = doc.get_page(page1).get_layer(layer1);
    
    // 第一页添加文本
    current_layer.use_text("First Page - Title", 36.0, Mm(50.0), Mm(250.0), &Font::default());
    
    // 第一页添加矩形
    let rect = Line {
        points: vec![
            (Point::new(Mm(30.0), Mm(30.0)), false),
            (Point::new(Mm(30.0), Mm(100.0)), false),
            (Point::new(Mm(100.0), Mm(100.0)), false),
            (Point::new(Mm(100.0), Mm(30.0)), false),
            (Point::new(Mm(30.0), Mm(30.0)), false),
        ],
        is_closed: true,
        has_fill: true,
        has_stroke: true,
        is_clipping_path: false,
    };
    current_layer.add_shape(rect);
    
    // 添加第二页
    let (page2, layer2) = doc.add_page(Mm(210.0), Mm(297.0), "Layer 1");
    let current_layer2 = doc.get_page(page2).get_layer(layer2);
    
    // 第二页添加文本
    current_layer2.use_text("Second Page - Image Example", 36.0, Mm(50.0), Mm(250.0), &Font::default());
    
    // 第二页添加图像
    if let Ok(img) = ImageReader::open("example.png").unwrap().decode() {
        let image = Image::try_from(img).unwrap();
        image.add_to_layer(
            current_layer2.clone(), 
            Some(Mm(30.0)),  // x坐标
            Some(Mm(30.0)),  // y坐标
            Some(Mm(100.0)), // 宽度
            Some(Mm(100.0)), // 高度
            None,            // 旋转
            None             // 透明度
        );
    }
    
    // 保存PDF文件
    doc.save(&mut BufWriter::new(File::create("comprehensive.pdf").unwrap())).unwrap();
}

注意事项

1. printpdf目前主要专注于PDF生成，对PDF编辑功能支持有限
2. 对于复杂布局，可能需要手动计算坐标位置
3. 性能方面，对于非常大的文档可能需要优化
4. 某些高级PDF特性可能不支持

printpdf是一个功能强大且易于使用的PDF生成库，特别适合需要以编程方式生成PDF文档的Rust应用程序。