pdftocairo      -     Portable     Document     Format     (PDF)     to


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


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

   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

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


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

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

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

          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

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

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

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

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

                 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.

                 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.

          Use a transparent page color instead  of  white  (PNG  and  TIFF

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

          Generate Level 2 PostScript (PS only).

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

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

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

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

          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.

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

          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.

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


   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.


   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.


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


   pdfdetach(1),   pdffonts(1),  pdfimages(1),  pdfinfo(1),  pdftohtml(1),
   pdftoppm(1),  pdftops(1),   pdftotext(1)   pdfseparate(1),   pdfsig(1),



Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.

Free Software

Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.

Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.

Free Books

The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.

Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.

Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.