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.
20

OPTIONS

22       -f number
23              Specifies the first page to convert.
24
25       -l number
26              Specifies the last page to convert.
27
28       -o     Generates only the odd numbered pages.
29
30       -e     Generates only the even numbered pages.
31
32       -singlefile
33              Writes only the first page and does not add digits.
34
35       -r number
36              Specifies the X and Y resolution, in DPI.  The  default  is  150
37              DPI.
38
39       -rx number
40              Specifies the X resolution, in DPI.  The default is 150 DPI.
41
42       -ry number
43              Specifies the Y resolution, in DPI.  The default is 150 DPI.
44
45       -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
51       -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
56       -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
61       -x number
62              Specifies the x-coordinate of the crop area top left corner
63
64       -y number
65              Specifies the y-coordinate of the crop area top left corner
66
67       -W number
68              Specifies the width of crop area in pixels (default is 0)
69
70       -H number
71              Specifies the height of crop area in pixels (default is 0)
72
73       -sz number
74              Specifies the size of crop square in pixels (sets W and H)
75
76       -cropbox
77              Uses the crop box rather than  media  box  when  generating  the
78              files
79
80       -mono  Generate a monochrome PBM file (instead of a color PPM file).
81
82       -gray  Generate a grayscale PGM file (instead of a color PPM file).
83
84       -png   Generates a PNG file instead a PPM file.
85
86       -jpeg  Generates a JPEG file instead a PPM file.
87
88       -jpegopt jpeg-options
89              When  used  with  -jpeg,  takes a list of options to control the
90              jpeg compression. See JPEG OPTIONS for the available options.
91
92       -tiff  Generates a TIFF file instead a PPM file.
93
94       -tiffcompression none | packbits | jpeg | lzw | deflate
95              Specifies the TIFF compression type.  This defaults to "none".
96
97       -freetype yes | no
98              Enable or disable FreeType (a TrueType /  Type  1  font  raster‐
99              izer).  This defaults to "yes".
100
101       -thinlinemode none | solid | shape
102              Specifies the thin line mode. This defaults to "none".
103
104       "solid":
105              adjust  lines with a width less than one pixel to pixel boundary
106              and paint it with a width of one pixel.
107
108       "shape":
109              adjust lines with a width less than one pixel to pixel  boundary
110              and  paint it with a width of one pixel but with a shape in pro‐
111              portion to its width.
112
113       -aa yes | no
114              Enable or disable font anti-aliasing.  This defaults to "yes".
115
116       -aaVector yes | no
117              Enable or disable vector anti-aliasing.  This defaults to "yes".
118
119       -opw password
120              Specify the owner password for the  PDF  file.   Providing  this
121              will bypass all security restrictions.
122
123       -upw password
124              Specify the user password for the PDF file.
125
126       -q     Don't print any messages or errors.
127
128       -v     Print copyright and version information.
129
130       -h     Print usage information.  (-help and --help are equivalent.)
131

EXIT CODES

133       The Xpdf tools use the following exit codes:
134
135       0      No error.
136
137       1      Error opening a PDF file.
138
139       2      Error opening an output file.
140
141       3      Error related to PDF permissions.
142
143       99     Other error.
144

JPEG OPTIONS

146       When  JPEG output is specified, the -jpegopt option can be used to con‐
147       trol the JPEG compression parameters.  It takes a string  of  the  form
148       "<opt>=<val>[,<opt>=<val>]". Currently the available options are:
149
150       quality
151              Selects  the  JPEG  quality  value. The value must be an integer
152              between 0 and 100.
153
154       progressive
155              Select progressive JPEG output. The  possible  values  are  "y",
156              "n",  indicating  progressive  (yes)  or  non-progressive  (no),
157              respectively.
158
159       optimize
160              Sets whether to compute optimal Huffman coding  tables  for  the
161              JPEG  output,  which will create smaller files but make an extra
162              pass over the data. The value must be "y" or "n", with "y"  per‐
163              forming  optimization,  otherwise the default Huffman tables are
164              used.
165

AUTHOR

167       The pdftoppm software and documentation are copyright 1996-2011 Glyph &
168       Cog, LLC.
169

SEE ALSO

171       pdfdetach(1),  pdffonts(1),  pdfimages(1),  pdfinfo(1),  pdftocairo(1),
172       pdftohtml(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), pdfu‐
173       nite(1)
174
175
176
177                                15 August 2011                     pdftoppm(1)
Impressum