#image-conversion #pdf #image #poppler #conversion #convert #pdf2img

pdf2image

A simplified port of Python's pdf2image that wraps pdftoppm and pdftocairo to convert PDFs into images

3 releases

0.1.2 May 7, 2024
0.1.1 May 7, 2024
0.1.0 May 7, 2024

#377 in Images

Download history 17/week @ 2024-07-27 6/week @ 2024-08-03 47/week @ 2024-08-10 27/week @ 2024-08-17 169/week @ 2024-08-24 27/week @ 2024-08-31 40/week @ 2024-09-07 61/week @ 2024-09-14 55/week @ 2024-09-21 107/week @ 2024-09-28 101/week @ 2024-10-05 81/week @ 2024-10-12 64/week @ 2024-10-19 71/week @ 2024-10-26 111/week @ 2024-11-02 107/week @ 2024-11-09

381 downloads per month
Used in 3 crates

MIT license

19KB
358 lines

pdf2image

A simplified port of Python's pdf2image that wraps pdftoppmand pdftocairo (part of poppler) to convert PDFs to image::DynamicImages.

Installation

Add to your project: cargo add pdf2image

pdf2image requires poppler to be installed.

Windows

Windows users will have to build or download poppler for Windows. Python's pdf2image maintainer recommends @oschwartz10612 version. You will then have to add the bin/ folder to PATH or use the environment variable PDF2IMAGE_POPPLER_PATH.

macOS

using homebrew:

brew install poppler

Linux

Most distros ship with pdftoppm and pdftocairo. If they are not installed, refer to your package manager to install poppler-utils

Platform-independent (Using conda)

  1. Install poppler: conda install -c conda-forge poppler
  2. Install pdf2image: pip install pdf2image

Quick Start

use pdf2image::{PDF2ImageError, RenderOptionsBuilder, PDF};

fn main() -> Result<(), PDF2ImageError> {
    let pdf = PDF::from_file("examples/pdfs/ropes.pdf").unwrap();
    let pages = pdf.render(
        pdf2image::Pages::Range(1..=8),
        RenderOptionsBuilder::default().build()?,
    );
    println!("{:?}", pages.unwrap().len());

    Ok(())
}

Changelog

  • Reviewed all occurences of .unwrap(), refactored unnecessary ones to return errors and added comments detailing why it is safe to call (Thank you @qarmin!).

License

pdf2image includes code derived from Edouard Belval's pdf2image Python module, which is MIT licensed. Similarly, pdf2image is also licensed under the MIT License.

Dependencies

~17MB
~389K SLoC