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       -sep char
157              Specify single character separator between name and page number,
158              default - .
159
160       -forcenum
161              Force page number even if there is only one page.
162
163       -v     Print copyright and version information.
164
165       -h     Print usage information.  (-help and --help are equivalent.)
166

EXIT CODES

168       The Xpdf tools use the following exit codes:
169
170       0      No error.
171
172       1      Error opening a PDF file.
173
174       2      Error opening an output file.
175
176       3      Error related to PDF permissions.
177
178       99     Other error.
179

JPEG OPTIONS

181       When JPEG output is specified, the -jpegopt option can be used to  con‐
182       trol  the  JPEG  compression parameters.  It takes a string of the form
183       "<opt>=<val>[,<opt>=<val>]". Currently the available options are:
184
185       quality
186              Selects the JPEG quality value. The value must be an integer be‐
187              tween 0 and 100.
188
189       progressive
190              Select  progressive  JPEG  output.  The possible values are "y",
191              "n", indicating progressive (yes) or non-progressive  (no),  re‐
192              spectively.
193
194       optimize
195              Sets  whether  to  compute optimal Huffman coding tables for the
196              JPEG output, which will create smaller files but make  an  extra
197              pass  over the data. The value must be "y" or "n", with "y" per‐
198              forming optimization, otherwise the default Huffman  tables  are
199              used.
200

AUTHOR

202       The pdftoppm software and documentation are copyright 1996-2011 Glyph &
203       Cog, LLC.
204

SEE ALSO

206       pdfdetach(1),  pdffonts(1),  pdfimages(1),  pdfinfo(1),  pdftocairo(1),
207       pdftohtml(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), pdfu‐
208       nite(1)
209
210
211
212                                15 August 2011                     pdftoppm(1)
Impressum