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.

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&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help