root/main/trunk/binaries/windows/bin/xpdf-tools/doc/pdfimages.txt @ 32207

Revision 32207, 3.7 KB (checked in by ak19, 16 months ago)

Got a basic Windows version of PDFPlugin's new paged_html mode working

Line 
1pdfimages(1)                General Commands Manual               pdfimages(1)
2
3
4
5NAME
6       pdfimages  -  Portable  Document  Format (PDF) image extractor (version
7       4.00)
8
9SYNOPSIS
10       pdfimages [options] PDF-file image-root
11
12DESCRIPTION
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
26CONFIGURATION 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
33OPTIONS
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
74EXIT 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
87AUTHOR
88       The  pdfimages software and documentation are copyright 1998-2017 Glyph
89       & Cog, LLC.
90
91SEE 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)
Note: See TracBrowser for help on using the browser.