Skip to main content

Module render

Module render 

Source
Expand description

PDF page rendering to raster images (merged from easypdf-render). PDF 页面渲染为光栅图像。

本模块提供基于 trait 的抽象(PdfRenderer)用于将 PDF 页面渲染为 光栅图像(PNG、JPEG)。两个可用后端:

  • TextRenderer(默认,纯 Rust)——通过 easypdf_reader::PdfReader 提取文本并渲染为简单位图图像。质量较低但足以满足 OCR 流水线需求,无外部依赖。

  • PdfiumRenderer(feature pdfium)——使用 Google PDFium 进行 高质量渲染,运行时需要 libpdfium 动态库。

§快速开始

use easypdf_markdown::render::{render_page_to_png, render_all_pages_to_dir};

// 以 150 DPI 渲染第 0 页:
render_page_to_png("input.pdf".as_ref(), 0, "page_0.png".as_ref(), 150)?;

// 将全部页面渲染到目录:
let paths = render_all_pages_to_dir("input.pdf".as_ref(), "output/".as_ref(), 150)?;

§选择后端

使用 RenderBackend::default_backend 自动选择最佳可用后端,或手动指定:

use easypdf_markdown::render::RenderBackend;

let renderer = RenderBackend::default_backend()
    .build_renderer("document.pdf".as_ref())?;

Re-exports§

pub use backend::RenderBackend;
pub use config::Background;
pub use config::ImageFormat;
pub use config::RenderConfig;
pub use error::RenderError;
pub use error::Result;
pub use traits::PdfRenderer;
pub use traits::RenderedImage;

Modules§

backend
PDF 渲染后端选择。
backends
渲染后端实现。
config
渲染配置类型。
error
PDF 渲染错误类型。
traits
核心渲染 trait 与输出类型。

Functions§

render_all_pages_to_dir
将 PDF 全部页面渲染为目录下的 PNG 文件。
render_page
将 PDF 单页渲染为内存中的 RenderedImage
render_page_to_png
将 PDF 单页渲染为 PNG 文件。