| .\" Copyright 2004 Glyph & Cog, LLC |
| .TH pdftoppm 1 "22 January 2004" |
| .SH NAME |
| pdftoppm \- Portable Document Format (PDF) to Portable Pixmap (PPM) |
| converter (version 3.00) |
| .SH SYNOPSIS |
| .B pdftoppm |
| [options] |
| .I PDF-file PPM-root |
| .SH DESCRIPTION |
| .B 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. |
| .PP |
| Pdftoppm reads the PDF file, |
| .IR PDF-file , |
| and writes one PPM file for each page, |
| .IR PPM-root - nnnnnn .ppm, |
| where |
| .I nnnnnn |
| is the page number. |
| .SH CONFIGURATION FILE |
| Pdftoppm reads a configuration file at startup. It first tries to |
| find the user's private config file, ~/.xpdfrc. If that doesn't |
| exist, it looks for a system-wide config file, /etc/xpdf/xpdfrc. See the |
| .BR xpdfrc (5) |
| man page for details. |
| .SH OPTIONS |
| Many of the following options can be set with configuration file |
| commands. These are listed in square brackets with the description of |
| the corresponding command line option. |
| .TP |
| .BI \-f " number" |
| Specifies the first page to convert. |
| .TP |
| .BI \-l " number" |
| Specifies the last page to convert. |
| .TP |
| .BI \-r " number" |
| Specifies the resolution, in DPI. The default is 150 DPI. |
| .TP |
| .B \-mono |
| Generate a monochrome PBM file (instead of a color PPM file). |
| .TP |
| .B \-gray |
| Generate a grayscale PGM file (instead of a color PPM file). |
| .TP |
| .BI \-t1lib " yes | no" |
| Enable or disable t1lib (a Type 1 font rasterizer). This defaults to |
| "yes". |
| .RB "[config file: " enableT1lib ] |
| .TP |
| .BI \-freetype " yes | no" |
| Enable or disable FreeType (a TrueType / Type 1 font rasterizer). |
| This defaults to "yes". |
| .RB "[config file: " enableFreeType ] |
| .TP |
| .BI \-aa " yes | no" |
| Enable or disable font anti-aliasing. This defaults to "yes". |
| .RB "[config file: " antialias ] |
| .TP |
| .BI \-opw " password" |
| Specify the owner password for the PDF file. Providing this will |
| bypass all security restrictions. |
| .TP |
| .BI \-upw " password" |
| Specify the user password for the PDF file. |
| .TP |
| .B \-q |
| Don't print any messages or errors. |
| .RB "[config file: " errQuiet ] |
| .TP |
| .B \-v |
| Print copyright and version information. |
| .TP |
| .B \-h |
| Print usage information. |
| .RB ( \-help |
| and |
| .B \-\-help |
| are equivalent.) |
| .SH EXIT CODES |
| The Xpdf tools use the following exit codes: |
| .TP |
| 0 |
| No error. |
| .TP |
| 1 |
| Error opening a PDF file. |
| .TP |
| 2 |
| Error opening an output file. |
| .TP |
| 3 |
| Error related to PDF permissions. |
| .TP |
| 99 |
| Other error. |
| .SH AUTHOR |
| The pdftoppm software and documentation are copyright 1996-2004 Glyph |
| & Cog, LLC. |
| .SH "SEE ALSO" |
| .BR xpdf (1), |
| .BR pdftops (1), |
| .BR pdftotext (1), |
| .BR pdfinfo (1), |
| .BR pdffonts (1), |
| .BR pdfimages (1), |
| .BR xpdfrc (5) |
| .br |
| .B http://www.foolabs.com/xpdf/ |
