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

FreeBSD Manual Pages

  
 
  

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

NAME
       pdftocairo      -     Portable	  Document     Format	  (PDF)	    to
       PNG/JPEG/TIFF/PDF/PS/EPS/SVG using cairo

SYNOPSIS
       pdftocairo [options] PDF-file [output-file]

DESCRIPTION
       pdftocairo converts Portable Document Format  (PDF)  files,  using  the
       cairo output device of the poppler PDF library, to any of the following
       output formats:

       o      Portable Network Graphics	(PNG)

       o      JPEG Interchange Format (JPEG)

       o      Tagged Image File	Format (TIFF)

       o      Portable Document	Format (PDF)

       o      PostScript (PS)

       o      Encapsulated PostScript (EPS)

       o      Scalable Vector Graphics (SVG)

       o      Windows Printer

       pdftocairo reads	the PDF	file, PDF-file,	 and  writes  to  output-file.
       The image formats (PNG, JPEG, and TIFF) generate	one file per page with
       the page	number and file	type appended to output-file.  qWhen  -single-
       file  is	used with the image formats, the file type is appended to out-
       put-file.  When the output format is a vector format (PDF, PS, EPS, and
       SVG), output-file is the	full filename.

       If  the	PDF-file  is "-" , the PDF is read from	stdin.	If the output-
       file is "-" , the output	file will be written to	stdout.	 Using	stdout
       is not valid with image formats unless -singlefile is used.  If output-
       file is not used, the output filename will be derived from the PDF-file
       filename.

       Not  all	 options are valid with	all output formats. One	(and only one)
       of the output format options (-png, -jpeg, -tiff,  -pdf,	 -print,  -ps,
       -eps, or	-svg) must be used.

       The  resolution	options	(-r, -rx, -ry) set the resolution of the image
       output formats. The image dimensions will depend	on the PDF  page  size
       and  the	 resolution.  For the vector outputs, regions of the page that
       can not be represented natively in the output format  (eg  translucency
       in PS) will be rasterized at the	resolution specified by	the resolution
       options.

       The -scale-to options may be used to set	a fixed	image size. The	 image
       resolution will vary with the page size.

       The  cropping options (-x, -y, -W, and -H) use units of pixels with the
       image formats and PostScript points (1/72 inch) with  the  vector  for-
       mats.  When  cropping  is used with vector output the cropped region is
       centered	unless -nocenter is used in which case the cropped  region  is
       at the top left (SVG) or	bottom left (PDF, PS, EPS).

OPTIONS
       -png   Generates	a PNG file(s)

       -jpeg  Generates	a JPEG file(s)

       -tiff  Generates	a TIFF file(s)

       -pdf   Generates	a PDF file

       -ps    Generate a PS file

       -eps   Generate an EPS file. An EPS file	contains a single image, so if
	      you use this option with a multi-page PDF	file, you must use  -f
	      and  -l to specify a single page.	 The page size options (-orig-
	      pagesizes, -paper, -paperw, -paperh) can not be used  with  this
	      option.

       -svg   Generate a SVG (Scalable Vector Graphics)	file

       -print (Windows only) Prints to a system	printer. See also -printer and
	      -printeropt.
	       If an output file is not	specified, the output will be sent  to
	      the printer.
	       The output file '-' can not be used with	this option.

       -printdlg
	      (Windows	only)  Prints  to a system printer. Displays the print
	      dialog to	allow the print	options	to be modified	before	print-
	      ing.

       -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 pixels per inch of image
	      files (or	rasterized regions in vector output). The  default  is
	      150 PPI.

       -rx number
	      Specifies	 the  X	 resolution, in	pixels per inch	of image files
	      (or rasterized regions in	vector output).	 The  default  is  150
	      PPI.

       -ry number
	      Specifies	 the  Y	 resolution, in	pixels per inch	of image files
	      (or rasterized regions in	vector output).	 The  default  is  150
	      PPI.

       -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 (PNG/JPEG/TIFF only).

       -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 (PNG/JPEG/TIFF only).

       -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 (PNG/JPEG/TIFF only).

       -x number
	      Specifies	the x-coordinate of the	crop area top left  corner  in
	      pixels (image output) or points (vector output)

       -y number
	      Specifies	 the  y-coordinate of the crop area top	left corner in
	      pixels (image output) or points (vector output)

       -W number
	      Specifies	the width of crop area in  pixels  (image  output)  or
	      points (vector output)  (default is 0)

       -H number
	      Specifies	 the  height  of crop area in pixels (image output) or
	      points (vector output)  (default is 0)

       -sz number
	      Specifies	the size of crop square	in pixels  (image  output)  or
	      points (vector output)  (sets -W and -H)

       -cropbox
	      Uses  the	 crop  box  rather  than media box when	generating the
	      files (PNG/JPEG/TIFF only)

       -mono  Generate a monochrome file (PNG and TIFF only).

       -gray  Generate a grayscale file	(PNG, JPEG, and	TIFF only).

       -antialias
	      Set the cairo antialias option used for text and drawing in  im-
	      age  files (or rasterized	regions	in vector output). The options
	      are:

	      default
		     Use the default antialiasing for the target device.  This
		     is	the default setting if -antialias is not used.

	      none   Antialiasing is disabled.

	      gray   Perform single-color antialiasing using shades of gray.

	      subpixel
		     Perform  antialiasing by taking advantage of the order of
		     subpixel elements on devices such as LCD.

	      fast   Hint that the backend should  perform  some  antialiasing
		     but prefer	speed over quality.

	      good   The backend should	balance	quality	against	performance.

	      best   Hint  that	the backend should render at the highest qual-
		     ity, sacrificing speed if necessary.

       -transp
	      Use a transparent	page color instead  of	white  (PNG  and  TIFF
	      only).

       -icc icc-file
	      Use the specified	ICC file as the	output profile (PNG only). The
	      profile will be embedded in the PNG file.

       -level2
	      Generate Level 2 PostScript (PS only).

       -level3
	      Generate Level 3 PostScript (PS only). This enables all Level  2
	      features	plus  shading  patterns	and masked images. This	is the
	      default setting.

       -origpagesizes
	      This option is the same as "-paper match".

       -paper size
	      Set the paper size to one	of "letter", "legal",  "A4",  or  "A3"
	      (PS,PDF,SVG  only).  This	can also be set	to "match", which will
	      set the paper size of each page to match the size	 specified  in
	      the  PDF	file.  If none the -paper, -paperw, or -paperh options
	      are specified the	default	is to match the	paper size.

       -paperw size
	      Set the paper width, in points (PS,PDF,SVG only).

       -paperh size
	      Set the paper height, in points (PS,PDF,SVG only).

       -nocrop
	      By default, printing output is cropped to	the CropBox  specified
	      in  the  PDF  file.   This  option disables cropping (PS,PDF,SVG
	      only).

       -expand
	      Expand PDF pages smaller	than  the  paper  to  fill  the	 paper
	      (PS,PDF,SVG only).  By default, these pages are not scaled.

       -noshrink
	      Don't   scale   PDF  pages  which	 are  larger  than  the	 paper
	      (PS,PDF,SVG only).  By default, pages larger than	the paper  are
	      shrunk to	fit.

       -nocenter
	      By default, PDF pages smaller than the paper (after any scaling)
	      are centered on the  paper.   This  option  causes  them	to  be
	      aligned	to   the   lower-left  corner  of  the	paper  instead
	      (PS,PDF,SVG only).

       -duplex
	      Adds the %%IncludeFeature: *Duplex DuplexNoTumble	DSC comment to
	      the  PostScript file (PS only).  This tells the print manager to
	      enable duplexing.

       -printer	printer-name
	      (Windows only). When used	with -print, specifies the name	of the
	      printer to be used, instead of the system	default.

       -printopt printer-options
	      (Windows	only).	When used with -print, takes a list of options
	      to be used to configure the printer. See WINDOWS PRINTER OPTIONS
	      for the available	options.

       -setupdlg
	      (Windows	only).	When  used with	-print,	the printer properties
	      dialog is	displayed allowing the print settings to  be  modified
	      before printing. The paper size selected in the print properties
	      dialog will be used except when -origpagesizes is	specified.

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

       -v     Print copyright and version information.

       -h     Print usage information.	(-help and --help are equivalent.)

EXIT CODES
       The poppler 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.

       4      Error related to ICC profile.

       99     Other error.

WINDOWS	PRINTER	OPTIONS
       In Windows, you can use the -print option to print directly to a	system
       printer.	Additionally, you can use the -printopt	 option	 to  configure
       the printer. It takes a string of the form "<opt>=<val>[,<opt>=<val>]".
       Currently the available options are:

       source Selects the source paper tray to be  used	 (bin).	 The  possible
	      values are "upper", "onlyone", "lower", "middle",	"manual", "en-
	      velope", "envmanual", "auto", "tractor", "smallfmt", "largefmt",
	      "largecapacity",	"formsource",  or  a numeric value to choose a
	      driver specific source.

       duplex Sets the duplex mode of the printer.  The	 possible  values  are
	      "off",  "short"  or  "long", indicating no duplexing, short-edge
	      binding, or long-edge  binding,  respectively.   General	option
	      -duplex is a synonym of "duplex=long". If	both options are spec-
	      ified, -printopt has priority.

AUTHOR
       The pdftocairo software and documentation are copyright 1996-2004 Glyph
       & Cog, LLC and copyright	2005-2011 The Poppler Developers.

SEE ALSO
       pdfdetach(1),   pdffonts(1),  pdfimages(1),  pdfinfo(1),	 pdftohtml(1),
       pdftoppm(1), pdftops(1),	pdftotext(1) pdfseparate(1), pdfsig(1),	 pdfu-
       nite(1)

								 pdftocairo(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT CODES | WINDOWS PRINTER OPTIONS | AUTHOR | SEE ALSO

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

home | help