Manual: pdftoppm

pdftoppm(1)					   General Commands Manual					 pdftoppm(1)

NAME
       pdftoppm - Portable Document Format (PDF) to Portable Pixmap (PPM) converter (version 3.03)

SYNOPSIS
       pdftoppm [options] PDF-file PPM-root

DESCRIPTION
       Pdftoppm	 converts  Portable  Document  Format  (PDF)  files  to	 color	image files in Portable Pixmap (PPM) format,
       grayscale image files in Portable Graymap (PGM) format, or monochrome image files in Portable Bitmap (PBM) format.

       Pdftoppm reads the PDF file, PDF-file, and writes one PPM file for each page, PPM-root-number.ppm,  where  number  is
       the page number.	 If PDF-file is ´-', it reads the PDF file from stdin.

OPTIONS
       -f number
	      Specifies the first page to convert.

       -l number
	      Specifies the last page to convert.

       -o     Generates only the odd numbered pages.

       -e     Generates only the even numbered pages.

       -singlefile
	      Writes only the first page and does not add digits.

       -r number
	      Specifies the X and Y resolution, in DPI.	 The default is 150 DPI.

       -rx number
	      Specifies the X resolution, in DPI.  The default is 150 DPI.

       -ry number
	      Specifies the Y resolution, in DPI.  The default is 150 DPI.

       -scale-to number
	      Scales  the  long	 side of each page (width for landscape pages, height for portrait pages) to fit in scale-to
	      pixels. The size of the short side will be determined by the aspect ratio of the page.

       -scale-to-x number
	      Scales each page horizontally to fit in scale-to-x pixels. If scale-to-y is set to -1, the vertical size	will
	      determined by the aspect ratio of the page.

       -scale-to-y number
	      Scales  each page vertically to fit in scale-to-y pixels. If scale-to-x is set to -1, the horizontal size will
	      determined by the aspect ratio of the page.

       -scale-dimension-before-rotation
	      Swaps horizontal and vertical size for a rotated (landscape) pdf before scaling instead of after.

       -x number
	      Specifies the x-coordinate of the crop area top left corner

       -y number
	      Specifies the y-coordinate of the crop area top left corner

       -W number
	      Specifies the width of crop area in pixels (default is 0)

       -H number
	      Specifies the height of crop area in pixels (default is 0)

       -sz number
	      Specifies the size of crop square in pixels (sets W and H)

       -cropbox
	      Uses the crop box rather than media box when generating the files

       -hide-annotations
	      Do not show annotations

       -mono  Generate a monochrome PBM file (instead of a color PPM file).

       -gray  Generate a grayscale PGM file (instead of a color PPM file).

       -displayprofile displayprofilefile
	      If poppler is compiled with colour management support, this option sets the display profile to the ICC profile
	      stored in displayprofilefile.

       -defaultgrayprofile defaultgrayprofilefile
	      If poppler is compiled with colour management support, this option sets the DefaultGray color space to the ICC
	      profile stored in defaultgrayprofilefile.

       -defaultrgbprofile defaultrgbprofilefile
	      If poppler is compiled with colour management support, this option sets the DefaultRGB color space to the	 ICC
	      profile stored in defaultrgbprofilefile.

       -defaultcmykprofile defaultcmykprofilefile
	      If poppler is compiled with colour management support, this option sets the DefaultCMYK color space to the ICC
	      profile stored in defaultcmykprofilefile.

       -png   Generates a PNG file instead a PPM file.

       -jpeg  Generates a JPEG file instead a PPM file.

       -jpegopt jpeg-options
	      When used with -jpeg, takes a list of options to control the jpeg compression. See JPEG OPTIONS for the avail‐
	      able options.

       -tiff  Generates a TIFF file instead a PPM file.

       -tiffcompression none | packbits | jpeg | lzw | deflate
	      Specifies the TIFF compression type.  This defaults to "none".

       -freetype yes | no
	      Enable or disable FreeType (a TrueType / Type 1 font rasterizer).	 This defaults to "yes".

       -thinlinemode none | solid | shape
	      Specifies the thin line mode. This defaults to "none".

       "solid":
	      adjust lines with a width less than one pixel to pixel boundary and paint it with a width of one pixel.

       "shape":
	      adjust  lines  with  a  width less than one pixel to pixel boundary and paint it with a width of one pixel but
	      with a shape in proportion to its width.

       -aa yes | no
	      Enable or disable font anti-aliasing.  This defaults to "yes".

       -aaVector yes | no
	      Enable or disable vector anti-aliasing.  This defaults to "yes".

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

       -q     Don't print any messages or errors.

       -progress
	      Print progress info as each page is generated.  Three space-separated fields are printed to STDERR: the number
	      of the current page, the number of the last page that will be generated, and the path to the file written to.

       -sep char
	      Specify single character separator between name and page number, default - .

       -forcenum
	      Force page number even if there is only one page.

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

JPEG OPTIONS
       When JPEG output is specified, the -jpegopt option can be used to control the JPEG compression parameters.  It  takes
       a string of the form "=[,=]". Currently the available options are:

       quality
	      Selects the JPEG quality value. The value must be an integer between 0 and 100.

       progressive
	      Select progressive JPEG output. The possible values are "y", "n", indicating progressive (yes) or non-progres‐
	      sive (no), respectively.

       optimize
	      Sets whether to compute optimal Huffman coding tables for the JPEG output, which will create smaller files but
	      make  an	extra  pass over the data. The value must be "y" or "n", with "y" performing optimization, otherwise
	      the default Huffman tables are used.

AUTHOR
       The pdftoppm software and documentation are copyright 1996-2011 Glyph & Cog, LLC.

SEE ALSO
       pdfdetach(1), pdffonts(1), pdfimages(1), pdfinfo(1), pdftocairo(1), pdftohtml(1), pdftops(1),  pdftotext(1)  pdfsepa‐
       rate(1), pdfsig(1), pdfunite(1)

						       15 August 2011						 pdftoppm(1)