org.apache.pdfbox.rendering

Class PDFRenderer

java.lang.Object

org.apache.pdfbox.rendering.PDFRenderer

public class PDFRenderer
extends Object

Renders a PDF document to an AWT BufferedImage. This class may be overridden in order to perform custom rendering.

Author:

John Hewson

Field Summary

Fields

Modifier and Type	Field and Description
protected PDDocument	document

Constructor Summary

Constructors

Constructor and Description
PDFRenderer(PDDocument document) Creates a new PDFRenderer.

Method Summary

Methods

Modifier and Type	Method and Description
protected PageDrawer	createPageDrawer(PageDrawerParameters parameters) Returns a new PageDrawer instance, using the given parameters.
BufferedImage	renderImage(int pageIndex) Returns the given page as an RGB image at 72 DPI
BufferedImage	renderImage(int pageIndex, float scale) Returns the given page as an RGB image at the given scale.
BufferedImage	renderImage(int pageIndex, float scale, ImageType imageType) Returns the given page as an RGB or ARGB image at the given scale.
BufferedImage	renderImageWithDPI(int pageIndex, float dpi) Returns the given page as an RGB image at the given DPI.
BufferedImage	renderImageWithDPI(int pageIndex, float dpi, ImageType imageType) Returns the given page as an RGB image at the given DPI.
void	renderPageToGraphics(int pageIndex, Graphics2D graphics) Renders a given page to an AWT Graphics2D instance.
void	renderPageToGraphics(int pageIndex, Graphics2D graphics, float scale) Renders a given page to an AWT Graphics2D instance.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

document

protected final PDDocument document

Constructor Detail

PDFRenderer

public PDFRenderer(PDDocument document)

Creates a new PDFRenderer.

Parameters:

document - the document to render

Method Detail

renderImage

public BufferedImage renderImage(int pageIndex)
                          throws IOException

Returns the given page as an RGB image at 72 DPI

Parameters:

pageIndex - the zero-based index of the page to be converted.

Returns:

the rendered page image

Throws:

IOException - if the PDF cannot be read

renderImage

public BufferedImage renderImage(int pageIndex,
                        float scale)
                          throws IOException

Returns the given page as an RGB image at the given scale. A scale of 1 will render at 72 DPI.

Parameters:

pageIndex - the zero-based index of the page to be converted

scale - the scaling factor, where 1 = 72 DPI

Returns:

the rendered page image

Throws:

IOException - if the PDF cannot be read

renderImageWithDPI

public BufferedImage renderImageWithDPI(int pageIndex,
                               float dpi)
                                 throws IOException

Returns the given page as an RGB image at the given DPI.

Parameters:

pageIndex - the zero-based index of the page to be converted

dpi - the DPI (dots per inch) to render at

Returns:

the rendered page image

Throws:

IOException - if the PDF cannot be read

renderImageWithDPI

public BufferedImage renderImageWithDPI(int pageIndex,
                               float dpi,
                               ImageType imageType)
                                 throws IOException

Returns the given page as an RGB image at the given DPI.

Parameters:

pageIndex - the zero-based index of the page to be converted

dpi - the DPI (dots per inch) to render at

imageType - the type of image to return

Returns:

the rendered page image

Throws:

IOException - if the PDF cannot be read

renderImage

public BufferedImage renderImage(int pageIndex,
                        float scale,
                        ImageType imageType)
                          throws IOException

Returns the given page as an RGB or ARGB image at the given scale.

Parameters:

pageIndex - the zero-based index of the page to be converted

scale - the scaling factor, where 1 = 72 DPI

imageType - the type of image to return

Returns:

the rendered page image

Throws:

IOException - if the PDF cannot be read

renderPageToGraphics

public void renderPageToGraphics(int pageIndex,
                        Graphics2D graphics)
                          throws IOException

Renders a given page to an AWT Graphics2D instance.

Parameters:

pageIndex - the zero-based index of the page to be converted

graphics - the Graphics2D on which to draw the page

Throws:

IOException - if the PDF cannot be read

renderPageToGraphics

public void renderPageToGraphics(int pageIndex,
                        Graphics2D graphics,
                        float scale)
                          throws IOException

Renders a given page to an AWT Graphics2D instance.

Parameters:

pageIndex - the zero-based index of the page to be converted

graphics - the Graphics2D on which to draw the page

scale - the scale to draw the page at

Throws:

IOException - if the PDF cannot be read

createPageDrawer

protected PageDrawer createPageDrawer(PageDrawerParameters parameters)
                               throws IOException

Returns a new PageDrawer instance, using the given parameters. May be overridden.

Throws:

IOException