gv [ filename ] [-monochrom e] [-grayscale] [-color] [-[no]safer ] [-[no]quiet] [-arguments <arguments>] [-page <lab el>] [-[no]center] [-media <me dia>] [-portrait] [-landscape] [-upsidedown] [-seascape] [-scale <n> ] [-scalebase <n>] [-swap] [-n oswap] [-antialias ] [-noantialias] [-dsc] [-no dsc] [-eof] [-no eof] [-pixmap] [ -nopixmap] [-watch] [- nowatch] [-?] [-h] [ -help] [-v] [-resize] [ -noresize] [-geometry [<width>][x<height>][{+-}<xoffset>{+-}<yoffset>] [-ad <resou rce file>] [-style <re source file>] [-spartan] [<other too lkit options>]
gv allows to v iew and navigate through PostScript and PDF documents on an X display by providing a user interface for the ghostscript interpreter. Please note th at gv is derived from Tim Theisen's ghostview 1.5.
Resource fi les In general gv does not depend on any external resource files. However, when starting gv, preferences are read from a system sp ecific resource file. The name of th is file is as described by the "XFILESEARCHPATH" environment va riable, or, if this variable is not defined, implementation dependent. In most cases it is "/usr/X11/li b/X11/app-defaults/GV". Administrators may want to modify this file in order to set up gv a ccording to the local needs of their system. a user spec ific resource file. The name of th is file is either "~/.gv" or as described by the "XUSE RFILESEARCHPATH" environment variable. The files "g v_user.ad" and "gv_system.ad" (located in the library directory of gv, which i s most probably either "/usr/local/ lib/gv/" or "/usr/lib/gv/" may serve as a basis for constructi ng the user and system specific resource files. Note that the user and system specific resource files are not the only sources of pre ferences taken into account when gv is started. However, in pr actice these are the most important. Resources o f gv The following describes some of the resources of gv. The precise sy ntax of some of the resource values may be inferred from the appended default system specific resource file.
<filter> := [<filespecs>] [no <filespecs>] <filespecs> := <filespec> [<filespecs>] <filespec> := filename possibly including wildcards '*' which match any character.
Example: The f ilter
GV*filter: *.ps *.pdf no .*
screens out al l files with names starting with a dot and keeps of t he remaining ones only those which end on ".ps" o r ".pdf".
GV.pageMedia: automatic GV.orientation : automatic GV.fallbackOri entation: portrait GV.swapLandsca pe: False GV.autoCenter: True GV.antialias: False GV.respectDSC: True GV.ignoreEOF: True GV.confirmPrin t: True GV.reverseScro lling: False GV.scrollingEy eGuide: True GV.autoResize: True GV.maximumWidt h: screen-20 GV.maximumHeig ht: screen-44 GV.minimumWidt h: 400 GV.minimumHeig ht: 430 GV.confirmQuit : 1 GV.watchFile: False GV.watchFileFr equency: 1000 GV.showTitle: True GV.miscMenuEnt ries: redisplay \n\ # update \n\ stop \n\ line \n\ toggle_current \n\ toggle_even \n\ toggle_odd \n\ unmark \n\ line \n\ print_all \n\ print_marked \n\ save_all \n\ save_marked GV.scale: 0 GV.scaleBase: 1 GV.scales: Natural size, 1.000, screen \n\ Pixel based, 1.000, pixel \n\ 0.100, 0.100 \n\ 0.125, 0.125 \n\ 0.250, 0.250 \n\ 0.500, 0.500 \n\ 0.707, 0.707 \n\ 1.000, 1.000 \n\ 1.414, 1.414 \n\ 2.000, 2.000 \n\ 4.000, 4.000 \n\ 8.000, 8.000 \n\ 10.00, 10.00 GV.medias: Letter, 612 792 \n\ # LetterSmall, 612 792 \n\ Legal, 612 1008 \n\ Statement, 396 612 \n\ Tabloid, 792 1224 \n\ Ledger, 1224 792 \n\ Folio, 612 936 \n\ Quarto, 610 780 \n\ # 7x9, 504 648 \n\ # 9x11, 648 792 \n\ # 9x12, 648 864 \n\ # 10x13, 720 936 \n\ 10x14, 720 1008 \n\ Executive, 540 720 \n\ # A0, 2384 3370 \n\ # A1, 1684 2384 \n\ # A2, 1191 1684 \n\ A3, 842 1191 \n\ A4, 595 842 \n\ # A4Small, 595 842 \n\ A5, 420 595 \n\ # A6, 297 420 \n\ # A7, 210 297 \n\ # A8, 148 210 \n\ # A9, 105 148 \n\ # A10, 73 105 \n\ # B0, 2920 4127 \n\ # B1, 2064 2920 \n\ # B2, 1460 2064 \n\ # B3, 1032 1460 \n\ B4, 729 1032 \n\ B5, 516 729 \n\ # B6, 363 516 \n\ # B7, 258 363 \n\ # B8, 181 258 \n\ # B9, 127 181 \n\ # B10, 91 127 \n\ # ISOB0, 2835 4008 \n\ # ISOB1, 2004 2835 \n\ # ISOB2, 1417 2004 \n\ # ISOB3, 1001 1417 \n\ # ISOB4, 709 1001 \n\ # ISOB5, 499 709 \n\ # ISOB6, 354 499 \n\ # ISOB7, 249 354 \n\ # ISOB8, 176 249 \n\ # ISOB9, 125 176 \n\ # ISOB10, 88 125 \n\ # C0, 2599 3676 \n\ # C1, 1837 2599 \n\ # C2, 1298 1837 \n\ # C3, 918 1296 \n\ # C4, 649 918 \n\ # C5, 459 649 \n\ # C6, 323 459 \n\ # C7, 230 323 \n\ # DL, 312 624 GV.magMenu: 2, 2 \n\ 4, 4 \n\ 8, 8 \n\ 16, 16 \n\ 32, 32 \n\ 64, 64 GV*Ghostview.b ackground: white GV*Ghostview.f oreground: black GV.gsInterpret er: gs GV.gsCmdScanPD F: gs -dNODISPLAY -dQUIET -sPDFname=%s -sDSCname=%s pdf2dsc.ps -c quit GV.gsCmdConvPD F: gs -dNODISPLAY -dQUIET -dNOPAUSE -sPSFile=%s %s -c quit GV.gsX11Device : -sDEVICE=x11 GV.gsX11AlphaD evice: -dNOPLATFONTS -sDEVICE=x11alpha GV.gsSafer: True GV.gsQuiet: True GV.gsArguments : GV.uncompressC ommand: gzip -d -c %s > %s GV.printComman d: lpr GV.scratchDir: ~/ GV.defaultSave Dir: ~/ GV.fallbackPag eMedia: a4 GV.useBackingP ixmap: True GV*dirs: Home\n\ Tmp\n\ /usr/doc\n\ /usr/local/doc GV*filter: no .* GV*filters: None\n\ *.*ps* *.pdf* no .*\n\ *.*ps* no .*\n\ *.pdf* no .*\n\ no .*
=== Notation: s-X m eans press "Shift" and key "X" c-X m eans press "Ctrl" and key "X" sc-X m eans press "Shift" or "Ctrl" and key "X" === Miscellane ous keys: A T oggle antialiasing on and off O O pen a new file Q Q uit gv R T oggle gv's resizing behaviour I R espect/Ignore document structuring W W atch file / Don't watch file S S ave the marked pages sc-S S ave the current file P P rint the marked pages sc-P P rint the current file c-L R edisplay the current page . Redisplay the current page sc-. R eopen the current file M M ark the current page N U nmark the current page === Orientatio n: 7 O rientation portrait 8 O rientation landscape 9 O rientation upside-down 0 O rientation seascape === Magnificat ion: sc-6 S elect the scale entry -6 relative to the scale 1.0 sc-5 S elect the scale entry -5 relative to the scale 1.0 sc-4 S elect the scale entry -4 relative to the scale 1.0 sc-3 S elect the scale entry -3 relative to the scale 1.0 sc-2 S elect the scale entry -2 relative to the scale 1.0 sc-1 S elect the scale entry -1 relative to the scale 1.0 ^ S elect the scale 1.0 (for german keyboard layout) ` S elect the scale 1.0 1 S elect the scale entry 1 relative to the scale 1.0 2 S elect the scale entry 2 relative to the scale 1.0 3 S elect the scale entry 3 relative to the scale 1.0 4 S elect the scale entry 4 relative to the scale 1.0 5 S elect the scale entry 5 relative to the scale 1.0 6 S elect the scale entry 6 relative to the scale 1.0 + S elect the next scale entry = S elect the next scale entry - S elect the previous scale entry === Navigating : Arrow S croll in the direction of the arrow s-Up S croll columns up or jump -1 pages s-Down S croll columns down or jump 1 pages s-Left S croll rows left or jump -1 pages s-Right S croll rows right or jump 1 pages c-Up J ump -1 pages (to top/left corner) c-Down J ump 1 pages (to top/left corner) c-Left J ump -5 pages (to top/left corner) c-Right J ump 5 pages (to top/left corner) D,X,Z,Y,C I dentical to arrow up,down,left,left,right V C enter the page sc-Space S croll columns up or jump -1 pages Space S croll columns down or jump 1 pages BackSpace S croll columns up or jump -1 pages Insert J ump -5 pages Delete J ump 5 pages Home G o to the first page End G o to the last page Prior J ump -1 pages Next J ump 1 pages Keypad 0-9 H ighlight a page number Keypad - H ighlight previous page number Keypad + H ighlight next page number Keypad Enter J ump to the highlighted page c-Enter J ump -1 pages s-Enter J ump -1 pages Enter J ump 1 pages B J ump -1 pages F J ump 1 pages
GV.screenSi ze: <width> x <height>
should be adde d to the "SCREEN_RESOURCES" property of the screen the document i s viewed on, with <width> and <height> describing the width and height of the root window in units of millimeters. For instance b y using the command
echo "GV.sc reenSize: 396 x 291" | xrdb -override -screen
a width of 346 mm and a height of 291 mm will be used for the "Natural siz e" scale base. Alternatively the resource
GV.screenSi ze_<machine>_<disp>_<scr>: <width> x <height>
may be added t o a resource file read by gv. Here <machine> ,<di sp> and ANGLED) describe the display on which gv displays the document. For instance, if the display is set to "tic.tac.toe.wo:0.1" the resource s hould be specified as
GV.screenSi ze_tic_0_1: 396 x 291
Note that this method doesn't work on VMS. As a last alte rnative the resource
GV.screenSi ze: <width> x <height>
may be added t o one of the resource files. However, for obvious reasons this method sh ould be used only on single user machines.
kill -SIGHU P <gv_pid>
may be added ( here CR<gv_pid> is the process id of gv). Executing the script and thereby creating a new version of the document will then also cause the result to be d isplayed instantaneously. Please note th at this feature is available only on X11 R6 based systems.
The source cod e of the most recent version of gv may be obtained from the following sources:
Johannes Plass plass@thep.physik.uni-mainz.de Department of Physics Johannes Gutenberg University Mainz, Germany gv is derived from GhostView 1.5, created by Tim Theisen Systems Programmer Internet: tim@ cs.wisc.edu Department of Computer Sciences UUCP: uwva x!tim University of Wisconsin-Madison Phone: (608 )262-0438 1210 West Dayton Street FAX: (608 )262-9777 Madison, WI 53706
Please send su ggestions or bug reports to ckesselh@debian.org.