pdfimages(1)

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)