# The &kpdf; Handbook

Albert Astals Cid

    tsdgeos@yahoo.es

Titus Laska

    titus.laska@gmx.de

&FDLNotice;
2006-05-20
0.5

&kpdf; is a &kde; PDF viewer based on xpdf code.

KDE kpdf pdf

## Introduction

&kpdf; is a &kde; PDF (Portable Document Format) viewer based on the code of the xpdf application. Although being based on xpdf code, &kpdf; has some unique features such as continuous mode and presentation support.

The PDF format is widely used for publishing documents that are mostly not meant to be edited again. &kpdf; is only a viewer for these files and therefore it doesn't provide any functionality to edit or create PDF documents.

## Using &kpdf;

### Opening Files

To view a PDF file in &kpdf;, select File Open... , choose a PDF or PS file in the dialogue and click Open. Your file should now be displayed in the main window.

If you have already opened files in &kpdf; before, you can quickly access them by selecting them in the File Open Recent menu.

After having a file opened you probably want to read it and therefore navigate through it. Click Next to learn more about this.

### Navigating

This section describes how you can navigate through a document in &kpdf;.

There are multiple ways of scrolling the viewing area. One is to use the Up Arrow and Down Arrow keys. You may also use the scrollbar, your mousewheel or the Page Up and Page Down keys.

Another way is to hold the &LMB; down at any place on the document while dragging the mouse in the opposite direction of where you want to move. This procedure only works if the Browse Tool is enabled, which you can select by choosing Tools Browse Tool .

The navigation panel on the left side of the screen enables two more ways of navigating through a document:

- If you click on a page thumbnail the viewing area will be brought to that page.

- If the document has a table of contents, clicking on a table of contents item will bring the document to to the page linked to that item.

Some documents have links. In this case you can click on them and the view will change to the page it links to. If the link is to a web page the default browser will be invoked.

Additionally, you may use the following functionality to quickly move to specific places in the document:

- You can go to the first page of the document using &Ctrl;Home or using Go First Page .

- You can go to the last page of the document using &Ctrl;End or using Go Last Page .

- You can go to the next page of the document using Space, the Next Page Toolbar button or using Go Next Page .

- You can go to the previous page of the document using Backspace, the Previous Page Toolbar button or using Go Previous Page .

### Presentation Mode

The Presentation mode represents another way to view PDF documents in &kpdf;. It can be enabled in View Presentation. It shows the document on a page per page basis. The pages are shown with zoom to page, that means all the page is visible.

PDF documents can even specify that they are always opened in presentation mode.

To navigate between pages you may use the &LMB; (next page) and the &RMB; (previous page), the mouse wheel, the arrow icons that appear as soon as you move the mouse cursor to the top of the screen, or the keys specified in the Navigating section.

You can exit presentation mode at any time by pressing the ESC key or clicking the Quit icon appearing if you move the mouse cursor to the top of the screen.

Presentation mode has some configuration options, you can find their description at Configuring &kpdf;.

## The Menubar

### The File Menu

&Ctrl;O File Open...

  Open a PDF or PS file. If there is already an opened file it will be closed. For more information, see the section about Opening Files.

File Open Recent

  Open a file which was used previously from a submenu. If a file is currently being displayed it will be closed. For more information, see the section about Opening Files.

File Save As...

  Save the currently open file under a different name.

&Ctrl;P File Print...

  Print the currently displayed document.

File Print Preview...

  Show a preview of how the currently displayed document would be printed with the default options.

File Properties

  Display some basic information about the document, such as title, author, creation date, and details about the fonts used.

&Ctrl; Q File Quit

  Close &kpdf;.

### The Edit Menu

&Ctrl; F Edit Find...

  Open a dialogue that allows you to search for a string in the document.

F3 Edit Find Next

  Try to find the previous searched string again in the document.

### The View Menu

&Ctrl;&Shift;P View Presentation

  Activates the Presentation Mode. For more information, see the section about Presentation Mode.

&Ctrl;+ View Zoom In

  Increase the magnification of the document view.

&Ctrl;- View Zoom Out

  Decrease the magnification of the document view.

View Fit to Page Width

  Change the magnification of the document view to a value that makes the pages' width equal to the document view's width.

View Fit to Page

  Change the magnification of the document view to a value that makes at least one whole page visible.

View Continuous

  Enable the continuous page mode. In continuous mode, all pages of the document are shown, and you can scroll through them without having to use the Go Previous Page and Go Next Page options.

View Two Pages

  Enable the two page mode, which shows two pages of the document next to each other..

### The Go Menu

Backspace Go Previous Page

  View the previous page of the document.

Space Go Next Page

  View the next page of the document.

&Ctrl; Home Go First Page

  Go to the first page of the document.

&Ctrl; End Go Last Page

  Go to the last page of the document.

&Alt; Left Go Back

  Go back to the previous view of the document.

&Alt;Right Go Forward

  Move forward to the next view of the document. This only works if you have already moved back before.

&Ctrl;G Go Go to Page

  Open a dialog which allows you to go to any page of the document.

### The Tools Menu

Tools Browse Tool

  The mouse will have its normal behaviour, &LMB; for dragging the document and following links and &RMB; for adding bookmarks and fit to width.

Tools Zoom Tool

  The mouse will work as a zoom tool. Clicking &LMB; and dragging will zoom the view to the selected area, clicking &RMB; will bring the document back to the previous zoom.

Tools Select Tool

  The mouse will work as a select tool. In that mode clicking &LMB; and dragging will give the option of copying the text/image of current the selected area to the clipboard, speak a text or to save an image to a file.

### The Settings Menu

&Ctrl;M Settings Show/Hide Menubar

  Toggle the Menubar display on and off. Once hidden it can be made visible using the &RMB; menu.

Settings Show/Hide Toolbar

  Toggle the Toolbar display on and off.

&Ctrl;L Settings Show/Hide Navigation Panel

  Toggle the navigation panel on and off.

&Ctrl;&Shift;F Settings Full Screen Mode

  Enables the full screen mode. Note that full screen mode is different from presentation mode insofar as the only peculiarity of full screen mode is that it hides the window decorations, the menubar and the toolbar.

Settings Configure Shortcuts...

  Opens a window that lets you configure the keyboard shortcuts for many menu commands.

Settings Configure Toolbars...

  Opens a window that lets you choose which icons are visible in the toolbar.

Settings Configure &kpdf;...

  Opens the Configure window.

### The Help Menu

&help.menu.documentation;

## Configuring &kpdf;

### Overview

You can configure &kpdf; by choosing Settings Configure &kpdf;.... The configuration dialogue is split into four sections. This chapter describes the available options in detail.

- General

- Accessibility

- Performance

- Presentation

The configuration dialogue
The configuration dialogue

### General

Show search bar in thumbnails list

  Whether to the show a search bar in the thumbnails view or not. That search bar is useful for filtering pages that contain a given string.

Link thumbnails list with the page

  Whether the thumbnails view should always display the current page or not.

Show scrollbars

  Whether to show scrollbars for the document view.

Show hints and info messages

  Whether to show some informative messages on startup, file load, etc.

Obey DRM limitations

  Whether &kpdf; should obey DRM (Digital Rights Management) restrictions. DRM limitations are used to make it impossible to perform certain actions with PDF documents, such as copying content to the clipboard. Note that in some configurations of &kpdf;, this option is not available.

Watch file

  Whether opened files should be automatically checked for changes and updated, if necessary.

### Accessibility

Draw border around images

  Whether to draw a border around images.

Draw border around links

  Whether to draw a border around links.

Change colors

  Enables the color changing options.

Invert colors

  Inverts colors on the view, &ie; black objects will be shown white.

Change paper color

  Changes the paper's color, &ie; the document's background.

Change dark and light colors

  Changes the dark and light color to your preference, that means black will not be rendered as black but as the selected dark color and white will not be rendered as white but as the selected light color.

Convert to black and white

  Converts the document to black and white. You can set the threshold and the contrast. Setting the threshold to a higher value will result in darker grays used.

### Performance

Enable transparency effects

  Draw selections and other special graphics using transparency effects. Disable the option to draw them using outline or opaque fill styles and increase speed on selections.

Enable background generation

  Use a background thread to generate the pages. By disabling this option the user interface will become less reactive (will be blocked if necessary), but pages will be displayed a bit faster.

Memory usage profiles

  &kpdf; can achieve best performance by tuning the memory usage, based on your system and your tastes. The more memory you let it to use, the faster the program will behave. The Default profile is good for every system, but you can prevent &kpdf; from using more memory than necessary by selecting the Low profile, or let it get the most out of your system using Aggressive.

### Presentation

Advance every

  Enables automatic advancing of pages given a time period.

Loop after last page

  When navigating on presentation mode and going past the last page the first page will appear.

Background color

  The color that will fill the part of the screen not covered by the page when on presentation mode.

Default transition

  The transition effect between page and page if the document does not specify one. Set this to Random Transition to make &kpdf; randomly choose one of the available effects.

Mouse cursor

  Whether the mouse should be always hidden, always shown or hidden after a small time of inactivity.

Show progress indicator

  Whether to show a progress circle that shows the current page and the total number of pages on the upper right corner of the presentation screen everytime you change the page.

Show summary page

  Whether to show a summary page at the beginning of the presentation with the title, author and number of pages of the document.

## Credits and License

Program Copyright:

- Albert Astals Cidtsdgeos@yahoo.es Current maintainer

- Christophe Devrieseoelewapperke@ulyssis.org

- &Wilco.Greven; &Wilco.Greven.mail; Original author

- Enrico Roseros.kde@email.it Refactoring for 3.4

- Laurent Montelmontel@kde.org

Documentation Copyright:

- Albert Astals Cidtsdgeos@yahoo.es Author

- Titus Laskatitus.laska@gmx.de Some updates and additions

&underFDL; &underGPL;

## Installation

### How to obtain &kpdf;

&install.intro.documentation;

### Compilation and Installation

If you are reading this help in the &khelpcenter;, &kpdf; has already been installed on this system and you do not need install it anymore.

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