/usr/bin/pdftoppm --help — Chainguard OS Manuals

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

pdftoppm version 26.11.0
Copyright 2005-2026 The Poppler Developers - http://poppler.freedesktop.org
Copyright 1996-2011, 2022 Glyph & Cog, LLC
Usage: pdftoppm [options] [PDF-file [PPM-file-prefix]]
  -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
  -scale-dimension-before-rotation         : for rotated pdf, resize dimensions before the rotation
  -r <fp>                                  : resolution, in DPI (default is 150)
  -rx <fp>                                 : X resolution, in DPI (default is 150)
  -ry <fp>                                 : Y resolution, in DPI (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
  -hide-annotations                        : do not show annotations
  -mono                                    : generate a monochrome PBM file
  -gray                                    : generate a grayscale PGM file
  -displayprofile <string>                 : ICC color profile to use as the display profile
  -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
  -sep <string>                            : single character separator between name and page number, default -
  -forcenum                                : force page number even if there is only one page
  -png                                     : generate a PNG file
  -jpeg                                    : generate a JPEG file
  -jpegcmyk                                : generate a CMYK JPEG file
  -jpegopt <string>                        : jpeg options, with format <opt1>=<val1>[,<optN>=<valN>]*
  -overprint                               : enable overprint
  -tiff                                    : generate a TIFF file
  -tiffcompression <string>                : set TIFF compression: none, packbits, jpeg, lzw, deflate
  -freetype <string>                       : enable FreeType font rasterizer: yes, no
  -thinlinemode <string>                   : set thin line mode: none, solid, shape. Default: none
  -aa <string>                             : enable font anti-aliasing: yes, no
  -aaVector <string>                       : enable vector anti-aliasing: yes, no
  -opw <string>                            : owner password (for encrypted files)
  -upw <string>                            : user password (for encrypted files)
  -q                                       : don't print any messages or errors
  -progress                                : print progress info
  -v                                       : print copyright and version info
  -h                                       : print usage information
  -help                                    : print usage information
  --help                                   : print usage information
  -?                                       : print usage information

Options (47)

Option	Description	Source
`-f` int	Specifies the first page to convert.	help + man
`-l` int	Specifies the last page to convert.	help + man
`-o`	Generates only the odd numbered pages.	help + man
`-e`	Generates only the even numbered pages.	help + man
`-singlefile`	Writes only the first page and does not add digits.	help + man
`-scale-dimension-before-rotation`	Swaps horizontal and vertical size for a rotated (landscape) pdf before scaling instead of after.	help + man
`-r` fp	Specifies the X and Y resolution, in DPI.	help + man
`-rx` fp	: X resolution, in DPI (default is 150)	help + man
`-ry` fp	: Y resolution, in DPI (default is 150)	help + man
`-scale-to` int	Scales 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 pixels	help + man
`-scale-to-y` int	: scales each page vertically to fit in scale-to-y pixels	help + man
`-x` int	Specifies the x-coordinate of the crop area top left corner	help + man
`-y` int	Specifies the y-coordinate of the crop area top left corner	help + man
`-W` int	Specifies the width of crop area in pixels (default is 0)	help + man
`-H` int	Specifies the height of crop area in pixels (default is 0)	help + man
`-sz` int	Specifies the size of crop square in pixels (sets W and H)	help + man
`-cropbox`	Uses the crop box rather than media box when generating the files	help + man
`-hide-annotations`	: do not show annotations	help + man
`-mono`	Generate a monochrome PBM file (instead of a color PPM file).	help + man
`-gray`	Generate a grayscale PGM file (instead of a color PPM file).	help + man
`-displayprofile` string	If poppler is compiled with colour management support, this option sets the display profile to the ICC profile stored in displayprofilefile.	help + man
`-defaultgrayprofile` string	If poppler is compiled with colour management support, this option sets the DefaultGray color space to the ICC profile stored in defaultgrayprofilefile.	help + man
`-defaultrgbprofile` string	If poppler is compiled with colour management support, this option sets the DefaultRGB color space to the ICC profile stored in defaultrgbprofilefile.	help + man
`-defaultcmykprofile` string	If poppler is compiled with colour management support, this option sets the DefaultCMYK color space to the ICC profile stored in defaultcmykprofilefile.	help + man
`-sep` string	Specify single character separator between name and page number, default - .	help + man
`-forcenum`	: force page number even if there is only one page	help + man
`-png`	Generates a PNG file instead a PPM file.	help + man
`-jpeg`	Generates a JPEG file instead a PPM file.	help + man
`-jpegcmyk`	: generate a CMYK JPEG file	help
`-jpegopt` string	When used with -jpeg, takes a list of options to control the jpeg compression.	help + man
`-overprint`	: enable overprint	help
`-tiff`	Generates a TIFF file instead a PPM file.	help + man
`-tiffcompression` string	: set TIFF compression: none, packbits, jpeg, lzw, deflate	help + man
`-freetype` string	Enable or disable FreeType (a TrueType / Type 1 font rasterizer).	help + man
`-thinlinemode` string	: set thin line mode: none, solid, shape.	help + man
`-aa` string	Enable or disable font anti-aliasing.	help + man
`-aaVector` string	Enable or disable vector anti-aliasing.	help + man
`-opw` string	Specify the owner password for the PDF file.	help + man
`-upw` string	Specify the user password for the PDF file.	help + man
`-q`	: don't print any messages or errors	help + man
`-progress`	Print progress info as each page is generated.	help + man
`-v`	Print copyright and version information.	help + man
`-h`	: print usage information	help + man
`-help`	: print usage information	help
`--help`	: print usage information	help
`-?`	: print usage information	help

Exit status (5) from the manual page

`0`	No error.
`1`	Error opening a PDF file.
`2`	Error opening an output file.
`3`	Error related to PDF permissions.
`99`	Other 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.