Provided by: poppler-utils_0.86.1-0ubuntu1.4_amd64 bug

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:

       •      Portable Network Graphics (PNG)

       •      JPEG Interchange Format (JPEG)

       •      Tagged Image File Format (TIFF)

       •      Portable Document Format (PDF)

       •      PostScript (PS)

       •      Encapsulated PostScript (EPS)

       •      Scalable Vector Graphics (SVG)

       •      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.  When -singlefile is used with the image formats, the  file  type
       is  appended to output-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 formats. 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). See also -jpegopt.

       -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 (-origpagesizes, -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 printing.

       -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 image 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 quality, 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.

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

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

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 "<opt>=<val>[,<opt>=<val>]".
       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-progressive (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.

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", "envelope", "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 specified, -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), pdfunite(1)

                                                                                    pdftocairo(1)