# The &kpdf; Handbook

Albert
Astals Cid

    tsdgeos@yahoo.es

&FDLNotice;
2005-02-20
1.0

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

KDE
kpdf
pdf

## Introduction

&kpdf; is a &kde; PDF viewer based on xpdf code. Although being based on xpdf code, &kpdf; has some unique features like continuous mode, presentation support, etc.

## Navigating

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

You can scroll up and down the viewing area with the Up Arrow and Down Arrow keys, using the mouse wheel, pressing &LMB; and dragging while in normal mode or using Page Up and Page Down keys.

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.

If the document has links in it, 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.

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

Presentation mode can be enabled in View Presentation. It shows the document in a page per page basis. The pages are shown with zoom to page, that means all the page is visible. To navigate between pages you have to use &LMB; (next page) and &RMB; (previous page). You can exit presentation mode using ESC key.

Presentation mode has a few configuration options, you can find their meaning at Configuring &kpdf;

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

File Print Preview...

  Shows a preview of how the currently displayed document will print with the default options.

File Properties

  Display some basic information about the document.

&Ctrl; Q File Quit

  Close &kpdf;.

### The Edit Menu

&Ctrl; F Edit Find...

  Finds a string in the document text.

F3 Edit Find Next

  Finds the previous searched string again.

### The Mouse mode Menu

Mouse mode Normal

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

Mouse mode 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.

Mouse mode Select

  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, images can be saved to a file too.

### The View Menu

View Presentation

  Activates the 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

  Changes the magnification of the document view so that the pages width fill all the view space.

View Fit to Page

  Changes the magnification of the document view so that the pages fits completely on the view space.

View Continuous

  Enables the continuous page mode.

View Two Pages

  Enables the two page mode.

### The Go Menu

&Ctrl; Home Go First Page

  Go to the first page of the document.

Backspace Go Previous Page

  View the previous page of the document.

Space Go Next Page

  View the next page of the document.

&Ctrl; End Go Last Page

  Go to the last page of the document.

### The Settings Menu

Settings Show Menubar

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

Settings Show Toolbar

  Toggle the Toolbar display on and off.

Settings Watch File

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

Settings Full Screen Mode

  Enables the full screen mode. Note that full screen mode is different from presentation mode 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.

### Help Menu

&help.menu.documentation;

## Configuring &kpdf;

### General

Show left panel

  Whether to show the left panel.

Show search bar in thumbnails view

  Whether to show search bar in 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 will always show the current page or not.

Show scrollbars

  Whether to show scrollbars.

Show hints and info messages

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

### 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, i.e. black things will be shown white.

Change paper color

  Changes paper color.

Change dark and light colors

  Changes the dark and light color, that means black will not be rendered as black but as the dark color and the same for white.

Convert to black and white

  Converts the document to black and white.

### 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 GUI 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 auto 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 between page and page if the document does not specify one.

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.

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 greven@kde.org Original author

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

&underFDL; &underGPL;
&documentation.index;