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. If PDF-
20 file is ´-', it reads the PDF file from stdin.
21
23 -f number
24 Specifies the first page to convert.
25 -l number
27 Specifies the last page to convert.
28 -o Generates only the odd numbered pages.
30 -e Generates only the even numbered pages.
32 -singlefile
34 Writes only the first page and does not add digits.
35 -r number
37 Specifies the X and Y resolution, in DPI. The default is 150
38 DPI.
39 -rx number
41 Specifies the X resolution, in DPI. The default is 150 DPI.
42 -ry number
44 Specifies the Y resolution, in DPI. The default is 150 DPI.
45 -scale-to number
47 Scales the long side of each page (width for landscape pages,
48 height for portrait pages) to fit in scale-to pixels. The size
49 of the short side will be determined by the aspect ratio of the
50 page.
51 -scale-to-x number
53 Scales each page horizontally to fit in scale-to-x pixels. If
54 scale-to-y is set to -1, the vertical size will determined by
55 the aspect ratio of the page.
56 -scale-to-y number
58 Scales each page vertically to fit in scale-to-y pixels. If
59 scale-to-x is set to -1, the horizontal size will determined by
60 the aspect ratio of the page.
61 -scale-dimension-before-rotation
63 Swaps horizontal and vertical size for a rotated (landscape) pdf
64 before scaling instead of after.
65 -x number
67 Specifies the x-coordinate of the crop area top left corner
68 -y number
70 Specifies the y-coordinate of the crop area top left corner
71 -W number
73 Specifies the width of crop area in pixels (default is 0)
74 -H number
76 Specifies the height of crop area in pixels (default is 0)
77 -sz number
79 Specifies the size of crop square in pixels (sets W and H)
80 -cropbox
82 Uses the crop box rather than media box when generating the
83 files
84 -hide-annotations
86 Do not show annotations
87 -mono Generate a monochrome PBM file (instead of a color PPM file).
89 -gray Generate a grayscale PGM file (instead of a color PPM file).
91 -displayprofile displayprofilefile
93 If poppler is compiled with colour management support, this op‐
94 tion sets the display profile to the ICC profile stored in dis‐
95 playprofilefile.
96 -defaultgrayprofile defaultgrayprofilefile
98 If poppler is compiled with colour management support, this op‐
99 tion sets the DefaultGray color space to the ICC profile stored
100 in defaultgrayprofilefile.
101 -defaultrgbprofile defaultrgbprofilefile
103 If poppler is compiled with colour management support, this op‐
104 tion sets the DefaultRGB color space to the ICC profile stored
105 in defaultrgbprofilefile.
106 -defaultcmykprofile defaultcmykprofilefile
108 If poppler is compiled with colour management support, this op‐
109 tion sets the DefaultCMYK color space to the ICC profile stored
110 in defaultcmykprofilefile.
111 -png Generates a PNG file instead a PPM file.
113 -jpeg Generates a JPEG file instead a PPM file.
115 -jpegopt jpeg-options
117 When used with -jpeg, takes a list of options to control the
118 jpeg compression. See JPEG OPTIONS for the available options.
119 -tiff Generates a TIFF file instead a PPM file.
121 -tiffcompression none | packbits | jpeg | lzw | deflate
123 Specifies the TIFF compression type. This defaults to "none".
124 -freetype yes | no
126 Enable or disable FreeType (a TrueType / Type 1 font raster‐
127 izer). This defaults to "yes".
128 -thinlinemode none | solid | shape
130 Specifies the thin line mode. This defaults to "none".
131 "solid":
133 adjust lines with a width less than one pixel to pixel boundary
134 and paint it with a width of one pixel.
135 "shape":
137 adjust lines with a width less than one pixel to pixel boundary
138 and paint it with a width of one pixel but with a shape in pro‐
139 portion to its width.
140 -aa yes | no
142 Enable or disable font anti-aliasing. This defaults to "yes".
143 -aaVector yes | no
145 Enable or disable vector anti-aliasing. This defaults to "yes".
146 -opw password
148 Specify the owner password for the PDF file. Providing this
149 will bypass all security restrictions.
150 -upw password
152 Specify the user password for the PDF file.
153 -q Don't print any messages or errors.
155 -progress
157 Print progress info as each page is generated. Three space-sep‐
158 arated fields are printed to STDERR: the number of the current
159 page, the number of the last page that will be generated, and
160 the path to the file written to.
161 -sep char
163 Specify single character separator between name and page number,
164 default - .
165 -forcenum
167 Force page number even if there is only one page.
168 -v Print copyright and version information.
170 -h Print usage information. (-help and --help are equivalent.)
172
174 The Xpdf tools use the following exit codes:
175 0 No error.
177 1 Error opening a PDF file.
179 2 Error opening an output file.
181 3 Error related to PDF permissions.
183 99 Other error.
185
187 When JPEG output is specified, the -jpegopt option can be used to con‐
188 trol the JPEG compression parameters. It takes a string of the form
189 "<opt>=<val>[,<opt>=<val>]". Currently the available options are:
190 quality
192 Selects the JPEG quality value. The value must be an integer be‐
193 tween 0 and 100.
194 progressive
196 Select progressive JPEG output. The possible values are "y",
197 "n", indicating progressive (yes) or non-progressive (no), re‐
198 spectively.
199 optimize
201 Sets whether to compute optimal Huffman coding tables for the
202 JPEG output, which will create smaller files but make an extra
203 pass over the data. The value must be "y" or "n", with "y" per‐
204 forming optimization, otherwise the default Huffman tables are
205 used.
206
208 The pdftoppm software and documentation are copyright 1996-2011 Glyph &
209 Cog, LLC.
210
212 pdfdetach(1), pdffonts(1), pdfimages(1), pdfinfo(1), pdftocairo(1),
213 pdftohtml(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), pdfu‐
214 nite(1)
215 15 August 2011 pdftoppm(1)