Most switches have a value that may be mandatory or optional. Sometimes it's just a number or a string, but sometimes it's more complicated than that. Some switches do not have a type, which means they do not take any parameter.
||A flag that can be either on (true, 1) or off (false, 0)|
||An integer, such as a page number (usually positive)|
||Specifies an existing file, or an output file|
||A string that happens to be a password|
||You must choose from a list of valid values (varies)|
-pages 1-5 -quality 85 -compress jpeg -embedImages on
Most switches are flags, which can be turned on or off. You may use one of the following values to turn a flag on:
on true True 1
You may use one of the following values to turn a flag off:
off false False 0
-embedImages on -simpleLists off
When a parameter is missing, it defaults to
on. You may simply write:
-embedImagesSome flags cannot be turned off, because they do not have any parameters. For example:
Page numbers are integers that start with 1 for the first page.
When specifying a range of pages, you may use the following
<int>-<int>. The dash
character has the meaning of "through". Example:
You may also specify the word
convert all pages with no restriction. However, that is the default
Note: watermarks and stamps may only be placed on either the first page, or all pages. No other options are available.
-pages 1-5 -page 1 -pages all
For readability reasons, the
-pagesswitch is identical to the
-pageswitch, so they can be used interchangeably.