| 1 | pdfimages(1) General Commands Manual pdfimages(1)
|
|---|
| 2 |
|
|---|
| 3 |
|
|---|
| 4 |
|
|---|
| 5 | NAME
|
|---|
| 6 | pdfimages - Portable Document Format (PDF) image extractor (version
|
|---|
| 7 | 4.00)
|
|---|
| 8 |
|
|---|
| 9 | SYNOPSIS
|
|---|
| 10 | pdfimages [options] PDF-file image-root
|
|---|
| 11 |
|
|---|
| 12 | DESCRIPTION
|
|---|
| 13 | Pdfimages saves images from a Portable Document Format (PDF) file as
|
|---|
| 14 | Portable Pixmap (PPM), Portable Graymap (PGM), Portable Bitmap (PBM),
|
|---|
| 15 | or JPEG files.
|
|---|
| 16 |
|
|---|
| 17 | Pdfimages reads the PDF file, scans one or more pages, PDF-file, and
|
|---|
| 18 | writes one PPM, PGM, PBM, or JPEG file for each image, image-root-
|
|---|
| 19 | nnnn.xxx, where nnnn is the image number and xxx is the image type
|
|---|
| 20 | (.ppm, .pgm, .pbm, .jpg).
|
|---|
| 21 |
|
|---|
| 22 | NB: pdfimages extracts the raw image data from the PDF file, without
|
|---|
| 23 | performing any additional transforms. Any rotation, clipping, color
|
|---|
| 24 | inversion, etc. done by the PDF content stream is ignored.
|
|---|
| 25 |
|
|---|
| 26 | CONFIGURATION FILE
|
|---|
| 27 | Pdfimages reads a configuration file at startup. It first tries to
|
|---|
| 28 | find the user's private config file, ~/.xpdfrc. If that doesn't exist,
|
|---|
| 29 | it looks for a system-wide config file, typically /usr/local/etc/xpdfrc
|
|---|
| 30 | (but this location can be changed when pdfimages is built). See the
|
|---|
| 31 | xpdfrc(5) man page for details.
|
|---|
| 32 |
|
|---|
| 33 | OPTIONS
|
|---|
| 34 | Many of the following options can be set with configuration file com-
|
|---|
| 35 | mands. These are listed in square brackets with the description of the
|
|---|
| 36 | corresponding command line option.
|
|---|
| 37 |
|
|---|
| 38 | -f number
|
|---|
| 39 | Specifies the first page to scan.
|
|---|
| 40 |
|
|---|
| 41 | -l number
|
|---|
| 42 | Specifies the last page to scan.
|
|---|
| 43 |
|
|---|
| 44 | -j Normally, all images are written as PBM (for monochrome images),
|
|---|
| 45 | PGM (for grayscale images), or PPM (for color images) files.
|
|---|
| 46 | With this option, images in DCT format are saved as JPEG files.
|
|---|
| 47 | All non-DCT images are saved in PBM/PGM/PPM format as usual.
|
|---|
| 48 | (Inline images are always saved in PBM/PGM/PPM format.)
|
|---|
| 49 |
|
|---|
| 50 | -raw Write all images in PDF-native formats. Most of the formats are
|
|---|
| 51 | not standard image formats, so this option is primarily useful
|
|---|
| 52 | as input to a tool that generates PDF files. (Inline images are
|
|---|
| 53 | always saved in PBM/PGM/PPM format.)
|
|---|
| 54 |
|
|---|
| 55 | -list Write a one-line summary to stdout for each image. The summary
|
|---|
| 56 | provides the image file name, the page number, the image width
|
|---|
| 57 | and height, the horizontal and vertical resolution (DPI) as
|
|---|
| 58 | drawn, the color space type, and the number of bits per compo-
|
|---|
| 59 | nent (BPC).
|
|---|
| 60 |
|
|---|
| 61 | -opw password
|
|---|
| 62 | Specify the owner password for the PDF file. Providing this
|
|---|
| 63 | will bypass all security restrictions.
|
|---|
| 64 |
|
|---|
| 65 | -upw password
|
|---|
| 66 | Specify the user password for the PDF file.
|
|---|
| 67 |
|
|---|
| 68 | -q Don't print any messages or errors. [config file: errQuiet]
|
|---|
| 69 |
|
|---|
| 70 | -v Print copyright and version information.
|
|---|
| 71 |
|
|---|
| 72 | -h Print usage information. (-help and --help are equivalent.)
|
|---|
| 73 |
|
|---|
| 74 | EXIT CODES
|
|---|
| 75 | The Xpdf tools use the following exit codes:
|
|---|
| 76 |
|
|---|
| 77 | 0 No error.
|
|---|
| 78 |
|
|---|
| 79 | 1 Error opening a PDF file.
|
|---|
| 80 |
|
|---|
| 81 | 2 Error opening an output file.
|
|---|
| 82 |
|
|---|
| 83 | 3 Error related to PDF permissions.
|
|---|
| 84 |
|
|---|
| 85 | 99 Other error.
|
|---|
| 86 |
|
|---|
| 87 | AUTHOR
|
|---|
| 88 | The pdfimages software and documentation are copyright 1998-2017 Glyph
|
|---|
| 89 | & Cog, LLC.
|
|---|
| 90 |
|
|---|
| 91 | SEE ALSO
|
|---|
| 92 | xpdf(1), pdftops(1), pdftotext(1), pdftohtml(1), pdfinfo(1), pdf-
|
|---|
| 93 | fonts(1), pdfdetach(1), pdftoppm(1), pdftopng(1), xpdfrc(5)
|
|---|
| 94 | http://www.xpdfreader.com/
|
|---|
| 95 |
|
|---|
| 96 |
|
|---|
| 97 |
|
|---|
| 98 | 10 Aug 2017 pdfimages(1)
|
|---|
