Kghostview"> ]]> ]> The KGhostview Handbook Mark Donohoe 07/06/1998 0.06.01 This documentation was last updated for kghostview version 0.6.1. Please make any comments and additions to the author. KDE linux postscript ghostivew Introduction KGhostview is the PostScript viewer for the K Desktop Environment. It is a port of Tim Theisen's Ghostview program which is used to view documents prepared in Adobe's PostScript page description language. PostScript is the major page description language for printing on UNIX systems and this application is used to preview material intended for printing or for reading documents online. KGhostview is just a front end to Alladin's Ghostcript package which renders the documents. You can use the viewer with all recent versions of Ghostscript. Newer versions offer much improved performance which you can take advantage of with KGhostview. It future, it will be possible to view Portable Document Format files. If a document does not conform to the Adobe document structuring convention the functionality of the PostScript viewer is limited. If there is no table of contents, skipping around the document and marking pages is not possible. Tutorial Fundamentals This section desribes what you see in the main PostScript viewer window, the actions of the toolbar buttons and how to use the page list. You can open multiple PostScript viewer windows to view multiple documents. The window title bar shows you the name of the document in that window. The tools and text fields that help you to navigate a document may be hidden in order to give more space on the screen to the content area. Window summary Window title bar The name of a document is displayed in the window title bar. Page display The content area displays a page of the current document. If the page is too large to fit inside the window, scroll bars are automatically added to the sides of the display. Tool bar Tool bar buttons activate the PostScript viewer features you'll most commonly use. Click on the buttons to move through the document, to change the view and to mark and print pages. You can choose to have the toolbar on any side of the contents area. Click with the right mouse button on the toolbar handle to select the position you want. You can also hide the toolbar from the options menu. Status bar The status bar has four fields showing the current page, magnification factor, orientation and file name of the document. You can choose to hide the status bar from the options menu. Page list A page list can be shown down the left side of the page display. This list has three columns: the first may contain a flag indicating that the page has been marked; the second shows the page shape; and the third contains the page number. You may use this page list to navigate the document or to select pages for printing. Tool bar Back Moves one page back in the document. Forward Moves one page forward in the document. Go to page Lets you choose which page to display. View control Lets you set the magnification, orientation and page size for the view of your document. Print Lets you print the document previewed in this PostScript viewer window. Mark Marks (Unmarks) the current page. Used to select individual pages for printing. Go to start Goes to start of the document. Go to end Goes to end of the document. Read down Scrolls up the current page for convenient reading of the document in chunks. Page list The page list is useful for navigating the document and selecting pages for printing. To view a page simply click on the page number in the list with the left mouse button. If you want to mark a page, click on it with the middle mouse button. A flag will be displayed in the first column of the page list to show that the page has been marked. You can clear or change your page marks using the menu of choices that is activated with the right mouse button. The choices available are Mark current Mark all Mark even Mark odd Toggle marks Remove marks Primary menu items File New Creates a new PostScript viewer window. Open ... Lets you select a file to open. Close Closes the current PostScript viewer window. Print ... Lets you print the document previewed in this PostScript viewer window. Entries 1. - 4. The last four opened documents are stored in these menu entries. Simply select one of these to reopen that document. Quit Exits PostScript viewer, closing all the windows. View Zoom in Increases the magnification of the view of your document. Zoom out Decreases the magnification of the view of your document. View control ... Lets you set the magnification, orientation and page size for the view of your document. Shrink wrap Resizes the PostScript viewer window to neatly fit the width of the document. If the document is too wide to fit on the screen then the PostScript viewer window is stretched to the maximum possible width. Redisplay Renders the current page of your document again. Info ... Displays some basic information about your document. Go Next page Moves one page forward in the document. Previous page Moves one page back in the document. Go to page ... Lets you choose which page to display. Go to start Goes to the start of the document. Go to end Goes to the end of the document. Read down Scrolls up the current page for convenient reading of the document in chunks. Options Configure interpreter ... Lets you choose a few options about how the Ghostscript driver should work. Show tool bar Toggle the toolbar on and off. Show status bar Toggle the statusbar on and off. Show page list Toggle the page list on and off. Configure key bindings ... Lets you choose your own key bindings for the actions that PostScript viewer can perform. Save Options Writes your set of preferences including the size of the PostScript viewer window and the location of the toolbar to a configuration file. Help About PostScript viewer Simply tells you the program name, version number and address of the author Help for PostScript viewer Starts the KDE online help and loads in this handbook. Copyright Displays copyright information for PostScript viewer. Dialog boxes Print The Printer Name can be entered in the appropriate text field to choose the destination to send your document. The Pages to be printed can be selected from the combo box. The options are All Marked View control This dialog allows you to set the magnification factor, orientaion and media used for the view of your document. You can leave the dialog open and apply changes repeatedly. Magstep Select the magnification of the document from the combo box. Your can scale a page from 20% to 300% from its default size. Orientation The options are Portrait Landscape Upside down Seascape Media Media defined in the document appear at the start of the list. Info Shows the file name, title and creation date of the document. Go to page Allows you to select the section and page number of the page you want to display. Configure key bindings Allows you to change the keys that are bound to PostScript viewer actions. Configure interpreter The Configure interpreter dialog is comprised of three sections: The General section. The Palette options. The Backing style. General One may edit the interpreter name which is by default set to gs suitable for most systems. One may also check any combination of three options. Set Antialiasing for smoothly rendered text. Performing antialiasing is memory intensive and slower than a straightforward rendering of fonts. If short of memory or time you may wish to turn this option off. Early versions of Ghostscript could not perform antialiasing. Check Platform fonts if you wish to use your native window system fonts rather than the fonts that come with your PostScript interpreter. Recent versions of Ghostscript come with good quality fonts. Turn Messages on if you want to be informed of any output or error messages generated by your PostScript interpreter. Palette You may choose the palette to be used to render your PostScript document. The options are Color Grayscale Monochrome Backing You have the choice of two methods to maintain the contents of a page in the viewer once it has been rendered by your PostScript interpreter. These are Pixmap Backing store One method may be faster on your X server than the other. Also, some X servers do not offer a backing store. Ghostscript messages Displays error or general output messages from Ghostscript. Epilogue Developer Mark Donohoe Authors Mark Donohoe Robert Williams - Editor Copyright kghostview is released under the GPL License.