pdftoppm

Section: User Commands (1)
Updated: 22 January 2004
Index Return to Main Contents
 

NAME

pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM) converter (version 3.00)  

SYNOPSIS

pdftoppm [options] PDF-file PPM-root  

DESCRIPTION

Pdftoppm converts Portable Document Format (PDF) files to color image files in Portable Pixmap (PPM) format, grayscale image files in Portable Graymap (PGM) format, or monochrome image files in Portable Bitmap (PBM) format.

Pdftoppm reads the PDF file, PDF-file, and writes one PPM file for each page, PPM-root-nnnnnn.ppm, where nnnnnn is the page number.  

OPTIONS

-f number
Specifies the first page to convert.
-l number
Specifies the last page to convert.
-r number
Specifies the X and Y resolution, in DPI. The default is 150 DPI.
-rx number
Specifies the X resolution, in DPI. The default is 150 DPI.
-ry number
Specifies the Y resolution, in DPI. The default is 150 DPI.
-scale-to number
Scales each page to fit in scale-to*scale-to pixel box.
-scale-to-x number
Scales each page horizontally to fit in scale-to-x pixels.
-scale-to-y number
Scales each page vertically to fit in scale-to-y pixels.
-x number
Specifies the x-coordinate of the crop area top left corner
-y number
Specifies the y-coordinate of the crop area top left corner
-W number
Specifies the width of crop area in pixels (default is 0)
-H number
Specifies the height of crop area in pixels (default is 0)
-sz number
Specifies the size of crop square in pixels (sets W and H)
-mono
Generate a monochrome PBM file (instead of a color PPM file).
-gray
Generate a grayscale PGM file (instead of a color PPM file).
-png
Generates a PNG file instead a PPM file.
-freetype yes | no
Enable or disable FreeType (a TrueType / Type 1 font rasterizer). This defaults to "yes".
-aa yes | no
Enable or disable font anti-aliasing. This defaults to "yes".
-aaVector yes | no
Enable or disable vector anti-aliasing. This defaults to "yes".
-opw password
Specify the owner password for the PDF file. Providing this will bypass all security restrictions.
-upw password
Specify the user password for the PDF file.
-q
Don't print any messages or errors.
-v
Print copyright and version information.
-h
Print usage information. (-help and --help are equivalent.)
 

EXIT CODES

The Xpdf tools use the following exit codes:
0
No error.
1
Error opening a PDF file.
2
Error opening an output file.
3
Error related to PDF permissions.
99
Other error.
 

AUTHOR

The pdftoppm software and documentation are copyright 1996-2004 Glyph & Cog, LLC.  

SEE ALSO

pdftops(1), pdftotext(1), pdfinfo(1), pdffonts(1), pdfimages(1),