Previous Next Table of Contents

3. Options

-ad <resource file>

Read and use additional resources from the file <resource file>. These resources have higher priority than those provided in the context of the -style <resource file> option.

-antialias, -noantialias

Whether to use antialiasing.

-arguments <arguments>

Start ghostscript with additional options as specified by the string <arguments>.

-center, -nocenter

Whether the page should be centered automatically.

-dpi <dpi>, -resolution <dpi>

Sets the resolution to <dpi> dots per inch.

-dsc, -nodsc

Determines if document structuring convention (DSC) comments should be respected or ignored. If -nodsc is used gv will not attempt to examine the structure of the document but will pass the file to the ghostscript interpreter as a whole. In this case no page numbers are shown and freely moving around in the document is not possible. This option may help when viewing files not conforming to the document structuring conventions.

-eof, -noeof

Defines the behaviour of the postscript scanner used to examine the structure of the document. If -noeof is used the scanner will ignore end of file (EOF) comments. This may help when viewing documents which import other documents without enclosing them within the proper "BeginDocument" and "EndDocument" comments. If -eof is used, the scanner treats an EOF comment as marking the end of the file.

-h, -?

Display a short help message and exit.

-help

Display a more explicit help message and exit.

-magstep <n>

Sets the magstep to <n>. <n> must be an integer in the range of allowed magsteps.

-monochrome, -grayscale, -color

Sets the color palette to be used.

-page <label>

Display the page with label <label> first.

-<paper-size>

Sets the paper-size. Valid values for <paper-size> are:

   Paper Size  X (pts)  Y (pts)   X cm    Y cm
   -------------------------------------------
   letter        612      792    21.59   27.94
   tabloid       792     1224    27.94   43.18
   ledger       1224      792    43.18   27.94
   legal         612     1008    21.59   35.56
   statement     396      612    13.97   21.59
   executive     540      720    19.05   25.40
   a0           2384     3371    84.09  118.92
   a1           1685     2384    59.46   84.09
   a2           1192     1685    42.04   59.46
   a3            843     1192    29.73   42.04
   a4            596      843    21.02   29.73
   a5            421      596    14.87   21.02
   b4            729     1032    25.01   35.35
   b5            516      729    17.67   25.01
   folio         612      936    21.59   33.02
   quarto        610      780    21.52   27.52
   10x14         720     1008    25.40   35.56
   

-portrait, -landscape, -seascape, -upsidedown

Sets the orientation.

-quiet, -noquiet

Whether to start ghostscript with the -dQUIET option.

-resize, -noresize

Whether gv is allowed to automatically fit the size of its window to the size of the displayed page.

-safer, -nosafer

Whether to start ghostscript with the -dSAFER option.

-style <resource file>

Read and use additional resources from the file <resource file>. These resources have lower priority than those provided in the context of the -ad <resource file> option.

-swap, -noswap

Whether to interchange the meaning of the orientations landscape and seascape.

-watch, -nowatch

The -watch option causes gv to check the document periodically. If changes are detected gv will automatically display the newer version of the file. The document is by default checked once every second. This can be changed via the watchFileFrequency resource. Note that sending gv the SIGHUP signal also causes an update of the displayed document. This method may be used by document creators to trigger gv remotely.

-xdpi <dpi>, -ydpi <dpi>

Sets the horizontal, vertical resolution to <dpi> dots per inch.


Previous Next Table of Contents