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       -tiff  Generates a TIFF file instead a PPM file.
89
90       -tiffcompression none | packbits | jpeg | lzw | deflate
91              Specifies the TIFF compression type.  This defaults to "none".
92
93       -freetype yes | no
94              Enable  or  disable  FreeType  (a TrueType / Type 1 font raster‐
95              izer).  This defaults to "yes".
96
97       -thinlinemode none | solid | shape
98              Specifies the thin line mode. This defaults to "none".
99
100       "solid":
101              adjust lines with a width less than one pixel to pixel  boundary
102              and paint it with a width of one pixel.
103
104       "shape":
105              adjust  lines with a width less than one pixel to pixel boundary
106              and paint it with a width of one pixel but with a shape in  pro‐
107              portion to its width.
108
109       -aa yes | no
110              Enable or disable font anti-aliasing.  This defaults to "yes".
111
112       -aaVector yes | no
113              Enable or disable vector anti-aliasing.  This defaults to "yes".
114
115       -opw password
116              Specify  the  owner  password  for the PDF file.  Providing this
117              will bypass all security restrictions.
118
119       -upw password
120              Specify the user password for the PDF file.
121
122       -q     Don't print any messages or errors.
123
124       -v     Print copyright and version information.
125
126       -h     Print usage information.  (-help and --help are equivalent.)
127

EXIT CODES

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

AUTHOR

142       The pdftoppm software and documentation are copyright 1996-2011 Glyph &
143       Cog, LLC.
144

SEE ALSO

146       pdfdetach(1),  pdffonts(1),  pdfimages(1),  pdfinfo(1),  pdftocairo(1),
147       pdftohtml(1), pdftops(1), pdftotext(1)
148
149
150
151                                15 August 2011                     pdftoppm(1)