<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook V3.1-Based Variant V1.0//EN" [
 <!ENTITY kghostview "<application>Kghostview</application>">
 <!ENTITY % addindex "IGNORE">
 <![ %addindex; [ <!ENTITY docindex SYSTEM "docindex.docbook"> ]]>
]>
<book lang="en">
<bookinfo>
<title>The KGhostview Handbook</title>
<authorgroup>
<author>
<firstname>Mark</firstname>
<surname>Donohoe</surname>
</author>
</authorgroup>
<date>07/06/1998</date>
<releaseinfo>0.06.01</releaseinfo>
<abstract>
<para>This documentation was last updated for kghostview version 0.6.1.
Please make any comments and additions to the author.</para>
</abstract>
<keywordset>
<keyword>KDE</keyword>
<keyword>linux</keyword>
<keyword>postscript</keyword>
<keyword>ghostivew</keyword>
</keywordset>
</bookinfo>

<chapter id="Introduction">
<title>Introduction</title>

<para>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 <emphasis remap="bf">Adobe</emphasis>'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.</para>

<para>KGhostview is just a front end to <emphasis remap="bf">Alladin</emphasis>'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.</para>

<para>If a document does not conform to the <emphasis remap="bf">Adobe</emphasis> 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.</para>
</chapter>

<chapter id="Tutorial">
<title>Tutorial</title>
<para>
</para>
</chapter>

<chapter id="Fundamentals">
<title>Fundamentals</title>

<para>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.</para>

<para>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. </para>

<sect1 id="window-summary">
<title>Window summary</title>

<para><variablelist>
<varlistentry>
<term>Window title bar</term>
<listitem>
<para>The name of a document is displayed in the window title bar.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Page display</term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Tool bar</term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Status bar </term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Page list </term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="tool-bar">
<title>Tool bar</title>

<para><variablelist>
<varlistentry>
<term>Back</term>
<listitem>
<para>Moves one page back in the document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Forward</term>
<listitem>
<para>Moves one page forward in the document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Go to page</term>
<listitem>
<para>Lets you choose which page to display.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>View control</term>
<listitem>
<para>Lets you set the magnification, orientation and page size for the view of
your document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Print</term>
<listitem>
<para>Lets you print the document previewed in this PostScript viewer window.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Mark</term>
<listitem>
<para>Marks (Unmarks) the current page. Used to select individual pages for
printing.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Go to start</term>
<listitem>
<para>Goes to start of the document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Go to end</term>
<listitem>
<para>Goes to end of the document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Read down</term>
<listitem>
<para>Scrolls up the current page for convenient reading
of the document in chunks.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="page-list">
<title>Page list</title>

<para>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.</para>

<para>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</para>

<para><itemizedlist>
<listitem>
<para>Mark current</para>
</listitem>
<listitem>
<para>Mark all</para>
</listitem>
<listitem>
<para>Mark even</para>
</listitem>
<listitem>
<para>Mark odd</para>
</listitem>
<listitem>
<para>Toggle marks</para>
</listitem>
<listitem>
<para>Remove marks</para>
</listitem>
</itemizedlist>
</para>
</sect1>
</chapter>

<chapter id="Primarymenuitems">
<title>Primary menu items</title>

<sect1 id="file">
<title>File</title>

<para><variablelist>
<varlistentry>
<term>New</term>
<listitem>
<para>Creates a new PostScript viewer window.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Open ...</term>
<listitem>
<para>Lets you select a file to open.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Close</term>
<listitem>
<para>Closes the current PostScript viewer window.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Print ...</term>
<listitem>
<para>Lets you print the document previewed in this PostScript viewer window.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Entries 1. - 4.</term>
<listitem>
<para>The last four opened documents are stored in these menu entries. Simply
select one of these to reopen that document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Quit</term>
<listitem>
<para>Exits PostScript viewer, closing all the windows.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="view">
<title>View</title>

<para><variablelist>
<varlistentry>
<term>Zoom in</term>
<listitem>
<para>Increases the magnification of the view of your document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Zoom out</term>
<listitem>
<para>Decreases the magnification of the view of your document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>View control ...</term>
<listitem>
<para>Lets you set the magnification, orientation and page size for the view of
your document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Shrink wrap</term>
<listitem>
<para>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.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Redisplay</term>
<listitem>
<para>Renders the current page of your document again.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Info ...</term>
<listitem>
<para>Displays some basic information about your document.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="go">
<title>Go</title>

<para><variablelist>
<varlistentry>
<term>Next page</term>
<listitem>
<para>Moves one page forward in the document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Previous page</term>
<listitem>
<para>Moves one page back in the document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Go to page ...</term>
<listitem>
<para>Lets you choose which page to display.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Go to start</term>
<listitem>
<para>Goes to the start of the document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Go to end</term>
<listitem>
<para>Goes to the end of the document.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Read down</term>
<listitem>
<para>Scrolls up the current page for convenient reading
of the document in chunks.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="options">
<title>Options</title>

<para><variablelist>
<varlistentry>
<term>Configure interpreter ... </term>
<listitem>
<para>Lets you choose a few options about how the Ghostscript driver should
work.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Show tool bar</term>
<listitem>
<para>Toggle the toolbar on and off.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Show status bar</term>
<listitem>
<para>Toggle the statusbar on and off.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Show page list</term>
<listitem>
<para>Toggle the page list on and off.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Configure key bindings ... </term>
<listitem>
<para>Lets you choose your own key bindings for the actions that PostScript viewer can
perform.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Save Options</term>
<listitem>
<para>Writes your set of preferences including the size of the PostScript viewer
window and the location of the toolbar to a configuration file. </para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="help">
<title>Help</title>

<para><variablelist>
<varlistentry>
<term>About PostScript viewer</term>
<listitem>
<para>Simply tells you the program name, version number and address of the
author</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Help for PostScript viewer</term>
<listitem>
<para>Starts the KDE online help and loads in this handbook.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Copyright</term>
<listitem>
<para>Displays copyright information for PostScript viewer.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>
</chapter>

<chapter id="Dialogboxes">
<title>Dialog boxes</title>

<sect1 id="print">
<title>Print</title>

<para>The <emphasis remap="bf">Printer Name</emphasis> can be entered in the appropriate text field to choose
the destination to send your document. The <emphasis remap="bf">Pages</emphasis> to be printed can be
selected from the combo box. The options are</para>

<para><itemizedlist>
<listitem>
<para>All</para>
</listitem>
<listitem>
<para>Marked</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="view-control">
<title>View control</title>

<para>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.</para>

<para><variablelist>
<varlistentry>
<term>Magstep</term>
<listitem>
<para>Select the magnification of the document from the combo box. Your can
scale a page from 20&percnt; to 300&percnt; from its default size.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Orientation</term>
<listitem>
<para>The options are</para>
<para><itemizedlist>
<listitem>
<para>Portrait</para>
</listitem>
<listitem>
<para>Landscape</para>
</listitem>
<listitem>
<para>Upside down</para>
</listitem>
<listitem>
<para>Seascape</para>
</listitem>
</itemizedlist>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Media</term>
<listitem>
<para>Media defined in the document appear at the start of the list.</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</sect1>

<sect1 id="info">
<title>Info</title>

<para>Shows the file name, title and creation date of the document.</para>
</sect1>

<sect1 id="go-to-page">
<title>Go to page</title>

<para>Allows you to select the section and page number of the page you want to
display.</para>
</sect1>

<sect1 id="configure-key-bindings">
<title>Configure key bindings</title>

<para>Allows you to change the keys that are bound to PostScript viewer actions.</para>
</sect1>

<sect1 id="configure-interpreter">
<title>Configure interpreter</title>

<para>The Configure interpreter dialog is comprised of three sections:</para>

<para><orderedlist><listitem>
<para>The <emphasis remap="bf">General</emphasis> section.</para>
</listitem>
<listitem>
<para>The <emphasis remap="bf">Palette</emphasis> options.</para>
</listitem>
<listitem>
<para>The <emphasis remap="bf">Backing</emphasis> style.</para>
</listitem>
</orderedlist>
</para>

<sect2>
<title>General</title>

<para>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.</para>

<para>Set <emphasis>Antialiasing</emphasis> 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.</para>

<para>Check <emphasis>Platform fonts</emphasis> 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.</para>

<para>Turn <emphasis>Messages</emphasis> on if you want to be informed of any output or error
messages generated by your PostScript interpreter.</para>
</sect2>

<sect2>
<title>Palette</title>

<para>You may choose the palette to be used to render your PostScript document. The
options are</para>

<para><itemizedlist>
<listitem>
<para>Color</para>
</listitem>
<listitem>
<para>Grayscale</para>
</listitem>
<listitem>
<para>Monochrome</para>
</listitem>
</itemizedlist>
</para>
</sect2>

<sect2>
<title>Backing</title>

<para>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</para>

<para><itemizedlist>
<listitem>
<para>Pixmap</para>
</listitem>
<listitem>
<para>Backing store</para>
</listitem>
</itemizedlist>
</para>

<para>One method may be faster on your X server than the other. Also, some X servers do
not offer a backing store.</para>
</sect2>
</sect1>

<sect1 id="ghostscript-messages">
<title>Ghostscript messages</title>

<para>Displays error or general output messages from Ghostscript.</para>
</sect1>
</chapter>

<chapter id="Epilogue">
<title>Epilogue</title>

<sect1 id="developer">
<title>Developer</title>

<para><literal remap="tt"><ulink url="mailto:donohoe@kde.org">Mark Donohoe</ulink></literal></para>
</sect1>

<sect1 id="authors">
<title>Authors</title>

<para><literal remap="tt"><ulink url="mailto:donohoe@kde.org">Mark Donohoe</ulink></literal></para>

<para><literal remap="tt"><ulink url="mailto:rwilliams@kde.org">Robert Williams</ulink></literal> - Editor</para>
</sect1>

<sect1 id="copyright">
<title>Copyright</title>

<para>kghostview is released under the GPL License. </para>
</sect1>
</chapter>
</book>
<!--
Local Variables:
mode: sgml
sgml-omittag: nil
sgml-shorttag: t
End:
-->
