pdftoppm(1) manual page
Table of Contents
pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM)
converter (version 3.03)
pdftoppm [options] PDF-file PPM-root
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-number.ppm,
where number is the page number.
- -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 rasterizer). 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 proportion 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.)
The
Xpdf tools use the following exit codes:
- No error.
- Error opening a PDF file.
- Error opening an output file.
- Error related to PDF permissions.
- Other error.
The pdftoppm software and documentation are copyright 1996-2011 Glyph
& Cog, LLC.
pdfdetach(1)
, pdffonts(1)
, pdfimages(1)
, pdfinfo(1)
,
pdftocairo(1)
, pdftohtml(1)
, pdftops(1)
, pdftotext(1)
Table of Contents