DragonFly On-Line Manual Pages
pdftoppm(1) pdftoppm(1)
NAME
pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM) con-
verter (version 3.03)
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 Porta-
ble 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-number.ppm, where number is the page number.
OPTIONS
-f number
Specifies the first page to convert.
-l number
Specifies the last page to convert.
-o Generates only the odd numbered pages.
-e Generates only the even numbered pages.
-singlefile
Writes only the first page and does not add digits.
-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 the long side of each page (width for landscape pages,
height for portrait pages) to fit in scale-to pixels. The size
of the short side will be determined by the aspect ratio of the
page.
-scale-to-x number
Scales each page horizontally to fit in scale-to-x pixels. If
scale-to-y is set to -1, the vertical size will determined by
the aspect ratio of the page.
-scale-to-y number
Scales each page vertically to fit in scale-to-y pixels. If
scale-to-x is set to -1, the horizontal size will determined by
the aspect ratio of the page.
-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)
-cropbox
Uses the crop box rather than media box when generating the
files
-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.
-jpeg Generates a JPEG file instead a PPM file.
-tiff Generates a TIFF file instead a PPM file.
-tiffcompression none | packbits | jpeg | lzw | deflate
Specifies the TIFF compression type. This defaults to "none".
-freetype yes | no
Enable or disable FreeType (a TrueType / Type 1 font raster-
izer). This defaults to "yes".
-thinlinemode none | solid | shape
Specifies the thin line mode. This defaults to "none".
"solid":
adjust lines with a width less than one pixel to pixel boundary
and paint it with a width of one pixel.
"shape":
adjust lines with a width less than one pixel to pixel boundary
and paint it with a width of one pixel but with a shape in pro-
portion to its width.
-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-2011 Glyph &
Cog, LLC.
SEE ALSO
pdfdetach(1), pdffonts(1), pdfimages(1), pdfinfo(1), pdftocairo(1),
pdftohtml(1), pdftops(1), pdftotext(1)
15 August 2011 pdftoppm(1)