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

FreeBSD Manual Pages

  
 
  

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

NAME
       pdftoppm	- Portable Document Format (PDF) to Portable Pixmap (PPM) con-
       verter (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	Porta-
       ble 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 op-
	      tion sets	the display profile to the ICC profile stored in  dis-
	      playprofilefile.

       -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 available 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  raster-
	      izer).  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 pro-
	      portion 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.

       -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  con-
       trol  the  JPEG	compression parameters.	 It takes a string of the form
       "<opt>=<val>[,<opt>=<val>]". Currently the available options are:

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

       progressive
	      Select  progressive  JPEG	 output.  The possible values are "y",
	      "n", indicating progressive (yes)	or non-progressive  (no),  re-
	      spectively.

       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" per-
	      forming 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) pdfseparate(1), pdfsig(1), pdfu-
       nite(1)

				15 August 2011			   pdftoppm(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT CODES | JPEG OPTIONS | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pdftoppm&sektion=1&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help