pdftocairo - Portable Document Format (PDF) to PNG/JPEG/TIFF/PDF/PS/EPS/SVG
using cairo
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.
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).
- -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.)
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.
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.
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),
pdfunite(1)