Chapter 2.2.6 qpdfview
======================

qpdfview is the default PDF viewer for Lubuntu.

Features:
 - Tabs
 - Presentation mode
 - Zoom to entire page/ page width
 - Rotating pages
 - Outline, properties, thumbnail, and bookmark docks
 - Printing support
 - Annotation and highlighting 
 - Bookmarks
 - Customizable keyboard shortcuts
 - Viewing postscript files

Usage
------
To open a PDF file use :menuselection:`File --> Open` or press :kbd:`Control + O` on the keyboard. If you have a PDF open use :menuselection:`File --> Open in new tab` from the menu, click the Open in new tab button or press :kbd:`Control + T`. To refresh a PDF click the Refresh button, :menuselection:`File --> Refresh`, or press :kbd:`F5` just like most web browsers. To switch between tabs on the keyboard you can press control :kbd:`control + tab` or :menuselection:`Tabs --> Next Tab` to go the next tab or :kbd:`control + shift + tab` or :menuselection:`Tabs --> Previous Tab` to cycle through your tabs in the opposite direction. At the bottom of the tab menu will be a list of all your tabs you have open with the title of each document. To close the tab press the red X button on the tab or press :kbd:`Control +W`. To close all tabs on qpdfview press :kbd:`Control + Shift +W`. To restore the most recently closed tabs press :kbd:`Alt+Shift+W` or :menuselection:`Restore most recently closed tab`. To view a menu with your recently closed tab :menuselection:`Tabs --> Recently Closed` and select the file you want. To see a list of all your tabs in a menu they are at the bottom of the :menuselection:`Tabs` menu.

If you want a second copy of a PDF file open right click on the tab and :menuselection:`Open copy in new tab`. If you want a copy of the current PDF on the tab and select :menuselection:`Open copy in new window`. To open your file manager in the current directory right click on the tab and :menuselection:`Open containing folder`. To one pdf file on the left and another on the right click on the tab bar and select :menuselection:`Split view horizontally`. To have one pdf file on top of another right click and select :menuselection:`Split view vertically`. To switch between which pdf you are able to change pages of simply move the mouse over that pdf. To close go back to only one pdf file right click on the tab and select :menuselection:`Close current view`.

To close all tabs right click on the tab bar and :menuselection:`Close all tabs`. To Close all tabs but that one you right click on right click on a tab and :menuselection:`Close all tabs but this one`. To close all tabs to the right of the one you right click right click on a tab and :menuselection:`Close all tabs to right`. To close all tabs to the left right click on a tab and :menuselection:`Close all tabs to left`. To reorder your tabs left click and drag the tab where you want it in the order.

.. image:: qpdfview-tab-context.png

If you want to view a particular page select the box (e.g. page 1/3) in towards the top left corner and type the page number (e.g. page 3/3). To move to the previous and next page press the :kbd:`left arrow` and :kbd:`right arrow` buttons respectively. Scrolling with the mousewheel past the end or beginning of a page will also change the page. Another way to move to the next page is to press :kbd:`spacebar` or :menuselection:`Edit --> Next page`. Another way to go to the previous page is pressing :kbd:`Backspace` or :menuselection:`Edit --> Previous page`.  Another way to jump to a particular page is to press :kbd:`control + j` or :menuselection:`Edit --> Jump to page`. To go back to page which you have just come from press :kbd:`control + enter` or :menuselection:`Edit --> Jump backward`. To jump forward a page press :kbd:`control + shift + enter` or :menuselection:`Edit --> Jump forward`. To move to the last page of the PDF press the :kbd:`End` key or :menuselection:`Edit --> Last Page`. To move to the first page of the PDF press the :kbd:`Home` key or :menuselection:`Edit --> First page`.

To select text or an image from qpdfview press :kbd:`control+c` or :menuselection:`Edit --> Copy to clipboard`. Then the cursor will turn into a crosshair and you will be able to expand a box to select either text or an image and a menu to select copying the text, selecting the text, copying the image, or saving the image to file. Another way to copy text is to press :kbd:`Shift + Left Click`.

To save your PDF file is to :menuselection:`File --> Save` or you can press :kbd:`Control + s`. You can save the file with a different name with :menuselection:`File --> Save as`. To save a copy of the document click :menuselection:`File --> Save a copy`. If the next time you want to open a pdf to a specific page as first page right click :menuselection:`Set first page`. :menuselection:` If you want to quit qpdfview press :kbd:`Control+Q`.

To view two pages at once like if you want to see a two page spread of an illustration in a PDF of a book press :kbd:`Control + 6` or :menuselection:`View --> Two pages`. To get your view back to normal press :kbd:`Control +6` again or :menuselection:`View --> Two pages` again.  To toggle the view of three pages at a time press :kbd:`Control +4` or :menuselection:`View --> Multiple pages`. To view right to left languages on qpdfview press :kbd:`Control +Shift +R` or :menuselection:`View --> Right to left`. To view the fonts embedded in the PDF :menuselection:`View --> Fonts`.

To search through your PDF file you can press :kbd:`control + f` or from the menu :menuselection:`Edit --> Search`. You will get taken to the results and will appear highlighted in yellow to see through the results you can press the down arrow, right click :menuselection:`Find next`, or press :kbd:`F3` to see results farther in the document and press the upward pointed arrow button, right click :menuselection:`Find previous`, or press :kbd:`Shift +F3` to see results towards the start of the document. To exit the search dialog press :kbd:`Escape`, right click :menuselection:`Cancel search`, or :menuselection:`Edit --> Cancel search`. If you want searches to match case check the :guilabel:`Match case` checkbox. To match entire words check the :guilabel:`Whole words` checkbox. To highlight all matches of words check the :guilabel:`Highlight all` checkbox. To exit the search press the button that looks like an octagon.

.. image:: qpdfview-search-bar.png

To make qpdfview fullscreen you can press :kbd:`f11` or :menuselection:`View --> Fullscreen`.

To make an annotation press :kbd:`Control +A` or :menuselection:`Edit --> Add annotation`. To view the annotation you have made or edit it again press click on what looks like a sticky note with a pin in it. To remove your annotation right click on the annotation and click :menuselection:`Remove annotation`. If you just want to highlight something right click on the text and select :menuselection:`Add highlight` text.

To select page width in zoom in qpdfview is a drop down menu with page width to show the width of the page on qpdfview, :menuselection:`View --> Fit to page width`, or press :kbd:`Control +9`. To view the whole page on qpdfview in this drop down menu select whole page, :menuselection:`View --> fit to page size`, or press :kbd:`Control + 8`. To return to the original zoom press :kbd:`Control + 0` or :menuselection:`View --> Original size`. To zoom in is press the magnifying glass with a + in it or press :kbd:`Control + +` or :menuselection:`View --> Zoom in`. To zoom out press the magnifying glass button with a - in it or press :kbd:`Control + -` or :menuselection:`View --> Zoom out`. To rotate the file to the left is press :kbd:`Control + Left arrow` or :menuselection:`View --> Rotate Left`. To rotate the file to the right is press :kbd:`Control + Right arrow` or :menuselection:`View --> Rotate Right`. Another way to rotate is to hold :kbd:`Shift` and then use the mousewheel. Another way to zoom with the scrollwheel is to hold :kbd:`Control` and zoom with the mousewheel.

If you have a particularly long PDF file you might want to make a bookmark to find a specific thing easily. To create a bookmark press :kbd:`control +b` or  :menuselection:`Bookmarks -->  Add Bookmark` and give the bookmark a memorable title and description so you can find it in this document again easily. If you later want to remove the bookmark go :menuselection:`Bookmarks --> Remove bookmark` or press :kbd:`control+ shift+ B`.

Screenshot
----------
.. image:: qpdfview.png

Docks
-----
qpdfview also includes some very useful docks. To view the outline dock, in the menu select :menuselection:`View --> Docks --> Outline (make sure the button is checked)` or press :kbd:`F6` on the keyboard. It should appear on the left hand side of the PDF with collapsible sections and to expand or collapse each section left click on the :menuselection:`-->`. To go to a particular part of the outline double click on that part of the outline. To see the entire outline right click on the outline and select :menuselection:`Expand all`. To have your outline back to the original state right click on it and select :menuselection:`Collapse all`. This is useful in navigating large PDFs.

.. image:: qpdfview-outline.png

To view properties of your PDF file press :kbd:`F7` or :menuselection:`View --> Docks --> Properties`. To see a thumbnail of each page :menuselection:`View --> Dock --> Thumbnails` or press :kbd:`F8` to view a thumbnail of each page of the PDF file. If you want to close one of these docks click the X button on the dock to close it. To detach a dock to its own floating window press the diamond button to detach it. To get the dock back to where it was press the diamond button again.

.. image:: properties-dock.png

Presentation
-------------
To enter presentation mode you can press :kbd:`f12` or :menuselection:`View --> Presentation` which makes the content of the PDF take up the fullscreen and gives you no menubars or toolbars. To exit presentation mode you can press :kbd:`f12` again. To advance to the next page in the presentation press the :kbd:`spacebar` or the :kbd:`right arrow`. To go back a page in presentation press the :kbd:`left arrow`. To exit the presentation press :kbd:`escape`. To go to the first page of the presentation press the :kbd:`Home` key. To go to the last page of the presentation press the :kbd:`End` key.

Printing
--------

To print your PDF press :kbd:`Control + P` or :menuselection:`File --> Print`. To change what printer you use use the :guilabel:`Name` drop down to select the name of the printer. To see more options press the :guilabel:`Options >>` button to see more options when you print. To select which pages to print use the :guilabel:`Pages from` button and then the fields for the first page to print and then the last page to print. To change what pages you print and type the page number in use the :guilabel:`Pages` field. To print your current page press the :guilabel:`Current Page` button. To change how many copies you print change the :guilabel:`Copies` field.

.. image:: qpdfview-print.png

If you are printing the PDF in black and white you can however  toggle previewing  the file in black and white by pressing :kbd:`Control + U` or :menuselection:`View --> Convert to grayscale`. To invert the colors of your PDF press :kbd:`Control +I` or :menuselection:`View --> Invert Colors`. To trim the margins off your PDF file press :kbd:`control +Shift +U` or :menuselection:`View --> Trim margins`. If you want to turn off changed colors or trimmed margins off press or use the menu in the same thing again.

Customizing
-----------
To add your own settings to qpdfview you can get to a settings window with :menuselection:`Edit --> Settings`. To change how qpdfview uses links or manages tabs left click on the :guilabel:`Behavior` tab. The checkbox :guilabel:`Open URL` allows you to turn on or off Opening URLs or links within qpdfview. The :guilabel:`Auto-refresh` checkbox reloads the PDF whenever the file changes which is useful for authoring PDF files. To have qpdfview keep track of recently check the :guilabel:`Track recently used` checkbox. To keep track of recently closed documents check the :guilabel:`Keep recently closed` checkbox. To open the tabs you had open last time with qpdfview the next time you open the program check the :guilabel:`Restore tabs` checkbox. To restore bookmarks after qpdfview is closed check the :guilabel:`Restore bookmarks` checkbox. To have per file settings restored each time you open qpdfview check the :guilabel:`Restore per-file settings` checkbox. To change the page in the main view in addition with the presentation check the :guilabel:`Synchronize presentation` checkbox. To change what screen you use for presentations change the :guilabel:`Presentation Screen` field to the number of the screen you want to use.  To have your outline dock follow what section you  are viewing check the :guilabel:`Synchronize outline view` checkbox. If you want to scroll once to change an entire page check the :guilabel:`Minimal scrolling` checkbox. To change the color of highlights type a hex number for a color or select one from the :guilabel:`Highlight Color` drop down menu.

.. image:: qpdfviewprefrences.png

If you want to reset these settings to the defaults is to press the :guilabel:`Defaults` button. If you just want defaults on the current tab you can press the :guilabel:`Defaults on current tab` button. If you want to return to viewing your PDF with the same settings press the :guilabel:`OK` button. If you wish to discard your changes press the :guilabel:`Cancel` button.

To deal with settings on graphics press press on the :guilabel:`Graphics` tab. To toggle having a small decoration showing where different pages are check the :guilabel:`Decorate pages` checkbox. To toggle having a red border around hyperlinks check the :guilabel:`Decorate links` checkbox. To toggle having a blue borders around fillable forms in a PDF check the :guilabel:`Decorate form fields` checkbox. The settings for paper color will has a drop down menu for previewing what it is like printing on colored paper. The checkbox :guilabel:`Prefetch` will preload pages not directly viewed by the PDF viewer not directly on the screen however this will use more resources. The drop down for :guilabel:`Cache size` will increase loading speed but will use more resources. The :guilabel:`Prefetch` checkbox loads pages before you view them. The :guilabel:`Prefetch distance` tells you how many pages away from where you are to load. The field for :guilabel:`Presentation background color` sets the color of the background for presentations. The :guilabel:`Cache size` menu increases the size of the cache which will apply more system resources to run heavy PDFs with hundreds of pages of full color artwork.

.. image:: qpdfview-graphics.png
 
The :guilabel:`PDF` subtab of the graphics tab has settings for font and paper color for viewing PDF files. To antialias images check the :guilabel:`Antialiasing` checkbox. To antialias text check the :guilabel:`Text antialiasing` checkbox. To use font hinting to view text easier to view change the :guilabel:`Text hinting` menu to Reduced or full. To not change the background color with change the :guilabel:`Ignore paper color` checkbox. To change how qpdfview draws thin lines change the :guilabel:`Thin line mode` drop down menu. 

.. image:: Graphic_PDF_subtab.png

The :guilabel:`PS` subtab manages how Postscript files appear on the screen. To change how many bits are used for antialiasing graphics change the :guilabel:`Graphics antialias bits` field. To change the number of bits of text antialiasing change :guilabel:`Text antialiasing bits` field.

.. image:: graphics-postscript.png

To change the interface settings click on the :guilabel:`Interface` tab. If you want the tabs to be spread out press the spread tabs checkbox. The :guilabel:`Tab position` changes where the tabbar on the window. The :guilabel:`Tab visibility` menu can be set to as needed, always or never which will show or hide the tabbar. The checkbox for :guilabel:`New tab next to current tab` opens new tabs next to the current one. The field :guilabel:`Recently used count` lets you set the maximum number of files to keep around in recently used. The :guilabel:`Spread tabs` checkbox spreads the tabs to take up the whole tab bar and they get smaller the more tabs you open. To have qpdfview close when the last tab in qpdfview is closed check the :guilabel:`Exit after last tab` checkbox. To change the number of recently used PDF files in the menu change the :guilabel:`Recently used count` field. To change how many recently closed tabs of PDFs are shown change the :guilabel:`Recently closed count` field. To toggle showing the current page in the window title check the :guilabel:`Current page in window title`.

.. image:: qpdfview-interface.png

The :guilabel:`Shortcuts` tab provides the ability to customize keyboard shortcuts. The :guilabel:`Action` column is what each keyboard shortcut does. The :guilabel:`Key sequence` column shows the keyboard shortcut. Double click in the key sequence column and type in your desired keyboard shortcut to change the keyboard shortcut.

.. image:: qpdfview-shortcuts.png

The :guilabel:`Modifiers` tab allows you to change settings with the mouse and certain keyboard shortcuts in combination with the mouse. To change what keyboard shortcut to hold down while you hold down your mousewheel to zoom use the :guilabel:`Zoom` drop down menu. To change what keyboard key to hold down before using the mousewheel use the :guilabel:`Rotate` key. To change what key to press when you copy text to the clipboard when also pressing a mouse button use the :guilabel:`Copy to Clipboard` drop down menu. To switch which key you press when left clicking to add an annotation use the :guilabel:`Add annotation` drop down menu. To change what what you press to while left clicking to zoom to a selection change the :guilabel:`Zoom to Selection` drop down menu.

.. image:: qpdfview-modifiers.png

Version
-------
Lubuntu ships with version 0.4.18-3 of qpdfview.

How to Launch
-------------
To launch qpdfview go to the Menu :menuselection:`Office --> qpdfview` or run 

.. code:: 

   qpdfview 

from the command line. The icon for qpdfview looks like an eye with a blue background.
