Options may start with either "-" or "--", and may be unambiguously abbreviated. It is best to use the
full option name in scripts to avoid possible collisions with new options in the future.
General script options:
--help display help message and exit
--version
display version information and exit
--outfile=file
write result to file. If this option is not given, and --nogs or --filter is specified, write to
standard output; otherwise, the default is to construct the output file name by replacing any
extension in the input file with `.pdf'.
--[no]debug
write debugging info (default: false). For maximum output, use --debug as the first option.
--[no]exact
scan ExactBoundingBox (default: false).
--[no]filter
read standard input and (unless --outfile is given) write standard output (default: false).
--[no]gs
run Ghostscript (default: true). With --nogs, output (to standard output by default) the
PostScript that would normally be converted; that is, the input PostScript as modified by
epstopdf.
--[no]hires
scan HiresBoundingBox (default: false).
--restricted=val
turn on restricted mode (default: [true for repstopdf, else false]); this forbids the use of
--gscmd, among other options, and imposes restrictions on the input and output file names
according to the values of openin_any and openout_any (see the Web2c manual,
https://tug.org/web2c). On Windows, the Ghostscript command is forced to be the TeX Live builtin
gs, installed under .../tlpkg/tlgs/bin/.
Options for Ghostscript (more info below):
--gscmd=val
pipe output to val (default: [gswin64c.exe on 64-bit Windows, gswin32c.exe on 32-bit Windows, else
gs])
--gsopt=val
include val as one argument in the gs command (can be repeated).
--gsopts=val
split val at whitespace and include each resulting word as an argument in the gs command (can be
repeated).
--autorotate=val
set AutoRotatePages (default: None); recognized val choices: None, All, PageByPage. For EPS
files, PageByPage is equivalent to All.
--[no]compress
use compression in the output (default: true); if turned off, passes -dUseFlateCompression=false.
--device=dev
use -sDEVICE=dev (default: pdfwrite); not allowed in restricted mode.
--[no]embed
embed fonts (default: true); passes -dMaxSubsetPct=100-dSubsetFonts=true-dEmbedAllFonts=true.--[no]gray
grayscale output (default: false); passes -sColorConversionStrategy=Gray-dProcessColorModel=/DeviceGray.--pdfsettings=val
use -dPDFSETTINGS=/val (default is `prepress' if --embed, else empty); recognized val choices:
screen, ebook, printer, prepress, default.
--[no]quiet
use -q, a.k.a. -dQUIET (default: false).
--res=dpi,dpixdpi
set image resolution (default: [use gs default]).
--[no]safer
use -d(NO)SAFER (default: true).
In addition to the specific options above, additional options to be used with gs can be specified with
either or both of the two cumulative options --gsopts and --gsopt.--gsopts takes a single string of options, which is split at whitespace; each resulting word then added
to the gs command line individually.
--gsopt adds its argument as a single option to the gs command line. It can be used multiple times to
specify options separately. This form must be used if a gs option or its value contains whitespace.
In restricted mode, options are limited to those with names and values known to be safe. Some options
taking booleans, integers or fixed names are allowed, those taking general strings are not.
In order to give a comprehensible error message, epstopdf checks whether kpsewhich and (the specified) gs
are found in the current PATH, or executable if they are specified as absolute names.