1pdftoppm(1)                 General Commands Manual                pdftoppm(1)
2
3
4

NAME

6       pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM) con‐
7       verter (version 3.03)
8

SYNOPSIS

10       pdftoppm [options] PDF-file PPM-root
11

DESCRIPTION

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
18       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

OPTIONS

23       -f number
24              Specifies the first page to convert.
25
26       -l number
27              Specifies the last page to convert.
28
29       -o     Generates only the odd numbered pages.
30
31       -e     Generates only the even numbered pages.
32
33       -singlefile
34              Writes only the first page and does not add digits.
35
36       -r number
37              Specifies  the  X  and Y resolution, in DPI.  The default is 150
38              DPI.
39
40       -rx number
41              Specifies the X resolution, in DPI.  The default is 150 DPI.
42
43       -ry number
44              Specifies the Y resolution, in DPI.  The default is 150 DPI.
45
46       -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
52       -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
57       -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
62       -scale-dimension-before-rotation
63              Swaps horizontal and vertical size for a rotated (landscape) pdf
64              before scaling instead of after.
65
66       -x number
67              Specifies the x-coordinate of the crop area top left corner
68
69       -y number
70              Specifies the y-coordinate of the crop area top left corner
71
72       -W number
73              Specifies the width of crop area in pixels (default is 0)
74
75       -H number
76              Specifies the height of crop area in pixels (default is 0)
77
78       -sz number
79              Specifies the size of crop square in pixels (sets W and H)
80
81       -cropbox
82              Uses the crop box rather than  media  box  when  generating  the
83              files
84
85       -hide-annotations
86              Do not show annotations
87
88       -mono  Generate a monochrome PBM file (instead of a color PPM file).
89
90       -gray  Generate a grayscale PGM file (instead of a color PPM file).
91
92       -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
97       -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
102       -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
107       -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
112       -png   Generates a PNG file instead a PPM file.
113
114       -jpeg  Generates a JPEG file instead a PPM file.
115
116       -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
120       -tiff  Generates a TIFF file instead a PPM file.
121
122       -tiffcompression none | packbits | jpeg | lzw | deflate
123              Specifies the TIFF compression type.  This defaults to "none".
124
125       -freetype yes | no
126              Enable or disable FreeType (a TrueType /  Type  1  font  raster‐
127              izer).  This defaults to "yes".
128
129       -thinlinemode none | solid | shape
130              Specifies the thin line mode. This defaults to "none".
131
132       "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
136       "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
141       -aa yes | no
142              Enable or disable font anti-aliasing.  This defaults to "yes".
143
144       -aaVector yes | no
145              Enable or disable vector anti-aliasing.  This defaults to "yes".
146
147       -opw password
148              Specify the owner password for the  PDF  file.   Providing  this
149              will bypass all security restrictions.
150
151       -upw password
152              Specify the user password for the PDF file.
153
154       -q     Don't print any messages or errors.
155
156       -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
162       -sep char
163              Specify single character separator between name and page number,
164              default - .
165
166       -forcenum
167              Force page number even if there is only one page.
168
169       -v     Print copyright and version information.
170
171       -h     Print usage information.  (-help and --help are equivalent.)
172

EXIT CODES

174       The Xpdf tools use the following exit codes:
175
176       0      No error.
177
178       1      Error opening a PDF file.
179
180       2      Error opening an output file.
181
182       3      Error related to PDF permissions.
183
184       99     Other error.
185

JPEG OPTIONS

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
191       quality
192              Selects the JPEG quality value. The value must be an integer be‐
193              tween 0 and 100.
194
195       progressive
196              Select progressive JPEG output. The  possible  values  are  "y",
197              "n",  indicating  progressive (yes) or non-progressive (no), re‐
198              spectively.
199
200       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

AUTHOR

208       The pdftoppm software and documentation are copyright 1996-2011 Glyph &
209       Cog, LLC.
210

SEE ALSO

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
216
217
218                                15 August 2011                     pdftoppm(1)
Impressum