# The &kghostview; Handbook

## Introduction

&kghostview; displays and prints &PostScript; (`.ps`, `.eps`) and Portable Document Format (`.pdf`) files. It is 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 titlebar 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, scrollbars 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 (PageUp) and View Read Down (PageDown) options to scroll through the entire document.

The Read Up and Read Down -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;&Shift;M or for any page by &LMB; clicking on it in the Page List. You can also clear or change your page marks using the context menu that is activated by &RMB; clicking anywhere in the Page List area or by selecting the Edit 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 combo box 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 Edit Menu

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

&Ctrl;&Shift; M Edit Mark Current Page

- Toggle the page marked flag for the current page.

Edit Mark All Pages

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

Edit 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

Edit Mark Odd Pages

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

Edit Toggle Page Marks

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

Edit Remove Page Marks

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

### The View Menu

F5 View Reload

- Re-render the current document page.

M View Maximize

- This option maximizes the &kghostview; window.

&Ctrl;&Shift; F View Full Screen Mode

- This option maximizes the &kghostview; window and the currently shown page. Even the window decorations (titlebar &etc;) are temporarily removed. To switch back to normal window mode, press the ESC key or the shortcut &Ctrl;&Shift; F again, or open the context menu with a &RMB; click and select Exit Full Screen Mode.

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.

View Zoom

- Select a predefined zoom factor.

&Ctrl; - View Zoom Out

- Decrease the magnification of the document view.

View Fit to Page Width

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

S View Fit to Screen

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

&Ctrl; PageUp View Previous Page

- View the previous page of the document.

&Ctrl; PageDown 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.

PageUp View Read Up

- Scroll backwards through the document.

PageDown View Read Down

- Scroll forwards through the document.

### The Settings Menu

&Ctrl;M Settings Show/Hide Menubar

- Toggles the menubar on/off.

Settings Show/Hide Toolbar

- Toggle the Toolbar display on and off.

Settings Show/Hide Statusbar

- Toggle the Status bar display on and off.

&Ctrl;&Shift; F Settings Full Screen Mode

- This option maximizes the &kghostview; window and the currently shown page. Even the window decorations (titlebar &etc;) are temporarily removed. To switch back to normal window mode, press the ESC key or the shortcut &Ctrl;&Shift; F again, or open the context menu with a &RMB; click and select Exit Full Screen Mode.

Settings Configure Shortcuts...

- Opens a dialog for changing the shortcuts. Using this option you can change the standard key shortcut for &kghostview;'s commands or create new ones.

Settings Configure Toolbars...

- Opens a dialog for configuring the toolbar. You can add and remove toolbuttons for &kghostview;'s commands with this option.

Settings Show/Hide Scrollbars

- Toggle the horizontal and vertical scrollbars on and off.

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 Watch File

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

Settings No Flicker

- If this is selected the display will start showing objects instantly as they are rendered, otherwise the whole page is rendered off-screen and then displayed.

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 and Ghostscript Configuration

### General Settings

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

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 separate 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; &Mark.Donohoe.mail; (original author) 1998

- &David.Sweet; &David.Sweet.mail; Maintainer 1999-2000

- &Wilco.Greven; &Wilco.Greven.mail; Current maintainer

- &David.Faure; &David.Faure.mail; (basis for shell)

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

- &Espen.Sand; &Espen.Sand.mail; (dialog boxes)

Documentation copyright 2001, 2002 &Pamela.Roberts; &Pamela.Roberts.mail;

&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.

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