apdf/doc/pdfimages.cat

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