Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
pdfimages(1)		    General Commands Manual		  pdfimages(1)

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

       pdfimages [options] PDF-file image-root

       Pdfimages saves images from a Portable Document Format  (PDF)  file  as
       Portable	Pixmap (PPM), Portable Bitmap (PBM), Portable Network Graphics
       (PNG), Tagged Image File	Format (TIFF), JPEG, JPEG2000, or JBIG2	files.

       Pdfimages reads the PDF file PDF-file, scans one	 or  more  pages,  and
       writes  one  file  for each image,, where nnn	is the
       image number and	xxx is the image type (.ppm, .pbm, .png,  .tif,	 .jpg,
       jp2, jb2e, or jb2g).

       The  default  output  format  is	PBM (for monochrome images) or PPM for
       non-monochrome. The -png	or -tiff options change	to default  output  to
       PNG  or	TIFF  respectively. If both -png and -tiff are specified, CMYK
       images will be written as TIFF and all other images will	be written  as
       PNG.  In	 addition  the	-j,  -jp2, and -jbig2 options will cause JPEG,
       JPEG2000, and JBIG2, respectively, images in the	PDF file to be written
       in their	native format.

       -f number
	      Specifies	the first page to scan.

       -l number
	      Specifies	the last page to scan.

       -png   Change the default output	format to PNG.

       -tiff  Change the default output	format to TIFF.

       -j     Write images in JPEG format as JPEG files	instead	of the default
	      format. The JPEG file is identical to the	JPEG  data  stored  in
	      the PDF.

       -jp2   Write  images in JPEG2000	format as JP2 files instead of the de-
	      fault format. The	JP2 file is identical  to  the	JPEG2000  data
	      stored in	the PDF.

       -jbig2 Write  images  in	JBIG2 format as	JBIG2 files instead of the de-
	      fault format. JBIG2 data in PDF is of the	embedded type. The em-
	      bedded  type  of	JBIG2 has an optional separate file containing
	      global data. The embedded	data is	 written  with	the  extension
	      .jb2e  and the global data (if available)	will be	written	to the
	      same image number	with the extension .jb2g. The content of  both
	      these files is identical to the JBIG2 data in the	PDF.

       -ccitt Write  images  in	CCITT format as	CCITT files instead of the de-
	      fault format. The	CCITT file is  identical  to  the  CCITT  data
	      stored in	the PDF. PDF files contain additional parameters spec-
	      ifying how to decode the CCITT data. These parameters are	trans-
	      lated  to	 fax2tiff  input options and written to	a .params file
	      with the same image number. The parameters are:

	      -1     1D	Group 3	encoding

	      -2     2D	Group 3	encoding

	      -4     Group 4 encoding

	      -A     Beginning of line is aligned on a byte boundary

	      -P     Beginning of line is not aligned on a byte	boundary

	      -X n   The image width in	pixels

	      -W     Encoding uses 1 for black and 0 for white

	      -B     Encoding uses 0 for black and 1 for white

	      -M     Input data	fills from most	significant bit	to least  sig-
		     nificant bit.

       -all   Write  JPEG,  JPEG2000,  JBIG2, and CCITT	images in their	native
	      format. CMYK files are written as	TIFF files. All	 other	images
	      are  written as PNG files.  This is equivalent to	specifying the
	      options -png -tiff -j -jp2 -jbig2	-ccitt.

       -list  Instead of writing the images, list the images along with	 vari-
	      ous  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 sepa-
	      rate 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	 scal-
		     ing up the	image

	      object ID
		     the image dictionary object ID (number and	generation)

	      x-ppi  The  horizontal  resolution  of  the image	(in pixels per
		     inch) when	rendered on the	pdf page.

	      y-ppi  The vertical resolution of	the image (in pixels per inch)
		     when rendered on the pdf page.

	      size   The  size of the embedded image in	the pdf	file. The fol-
		     lowing suffixes are used: 'B' bytes, 'K'  kilobytes,  'M'
		     megabytes,	and 'G'	gigabytes.

	      ratio  The compression ratio of the embedded image.

       -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.)

       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.

       The pdfimages software and documentation	are copyright 1998-2011	 Glyph
       & Cog, LLC.

       pdfdetach(1),  pdffonts(1),  pdfinfo(1),	 pdftocairo(1),	 pdftohtml(1),
       pdftoppm(1), pdftops(1),	pdftotext(1) pdfseparate(1), pdfsig(1),	 pdfu-

				15 August 2011			  pdfimages(1)


Want to link to this manual page? Use this URL:

home | help