OS Manuals

/usr/bin/pdftocairo

From poppler-utils 26.11.0-r0 (os), captured 2026-11-06 by running pdftocairo --help (exit 0). permalink

pdftocairo version 26.11.0
Copyright 2005-2026 The Poppler Developers - http://poppler.freedesktop.org
Copyright 1996-2011, 2022 Glyph & Cog, LLC
Usage: pdftocairo [options] <PDF-file> [<output-file>]
  -png                     : generate a PNG file
  -jpeg                    : generate a JPEG file
  -jpegopt <string>        : jpeg options, with format <opt1>=<val1>[,<optN>=<valN>]*
  -tiff                    : generate a TIFF file
  -tiffcompression <string>: set TIFF compression: none, packbits, jpeg, lzw, deflate
  -ps                      : generate PostScript file
  -eps                     : generate Encapsulated PostScript (EPS)
  -pdf                     : generate a PDF file
  -svg                     : generate a Scalable Vector Graphics (SVG) file
  -f <int>                 : first page to print
  -l <int>                 : last page to print
  -o                       : print only odd pages
  -e                       : print only even pages
  -singlefile              : write only the first page and do not add digits
  -r <fp>                  : resolution, in PPI (default is 150)
  -rx <fp>                 : X resolution, in PPI (default is 150)
  -ry <fp>                 : Y resolution, in PPI (default is 150)
  -scale-to <int>          : scales each page to fit within scale-to*scale-to pixel box
  -scale-to-x <int>        : scales each page horizontally to fit in scale-to-x pixels
  -scale-to-y <int>        : scales each page vertically to fit in scale-to-y pixels
  -x <int>                 : x-coordinate of the crop area top left corner
  -y <int>                 : y-coordinate of the crop area top left corner
  -W <int>                 : width of crop area in pixels (default is 0)
  -H <int>                 : height of crop area in pixels (default is 0)
  -sz <int>                : size of crop square in pixels (sets W and H)
  -cropbox                 : use the crop box rather than media box
  -mono                    : generate a monochrome image file (PNG, JPEG)
  -gray                    : generate a grayscale image file (PNG, JPEG)
  -transp                  : use a transparent background instead of white (PNG)
  -antialias <string>      : set cairo antialias option
  -icc <string>            : ICC color profile to use
  -level2                  : generate Level 2 PostScript (PS, EPS)
  -level3                  : generate Level 3 PostScript (PS, EPS)
  -origpagesizes           : conserve original page sizes (PS, PDF, SVG)
  -paper <string>          : paper size (letter, legal, A4, A3, match)
  -paperw <int>            : paper width, in points
  -paperh <int>            : paper height, in points
  -nocrop                  : don't crop pages to CropBox
  -expand                  : expand pages smaller than the paper size
  -noshrink                : don't shrink pages larger than the paper size
  -nocenter                : don't center pages smaller than the paper size
  -duplex                  : enable duplex printing
  -struct                  : enable logical document structure
  -opw <string>            : owner password (for encrypted files)
  -upw <string>            : user password (for encrypted files)
  -q                       : don't print any messages or errors
  -v                       : print copyright and version info
  -h                       : print usage information
  -help                    : print usage information
  --help                   : print usage information
  -?                       : print usage information
Options (55)
OptionDescriptionSource
-pngGenerates a PNG file(s)help + man
-jpegGenerates a JPEG file(s).help + man
-jpegopt stringWhen used with -jpeg, takes a list of options to control the jpeg compression.help + man
-tiffGenerates a TIFF file(s)help + man
-ps: generate PostScript filehelp + man
-eps: generate Encapsulated PostScript (EPS)help + man
-pdf: generate a PDF filehelp + man
-svg: generate a Scalable Vector Graphics (SVG) filehelp + man
-f intSpecifies the first page to convert.help + man
-l intSpecifies the last page to convert.help + man
-oGenerates only the odd numbered pages.help + man
-eGenerates only the even numbered pages.help + man
-singlefileWrites only the first page and does not add digits.help + man
-r fpSpecifies the X and Y resolution, in pixels per inch of image files (or rasterized regions in vector output).help + man
-rx fpSpecifies the X resolution, in pixels per inch of image files (or rasterized regions in vector output).help + man
-ry fpSpecifies the Y resolution, in pixels per inch of image files (or rasterized regions in vector output).help + man
-scale-to intScales the long side of each page (width for landscape pages, height for portrait pages) to fit in scale-to pixels.help + man
-scale-to-x int: scales each page horizontally to fit in scale-to-x pixelshelp + man
-scale-to-y int: scales each page vertically to fit in scale-to-y pixelshelp + man
-x intSpecifies the x-coordinate of the crop area top left corner in pixels (image output) or points (vector output)help + man
-y intSpecifies the y-coordinate of the crop area top left corner in pixels (image output) or points (vector output)help + man
-W intSpecifies the width of crop area in pixels (image output) or points (vector output) (default is 0)help + man
-H intSpecifies the height of crop area in pixels (image output) or points (vector output) (default is 0)help + man
-sz intSpecifies the size of crop square in pixels (image output) or points (vector output) (sets -W and -H)help + man
-cropboxUses the crop box rather than media box when generating the files (PNG/JPEG/TIFF only)help + man
-monoGenerate a monochrome file (PNG and TIFF only).help + man
-grayGenerate a grayscale file (PNG, JPEG, and TIFF only).help + man
-transpUse a transparent page color instead of white (PNG and TIFF only).help + man
-antialias stringSet the cairo antialias option used for text and drawing in image files (or rasterized regions in vector output).help + man
-icc stringUse the specified ICC file as the output profile (PNG only).help + man
-level2: generate Level 2 PostScript (PS, EPS)help + man
-level3: generate Level 3 PostScript (PS, EPS)help + man
-origpagesizes: conserve original page sizes (PS, PDF, SVG)help + man
-paper stringSet the paper size to one of "letter", "legal", "A4", or "A3" (PS,PDF,SVG only).help + man
-paperw intSet the paper width, in points (PS,PDF,SVG only).help + man
-paperh intSet the paper height, in points (PS,PDF,SVG only).help + man
-nocropBy default, printing output is cropped to the CropBox specified in the PDF file.help + man
-expandExpand PDF pages smaller than the paper to fill the paper (PS,PDF,SVG only).help + man
-noshrinkDon't scale PDF pages which are larger than the paper (PS,PDF,SVG only).help + man
-nocenterBy default, PDF pages smaller than the paper (after any scaling) are centered on the paper.help + man
-duplexAdds the %%IncludeFeature: Duplex DuplexNoTumble DSC comment to the PostScript file (PS only).help + man
-structIf the input file contains structural information about the document's content, write this information to the output file (PDF only).help + man
-opw stringSpecify the owner password for the PDF file.help + man
-upw stringSpecify the user password for the PDF file.help + man
-q: don't print any messages or errorshelp + man
-vPrint copyright and version information.help + man
-h: print usage informationhelp + man
-help: print usage informationhelp
--help: print usage informationhelp
-?: print usage informationhelp
-print(Windows only) Prints to a system printer. (in the manual page but not in --help)man
-printdlg(Windows only) Prints to a system printer. (in the manual page but not in --help)man
-printer printer-name(Windows only). (in the manual page but not in --help)man
-printopt printer-options(Windows only). (in the manual page but not in --help)man
-setupdlg(Windows only). (in the manual page but not in --help)man
Exit status (6) from the manual page
0No error.
1Error opening a PDF file.
2Error opening an output file.
3Error related to PDF permissions.
4Error related to ICC profile.
99Other error.

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.