1pdftoppm(1) General Commands Manual pdftoppm(1)
2
6 pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM) con‐
7 verter (version 3.03)
8
10 pdftoppm [options] PDF-file PPM-root
11
13 Pdftoppm converts Portable Document Format (PDF) files to color image
14 files in Portable Pixmap (PPM) format, grayscale image files in Porta‐
15 ble Graymap (PGM) format, or monochrome image files in Portable Bitmap
16 (PBM) format.
17 Pdftoppm reads the PDF file, PDF-file, and writes one PPM file for each
19 page, PPM-root-number.ppm, where number is the page number.
20
22 -f number
23 Specifies the first page to convert.
24 -l number
26 Specifies the last page to convert.
27 -o Generates only the odd numbered pages.
29 -e Generates only the even numbered pages.
31 -singlefile
33 Writes only the first page and does not add digits.
34 -r number
36 Specifies the X and Y resolution, in DPI. The default is 150
37 DPI.
38 -rx number
40 Specifies the X resolution, in DPI. The default is 150 DPI.
41 -ry number
43 Specifies the Y resolution, in DPI. The default is 150 DPI.
44 -scale-to number
46 Scales the long side of each page (width for landscape pages,
47 height for portrait pages) to fit in scale-to pixels. The size
48 of the short side will be determined by the aspect ratio of the
49 page.
50 -scale-to-x number
52 Scales each page horizontally to fit in scale-to-x pixels. If
53 scale-to-y is set to -1, the vertical size will determined by
54 the aspect ratio of the page.
55 -scale-to-y number
57 Scales each page vertically to fit in scale-to-y pixels. If
58 scale-to-x is set to -1, the horizontal size will determined by
59 the aspect ratio of the page.
60 -scale-dimension-before-rotation
62 Swaps horizontal and vertical size for a rotated (landscape) pdf
63 before scaling instead of after.
64 -x number
66 Specifies the x-coordinate of the crop area top left corner
67 -y number
69 Specifies the y-coordinate of the crop area top left corner
70 -W number
72 Specifies the width of crop area in pixels (default is 0)
73 -H number
75 Specifies the height of crop area in pixels (default is 0)
76 -sz number
78 Specifies the size of crop square in pixels (sets W and H)
79 -cropbox
81 Uses the crop box rather than media box when generating the
82 files
83 -hide-annotations
85 Do not show annotations
86 -mono Generate a monochrome PBM file (instead of a color PPM file).
88 -gray Generate a grayscale PGM file (instead of a color PPM file).
90 -displayprofile displayprofilefile
92 If poppler is compiled with colour management support, this
93 option sets the display profile to the ICC profile stored in
94 displayprofilefile.
95 -png Generates a PNG file instead a PPM file.
97 -jpeg Generates a JPEG file instead a PPM file.
99 -jpegopt jpeg-options
101 When used with -jpeg, takes a list of options to control the
102 jpeg compression. See JPEG OPTIONS for the available options.
103 -tiff Generates a TIFF file instead a PPM file.
105 -tiffcompression none | packbits | jpeg | lzw | deflate
107 Specifies the TIFF compression type. This defaults to "none".
108 -freetype yes | no
110 Enable or disable FreeType (a TrueType / Type 1 font raster‐
111 izer). This defaults to "yes".
112 -thinlinemode none | solid | shape
114 Specifies the thin line mode. This defaults to "none".
115 "solid":
117 adjust lines with a width less than one pixel to pixel boundary
118 and paint it with a width of one pixel.
119 "shape":
121 adjust lines with a width less than one pixel to pixel boundary
122 and paint it with a width of one pixel but with a shape in pro‐
123 portion to its width.
124 -aa yes | no
126 Enable or disable font anti-aliasing. This defaults to "yes".
127 -aaVector yes | no
129 Enable or disable vector anti-aliasing. This defaults to "yes".
130 -opw password
132 Specify the owner password for the PDF file. Providing this
133 will bypass all security restrictions.
134 -upw password
136 Specify the user password for the PDF file.
137 -q Don't print any messages or errors.
139 -sep char
141 Specify single character separator between name and page number,
142 default - .
143 -forcenum
145 Force page number even if there is only one page.
146 -v Print copyright and version information.
148 -h Print usage information. (-help and --help are equivalent.)
150
152 The Xpdf tools use the following exit codes:
153 0 No error.
155 1 Error opening a PDF file.
157 2 Error opening an output file.
159 3 Error related to PDF permissions.
161 99 Other error.
163
165 When JPEG output is specified, the -jpegopt option can be used to con‐
166 trol the JPEG compression parameters. It takes a string of the form
167 "<opt>=<val>[,<opt>=<val>]". Currently the available options are:
168 quality
170 Selects the JPEG quality value. The value must be an integer
171 between 0 and 100.
172 progressive
174 Select progressive JPEG output. The possible values are "y",
175 "n", indicating progressive (yes) or non-progressive (no),
176 respectively.
177 optimize
179 Sets whether to compute optimal Huffman coding tables for the
180 JPEG output, which will create smaller files but make an extra
181 pass over the data. The value must be "y" or "n", with "y" per‐
182 forming optimization, otherwise the default Huffman tables are
183 used.
184
186 The pdftoppm software and documentation are copyright 1996-2011 Glyph &
187 Cog, LLC.
188
190 pdfdetach(1), pdffonts(1), pdfimages(1), pdfinfo(1), pdftocairo(1),
191 pdftohtml(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), pdfu‐
192 nite(1)
193 15 August 2011 pdftoppm(1)