GHOSTVIEW(1) GHOSTVIEW(1) NNAAMMEE _g_h_o_s_t_v_i_e_w - View PostScript documents using ghostscript SSYYNNOOPPSSIISS gghhoossttvviieeww [filename] or gghhoossttvviieeww [-staticgray] [-grayscale] [-staticcolor] [-pseudocolor] [-truecolor] [-directcolor] [-[no]install] [-[no]private] [-[no]center] [-[no]title] [-[no]date] [-[no]locator] [-[no]labels] [-resolution _d_p_i] [-dpi _d_p_i] [-xdpi _d_p_i] [-ydpi _d_p_i] [-[no]quiet] [-preload _f_i_l_e] [-magstep _n] [-portrait] [-landscape] [-upsidedown] [-seascape] [-letter] [-tabloid] [-ledger] [-legal] [-statement] [-executive] [-a3] [-a4] [-a5] [-b4] [-b5] [-folio] [-quarto] [-10x14] [-force] [-forceorientation] [-forcemedia] [-[no]swap] [-[no]openwindows] [-[no]ncdwm] [-page _l_a_b_e_l] [-_t_o_o_l_k_i_t_o_p_t_i_o_n ...] [filename] DDEESSCCRRIIPPTTIIOONN The _g_h_o_s_t_v_i_e_w program provides an X11 user interface for the _g_h_o_s_t_s_c_r_i_p_t interpreter. _G_h_o_s_t_v_i_e_w and _g_h_o_s_t_s_c_r_i_p_t function as two cooperating programs. _G_h_o_s_t_v_i_e_w creates the viewing window and _g_h_o_s_t_s_c_r_i_p_t draws in it. Don't be alarmed by the number of options. Generally, one invokes _g_h_o_s_t_v_i_e_w with just one parameter, the name of the file to be previewed. If the filename is ``-'', _g_h_o_s_t_v_i_e_w will read from ``stdin''. The options provide a way to set X resources from the command line for a single invoca- tion of _g_h_o_s_t_v_i_e_w. For that reason, discussion of the options is delayed until after the X resources are dis- cussed. MMAAIINN WWIINNDDOOWW The main viewport is on the right side of the main window. If the page is larger than the viewport, there will be scroll bars along the bottom and right edges of the view- port. To the left of the viewport is the table of con- tents. If the PostScript file has document structuring convention (DSC) comments, the table of context will dis- play the page labels (i.e. usually page numbers). To the left of the table of contents is the menu box. Each push button brings up a popup menu. Over the menu box and table of contents there are three optional labels that contain the title, date, and locator. The title label contains the document title found in the DSC comments. If no title can be found, the filename is used in its place. The date label contains the document date found in the DSC comments. If no date can be found, the last modified date of the file is used in its place. Since the title and date labels may be clipped by the main viewport, the date and title labels are push buttons that bring up a popup window with the title or date. These popup windows also show the ``document'' icon when the displayed string comes 1 GHOSTVIEW(1) GHOSTVIEW(1) from the DSC comments. The locator shows the location of the cursor in the viewport. The location is expressed in the default user coordinate system. The locator is useful for measuring bounding boxes. Within the main viewport the mouse cursor is a ``target'' when _g_h_o_s_t_s_c_r_i_p_t is doing work. The cursor is a ``cross hair'' when _g_h_o_s_t_s_c_r_i_p_t is idle. When moving to another page in a document, it is generally best to wait for _g_h_o_s_t_s_c_r_i_p_t to become idle. Otherwise, the current _g_h_o_s_t_s_c_r_i_p_t process must be killed and the overhead of reading the prologue is incurred again. _G_h_o_s_t_v_i_e_w will check to see if the file has been modified just before it displays a page or when the application is deiconified. If the file has changed, it will reopen the file. Clicking anywhere within the viewport will popup a zoom window. The window is centered about the location that was clicked. Clicking with the first mouse button pops up a low resolution zoom window. Clicking with the second mouse button pops up a medium resolution zoom window. Clicking with the third mouse button pops up a high reso- lution zoom window. The cursor in the zoom window will display a ``target'' or ``cross hair'' depending on the state of _g_h_o_s_t_s_c_r_i_p_t. The locator reports the position of the cursor in the zoom windows as well as the main view- port. In the table of contents, the first and third mouse button functions exactly as they do in a Text widget. That is the first mouse button selects text and the third mouse button extends selections. However, clicking on a page label with the second mouse button will cause that page to be shown. The page being displayed is marked with a '<' in the right margin of the table of contents. PPOOPPUUPP WWIINNDDOOWWSS The are several additional windows that may appear. The _c_o_p_y_r_i_g_h_t window will appear whenever copyright informa- tion is requested. The _i_n_f_o_r_m_a_t_i_o_n window appears when- ever the _g_h_o_s_t_s_c_r_i_p_t process writes to ``stdout'' or ``stderr''. Whenever there is an error in the PostScript program, the stack trace will appear in this window. When _g_h_o_s_t_s_c_r_i_p_t is invoked without the quiet option, informa- tional message regarding the state of _g_h_o_s_t_s_c_r_i_p_t will appear in the _i_n_f_o_r_m_a_t_i_o_n window. The _c_o_p_y_r_i_g_h_t and _i_n_f_o_r_m_a_t_i_o_n windows can be dismissed by pushing the ``Dis- miss'' button. The _S_e_l_e_c_t _F_i_l_e dialog widget will appear when you wish to open or save a file. The _S_e_l_e_c_t _F_i_l_e dialog widget allows an X11 user to select a file by typing the path or by 2 GHOSTVIEW(1) GHOSTVIEW(1) browsing in directory listings and selecting entries with the mouse. The space bar can be pressed to complete filenames, and tilde is used for home directories. All the usual key bindings can be used in the text widget, except for Return and Control-M, which are equivalent to pressing the OK button. The path can be scrolled using the large horizon- tal scroll bar, or by moving the insertion cursor in the text widget. The directory entries can be scrolled using the vertical scroll bars, or by holding a mouse button down and moving out of the listing. The scrolling speed varies with the distance from the listing. The directory entries are terminated with special charac- ters that show the type of entry, similar to the _-_F option of _l_s(1). The _S_e_l_e_c_t _F_i_l_e dialog widget is in total control until is pops down. No other controls in _g_h_o_s_t_v_i_e_w will be active during this time. MMEENNUUSS There are five buttons in the menu box. They are the FFiillee, PPaaggee, MMaaggsstteepp, OOrriieennttaattiioonn, and MMeeddiiaa buttons. There are keyboard accelerators for most of the popup menus. Be sure to read the keyboard accelerator section. FFiillee This popup menu controls file access: OOppeenn...... Pops up the Select File window in preparation to open a file. The Select File widget is in total control until it pops down. Opens the file for viewing. RReeooppeenn Reopens the current file. PPrriinntt...... Pops up a dialog widget to ask for the printer name. Sends the whole docu- ment to the printer. PPrriinntt mmaarrkkeedd ppaaggeess...... Pops up a dialog widget to ask for the printer name. Sends the marked pages to the printer. If no pages have been marked, the mark procedure is called before printing and then the unmark procedure is called after printing. SSaavvee mmaarrkkeedd ppaaggeess...... Pops up the Select File window in preparation to save a file. The Select File widget is in total control 3 GHOSTVIEW(1) GHOSTVIEW(1) until it pops down. Saves the marked pages in the selected file. If no pages have been marked, the mark pro- cedure is called before saving and then the unmark procedure is called after saving. CCooppyyrriigghhtt...... Pops up the _c_o_p_y_r_i_g_h_t window. QQuuiitt Causes _g_h_o_s_t_v_i_e_w to exit. PPaaggee This popup menu controls page access: NNeexxtt Display the next page. RReeddiissppllaayy Display the current page. PPrreevviioouuss Display the previous page. CCeenntteerr Center the page in the viewport. MMaarrkk Mark the pages that have been selected in the table of contents. If no pages have been selected, mark the current page. UUnnmmaarrkk Unmark the pages that have been selected in the table of contents. If no pages have been selected, unmark the current page. MMaaggsstteepp The Magstep menu controls the magnification at which the document is viewed. The default mag- step of 0 implies no magnification (i.e. the size on the screen should match the size on paper). _G_h_o_s_t_v_i_e_w borrows the notion of magstep from TeX. The magnification is defined to be 1.2**magstep. At magstep 1, the document is magnified by 1.2. At magstep -1, the document is reduced by 1.2. The Magstep menu lists val- ues from -5 to 5. OOrriieennttaattiioonn The Orientation menu controls the display orien- tation. A ``dot'' appears in front of the cur- rent orientation. The first mouse button sets the default orientation. The DSC comments may specify an orientation of Portrait or Landscape that overrides the default. In this case, a "document" appears in front of the current ori- entation. The second mouse button can be used to ``force'' the orientation on a document to override the DSC comments. If an orientation is 4 GHOSTVIEW(1) GHOSTVIEW(1) being forced, then a ``tie fighter'' will appear in front of the current orientation. PPoorrttrraaiitt Set the orientation to Portrait. This implies no rotation. A portrait ori- entation indicates that the longest edge of the paper is parallel to the vertical (y) axis. LLaannddssccaappee Set the orientation to Landscape. This implies a clockwise rotation of the paper by 90 degrees. A landscape orientation indicates that the longest edge of the paper is parallel to the horizontal (x) axis. UUppssiiddee--ddoowwnn Set the orientation to Upside-Down. SSeeaassccaappee Set the orientation to Seascape. This implies a counterclockwise rotation of the paper by 90 degrees. SSwwaapp LLaannddssccaappee Swap the meaning of Landscape and Seascape. Most of the Landscape docu- ments that I have encountered require a 90 clockwise rotation of the paper to view. However, there is no stan- dard and some documents need to be rotated the other way. The swap land- scape button allows _g_h_o_s_t_v_i_e_w to auto- matically rotate the document the right way in response to the %%%%OOrriieenn-- ttaattiioonn comment in the PostScript file. MMeeddiiaa The entries on the Media menu set the page media. Media defined in the document appear at the beginning of the menu separated by a line from the standard media. A ``dot'' appears in front of the current media. The first mouse button sets the default media. The DSC comments may specify the page media that overrides the default. In this case, a "document" appears in front of the current media. The second mouse button can be used to ``force'' the media on a document to override the DSC comments. Forcing the media on an EPSF figure will override the Bounding Box. This makes is easy to view a fig- ure with an incorrect %%%%BBoouunnddiinnggBBooxx comment. If a media is being forced, then a ``tie fighter'' will appear in front of the current media. Here are the standard media names and their 5 GHOSTVIEW(1) GHOSTVIEW(1) sizes. The size is given as the width and height in PostScript points. LLeetttteerr 612 x 792 (8.5 x 11 in.) TTaabbllooiidd 792 x 1224 (11 x 17 in.) LLeeddggeerr 1224 x 792 (17 x 11 in.) LLeeggaall 612 x 1008 (8.5 x 14 in.) SSttaatteemmeenntt 396 x 612 (5.5 x 8.5 in.) EExxeeccuuttiivvee 540 x 720 (7.5 x 10 in.) AA33 842 x 1190 AA44 595 x 842 AA55 420 x 595 BB44 729 x 1032 BB55 516 x 729 FFoolliioo 612 x 936 (8.5 x 13 in.) QQuuaarrttoo 610 x 780 1100xx1144 720 x 1008 (10 x 14 in.) KKEEYYBBOOAARRDD AACCCCEELLEERRAATTOORRSS Most of the popup menu commands have an equivalent action that can be invoked from the keyboard. The popup menu entry must be sensitive (i.e. not grayed out) for the action to have effect. Here is the default keyboard bind- ing: QQ Bound to GGhhoossttvviieewwQQuuiitt(()) which is equivalent to pushing the QQuuiitt menu button on the GGhhoossttvviieeww menu. OO Bound to GGhhoossttvviieewwOOppeenn(()) which is equivalent to pushing the OOppeenn...... menu button on the FFiillee menu. RR Bound to GGhhoossttvviieewwRReeooppeenn(()) which is equivalent to pushing the RReeooppeenn menu button on the FFiillee menu. SS Bound to GGhhoossttvviieewwSSaavvee(()) which is equivalent to pushing the SSaavvee mmaarrkkeedd ppaaggeess...... menu button on the FFiillee menu. PP Bound to GGhhoossttvviieewwPPrriinnttMMaarrkkeedd(()) which is equiva- lent to pushing the PPrriinntt mmaarrkkeedd ppaaggeess...... menu button on the FFiillee menu. SShhiifftt--PP Bound to GGhhoossttvviieewwPPrriinnttWWhhoollee(()) which is equiva- lent to pushing the PPrriinntt...... menu button on the FFiillee menu. BBaacckkSSppaaccee, DDeelleettee, PPrriioorr, BB Bound to GGhhoossttvviieewwPPrreevviioouuss(()) which is equivalent to pushing the PPrreevviioouuss menu button on the PPaaggee menu. 6 GHOSTVIEW(1) GHOSTVIEW(1) ssppaaccee, RReettuurrnn, NNeexxtt, FF Bound to GGhhoossttvviieewwNNeexxtt(()) which is equivalent to pushing the NNeexxtt menu button on the PPaaggee menu. ppeerriioodd, CCttrrll--LL Bound to GGhhoossttvviieewwSShhooww(()) which is equivalent to pushing the RReeddiissppllaayy menu button on the PPaaggee menu. MM Bound to GGhhoossttvviieewwMMaarrkk(()) which is equivalent to pushing the MMaarrkk menu button on the PPaaggee menu. NN Bound to GGhhoossttvviieewwUUnnMMaarrkk(()) which is equivalent to pushing the UUnnmmaarrkk menu button on the PPaaggee menu. 00 Bound to GGhhoossttvviieewwMMaaggsstteepp((00)) which is equivalent to pushing the 00 menu button on the MMaaggsstteepp menu. 11 Bound to GGhhoossttvviieewwMMaaggsstteepp((11)) which is equivalent to pushing the 11 menu button on the MMaaggsstteepp menu. 22 Bound to GGhhoossttvviieewwMMaaggsstteepp((22)) which is equivalent to pushing the 22 menu button on the MMaaggsstteepp menu. 33 Bound to GGhhoossttvviieewwMMaaggsstteepp((33)) which is equivalent to pushing the 33 menu button on the MMaaggsstteepp menu. 44 Bound to GGhhoossttvviieewwMMaaggsstteepp((44)) which is equivalent to pushing the 44 menu button on the MMaaggsstteepp menu. 55 Bound to GGhhoossttvviieewwMMaaggsstteepp((55)) which is equivalent to pushing the 55 menu button on the MMaaggsstteepp menu. ++ Bound to GGhhoossttvviieewwIInnccrreeaasseeMMaaggsstteepp(()) which increases the magstep by 1. -- Bound to GGhhoossttvviieewwDDeeccrreeaasseeMMaaggsstteepp(()) which decreases the magstep by 1. UU Bound to GGhhoossttvviieewwUUpp(()) which scrolls the main viewport up. DD Bound to GGhhoossttvviieewwDDoowwnn(()) which scrolls the main viewport down. HH Bound to GGhhoossttvviieewwLLeefftt(()) which scrolls the main viewport left. 7 GHOSTVIEW(1) GHOSTVIEW(1) JJ Bound to GGhhoossttvviieewwDDoowwnn(()) which scrolls the main viewport down. KK Bound to GGhhoossttvviieewwUUpp(()) which scrolls the main viewport up. LL Bound to GGhhoossttvviieewwRRiigghhtt(()) which scrolls the main viewport right. UUpp (arrow) Bound to GGhhoossttvviieewwDDeeffaauulltt(()) GGhhoossttvviieewwSSeettOOrriieennttaa-- ttiioonn((ppoorrttrraaiitt)) which is equivalent to pushing PPoorrttrraaiitt with the first mouse button on the OOrrii-- eennttaattiioonn menu. RRiigghhtt (arrow) Bound to GGhhoossttvviieewwDDeeffaauulltt(()) GGhhoossttvviieewwSSeettOOrriieennttaa-- ttiioonn((llaannddssccaappee)) which is equivalent to pushing LLaannddssccaappee with the first mouse button on the OOrriieennttaattiioonn menu. DDoowwnn (arrow) Bound to GGhhoossttvviieewwDDeeffaauulltt(()) GGhhoossttvviieewwSSeettOOrriieennttaa-- ttiioonn((uuppssiiddee--ddoowwnn)) which is equivalent to pushing UUppssiiddee--ddoowwnn with the first mouse button on the OOrriieennttaattiioonn menu. LLeefftt (arrow) Bound to GGhhoossttvviieewwDDeeffaauulltt(()) GGhhoossttvviieewwSSeettOOrriieennttaa-- ttiioonn((sseeaassccaappee)) which is equivalent to pushing SSeeaassccaappee with the first mouse button on the OOrrii-- eennttaattiioonn menu. SShhiifftt--UUpp (arrow) Bound to GGhhoossttvviieewwFFoorrccee(()) GGhhoossttvviieewwSSeettOOrriieennttaa-- ttiioonn((ppoorrttrraaiitt)) which is equivalent to pushing PPoorrttrraaiitt with the second mouse button on the OOrriieennttaattiioonn menu. SShhiifftt--RRiigghhtt (arrow) Bound to GGhhoossttvviieewwFFoorrccee(()) GGhhoossttvviieewwSSeettOOrriieennttaa-- ttiioonn((llaannddssccaappee)) which is equivalent to pushing LLaannddssccaappee with the second mouse button on the OOrriieennttaattiioonn menu. SShhiifftt--DDoowwnn (arrow) Bound to GGhhoossttvviieewwFFoorrccee(()) GGhhoossttvviieewwSSeettOOrriieennttaa-- ttiioonn((uuppssiiddee--ddoowwnn)) which is equivalent to pushing UUppssiiddee--ddoowwnn with the second mouse button on the OOrriieennttaattiioonn menu. SShhiifftt--LLeefftt (arrow) Bound to GGhhoossttvviieewwFFoorrccee(()) GGhhoossttvviieewwSSeettOOrriieennttaa-- ttiioonn((sseeaassccaappee)) which is equivalent to pushing 8 GHOSTVIEW(1) GHOSTVIEW(1) SSeeaassccaappee with the second mouse button on the OOrriieennttaattiioonn menu. AACCTTIIOONNSS Most of the popup menu commands have an equivalent action that can be used in a translation. The popup menu entry must be sensitive (i.e. not grayed out) for the action to have effect. Here is the list of actions: GGhhoossttvviieewwCCooppyyrriigghhtt(()) Equivalent to pushing the CCooppyyrriigghhtt...... menu but- ton on the GGhhoossttvviieeww menu. GGhhoossttvviieewwQQuuiitt(()) Equivalent to pushing the QQuuiitt menu button on the GGhhoossttvviieeww menu. GGhhoossttvviieewwOOppeenn(()) Equivalent to pushing the OOppeenn...... menu button on the FFiillee menu. GGhhoossttvviieewwRReeooppeenn(()) Equivalent to pushing the RReeooppeenn menu button on the FFiillee menu. GGhhoossttvviieewwSSaavvee(()) Equivalent to pushing the SSaavvee mmaarrkkeedd ppaaggeess...... menu button on the FFiillee menu. GGhhoossttvviieewwPPrriinnttWWhhoollee(()) Equivalent to pushing the PPrriinntt...... menu button on the FFiillee menu. GGhhoossttvviieewwPPrriinnttMMaarrkkeedd(()) Equivalent to pushing the PPrriinntt mmaarrkkeedd ppaaggeess...... menu button on the FFiillee menu. GGhhoossttvviieewwPPrreevviioouuss(()) Equivalent to pushing the PPrreevviioouuss menu button on the PPaaggee menu. GGhhoossttvviieewwSShhooww(()) Equivalent to pushing the RReeddiissppllaayy menu button on the PPaaggee menu. GGhhoossttvviieewwNNeexxtt(()) Equivalent to pushing the NNeexxtt menu button on the PPaaggee menu. GGhhoossttvviieewwCCeenntteerr(()) Equivalent to pushing the CCeenntteerr menu button on the PPaaggee menu. 9 GHOSTVIEW(1) GHOSTVIEW(1) GGhhoossttvviieewwMMaarrkk(()) Equivalent to pushing the MMaarrkk menu button on the PPaaggee menu. GGhhoossttvviieewwUUnnmmaarrkk(()) Equivalent to pushing the UUnnmmaarrkk menu button on the PPaaggee menu. GGhhoossttvviieewwSSeettMMaaggsstteepp((mmaaggsstteepp)) Sets the magstep. The parameter must be an integer. GGhhoossttvviieewwIInnccrreeaasseeMMaaggsstteepp(()) Increases magstep by one. GGhhoossttvviieewwDDeeccrreeaasseeMMaaggsstteepp(()) Decreases magstep by one. GGhhoossttvviieewwSSeettOOrriieennttaattiioonn((oorriieennttaattiioonn)) Set the orientation to the passed parameter. The parameter must be ppoorrttrraaiitt, llaannddssccaappee, uuppssiiddee--ddoowwnn, or sseeaassccaappee. GGhhoossttvviieewwSSwwaappLLaannddssccaappee(()) Equivalent to pushing the SSwwaapp LLaannddssccaappee menu button on the OOrriieennttaattiioonn menu. GGhhoossttvviieewwSSeettPPaaggeeMMeeddiiaa((mmeeddiiaa--nnaammee)) Sets the media. The parameter should be either a media defined in the document or a standard media. GGhhoossttvviieewwDDeeffaauulltt(()) The orientation or media being set is not forced on the document. This action is called before the action that sets the orientation or media. GGhhoossttvviieewwFFoorrccee(()) The orientation or media being set is forced on the document. This action is called before the action that sets the orientation or media. GGhhoossttvviieewwDDeelleetteeWWiinnddooww(()) Destroy the current window. This provides a way to implement the Delete Window protocol for win- dow managers. GGhhoossttvviieewwDDiissmmiissss(()) Pop down the current window. This provides a way to implement the Delete Window protocol for window managers. GGhhoossttvviieewwSSccrroollllUUpp(()) Scroll the main viewport up. 10 GHOSTVIEW(1) GHOSTVIEW(1) GGhhoossttvviieewwSSccrroollllDDoowwnn(()) Scroll the main viewport down. GGhhoossttvviieewwSSccrroollllLLeefftt(()) Scroll the main viewport left. GGhhoossttvviieewwSSccrroollllRRiigghhtt(()) Scroll the main viewport right. GGhhoossttvviieewwEErraasseeLLooccaattoorr(()) Used to erase the locator when leaving a Ghostview widget. GGhhoossttvviieewwCChheecckkFFiillee(()) Checks to see if the file changed and refreshes the screen if necessary. AAPPPPLLIICCAATTIIOONN RREESSOOUURRCCEESS The following application resources may be set to control the default behavior of _g_h_o_s_t_v_i_e_w. sshhoowwTTiittllee ((class LLaabbeellss)) Tells whether to display the %%%%TTiittllee comment. The default is ``true''. sshhoowwDDaattee ((class LLaabbeellss)) Tells whether to display the %%%%DDaattaa comment. The default is ``true''. sshhoowwLLooccaattoorr ((class LLaabbeellss)) Tells whether to display the locator. The default is ``true''. iinnssttaallllSSttddCCmmaapp ((class IInnssttaallllSSttddCCmmaapp)) Tells whether to attempt to install a standard colormap. The default is ``false''. pprriivvaatteeCCmmaapp ((class PPrriivvaatteeCCmmaapp)) Tells whether to use a standard colormap that is not the default colormap. The default is ``false''. aauuttooCCeenntteerr ((class AAuuttooCCeenntteerr)) Tells whether to center the page within the viewport whenever the page size changes. The default is ``true''. hhoorriizzoonnaallMMaarrggiinn ((class MMaarrggiinn)) Tells how many pixels ghostview should reserve for window decorations in the horizontal direc- tion. The default value is ``20''. vveerrttiiccaallMMaarrggiinn ((class MMaarrggiinn)) Tells how many pixels ghostview should reserve 11 GHOSTVIEW(1) GHOSTVIEW(1) for window decorations in the vertical direc- tion. The default value is ``44''. mmiinniimmuummMMaaggsstteepp ((class MMaaggsstteepp)) Tells the smallest magstep to display. The default is ``-5''. mmaaxxiimmuummMMaaggsstteepp ((class MMaaggsstteepp)) Tells the largest magstep to display. The default is ``5''. mmaaggsstteepp ((class MMaaggsstteepp)) Sets the default magstep. The default is ``0''. oorriieennttaattiioonn ((class OOrriieennttaattiioonn)) Sets the default orientation. The default is ``Portrait''. ppaaggee ((class PPaaggee)) Gives the initial page to display. This resource only affects the display of the file listed on the command line. The default is NULL. ppaaggeeMMeeddiiaa ((class PPaaggeeMMeeddiiaa)) Sets the default page media. The default is ``Letter''. ffoorrcceeOOrriieennttaattiioonn ((class FFoorrccee)) Tells whether to force the orientation on the document. The default is ``false''. ffoorrcceePPaaggeeMMeeddiiaa ((class FFoorrccee)) Tells whether to force the page media on the document. The default is ``false''. sswwaappLLaannddssccaappee ((class SSwwaappLLaannddssccaappee)) Tells whether to swap the meaning of Landscape and Seascape. The default is ``false''. pprriinnttCCoommmmaanndd ((class PPrriinnttCCoommmmaanndd)) Sets the command used for printing. The printer environment variable is set to the desired printer and then this command is executed using popen. This command should read from ``stdin'' and send the file to the appropriate printer. The default value is ``lpr'' for BSD and ``lp'' for System V. pprriinntteerrVVaarriiaabbllee ((class PPrriinntteerrVVaarriiaabbllee)) Gives the name of the printer environment vari- able. The default value is ``PRINTER'' for BSD and ``LPDEST'' for System V. 12 GHOSTVIEW(1) GHOSTVIEW(1) ddeeffaauullttPPrriinntteerr ((class DDeeffaauullttPPrriinntteerr)) Gives the printer name to use when the printer environment variable is not set. The default value is NULL. pprriinnttPPrroommpptt ((class PPrriinnttPPrroommpptt)) Sets the prompt used to ask for the printer name. The default value is ``Printer Name: ''. pprriinnttFFaaiill ((class pprriinnttFFaaiill)) Sets the string used to inform the user that the printer command failed. The default is ``"lpr" command failed.''. ooppeennPPrroommpptt ((class OOppeennPPrroommpptt)) Sets the prompt used to ask for a file name to open. The default value is ``Open File: ''. ooppeennFFaaiill ((class OOppeennFFaaiill)) Sets the string used to inform the user that the open failed. The default value is ``Cannot open file: ''. ssaavveePPrroommpptt ((class SSaavveePPrroommpptt)) Sets the prompt used to ask for a file name to save. The default value is ``Save File: ''. ssaavveeFFaaiill ((class SSaavveeFFaaiill)) Sets the string used to inform the user that the save failed. The default value is ``Cannot save file: ''. ooppeennWWiinnddoowwss ((class OOppeennWWiinnddoowwss)) OpenWindows servers sometimes cause error mes- sages about bitmaps not being 1 bit deep. Turn- ing on this resource avoids the problem by not using any bitmaps. You lose the functionality of having the current magstep, orientation and media marked on the popup menus. The default value is ``false''. nnccddwwmm ((class NNccddwwmm)) The Xt Intrinsics has a bug that causes bogus information in the window manager size hints. _N_c_d_w_m and possibly other window managers get confused by the bogus information and make the window extremely small. _T_w_m and _m_w_m ignore the bogus information. Turning on the resource avoids the problem with _n_c_d_w_m by doing things slightly differently. However, this can confuse other window managers such as _m_w_m. This bug is fixed in X11R5 fix-10. You should only set this resource if you have the problem. The default value is ``false''. 13 GHOSTVIEW(1) GHOSTVIEW(1) GGHHOOSSTTVVIIEEWW WWIIDDGGEETT RREESSOOUURRCCEESS Certain resources in the Ghostview widget may be set by the user. These selected resources are presented below. bbuussyyCCuurrssoorr ((class CCuurrssoorr)) The cursor shown when _g_h_o_s_t_s_c_r_i_p_t is rendering to the window. The busy cursor is set to the ``target'' by the application defaults. ccuurrssoorr ((class CCuurrssoorr)) The cursor shown when _g_h_o_s_t_s_c_r_i_p_t is idle. The default cursor is the ``crosshair''. iinntteerrpprreetteerr ((class IInntteerrpprreetteerr)) The name of the executable to call to render the PostScript. It is convenient to set this resource to the path of an alternate version of ghostscript for testing. The default value is ``gs''. pprreellooaadd ((class PPrreellooaadd)) Files to load before the PostScript program. It is convenient to name files that preload fonts here for PostScript programs that continually reload fonts while rendering a page. The default is to not preload any files. qquuiieett ((class QQuuiieett)) Tells _g_h_o_s_t_s_c_r_i_p_t whether to produce informa- tional messages. The default value is ``false''. uusseeBBaacckkiinnggPPiixxmmaapp ((class UUsseeBBaacckkiinnggPPiixxmmaapp)) Tells whether to use a backing pixmap. If this resource is false, backing store is requested on the Ghostview window. Some X servers have lim- ited resources for large pixmaps. Also, some X servers' backing store is much faster than using a backing pixmap. You should reset this resource if your X server is one of the server types mentioned. The default value is ``true''. xxddppii ((class RReessoolluuttiioonn)) Sets the X resolution of the window in dots per inch. You can use this resource to affect the main window. Zoom windows have their X dpi set explicitly in the program. The default value is calculated from the screen metrics. yyddppii ((class RReessoolluuttiioonn)) Sets the Y resolution of the window in dots per inch. You can use this resource to affect the main window. Zoom windows have their Y dpi set explicitly in the program. The default value is 14 GHOSTVIEW(1) GHOSTVIEW(1) calculated from the screen metrics. GGHHOOSSTTVVIIEEWW WWIIDDGGEETT AACCTTIIOONNSS nnoottiiffyy((wwiiddtthh hheeiigghhtt xxddppii yyddppii)) The notify event is used by the ghostview appli- cation for the locator and popup zoom windows. If the width and height are 0, the event is user for the locator. Otherwise, it triggers a popup zoom window. The default widht and height are 72. The default xdpi and ydpi are 300. The height will default to the width if the height is omitted. The xdpi will default to the xdpi if the ydpi is omitted. OOPPTTIIOONNSS --ssttaattiiccggrraayy Equivalent to setting ``*Visual: StaticGray''. --ggrraayyssccaallee Equivalent to setting ``*Visual: GrayScale''. --ssttaattiiccccoolloorr Equivalent to setting ``*Visual: StaticColor''. --ppsseeuuddooccoolloorr Equivalent to setting ``*Visual: PseudoColor''. --ttrruueeccoolloorr Equivalent to setting ``*Visual: TrueColor''. --ddiirreeccttccoolloorr Equivalent to setting ``*Visual: DirectColor''. --iinnssttaallll Equivalent to setting ``Ghostview.installStdCmap: True''. --nnooiinnssttaallll Equivalent to setting ``Ghostview.installStdCmap: False''. --pprriivvaattee Equivalent to setting ``Ghostview.privateCmap: True''. --nnoopprriivvaattee Equivalent to setting ``Ghostview.privateCmap: False''. --cceenntteerr Equivalent to setting ``Ghostview.autoCenter: True''. --nnoocceenntteerr Equivalent to setting ``Ghostview.autoCenter: False''. --ttiittllee Equivalent to setting ``Ghostview.showTitle: 15 GHOSTVIEW(1) GHOSTVIEW(1) True''. --nnoottiittllee Equivalent to setting ``Ghostview.showTitle: False''. --ddaattee Equivalent to setting ``Ghostview.showDate: True''. --nnooddaattee Equivalent to setting ``Ghostview.showDate: False''. --llooccaattoorr Equivalent to setting ``Ghostview.showLocator: True''. --nnoollooccaattoorr Equivalent to setting ``Ghostview.showLocator: False''. --llaabbeellss Equivalent to setting ``Ghostview.Labels: True''. --nnoollaabbeellss Equivalent to setting ``Ghostview.Labels: False''. --qquuiieett Equivalent to setting ``*Ghostview.quiet: True''. --nnooqquuiieett Equivalent to setting ``*Ghostview.quiet: False''. --pprreellooaadd _f_i_l_e Equivalent to setting ``*Ghostview.preload: _f_i_l_e''. --xxddppii _d_p_i Equivalent to setting ``*Ghostview.xdpi: _d_p_i''. --yyddppii _d_p_i Equivalent to setting ``*Ghostview.ydpi: _d_p_i''. --rreessoolluuttiioonn _d_p_i Equivalent to setting ``*Ghostview.Resolution: _d_p_i''. --ddppii _d_p_i Equivalent to setting ``*Ghostview.Resolution: _d_p_i''. --mmaaggsstteepp _m_a_g_s_t_e_p Equivalent to setting ``Ghostview.magstep: _m_a_g_- _s_t_e_p''. --ppoorrttrraaiitt Equivalent to setting ``Ghostview.orientation: Portrait''. --llaannddssccaappee Equivalent to setting ``Ghostview.orientation: 16 GHOSTVIEW(1) GHOSTVIEW(1) Landscape''. --uuppssiiddeeddoowwnn Equivalent to setting ``Ghostview.orientation: Upside-down''. --sseeaassccaappee Equivalent to setting ``Ghostview.orientation: Seascape''. --ffoorrcceeoorriieennttaattiioonn Equivalent to setting ``Ghostview.forceOrientation: True''. --ppaaggee _l_a_b_e_l Equivalent to setting ``Ghostview.page: _l_a_b_e_l''. --lleetttteerr Equivalent to setting ``Ghostview.pageMedia: Letter''. --ttaabbllooiidd Equivalent to setting ``Ghostview.pageMedia: Tabloid''. --lleeddggeerr Equivalent to setting ``Ghostview.pageMedia: Ledger''. --lleeggaall Equivalent to setting ``Ghostview.pageMedia: Legal''. --ssttaatteemmeenntt Equivalent to setting ``Ghostview.pageMedia: Statement''. --eexxeeccuuttiivvee Equivalent to setting ``Ghostview.pageMedia: Executive''. --aa33 Equivalent to setting ``Ghostview.pageMedia: A3''. --aa44 Equivalent to setting ``Ghostview.pageMedia: A4''. --aa55 Equivalent to setting ``Ghostview.pageMedia: A5''. --bb44 Equivalent to setting ``Ghostview.pageMedia: B4''. --bb55 Equivalent to setting ``Ghostview.pageMedia: B5''. --ffoolliioo Equivalent to setting ``Ghostview.pageMedia: Folio''. 17 GHOSTVIEW(1) GHOSTVIEW(1) --qquuaarrttoo Equivalent to setting ``Ghostview.pageMedia: Quarto''. --1100xx1144 Equivalent to setting ``Ghostview.pageMedia: 10x14''. --ffoorrcceemmeeddiiaa Equivalent to setting ``Ghostview.forcePageMedia: True''. --ffoorrccee Equivalent to setting ``Ghostview.Force: True''. --sswwaapp Equivalent to setting ``Ghostview.swapLandscape: True''. --nnoosswwaapp Equivalent to setting ``Ghostview.swapLandscape: False''. --ooppeennwwiinnddoowwss Equivalent to setting ``Ghostview.openWindows: True''. --nnooooppeennwwiinnddoowwss Equivalent to setting ``Ghostview.openWindows: False''. --nnccddwwmm Equivalent to setting ``Ghostview.ncdwm: True''. --nnoonnccddwwmm Equivalent to setting ``Ghostview.ncdwm: False''. WWIIDDGGEETT HHIIEERRAARRCCHHYY _T_h_e _h_i_e_r_a_r_c_h_y _o_f _t_h_e _g_h_o_s_t_v_i_e_w _a_p_p_l_i_c_a_t_i_o_n_: Ghostview ghostview Form form MenuButton titleButton SimpleMenu menu SmeBSB title MenuButton dateButton SimpleMenu menu SmeBSB date Label locator Box box MenuButton fileButton SimpleMenu menu SmeBSB open SmeBSB reopen SmeBSB printwhole SmeBSB printmarked SmeBSB save SmeLine line SmeBSB copyright SmeBSB quit 18 GHOSTVIEW(1) GHOSTVIEW(1) MenuButton pageButton SimpleMenu menu SmeBSB next SmeBSB show SmeBSB prev SmeLine line SmeBSB center SmeLine line SmeBSB mark SmeBSB unmark MenuButton magstepButton SimpleMenu menu SmeBSB -5 SmeBSB -4 SmeBSB -3 SmeBSB -2 SmeBSB -1 SmeBSB 0 SmeBSB 1 SmeBSB 2 SmeBSB 3 SmeBSB 4 SmeBSB 5 MenuButton orientationButton SimpleMenu menu SmeBSB portrait SmeBSB landscape SmeBSB upsidedown SmeBSB seascape SmeLine line SmeBSB swap MenuButton pagemediaButton SimpleMenu menu SmeBSB Letter SmeBSB Tabloid SmeBSB Ledger SmeBSB Legal SmeBSB Statement SmeBSB Executive SmeBSB A3 SmeBSB A4 SmeBSB A5 SmeBSB B4 SmeBSB B5 SmeBSB Folio SmeBSB Quarto SmeBSB 10x14 Text toc Viewport pageview Core clip Ghostview page Scrollbar horizontal Scrollbar vertical TopLevelShell information 19 GHOSTVIEW(1) GHOSTVIEW(1) Form form Text text Command dismiss TopLevelShell copyright Form form Text text Command dismiss TransientShell popup Form dialog Label prompt Text response Command okay Command cancel TopLevelShell zoom Form form Ghostview page Command dismiss _T_h_e _h_i_e_r_a_r_c_h_y _o_f _t_h_e _S_e_l_e_c_t _F_i_l_e _d_i_a_l_o_g _b_o_x_: TransientShell selFile Form selFileForm Label selFilePrompt Text selFileField Scrollbar selFileHScroll Composite selFileList1 Scrollbar selFileVScroll Scrollbar selFileHScroll Composite selFileList2 Scrollbar selFileVScroll Scrollbar selFileHScroll Composite selFileList3 Scrollbar selFileVScroll Scrollbar selFileHScroll Command selFileOK Command selFileCancel EENNVVIIRROONNMMEENNTT LLPPDDEESSTT The LPDEST environment variable gives the default printer destination on System V. PPRRIINNTTEERR The PRINTER environment variable gives the default printer destination on BSD. LLIIMMIITTAATTIIOONNSS If the document does not begin with ``%!PS-Adobe-'', it does not claim conformance to the document structuring convention. When these documents are encountered, the functionality of _g_h_o_s_t_v_i_e_w is limited to giving you scroll bars and a next page capability. Because there is no table of contents, skipping around the document and mark- ing pages is impossible. If there is no table of contents for the document, the 20 GHOSTVIEW(1) GHOSTVIEW(1) popup zoom window will always show the first page. BBUUGGSS If you find a bug, please send a bug report to ghostview@cs.wisc.edu. AAUUTTHHOORR Copyright (C) 1992 Timothy O. Theisen This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. Author: Tim Theisen Systems Programmer Internet: tim@cs.wisc.edu Department of Computer Sciences UUCP: uwvax!tim University of Wisconsin-Madison Phone: (608)262-0438 1210 West Dayton Street FAX: (608)262-9777 Madison, WI 53706 AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS The Select File widget contains the following copyright notice: Copyright 1989 Software Research Associates, Inc., Tokyo, Japan Permission to use, copy, modify, and distribute this soft- ware and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Software Research Associates not be used in advertising or publicity per- taining to distribution of the software without specific, written prior permission. Software Research Associates makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. SOFTWARE RESEARCH ASSOCIATES DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES 21 GHOSTVIEW(1) GHOSTVIEW(1) OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL SOFTWARE RESEARCH ASSOCIATES BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. Author: Erik M. van der Poel Software Research Associates, Inc., Tokyo, Japan erik@sra.co.jp 22 .