gv [ filename ] [-monochrome] [-grayscale] [-color] [-[no]safer] [ -[no]quiet] [-arguments <arguments>] [-page <label> ] [-[no]cent er] [-media <media >] [-portrait] [- landscape] [ -upsidedown] [-seascape] [-scale <n>] [ -scalebase < n>] [-swap] [-nosw ap] [-antialias] [ -noantialias ] [-dsc] [-nodsc ] [-eof] [-noeof ] [-pixmap] [-no pixmap] [-watch] [-now atch] [-?] [-h] [-he lp] [-v] [-resize] [-no resize] [-geometry [<w idth>][x<hei ght>][{+-}<xoffset>{+-}<yoffset>] [-ad <resource file>] [-style <resou rce file>] [-spartan] [<other toolki t options>]
gv allows to view and navigat e through PostScript and PD F documents on an X display by providing a us er interface for the ghostscript interpreter. Please note that gv is derive d from Tim Theisen's ghostview 1.5.
Resource files In general gv doe s not depend on any external resource files. However, when sta rting gv, pr eferences are read from a system speci fic resource file. The name of this file is as d escribed by the "XFILESEARCHPATH" environment varia ble, or, if this variable is not defined, implementation de pendant. In most cases it is "/usr/X11/lib/X 11/app-defau lts/GV". Administrators ma y want to mo dify this file in order to set up gv acco rding to the local needs of their system. a user specifi c resource f ile. The name of this file is eith er "~/.gv" or as described by the "XUSERFI LESEARCHPATH " environment variable. The files "gv_u ser.ad" an d "gv_system.ad" (located in the library directory of gv, which is m ost probably either "/usr/local/lib /gv/" or \ *Q/usr/lib/gv/" may serve as a basis for constructing the user and system specific resource files. Note that the use r and system specific resource files are not the only sources of prefer ences taken into account when gv is started. However, in pract ice these ar e the most important. Resources of g v The following des cribes some of the resources of gv. The precise synta x of some of the resource values may be inferred from the appended de fault system specific resource file.
<filter> := [<filespecs >] [no <filespecs>] <filespecs> := <filespec> [<filespecs>] <filespec> := filename po ssibly including wildcards '*' which match any character.
Example: The filt er
GV*filter: *.p s *.pdf no . *
screens out all f iles with na mes starting with a dot and keeps of the remaining on es only those which end on ".ps" or \ *Q.pdf".
GV.pageMedia: autom atic GV.orientation: autom atic GV.fallbackOrient ation: portr ait GV.swapLandscape: False GV.autoCenter: True GV.antialias: False GV.respectDSC: True GV.ignoreEOF: True GV.confirmPrint: True GV.reverseScrolli ng: False GV.scrollingEyeGu ide: True GV.autoResize: True GV.maximumWidth: screen-20 GV.maximumHeight: screen-44 GV.minimumWidth: 400 GV.minimumHeight: 430 GV.confirmQuit: 1 GV.watchFile: False GV.watchFileFrequ ency: 1000 GV.showTitle: True GV.miscMenuEntrie s: 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.back ground: white GV*Ghostview.fore ground: black GV.gsInterpreter: gs GV.gsCmdScanPDF: gs -dNODISPLAY -dQUIET -sPDFname=%s -sDSCname=%s pdf2dsc.ps -c quit GV.gsCmdConvPDF: gs -dNODISPLAY -dQUIET -dNOPAUSE -sPSFile=%s %s -c quit GV.gsX11Device: -sDEVICE=x11 GV.gsX11AlphaDevi ce: -dNOPLATFONTS -sDEVICE=x11alpha GV.gsSafer: True GV.gsQuiet: True GV.gsArguments: GV.uncompressComm and: gzip -d -c %s > %s GV.printCommand: lpr GV.scratchDir: ~/ GV.defaultSaveDir : ~/ GV.fallbackPageMe dia: a4 GV.useBackingPixm ap: 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 mean s press "Shi ft" and key "X" c-X mean s press "Ctr l" and key "X" sc-X mean s press "Shi ft" or "Ctrl" and key "X" === Miscellaneous keys: A Togg le antialias ing on and off O Open a new file Q Quit gv R Togg le gv's resi zing behaviour I Resp ect/Ignore d ocument structuring W Watc h file / Don 't watch file S Save the marked pages sc-S Save the current file P Prin t the marked pages sc-P Prin t the curren t file c-L Redi splay the cu rrent page . Re display the current page sc-. Reop en the curre nt file M Mark the current page N Unma rk the curre nt page === Orientation: 7 Orie ntation port rait 8 Orie ntation land scape 9 Orie ntation upsi de-down 0 Orie ntation seas cape === Magnification : sc-6 Sele ct the scale entry -6 relative to the scale 1.0 sc-5 Sele ct the scale entry -5 relative to the scale 1.0 sc-4 Sele ct the scale entry -4 relative to the scale 1.0 sc-3 Sele ct the scale entry -3 relative to the scale 1.0 sc-2 Sele ct the scale entry -2 relative to the scale 1.0 sc-1 Sele ct the scale entry -1 relative to the scale 1.0 ^ Sele ct the scale 1.0 (for german keyboard layout) ` Sele ct the scale 1.0 1 Sele ct the scale entry 1 relative to the scale 1.0 2 Sele ct the scale entry 2 relative to the scale 1.0 3 Sele ct the scale entry 3 relative to the scale 1.0 4 Sele ct the scale entry 4 relative to the scale 1.0 5 Sele ct the scale entry 5 relative to the scale 1.0 6 Sele ct the scale entry 6 relative to the scale 1.0 + Sele ct the next scale entry = Sele ct the next scale entry - Sele ct the previ ous scale entry === Navigating: Arrow Scro ll in the di rection of the arrow s-Up Scro ll columns u p or jump -1 pages s-Down Scro ll columns d own or jump 1 pages s-Left Scro ll rows left or jump -1 pages s-Right Scro ll rows righ t or jump 1 pages c-Up Jump -1 pages (t o top/left corner) c-Down Jump 1 pages (t o top/left corner) c-Left Jump -5 pages (t o top/left corner) c-Right Jump 5 pages (t o top/left corner) D,X,Z,Y,C Iden tical to arr ow up,down,left,left,right V Cent er the page sc-Space Scro ll columns u p or jump -1 pages Space Scro ll columns d own or jump 1 pages BackSpace Scro ll columns u p or jump -1 pages Insert Jump -5 pages Delete Jump 5 pages Home Go t o the first page End Go t o the last p age Prior Jump -1 pages Next Jump 1 pages Keypad 0-9 High light a page number Keypad - High light previo us page number Keypad + High light next p age number Keypad Enter Jump to the high lighted page c-Enter Jump -1 pages s-Enter Jump -1 pages Enter Jump 1 pages B Jump -1 pages F Jump 1 pages
GV.screenSize: <width> x <height>
should be added t o the "SCR EEN_RESOURCES" property of the screen the document is v iewed on, wi th <width> and <height> describing the wi dth and heig ht of the root window in units of millimeters. For instance by u sing the com mand
echo "GV.scree nSize: 396 x 291" | xrdb -override -screen
a width of 346 mm and a heigh t of 291 mm will be used for the "Natural size U scale base . Alternatively the resource
GV.screenSize_ <machine>_<d isp>_<scr>: <width> x <height>
may be added to a resource fi le read by gv. Here <machine> ,<disp> and ANGLED) describe the display on wh ich gv displ ays the document. For instance, if the display is set to "tic.tac.toe.wo:0.1" the resource shou ld be specif ied as
GV.screenSize_ tic_0_1: 396 x 291
Note that this me thod doesn't work on VMS. As a last alterna tive the res ource
GV.screenSize: <width> x <height>
may be added to o ne of the re source files. However, for obvious reasons this method shoul d be used on ly on single user machines.
kill -SIGHUP < gv_pid>
may be added (her e CR<gv_p id> is the process id of gv). Executing th e script and thereby creating a new version of the do cument will then also cause the result to be disp layed instan taneously. Please note that this feature is available only on X11 R6 based systems.
The source code o f the most r ecent version of gv may be obtained from the following s ources:
Johannes Plass pl ass@thep.physik.uni-mainz.de De partment of Physics Jo hannes Gutenberg University Ma inz, Germany gv is derived fro m GhostView 1.5, created by Tim The isen Sy stems Programmer Internet: tim@cs. wisc.edu De partment of Computer Sciences UUCP: uwvax!t im Un iversity of Wisconsin-Madison Phone: (608)26 2-0438 12 10 West Dayton Street FAX: (608)26 2-9777 Ma dison, WI 53706
Please send sugge stions or bu g reports to plass@thep.physik.uni-mainz.de.