# The &kghostview; Handbook

## Introduction

&kghostview; displays and prints &PostScript; (`.ps`, `.eps`) and Portable Document Format (`.pdf`) files. It a port to &kde; of Tim Theisen's Ghostview program which uses Alladin Ghostscript 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 can be used to preview material intended for printing or for reading documents online.

You can use &kghostview; with all recent versions of Ghostscript. Newer versions offer much improved performance which you can take advantage of with &kghostview;.

If a document does not conform to the Adobe document structuring convention the functionality of the viewer is limited. For example, if there is no table of contents, skipping around the document and marking pages is not possible.

## Fundamentals

This section describes what you see in the main &kghostview; window, the actions of the Toolbar buttons and how to use the Page List.

You can open multiple instances of &kghostview; to view multiple documents. The title bar at the top of a window shows you the name of the document in that window.

The main 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, although these can be disabled with the Settings menu.

Note that the Toolbar and the Page List can be hidden with the Settings menu options to give more space on the screen for the content area.

You can scroll up and down in a page with the Up Arrow and Down Arrow keys, or use the View Read Up Document (&Shift;Space ) and View Read Down Document (&Ctrl;Space) options to scroll through the entire document.

The Next Page and Previous Page Toolbar buttons do what they say, or you can go immediately to any page with a &LMB; click on the appropriate entry in the Page List.

If selected in the Settings menu a Page List will be displayed at the left side of the window. This list has two columns: the first may contain a flag indicating that the page has been marked, the second contains the page numbers. You can use this page list to navigate through the document or to mark pages for printing.

You can toggle the page marked flag for the currently displayed page with Ctrl M or for any page by &MMB; clicking on it in the Page List. You can also clear or change your page marks using the drop-down menu that is activated by &RMB; clicking anywhere in the Page List area or by selecting the PageMarks menu.

## The Menubar

### The File Menu

&Ctrl; O File Open...

- Open a file. If a file is currently being displayed it will be closed.

File Open Recent

- Open a file selected from a drop-down list of recently opened files. If a file is currently being displayed it will be closed.

File Save As...

- Save the currently open file.

&Ctrl; P File Print...

- Print the currently displayed document. The Print dialog box will let you choose to print all or selected (marked) pages.

File Document Info...

- Display some basic information about the document.

&Ctrl; Q File Quit

- Close down &kghostview;.

### The View Menu

View Redisplay

- Re-render the current document page.

View Fit To Page Width

- Scale the display so a page width fits exactly across the main display area.

View Orientation

- Change the orientation of the displayed page. You can choose between Auto, Portrait, Landscape, Upside Down and Seascape which is like Landscape but the other way up.

View Paper Size

- Lets you view the document as if it were printed on different paper sizes without changing the scale. You should normally choose Auto.

&Ctrl;+ View Zoom In

- Increase the magnification of the document view.

&Ctrl; - View Zoom Out

- Decrease the magnification of the document view.

Page Up View Previous Page

- View the previous page of the document.

Page Down View Next Page

- View the next page of the document.

&Ctrl; Home View First Page

- Go to the first page of the document.

&Ctrl; End View Last Page

- Go to the last page of the document.

View Go to Page...

- Go to a selected page of the document.

&Shift; Space View Read up Document

- Scroll backwards through the document.

View Read down Document

- Scroll forwards through the document.

### The PageMarks Menu

You can also get this menu by &RMB; clicking anywhere in the Page List area.

&Ctrl; M PageMarks Mark Current Page

- Toggle the page marked flag for the current page.

PageMarks Mark All Pages

- Set the page marked flag for all pages of the document.

PageMarks Mark Even Pages

- Set the page marked flag for all even numbered pages in the document. Used in conjunction with Mark Odd Pages or Toggle Page Marks this provides a convenient way of double-sided printing a document on a single sided printer

PageMarks Mark Odd Pages

- Set the page marked flag for all odd numbered pages in the document.

PageMarks Toggle Page Marks

- Toggle the page marked flags for all pages in the document.

PageMarks Remove Page Marks

- Clear the page marked flags for all pages in the document.

### The Settings Menu

Settings Show Toolbar

- Toggle the Toolbar display on and off.

Settings Show Statusbar

- Toggle the Statusbar display on and off.

Settings Show Scrollbars

- Toggle the horizontal and vertical scrollbars on and off.

Settings Watch File

- If this is selected the display will automatically update if the document file changes.

Settings Show Page List

- Toggle the Page List on and off.

Settings Show Page Labels

- If this is selected the name (if any) of the current page is displayed in the Status Bar.

Settings Configure &kghostview;...

- Brings up the &kghostview; configuration dialog box.

### The Help Menu

&help.menu.documentation;

## Configuration

The configuration dialog box is accessed with the Settings Configure &kghostview;... option. It has two pages; General settings and Ghostscript configuration

### General settings

You can select Enable anti-aliasing of fonts and images to get smoothly rendered text, but note that antialiasing is memory intensive and slower than straightforward rendering of fonts. Early versions of Ghostscript could not perform antialiasing.

Select Use Platform fonts if you wish to use your native system fonts rather than those that come with Ghostscript.

Turn Show Ghostscript Messages in a seperate box on if you want to be informed of any output or error messages generated by the Ghostscript interpreter.

You can choose whether &kghostview; uses a Monochrome, Grayscale or Color Palette for the display.

### Ghostscript configuration

In this dialog box page you can set the name of the Ghostscript Interpreter executable and the Non-antialiasing arguments: and the Antialiasing arguments passed to it. The default settings should be suitable for most systems.

## Credits and License

&kghostview;

## Program Copyright:

- Mark Donohoe donohoe@kde.org (original author) 1998

- David Sweet dsweet@kde.org Maintainer 1999-2000

- Wilco Greven greven@kde.org Current maintainer

- David Faure faure@kde.org (basis for shell)

- Daniel Duley mosfet@kde.org (port to Kparts)

- Espen Sand epsen@kde.org (dialog boxes)

Documentation copyright 2001, 2002 Pamela Roberts pamroberts@blueyonder.co.uk

&underFDL; &underGPL;

## Installation

&kghostview; is part of the &kde; 3 project, details of which can be found at http://www.kde.org.

To use &kghostview;, you must have the Ghostscript program as well as &kde; 3 installed on your machine. The Ghostscript home page is at http://www.cs.wisc.edu/~ghost/

Most distributions will include &kghostview;, but if you want to roll your own the source code can be found in the &package; package on &kde-ftp;, the main ftp site of the &kde; project.

To see if a later version of &kghostview; has been released, you can take a look in http://apps.kde.com.

&install.compile.documentation;
&documentation.index;