73

Can someone give me an example on how to use Apache PDFBox to convert a PDF file in different images (one for each page of the PDF)?

1

7 Answers 7

131

Solution for 1.8.* versions:

PDDocument document = PDDocument.loadNonSeq(new File(pdfFilename), null);
List<PDPage> pdPages = document.getDocumentCatalog().getAllPages();
int page = 0;
for (PDPage pdPage : pdPages)
{ 
    ++page;
    BufferedImage bim = pdPage.convertToImage(BufferedImage.TYPE_INT_RGB, 300);
    ImageIOUtil.writeImage(bim, pdfFilename + "-" + page + ".png", 300);
}
document.close();

Don't forget to read the 1.8 dependencies page before doing your build.

Solution for the 2.0 version:

PDDocument document = PDDocument.load(new File(pdfFilename));
PDFRenderer pdfRenderer = new PDFRenderer(document);
for (int page = 0; page < document.getNumberOfPages(); ++page)
{ 
    BufferedImage bim = pdfRenderer.renderImageWithDPI(page, 300, ImageType.RGB);

    // suffix in filename will be used as the file format
    ImageIOUtil.writeImage(bim, pdfFilename + "-" + (page+1) + ".png", 300);
}
document.close();

The ImageIOUtil class is in a separate download / artifact (pdf-tools). Read the 2.0 dependencies page before doing your build, you'll need extra jar files for PDFs with jbig2 images, for saving to tiff images, and reading of encrypted files.

Make sure to use the latest version of whatever JDK version you are using, i.e. if you are using jdk8, then don't use version 1.8.0_5, use 1.8.0_191 or whatever is the latest at the time you're reading. Early versions were very slow.

14
  • 1
    For future readers of this Q&A you might also want to post a solution for 2.x (unless the API change in that respect has not yet stabilized, that is).
    – mkl
    Jan 15, 2015 at 11:50
  • 11
    Note that in order to use ImageIOUtil in 2.0 you will need to add a dependency on pdfbox-tools.
    – metaforge
    Dec 10, 2015 at 17:33
  • 4
    Great example! Thanks. Two remarks though: * in the 2.0 version, BufferedImage bim = is missing in the fifth line * Notice that "300" is the zoom level and not (as I assumed) a dpi value or something. It wasn't before I got tons of OutOfMemory exceptions that I thought to check the API! Apr 21, 2016 at 21:38
  • 2
    @Aeseir you need pdfbox-tools. Plus the levigo jbig2 decoder, and jai_imageio.jar. Jul 3, 2016 at 5:09
  • 1
    Thanks bud, found out they migrated the tools to a different jar.
    – Aeseir
    Jul 3, 2016 at 5:14
21

I tried it today with PdfBox 2.0.15.

import org.apache.pdfbox.pdmodel.*;
import org.apache.pdfbox.rendering.*;
import java.awt.image.*;
import java.io.*;
import javax.imageio.*;


public static void PDFtoJPG (String in, String out) throws Exception
{
    PDDocument pd = PDDocument.load (new File (in));
    PDFRenderer pr = new PDFRenderer (pd);
    BufferedImage bi = pr.renderImageWithDPI (0, 300);
    ImageIO.write (bi, "JPEG", new File (out)); 
}
5
  • 2
    works like a charm, just one thing. If the pdf document has more than one page use: pd.getNumberOfPages() to do a loop for every page.
    – GBS
    Aug 20, 2020 at 8:59
  • This gives me java heap space what would be the reason ?
    – GhostDede
    Jan 11, 2021 at 11:33
  • @GhostDede Did you play around with the DPI value? Maybe lowering solves your problem.
    – Spindizzy
    Apr 14, 2021 at 10:11
  • Yes lowering DPI value solves my problem but I need 500 DPI
    – GhostDede
    Apr 28, 2021 at 11:22
  • @GhostDede pretty sure you need to increase the java heap space. 500 DPI needs more heap than 300 DPI. Oct 20, 2022 at 8:37
4
public class PDFtoJPGConverter {

    public List<File> convertPdfToImage(File file, String destination) throws Exception {

    File destinationFile = new File(destination);

    if (!destinationFile.exists()) {
        destinationFile.mkdir();
        System.out.println("DESTINATION FOLDER CREATED -> " + destinationFile.getAbsolutePath());
    }else if(destinationFile.exists()){
        System.out.println("DESTINATION FOLDER ALLREADY CREATED!!!");
    }else{
        System.out.println("DESTINATION FOLDER NOT CREATED!!!");
    }

    if (file.exists()) {
        PDDocument doc = PDDocument.load(file);
        PDFRenderer renderer = new PDFRenderer(doc);
        List<File> fileList = new ArrayList<File>();

        String fileName = file.getName().replace(".pdf", "");
        System.out.println("CONVERTER START.....");

        for (int i = 0; i < doc.getNumberOfPages(); i++) {
        // default image files path: original file path
        // if necessary, file.getParent() + "/" => another path
        File fileTemp = new File(destination + fileName + "_" + i + ".jpg"); // jpg or png
        BufferedImage image = renderer.renderImageWithDPI(i, 200);
        // 200 is sample dots per inch.
        // if necessary, change 200 into another integer.
        ImageIO.write(image, "JPEG", fileTemp); // JPEG or PNG
        fileList.add(fileTemp);
        }
        doc.close();
        System.out.println("CONVERTER STOPTED.....");
        System.out.println("IMAGE SAVED AT -> " + destinationFile.getAbsolutePath());
        return fileList;
    } else {
        System.err.println(file.getName() + " FILE DOES NOT EXIST");
    }
    return null;
    }

    public static void main(String[] args) {

    try {
        PDFtoJPGConverter converter = new PDFtoJPGConverter();
        Scanner sc = new Scanner(System.in);
        System.out.print("Enter your destination folder where save image \n");
        // Destination = D:/PPL/;
        String destination = sc.nextLine();

        System.out.print("Enter your selected pdf files name with source folder \n");
        String sourcePathWithFileName = sc.nextLine();
        // Source Path = D:/PDF/ant.pdf,D:/PDF/abc.pdf,D:/PDF/xyz.pdf
        if (sourcePathWithFileName != null || sourcePathWithFileName != "") {
        String[] files = sourcePathWithFileName.split(",");
        for (String file : files) {
            File pdf = new File(file);
            System.out.print("FILE:>> "+ pdf);
            converter.convertPdfToImage(pdf, destination);
        }
        }

    } catch (Exception ex) {
        ex.printStackTrace();
    }
    }
}

====================================

Here i am use Apache pdfbox-2.0.8 , commons-logging-1.2 and fontbox-2.0.8 Library

HAPPY CODING :)

2

w/o any extra dependencies you can just use the PDFToImage class already included in PDFBox.

Kotlin:

PDFToImage.main(arrayOf<String>("-outputPrefix", "newImgFilenamePrefix", existingPdfFilename))

other config opts: https://pdfbox.apache.org/docs/2.0.8/javadocs/org/apache/pdfbox/tools/PDFToImage.html

4
  • 2
    There will be dependencies. You'll see it when having a PDF with restricted rights or which has JPEG 2000 images or JBIG2 images. Nov 6, 2017 at 9:36
  • 2
    There “will be dependencies” in that case. For my use case we are turning pdfs we create into imgs so there isn’t the issue of restricted rights or those different img kinds.
    – kittyminky
    Nov 6, 2017 at 15:07
  • Such images are IN the PDFs. Example: issues.apache.org/jira/secure/attachment/12865265/jbig2.pdf You're only safe if you know in advance that your input PDFs don't have these types of images inside them. Nov 7, 2017 at 21:54
  • The link with javadoc does not describe other options (in fact it does not describe any). At the moment one can use this mirrored source code to review options: github.com/apache/pdfbox/blob/trunk/tools/src/main/java/org/…
    – Googie
    Feb 16, 2022 at 20:37
1
import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.rendering.PDFRenderer;

import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.nio.file.Path;

public class Pdf2Image {

    public String convertPdf2Img(String fileInput, Path path) {
        String destDir = "";
        try {
            String destinationDir = path.toString();
            File sourceFile = new File(fileInput);
            File destinationFile = new File(destinationDir);

            if (!destinationFile.exists()) {
                destinationFile.mkdir();
                System.out.println("Folder Created -> " + destinationFile.getAbsolutePath());
            }

            if (sourceFile.exists()) {
                PDDocument document = PDDocument.load(sourceFile);
                PDFRenderer pdfRenderer = new PDFRenderer(document);

                String fileName = sourceFile.getName().replace(".pdf", "");

                // int pageNumber = 0;

                // for (PDPage page : document.getPages()) {
                for (int pageNumber = 0; pageNumber < document.getNumberOfPages(); ++pageNumber) {
                    BufferedImage bim = pdfRenderer.renderImage(pageNumber);

                    destDir = destinationDir + File.separator + fileName + "_" + pageNumber + ".png";

                    ImageIO.write(bim, "png", new File(destDir));
                }

                document.close();

                System.out.println("Image saved at -> " + destinationFile.getAbsolutePath());
            } else {
                System.err.println(sourceFile.getName() + " File does not exist");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }

        return destDir;
    }

}
1
  • What is the advantage of your solution compared with all the other ones?
    – mkl
    Sep 14, 2021 at 19:14
0

Here is part of my code to convert a pdf, from a multipart file, to jpg thumbnail. I'm saving the image as a base64 string. Pdfbox 2.0.21 version was used.

private static String generatePdfThumbnail(byte[] imageInBytesArray) throws IOException {
    PDDocument document = PDDocument.load(imageInBytesArray);
    PDFRenderer renderer = new PDFRenderer(document);
    BufferedImage bufferedImage = renderer.renderImage(0);
    Graphics2D bufImageGraphics = bufferedImage.createGraphics();
    bufImageGraphics.drawImage(bufferedImage, 0, 0, null);

    ByteArrayOutputStream baos = new ByteArrayOutputStream();
    boolean foundWriter = ImageIO.write(bufferedImage, "jpg", baos);
    byte[] fileContent = null;
    if (!foundWriter) {
      return "";
    }

    fileContent = baos.toByteArray();
    return Base64.getEncoder().encodeToString(fileContent);
  }
0

Just adding the following snippet for the new Apache pdfbox version 3 (3.0.0-RC1)

        try(PDDocument pddDoc =  Loader.loadPDF(docFile) ){
            PDFRenderer pr = new PDFRenderer (pddDoc );
            BufferedImage backImage = pr.renderImage(0);
        } catch (IOException  e) {
            e.printStackTrace();
        }

Notes

  • version 3 (3.0.0-RC1) works with GraalVM and the new just released Liberica Native Image Kit allows for awt on Linux/Windows/Mac
  • PDDocument.load ect replaced by new org.apache.pdfbox.Loader class

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge that you have read and understand our privacy policy and code of conduct.

Not the answer you're looking for? Browse other questions tagged or ask your own question.