NAME

       pdfimages - Portable Document Format (PDF) image extractor (version 3.03)

SYNOPSIS

       pdfimages [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 various  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 separate 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 scaling 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 ALSO

       pdfdetach(1)   pdffonts(1),   pdfinfo(1),   pdftocairo(1),   pdftohtml(1),    pdftoppm(1),
       pdftops(1), pdftotext(1)

                                          15 August 2011                             pdfimages(1)