1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
|
<!--
Copyright 2012 Benjamin Eltzner
Copyright 2012 Adam Reichold
This file is part of qpdfview.
qpdfview is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or
(at your option) any later version.
qpdfview is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with qpdfview. If not, see <http://www.gnu.org/licenses/>.
This file is additionally licensed under the Creative Commons Attribution-ShareAlike 3.0 Unported (CC-BY-SA) license. The full text of the license can be found at https://creativecommons.org/licenses/by-sa/3.0/legalcode
-->
<html>
<head>
<title>Help</title>
</head>
<body>
<h2><a name="top">Help</a></h2>
<h4>Table of contents</h4>
<ol>
<li><a href="#mainmenu">Main menu</a></li>
<ol>
<li><a href="#file">File</a></li>
<li><a href="#edit">Edit</a></li>
<li><a href="#view">View</a></li>
<li><a href="#tabs">Tabs</a></li>
<li><a href="#bookmarks">Bookmarks</a></li>
<li><a href="#help">Help</a></li>
</ol>
<li><a href="#mainview">Main view</a></li>
<li><a href="#auxiliaryviews">Auxiliary views</a></li>
<li><a href="#settings">Settings</a></li>
<ol>
<li><a href="#behaviorsettings">Behavior settings</a></li>
<li><a href="#graphicssettings">Graphics settings</a></li>
<li><a href="#interfacesettings">Interface settings</a></li>
<li><a href="#shortcutsettings">Shortcut settings</a></li>
<li><a href="#modifiersettings">Modifier settings</a></li>
</ol>
</ol>
<h4>Introduction</h4>
<p><em>qpdfview</em> is a tabbed document viewer. It uses Poppler for PDF support, libspectre for PS support, DjVuLibre for DjVu support, CUPS for printing support and the Qt toolkit for its interface.</p>
<p>Please refer to the manual page for information on command-line options and configuration files.</p>
<h3><a name="mainmenu">Main menu</a> <a href="#top">↑</a></h3>
<h4><a name="file">File</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Open...</b> Opens a dialog to choose a file to open in the current tab. If there is no tab, the file is opened in a new tab.</li>
<li><b>Open in new tab...</b> Opens a dialog to choose files to open in new tabs.</li>
<li><b>Recently used</b> Contains a list of the ten most recently used files. (Available only if 'track recently used' is enabled in the settings.)</li>
<li><b>Refresh</b> Reloads the file displayed in the current tab.</li>
<li><b>Save copy...</b> Opens a dialog to save a copy of the file displayed in the current tab.</li>
<li><b>Save as...</b> Opens a dialog to save the file displayed in the current tab including changes to annotations and form fields.</li>
<li><b>Print...</b> Opens a dialog to print the file displayed in the current tab.</li>
<li><b>Exit</b> Closes all tabs and ends the program.</li>
</ul>
<h4><a name="edit">Edit</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Next/Previous/First/Last page</b> Skips to the next/previous/first/last page of the document.</li>
<li><b>Jump to page...</b> Opens a dialog to enter a page to display in the current tab.</li>
<li><b>Search...</b> Opens the search tool bar below the main view. The search automatically starts two seconds after the last change of the search term or is manually started by pressing the return key. If the Shift modifier is held when the return key is pressed, the search starts in all tabs instead of just the current tab.</li>
<li><b>Find previous/next</b> Jumps to the previous/next occurrence of the search term in the document.</li>
<li><b>Cancel search</b> Cancels the currently running search and closes the search tool bar.</li>
<li><b>Copy to clipboard</b> If checked, the program will wait for a frame to be dragged to copy texts or images.</li>
<li><b>Add annotation</b> If checked, the program will wait for a frame to be dragged to add annotations.</li>
<li><b>Settings...</b> Opens the settings dialog.</li>
</ul>
<p>The <em>current page</em> can be changed by entering the desired page into the text field in the edit tool bar and pressing the return key.</p>
<h4><a name="view">View</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Continuous</b> Determines whether all rows of the page layout are visible at once.</li>
<li><b>Two pages</b> Determines whether the page layout uses two columns.</li>
<li><b>Two pages with cover page</b> Determines whether the page layout uses two columns with a break after the cover page.</li>
<li><b>Multiple pages</b> Determines whether the page layout uses multiple columns. The number of columns can be changed in the settings dialog.</li>
<li><b>Zoom in</b> Increases the scale factor by 10 percent.</li>
<li><b>Zoom out</b> Decreases the scale factor by 10 percent.</li>
<li><b>Original size</b> Resets the scale factor to 100 percent.</li>
<li><b>Fit to page width</b> Determines the scale factor such that all pages fully fit into the main view horizontally.</li>
<li><b>Fit to page size</b> Determines the scale factor such that all pages fully fit into the main view horizontally and vertically.</li>
<li><b>Rotate left</b> Rotates the pages left/counterclockwise by 90 degrees.</li>
<li><b>Rotate right</b> Rotates the pages right/clockwise by 90 degrees.</li>
<li><b>Tool bars</b> This menu contains a list of available tool bars for accessing frequently used actions.</li>
<li><b>Docks</b> This menu contains a list of available docks for displaying supplementary information.</li>
<li><b>Fonts...</b> Opens a dialog listing the fonts used in the document.</li>
<li><b>Fullscreen</b> Toggles the fullscreen mode, i.e. the window is shown maximized and without decoration.</li>
<li><b>Presentation...</b> Enters presentation mode which can be left by pressing F12 or escape. The home/end key is used to display the first/last page. Arrow keys right and down, space and the page down key jump to the next page. Arrow keys left and up, backspace and the page up key jump to the previous page. The return key returns to the page before the last jump.</li>
</ul>
<p>The <em>scale factor</em> can be changed by entering the desired percentage into the text field in the view tool bar and pressing the return key.</p>
<h4><a name="tabs">Tabs</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Previous/Next tab</b> Makes the previous/next tab the current tab. Cycles to the last/first tab if the first/last tab is the current tab.</li>
<li><b>Close tab</b> Closes the current tab.</li>
<li><b>Close all tabs</b> Closes all tabs.</li>
<li><b>Close all tabs but current tab</b> Closes all tabs except for the current tab.</li>
</ul>
<p>This menu contains a list of all tabs which can be made the current tab by clicking on the corresponding menu item. Tabs can also be closed by middle-clicking. The first nine tabs can also be activated by holding the Alt modifier and pressing keys one to nine.</p>
<h4><a name="bookmarks">Bookmarks</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Previous bookmark</b> Jumps to the closest bookmark before the current page.</li>
<li><b>Next bookmark</b> Jumps to the closest bookmark after the current page.</li>
<li><b>Add bookmark</b> Adds a bookmark for the current file and page.</li>
<li><b>Remove bookmark</b> Removes the bookmark for the current file and page.</li>
<li><b>Remove all bookmarks</b> Removes all bookmarks.</li>
<li><b>Open</b> Opens the corresponding file in the current tab. If there is no tab, the file is opened in a new tab.</li>
<li><b>Open in new tab</b> Opens the corresponding file in a new tab.</li>
<li><b>Jump to page</b> Jumps to the corresponding page if the corresponding file is already open. Otherwise the corresponding file is opened in a new tab.</li>
</ul>
<h4><a name="help">Help</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Contents</b> Displays this document.</li>
<li><b>About</b> Displays the program version.</li>
</ul>
<h3><a name="mainview">Main view</a> <a href="#top">↑</a></h3>
<p>The backspace/space key skips to the previous/next page. (Holding the Shift modifier reverses this.) The home/end key skips to the first/last page. The arrow, page up and page down keys scroll the viewport. The return key returns to the page before the last jump.</p>
<p>Using the mouse wheel scrolls up and down. Holding <b>ALT</b> while using the mouse wheel scrolls left and right. Holding <b>CTRL</b> while using the mouse wheel scales the document. Holding <b>SHIFT</b> while using the mouse wheel rotates the document. (Keyboard modifiers can be changed in the settings dialog.)</p>
<p>Links are highlighted by red frames (if enabled in the settings). Left-click on a link to show the linked page or open the linked URL in the default browser (if enabled in the settings). Hovering over a link displays its destination as a tool tip.</p>
<p>Form fields are highlighted by blue frames (if enabled in the settings). Left-click on a form field to edit its contents. Hovering over a form field displays its name as a tool tip.</p>
<p>The source of a position in the document is requested by double-clicking which opens the first matching <em>SyncTeX</em> node using the source editor.</p>
<p>To <em>copy texts or images</em>, hold <b>SHIFT</b>, click and hold the left mouse button to drag a frame around the area to copy. Once the mouse button is released, a pop-up menu is displayed to select whether to copy texts or images into the clipboard.</p>
<p>To <em>add annotations</em>, hold <b>CTRL</b>, click and hold the left mouse button to drag a frame around the region of interest. Once the mouse button is released, a pop-up menu is displayed to select whether to add text or highlight annotations. Left-click to <em>edit annotations</em>. Right-click to <em>remove annotations</em>. (Adding and removing annotations requires version 0.20.1 or higher of the Poppler library.) Hovering over an annotation displays its contents as a tool tip.</p>
<h3><a name="auxiliaryviews">Auxiliary views</a> <a href="#top">↑</a></h3>
<p>The <em>outline</em> dock displays an overview of the contents of the document. A left click on an entry jumps to the respective page in the main view. The context menu can be used to expand/collapse all items below the selected item.</p>
<p>The <em>properties</em> dock displays additional information contained in the document.</p>
<p>The <em>thumbnails</em> dock displays smaller versions of the pages of the document. A left click on an entry jumps to the respective page in the main view.</p>
<h3><a name="settings">Settings</a> <a href="#top">↑</a></h3>
<h4><a name="behaviorsettings">Behavior settings</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Open URL</b> Determines whether links to URL are opened in the default browser.</li>
<li><b>Auto-refresh</b> Determines whether files are automatically reloaded if changed on disk.</li>
<li><b>Track recently used</b> If enabled, a recently used menu is available and lists the ten most recently used files. (Effective after restart.)</li>
<li><b>Restore tabs</b> If enabled, tabs and their properties are saved on ending the program and restored on restart.</li>
<li><b>Restore bookmarks</b> If enabled, bookmarks are saved on ending the program and restored on restart.</li>
<li><b>Restore per-file settings</b> If enabled, per-file settings are saved/restored on opening/closing tabs.</li>
<li><b>Synchronize presentation</b> If enabled, the main view can be used to control the presentation view.</li>
<li><b>Presentation screen</b> The index of the screen to display the presentation view on. </li>
<li><b>Source editor</b> The program which is started to edit sources. '%1' is replaced by the absolute file path. '%2' resp. '%3' is replaced by line resp. column number.</li>
</ul>
<h4><a name="graphicssettings">Graphics settings</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Decorate pages</b> Determines whether pages are set apart from the background.</li>
<li><b>Decorate links</b> Determines whether links are highlighted by red frames.</li>
<li><b>Decorate form fields</b> Determines whether form fields are highlighted by blue frames.</li>
<li><b>Highlight duration</b> Determines the duration of temporary highlights.</li>
<li><b>Background color</b> Determines the color of the background using SVG color keywords or hexadecimal notation '#rrggbb'.</li>
<li><b>Paper color</b> Determines the color of pages using SVG color keywords or hexadecimal notation '#rrggbb'.</li>
<li><b>Invert colors</b> Determines whether pages are rendered with inverted colors.</li>
<li><b>Pages per row</b> Number of pages per row in the 'multiple pages' layout mode.</li>
<li><b>Page spacing</b> Determines both vertical and horizontal space displayed between pages.</li>
<li><b>Thumbnail spacing</b> Determines both vertical and horizontal space displayed between thumbnails.</li>
<li><b>Thumbnail size</b> Determines the size of the thumbnails.</li>
<li><b>Cache size</b> The program will try to cache rendered pages within this limit increasing rendering speed at the cost of increased memory usage.</li>
<li><b>Prefetch</b> The program will try to render pages that are not yet visible increasing rendering speed at the cost of increased cache usage.</li>
<li><b>Prefetch distance</b> The number of rows beyond the current row and twice the number of rows before the current row that are prefetched.</li>
<li><b>PDF settings</b>
<ul>
<li><b>Overprint preview</b> If enabled, a preview of printing one layer of ink on top of another is displayed.</li>
<li><b>Antialiasing</b> Improves display quality at the cost of performance</li>
<li><b>Text antialiasing</b> Improves text display quality at the cost of performance</li>
<li><b>Text hinting</b> May improve text display quality for certain fonts.</li>
</ul>
</li>
<li><b>PS settings</b>
<ul>
<li><b>Graphics antialias bits</b> Determines the amount of antialiasing of graphics.</li>
<li><b>Text antialias bits</b> Determines the amount of antialiasing of text.</li>
</ul>
</li>
</ul>
<h4><a name="interfacesettings">Interface settings</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Tab position</b> Defines at which edge of the main view tabs will be displayed.</li>
<li><b>Tab visibility</b> Determines whether tabs will be displayed if less than two documents are opened.</li>
<li><b>File tool bar</b> Defines which actions are visible in the file tool bar. Available actions are openInNewTab, open, refresh, saveCopy, saveAs and print. (Effective after restart.)</li>
<li><b>Edit tool bar</b> Defines which actions are visible in the edit tool bar. Available actions are currentPage, previousPage, nextPage, firstPage, lastPage, jumpToPage, search, copyToClipboardMode and addAnnotationMode. (Effective after restart.)</li>
<li><b>View tool bar</b> Defines which actions are visible in the view tool bar. Available actions are scaleFactor, zoomIn, zoomOut, continuousMode, twoPagesMode, twoPagesWithCoverPageMode, multiplePagesMode, originalSize, fitToPageWidthMode, fitToPageSizeMode, rotateLeft, rotateRight, fullscreen and presentation. (Effective after restart.)</li>
</ul>
<h4><a name="shortcutsettings">Shortcut settings</a> <a href="#top">↑</a></h4>
<p>The shortcut settings dialog allows the adjustment of keyboard shortcuts to personal preference. Shortcuts are changed by double-clicking on the shortcut to edit it and typing in the new shortcut. Names of keys that are not single letters are written out explicitly (e.g. "Alt", "Ctrl", "PgDown"), where the matching is not case sensitive. If the shortcut contains modifier keys, the names of the keys are joined by a plus sign and modifier keys must be listed first, e.g. "Crtl+A" or "Ctrl++".</p>
<h4><a name="modifiersettings">Modifier settings</a> <a href="#top">↑</a></h4>
<ul>
<li><b>Zoom</b> The keyboard modifiers to zoom using the mouse wheel in the main view.</li>
<li><b>Rotate</b> The keyboard modifiers to rotate using the mouse wheel in the main view.</li>
<li><b>Scroll</b> The keyboard modifiers to scroll horizontally using the mouse wheel in the main view.</li>
<li><b>Copy to clipboard</b> The keyboard modifiers to copy texts or images from a page to the clipboard.</li>
<li><b>Add annotation</b> The keyboard modifiers to add annotations to a page.</li>
</ul>
</body>
</html>
|