1pdfimages(1) General Commands Manual pdfimages(1)
2
3
4
6 pdfimages - Portable Document Format (PDF) image extractor (version
7 3.03)
8
10 pdfimages [options] PDF-file image-root
11
13 Pdfimages saves images from a Portable Document Format (PDF) file as
14 Portable Pixmap (PPM), Portable Bitmap (PBM), Portable Network Graphics
15 (PNG), Tagged Image File Format (TIFF), JPEG, JPEG2000, or JBIG2 files.
16
17 Pdfimages reads the PDF file PDF-file, scans one or more pages, and
18 writes one file for each image, image-root-nnn.xxx, where nnn is the
19 image number and xxx is the image type (.ppm, .pbm, .png, .tif, .jpg,
20 jp2, jb2e, or jb2g).
21
22 The default output format is PBM (for monochrome images) or PPM for
23 non-monochrome. The -png or -tiff options change to default output to
24 PNG or TIFF respectively. If both -png and -tiff are specified, CMYK
25 images will be written as TIFF and all other images will be written as
26 PNG. In addition the -j, -jp2, and -jbig2 options will cause JPEG,
27 JPEG2000, and JBIG2, respectively, images in the PDF file to be written
28 in their native format.
29
31 -f number
32 Specifies the first page to scan.
33
34 -l number
35 Specifies the last page to scan.
36
37 -png Change the default output format to PNG.
38
39 -tiff Change the default output format to TIFF.
40
41 -j Write images in JPEG format as JPEG files instead of the default
42 format. The JPEG file is identical to the JPEG data stored in
43 the PDF.
44
45 -jp2 Write images in JPEG2000 format as JP2 files instead of the
46 default format. The JP2 file is identical to the JPEG2000 data
47 stored in the PDF.
48
49 -jbig2 Write images in JBIG2 format as JBIG2 files instead of the
50 default format. JBIG2 data in PDF is of the embedded type. The
51 embedded type of JBIG2 has an optional separate file containing
52 global data. The embedded data is written with the extension
53 .jb2e and the global data (if available) will be written to the
54 same image number with the extension .jb2g. The content of both
55 these files is identical to the JBIG2 data in the PDF.
56
57 -ccitt Write images in CCITT format as CCITT files instead of the
58 default format. The CCITT file is identical to the CCITT data
59 stored in the PDF. PDF files contain additional parameters spec‐
60 ifying how to decode the CCITT data. These parameters are trans‐
61 lated to fax2tiff input options and written to a .params file
62 with the same image number. The parameters are:
63
64 -1 1D Group 3 encoding
65
66 -2 2D Group 3 encoding
67
68 -4 Group 4 encoding
69
70 -A Beginning of line is aligned on a byte boundary
71
72 -P Beginning of line is not aligned on a byte boundary
73
74 -X n The image width in pixels
75
76 -W Encoding uses 1 for black and 0 for white
77
78 -B Encoding uses 0 for black and 1 for white
79
80 -M Input data fills from most significant bit to least sig‐
81 nificant bit.
82
83 -all Write JPEG, JPEG2000, JBIG2, and CCITT images in their native
84 format. CMYK files are written as TIFF files. All other images
85 are written as PNG files. This is equivalent to specifying the
86 options -png -tiff -j -jp2 -jbig2 -ccitt.
87
88 -list Instead of writing the images, list the images along with vari‐
89 ous information for each image. Do not specify an image-root
90 with this option.
91
92 The following information is listed for each image:
93
94 page the page number containing the image
95
96 num the image number
97
98 type the image type:
99
100 image - an opaque image
101 mask - a monochrome mask image
102 smask - a soft-mask image
103 stencil - a monochrome mask image used for painting a
104 color or pattern
105
106 Note: Tranparency in images is represented in PDF using a sepa‐
107 rate image for the image and the mask/smask. The mask/smask
108 used as part of a transparent image always immediately follows
109 the image in the image list.
110
111 width image width (in pixels)
112
113 height image height (in pixels)
114
115 Note: the image width/height is the size of the embedded image,
116 not the size the image will be rendered at.
117
118 color image color space:
119
120 gray - Gray
121 rgb - RGB
122 cmyk - CMYK
123 lab - L*a*b
124 icc - ICC Based
125 index - Indexed Color
126 sep - Separation
127 devn - DeviceN
128
129 comp number of color components
130
131 bpc bits per component
132
133 enc encoding:
134
135 image - raster image (may be Flate or LZW compressed but
136 does not use an image encoding)
137 jpeg - Joint Photographic Experts Group
138 jp2 - JPEG2000
139 jbig2 - Joint Bi-Level Image Experts Group
140 ccitt - CCITT Group 3 or Group 4 Fax
141
142 interp "yes" if the interpolation is to be performed when scal‐
143 ing up the image
144
145 object ID
146 the image dictionary object ID (number and generation)
147
148 x-ppi The horizontal resolution of the image (in pixels per
149 inch) when rendered on the pdf page.
150
151 y-ppi The vertical resolution of the image (in pixels per inch)
152 when rendered on the pdf page.
153
154 size The size of the embedded image in the pdf file. The fol‐
155 lowing suffixes are used: 'B' bytes, 'K' kilobytes, 'M'
156 megabytes, and 'G' gigabytes.
157
158 ratio The compression ratio of the embedded image.
159
160 -opw password
161 Specify the owner password for the PDF file. Providing this
162 will bypass all security restrictions.
163
164 -upw password
165 Specify the user password for the PDF file.
166
167 -p Include page numbers in output file names.
168
169 -q Don't print any messages or errors.
170
171 -v Print copyright and version information.
172
173 -h Print usage information. (-help and --help are equivalent.)
174
176 The Xpdf tools use the following exit codes:
177
178 0 No error.
179
180 1 Error opening a PDF file.
181
182 2 Error opening an output file.
183
184 3 Error related to PDF permissions.
185
186 99 Other error.
187
189 The pdfimages software and documentation are copyright 1998-2011 Glyph
190 & Cog, LLC.
191
193 pdfdetach(1), pdffonts(1), pdfinfo(1), pdftocairo(1), pdftohtml(1),
194 pdftoppm(1), pdftops(1), pdftotext(1) pdfseparate(1), pdfsig(1), pdfu‐
195 nite(1)
196
197
198
199 15 August 2011 pdfimages(1)