pdfimages(1)pdfimages(1)NAMEpdfimages - Portable Document Format (PDF) image extractor (version
3.03)
SYNOPSISpdfimages [options] PDF-file image-root
DESCRIPTION
Pdfimages saves images from a Portable Document Format (PDF) file as
Portable Pixmap (PPM), Portable Bitmap (PBM), or JPEG files.
Pdfimages reads the PDF file PDF-file, scans one or more pages, and
writes one PPM, PBM, or JPEG file for each image, image-root-nnn.xxx,
where nnn is the image number and xxx is the image type (.ppm, .pbm,
.jpg).
OPTIONS-f number
Specifies the first page to scan.
-l number
Specifies the last page to scan.
-j Normally, all images are written as PBM (for monochrome images)
or PPM (for non-monochrome images) files. With this option,
images in DCT format are saved as JPEG files. All non-DCT
images are saved in PBM/PPM format as usual.
-list Instead of writing the images, list the images along with vari‐
ous information for each image. Do not specify an image-root
with this option.
The following information is listed for each image:
page the page number containing the image
num the image number
type the image type:
image - an opaque image
mask - a monochrome mask image
smask - a soft-mask image
stencil - a monochrome mask image used for painting a
color or pattern
Note: Tranparency in images is represented in PDF using a sepa‐
rate image for the image and the mask/smask. The mask/smask
used as part of a transparent image always immediately follows
the image in the image list.
width image width (in pixels)
height image height (in pixels)
Note: the image width/height is the size of the embedded image,
not the size the image will be rendered at.
color image color space:
gray - Gray
rgb - RGB
cmyk - CMYK
lab - L*a*b
icc - ICC Based
index - Indexed Color
sep - Separation
devn - DeviceN
comp number of color components
bpc bits per component
enc encoding:
image - raster image (may be Flate or LZW compressed but
does not use an image encoding)
jpeg - Joint Photographic Experts Group
jp2 - JPEG2000
jbig2 - Joint Bi-Level Image Experts Group
ccitt - CCITT Group 3 or Group 4 Fax
interp "yes" if the interpolation is to be performed when scal‐
ing up the image
object ID
the image dictionary object ID (number and generation)
-opw password
Specify the owner password for the PDF file. Providing this
will bypass all security restrictions.
-upw password
Specify the user password for the PDF file.
-p Include page numbers in output file names.
-q Don't print any messages or errors.
-v Print copyright and version information.
-h Print usage information. (-help and --help are equivalent.)
EXIT CODES
The Xpdf tools use the following exit codes:
0 No error.
1 Error opening a PDF file.
2 Error opening an output file.
3 Error related to PDF permissions.
99 Other error.
AUTHOR
The pdfimages software and documentation are copyright 1998-2011 Glyph
& Cog, LLC.
SEE ALSOpdfdetach(1)pdffonts(1), pdfinfo(1), pdftocairo(1), pdftohtml(1),
pdftoppm(1), pdftops(1), pdftotext(1)
15 August 2011 pdfimages(1)