OS Manuals

/usr/bin/pdftops

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

pdftops version 26.11.0
Copyright 2005-2026 The Poppler Developers - http://poppler.freedesktop.org
Copyright 1996-2011, 2022 Glyph & Cog, LLC
Usage: pdftops [options] <PDF-file> [<PS-file>]
  -f <int>                       : first page to print
  -l <int>                       : last page to print
  -level1                        : generate Level 1 PostScript
  -level1sep                     : generate Level 1 separable PostScript
  -level2                        : generate Level 2 PostScript
  -level2sep                     : generate Level 2 separable PostScript
  -level3                        : generate Level 3 PostScript
  -level3sep                     : generate Level 3 separable PostScript
  -origpagesizes                 : conserve original page sizes
  -eps                           : generate Encapsulated PostScript (EPS)
  -form                          : generate a PostScript form
  -opi                           : generate OPI comments
  -r <int>                       : resolution for rasterization, in DPI (default is 300)
  -binary                        : write binary data in Level 1 PostScript
  -noembt1                       : don't embed Type 1 fonts
  -noembtt                       : don't embed TrueType fonts
  -noembcidps                    : don't embed CID PostScript fonts
  -noembcidtt                    : don't embed CID TrueType fonts
  -passfonts                     : don't substitute missing fonts
  -aaRaster <string>             : enable anti-aliasing on rasterization: yes, no
  -rasterize <string>            : control rasterization: always, never, whenneeded
  -processcolorformat <string>   : color format that is used during rasterization and transparency reduction: MONO8, RGB8, CMYK8
  -processcolorprofile <string>  : ICC color profile to use as the process color profile during rasterization and transparency reduction
  -defaultgrayprofile <string>   : ICC color profile to use as the DefaultGray color space
  -defaultrgbprofile <string>    : ICC color profile to use as the DefaultRGB color space
  -defaultcmykprofile <string>   : ICC color profile to use as the DefaultCMYK color space
  -optimizecolorspace            : convert gray RGB images to gray color space
  -passlevel1customcolor         : pass custom color in level1sep
  -preload                       : preload images and forms
  -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
  -opw <string>                  : owner password (for encrypted files)
  -upw <string>                  : user password (for encrypted files)
  -overprint                     : enable overprint emulation during rasterization
  -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 (46)
OptionDescriptionSource
-f intSpecifies the first page to print.help + man
-l intSpecifies the last page to print.help + man
-level1: generate Level 1 PostScripthelp + man
-level1sep: generate Level 1 separable PostScripthelp + man
-level2: generate Level 2 PostScripthelp + man
-level2sep: generate Level 2 separable PostScripthelp + man
-level3: generate Level 3 PostScripthelp + man
-level3sep: generate Level 3 separable PostScripthelp + man
-origpagesizesThis option is the same as "-paper match".help + man
-epsGenerate an Encapsulated PostScript (EPS) file.help + man
-formGenerate a PostScript form which can be imported by software that understands forms.help + man
-opiGenerate OPI comments for all images and forms which have OPI information.help + man
-r intSet the resolution in DPI when pdftops rasterizes images with transparencies or, for Level 1 PostScript, when pdftops rasterizes images with color masks.help + man
-binary: write binary data in Level 1 PostScripthelp + man
-noembt1By default, any Type 1 fonts which are embedded in the PDF file are copied into the PostScript file.help + man
-noembttBy default, any TrueType fonts which are embedded in the PDF file are copied into the PostScript file.help + man
-noembcidpsBy default, any CID PostScript fonts which are embedded in the PDF file are copied into the PostScript file.help + man
-noembcidttBy default, any CID TrueType fonts which are embedded in the PDF file are copied into the PostScript file.help + man
-passfontsBy default, references to non-embedded 8-bit fonts in the PDF file are substituted with the closest "Helvetica", "Times-Roman", or "Courier" font.help + man
-aaRaster string: enable anti-aliasing on rasterization: yes, nohelp + man
-rasterize stringBy default, pdftops rasterizes pages as needed, for example, if they contain transparencies.help + man
-processcolorformat string: color format that is used during rasterization and transparency reduction: MONO8, RGB8, CMYK8help + man
-processcolorprofile string: ICC color profile to use as the process color profile during rasterization and transparency reductionhelp + man
-defaultgrayprofile stringIf poppler is compiled with colour management support, this option sets the DefaultGray color space to the ICC profile stored in defaultgrayprofilefile.help + man
-defaultrgbprofile stringIf poppler is compiled with colour management support, this option sets the DefaultRGB color space to the ICC profile stored in defaultrgbprofilefile.help + man
-defaultcmykprofile stringIf poppler is compiled with colour management support, this option sets the DefaultCMYK color space to the ICC profile stored in defaultcmykprofilefile.help + man
-optimizecolorspaceBy default, bitmap images in the PDF pass through to the output PostScript in their original color space, which produces predictable results.help + man
-passlevel1customcolor: pass custom color in level1sephelp
-preload: preload images and formshelp + man
-paper stringSet the paper size to one of "letter", "legal", "A4", or "A3".help + man
-paperw intSet the paper width, in points.help + man
-paperh intSet the paper height, in points.help + man
-nocropBy default, output is cropped to the CropBox specified in the PDF file.help + man
-expandExpand PDF pages smaller than the paper to fill the paper.help + man
-noshrinkDon't scale PDF pages which are larger than the paper.help + man
-nocenterBy default, PDF pages smaller than the paper (after any scaling) are centered on the paper.help + man
-duplexSet the Duplex pagedevice entry in the PostScript file.help + man
-opw stringSpecify the owner password for the PDF file.help + man
-upw stringSpecify the user password for the PDF file.help + man
-overprint: enable overprint emulation during rasterizationhelp + 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
Exit status (5) from the manual page
0No error.
1Error opening a PDF file.
2Error opening an output file.
3Error related to PDF permissions.
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.