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: * 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 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)
-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.
-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",
"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)
Opportunity
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.
Education
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.
