3.2 Resources of gv

The following describes some of the resources of gv. The precise syntax of some of the resource values may be inferred from the appended default system specific resource file.

antialias

Whether antialiasing should be used. Valid values are True and False.

It defaults to True.

autoCenter

Whether the displayed page should automatically be centered (for instance when opening a new file). Valid values are True and False.

It defaults to True.

autoResize

Whether gv is allowed to resize the main window according to the size of the current page. Valid values are True and False.

It defaults to True.

confirmPrint

Whether printing requires an extra confirmation. Valid values are True and False.

It defaults to True.

confirmQuit

Whether leaving gv requires extra confirmation. Valid values are 0 (Never), 1 (When processing) and 2 (Always). The default value is 1, which causes a confirmation request when trying to leave gv in the presence of pending PDF to Postscript conversions.

scrollingEyeGuide

If this resource is True scrolling via the keyboard causes a temporary border to be drawn around the previously visible area of the page. Allowed values are True and False.

It defaults to True.

infoVerbose

Defines the behavior of the info popup which shows messages from ghostscript. Valid values are Silent (Never), Errors (show only errror messages) and All (Any message is being shown).

It defaults to Errors.

xinerama

Defines whether the display resolution is determined by xinerama. Valid values are On (use Xinerama if available), Off (do not use Xinerama) and Auto (heuristically decide whether to use Xinerama or not).

It defaults to Auto.

ignoreEOF

Defines the behaviour of the postscript scanner as described in the Options section. Valid values are True and False.

It defaults to True.

respectDSC

Determines whether gv should attempt to respect document structuring comments. Valid values are True and False.

It defaults to True.

reverseScrolling

Defines the interpretation of directions when scrolling with the mouse. Valid values are True and False.

It defaults to False.

swapLandscape

Whether the meaning of landscape and seacape should be interchanged. Valid values are True and False.

It defaults to False.

scratchDir

Specifies a directory used to store temporary data.

It defaults to the invocation directory.

defaultSaveDir

Specifies the default destination directory for files to be saved.

It defaults to the home directory, ~/.

useBackingPixmap

If the value of this resource is False the X Server is advised that saving off-screen pixels of the displayed page would be beneficial (maintaining backing store). In this case gv does not actively maintain the contents of the page but relies on the X Server. The server is, however, always free to stop maintaining backing backing store. If the value of this resource is True the X Server is advised that maintaining backing store is not useful. In this case gv attempts to allocate a sufficiently large pixmap to store the contents of the displayed page.

It defaults to True.

watchFile

Whether the document should be checked periodically and updated automatically if changes are detected. Valid values are True and False.

It defaults to False.

watchFileFrequency

Defines the time in milliseconds elapsing between successive checks of the document when watchFile is set to True. Allowed values must be larger than 500.

It defaults to 1000.

printCommand

The command used for printing a file. The command may contain multiple %s wildcards which will be replaced by the name of the file to be printed.

It defaults to lpr.

saveposFilename

This file is used for saving positions by the z and u keys.

It defaults to ~/gv.savepos.

gsInterpreter

The command used to start the ghostscript interpreter.

It defaults to gv.

gsCmdScanPDF

The command used to extract document structuring comments from a PDF file.

It defaults to gs -dNODISPLAY -dQUIET -sPDFname=%s -sDSCname=%s pdf2dsc.ps -c quit

gsCmdConvPDF

The command used to convert a PDF file to PostScript.

It defaults to gs -dNODISPLAY -dQUIET -dNOPAUSE -sPSFile=%s %s -c quit

gsX11Device

The ghostscript command line option which activates the X11 device.

It defaults to -sDEVICE=x11

gsX11AlphaDevice

The ghostscript command line option which activates the X11 device with antialiasing enabled.

It defaults to -dNOPLATFONTS -sDEVICE=x11alpha

gsSafer

Determines whether ghostscript should be started with the -dSAFER command line option.

It defaults to True.

gsQuiet

Determines whether ghostscript should be started with the -dQUIET command line option.

It defaults to True.

gsArguments

May be used to provide additional command line options for the ghostscript interpreter. Starting gv with the -arguments arguments option will override this resource setting.

It defaults to the empty string.

magMenu

Describes the menu that pops up when preparing to to zoom an area of the displayed page.

dirs

Defines a list of directories accessible via the Directories menu in the file selection window. The special value Home corresponds to the users home directory, the value Tmp corresponds to the scratch directory as defined by the scratchDir resource.

It defaults to Home Tmp /usr/doc /usr/local/doc

filter

Defines the default filter to be used when displaying a directory contents in the file selection window. A filter is specified according to the syntax

     
        <filter>    := [<filespecs>] [no <filespecs>]
        <filespecs> := <filespec> [<filespecs>]
        <filespec>  := filename possibly including wildcards '*'
                       which match any character.

Example: The filter

     
        GV*filter: *.ps *.pdf no .*

screens out all files with names starting with a dot and keeps of the remaining ones only those which end on .ps or .pdf.

It defaults to no .*

filters

Defines a list of filters offered in the Filters menu of the file selection window. The filter None has a special meaning causing all files to be displayed when the corresponding menu entry is selected.

miscMenuEntries

Describes the menu that pops up when clicking with the third mouse button on the displayed page. The value of this resource is a list of menu entries.

Allowed entries are

• update
• reload
• toggle_current
• toggle_even
• toggle_odd
• unmark
• stop
• print_all
• print_marked
• save_all
• save_marked
• line

titleStyle

Whether the name of the displayed document should be shown in the title bar of the window. The name of gv's icon will also change accordingly if this resource is set to True.

If this is 0, no title will be shown. 1 means to show a the document title or the file name if there is no document title. Only the file name is shown with 2.

It defaults to 1.

maximumWidth, maximumHeight

When resizing gv will not attempt to exceed the size specified by these resources. These resources may be specified as a positive integer or as screen, optionally combined with a positive or negative offset. The default values listed above provide examples for this syntax. screen will automatically be replaced by the size of the screen.

maximumWidth defaults to screen-20. maximumHeight defaults to screen-44.

minimumWidth, minimumHeight

Defines a minimum size for the main window. Valid values for both resources are positive integers larger than 200.

minimumWidth defaults to 400. minimumHeight defaults to 430.

scale

Sets the initial scale. The value of this resource is the offset of the scale to be selected relative to the scale 1.0 in the the Scale menu.

It defaults to 0.

scaleBase

Selects the initial scale base. The value of this resource should be a positive integer.

It defaults to 1.

scales

Defines the available scales bases and scales in the Scale menu.

orientation

Sets the initial orientation. Valid values are

• portrait
• landscape
• seascape
• upside-down
• automatic

automatic causes gv to attempt to derive the correct orientation from document structuring comments.

It defaults to automatic.

fallbackOrientation

Defines the paper-size to be used when automatic orientation detetction fails. Valid values are portrait, landscape, seascape and upside-down.

It defaults to portrait.

medias

A list describing the page medias known to gv. List entries starting with ! or # will not appear in the Media menu but will still be used for automatic paper size detection.

pagemedia

Sets the paper size. Allowd values are as given in the above list of paper-sizes. Specifying automatic causes gv to attempt to derive the correct paper-size from document structuring comments.

It defaults to automatic.

fallbackPageMedia

Defines the paper-size to be used when automatic paper-size detetction fails. Valid values are as given in the above list of paper-sizes.

It defaults to a4.